suaveplan/openspec/archive/2026-05-02-testing-dom-spec-conformance/proposal.md

OpenSpec Change: testing-dom-spec-conformance

• Change ID: testing-dom-spec-conformance
• Package: @suaveplan/testing-dom
• Status: PROPOSED
• Date: 2026-04-26

Summary

Add **Verified by:** lines to every requirement in openspec/specs/testing-dom/spec.md, add a small spec-conformance test that pins the dual-runner conditional-exports shape declared in package.json, and rectify the historical "retro-tick" phrasing in the archived enterprise-testing-dom tasks so bun scripts/openspec-conformance.ts @suaveplan/testing-dom exits 0. No public-API changes.

Current state

@suaveplan/testing-dom is structurally solid: dual-runner re-exports (vitest + bun:test), createTestConfig() factory with WSL2-safe defaults and dynamic @vitejs/plugin-react loading, side-effect-only polyfills, jest-dom matcher extension, renderComponent wrapper with auto-cleanup and userEvent, accessibility-first query aliases, structured TestingDomError hierarchy with stable codes, dep-graph + tree-shake + no-disallowed guards, and instrumented() OTel wrapper. All 63 tests pass under vitest. The conformance gaps are documentary plus one unwritten test scenario:

• 9/9 requirements lack **Verified by:** lines.
• "Dual-runner conditional exports preserved" — the spec asserts package.json#exports routes the vitest + default conditions to one barrel and the bun condition to the bun-test barrel, but no test pins the JSON shape, so a regression in the exports map would slip past the test suite.
• tasks.md of 2026-04-19-enterprise-testing-dom/ carries the legacy retro-tick phrasing the conformance script flags.
• The Coverage section path-references packages/universal/testing-dom/src/; the package now lives at packages/dev/testing-dom/src/ after the domain-first reorg. (Documentary fix only — coverage gate already runs against the correct path.)

What changes

1. Add **Verified by:** line under every ### Requirement: block in openspec/specs/testing-dom/spec.md.
2. Update the path reference inside the "Coverage and docs gates" requirement from packages/universal/testing-dom/src/ to packages/dev/testing-dom/src/.
3. Add tests/exports-map.spec-conformance.test.ts that parses package.json and pins:
   • exports["."]["vitest"].default === "./dist/index.js"
   • exports["."]["default"].default === "./dist/index.js"
   • exports["."]["bun"].default === "./dist/runner/bun-test.js"
   • ./polyfills, ./matchers, ./config, ./errors, ./render, ./queries, ./user subpaths exist.
4. Replace the legacy retro-tick phrase in openspec/archive/2026-04-19-enterprise-testing-dom/tasks.md with a neutral note pointing at this change.
5. Re-run bun scripts/openspec-conformance.ts @suaveplan/testing-dom and confirm exit 0.

Impact

• Public API unchanged.
• One new test file (~40 lines).
• openspec/specs/testing-dom/spec.md gains 9 **Verified by:** lines and one corrected path reference.
• openspec/archive/2026-04-19-enterprise-testing-dom/tasks.md rephrased to drop the conformance-blocking phrase.