@@ -48,6 +48,22 @@ to make a test easier — widening the public surface for a test is a product ch
4848outlive the test that motivated them. If a seam is genuinely missing, add it as a real one rather
4949than as a test affordance (the workflow separately forbids test-only ` typeof ` DI params).
5050
51+ ## Properties over examples (pure parsers and geometry)
52+
53+ ** Pure parser or geometry change → extend a property, not another example.** The parse/print and
54+ geometry kernels (selectors, ` @eN~sM ` refs, ` .ad ` script lines, gesture planning, snapshot diff) are
55+ covered by fast-check properties living in each owning module's test file. Their generators are
56+ shared in ` src/__tests__/test-utils/property-arbitraries.ts ` and exported through the test-utils
57+ barrel, so a new hazard (another quote shape, a new gesture kind, another ` .ad ` command) belongs in
58+ the generator, where every property inherits it — not in a new hand-pinned case.
59+
60+ - Keep examples that document a specific decision or a real past bug; add the general guarantee as a
61+ property alongside them.
62+ - Bound ` numRuns ` with the shared ` PROPERTY_RUNS ` / ` PROPERTY_RUNS_SMALL ` constants: properties run
63+ in ` unit-core ` under the same slow-test budget as everything else.
64+ - A failing property prints the shrunk counterexample plus the seed and path to replay it; paste
65+ that seed into ` fc.assert(..., { seed, path }) ` to re-run exactly that case.
66+
5167## Affected-check selector (` pnpm check:affected ` )
5268
5369` pnpm check:affected --base <ref> ` derives which local checks a diff needs, so
0 commit comments