feat(types): ship TypeScript definitions for the public API

[kevinchappell]

Stacked on #511 (control sets). Merge #511 first; this PR's own changes are the 10 commits after it. Please squash-merge (one commit, fcdb782 fixes code added earlier in this PR).

What

Formeo now ships TypeScript definitions, so the README's "Full type definitions included" is true.

• src/types/formeo.d.ts is the single, hand-written source. It covers FormeoEditor and FormeoRenderer, every option, event callback, before hook (onBeforeAdd/Remove/Clone/Save, with onBeforeAdd's detail a union keyed on componentType), action (click.btn, save.form, remove.component, remove.page, item removals with isClearAll), the formeo* DOM events (on document and on elements), destroy(), pages and renderer pagination, control sets (controlSet definitions and componentType: 'controlSet'), and the formData shape. The old README names FormeoOptions and FormData still work, marked @deprecated.
• The types follow the runtime, not just the docs. For example, both constructors accept no options; controls.disable.formActions: false is a type error because it throws; a component's config.events.onRender / onAddChild handler is typed for both calls the runtime makes (the event, then the legacy element / { parent, child } call); and the editor's onRender, formeoOnRender and formeoConditionUpdated are left out because nothing fires them.
• Checked by tsc: npm run test:types compiles fixtures (src/types/*.test-d.ts) against the d.ts, with @ts-expect-error lines that fail if a type is loosened. It runs in CI (pull-request.yml) and on pre-push.
• Published: after build:lib, tools/build-types.mjs copies the d.ts to dist/formeo.d.ts and dist/formeo.d.cts; package.json has types and a types condition first in each exports["."] entry. tools/dist.test.mjs now handles nested conditions and checks that tsc finds the types from bundler and nodenext (.mts and .cts) consumers.
• TypeScript 7 (typescript@^7.0.2, devDependency) via the tsc CLI only. Commit-message linting still works with it installed (its config is in package.json).

Docs

docs/typescript.md (what's typed, before-hook narrowing, DOM events, control sets, supported TypeScript versions: 4.7+, 5.0+ for bundler, dom lib; node10 needs TS ≤ 6 or bundler/nodenext; replacing your own declare module 'formeo' or Window declarations), a rewritten README TypeScript section, docs/README.md, the editor constructor row (options are optional), the action names in docs/options/actions/README.md (click.btn, save.form), and CLAUDE.md. A separate commit fixes docs/options/events/README.md: the edit panel events fire for stages too (Refs #316).

For consumers

Code that was any is now type-checked, so upgrading may surface type errors in existing TypeScript code. Projects with their own declare module 'formeo' or Window.FormeoEditor declarations should delete them (formeo-io has one).

Testing

• npm test: 704 pass (701 on feat(controls): control sets, a control that adds a row of fields at once #511). New: src/lib/js/package-types.test.mjs
• npm run test:types: clean
• npm run lint: clean
• npm run build + npm run test:dist: 7 pass
• Playwright: 174 passed, 3 skipped (the pre-existing test.skips)
• Packed tarball: @arethetypeswrong/cli green for node16 (ESM and CJS) and bundler

Follow-ups

• controls.disable.formActions: false throws at runtime (typed as an error for now)
• The editor's onRender, formeoOnRender and formeoConditionUpdated are documented but never fired: wire them up or drop them from the docs
• Run @arethetypeswrong/cli in CI
• Remove the deprecated FormeoOptions / FormData aliases in the next major

Refs #184

[Copilot]

Copilot was unable to review this pull request because the user who requested the review has reached their quota limit.

[kevinchappell]

🎉 This PR is included in version 5.13.0 🎉

The release is available on:

• npm package (@latest dist-tag)
• GitHub release

Your semantic-release bot 📦🚀