Skip to content

docs(api): keep examples aligned with public exports - #2

Merged
fabiorosa merged 1 commit into
mainfrom
agent/docs-api-contract
Jul 27, 2026
Merged

docs(api): keep examples aligned with public exports#2
fabiorosa merged 1 commit into
mainfrom
agent/docs-api-contract

Conversation

@fabiorosa

Copy link
Copy Markdown
Owner

What changed

  • corrected the architecture example to use the published root and raster
    entry points
  • replaced the nonexistent templates aggregate with the named blogPost
    export
  • added a regression test for documented imports, package export paths, and
    runtime symbols
  • recorded the maintenance ticket and updated the verified test count

Why

The architecture example did not match the API published on npm. Documentation
for a library is part of its public contract, and copied examples should not
fail at the first TypeScript import.

Impact

No runtime API, rendering behavior, template, Studio interface, package version,
or npm release changed.

Validation

  • 78 core tests
  • 9 Studio tests
  • lint
  • strict typecheck
  • core and Studio builds

Closes #1

Treat documented entry points as a tested package contract. Refs #1
@fabiorosa
fabiorosa marked this pull request as ready for review July 27, 2026 22:37
@fabiorosa
fabiorosa merged commit 9683659 into main Jul 27, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

docs(api): keep examples aligned with public exports

2 participants