@hirobius/design-system 0.23.1 → 0.24.0

package/public/hds-manifest.json

@@ -2,11 +2,11 @@
   "name": "Hirobius Design System",
   "description": "Three-tier design token system for Adrian Milsap's portfolio site. Tokens flow primitive → semantic → component. All visual decisions trace back to hirobius.tokens.json.",
   "version": "1",
-  "generated": "2026-10-11T06:18:15.595Z",
+  "generated": "2026-10-11T21:00:30.237Z",
   "source": "hirobius.tokens.json",
   "format": "W3C DTCG 2025.10",
-  "docs": "https://hirobius-design-system.vercel.app/",
-  "llmsTxt": "https://hirobius-design-system.vercel.app/llms.txt",
+  "docs": "https://hirobius-hds-components.vercel.app/",
+  "llmsTxt": "https://hirobius-hds-components.vercel.app/llms.txt",
   "systemSpecs": {
     "engine": "React + TypeScript",
     "icons": "Lucide React",
@@ -28,7 +28,7 @@
     "consumeTypography": "hds.typeStyles.h1 (inline style object) — never Tailwind font classes"
   },
   "brand": {
-    "primaryColor": "#66b239",
+    "primaryColor": "#433a3f",
     "primaryColorToken": "semantic.accent.rest",
     "font": "Plus Jakarta Sans variable 100–900, self-hosted",
     "spacingBase": "4px",
@@ -402,10 +402,7 @@
         "src/app/components/callout.tsx",
         "src/app/components/dialog.tsx",
         "src/app/components/empty-state.tsx",
-        "src/app/components/toast.tsx",
-        "src/stories/alert-dialog.stories.tsx",
-        "src/stories/alert.stories.tsx",
-        "src/stories/static-primitives.stories.tsx"
+        "src/app/components/toast.tsx"
       ],
       "tokenMapping": {
         "Success accent": "semantic.color.feedback.success",
@@ -514,17 +511,7 @@
           ]
         }
       },
-      "storyFiles": [
-        "src/stories/alert.stories.tsx"
-      ],
-      "storyIds": [
-        "primitives-alert--all-variants",
-        "primitives-alert--error",
-        "primitives-alert--info",
-        "primitives-alert--success",
-        "primitives-alert--warning",
-        "primitives-alert--with-title"
-      ],
+      "docsPage": "/docs/components/alert",
       "usage": {
         "when": "Show a persistent inline message with a severity, next to the content it concerns.",
         "whenNot": "A brief confirmation that should disappear on its own, or a status label.",
@@ -554,9 +541,7 @@
         "exportName": "CodeBlock",
         "sizing": "panel"
       },
-      "consumers": [
-        "src/stories/code-block.stories.tsx"
-      ],
+      "consumers": [],
       "tokenMapping": {
         "Surface fill": "semantic.color.surface.raised",
         "Border stroke": "semantic.color.border.default",
@@ -614,16 +599,7 @@
       "docExempt": false,
       "sourcePath": "src/app/components/CodeBlock.tsx",
       "figmaLink": "https://www.figma.com/design/2VgBbVpKiDnu0aftJEVyBQ/HDS-Tokens-Components?node-id=89-154",
-      "storyFiles": [
-        "src/stories/code-block.stories.tsx"
-      ],
-      "storyIds": [
-        "primitives-code-block--collapsible",
-        "primitives-code-block--css-highlighting",
-        "primitives-code-block--default",
-        "primitives-code-block--inline",
-        "primitives-code-block--json-highlighting"
-      ],
+      "docsPage": "/docs/patterns/code-block",
       "usage": {
         "when": "Show a code sample with a copy button, optionally collapsed."
       }
@@ -646,11 +622,7 @@
         "src/app/components/page.tsx",
         "src/app/components/switcher.tsx",
         "src/app/context/__tests__/portal-scope.test.tsx",
-        "src/index.ts",
-        "src/stories/box.stories.tsx",
-        "src/stories/container.stories.tsx",
-        "src/stories/page.stories.tsx",
-        "src/stories/patterns-layout.stories.tsx"
+        "src/index.ts"
       ],
       "tokenMapping": {},
       "props": {
@@ -690,13 +662,7 @@
       "docExempt": false,
       "sourcePath": "src/app/components/Container.tsx",
       "figmaLink": null,
-      "storyFiles": [
-        "src/stories/container.stories.tsx"
-      ],
-      "storyIds": [
-        "primitives-container--content-width",
-        "primitives-container--max-width"
-      ],
+      "docsPage": "/docs/components/utilities",
       "usage": {
         "when": "Constrain a page region to the content or maximum width and centre it.",
         "whenNot": "Spacing between siblings, columns, or a surface with padding.",
@@ -732,8 +698,7 @@
         "sizing": "panel"
       },
       "consumers": [
-        "src/app/components/tabs.tsx",
-        "src/stories/disclosure.stories.tsx"
+        "src/app/components/tabs.tsx"
       ],
       "tokenMapping": {
         "Surface fill": "semantic.color.surface.raised",
@@ -830,15 +795,7 @@
       ],
       "sourcePath": "src/app/components/Disclosure.tsx",
       "figmaLink": "https://www.figma.com/design/2VgBbVpKiDnu0aftJEVyBQ/HDS-Tokens-Components?node-id=88-453",
-      "storyFiles": [
-        "src/stories/disclosure.stories.tsx"
-      ],
-      "storyIds": [
-        "primitives-disclosure--controlled",
-        "primitives-disclosure--multiple-items",
-        "primitives-disclosure--open-by-default",
-        "primitives-disclosure--panel"
-      ],
+      "docsPage": "/docs/components/disclosure",
       "usage": {
         "when": "Hide optional explanatory content behind a heading that people can expand.",
         "whenNot": "Content people must see, or switching between panels.",
@@ -865,9 +822,7 @@
         "sizing": "panel"
       },
       "consumers": [
-        "src/app/components/metadata-list.tsx",
-        "src/stories/divider.stories.tsx",
-        "src/stories/static-primitives.stories.tsx"
+        "src/app/components/metadata-list.tsx"
       ],
       "tokenMapping": {
         "Default stroke": "semantic.color.border.default",
@@ -943,17 +898,7 @@
           ]
         }
       },
-      "storyFiles": [
-        "src/stories/divider.stories.tsx"
-      ],
-      "storyIds": [
-        "primitives-divider--between-sections",
-        "primitives-divider--horizontal",
-        "primitives-divider--horizontal-strong",
-        "primitives-divider--legacy-strong-prop",
-        "primitives-divider--vertical",
-        "primitives-divider--with-spacing"
-      ],
+      "docsPage": "/docs/components/divider",
       "usage": {
         "when": "Separate two blocks of content with a thin line.",
         "whenNot": "Spacing alone would do, or the separation needs a container.",
@@ -984,8 +929,7 @@
         "sizing": "panel"
       },
       "consumers": [
-        "src/index.ts",
-        "src/stories/error-pattern.stories.tsx"
+        "src/index.ts"
       ],
       "tokenMapping": {
         "Headline typography": "semantic.typography.display",
@@ -1055,15 +999,7 @@
       "tier": "template",
       "docExempt": false,
       "figmaLink": "https://www.figma.com/design/2VgBbVpKiDnu0aftJEVyBQ/HDS-Tokens-Components?node-id=2121-839",
-      "storyFiles": [
-        "src/stories/error-pattern.stories.tsx"
-      ],
-      "storyIds": [
-        "feedback-error-pattern--default",
-        "feedback-error-pattern--not-found",
-        "feedback-error-pattern--server-error",
-        "feedback-error-pattern--unauthorized"
-      ],
+      "docsPage": "/docs/patterns/error-pattern",
       "usage": {
         "when": "Show an error with a short message and a Back button, in place or as a full page."
       }
@@ -1094,13 +1030,7 @@
         "src/app/components/stack.tsx",
         "src/app/components/table.tsx",
         "src/app/components/tooltip.tsx",
-        "src/index.ts",
-        "src/stories/box.stories.tsx",
-        "src/stories/grid.stories.tsx",
-        "src/stories/patterns-layout.stories.tsx",
-        "src/stories/segmented-control.stories.tsx",
-        "src/stories/status-tile.stories.tsx",
-        "src/stories/surface.stories.tsx"
+        "src/index.ts"
       ],
       "tokenMapping": {},
       "props": {
@@ -1230,16 +1160,7 @@
       "docExempt": false,
       "sourcePath": "src/app/components/Grid.tsx",
       "figmaLink": null,
-      "storyFiles": [
-        "src/stories/grid.stories.tsx"
-      ],
-      "storyIds": [
-        "primitives-grid--aside-layout",
-        "primitives-grid--auto-fill",
-        "primitives-grid--auto-fit",
-        "primitives-grid--three-column",
-        "primitives-grid--two-column"
-      ],
+      "docsPage": "/docs/components/grid",
       "usage": {
         "when": "Lay out content in columns that adapt to the screen width, or line up nested content with subgrid.",
         "whenNot": "A single row or column, or styling a surface.",
@@ -1275,6 +1196,7 @@
         "src/app/components/avatar.tsx",
         "src/app/components/breadcrumb.tsx",
         "src/app/components/button.test.tsx",
+        "src/app/components/button.tsx",
         "src/app/components/checkbox.tsx",
         "src/app/components/code-block.tsx",
         "src/app/components/combobox.tsx",
@@ -1288,10 +1210,7 @@
         "src/app/components/pagination.tsx",
         "src/app/components/select.tsx",
         "src/app/components/table.tsx",
-        "src/app/components/toast.tsx",
-        "src/stories/data-table-section.stories.tsx",
-        "src/stories/icon.stories.tsx",
-        "src/stories/patterns-client-detail.stories.tsx"
+        "src/app/components/toast.tsx"
       ],
       "tokenMapping": {
         "Small icon size": "primitive.typography.size.base",
@@ -1401,17 +1320,7 @@
       "docExempt": false,
       "sourcePath": "src/app/components/Icon.tsx",
       "figmaLink": "https://www.figma.com/design/2VgBbVpKiDnu0aftJEVyBQ/HDS-Tokens-Components?node-id=27-2",
-      "storyFiles": [
-        "src/stories/icon.stories.tsx"
-      ],
-      "storyIds": [
-        "primitives-icon--default",
-        "primitives-icon--large",
-        "primitives-icon--medium",
-        "primitives-icon--semantic-color",
-        "primitives-icon--semantic-colors",
-        "primitives-icon--size-gallery"
-      ],
+      "docsPage": "/docs/components/icon",
       "usage": {
         "when": "Show a Lucide icon at a set size and color.",
         "whenNot": "A control someone can activate, or a picture that carries content.",
@@ -1443,9 +1352,7 @@
       },
       "consumers": [
         "src/app/components/inline-code.test.tsx",
-        "src/app/components/metadata-list.tsx",
-        "src/stories/inline-code.stories.tsx",
-        "src/stories/metadata-list.stories.tsx"
+        "src/app/components/metadata-list.tsx"
       ],
       "tokenMapping": {
         "Font family": "primitive.typography.family.mono",
@@ -1492,18 +1399,7 @@
       "docExempt": false,
       "sourcePath": "src/app/components/InlineCode.tsx",
       "figmaLink": "https://www.figma.com/design/2VgBbVpKiDnu0aftJEVyBQ/HDS-Tokens-Components?node-id=89-155",
-      "storyFiles": [
-        "src/stories/inline-code.stories.tsx"
-      ],
-      "storyIds": [
-        "primitives-inline-code--comfortable",
-        "primitives-inline-code--compact",
-        "primitives-inline-code--compact-deprecated-alias",
-        "primitives-inline-code--copyable",
-        "primitives-inline-code--copyable-in-prose",
-        "primitives-inline-code--default",
-        "primitives-inline-code--in-prose"
-      ]
+      "docsPage": null
     },
     "InlineLink": {
       "category": "Navigation",
@@ -1521,9 +1417,7 @@
       "consumers": [
         "src/app/components/button.tsx",
         "src/app/components/inline-link.test.tsx",
-        "src/app/components/text.tsx",
-        "src/stories/inline-link.stories.tsx",
-        "src/stories/lib/usage-description.test.ts"
+        "src/app/components/text.tsx"
       ],
       "tokenMapping": {
         "Link text": "semantic.color.content.accent",
@@ -1570,15 +1464,7 @@
       "docExempt": false,
       "sourcePath": "src/app/components/InlineLink.tsx",
       "figmaLink": "https://www.figma.com/design/2VgBbVpKiDnu0aftJEVyBQ/HDS-Tokens-Components?node-id=89-161",
-      "storyFiles": [
-        "src/stories/inline-link.stories.tsx"
-      ],
-      "storyIds": [
-        "primitives-inline-link--default",
-        "primitives-inline-link--external-no-icon",
-        "primitives-inline-link--in-body-copy",
-        "primitives-inline-link--internal-route"
-      ],
+      "docsPage": "/docs/components/inline-link",
       "usage": {
         "when": "Link to a route or external URL from inside body copy.",
         "whenNot": "An action that changes something, or a control that needs button styling.",
@@ -1618,11 +1504,7 @@
         "src/app/components/slider.tsx",
         "src/app/components/textarea.tsx",
         "src/app/design-system/generated-token-descriptions.ts",
-        "src/index.ts",
-        "src/stories/combobox.stories.tsx",
-        "src/stories/input.stories.tsx",
-        "src/stories/patterns-layout.stories.tsx",
-        "src/stories/textarea.stories.tsx"
+        "src/index.ts"
       ],
       "tokenMapping": {
         "Surface fill": "role.background",
@@ -1855,20 +1737,7 @@
       "tier": "primitive",
       "docExempt": false,
       "figmaLink": "https://www.figma.com/design/2VgBbVpKiDnu0aftJEVyBQ/HDS-Tokens-Components?node-id=38-20",
-      "storyFiles": [
-        "src/stories/input.stories.tsx"
-      ],
-      "storyIds": [
-        "primitives-input--date-and-time",
-        "primitives-input--default",
-        "primitives-input--disabled",
-        "primitives-input--loading",
-        "primitives-input--mono",
-        "primitives-input--prefix-and-suffix",
-        "primitives-input--size-variants",
-        "primitives-input--with-error",
-        "primitives-input--with-helper"
-      ],
+      "docsPage": "/docs/components/input",
       "usage": {
         "when": "Collect a single line of text, a number, an email, a password, a date or a time, with label, helper and error slots.",
         "whenNot": "Multi-line text, or choosing from a fixed list of options.",
@@ -1906,8 +1775,7 @@
         "src/app/components/radio.tsx",
         "src/app/components/segmented-control.test.tsx",
         "src/app/components/tabs.tsx",
-        "src/app/hooks/useInteractionState.ts",
-        "src/stories/segmented-control.stories.tsx"
+        "src/app/hooks/useInteractionState.ts"
       ],
       "tokenMapping": {
         "Frame surface fill": "semantic.color.surface.page",
@@ -2013,15 +1881,7 @@
       "docExempt": false,
       "sourcePath": "src/app/components/SegmentedControl.tsx",
       "figmaLink": "https://www.figma.com/design/2VgBbVpKiDnu0aftJEVyBQ/HDS-Tokens-Components?node-id=82-334",
-      "storyFiles": [
-        "src/stories/segmented-control.stories.tsx"
-      ],
-      "storyIds": [
-        "primitives-segmented-control--compact",
-        "primitives-segmented-control--full-width",
-        "primitives-segmented-control--primary",
-        "primitives-segmented-control--secondary"
-      ],
+      "docsPage": "/docs/components/segmented-control",
       "usage": {
         "when": "Switch between two to five mutually exclusive views or modes in a compact row.",
         "whenNot": "A form choice that submits with the form, or more than five options.",
@@ -2075,14 +1935,7 @@
         "src/app/components/switcher.tsx",
         "src/app/components/table.tsx",
         "src/app/components/tooltip.tsx",
-        "src/index.ts",
-        "src/stories/box.stories.tsx",
-        "src/stories/code-block.stories.tsx",
-        "src/stories/grid.stories.tsx",
-        "src/stories/page.stories.tsx",
-        "src/stories/patterns-client-detail.stories.tsx",
-        "src/stories/patterns-layout.stories.tsx",
-        "src/stories/stack.stories.tsx"
+        "src/index.ts"
       ],
       "tokenMapping": {
         "Default gap": "primitive.space.3",
@@ -2205,16 +2058,7 @@
       "docExempt": false,
       "sourcePath": "src/app/components/Stack.tsx",
       "figmaLink": null,
-      "storyFiles": [
-        "src/stories/stack.stories.tsx"
-      ],
-      "storyIds": [
-        "primitives-stack--column",
-        "primitives-stack--row",
-        "primitives-stack--space-between",
-        "primitives-stack--spacious-gap",
-        "primitives-stack--tight-gap"
-      ],
+      "docsPage": "/docs/components/stack",
       "usage": {
         "when": "Space items in a row or column with even gaps.",
         "whenNot": "Multi-column layout, or giving content a background or padding.",
@@ -2248,10 +2092,7 @@
       "consumers": [
         "src/app/components/data-table-section.tsx",
         "src/app/components/table.test.tsx",
-        "src/app/data/manifest-types.ts",
-        "src/stories/data-table-section.stories.tsx",
-        "src/stories/segmented-control.stories.tsx",
-        "src/stories/table.stories.tsx"
+        "src/app/data/manifest-types.ts"
       ],
       "tokenMapping": {},
       "props": {
@@ -2336,19 +2177,7 @@
       "docExempt": false,
       "sourcePath": "src/app/components/Table.tsx",
       "figmaLink": "https://www.figma.com/design/2VgBbVpKiDnu0aftJEVyBQ/HDS-Tokens-Components?node-id=89-300",
-      "storyFiles": [
-        "src/stories/table.stories.tsx"
-      ],
-      "storyIds": [
-        "primitives-table--default",
-        "primitives-table--density-comfortable",
-        "primitives-table--density-compact",
-        "primitives-table--flush",
-        "primitives-table--follows-density-dial",
-        "primitives-table--sortable",
-        "primitives-table--with-badge-slots",
-        "primitives-table--with-caption"
-      ],
+      "docsPage": "/docs/components/table",
       "usage": {
         "when": "Show rows of structured data in aligned columns, with optional sorting.",
         "whenNot": "A single record, a short list of links, or content that reflows as cards.",
@@ -2392,9 +2221,7 @@
         "src/app/components/switcher.tsx",
         "src/app/components/text.tsx",
         "src/app/components/visually-hidden.tsx",
-        "src/app/design-system/generated-token-descriptions.ts",
-        "src/stories/static-primitives.stories.tsx",
-        "src/stories/tag.stories.tsx"
+        "src/app/design-system/generated-token-descriptions.ts"
       ],
       "tokenMapping": {
         "Surface fill": "component.tag.background",
@@ -2489,17 +2316,7 @@
       "docExempt": false,
       "sourcePath": "src/app/components/Tag.tsx",
       "figmaLink": "https://www.figma.com/design/2VgBbVpKiDnu0aftJEVyBQ/HDS-Tokens-Components?node-id=32-11",
-      "storyFiles": [
-        "src/stories/tag.stories.tsx"
-      ],
-      "storyIds": [
-        "primitives-tag--active",
-        "primitives-tag--default",
-        "primitives-tag--disabled",
-        "primitives-tag--filter-row",
-        "primitives-tag--interactive",
-        "primitives-tag--state-matrix"
-      ],
+      "docsPage": "/docs/components/tag",
       "usage": {
         "when": "Show an interactive filter or category chip that people can toggle.",
         "whenNot": "A read-only status or count label.",
@@ -2542,13 +2359,7 @@
         "src/app/components/table.tsx",
         "src/app/components/tooltip.test.tsx",
         "src/app/components/tooltip.tsx",
-        "src/app/context/hds-theme.tsx",
-        "src/stories/card.stories.tsx",
-        "src/stories/container.stories.tsx",
-        "src/stories/grid.stories.tsx",
-        "src/stories/page.stories.tsx",
-        "src/stories/patterns-layout.stories.tsx",
-        "src/stories/surface.stories.tsx"
+        "src/app/context/hds-theme.tsx"
       ],
       "tokenMapping": {},
       "props": {
@@ -2618,16 +2429,7 @@
       "states": [
         "default"
       ],
-      "storyFiles": [
-        "src/stories/surface.stories.tsx"
-      ],
-      "storyIds": [
-        "primitives-surface--card-grid",
-        "primitives-surface--default",
-        "primitives-surface--forced-dark",
-        "primitives-surface--item-padding",
-        "primitives-surface--with-shadow"
-      ],
+      "docsPage": "/docs/components/surface",
       "usage": {
         "when": "Give a block of content a background and padding, with no header or footer.",
         "whenNot": "Page layout, section spacing, width constraints, or content that needs slots.",
@@ -2672,11 +2474,7 @@
         "src/app/components/surface-padding.ts",
         "src/app/components/surface.tsx",
         "src/app/design-system/generated-token-descriptions.ts",
-        "src/index.ts",
-        "src/stories/card.stories.tsx",
-        "src/stories/grid.stories.tsx",
-        "src/stories/metric-tiles.stories.tsx",
-        "src/stories/static-primitives.stories.tsx"
+        "src/index.ts"
       ],
       "tokenMapping": {
         "Surface fill": "role.card",
@@ -2859,23 +2657,7 @@
           ]
         }
       },
-      "storyFiles": [
-        "src/stories/card.stories.tsx"
-      ],
-      "storyIds": [
-        "primitives-card--bordered",
-        "primitives-card--default",
-        "primitives-card--elevated",
-        "primitives-card--feedback-tones",
-        "primitives-card--full-anatomy",
-        "primitives-card--header-only",
-        "primitives-card--metric-slot",
-        "primitives-card--padding-variants",
-        "primitives-card--progress-slot",
-        "primitives-card--selectable",
-        "primitives-card--tone-matrix",
-        "primitives-card--variant-accent"
-      ],
+      "docsPage": "/docs/components/card",
       "usage": {
         "when": "Group related content on a raised surface with header, body, footer and metric slots, or as one selectable option.",
         "whenNot": "A bare padded background with no slot anatomy, or a single headline figure.",
@@ -2944,17 +2726,7 @@
         "src/app/components/table.tsx",
         "src/app/components/visually-hidden.tsx",
         "src/app/design-system/generated-token-descriptions.ts",
-        "src/brand/overlay.ts",
-        "src/stories/container.stories.tsx",
-        "src/stories/disclosure.stories.tsx",
-        "src/stories/grid.stories.tsx",
-        "src/stories/inline-code.stories.tsx",
-        "src/stories/input.stories.tsx",
-        "src/stories/page.stories.tsx",
-        "src/stories/patterns-layout.stories.tsx",
-        "src/stories/skeleton.stories.tsx",
-        "src/stories/surface.stories.tsx",
-        "src/stories/text.stories.tsx"
+        "src/brand/overlay.ts"
       ],
       "tokenMapping": {},
       "variantAxes": [],
@@ -2963,20 +2735,7 @@
       "docExempt": true,
       "sourcePath": "src/app/components/Text.tsx",
       "figmaLink": "https://www.figma.com/design/2VgBbVpKiDnu0aftJEVyBQ/HDS-Tokens-Components?node-id=2022-31",
-      "storyFiles": [
-        "src/stories/text.stories.tsx"
-      ],
-      "storyIds": [
-        "primitives-text--body",
-        "primitives-text--caption",
-        "primitives-text--display",
-        "primitives-text--full-ramp",
-        "primitives-text--heading-1",
-        "primitives-text--heading-2",
-        "primitives-text--heading-3",
-        "primitives-text--technical",
-        "primitives-text--ui"
-      ],
+      "docsPage": "/docs/components/text",
       "usage": {
         "when": "Set any text on the type ramp, with the element chosen by `as`.",
         "whenNot": "Navigation links, or a keyboard hint.",
@@ -3017,11 +2776,6 @@
         "src/app/components/toast.tsx",
         "src/app/context/__tests__/portal-hydration.test.tsx",
         "src/app/context/__tests__/portal-scope.test.tsx",
-        "src/stories/alert-dialog.stories.tsx",
-        "src/stories/alert.stories.tsx",
-        "src/stories/combobox.stories.tsx",
-        "src/stories/dialog.stories.tsx",
-        "src/stories/table.stories.tsx",
         "src/styles/__tests__/scrim-and-color-scheme.test.ts"
       ],
       "tokenMapping": {},
@@ -3200,16 +2954,7 @@
           "type": "boolean"
         }
       },
-      "storyFiles": [
-        "src/stories/dialog.stories.tsx"
-      ],
-      "storyIds": [
-        "primitives-dialog--dark-scope",
-        "primitives-dialog--default",
-        "primitives-dialog--destructive",
-        "primitives-dialog--information",
-        "primitives-dialog--no-close-affordance"
-      ],
+      "docsPage": "/docs/components/dialog",
       "usage": {
         "when": "Interrupt the page with a modal that needs a decision or focused input before people continue.",
         "whenNot": "A preview on hover, a message that needs no reply, or content that can stay inline.",
@@ -3296,24 +3041,6 @@
         "src/form/index.ts",
         "src/index.ts",
         "src/mui/index.ts",
-        "src/stories/alert-dialog.stories.tsx",
-        "src/stories/button.stories.tsx",
-        "src/stories/code-block.stories.tsx",
-        "src/stories/combobox.stories.tsx",
-        "src/stories/data-table-section.stories.tsx",
-        "src/stories/dialog.stories.tsx",
-        "src/stories/form-actions.stories.tsx",
-        "src/stories/form.stories.tsx",
-        "src/stories/hds-tooltip.stories.tsx",
-        "src/stories/inline-code.stories.tsx",
-        "src/stories/lib/usage-description.test.ts",
-        "src/stories/menu.stories.tsx",
-        "src/stories/page-header.stories.tsx",
-        "src/stories/patterns-client-detail.stories.tsx",
-        "src/stories/patterns-layout.stories.tsx",
-        "src/stories/popover.stories.tsx",
-        "src/stories/table.stories.tsx",
-        "src/stories/toast.stories.tsx",
         "src/styles/__tests__/pressed-overlay-token.test.ts"
       ],
       "tokenMapping": {},
@@ -3509,23 +3236,7 @@
           ]
         }
       },
-      "storyFiles": [
-        "src/stories/button.stories.tsx"
-      ],
-      "storyIds": [
-        "primitives-button--all-variants-row",
-        "primitives-button--disabled",
-        "primitives-button--icon-only",
-        "primitives-button--large",
-        "primitives-button--loading",
-        "primitives-button--medium",
-        "primitives-button--pressed",
-        "primitives-button--primary",
-        "primitives-button--secondary",
-        "primitives-button--small",
-        "primitives-button--tertiary",
-        "primitives-button--tone-matrix"
-      ],
+      "docsPage": "/docs/components/button",
       "usage": {
         "when": "Run an action, such as submit, save or open a dialog. For an icon-only control pass iconOnly, iconLeft and label; for an on/off toggle pass pressed.",
         "whenNot": "Navigating to another page, where a link is the correct element.",
@@ -3554,9 +3265,7 @@
         "exportName": "Callout",
         "sizing": "panel"
       },
-      "consumers": [
-        "src/stories/callout.stories.tsx"
-      ],
+      "consumers": [],
       "tokenMapping": {},
       "variantAxes": [],
       "componentProperties": [],
@@ -3602,18 +3311,7 @@
           "required": false
         }
       ],
-      "storyFiles": [
-        "src/stories/callout.stories.tsx"
-      ],
-      "storyIds": [
-        "primitives-callout--accent",
-        "primitives-callout--all-tones",
-        "primitives-callout--danger",
-        "primitives-callout--default",
-        "primitives-callout--italic",
-        "primitives-callout--success",
-        "primitives-callout--warning"
-      ]
+      "docsPage": null
     },
     "EmptyState": {
       "category": "Display",
@@ -3632,10 +3330,7 @@
         "sizing": "panel"
       },
       "consumers": [
-        "src/app/components/data-table-section.tsx",
-        "src/stories/data-table-section.stories.tsx",
-        "src/stories/empty-state.stories.tsx",
-        "src/stories/patterns-layout.stories.tsx"
+        "src/app/components/data-table-section.tsx"
       ],
       "tokenMapping": {},
       "variantAxes": [],
@@ -3659,15 +3354,7 @@
       "propConstraints": {},
       "requiredProps": [],
       "a11yRules": [],
-      "storyFiles": [
-        "src/stories/empty-state.stories.tsx"
-      ],
-      "storyIds": [
-        "primitives-empty-state--default",
-        "primitives-empty-state--in-grid",
-        "primitives-empty-state--title-only",
-        "primitives-empty-state--with-description"
-      ],
+      "docsPage": "/docs/components/empty-state",
       "usage": {
         "when": "Say that a list, grid or section has no data yet, with a title and an optional description.",
         "whenNot": "Content that is still loading, or a full-page error.",
@@ -3707,9 +3394,7 @@
         "src/app/components/input.tsx",
         "src/app/components/table.tsx",
         "src/app/components/textarea.tsx",
-        "src/form/hds-form.tsx",
-        "src/stories/field.stories.tsx",
-        "src/stories/patterns-layout.stories.tsx"
+        "src/form/hds-form.tsx"
       ],
       "tokenMapping": {},
       "variantAxes": [],
@@ -3772,20 +3457,7 @@
           "required": false
         }
       ],
-      "storyFiles": [
-        "src/stories/field.stories.tsx"
-      ],
-      "storyIds": [
-        "primitives-field--all-tones",
-        "primitives-field--danger",
-        "primitives-field--default",
-        "primitives-field--info",
-        "primitives-field--metadata-grid",
-        "primitives-field--mono",
-        "primitives-field--success",
-        "primitives-field--warning",
-        "primitives-field--with-children"
-      ],
+      "docsPage": "/docs/components/field",
       "usage": {
         "when": "Show a labelled read-only value, such as a name and its value in a detail view.",
         "whenNot": "Editable input, or a single headline figure.",
@@ -3826,12 +3498,7 @@
         "src/app/components/surface.tsx",
         "src/app/components/toast.tsx",
         "src/app/design-system/generated-token-descriptions.ts",
-        "src/brand/overlay.ts",
-        "src/stories/error-pattern.stories.tsx",
-        "src/stories/page.stories.tsx",
-        "src/stories/pagination.stories.tsx",
-        "src/stories/patterns-layout.stories.tsx",
-        "src/stories/table.stories.tsx"
+        "src/brand/overlay.ts"
       ],
       "tokenMapping": {},
       "variantAxes": [],
@@ -3872,20 +3539,7 @@
       "propConstraints": {},
       "requiredProps": [],
       "a11yRules": [],
-      "storyFiles": [
-        "src/stories/page.stories.tsx",
-        "src/stories/patterns-layout.stories.tsx"
-      ],
-      "storyIds": [
-        "layout-page--compact-padding",
-        "layout-page--content-width",
-        "layout-page--default",
-        "layout-page--no-padding",
-        "patterns-layout--dashboard-grid",
-        "patterns-layout--detail-page",
-        "patterns-layout--empty-state-screen",
-        "patterns-layout--form-screen"
-      ],
+      "docsPage": "/docs/patterns/page",
       "usage": {
         "when": "Wrap a screen in the standard width and padding."
       }
@@ -3907,9 +3561,7 @@
         "sizing": "panel"
       },
       "consumers": [
-        "src/app/components/metric-tiles.tsx",
-        "src/stories/metric-tiles.stories.tsx",
-        "src/stories/stat.stories.tsx"
+        "src/app/components/metric-tiles.tsx"
       ],
       "tokenMapping": {},
       "variantAxes": [],
@@ -3963,17 +3615,7 @@
           "required": false
         }
       ],
-      "storyFiles": [
-        "src/stories/stat.stories.tsx"
-      ],
-      "storyIds": [
-        "primitives-stat--all-tones",
-        "primitives-stat--danger",
-        "primitives-stat--default",
-        "primitives-stat--success",
-        "primitives-stat--warning",
-        "primitives-stat--with-sub"
-      ],
+      "docsPage": null,
       "usage": {
         "when": "Show one headline figure inline, inside prose or a dense list, with its label and an optional sub-line.",
         "whenNot": "A row of headline numbers on a screen, a figure inside a Card, or a status with a trailing badge.",
@@ -4010,9 +3652,7 @@
         "sizing": "panel"
       },
       "consumers": [
-        "src/app/components/status-tile.tsx",
-        "src/stories/status-list-item.stories.test.tsx",
-        "src/stories/status-list-item.stories.tsx"
+        "src/app/components/status-tile.tsx"
       ],
       "tokenMapping": {},
       "variantAxes": [],
@@ -4063,17 +3703,7 @@
           "required": true
         }
       ],
-      "storyFiles": [
-        "src/stories/status-list-item.stories.tsx"
-      ],
-      "storyIds": [
-        "primitives-status-list-item--danger",
-        "primitives-status-list-item--default",
-        "primitives-status-list-item--info",
-        "primitives-status-list-item--success",
-        "primitives-status-list-item--warning",
-        "primitives-status-list-item--with-trailing"
-      ]
+      "docsPage": null
     },
     "StatusTile": {
       "category": "Display",
@@ -4095,11 +3725,7 @@
         "src/app/components/metric-tiles.tsx",
         "src/app/components/stat.tsx",
         "src/index.ts",
-        "src/patterns.ts",
-        "src/stories/metric-tiles.stories.tsx",
-        "src/stories/status-list-item.stories.tsx",
-        "src/stories/status-tile.stories.test.tsx",
-        "src/stories/status-tile.stories.tsx"
+        "src/patterns.ts"
       ],
       "tokenMapping": {},
       "variantAxes": [],
@@ -4134,16 +3760,7 @@
       "propConstraints": {},
       "requiredProps": [],
       "a11yRules": [],
-      "storyFiles": [
-        "src/stories/status-tile.stories.tsx"
-      ],
-      "storyIds": [
-        "primitives-status-tile--danger",
-        "primitives-status-tile--default",
-        "primitives-status-tile--in-grid",
-        "primitives-status-tile--warning",
-        "primitives-status-tile--with-trailing-badge"
-      ],
+      "docsPage": "/docs/patterns/status-tile",
       "usage": {
         "when": "Show a titled status block with optional notes and a trailing badge or affordance.",
         "whenNot": "A headline number (never a value), or a row inside a list.",
@@ -4268,34 +3885,10 @@
         "src/app/components/page-header.tsx",
         "src/app/components/tag.tsx",
         "src/app/design-system/generated-token-descriptions.ts",
-        "src/mui/index.ts",
-        "src/stories/badge.stories.tsx",
-        "src/stories/code-block.stories.tsx",
-        "src/stories/combobox.stories.tsx",
-        "src/stories/data-table-section.stories.tsx",
-        "src/stories/page-header.stories.tsx",
-        "src/stories/patterns-client-detail.stories.tsx",
-        "src/stories/patterns-layout.stories.tsx",
-        "src/stories/static-primitives.stories.tsx",
-        "src/stories/status-list-item.stories.test.tsx",
-        "src/stories/status-list-item.stories.tsx",
-        "src/stories/status-tile.stories.test.tsx",
-        "src/stories/status-tile.stories.tsx",
-        "src/stories/table.stories.tsx"
+        "src/mui/index.ts"
       ],
       "tokenMapping": {},
-      "storyFiles": [
-        "src/stories/badge.stories.tsx"
-      ],
-      "storyIds": [
-        "primitives-badge--all-tones",
-        "primitives-badge--danger",
-        "primitives-badge--dot",
-        "primitives-badge--info",
-        "primitives-badge--neutral",
-        "primitives-badge--success",
-        "primitives-badge--warning"
-      ],
+      "docsPage": "/docs/components/badge",
       "usage": {
         "when": "Label a status, state or count with a compact neutral or semantic chip, or a dot.",
         "whenNot": "A chip people can toggle, or a message that needs a sentence.",
@@ -4332,8 +3925,7 @@
         "src/app/components/asset-img.test.tsx",
         "src/app/components/hds-tooltip.tsx",
         "src/app/components/tooltip.test.tsx",
-        "src/app/components/tooltip.tsx",
-        "src/stories/asset-img.stories.tsx"
+        "src/app/components/tooltip.tsx"
       ],
       "tokenMapping": {},
       "variantAxes": [],
@@ -4475,16 +4067,7 @@
           "required": false
         }
       ],
-      "storyFiles": [
-        "src/stories/asset-img.stories.tsx"
-      ],
-      "storyIds": [
-        "primitives-asset-img--default",
-        "primitives-asset-img--detail-context",
-        "primitives-asset-img--lightbox-context",
-        "primitives-asset-img--placeholder-fallback",
-        "primitives-asset-img--with-title"
-      ],
+      "docsPage": "/docs/patterns/asset-img",
       "usage": {
         "when": "Show an image that scales to its frame, with a placeholder if it fails to load."
       }
@@ -4509,10 +4092,7 @@
         "src/app/components/breadcrumb.tsx",
         "src/app/components/disclosure.tsx",
         "src/app/components/segmented-control.tsx",
-        "src/app/components/tabs.test.tsx",
-        "src/stories/combobox.stories.tsx",
-        "src/stories/patterns-client-detail.stories.tsx",
-        "src/stories/tabs.stories.tsx"
+        "src/app/components/tabs.test.tsx"
       ],
       "tokenMapping": {},
       "variantAxes": [],
@@ -4561,15 +4141,7 @@
       "propConstraints": {},
       "requiredProps": [],
       "a11yRules": [],
-      "storyFiles": [
-        "src/stories/tabs.stories.tsx"
-      ],
-      "storyIds": [
-        "primitives-tabs--controlled",
-        "primitives-tabs--default",
-        "primitives-tabs--many-tabs",
-        "primitives-tabs--with-disabled-tab"
-      ],
+      "docsPage": "/docs/components/tabs",
       "usage": {
         "when": "Switch between panels of related content in the same place, one visible at a time.",
         "whenNot": "A compact mode switch with no panels, or content that must all be visible.",
@@ -4603,9 +4175,7 @@
         "sizing": "panel"
       },
       "consumers": [
-        "src/app/components/tabs.test.tsx",
-        "src/stories/patterns-client-detail.stories.tsx",
-        "src/stories/tabs.stories.tsx"
+        "src/app/components/tabs.test.tsx"
       ],
       "tokenMapping": {},
       "variantAxes": [],
@@ -4629,15 +4199,7 @@
       "propConstraints": {},
       "requiredProps": [],
       "a11yRules": [],
-      "storyFiles": [
-        "src/stories/tabs.stories.tsx"
-      ],
-      "storyIds": [
-        "primitives-tabs--controlled",
-        "primitives-tabs--default",
-        "primitives-tabs--many-tabs",
-        "primitives-tabs--with-disabled-tab"
-      ]
+      "docsPage": null
     },
     "TabsList": {
       "category": "Navigation",
@@ -4656,9 +4218,7 @@
         "sizing": "panel"
       },
       "consumers": [
-        "src/app/components/tabs.test.tsx",
-        "src/stories/patterns-client-detail.stories.tsx",
-        "src/stories/tabs.stories.tsx"
+        "src/app/components/tabs.test.tsx"
       ],
       "tokenMapping": {},
       "variantAxes": [],
@@ -4679,15 +4239,7 @@
       "propConstraints": {},
       "requiredProps": [],
       "a11yRules": [],
-      "storyFiles": [
-        "src/stories/tabs.stories.tsx"
-      ],
-      "storyIds": [
-        "primitives-tabs--controlled",
-        "primitives-tabs--default",
-        "primitives-tabs--many-tabs",
-        "primitives-tabs--with-disabled-tab"
-      ]
+      "docsPage": null
     },
     "TabsTrigger": {
       "category": "Navigation",
@@ -4706,9 +4258,7 @@
         "sizing": "panel"
       },
       "consumers": [
-        "src/app/components/tabs.test.tsx",
-        "src/stories/patterns-client-detail.stories.tsx",
-        "src/stories/tabs.stories.tsx"
+        "src/app/components/tabs.test.tsx"
       ],
       "tokenMapping": {},
       "variantAxes": [],
@@ -4728,15 +4278,7 @@
       "propConstraints": {},
       "requiredProps": [],
       "a11yRules": [],
-      "storyFiles": [
-        "src/stories/tabs.stories.tsx"
-      ],
-      "storyIds": [
-        "primitives-tabs--controlled",
-        "primitives-tabs--default",
-        "primitives-tabs--many-tabs",
-        "primitives-tabs--with-disabled-tab"
-      ]
+      "docsPage": null
     },
     "Radio": {
       "category": "Inputs",
@@ -4758,9 +4300,7 @@
         "src/app/components/segmented-control.tsx",
         "src/app/components/toggle.tsx",
         "src/app/hooks/useInteractionState.test.ts",
-        "src/app/hooks/useInteractionState.ts",
-        "src/stories/menu.stories.tsx",
-        "src/stories/radio.stories.tsx"
+        "src/app/hooks/useInteractionState.ts"
       ],
       "tokenMapping": {
         "label": "semantic.typography.small",
@@ -4797,16 +4337,7 @@
       "tier": "primitive",
       "docExempt": false,
       "figmaLink": "https://www.figma.com/design/2VgBbVpKiDnu0aftJEVyBQ/HDS-Tokens-Components?node-id=36-17",
-      "storyFiles": [
-        "src/stories/radio.stories.tsx"
-      ],
-      "storyIds": [
-        "primitives-radio--default",
-        "primitives-radio--disabled",
-        "primitives-radio--disabled-selected",
-        "primitives-radio--group",
-        "primitives-radio--selected"
-      ],
+      "docsPage": "/docs/components/radio",
       "usage": {
         "when": "Choose exactly one option from a small set that should stay visible together.",
         "whenNot": "Independent yes/no options, or a long list of options.",
@@ -4852,12 +4383,7 @@
         "src/app/components/segmented-control.tsx",
         "src/app/components/select.test.tsx",
         "src/app/context/__tests__/portal-hydration.test.tsx",
-        "src/app/context/__tests__/portal-scope.test.tsx",
-        "src/stories/checkbox.stories.tsx",
-        "src/stories/combobox.stories.tsx",
-        "src/stories/lib/open-listbox.test.tsx",
-        "src/stories/lib/open-listbox.ts",
-        "src/stories/select.stories.tsx"
+        "src/app/context/__tests__/portal-scope.test.tsx"
       ],
       "tokenMapping": {
         "label": "semantic.typography.small",
@@ -4912,14 +4438,7 @@
       "tier": "primitive",
       "docExempt": false,
       "figmaLink": "https://www.figma.com/design/2VgBbVpKiDnu0aftJEVyBQ/HDS-Tokens-Components?node-id=82-49",
-      "storyFiles": [
-        "src/stories/select.stories.tsx"
-      ],
-      "storyIds": [
-        "primitives-select--default",
-        "primitives-select--no-label",
-        "primitives-select--open"
-      ],
+      "docsPage": "/docs/components/select",
       "usage": {
         "when": "Choose one value from a short list of options in a form field.",
         "whenNot": "Firing actions, or choosing from a list long enough to need search.",
@@ -4980,8 +4499,7 @@
         "sizing": "panel"
       },
       "consumers": [
-        "src/app/components/form-control.ts",
-        "src/stories/slider.stories.tsx"
+        "src/app/components/form-control.ts"
       ],
       "tokenMapping": {
         "label": "semantic.typography.small",
@@ -5021,15 +4539,7 @@
       "tier": "primitive",
       "docExempt": false,
       "figmaLink": "https://www.figma.com/design/2VgBbVpKiDnu0aftJEVyBQ/HDS-Tokens-Components?node-id=82-265",
-      "storyFiles": [
-        "src/stories/slider.stories.tsx"
-      ],
-      "storyIds": [
-        "primitives-slider--decimal",
-        "primitives-slider--default",
-        "primitives-slider--stepped",
-        "primitives-slider--typography-controls"
-      ],
+      "docsPage": "/docs/components/slider",
       "usage": {
         "when": "Pick a number within a known range by dragging, when the exact value matters less than the position.",
         "whenNot": "A precise number the person must type or read exactly.",
@@ -5061,8 +4571,7 @@
         "src/app/components/radio.tsx",
         "src/app/components/toggle.test.tsx",
         "src/app/hooks/useInteractionState.test.ts",
-        "src/app/hooks/useInteractionState.ts",
-        "src/stories/toggle.stories.tsx"
+        "src/app/hooks/useInteractionState.ts"
       ],
       "tokenMapping": {
         "label": "semantic.typography.small",
@@ -5098,16 +4607,7 @@
       "tier": "primitive",
       "docExempt": false,
       "figmaLink": "https://www.figma.com/design/2VgBbVpKiDnu0aftJEVyBQ/HDS-Tokens-Components?node-id=37-19",
-      "storyFiles": [
-        "src/stories/toggle.stories.tsx"
-      ],
-      "storyIds": [
-        "primitives-toggle--default",
-        "primitives-toggle--disabled",
-        "primitives-toggle--disabled-on",
-        "primitives-toggle--on",
-        "primitives-toggle--settings-group"
-      ],
+      "docsPage": "/docs/components/toggle",
       "usage": {
         "when": "Switch one setting on or off, with the effect applying immediately.",
         "whenNot": "A choice that only takes effect after submitting a form, or picking from several options.",
@@ -5145,9 +4645,7 @@
         "src/app/components/avatar-group.tsx",
         "src/app/components/avatar.test.tsx",
         "src/app/components/icon.tsx",
-        "src/app/design-system/generated-token-descriptions.ts",
-        "src/stories/avatar-group.stories.tsx",
-        "src/stories/avatar.stories.tsx"
+        "src/app/design-system/generated-token-descriptions.ts"
       ],
       "tokenMapping": {},
       "variantAxes": [
@@ -5182,17 +4680,7 @@
       "propConstraints": {},
       "requiredProps": [],
       "a11yRules": [],
-      "storyFiles": [
-        "src/stories/avatar.stories.tsx"
-      ],
-      "storyIds": [
-        "primitives-avatar--all-sizes",
-        "primitives-avatar--default",
-        "primitives-avatar--explicit-initials",
-        "primitives-avatar--large",
-        "primitives-avatar--small",
-        "primitives-avatar--with-image"
-      ],
+      "docsPage": "/docs/components/avatar",
       "usage": {
         "when": "Show a person or entity as an image with an initials fallback.",
         "whenNot": "A generic pictogram, or a status marker.",
@@ -5232,10 +4720,7 @@
         "src/app/components/progress.test.tsx",
         "src/app/components/skeleton.tsx",
         "src/app/components/spinner.tsx",
-        "src/index.ts",
-        "src/stories/card.stories.tsx",
-        "src/stories/progress.stories.tsx",
-        "src/stories/table.stories.tsx"
+        "src/index.ts"
       ],
       "tokenMapping": {},
       "variantAxes": [],
@@ -5288,16 +4773,7 @@
       "propConstraints": {},
       "requiredProps": [],
       "a11yRules": [],
-      "storyFiles": [
-        "src/stories/progress.stories.tsx"
-      ],
-      "storyIds": [
-        "primitives-progress--all-sizes",
-        "primitives-progress--circular",
-        "primitives-progress--complete",
-        "primitives-progress--default",
-        "primitives-progress--indeterminate"
-      ],
+      "docsPage": "/docs/components/progress",
       "usage": {
         "when": "Show how far a task has got, as a bar or ring that is determinate or indeterminate.",
         "whenNot": "A wait of unknown length with no bar, or content that is still loading.",
@@ -5334,10 +4810,7 @@
         "src/app/components/empty-state.tsx",
         "src/app/components/progress.tsx",
         "src/app/components/skeleton.test.tsx",
-        "src/app/components/spinner.tsx",
-        "src/stories/patterns-layout.stories.tsx",
-        "src/stories/patterns-scroll.stories.tsx",
-        "src/stories/skeleton.stories.tsx"
+        "src/app/components/spinner.tsx"
       ],
       "tokenMapping": {},
       "variantAxes": [],
@@ -5367,16 +4840,7 @@
       "propConstraints": {},
       "requiredProps": [],
       "a11yRules": [],
-      "storyFiles": [
-        "src/stories/skeleton.stories.tsx"
-      ],
-      "storyIds": [
-        "primitives-skeleton--all-variants",
-        "primitives-skeleton--card-placeholder",
-        "primitives-skeleton--circular",
-        "primitives-skeleton--default",
-        "primitives-skeleton--text"
-      ],
+      "docsPage": "/docs/components/skeleton",
       "usage": {
         "when": "Reserve the shape of content that is still loading, so the layout does not jump.",
         "whenNot": "A task with measurable progress, or a wait with no layout to reserve.",
@@ -5412,8 +4876,7 @@
       "consumers": [
         "src/app/components/progress.tsx",
         "src/app/components/skeleton.tsx",
-        "src/app/components/spinner.test.tsx",
-        "src/stories/spinner.stories.tsx"
+        "src/app/components/spinner.test.tsx"
       ],
       "tokenMapping": {},
       "variantAxes": [],
@@ -5439,17 +4902,7 @@
       "propConstraints": {},
       "requiredProps": [],
       "a11yRules": [],
-      "storyFiles": [
-        "src/stories/spinner.stories.tsx"
-      ],
-      "storyIds": [
-        "primitives-spinner--all-sizes",
-        "primitives-spinner--color-inheritance",
-        "primitives-spinner--custom-label",
-        "primitives-spinner--default",
-        "primitives-spinner--large",
-        "primitives-spinner--small"
-      ],
+      "docsPage": "/docs/components/spinner",
       "usage": {
         "when": "Show that something is loading when the wait is short or has no measurable end.",
         "whenNot": "A task with measurable progress, or a region whose layout is known.",
@@ -5486,10 +4939,7 @@
         "src/app/components/breadcrumb.test.tsx",
         "src/app/components/page-header.tsx",
         "src/app/components/pagination.tsx",
-        "src/app/components/table.tsx",
-        "src/stories/breadcrumb.stories.tsx",
-        "src/stories/page-header.stories.tsx",
-        "src/stories/patterns-client-detail.stories.tsx"
+        "src/app/components/table.tsx"
       ],
       "tokenMapping": {},
       "variantAxes": [],
@@ -5509,16 +4959,7 @@
       "propConstraints": {},
       "requiredProps": [],
       "a11yRules": [],
-      "storyFiles": [
-        "src/stories/breadcrumb.stories.tsx"
-      ],
-      "storyIds": [
-        "primitives-breadcrumb--custom-label",
-        "primitives-breadcrumb--deep-trail",
-        "primitives-breadcrumb--default",
-        "primitives-breadcrumb--shallow-trail",
-        "primitives-breadcrumb--single-crumb"
-      ],
+      "docsPage": "/docs/components/breadcrumb",
       "usage": {
         "when": "Show where the current page sits in a hierarchy and link back up it.",
         "whenNot": "Switching between sibling views, or stepping through pages of results.",
@@ -5554,8 +4995,7 @@
       "consumers": [
         "src/app/components/breadcrumb.tsx",
         "src/app/components/pagination.markup.test.tsx",
-        "src/app/components/pagination.test.tsx",
-        "src/stories/pagination.stories.tsx"
+        "src/app/components/pagination.test.tsx"
       ],
       "tokenMapping": {},
       "variantAxes": [],
@@ -5585,16 +5025,7 @@
       "propConstraints": {},
       "requiredProps": [],
       "a11yRules": [],
-      "storyFiles": [
-        "src/stories/pagination.stories.tsx"
-      ],
-      "storyIds": [
-        "primitives-pagination--default",
-        "primitives-pagination--few-pages",
-        "primitives-pagination--last-page",
-        "primitives-pagination--middle-page",
-        "primitives-pagination--wide-siblings"
-      ],
+      "docsPage": "/docs/components/pagination",
       "usage": {
         "when": "Move between pages of a long result set, with truncated page numbers.",
         "whenNot": "A hierarchy trail, or a short list that fits on one page.",
@@ -5627,8 +5058,7 @@
         "src/app/components/alert-dialog.tsx",
         "src/app/components/alert.tsx",
         "src/app/components/dialog.tsx",
-        "src/app/components/toast.test.tsx",
-        "src/stories/toast.stories.tsx"
+        "src/app/components/toast.test.tsx"
       ],
       "tokenMapping": {},
       "variantAxes": [],
@@ -5653,16 +5083,7 @@
       "propConstraints": {},
       "requiredProps": [],
       "a11yRules": [],
-      "storyFiles": [
-        "src/stories/toast.stories.tsx"
-      ],
-      "storyIds": [
-        "primitives-toast--danger",
-        "primitives-toast--default",
-        "primitives-toast--info",
-        "primitives-toast--success",
-        "primitives-toast--warning"
-      ],
+      "docsPage": "/docs/guides/providers",
       "usage": {
         "when": "Confirm an action with a brief message that appears and dismisses itself, through useToast.",
         "whenNot": "A message people must act on or that must stay next to its content.",
@@ -5701,11 +5122,7 @@
         "src/app/components/form.tsx",
         "src/app/components/input.tsx",
         "src/app/components/select.tsx",
-        "src/index.ts",
-        "src/stories/combobox.stories.tsx",
-        "src/stories/lib/open-listbox.test.tsx",
-        "src/stories/lib/open-listbox.ts",
-        "src/stories/popover.stories.tsx"
+        "src/index.ts"
       ],
       "tokenMapping": {},
       "variantAxes": [],
@@ -5767,19 +5184,7 @@
       "propConstraints": {},
       "requiredProps": [],
       "a11yRules": [],
-      "storyFiles": [
-        "src/stories/combobox.stories.tsx"
-      ],
-      "storyIds": [
-        "primitives-combobox--default",
-        "primitives-combobox--disabled-trigger",
-        "primitives-combobox--few-options",
-        "primitives-combobox--multiple",
-        "primitives-combobox--open",
-        "primitives-combobox--open-multiple",
-        "primitives-combobox--pre-selected",
-        "primitives-combobox--with-disabled-option"
-      ],
+      "docsPage": "/docs/components/combobox",
       "usage": {
         "when": "Pick one value, or several with `multiple`, from a long list of options, with a search field that filters as you type.",
         "whenNot": "A short list that needs no search, or an action list.",
@@ -5843,10 +5248,7 @@
         "src/app/components/form.test.tsx",
         "src/form/hds-form.tsx",
         "src/form/index.ts",
-        "src/form/use-hds-form.ts",
-        "src/stories/form-actions.stories.tsx",
-        "src/stories/form.stories.tsx",
-        "src/stories/patterns-layout.stories.tsx"
+        "src/form/use-hds-form.ts"
       ],
       "tokenMapping": {},
       "variantAxes": [],
@@ -5858,15 +5260,7 @@
       "propConstraints": {},
       "requiredProps": [],
       "a11yRules": [],
-      "storyFiles": [
-        "src/stories/form.stories.tsx"
-      ],
-      "storyIds": [
-        "patterns-form--controlled",
-        "patterns-form--default",
-        "patterns-form--with-description",
-        "patterns-form--with-error"
-      ],
+      "docsPage": "/docs/patterns/form",
       "usage": {
         "when": "Wrap form fields so they stack with even spacing."
       }
@@ -5892,9 +5286,7 @@
         "src/app/components/form.test.tsx",
         "src/app/components/select.tsx",
         "src/form/form-adapter.test.tsx",
-        "src/form/hds-form.tsx",
-        "src/stories/form.stories.tsx",
-        "src/stories/patterns-layout.stories.tsx"
+        "src/form/hds-form.tsx"
       ],
       "tokenMapping": {},
       "variantAxes": [],
@@ -5933,15 +5325,7 @@
       "propConstraints": {},
       "requiredProps": [],
       "a11yRules": [],
-      "storyFiles": [
-        "src/stories/form.stories.tsx"
-      ],
-      "storyIds": [
-        "patterns-form--controlled",
-        "patterns-form--default",
-        "patterns-form--with-description",
-        "patterns-form--with-error"
-      ]
+      "docsPage": null
     },
     "FormFieldShell": {
       "category": "Inputs",
@@ -5998,15 +5382,7 @@
       "propConstraints": {},
       "requiredProps": [],
       "a11yRules": [],
-      "storyFiles": [
-        "src/stories/form.stories.tsx"
-      ],
-      "storyIds": [
-        "patterns-form--controlled",
-        "patterns-form--default",
-        "patterns-form--with-description",
-        "patterns-form--with-error"
-      ]
+      "docsPage": null
     },
     "HdsThemeProvider": {
       "category": "Theming",
@@ -6086,8 +5462,7 @@
       "propConstraints": {},
       "requiredProps": [],
       "a11yRules": [],
-      "storyFiles": [],
-      "storyIds": [],
+      "docsPage": "/docs/guides/providers",
       "usage": {
         "when": "Wrap an app or region once to set theme, density and other root attributes for everything inside it.",
         "whenNot": "Styling a single component, or per-component overrides.",
@@ -6117,8 +5492,7 @@
         "sizing": "panel"
       },
       "consumers": [
-        "src/app/components/avatar-group.test.tsx",
-        "src/stories/avatar-group.stories.tsx"
+        "src/app/components/avatar-group.test.tsx"
       ],
       "tokenMapping": {},
       "variantAxes": [],
@@ -6147,14 +5521,7 @@
       "propConstraints": {},
       "requiredProps": [],
       "a11yRules": [],
-      "storyFiles": [
-        "src/stories/avatar-group.stories.tsx"
-      ],
-      "storyIds": [
-        "primitives-avatar-group--default",
-        "primitives-avatar-group--sizes",
-        "primitives-avatar-group--with-overflow"
-      ]
+      "docsPage": null
     },
     "Blockquote": {
       "category": "Typography",
@@ -6173,8 +5540,7 @@
         "sizing": "panel"
       },
       "consumers": [
-        "src/app/components/blockquote.test.tsx",
-        "src/stories/blockquote.stories.tsx"
+        "src/app/components/blockquote.test.tsx"
       ],
       "tokenMapping": {},
       "variantAxes": [],
@@ -6200,14 +5566,7 @@
       "propConstraints": {},
       "requiredProps": [],
       "a11yRules": [],
-      "storyFiles": [
-        "src/stories/blockquote.stories.tsx"
-      ],
-      "storyIds": [
-        "primitives-blockquote--default",
-        "primitives-blockquote--sizes",
-        "primitives-blockquote--with-attribution"
-      ]
+      "docsPage": null
     },
     "Kbd": {
       "category": "Display",
@@ -6227,8 +5586,7 @@
       },
       "consumers": [
         "src/app/components/kbd.test.tsx",
-        "src/app/components/text.tsx",
-        "src/stories/kbd.stories.tsx"
+        "src/app/components/text.tsx"
       ],
       "tokenMapping": {},
       "variantAxes": [],
@@ -6250,14 +5608,7 @@
       "propConstraints": {},
       "requiredProps": [],
       "a11yRules": [],
-      "storyFiles": [
-        "src/stories/kbd.stories.tsx"
-      ],
-      "storyIds": [
-        "primitives-kbd--combination",
-        "primitives-kbd--default",
-        "primitives-kbd--sizes"
-      ],
+      "docsPage": "/docs/components/kbd",
       "usage": {
         "when": "Show a keyboard key or shortcut hint inline, as a native kbd element.",
         "whenNot": "Code samples, or a control that runs the shortcut.",
@@ -6287,8 +5638,7 @@
         "sizing": "panel"
       },
       "consumers": [
-        "src/app/components/timestamp.test.tsx",
-        "src/stories/timestamp.stories.tsx"
+        "src/app/components/timestamp.test.tsx"
       ],
       "tokenMapping": {},
       "variantAxes": [],
@@ -6322,13 +5672,7 @@
       "propConstraints": {},
       "requiredProps": [],
       "a11yRules": [],
-      "storyFiles": [
-        "src/stories/timestamp.stories.tsx"
-      ],
-      "storyIds": [
-        "primitives-timestamp--default",
-        "primitives-timestamp--formats"
-      ]
+      "docsPage": null
     },
     "VisuallyHidden": {
       "category": "Utility",
@@ -6347,8 +5691,7 @@
         "sizing": "panel"
       },
       "consumers": [
-        "src/app/components/visually-hidden.test.tsx",
-        "src/stories/visually-hidden.stories.tsx"
+        "src/app/components/visually-hidden.test.tsx"
       ],
       "tokenMapping": {},
       "variantAxes": [],
@@ -6365,12 +5708,7 @@
       "propConstraints": {},
       "requiredProps": [],
       "a11yRules": [],
-      "storyFiles": [
-        "src/stories/visually-hidden.stories.tsx"
-      ],
-      "storyIds": [
-        "primitives-visually-hidden--default"
-      ],
+      "docsPage": "/docs/components/utilities",
       "usage": {
         "when": "Give assistive technology a label or description that sighted people do not need to see.",
         "whenNot": "Text everyone should read, or hiding an element from assistive technology too.",
@@ -6400,8 +5738,7 @@
         "sizing": "panel"
       },
       "consumers": [
-        "src/app/components/metadata-list.test.tsx",
-        "src/stories/metadata-list.stories.tsx"
+        "src/app/components/metadata-list.test.tsx"
       ],
       "tokenMapping": {},
       "variantAxes": [],
@@ -6437,14 +5774,7 @@
       "propConstraints": {},
       "requiredProps": [],
       "a11yRules": [],
-      "storyFiles": [
-        "src/stories/metadata-list.stories.tsx"
-      ],
-      "storyIds": [
-        "patterns-metadata-list--default",
-        "patterns-metadata-list--divided",
-        "patterns-metadata-list--horizontal"
-      ]
+      "docsPage": null
     },
     "AlertDialog": {
       "category": "Overlays",
@@ -6468,8 +5798,6 @@
         "src/app/components/dialog.tsx",
         "src/app/context/__tests__/portal-hydration.test.tsx",
         "src/app/context/__tests__/portal-scope.test.tsx",
-        "src/stories/alert-dialog.stories.tsx",
-        "src/stories/destructive-section.stories.tsx",
         "src/styles/__tests__/scrim-and-color-scheme.test.ts"
       ],
       "tokenMapping": {},
@@ -6499,13 +5827,7 @@
       "propConstraints": {},
       "requiredProps": [],
       "a11yRules": [],
-      "storyFiles": [
-        "src/stories/alert-dialog.stories.tsx"
-      ],
-      "storyIds": [
-        "primitives-alert-dialog--dark-scope",
-        "primitives-alert-dialog--default"
-      ],
+      "docsPage": null,
       "usage": {
         "when": "Confirm a destructive or irreversible action (delete, archive, remove) before it runs, with Cancel and Action buttons.",
         "whenNot": "A modal that collects input or shows content, or a confirmation after the action is done.",
@@ -6548,10 +5870,7 @@
         "src/app/components/stack.tsx",
         "src/app/components/switcher.tsx",
         "src/app/components/toggle.tsx",
-        "src/index.ts",
-        "src/stories/box.stories.tsx",
-        "src/stories/patterns-layout.stories.tsx",
-        "src/stories/story-ssr.spec.tsx"
+        "src/index.ts"
       ],
       "tokenMapping": {},
       "variantAxes": [],
@@ -6576,17 +5895,7 @@
       "propConstraints": {},
       "requiredProps": [],
       "a11yRules": [],
-      "storyFiles": [
-        "src/stories/box.stories.tsx"
-      ],
-      "storyIds": [
-        "primitives-box--ampersand-selectors",
-        "primitives-box--ampersand-with-responsive",
-        "primitives-box--polymorphic-as",
-        "primitives-box--responsive-values",
-        "primitives-box--spacing-shorthands",
-        "primitives-box--token-colors"
-      ],
+      "docsPage": "/docs/components/utilities",
       "usage": {
         "when": "Build one-off layout that no named layout primitive covers, using token keys through `sx`.",
         "whenNot": "Ordinary vertical or horizontal spacing, columns, or page-width constraint.",
@@ -6627,11 +5936,7 @@
       "consumers": [
         "src/app/components/box-sx.test.ts",
         "src/app/components/box-sx.ts",
-        "src/app/components/sidebar.test.tsx",
-        "src/stories/grid.stories.tsx",
-        "src/stories/patterns-layout.stories.tsx",
-        "src/stories/pin.stories.tsx",
-        "src/stories/sidebar.stories.tsx"
+        "src/app/components/sidebar.test.tsx"
       ],
       "tokenMapping": {},
       "variantAxes": [],
@@ -6685,14 +5990,7 @@
       "propConstraints": {},
       "requiredProps": [],
       "a11yRules": [],
-      "storyFiles": [
-        "src/stories/sidebar.stories.tsx"
-      ],
-      "storyIds": [
-        "primitives-sidebar--narrow-container-stacks",
-        "primitives-sidebar--rail-end",
-        "primitives-sidebar--rail-start"
-      ],
+      "docsPage": null,
       "aiRules": "Reach for this named layout intent before Box/sx. Sidebar expects EXACTLY two children — the rail and the content — passed in that order. `side` controls which one visually renders as the rail; DOM order is unchanged. gap MUST use a semantic space step, never raw px. sideWidth and contentMin are CSS length dimensions (not spacing) — a length string like '16rem' or '50%' is expected, matching the check-hardcoded-spacing gate's own dimension-prop exemption. Do NOT use Sidebar for more than two regions — use Grid."
     },
     "Switcher": {
@@ -6714,8 +6012,7 @@
       "consumers": [
         "src/app/components/box-sx.test.ts",
         "src/app/components/box-sx.ts",
-        "src/app/components/switcher.test.tsx",
-        "src/stories/switcher.stories.tsx"
+        "src/app/components/switcher.test.tsx"
       ],
       "tokenMapping": {},
       "variantAxes": [],
@@ -6761,14 +6058,7 @@
       "propConstraints": {},
       "requiredProps": [],
       "a11yRules": [],
-      "storyFiles": [
-        "src/stories/switcher.stories.tsx"
-      ],
-      "storyIds": [
-        "primitives-switcher--default",
-        "primitives-switcher--limit-forces-stacked",
-        "primitives-switcher--narrow-container-stacks"
-      ],
+      "docsPage": null,
       "aiRules": "Reach for this named layout intent before Box/sx. gap MUST use a semantic space step, never raw px. threshold is a CSS length dimension (not spacing), e.g. '30rem'. `limit` unconditionally forces the stacked (column) layout once there are more than `limit` children, regardless of container width — use it to stop a row from thinning out into an unreadable N-up strip. Do NOT use Switcher for content that should always wrap in place — use Stack with `direction=\"row\"` and `wrap=\"wrap\"`."
     },
     "Pin": {
@@ -6789,10 +6079,7 @@
       },
       "consumers": [
         "src/app/components/form-actions.tsx",
-        "src/app/components/pin.test.tsx",
-        "src/stories/patterns-scroll.stories.tsx",
-        "src/stories/pin.stories.tsx",
-        "src/stories/reveal.stories.tsx"
+        "src/app/components/pin.test.tsx"
       ],
       "tokenMapping": {},
       "variantAxes": [],
@@ -6824,12 +6111,7 @@
       "propConstraints": {},
       "requiredProps": [],
       "a11yRules": [],
-      "storyFiles": [
-        "src/stories/pin.stories.tsx"
-      ],
-      "storyIds": [
-        "primitives-pin--sidebar"
-      ],
+      "docsPage": null,
       "aiRules": "`top` is a CSS length offset (a dimension, not a spacing step). Give the pinned element a TALLER scrolling parent so it has room to travel. For the scroll-scrubbed animation inside a pinned scene, use CSS `animation-timeline` (see Reveal) or `useScrollProgress` from `@hirobius/design-system/scroll`. See ADR-021."
     },
     "Reveal": {
@@ -6850,9 +6132,7 @@
       },
       "consumers": [
         "src/app/components/pin.tsx",
-        "src/app/components/reveal.test.tsx",
-        "src/stories/patterns-scroll.stories.tsx",
-        "src/stories/reveal.stories.tsx"
+        "src/app/components/reveal.test.tsx"
       ],
       "tokenMapping": {},
       "variantAxes": [],
@@ -6890,17 +6170,7 @@
       "propConstraints": {},
       "requiredProps": [],
       "a11yRules": [],
-      "storyFiles": [
-        "src/stories/patterns-scroll.stories.tsx",
-        "src/stories/reveal.stories.tsx"
-      ],
-      "storyIds": [
-        "patterns-scroll--pinned-scale-reveal",
-        "patterns-scroll--reveal-sequence",
-        "patterns-scroll--simple-parallax",
-        "primitives-reveal--animations",
-        "primitives-reveal--scale-reveal-scene"
-      ],
+      "docsPage": "/docs/patterns/reveal",
       "usage": {
         "when": "Fade content in as it scrolls into view."
       },
@@ -6926,9 +6196,7 @@
         "src/app/components/form-control.ts",
         "src/app/components/input.tsx",
         "src/app/components/select.tsx",
-        "src/app/components/textarea.test.tsx",
-        "src/stories/patterns-client-detail.stories.tsx",
-        "src/stories/textarea.stories.tsx"
+        "src/app/components/textarea.test.tsx"
       ],
       "tokenMapping": {},
       "variantAxes": [],
@@ -6973,16 +6241,7 @@
       "propConstraints": {},
       "requiredProps": [],
       "a11yRules": [],
-      "storyFiles": [
-        "src/stories/textarea.stories.tsx"
-      ],
-      "storyIds": [
-        "primitives-textarea--all-states",
-        "primitives-textarea--default",
-        "primitives-textarea--disabled",
-        "primitives-textarea--error",
-        "primitives-textarea--with-helper"
-      ],
+      "docsPage": "/docs/components/textarea",
       "usage": {
         "when": "Collect multi-line free text such as a message, note or description.",
         "whenNot": "A single line of text, or choosing from a list.",
@@ -7024,23 +6283,7 @@
       "propConstraints": {},
       "requiredProps": [],
       "a11yRules": [],
-      "storyFiles": [
-        "src/stories/card.stories.tsx"
-      ],
-      "storyIds": [
-        "primitives-card--bordered",
-        "primitives-card--default",
-        "primitives-card--elevated",
-        "primitives-card--feedback-tones",
-        "primitives-card--full-anatomy",
-        "primitives-card--header-only",
-        "primitives-card--metric-slot",
-        "primitives-card--padding-variants",
-        "primitives-card--progress-slot",
-        "primitives-card--selectable",
-        "primitives-card--tone-matrix",
-        "primitives-card--variant-accent"
-      ]
+      "docsPage": null
     },
     "CardDescription": {
       "category": "Display",
@@ -7071,23 +6314,7 @@
       "propConstraints": {},
       "requiredProps": [],
       "a11yRules": [],
-      "storyFiles": [
-        "src/stories/card.stories.tsx"
-      ],
-      "storyIds": [
-        "primitives-card--bordered",
-        "primitives-card--default",
-        "primitives-card--elevated",
-        "primitives-card--feedback-tones",
-        "primitives-card--full-anatomy",
-        "primitives-card--header-only",
-        "primitives-card--metric-slot",
-        "primitives-card--padding-variants",
-        "primitives-card--progress-slot",
-        "primitives-card--selectable",
-        "primitives-card--tone-matrix",
-        "primitives-card--variant-accent"
-      ]
+      "docsPage": null
     },
     "CardFooter": {
       "category": "Display",
@@ -7118,23 +6345,7 @@
       "propConstraints": {},
       "requiredProps": [],
       "a11yRules": [],
-      "storyFiles": [
-        "src/stories/card.stories.tsx"
-      ],
-      "storyIds": [
-        "primitives-card--bordered",
-        "primitives-card--default",
-        "primitives-card--elevated",
-        "primitives-card--feedback-tones",
-        "primitives-card--full-anatomy",
-        "primitives-card--header-only",
-        "primitives-card--metric-slot",
-        "primitives-card--padding-variants",
-        "primitives-card--progress-slot",
-        "primitives-card--selectable",
-        "primitives-card--tone-matrix",
-        "primitives-card--variant-accent"
-      ]
+      "docsPage": null
     },
     "CardHeader": {
       "category": "Display",
@@ -7170,23 +6381,7 @@
       "propConstraints": {},
       "requiredProps": [],
       "a11yRules": [],
-      "storyFiles": [
-        "src/stories/card.stories.tsx"
-      ],
-      "storyIds": [
-        "primitives-card--bordered",
-        "primitives-card--default",
-        "primitives-card--elevated",
-        "primitives-card--feedback-tones",
-        "primitives-card--full-anatomy",
-        "primitives-card--header-only",
-        "primitives-card--metric-slot",
-        "primitives-card--padding-variants",
-        "primitives-card--progress-slot",
-        "primitives-card--selectable",
-        "primitives-card--tone-matrix",
-        "primitives-card--variant-accent"
-      ]
+      "docsPage": null
     },
     "CardMetric": {
       "category": "Display",
@@ -7239,23 +6434,7 @@
       "propConstraints": {},
       "requiredProps": [],
       "a11yRules": [],
-      "storyFiles": [
-        "src/stories/card.stories.tsx"
-      ],
-      "storyIds": [
-        "primitives-card--bordered",
-        "primitives-card--default",
-        "primitives-card--elevated",
-        "primitives-card--feedback-tones",
-        "primitives-card--full-anatomy",
-        "primitives-card--header-only",
-        "primitives-card--metric-slot",
-        "primitives-card--padding-variants",
-        "primitives-card--progress-slot",
-        "primitives-card--selectable",
-        "primitives-card--tone-matrix",
-        "primitives-card--variant-accent"
-      ],
+      "docsPage": null,
       "usage": {
         "when": "Show one headline figure (a KPI, a count, a total) with its label inside a Card.",
         "whenNot": "A metric outside a Card, or several figures that share one label.",
@@ -7319,23 +6498,7 @@
       "propConstraints": {},
       "requiredProps": [],
       "a11yRules": [],
-      "storyFiles": [
-        "src/stories/card.stories.tsx"
-      ],
-      "storyIds": [
-        "primitives-card--bordered",
-        "primitives-card--default",
-        "primitives-card--elevated",
-        "primitives-card--feedback-tones",
-        "primitives-card--full-anatomy",
-        "primitives-card--header-only",
-        "primitives-card--metric-slot",
-        "primitives-card--padding-variants",
-        "primitives-card--progress-slot",
-        "primitives-card--selectable",
-        "primitives-card--tone-matrix",
-        "primitives-card--variant-accent"
-      ]
+      "docsPage": null
     },
     "CardTitle": {
       "category": "Display",
@@ -7366,23 +6529,7 @@
       "propConstraints": {},
       "requiredProps": [],
       "a11yRules": [],
-      "storyFiles": [
-        "src/stories/card.stories.tsx"
-      ],
-      "storyIds": [
-        "primitives-card--bordered",
-        "primitives-card--default",
-        "primitives-card--elevated",
-        "primitives-card--feedback-tones",
-        "primitives-card--full-anatomy",
-        "primitives-card--header-only",
-        "primitives-card--metric-slot",
-        "primitives-card--padding-variants",
-        "primitives-card--progress-slot",
-        "primitives-card--selectable",
-        "primitives-card--tone-matrix",
-        "primitives-card--variant-accent"
-      ]
+      "docsPage": null
     },
     "DialogClose": {
       "category": "Overlays",
@@ -7418,16 +6565,7 @@
       "propConstraints": {},
       "requiredProps": [],
       "a11yRules": [],
-      "storyFiles": [
-        "src/stories/dialog.stories.tsx"
-      ],
-      "storyIds": [
-        "primitives-dialog--dark-scope",
-        "primitives-dialog--default",
-        "primitives-dialog--destructive",
-        "primitives-dialog--information",
-        "primitives-dialog--no-close-affordance"
-      ]
+      "docsPage": null
     },
     "DialogContent": {
       "category": "Overlays",
@@ -7499,16 +6637,7 @@
       "propConstraints": {},
       "requiredProps": [],
       "a11yRules": [],
-      "storyFiles": [
-        "src/stories/dialog.stories.tsx"
-      ],
-      "storyIds": [
-        "primitives-dialog--dark-scope",
-        "primitives-dialog--default",
-        "primitives-dialog--destructive",
-        "primitives-dialog--information",
-        "primitives-dialog--no-close-affordance"
-      ]
+      "docsPage": null
     },
     "DialogDescription": {
       "category": "Overlays",
@@ -7544,16 +6673,7 @@
       "propConstraints": {},
       "requiredProps": [],
       "a11yRules": [],
-      "storyFiles": [
-        "src/stories/dialog.stories.tsx"
-      ],
-      "storyIds": [
-        "primitives-dialog--dark-scope",
-        "primitives-dialog--default",
-        "primitives-dialog--destructive",
-        "primitives-dialog--information",
-        "primitives-dialog--no-close-affordance"
-      ]
+      "docsPage": null
     },
     "DialogFooter": {
       "category": "Overlays",
@@ -7584,16 +6704,7 @@
       "propConstraints": {},
       "requiredProps": [],
       "a11yRules": [],
-      "storyFiles": [
-        "src/stories/dialog.stories.tsx"
-      ],
-      "storyIds": [
-        "primitives-dialog--dark-scope",
-        "primitives-dialog--default",
-        "primitives-dialog--destructive",
-        "primitives-dialog--information",
-        "primitives-dialog--no-close-affordance"
-      ]
+      "docsPage": null
     },
     "DialogHeader": {
       "category": "Overlays",
@@ -7624,16 +6735,7 @@
       "propConstraints": {},
       "requiredProps": [],
       "a11yRules": [],
-      "storyFiles": [
-        "src/stories/dialog.stories.tsx"
-      ],
-      "storyIds": [
-        "primitives-dialog--dark-scope",
-        "primitives-dialog--default",
-        "primitives-dialog--destructive",
-        "primitives-dialog--information",
-        "primitives-dialog--no-close-affordance"
-      ]
+      "docsPage": null
     },
     "DialogOverlay": {
       "category": "Overlays",
@@ -7673,16 +6775,7 @@
       "propConstraints": {},
       "requiredProps": [],
       "a11yRules": [],
-      "storyFiles": [
-        "src/stories/dialog.stories.tsx"
-      ],
-      "storyIds": [
-        "primitives-dialog--dark-scope",
-        "primitives-dialog--default",
-        "primitives-dialog--destructive",
-        "primitives-dialog--information",
-        "primitives-dialog--no-close-affordance"
-      ]
+      "docsPage": null
     },
     "DialogPortal": {
       "category": "Overlays",
@@ -7726,16 +6819,7 @@
       "propConstraints": {},
       "requiredProps": [],
       "a11yRules": [],
-      "storyFiles": [
-        "src/stories/dialog.stories.tsx"
-      ],
-      "storyIds": [
-        "primitives-dialog--dark-scope",
-        "primitives-dialog--default",
-        "primitives-dialog--destructive",
-        "primitives-dialog--information",
-        "primitives-dialog--no-close-affordance"
-      ]
+      "docsPage": null
     },
     "DialogTitle": {
       "category": "Overlays",
@@ -7771,16 +6855,7 @@
       "propConstraints": {},
       "requiredProps": [],
       "a11yRules": [],
-      "storyFiles": [
-        "src/stories/dialog.stories.tsx"
-      ],
-      "storyIds": [
-        "primitives-dialog--dark-scope",
-        "primitives-dialog--default",
-        "primitives-dialog--destructive",
-        "primitives-dialog--information",
-        "primitives-dialog--no-close-affordance"
-      ]
+      "docsPage": null
     },
     "DialogTrigger": {
       "category": "Overlays",
@@ -7816,16 +6891,7 @@
       "propConstraints": {},
       "requiredProps": [],
       "a11yRules": [],
-      "storyFiles": [
-        "src/stories/dialog.stories.tsx"
-      ],
-      "storyIds": [
-        "primitives-dialog--dark-scope",
-        "primitives-dialog--default",
-        "primitives-dialog--destructive",
-        "primitives-dialog--information",
-        "primitives-dialog--no-close-affordance"
-      ]
+      "docsPage": null
     },
     "Tooltip": {
       "category": "Overlays",
@@ -7848,8 +6914,7 @@
         "src/app/components/hds-tooltip.test.tsx",
         "src/app/components/popover.tsx",
         "src/app/context/__tests__/portal-hydration.test.tsx",
-        "src/app/context/__tests__/portal-scope.test.tsx",
-        "src/stories/hds-tooltip.stories.tsx"
+        "src/app/context/__tests__/portal-scope.test.tsx"
       ],
       "tokenMapping": {},
       "variantAxes": [],
@@ -7887,13 +6952,7 @@
       "propConstraints": {},
       "requiredProps": [],
       "a11yRules": [],
-      "storyFiles": [
-        "src/stories/hds-tooltip.stories.tsx"
-      ],
-      "storyIds": [
-        "primitives-hds-tooltip--default",
-        "primitives-hds-tooltip--placement"
-      ],
+      "docsPage": "/docs/components/tooltip",
       "usage": {
         "when": "Name an icon-only control, or add a short hint that appears on hover and keyboard focus.",
         "whenNot": "Anything interactive, text people need to finish a task, or a hint touch users must see (touch has no hover).",
@@ -7947,8 +7006,7 @@
         "src/app/components/popover.tsx",
         "src/app/components/select.tsx",
         "src/app/context/__tests__/portal-hydration.test.tsx",
-        "src/app/context/__tests__/portal-scope.test.tsx",
-        "src/stories/menu.stories.tsx"
+        "src/app/context/__tests__/portal-scope.test.tsx"
       ],
       "tokenMapping": {},
       "variantAxes": [],
@@ -7985,15 +7043,6 @@
       "propConstraints": {},
       "requiredProps": [],
       "a11yRules": [],
-      "storyFiles": [
-        "src/stories/menu.stories.tsx"
-      ],
-      "storyIds": [
-        "primitives-menu--default",
-        "primitives-menu--with-checkbox-items",
-        "primitives-menu--with-radio-group",
-        "primitives-menu--with-submenu"
-      ],
       "slots": [
         {
           "name": "trigger",
@@ -8006,6 +7055,7 @@
           "source": "jsdoc"
         }
       ],
+      "docsPage": "/docs/components/menu",
       "usage": {
         "when": "Offer a list of actions from a trigger, closed until opened.",
         "whenNot": "Choosing one value for a form field, or a set of options that must stay visible.",
@@ -8072,9 +7122,7 @@
         "src/app/components/popover.test.tsx",
         "src/app/context/__tests__/portal-hydration.test.tsx",
         "src/app/context/__tests__/portal-scope.test.tsx",
-        "src/app/design-system/generated-token-descriptions.ts",
-        "src/stories/combobox.stories.tsx",
-        "src/stories/popover.stories.tsx"
+        "src/app/design-system/generated-token-descriptions.ts"
       ],
       "tokenMapping": {},
       "variantAxes": [],
@@ -8107,15 +7155,7 @@
       "propConstraints": {},
       "requiredProps": [],
       "a11yRules": [],
-      "storyFiles": [
-        "src/stories/popover.stories.tsx"
-      ],
-      "storyIds": [
-        "primitives-popover--aligned-start",
-        "primitives-popover--default",
-        "primitives-popover--info-tip",
-        "primitives-popover--with-dismiss"
-      ],
+      "docsPage": "/docs/components/popover",
       "usage": {
         "when": "Anchor interactive content, such as a short form, a filter set or a picker, to a trigger people click to open.",
         "whenNot": "A short label on hover or focus, a list of actions, or a decision that must block the page.",
@@ -8170,8 +7210,7 @@
         "src/app/components/checkbox.test.tsx",
         "src/app/components/focus-visible.test.tsx",
         "src/app/components/radio.tsx",
-        "src/app/components/toggle.tsx",
-        "src/stories/checkbox.stories.tsx"
+        "src/app/components/toggle.tsx"
       ],
       "tokenMapping": {},
       "variantAxes": [],
@@ -8197,17 +7236,7 @@
       "propConstraints": {},
       "requiredProps": [],
       "a11yRules": [],
-      "storyFiles": [
-        "src/stories/checkbox.stories.tsx"
-      ],
-      "storyIds": [
-        "primitives-checkbox--checked",
-        "primitives-checkbox--default",
-        "primitives-checkbox--disabled",
-        "primitives-checkbox--disabled-checked",
-        "primitives-checkbox--group",
-        "primitives-checkbox--indeterminate"
-      ],
+      "docsPage": "/docs/components/checkbox",
       "usage": {
         "when": "Let people tick one or more independent options, or a parent choice that is partly selected.",
         "whenNot": "An immediate on/off setting, or a choice of exactly one option from a set.",
@@ -8241,9 +7270,7 @@
         "sizing": "panel"
       },
       "consumers": [
-        "src/app/components/form-actions.test.tsx",
-        "src/stories/form-actions.stories.tsx",
-        "src/stories/patterns-client-detail.stories.tsx"
+        "src/app/components/form-actions.test.tsx"
       ],
       "tokenMapping": {},
       "variantAxes": [],
@@ -8271,15 +7298,7 @@
       "propConstraints": {},
       "requiredProps": [],
       "a11yRules": [],
-      "storyFiles": [
-        "src/stories/form-actions.stories.tsx"
-      ],
-      "storyIds": [
-        "patterns-formactions--primary-only",
-        "patterns-formactions--sticky",
-        "patterns-formactions--with-destructive",
-        "patterns-formactions--with-secondary"
-      ],
+      "docsPage": "/docs/patterns/form-actions",
       "usage": {
         "when": "Lay out a form's buttons in a fixed order: danger on the left, then secondary, then primary on the right."
       }
@@ -8302,10 +7321,7 @@
       },
       "consumers": [
         "src/app/components/metric-tiles.test.tsx",
-        "src/app/components/stat.tsx",
-        "src/stories/metric-tile.stories.tsx",
-        "src/stories/metric-tiles.stories.tsx",
-        "src/stories/patterns-client-detail.stories.tsx"
+        "src/app/components/stat.tsx"
       ],
       "tokenMapping": {},
       "variantAxes": [],
@@ -8339,18 +7355,7 @@
       "propConstraints": {},
       "requiredProps": [],
       "a11yRules": [],
-      "storyFiles": [
-        "src/stories/metric-tile.stories.tsx",
-        "src/stories/metric-tiles.stories.tsx"
-      ],
-      "storyIds": [
-        "patterns-metrictile--danger",
-        "patterns-metrictile--default",
-        "patterns-metrictiles--four-tiles",
-        "patterns-metrictiles--sub-line-optional",
-        "patterns-metrictiles--three-tiles",
-        "patterns-metrictiles--tones"
-      ],
+      "docsPage": null,
       "usage": {
         "when": "Show one key number with its label, inside a MetricTiles row."
       }
@@ -8375,10 +7380,7 @@
         "src/app/components/card.tsx",
         "src/app/components/metric-tiles.test.tsx",
         "src/app/components/stat.tsx",
-        "src/app/components/status-tile.tsx",
-        "src/stories/metric-tile.stories.tsx",
-        "src/stories/metric-tiles.stories.tsx",
-        "src/stories/patterns-client-detail.stories.tsx"
+        "src/app/components/status-tile.tsx"
       ],
       "tokenMapping": {},
       "variantAxes": [],
@@ -8394,18 +7396,7 @@
       "propConstraints": {},
       "requiredProps": [],
       "a11yRules": [],
-      "storyFiles": [
-        "src/stories/metric-tile.stories.tsx",
-        "src/stories/metric-tiles.stories.tsx"
-      ],
-      "storyIds": [
-        "patterns-metrictile--danger",
-        "patterns-metrictile--default",
-        "patterns-metrictiles--four-tiles",
-        "patterns-metrictiles--sub-line-optional",
-        "patterns-metrictiles--three-tiles",
-        "patterns-metrictiles--tones"
-      ],
+      "docsPage": "/docs/patterns/metric-tiles",
       "usage": {
         "when": "Show a row of key numbers, one tile each."
       }
@@ -8427,9 +7418,7 @@
         "sizing": "panel"
       },
       "consumers": [
-        "src/app/components/page-header.test.tsx",
-        "src/stories/page-header.stories.tsx",
-        "src/stories/patterns-client-detail.stories.tsx"
+        "src/app/components/page-header.test.tsx"
       ],
       "tokenMapping": {},
       "variantAxes": [],
@@ -8461,21 +7450,7 @@
       "propConstraints": {},
       "requiredProps": [],
       "a11yRules": [],
-      "storyFiles": [
-        "src/stories/page-header.stories.tsx",
-        "src/stories/patterns-client-detail.stories.tsx"
-      ],
-      "storyIds": [
-        "patterns-client-detail-screen--compact",
-        "patterns-client-detail-screen--dark",
-        "patterns-client-detail-screen--light",
-        "patterns-client-detail-screen--phone-390",
-        "patterns-pageheader--default",
-        "patterns-pageheader--long-title-wraps",
-        "patterns-pageheader--nested-level",
-        "patterns-pageheader--title-only",
-        "patterns-pageheader--with-actions"
-      ],
+      "docsPage": "/docs/patterns/page-header",
       "usage": {
         "when": "Open a screen with its title, plus optional breadcrumb, status and actions."
       }
@@ -8497,9 +7472,7 @@
         "sizing": "panel"
       },
       "consumers": [
-        "src/app/components/data-table-section.test.tsx",
-        "src/stories/data-table-section.stories.tsx",
-        "src/stories/patterns-client-detail.stories.tsx"
+        "src/app/components/data-table-section.test.tsx"
       ],
       "tokenMapping": {},
       "variantAxes": [],
@@ -8541,16 +7514,7 @@
       "propConstraints": {},
       "requiredProps": [],
       "a11yRules": [],
-      "storyFiles": [
-        "src/stories/data-table-section.stories.tsx"
-      ],
-      "storyIds": [
-        "patterns-datatablesection--dark",
-        "patterns-datatablesection--default",
-        "patterns-datatablesection--empty",
-        "patterns-datatablesection--phone-390",
-        "patterns-datatablesection--without-row-actions"
-      ],
+      "docsPage": "/docs/patterns/data-table-section",
       "usage": {
         "when": "Put a heading and toolbar above a Table."
       }
@@ -8572,9 +7536,7 @@
         "sizing": "panel"
       },
       "consumers": [
-        "src/app/components/destructive-section.test.tsx",
-        "src/stories/destructive-section.stories.tsx",
-        "src/stories/patterns-client-detail.stories.tsx"
+        "src/app/components/destructive-section.test.tsx"
       ],
       "tokenMapping": {},
       "variantAxes": [],
@@ -8614,15 +7576,7 @@
       "propConstraints": {},
       "requiredProps": [],
       "a11yRules": [],
-      "storyFiles": [
-        "src/stories/destructive-section.stories.tsx"
-      ],
-      "storyIds": [
-        "patterns-destructivesection--dark",
-        "patterns-destructivesection--default",
-        "patterns-destructivesection--phone",
-        "patterns-destructivesection--separate-button-label"
-      ],
+      "docsPage": "/docs/patterns/destructive-section",
       "usage": {
         "when": "Put a dangerous action, such as delete, in its own section with a warning and a confirm step."
       }
@@ -8664,8 +7618,7 @@
       "propConstraints": {},
       "requiredProps": [],
       "a11yRules": [],
-      "storyFiles": [],
-      "storyIds": [],
+      "docsPage": "/docs/guides/providers",
       "usage": {
         "when": "Wrap the app root once so HDS links and navigation use your client router; with no provider they stay plain anchors."
       },
@@ -8684,8 +7637,7 @@
       "propConstraints": {},
       "requiredProps": [],
       "a11yRules": [],
-      "storyFiles": [],
-      "storyIds": []
+      "docsPage": null
     },
     "HdsFrame": {
       "category": "Compiler",
@@ -8700,8 +7652,7 @@
       "propConstraints": {},
       "requiredProps": [],
       "a11yRules": [],
-      "storyFiles": [],
-      "storyIds": []
+      "docsPage": null
     },
     "HdsHeading": {
       "category": "Compiler",
@@ -8716,8 +7667,7 @@
       "propConstraints": {},
       "requiredProps": [],
       "a11yRules": [],
-      "storyFiles": [],
-      "storyIds": []
+      "docsPage": null
     },
     "HdsLabel": {
       "category": "Compiler",
@@ -8732,8 +7682,7 @@
       "propConstraints": {},
       "requiredProps": [],
       "a11yRules": [],
-      "storyFiles": [],
-      "storyIds": []
+      "docsPage": null
     },
     "HdsCaption": {
       "category": "Compiler",
@@ -8748,8 +7697,7 @@
       "propConstraints": {},
       "requiredProps": [],
       "a11yRules": [],
-      "storyFiles": [],
-      "storyIds": []
+      "docsPage": null
     },
     "HdsCheckbox": {
       "category": "Compiler",
@@ -8764,8 +7712,7 @@
       "propConstraints": {},
       "requiredProps": [],
       "a11yRules": [],
-      "storyFiles": [],
-      "storyIds": []
+      "docsPage": null
     },
     "HdsChip": {
       "category": "Compiler",
@@ -8780,8 +7727,7 @@
       "propConstraints": {},
       "requiredProps": [],
       "a11yRules": [],
-      "storyFiles": [],
-      "storyIds": []
+      "docsPage": null
     },
     "HdsAvatar": {
       "category": "Compiler",
@@ -8796,8 +7742,7 @@
       "propConstraints": {},
       "requiredProps": [],
       "a11yRules": [],
-      "storyFiles": [],
-      "storyIds": []
+      "docsPage": null
     }
   },
   "utilities": {
@@ -9382,81 +8327,158 @@
         "value": "#022c22"
       },
       {
-        "path": "primitive.color.apple.50",
-        "cssVar": "--primitive-color-apple-50",
+        "path": "primitive.color.graphite.50",
+        "cssVar": "--primitive-color-graphite-50",
+        "type": "color",
+        "description": "Graphite accent tint — faintest step.",
+        "value": "#f5f4f4"
+      },
+      {
+        "path": "primitive.color.graphite.100",
+        "cssVar": "--primitive-color-graphite-100",
+        "type": "color",
+        "description": "Graphite accent — very light warm tint.",
+        "value": "#e9e7e8"
+      },
+      {
+        "path": "primitive.color.graphite.200",
+        "cssVar": "--primitive-color-graphite-200",
+        "type": "color",
+        "description": "Graphite accent — light warm-grey; dark-mode rest accent fill.",
+        "value": "#d4d0d2"
+      },
+      {
+        "path": "primitive.color.graphite.300",
+        "cssVar": "--primitive-color-graphite-300",
+        "type": "color",
+        "description": "Graphite accent — soft mid-light step; dark-mode hover/link.",
+        "value": "#b2abae"
+      },
+      {
+        "path": "primitive.color.graphite.400",
+        "cssVar": "--primitive-color-graphite-400",
+        "type": "color",
+        "description": "Graphite accent — mid warm-grey step.",
+        "value": "#8b8488"
+      },
+      {
+        "path": "primitive.color.graphite.500",
+        "cssVar": "--primitive-color-graphite-500",
+        "type": "color",
+        "description": "Graphite accent — mid step.",
+        "value": "#655e62"
+      },
+      {
+        "path": "primitive.color.graphite.600",
+        "cssVar": "--primitive-color-graphite-600",
         "type": "color",
-        "description": "Apple-green accent tint — faintest step.",
-        "value": "#f2faeb"
+        "description": "Graphite accent — mid-dark step.",
+        "value": "#544d51"
       },
       {
-        "path": "primitive.color.apple.100",
-        "cssVar": "--primitive-color-apple-100",
+        "path": "primitive.color.graphite.700",
+        "cssVar": "--primitive-color-graphite-700",
         "type": "color",
-        "description": "Apple-green accent — very light tint.",
-        "value": "#e2f3cf"
+        "description": "Graphite accent rest — the warm charcoal brand accent; white text as a fill (AA).",
+        "value": "#433a3f"
       },
       {
-        "path": "primitive.color.apple.200",
-        "cssVar": "--primitive-color-apple-200",
+        "path": "primitive.color.graphite.800",
+        "cssVar": "--primitive-color-graphite-800",
         "type": "color",
-        "description": "Apple-green accent — light tint.",
-        "value": "#c7e7a4"
+        "description": "Graphite accent — deep step; light-mode hover.",
+        "value": "#352e32"
       },
       {
-        "path": "primitive.color.apple.300",
-        "cssVar": "--primitive-color-apple-300",
+        "path": "primitive.color.graphite.900",
+        "cssVar": "--primitive-color-graphite-900",
         "type": "color",
-        "description": "Apple-green accent — soft mid-light step.",
-        "value": "#a6d873"
+        "description": "Graphite accent — darkest usable step; light-mode pressed, dark-mode on-accent text.",
+        "value": "#2a2428"
       },
       {
-        "path": "primitive.color.apple.400",
-        "cssVar": "--primitive-color-apple-400",
+        "path": "primitive.color.graphite.950",
+        "cssVar": "--primitive-color-graphite-950",
         "type": "color",
-        "description": "Apple-green accent — bright step; dark-mode rest accent.",
-        "value": "#85c84c"
+        "description": "Graphite accent — near-black warm substrate.",
+        "value": "#19161a"
       },
       {
-        "path": "primitive.color.apple.500",
-        "cssVar": "--primitive-color-apple-500",
+        "path": "primitive.color.mauve.50",
+        "cssVar": "--primitive-color-mauve-50",
         "type": "color",
-        "description": "Apple-green accent rest — bright, rich apple green; AA for dark (neutral.900) text as a fill.",
-        "value": "#66b239"
+        "description": "Mauve tint, faintest step.",
+        "value": "#fff0f6"
       },
       {
-        "path": "primitive.color.apple.600",
-        "cssVar": "--primitive-color-apple-600",
+        "path": "primitive.color.mauve.100",
+        "cssVar": "--primitive-color-mauve-100",
         "type": "color",
-        "description": "Apple-green accent — hover / border step.",
-        "value": "#54922d"
+        "description": "Mauve step 100, lightness-matched to graphite 100.",
+        "value": "#f4e2ea"
       },
       {
-        "path": "primitive.color.apple.700",
-        "cssVar": "--primitive-color-apple-700",
+        "path": "primitive.color.mauve.200",
+        "cssVar": "--primitive-color-mauve-200",
         "type": "color",
-        "description": "Apple-green accent — pressed and accent-intent text (AA for text on page and card surfaces).",
-        "value": "#416f20"
+        "description": "Mauve step 200, lightness-matched to graphite 200.",
+        "value": "#e1cad4"
       },
       {
-        "path": "primitive.color.apple.800",
-        "cssVar": "--primitive-color-apple-800",
+        "path": "primitive.color.mauve.300",
+        "cssVar": "--primitive-color-mauve-300",
         "type": "color",
-        "description": "Apple-green accent — deep step.",
-        "value": "#34571b"
+        "description": "Mauve step 300, lightness-matched to graphite 300.",
+        "value": "#c0a4b1"
       },
       {
-        "path": "primitive.color.apple.900",
-        "cssVar": "--primitive-color-apple-900",
+        "path": "primitive.color.mauve.400",
+        "cssVar": "--primitive-color-mauve-400",
         "type": "color",
-        "description": "Apple-green accent — darkest usable step.",
-        "value": "#2b4518"
+        "description": "Mauve step 400, lightness-matched to graphite 400.",
+        "value": "#9d7b8a"
       },
       {
-        "path": "primitive.color.apple.950",
-        "cssVar": "--primitive-color-apple-950",
+        "path": "primitive.color.mauve.500",
+        "cssVar": "--primitive-color-mauve-500",
         "type": "color",
-        "description": "Apple-green accent — near-black green substrate.",
-        "value": "#16250c"
+        "description": "Mauve anchor (#734B5E). Reserved; not mapped to any semantic token yet.",
+        "value": "#734b5e"
+      },
+      {
+        "path": "primitive.color.mauve.600",
+        "cssVar": "--primitive-color-mauve-600",
+        "type": "color",
+        "description": "Mauve step 600, lightness-matched to graphite 600.",
+        "value": "#674254"
+      },
+      {
+        "path": "primitive.color.mauve.700",
+        "cssVar": "--primitive-color-mauve-700",
+        "type": "color",
+        "description": "Mauve step 700, lightness-matched to graphite 700.",
+        "value": "#523141"
+      },
+      {
+        "path": "primitive.color.mauve.800",
+        "cssVar": "--primitive-color-mauve-800",
+        "type": "color",
+        "description": "Mauve step 800, lightness-matched to graphite 800.",
+        "value": "#432634"
+      },
+      {
+        "path": "primitive.color.mauve.900",
+        "cssVar": "--primitive-color-mauve-900",
+        "type": "color",
+        "description": "Mauve step 900, lightness-matched to graphite 900.",
+        "value": "#361d29"
+      },
+      {
+        "path": "primitive.color.mauve.950",
+        "cssVar": "--primitive-color-mauve-950",
+        "type": "color",
+        "description": "Mauve, near-black substrate.",
+        "value": "#240f1a"
       },
       {
         "path": "primitive.color.violet.50",
@@ -10427,24 +9449,24 @@
         "path": "semantic.color.surface.accent",
         "cssVar": "--semantic-color-surface-accent",
         "type": "color",
-        "description": "Accent-colored background — bright apple green (stays green on dark surfaces; pair with content.onAccent dark text).",
-        "alias": "{primitive.color.apple.500}",
-        "resolvedValue": "#66b239",
+        "description": "Accent fill, warm graphite. Dark in light mode, light warm-grey in dark mode; pair with content.onAccent.",
+        "alias": "{primitive.color.graphite.700}",
+        "resolvedValue": "#433a3f",
         "dark": {
-          "alias": "{primitive.color.apple.400}",
-          "resolvedValue": "#85c84c"
+          "alias": "{primitive.color.graphite.200}",
+          "resolvedValue": "#d4d0d2"
         }
       },
       {
         "path": "semantic.color.surface.accentSubtle",
         "cssVar": "--semantic-color-surface-accentSubtle",
         "type": "color",
-        "description": "Faint accent tint for hover states or highlights",
-        "alias": "{primitive.color.apple.50}",
-        "resolvedValue": "#f2faeb",
+        "description": "Faint accent tint for hover states or highlights.",
+        "alias": "{primitive.color.graphite.50}",
+        "resolvedValue": "#f5f4f4",
         "dark": {
-          "alias": "{primitive.color.apple.900}",
-          "resolvedValue": "#2b4518"
+          "alias": "{primitive.color.graphite.800}",
+          "resolvedValue": "#352e32"
         }
       },
       {
@@ -10555,24 +9577,24 @@
         "path": "semantic.color.content.accent",
         "cssVar": "--semantic-color-content-accent",
         "type": "color",
-        "description": "Accent-intent text/icon color — a dark apple green legible on page and card surfaces. Pair with underline/weight for link affordance.",
-        "alias": "{primitive.color.apple.700}",
-        "resolvedValue": "#416f20",
+        "description": "Accent-intent text/icon color — graphite, legible on page and card surfaces. Pair with underline/weight for link affordance.",
+        "alias": "{primitive.color.graphite.700}",
+        "resolvedValue": "#433a3f",
         "dark": {
-          "alias": "{primitive.color.apple.400}",
-          "resolvedValue": "#85c84c"
+          "alias": "{primitive.color.graphite.300}",
+          "resolvedValue": "#b2abae"
         }
       },
       {
         "path": "semantic.color.content.onAccent",
         "cssVar": "--semantic-color-content-onAccent",
         "type": "color",
-        "description": "Text/icon color on accent fills — a dark neutral, since the brand accent fill is a bright apple green in both light and dark mode.",
-        "alias": "{primitive.color.neutral.900}",
-        "resolvedValue": "#111111",
+        "description": "Text and icons on accent fills: near-white in light mode, dark graphite in dark mode.",
+        "alias": "{primitive.color.neutral.50}",
+        "resolvedValue": "#fafafa",
         "dark": {
-          "alias": "{primitive.color.neutral.900}",
-          "resolvedValue": "#111111"
+          "alias": "{primitive.color.graphite.900}",
+          "resolvedValue": "#2a2428"
         }
       },
       {
@@ -10672,12 +9694,12 @@
         "path": "semantic.color.border.accent",
         "cssVar": "--semantic-color-border-accent",
         "type": "color",
-        "description": "Accent border — apple green, dark enough to read as a boundary on page and card surfaces.",
-        "alias": "{primitive.color.apple.600}",
-        "resolvedValue": "#54922d",
+        "description": "Accent border — graphite, dark enough to read as a boundary on page and card surfaces.",
+        "alias": "{primitive.color.graphite.700}",
+        "resolvedValue": "#433a3f",
         "dark": {
-          "alias": "{primitive.color.apple.400}",
-          "resolvedValue": "#85c84c"
+          "alias": "{primitive.color.graphite.300}",
+          "resolvedValue": "#b2abae"
         }
       },
       {
@@ -11275,12 +10297,12 @@
         "path": "semantic.accent.rest",
         "cssVar": "--semantic-accent-rest",
         "type": "color",
-        "description": "Default accent fill for interactive elements at rest — bright apple green. Pair with content.onAccent (a dark neutral).",
-        "alias": "{primitive.color.apple.500}",
-        "resolvedValue": "#66b239",
+        "description": "Default accent fill for interactive elements at rest — warm graphite. Inverts per theme; pair with content.onAccent.",
+        "alias": "{primitive.color.graphite.700}",
+        "resolvedValue": "#433a3f",
         "dark": {
-          "alias": "{primitive.color.apple.400}",
-          "resolvedValue": "#85c84c"
+          "alias": "{primitive.color.graphite.200}",
+          "resolvedValue": "#d4d0d2"
         }
       },
       {
@@ -11288,11 +10310,11 @@
         "cssVar": "--semantic-accent-hover",
         "type": "color",
         "description": "Accent fill on pointer hover.",
-        "alias": "{primitive.color.apple.600}",
-        "resolvedValue": "#54922d",
+        "alias": "{primitive.color.graphite.800}",
+        "resolvedValue": "#352e32",
         "dark": {
-          "alias": "{primitive.color.apple.500}",
-          "resolvedValue": "#66b239"
+          "alias": "{primitive.color.graphite.300}",
+          "resolvedValue": "#b2abae"
         }
       },
       {
@@ -11300,11 +10322,11 @@
         "cssVar": "--semantic-accent-pressed",
         "type": "color",
         "description": "Accent fill during active press.",
-        "alias": "{primitive.color.apple.700}",
-        "resolvedValue": "#416f20",
+        "alias": "{primitive.color.graphite.900}",
+        "resolvedValue": "#2a2428",
         "dark": {
-          "alias": "{primitive.color.apple.600}",
-          "resolvedValue": "#54922d"
+          "alias": "{primitive.color.graphite.400}",
+          "resolvedValue": "#8b8488"
         }
       },
       {
@@ -11335,12 +10357,12 @@
         "path": "semantic.accent.content",
         "cssVar": "--semantic-accent-content",
         "type": "color",
-        "description": "Accent-intent text/icon color on neutral surfaces (a dark apple green) — pair with underline/weight for link affordance.",
-        "alias": "{primitive.color.apple.700}",
-        "resolvedValue": "#416f20",
+        "description": "Accent-intent text/icon color on neutral surfaces (graphite) — pair with underline/weight for link affordance.",
+        "alias": "{primitive.color.graphite.700}",
+        "resolvedValue": "#433a3f",
         "dark": {
-          "alias": "{primitive.color.apple.400}",
-          "resolvedValue": "#85c84c"
+          "alias": "{primitive.color.graphite.300}",
+          "resolvedValue": "#b2abae"
         }
       },
       {
@@ -11348,11 +10370,11 @@
         "cssVar": "--semantic-accent-contentHover",
         "type": "color",
         "description": "Accent content color on pointer hover.",
-        "alias": "{primitive.color.apple.800}",
-        "resolvedValue": "#34571b",
+        "alias": "{primitive.color.graphite.800}",
+        "resolvedValue": "#352e32",
         "dark": {
-          "alias": "{primitive.color.apple.300}",
-          "resolvedValue": "#a6d873"
+          "alias": "{primitive.color.graphite.200}",
+          "resolvedValue": "#d4d0d2"
         }
       },
       {
@@ -11360,11 +10382,11 @@
         "cssVar": "--semantic-accent-subtle",
         "type": "color",
         "description": "Low-emphasis accent tint for hover backgrounds and selection highlights.",
-        "alias": "{primitive.color.apple.50}",
-        "resolvedValue": "#f2faeb",
+        "alias": "{primitive.color.graphite.50}",
+        "resolvedValue": "#f5f4f4",
         "dark": {
-          "alias": "{primitive.color.apple.900}",
-          "resolvedValue": "#2b4518"
+          "alias": "{primitive.color.graphite.800}",
+          "resolvedValue": "#352e32"
         }
       },
       {
@@ -11600,7 +10622,7 @@
         "type": "color",
         "description": "Nav item background fill when active or selected.",
         "alias": "{semantic.accent.subtle}",
-        "resolvedValue": "#f2faeb"
+        "resolvedValue": "#f5f4f4"
       },
       {
         "path": "component.nav.borderActive",
@@ -11608,7 +10630,7 @@
         "type": "color",
         "description": "Nav item border color when active or selected.",
         "alias": "{semantic.color.surface.accent}",
-        "resolvedValue": "#66b239"
+        "resolvedValue": "#433a3f"
       },
       {
         "path": "component.nav.text",
@@ -11656,7 +10678,7 @@
         "type": "color",
         "description": "Base tag surface color.",
         "alias": "{semantic.accent.subtle}",
-        "resolvedValue": "#f2faeb"
+        "resolvedValue": "#f5f4f4"
       },
       {
         "path": "component.tag.text",
@@ -11744,7 +10766,7 @@
         "type": "color",
         "description": "Text color when the tag is active.",
         "alias": "{semantic.color.content.onAccent}",
-        "resolvedValue": "#111111"
+        "resolvedValue": "#fafafa"
       },
       {
         "path": "component.tag.activeBackground",
@@ -11752,7 +10774,7 @@
         "type": "color",
         "description": "Active tag fill color.",
         "alias": "{semantic.accent.rest}",
-        "resolvedValue": "#66b239"
+        "resolvedValue": "#433a3f"
       },
       {
         "path": "component.tag.activeBorder",
@@ -11760,7 +10782,7 @@
         "type": "color",
         "description": "Active tag border color.",
         "alias": "{semantic.accent.rest}",
-        "resolvedValue": "#66b239"
+        "resolvedValue": "#433a3f"
       },
       {
         "path": "component.tag.activeHover",
@@ -11768,7 +10790,7 @@
         "type": "color",
         "description": "Active tag hover fill color.",
         "alias": "{semantic.accent.hover}",
-        "resolvedValue": "#54922d"
+        "resolvedValue": "#352e32"
       },
       {
         "path": "component.badge.fontSize",
@@ -11852,7 +10874,7 @@
         "type": "color",
         "description": "Primary button fill.",
         "alias": "{semantic.color.surface.accent}",
-        "resolvedValue": "#66b239"
+        "resolvedValue": "#433a3f"
       },
       {
         "path": "component.button.bgHover",
@@ -11860,7 +10882,7 @@
         "type": "color",
         "description": "Primary button hover fill.",
         "alias": "{semantic.accent.hover}",
-        "resolvedValue": "#54922d"
+        "resolvedValue": "#352e32"
       },
       {
         "path": "component.button.text",
@@ -11868,7 +10890,7 @@
         "type": "color",
         "description": "Primary button text color.",
         "alias": "{semantic.color.content.onAccent}",
-        "resolvedValue": "#111111"
+        "resolvedValue": "#fafafa"
       },
       {
         "path": "component.button.radius",
@@ -12043,20 +11065,16 @@
         "cssVar": "--component-button-primary-textDisabled",
         "type": "color",
         "description": "Disabled primary button text color.",
-        "alias": "{semantic.color.content.onAccent}",
-        "resolvedValue": "#111111",
-        "dark": {
-          "alias": "{semantic.color.content.disabled}",
-          "resolvedValue": "#d4d4d4"
-        }
+        "alias": "{semantic.color.content.disabled}",
+        "resolvedValue": "#d4d4d4"
       },
       {
         "path": "component.button.primary.bgDisabled",
         "cssVar": "--component-button-primary-bgDisabled",
         "type": "color",
         "description": "Disabled primary button fill.",
-        "alias": "{semantic.color.surface.accentSubtle}",
-        "resolvedValue": "#f2faeb"
+        "alias": "{semantic.color.surface.muted}",
+        "resolvedValue": "#f5f5f5"
       },
       {
         "path": "component.button.secondary.bg.rest",
@@ -12286,7 +11304,7 @@
         "type": "color",
         "description": "Primary action surface. shadcn role: primary.",
         "alias": "{semantic.color.surface.accent}",
-        "resolvedValue": "#66b239"
+        "resolvedValue": "#433a3f"
       },
       {
         "path": "role.primary-foreground",
@@ -12294,7 +11312,7 @@
         "type": "color",
         "description": "Text/icons on primary surface. shadcn role: primary-foreground.",
         "alias": "{semantic.color.content.onAccent}",
-        "resolvedValue": "#111111"
+        "resolvedValue": "#fafafa"
       },
       {
         "path": "role.secondary",
@@ -12334,7 +11352,7 @@
         "type": "color",
         "description": "Hover/active tinted bg. shadcn role: accent.",
         "alias": "{semantic.color.surface.accentSubtle}",
-        "resolvedValue": "#f2faeb"
+        "resolvedValue": "#f5f4f4"
       },
       {
         "path": "role.accent-foreground",
@@ -12342,7 +11360,7 @@
         "type": "color",
         "description": "Text on accent surface. shadcn role: accent-foreground.",
         "alias": "{semantic.color.content.accent}",
-        "resolvedValue": "#416f20"
+        "resolvedValue": "#433a3f"
       },
       {
         "path": "role.destructive",
@@ -12382,7 +11400,7 @@
         "type": "color",
         "description": "Focus ring color. shadcn role: ring.",
         "alias": "{semantic.color.border.accent}",
-        "resolvedValue": "#54922d"
+        "resolvedValue": "#433a3f"
       },
       {
         "path": "role.radius",