fix(types): gate public JSDoc helpers (SD-2833)

[caio-pizzol]

Summary

• widen check:jsdoc so gated files are repo-relative and validated against a derived public export graph for superdoc, superdoc/super-editor, and superdoc/ui
• add the SD-2892 regression helpers (markInsertion, markDeletion, addMarkStep) to the checked JSDoc gate
• add a consumer-typecheck fixture for trackChangesHelpers through superdoc/super-editor, covering omitted optional IDs and the minimal addMarkStep call shape under bundler/node16/nodenext with skipLibCheck:false
• type those helper JSDoc blocks enough for // @ts-check without changing their consumer call shapes

Notes

This is the first shippable SD-2833 slice, not the full public-JSDoc drain. The checker now discovers 118 public JSDoc files and reports 114 still ungated, which gives us an explicit backlog while keeping this PR focused on the helper declarations that caused the SD-2892 review issue.

One important boundary: @ts-check catches JSDoc/source inconsistencies such as omitted destructured fields, but it does not reliably catch a runtime-optional field declared as required or an unused nested option declared in JSDoc. The new consumer fixture is the regression gate for that class because it compiles real public calls from the packed package.

@types/uuid is added to packages/super-editor dev dependencies because the newly checked helper files import uuid and TypeScript needs its declarations while running checkJs.

Verification

• pnpm --filter superdoc check:jsdoc
• pnpm --filter superdoc run build:es
• node tests/consumer-typecheck/typecheck-matrix.mjs -> 47 passed, 0 failed, 0 warnings
• pnpm run type-check
• git diff --check

[linear]

SD-2833 Type-check public JSDoc sources to prevent .d.ts drift (SD-2833)

[codecov-commenter]

Codecov Report

✅ All modified and coverable lines are covered by tests.

📢 Thoughts on this report? Let us know!

[superdoc-bot]

🎉 This PR is included in @superdoc-dev/mcp v0.3.0-next.41

The release is available on GitHub release

[superdoc-bot]

🎉 This PR is included in vscode-ext v2.3.0-next.85

[superdoc-bot]

🎉 This PR is included in @superdoc-dev/react v1.2.0-next.83

The release is available on GitHub release

[superdoc-bot]

🎉 This PR is included in superdoc v1.30.0-next.42

The release is available on GitHub release

[superdoc-bot]

🎉 This PR is included in superdoc-cli v0.8.0-next.59

The release is available on GitHub release

[superdoc-bot]

🎉 This PR is included in superdoc-sdk v1.8.0-next.44