docs(reference): add public API coverage

[aryasaatvik]

Summary

• add generated-style public API reference pages for the core and React packages
• add an audit that checks exported symbols, API headings, source links, and reference coverage
• make reference validation part of the docs package workflow

package exports -> reference inventory -> MDX pages -> reference audit

Validation

• docs build
• 1,596 reference audits with 0 errors
• core package build
• repository lint, format, and diff checks

[github-actions]

Tegami

This repository uses Tegami to manage releases. When your changes affect published packages, add a changelog file under .tegami/ before merging.

Create a changelog → · Changelog format

Release preview

Package	Bump	Version
@domainkit/react	minor	0.3.1 → 0.4.0
domainkit	minor	0.3.1 → 0.4.0

This PR does not add changelog files. Pending changelogs from other branches are included in the preview above.

Run bun run tegami locally to create a changelog interactively.

_{Managed by Tegami.}

[greptile-apps]

Greptile Summary

The PR adds public API reference pages for the core, Promise, testing, transport, React, and provider surfaces, then integrates reference validation into docs audit and build workflows. The validation remains too shallow to guarantee substantive API coverage.

• Adds reference navigation and package/runtime guidance.
• Adds namespace inventories and usage examples across public entrypoints.
• Adds missing-and-stale export checks to the docs workflow.

Confidence Score: 4/5

The PR should not merge until the reference audit distinguishes substantive API entries from retained inventory names.

The docs workflow can report complete reference coverage after an API's descriptive material is removed, because validation checks only whether its backtick-wrapped name remains in the configured table column.

Files Needing Attention: apps/docs/scripts/check-reference.mts, apps/docs/content/reference/promise.mdx

Important Files Changed

Filename	Overview
apps/docs/scripts/check-reference.mts	Adds export-to-inventory validation, but name-only extraction still allows substantive API documentation to disappear without failing the build.
apps/docs/package.json	Integrates the reference check into both audit and build, propagating the check's incomplete coverage semantics.
apps/docs/content/reference/promise.mdx	Adds Promise API guidance and a compact aggregate inventory whose names satisfy the audit without symbol-specific documentation.
apps/docs/content/reference/core.mdx	Adds categorized core namespace documentation and lifecycle guidance.
apps/docs/content/reference/react.mdx	Adds categorized documentation for the React package's public namespaces.

Flowchart

%%{init: {'theme': 'neutral'}}%%
flowchart LR
  A[Package entrypoint exports] --> B[Regex export inventory]
  B --> C[MDX inventory names]
  C --> D[Missing and stale comparison]
  D --> E[Docs audit and build]

Loading

_{Reviews (7): Last reviewed commit: "fix(docs): scope reference inventory aud..." | Re-trigger Greptile}

Dismissed because a newer commit was pushed; Greptile will re-review the current head.