Control descriptions: full IOF coverage, smarter autodetect, print/editor sheet parity

[ellmkay]

Summary

Brings control descriptions to full IOF 2018/2024 coverage and fixes the field-testing findings that followed.

Data model & sheet

• ControlDescription gains e (appearance / second feature) and h (other information). Dimensions move from column E to F per the spec. One shared descriptionCells() replaces two duplicated OCAD→IOF converters.
• New courses.description_instructions JSONB (migration 20260924180000_course_description_instructions) for special-instruction rows (13.x) and the finish variant (14.x).
• Shared buildDescriptionSheet() row model: 3-row IOF header (event / classes / course · length · climb), start row, controls, specials, finish with the measured last-control → finish distance. Used by the on-map sheet, the print block and the layout-editor preview, so screen and print are identical.
• IOF layout rules: bold header with thick cell rules; thick rule under start, after every third description, on either side of a special instruction, above the finish; thick verticals after columns C and F (A B C | D E F | G H); alternate row shading.

Editor

• Reworked ControlDescriptionEditor: labelled 3×3 compass grid for column C, visible symbol names (mobile-friendly), E/H sections, live summary sentence, bottom sheet on narrow screens. en/sv complete.
• Crosshair cursor in editor mode + magnifier loupe while dragging (MapLoupe over passive TileLayers sharing the blob cache).
• Context-menu actions are disabled rather than silently ignored while a save is in flight / before the control list has loaded.

Autodetect

• New passes: crossing/junction (F; second feature in E, also path · path · junction), bend, free end, which-of-similar (C), side-of / outside corner for compact areas, edge / part / inside & outside corner for extended areas.
• OCAD Bezier segments are flattened onto the drawn curve; junction snap tolerance 0.3 mm; within 1.5 mm the junction replaces the plain line candidate.
• Extended areas rank by depth-from-edge + 0.5 mm, so a boulder beside the control beats the open land it stands in.
• autoDescribe fills the top candidate on create; on move it replaces an untouched auto description (never a hand-edited one). The menu offers a single replacement suggestion only when it differs.

Also fixes a flaky runner-count read in structured-search-names.spec.ts.

Docs

docs/course-editor.md, docs/course-maps.md, docs/control-descriptions-and-editor-geometry.md, docs/features.md, new docs/bugfix-control-description-columns.md.

Verification

• pnpm build — clean
• Unit: shared 292 · api 588 · web 867
• Integration: 333
• Full E2E: 4/4 shards PASS
• Docker host-db stack rebuilt (oxygen-api / oxygen-web Built + Started)

Major-version drift (informational)

• vitest 4.1.10 → 5.0.1, @vitest/coverage-v8 4.1.10 → 5.0.1
• typescript 6.0.3 → 7.0.2
• dotenv 17.4.2 → 18.0.3
• prisma 7.9.1 → 8.0.0-rc.15 (RC — do not bump yet)

Out of scope / follow-ups

Purple Pen / IOF XML import-export of descriptions, upper/lower column C from contours, dimension symbols 9.x beyond free text.