Internal

Reader Navigation Internals

The reader shell switches documents from the navbar and renders document-specific sidebar navigation and routes.

uinavigationsearchreaderrouting

Key files

  • components/docs-shell.tsx
  • components/function-reference.tsx
  • components/markdown-content.tsx
  • src/pages/index.astro
  • src/pages/[documentSlug]/index.astro
  • src/pages/[documentSlug]/[entryId].astro

Routes

  • / renders the default document and its first entry. Documentation is the default only when it has visible concepts; otherwise an available project plan is used as the root document.
  • /documentation/ renders the first visible documentation concept.
  • /documentation/:conceptId/ renders a documentation concept.
  • /project-plan/ renders the first project plan section.
  • /project-plan/:sectionId/ renders a project plan section.
  • /task-tree/ renders the fullscreen task graph workspace.
  • /task-tree/:taskId/ renders the fullscreen task graph workspace with the selected task drawer open.
  • Function and type entries use hash anchors under the owning documentation concept route.

Behavior

  • The header navbar lists every recognized document in the collection.
  • The sidebar shows documentation categories for documentation pages.
  • The sidebar shows project plan areas for project plan pages.
  • Task tree pages do not use a sidebar; the graph is the primary workspace.
  • Search is scoped to the active document.
  • Documentation search returns concepts, function entries, and type entries.
  • Project plan search returns plan sections and searches section summaries, intro Markdown, and detail blocks.
  • Project plan pages render section summaries, free-form intro Markdown, and ### detail blocks.
  • Task tree search returns tasks.
  • Task tree pages render a pannable, zoomable SVG graph with task statuses, decomposition edges, dependency edges, and a right-side detail drawer.
  • Inline type references inside function and type cards link back to the owning TypeReferenceTarget.