js-docs-sync

Compare the barrel file exports in src/index.ts against the documented export list, then verify each documented signature, type, and enum against the source. Update only the discrepancies while preserving accurate existing prose and examples.

Run git diff on the package's src/ directory to identify changed files, map them to doc files using the Source Code Map in docs/README.md, and re-verify only those affected docs for signature, type, and example accuracy.

Only document functions reachable from the package's main entry point through the barrel index.ts chain. A function exported from its own file but not re-exported publicly is internal and should not appear in the docs.

Hand-written docs in js/packages/*/docs/ focus on usage patterns and examples and ship with the npm package. TypeDoc-generated API docs at js/docs/ are gitignored, exhaustive API references, and serve a separate purpose.

Examples often break when template literal types are documented as plain strings, imports reference renamed exports, or truncated arrays use invalid spread syntax. Verify each example against real exports and use comment placeholders for truncated arrays.