fix(website): render grouped API entries on middleware helpers page - #815
Merged
Conversation
The middleware API Reference is a single page covering nine exported helpers. It carried the "Auto-rendered from api-docs.json" marker, but the renderer only ever matched one entry by the page's H1 — and "LangGraph.js client-tool helpers" matches no export. So the page rendered zero generated entries, and every middleware export was absent from the site's API reference. That mismatch is what `docs.spec.ts > auto-rendered API pages resolve generated entries` has been failing on. Add an optional `apiEntries` to DocsPage for pages documenting a group of exports. The docs route renders each named entry in order; pages without it keep the existing match-by-title behavior. The spec now asserts every declared entry exists rather than skipping group pages. Verified all nine helpers render on /docs/middleware/api/client-tool-helpers. docs.spec.ts goes 15/16 -> 16/16; website suite 12 failures -> 11, none new. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
blove
enabled auto-merge (squash)
August 14, 2026 04:49
|
The latest updates on your projects. Learn more about Vercel for GitHub.
|
![github-actions[bot]](https://avatars.githubusercontent.com/in/15368?s=60&v=4){kind=small}
Contributor
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Picks up the first of the two flagged tasks. The second turned out to be a non-issue — details below.
The middleware API page rendered nothing
docs/middleware/api/client-tool-helpers.mdxcarries theAuto-rendered from api-docs.jsonmarker, but the docs route only ever matched one entry, by the page's H1. The H1 is "LangGraph.js client-tool helpers", which matches no export — so the page rendered zero generated entries.Since that page is the entirety of middleware's API Reference section, every middleware export —
bindClientTools,routeAfterAgent, the Postgres execution store, all of it — was missing from the site's API reference.docs.spec.ts > auto-rendered API pages resolve generated entrieshas been failing on exactly this.Fix: an optional
apiEntriesonDocsPagefor pages that document a group of exports. The route renders each named entry in order; pages without it keep the existing match-by-title behavior. The spec now asserts every declared entry actually exists, rather than skipping group pages — a stronger check than before.Verified in a browser: all nine helpers now render with signatures below the page prose.
The blog hydration error is dev-only
Investigated and could not find a real defect, so nothing is changed for it here.
threadplane.aion a real production build.Conclusion: Turbopack dev-server noise, not a user-facing bug. Shipping a speculative fix for it would be worse than leaving it, so I've closed that task rather than guessing.
Checks
docs.spec.ts: 15/16 → 16/16apps/websitesuite: 12 failures → 11, none new (baseline confirmed by stashing)nx lint website: 0 errors🤖 Generated with Claude Code