@hirobius/design-system 0.16.0 → 0.18.0

package/public/hds-manifest.json

@@ -2,7 +2,7 @@
   "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-09-24T18:19:57.948Z",
+  "generated": "2026-09-28T00:14:31.544Z",
   "source": "hirobius.tokens.json",
   "format": "W3C DTCG 2025.10",
   "docs": "https://adrianmilsap.com/hds",
@@ -64,6 +64,7 @@
     "CardTitle",
     "Carousel",
     "Center",
+    "Checkbox",
     "CinematicLink",
     "CircularProgress",
     "Cluster",
@@ -99,14 +100,8 @@
     "FoundationSwatch",
     "Frame",
     "Grid",
-    "HdsCheckbox",
     "HdsDocsShell",
-    "HdsRadio",
-    "HdsSelect",
-    "HdsSlider",
     "HdsThemeProvider",
-    "HdsToggle",
-    "HdsTooltip",
     "HeadingStack",
     "HoverCard",
     "Icon",
@@ -128,14 +123,16 @@
     "Pin",
     "Popover",
     "Progress",
+    "Radio",
     "Reveal",
     "SegmentedControl",
+    "Select",
     "SelectableCard",
     "Sidebar",
     "SideNav",
     "Skeleton",
     "Sketch",
-    "SpecimenBlock",
+    "Slider",
     "Spinner",
     "Stack",
     "StackedCardRail",
@@ -160,10 +157,12 @@
     "TimeInput",
     "Timestamp",
     "ToastProvider",
+    "Toggle",
     "ToggleButton",
     "Token",
     "Tokenizer",
     "Toolbar",
+    "Tooltip",
     "TopNav",
     "TreeList",
     "VisuallyHidden"
@@ -577,63 +576,10 @@
     "uncategorized": [
       {
         "name": "HdsLegacyTokenGovernancePanel",
-        "filePath": "src/app/components/lab/legacy-token-detail.tsx"
+        "filePath": "src/docs-tooling/lab/legacy-token-detail.tsx"
       }
     ],
-    "namespaceViolations": [
-      {
-        "name": "HdsCheckbox",
-        "filePath": "src/app/components/checkbox.tsx"
-      },
-      {
-        "name": "HdsLegacyTokenGovernancePanel",
-        "filePath": "src/app/components/lab/legacy-token-detail.tsx"
-      },
-      {
-        "name": "HdsMobileTopBar",
-        "filePath": "src/app/components/shell-controls.tsx"
-      },
-      {
-        "name": "HdsRadio",
-        "filePath": "src/app/components/controls.tsx"
-      },
-      {
-        "name": "HdsRadio",
-        "filePath": "src/app/components/radio.tsx"
-      },
-      {
-        "name": "HdsSelect",
-        "filePath": "src/app/components/controls.tsx"
-      },
-      {
-        "name": "HdsSelect",
-        "filePath": "src/app/components/select.tsx"
-      },
-      {
-        "name": "HdsSidebarUtilityButton",
-        "filePath": "src/app/components/shell-controls.tsx"
-      },
-      {
-        "name": "HdsSlider",
-        "filePath": "src/app/components/controls.tsx"
-      },
-      {
-        "name": "HdsSlider",
-        "filePath": "src/app/components/slider.tsx"
-      },
-      {
-        "name": "HdsToggle",
-        "filePath": "src/app/components/controls.tsx"
-      },
-      {
-        "name": "HdsToggle",
-        "filePath": "src/app/components/toggle.tsx"
-      },
-      {
-        "name": "HdsTooltip",
-        "filePath": "src/app/components/hds-tooltip.tsx"
-      }
-    ]
+    "namespaceViolations": []
   },
   "agentEntrypoint": "CLAUDE.md",
   "breakingChangePolicy": "Version increments on any prop rename, token path rename, or removed component. Additions are non-breaking.",
@@ -745,7 +691,6 @@
         "sizing": "panel"
       },
       "consumers": [
-        "src/app/components/componentPreviewRegistry.tsx",
         "src/app/data/hdsEditorial.tsx",
         "src/stories/alert.stories.tsx",
         "src/stories/static-primitives.stories.tsx"
@@ -884,7 +829,6 @@
       },
       "consumers": [
         "src/app/components/animated-label.tsx",
-        "src/app/components/componentPreviewRegistry.tsx",
         "src/stories/cinematic-link.stories.tsx"
       ],
       "tokenMapping": {},
@@ -932,8 +876,8 @@
         "sizing": "panel"
       },
       "consumers": [
-        "src/app/components/componentPreviewRegistry.tsx",
-        "src/app/components/lab/legacy-token-detail.tsx",
+        "src/docs-tooling/lab/legacy-token-detail.tsx",
+        "src/index.ts",
         "src/stories/code-block.stories.tsx"
       ],
       "tokenMapping": {
@@ -1082,7 +1026,6 @@
         "sizing": "panel"
       },
       "consumers": [
-        "src/app/components/componentPreviewRegistry.tsx",
         "src/app/components/nav-group.tsx",
         "src/app/layouts/HdsDocsShell.tsx",
         "src/stories/disclosure.stories.tsx",
@@ -1207,7 +1150,6 @@
         "sizing": "panel"
       },
       "consumers": [
-        "src/app/components/componentPreviewRegistry.tsx",
         "src/app/components/metadata-list.tsx",
         "src/app/data/hdsEditorial.tsx",
         "src/stories/divider.stories.tsx",
@@ -1340,9 +1282,9 @@
       "figmaId": null,
       "figmaLink": null,
       "consumers": [
-        "src/app/components/componentPreviewRegistry.tsx",
         "src/app/components/doc-link-card.test.tsx",
         "src/app/data/hdsEditorial.tsx",
+        "src/index.ts",
         "src/stories/doc-link-card.stories.tsx"
       ],
       "variantAxes": [],
@@ -1373,6 +1315,7 @@
       },
       "consumers": [
         "src/app/components/not-found-pattern.tsx",
+        "src/index.ts",
         "src/stories/error-pattern.stories.tsx",
         "src/stories/not-found-pattern.stories.tsx"
       ],
@@ -1468,7 +1411,6 @@
         "sizing": "full"
       },
       "consumers": [
-        "src/app/components/componentPreviewRegistry.tsx",
         "src/stories/foundation-swatch.stories.tsx"
       ],
       "tokenMapping": {},
@@ -1601,15 +1543,15 @@
       "consumers": [
         "src/app/components/box.tsx",
         "src/app/components/cluster.tsx",
-        "src/app/components/componentPreviewRegistry.tsx",
         "src/app/components/foundation-swatch.tsx",
         "src/app/components/image-lightbox.tsx",
         "src/app/components/segmented-control.test.tsx",
-        "src/app/components/shell-controls.tsx",
         "src/app/components/sidebar.tsx",
-        "src/app/components/sketch-controls.tsx",
         "src/app/components/stack.tsx",
+        "src/app/components/table.tsx",
         "src/app/components/tooltip.tsx",
+        "src/docs-tooling/shell-controls.tsx",
+        "src/docs-tooling/sketch-controls.tsx",
         "src/stories/box.stories.tsx",
         "src/stories/foundation-swatch.stories.tsx",
         "src/stories/grid.stories.tsx",
@@ -1739,7 +1681,6 @@
         "src/app/components/checkbox.tsx",
         "src/app/components/code-block.tsx",
         "src/app/components/combobox.tsx",
-        "src/app/components/componentPreviewRegistry.tsx",
         "src/app/components/context-menu.tsx",
         "src/app/components/disclosure.tsx",
         "src/app/components/doc-link-card.tsx",
@@ -1747,17 +1688,18 @@
         "src/app/components/icon-button.tsx",
         "src/app/components/image-lightbox.tsx",
         "src/app/components/inline-link.tsx",
-        "src/app/components/lab/legacy-token-detail.tsx",
         "src/app/components/menu.tsx",
         "src/app/components/multi-selector.tsx",
         "src/app/components/select.tsx",
-        "src/app/components/shell-controls.tsx",
+        "src/app/components/table.tsx",
         "src/app/components/text-lockup.tsx",
-        "src/app/components/theme-toggle.tsx",
         "src/app/components/toast.tsx",
         "src/app/components/tokenTableUtils.ts",
         "src/app/components/tokenUtils.ts",
         "src/app/data/hdsEditorial.tsx",
+        "src/docs-tooling/lab/legacy-token-detail.tsx",
+        "src/docs-tooling/shell-controls.tsx",
+        "src/docs-tooling/theme-toggle.tsx",
         "src/stories/activity-feed.stories.tsx",
         "src/stories/icon-button.stories.tsx",
         "src/stories/icon.stories.tsx",
@@ -1897,14 +1839,13 @@
         "sizing": "panel"
       },
       "consumers": [
-        "src/app/components/componentPreviewRegistry.tsx",
         "src/app/components/hds-tooltip.tsx",
         "src/app/components/inline-code.tsx",
-        "src/app/components/page-footer.tsx",
         "src/app/components/pagination.tsx",
-        "src/app/components/shell-controls.tsx",
         "src/app/components/stepper-field.tsx",
         "src/app/data/hdsEditorial.tsx",
+        "src/docs-tooling/page-footer.tsx",
+        "src/docs-tooling/shell-controls.tsx",
         "src/stories/icon-button.stories.tsx"
       ],
       "tokenMapping": {
@@ -2037,7 +1978,6 @@
         "sizing": "panel"
       },
       "consumers": [
-        "src/app/components/componentPreviewRegistry.tsx",
         "src/app/components/metadata-list.tsx",
         "src/app/data/hdsEditorial.tsx",
         "src/stories/inline-code.stories.tsx",
@@ -2104,10 +2044,9 @@
         "sizing": "panel"
       },
       "consumers": [
-        "src/app/components/componentPreviewRegistry.tsx",
         "src/app/components/hover-card.tsx",
         "src/app/components/image-lightbox.tsx",
-        "src/app/components/lab/legacy-token-detail.tsx",
+        "src/docs-tooling/lab/legacy-token-detail.tsx",
         "src/stories/inline-link.stories.tsx"
       ],
       "tokenMapping": {
@@ -2172,7 +2111,6 @@
         "sizing": "panel"
       },
       "consumers": [
-        "src/app/components/componentPreviewRegistry.tsx",
         "src/app/components/form.tsx",
         "src/app/components/segmented-control.tsx",
         "src/app/components/stepper-field.tsx",
@@ -2427,7 +2365,6 @@
         "sizing": "panel"
       },
       "consumers": [
-        "src/app/components/componentPreviewRegistry.tsx",
         "src/app/lib/nav-active.ts",
         "src/stories/nav-group.stories.tsx"
       ],
@@ -2545,12 +2482,12 @@
         "sizing": "panel"
       },
       "consumers": [
-        "src/app/components/componentPreviewRegistry.tsx",
         "src/app/components/nav-group.tsx",
         "src/app/context/DemoStateContext.tsx",
         "src/app/data/hds-nav-data.ts",
         "src/app/hooks/useInteractionState.ts",
         "src/app/layouts/HdsDocsShell.tsx",
+        "src/index.ts",
         "src/stories/nav-group.stories.tsx",
         "src/stories/nav-item.stories.tsx"
       ],
@@ -2632,11 +2569,10 @@
         "sizing": "panel"
       },
       "consumers": [
-        "src/app/components/componentPreviewRegistry.tsx",
         "src/app/components/segmented-control.test.tsx",
-        "src/app/components/TokenDisplayToggle.tsx",
         "src/app/data/hdsEditorial.tsx",
         "src/app/hooks/useInteractionState.ts",
+        "src/docs-tooling/TokenDisplayToggle.tsx",
         "src/stories/segmented-control.stories.tsx"
       ],
       "tokenMapping": {
@@ -2821,28 +2757,27 @@
         "src/app/components/activity-feed.tsx",
         "src/app/components/box.tsx",
         "src/app/components/cluster.tsx",
-        "src/app/components/componentPreviewRegistry.tsx",
         "src/app/components/container.tsx",
-        "src/app/components/controls-panel.tsx",
         "src/app/components/cover.tsx",
         "src/app/components/disclosure.tsx",
-        "src/app/components/doc-page-header.tsx",
         "src/app/components/error-boundary.tsx",
         "src/app/components/error-pattern.tsx",
         "src/app/components/foundation-swatch.tsx",
         "src/app/components/grid.tsx",
         "src/app/components/heading-stack.tsx",
         "src/app/components/image-lightbox.tsx",
-        "src/app/components/lab/token-collection-list.tsx",
         "src/app/components/nav-group.tsx",
         "src/app/components/page.tsx",
-        "src/app/components/shell-controls.tsx",
-        "src/app/components/sketch-controls.tsx",
         "src/app/components/sketch.tsx",
         "src/app/components/tooltip.tsx",
         "src/app/data/hdsEditorial.tsx",
         "src/app/layouts/CaseStudyLayout.tsx",
         "src/app/layouts/DocLayout.tsx",
+        "src/docs-tooling/controls-panel.tsx",
+        "src/docs-tooling/doc-page-header.tsx",
+        "src/docs-tooling/lab/token-collection-list.tsx",
+        "src/docs-tooling/shell-controls.tsx",
+        "src/docs-tooling/sketch-controls.tsx",
         "src/stories/box.stories.tsx",
         "src/stories/code-block.stories.tsx",
         "src/stories/grid.stories.tsx",
@@ -3017,7 +2952,6 @@
         "sizing": "panel"
       },
       "consumers": [
-        "src/app/components/componentPreviewRegistry.tsx",
         "src/stories/stepper-field.stories.tsx"
       ],
       "tokenMapping": {},
@@ -3118,10 +3052,10 @@
         "sizing": "full"
       },
       "consumers": [
-        "src/app/components/api-reference.tsx",
-        "src/app/components/componentPreviewRegistry.tsx",
-        "src/app/components/propTableUtils.tsx",
+        "src/app/components/table.test.tsx",
         "src/app/data/hdsEditorial.tsx",
+        "src/docs-tooling/api-reference.tsx",
+        "src/docs-tooling/propTableUtils.tsx",
         "src/stories/nav-group.stories.tsx",
         "src/stories/nav-item.stories.tsx",
         "src/stories/segmented-control.stories.tsx",
@@ -3197,6 +3131,7 @@
         "primitives-table--density-comfortable",
         "primitives-table--density-compact",
         "primitives-table--flush",
+        "primitives-table--sortable",
         "primitives-table--with-badge-slots",
         "primitives-table--with-caption"
       ]
@@ -3222,7 +3157,6 @@
         "src/app/components/card.tsx",
         "src/app/components/center.tsx",
         "src/app/components/cluster.tsx",
-        "src/app/components/componentPreviewRegistry.tsx",
         "src/app/components/cover.tsx",
         "src/app/components/file-input.tsx",
         "src/app/components/frame.tsx",
@@ -3389,18 +3323,17 @@
         "src/app/components/box-sx.ts",
         "src/app/components/box.tsx",
         "src/app/components/code-block.tsx",
-        "src/app/components/componentPreviewRegistry.tsx",
         "src/app/components/foundation-swatch.tsx",
-        "src/app/components/health-rail.tsx",
-        "src/app/components/lab/legacy-token-detail.tsx",
-        "src/app/components/lab/legacy-token-list.tsx",
-        "src/app/components/lab/token-collection-list.tsx",
         "src/app/components/side-nav.tsx",
-        "src/app/components/TokenDisplayToggle.tsx",
         "src/app/data/hdsEditorial.tsx",
         "src/app/design-system/generated-token-descriptions.ts",
         "src/app/lib/hds-search.ts",
         "src/app/stores/mobiusStore.ts",
+        "src/docs-tooling/health-rail.tsx",
+        "src/docs-tooling/lab/legacy-token-detail.tsx",
+        "src/docs-tooling/lab/legacy-token-list.tsx",
+        "src/docs-tooling/lab/token-collection-list.tsx",
+        "src/docs-tooling/TokenDisplayToggle.tsx",
         "src/index.ts",
         "src/stories/activity-feed.stories.tsx",
         "src/stories/card.stories.tsx",
@@ -3555,23 +3488,15 @@
         "sizing": "panel"
       },
       "consumers": [
-        "src/app/components/api-reference.tsx",
-        "src/app/components/component-preview.tsx",
         "src/app/components/container.tsx",
-        "src/app/components/controls-panel.tsx",
         "src/app/components/dialog.tsx",
         "src/app/components/disclosure.tsx",
-        "src/app/components/doc-page-header.tsx",
         "src/app/components/empty-state.tsx",
         "src/app/components/error-boundary.tsx",
         "src/app/components/error-pattern.tsx",
         "src/app/components/foundation-swatch.tsx",
         "src/app/components/image-lightbox.tsx",
-        "src/app/components/lab/token-list.tsx",
         "src/app/components/popover.tsx",
-        "src/app/components/preview-frame.tsx",
-        "src/app/components/shell-controls.tsx",
-        "src/app/components/sketch-controls.tsx",
         "src/app/components/sketch.tsx",
         "src/app/components/slider.tsx",
         "src/app/components/stepper-field.tsx",
@@ -3582,6 +3507,14 @@
         "src/app/components/tooltip.tsx",
         "src/app/data/hdsEditorial.tsx",
         "src/app/layouts/CaseStudyLayout.tsx",
+        "src/docs-tooling/api-reference.tsx",
+        "src/docs-tooling/component-preview.tsx",
+        "src/docs-tooling/controls-panel.tsx",
+        "src/docs-tooling/doc-page-header.tsx",
+        "src/docs-tooling/lab/token-list.tsx",
+        "src/docs-tooling/preview-frame.tsx",
+        "src/docs-tooling/shell-controls.tsx",
+        "src/docs-tooling/sketch-controls.tsx",
         "src/stories/card.stories.tsx",
         "src/stories/container.stories.tsx",
         "src/stories/grid.stories.tsx",
@@ -3904,7 +3837,6 @@
         "sizing": "full"
       },
       "consumers": [
-        "src/app/components/componentPreviewRegistry.tsx",
         "src/stories/component-instance-matrix.stories.tsx"
       ],
       "tokenMapping": {},
@@ -3930,40 +3862,6 @@
         "primitives-component-instance-matrix--mobile-layout"
       ]
     },
-    "SpecimenBlock": {
-      "category": "Utilities",
-      "categorySource": "jsdoc",
-      "governedCategory": true,
-      "hidden": false,
-      "filePath": "src/app/components/specimen-block.tsx",
-      "description": "SpecimenBlock — shared component-doc specimen block with preview, variant deck, and optional matrix.",
-      "figmaUrl": null,
-      "figmaId": null,
-      "preview": {
-        "exportName": "SpecimenBlock",
-        "sizing": "panel"
-      },
-      "consumers": [
-        "src/app/components/api-reference.tsx",
-        "src/app/components/componentPreviewRegistry.tsx"
-      ],
-      "tokenMapping": {},
-      "props": {},
-      "allowedChildren": [
-        "*"
-      ],
-      "propConstraints": {},
-      "requiredProps": [],
-      "a11yRules": [],
-      "tier": "primitive",
-      "docExempt": true,
-      "variantAxes": [],
-      "componentProperties": [],
-      "sourcePath": "src/app/components/SpecimenBlock.tsx",
-      "figmaLink": null,
-      "storyFiles": [],
-      "storyIds": []
-    },
     "ActivityFeed": {
       "category": "Display",
       "categorySource": "jsdoc",
@@ -3979,6 +3877,7 @@
       },
       "consumers": [
         "src/app/components/activity-feed.test.tsx",
+        "src/index.ts",
         "src/stories/activity-feed.stories.tsx"
       ],
       "tokenMapping": {},
@@ -4303,13 +4202,13 @@
         "src/app/components/foundation-swatch.tsx",
         "src/app/components/hds-tooltip.tsx",
         "src/app/components/nav-item.tsx",
-        "src/app/components/preview-frame.tsx",
         "src/app/components/table.tsx",
         "src/app/components/text-lockup.tsx",
         "src/app/components/tokenTableUtils.ts",
         "src/app/components/toolbar.test.tsx",
         "src/app/design-system/generated-token-descriptions.ts",
         "src/brand/overlay.ts",
+        "src/docs-tooling/preview-frame.tsx",
         "src/stories/container.stories.tsx",
         "src/stories/disclosure.stories.tsx",
         "src/stories/error-boundary.stories.tsx",
@@ -4571,6 +4470,7 @@
         "sizing": "panel"
       },
       "consumers": [
+        "src/index.ts",
         "src/stories/stacked-card-rail.stories.tsx"
       ],
       "tokenMapping": {},
@@ -4617,11 +4517,9 @@
         "src/app/components/activity-feed.tsx",
         "src/app/components/alert-dialog.tsx",
         "src/app/components/animated-label.tsx",
-        "src/app/components/api-reference.tsx",
         "src/app/components/button-group.test.tsx",
         "src/app/components/button-group.tsx",
         "src/app/components/card.tsx",
-        "src/app/components/componentPreviewRegistry.tsx",
         "src/app/components/dialog.tsx",
         "src/app/components/error-boundary.tsx",
         "src/app/components/error-pattern.tsx",
@@ -4633,13 +4531,15 @@
         "src/app/components/pagination.tsx",
         "src/app/components/popover.tsx",
         "src/app/components/segmented-control.tsx",
-        "src/app/components/sketch-controls.tsx",
         "src/app/components/toast.tsx",
         "src/app/components/toolbar.test.tsx",
         "src/app/components/toolbar.tsx",
-        "src/app/components/variant-strip.tsx",
         "src/app/context/DemoStateContext.tsx",
         "src/app/design-system/generated-token-descriptions.ts",
+        "src/docs-tooling/api-reference.tsx",
+        "src/docs-tooling/doc-page-header.test.tsx",
+        "src/docs-tooling/sketch-controls.tsx",
+        "src/docs-tooling/variant-strip.tsx",
         "src/form/index.ts",
         "src/mui/index.ts",
         "src/stories/alert-dialog.stories.tsx",
@@ -4939,7 +4839,7 @@
         "sizing": "panel"
       },
       "consumers": [
-        "src/app/components/lab/legacy-token-detail.tsx",
+        "src/docs-tooling/lab/legacy-token-detail.tsx",
         "src/stories/empty-state.stories.tsx",
         "src/stories/patterns-layout.stories.tsx"
       ],
@@ -5095,6 +4995,7 @@
         "src/app/components/toast.tsx",
         "src/app/design-system/generated-token-descriptions.ts",
         "src/brand/overlay.ts",
+        "src/index.ts",
         "src/stories/error-pattern.stories.tsx",
         "src/stories/heading-stack.stories.tsx",
         "src/stories/not-found-pattern.stories.tsx",
@@ -5475,10 +5376,9 @@
       "consumers": [
         "src/app/components/alert.tsx",
         "src/app/components/card.tsx",
-        "src/app/components/componentPreviewRegistry.tsx",
-        "src/app/components/lab/legacy-token-detail.tsx",
         "src/app/data/hdsEditorial.tsx",
         "src/app/design-system/generated-token-descriptions.ts",
+        "src/docs-tooling/lab/legacy-token-detail.tsx",
         "src/mui/index.ts",
         "src/stories/badge.stories.tsx",
         "src/stories/code-block.stories.tsx",
@@ -5556,7 +5456,6 @@
         "sizing": "compact"
       },
       "consumers": [
-        "src/app/components/componentPreviewRegistry.tsx",
         "src/stories/text-lockup.stories.tsx"
       ],
       "tokenMapping": {},
@@ -5589,11 +5488,11 @@
         "sizing": "panel"
       },
       "consumers": [
-        "src/app/components/componentPreviewRegistry.tsx",
         "src/app/components/hds-tooltip.tsx",
         "src/app/components/image-lightbox.tsx",
         "src/app/components/tooltip.tsx",
         "src/app/data/hdsEditorial.tsx",
+        "src/index.ts",
         "src/stories/asset-img.stories.tsx"
       ],
       "tokenMapping": {},
@@ -5924,26 +5823,26 @@
         "primitives-tabs--with-disabled-tab"
       ]
     },
-    "HdsRadio": {
+    "Radio": {
       "category": "Inputs",
       "categorySource": "jsdoc",
       "governedCategory": true,
       "hidden": false,
       "filePath": "src/app/components/radio.tsx",
-      "description": "HdsRadio — radio button with animated selection indicator.",
+      "description": "Radio — radio button with animated selection indicator.",
       "figmaUrl": "https://www.figma.com/design/c8MaVgwxOlxm4wr8wnH0Z4/HDS-Tokens-Components?node-id=36-17",
       "figmaId": null,
       "preview": {
-        "exportName": "HdsRadio",
+        "exportName": "Radio",
         "sizing": "panel"
       },
       "consumers": [
-        "src/app/components/componentPreviewRegistry.tsx",
-        "src/app/components/controls.tsx",
+        "src/app/components/checkbox.tsx",
         "src/app/components/radio.test.tsx",
-        "src/app/data/hdsEditorial.tsx",
         "src/app/hooks/useInteractionState.test.ts",
         "src/app/hooks/useInteractionState.ts",
+        "src/index.ts",
+        "src/stories/menu.stories.tsx",
         "src/stories/radio.stories.tsx"
       ],
       "tokenMapping": {
@@ -5992,24 +5891,34 @@
         "primitives-radio--selected"
       ]
     },
-    "HdsSelect": {
+    "Select": {
       "category": "Inputs",
       "categorySource": "jsdoc",
       "governedCategory": true,
       "hidden": false,
       "filePath": "src/app/components/select.tsx",
-      "description": "HdsSelect — dropdown selector built on Radix Select.",
+      "description": "Select — dropdown selector built on Radix Select (ADR-001 Radix convention). Radix owns the listbox a11y contract: managed focus + active-descendant, typeahead, full keyboard (Home/End/PageUp-Down/wrap), Popper collision/flip positioning, and dismissal. The HDS surface is styled with the token-backed Tailwind idiom used by tabs.tsx / command-palette.tsx; `ref` targets the trigger button.",
       "figmaUrl": "https://www.figma.com/design/c8MaVgwxOlxm4wr8wnH0Z4/HDS-Tokens-Components?node-id=82-49",
       "figmaId": null,
       "preview": {
-        "exportName": "HdsSelect",
+        "exportName": "Select",
         "sizing": "panel"
       },
       "consumers": [
-        "src/app/components/componentPreviewRegistry.tsx",
-        "src/app/components/controls.tsx",
+        "src/app/components/checkbox.test.tsx",
+        "src/app/components/combobox.test.tsx",
+        "src/app/components/combobox.tsx",
+        "src/app/components/date-range-input.test.tsx",
+        "src/app/components/date-range-input.tsx",
+        "src/app/components/form.tsx",
+        "src/app/components/multi-selector.test.tsx",
+        "src/app/components/multi-selector.tsx",
         "src/app/components/select.test.tsx",
         "src/app/data/hdsEditorial.tsx",
+        "src/docs-tooling/lab/legacy-token-detail.tsx",
+        "src/index.ts",
+        "src/stories/checkbox.stories.tsx",
+        "src/stories/combobox.stories.tsx",
         "src/stories/select.stories.tsx"
       ],
       "tokenMapping": {
@@ -6057,23 +5966,21 @@
         "primitives-select--no-label"
       ]
     },
-    "HdsSlider": {
+    "Slider": {
       "category": "Inputs",
       "categorySource": "jsdoc",
       "governedCategory": true,
       "hidden": false,
       "filePath": "src/app/components/slider.tsx",
-      "description": "HdsSlider — range slider with label and value display.",
+      "description": "Slider — range slider with label and value display.",
       "figmaUrl": "https://www.figma.com/design/c8MaVgwxOlxm4wr8wnH0Z4/HDS-Tokens-Components?node-id=82-265",
       "figmaId": null,
       "preview": {
-        "exportName": "HdsSlider",
+        "exportName": "Slider",
         "sizing": "panel"
       },
       "consumers": [
-        "src/app/components/componentPreviewRegistry.tsx",
-        "src/app/components/controls.tsx",
-        "src/app/data/hdsEditorial.tsx",
+        "src/index.ts",
         "src/stories/slider.stories.tsx"
       ],
       "tokenMapping": {
@@ -6124,27 +6031,29 @@
         "primitives-slider--typography-controls"
       ]
     },
-    "HdsToggle": {
+    "Toggle": {
       "category": "Inputs",
       "categorySource": "jsdoc",
       "governedCategory": true,
       "hidden": false,
       "filePath": "src/app/components/toggle.tsx",
-      "description": "HdsToggle — boolean on/off toggle with animated thumb.",
+      "description": "Toggle — boolean on/off toggle with animated thumb.",
       "figmaUrl": "https://www.figma.com/design/c8MaVgwxOlxm4wr8wnH0Z4/HDS-Tokens-Components?node-id=37-19",
       "figmaId": null,
       "preview": {
-        "exportName": "HdsToggle",
+        "exportName": "Toggle",
         "sizing": "panel"
       },
       "consumers": [
-        "src/app/components/componentPreviewRegistry.tsx",
-        "src/app/components/controls.tsx",
+        "src/app/components/checkbox.tsx",
         "src/app/components/radio.tsx",
+        "src/app/components/toggle-button.tsx",
         "src/app/components/toggle.test.tsx",
         "src/app/data/hdsEditorial.tsx",
         "src/app/hooks/useInteractionState.test.ts",
         "src/app/hooks/useInteractionState.ts",
+        "src/docs-tooling/shell-controls.tsx",
+        "src/index.ts",
         "src/stories/toggle.stories.tsx"
       ],
       "tokenMapping": {
@@ -6214,6 +6123,7 @@
         "src/app/components/avatar-group.test.tsx",
         "src/app/components/avatar-group.tsx",
         "src/app/components/avatar.test.tsx",
+        "src/app/design-system/generated-token-descriptions.ts",
         "src/stories/avatar-group.stories.tsx",
         "src/stories/avatar.stories.tsx"
       ],
@@ -6550,49 +6460,6 @@
         "primitives-pagination--wide-siblings"
       ]
     },
-    "HdsCheckbox": {
-      "category": "Inputs",
-      "filePath": "src/app/components/checkbox.tsx",
-      "description": "HdsCheckbox — custom-drawn checkbox with check / indeterminate glyph.",
-      "hidden": false,
-      "props": {},
-      "allowedChildren": [
-        "*"
-      ],
-      "propConstraints": {},
-      "requiredProps": [],
-      "a11yRules": [],
-      "preview": {
-        "exportName": "HdsCheckbox",
-        "sizing": "panel"
-      },
-      "tokenMapping": {},
-      "tier": "primitive",
-      "categorySource": "jsdoc",
-      "governedCategory": true,
-      "docExempt": false,
-      "figmaUrl": "https://www.figma.com/design/c8MaVgwxOlxm4wr8wnH0Z4/HDS-Tokens-Components?node-id=35-29",
-      "figmaId": null,
-      "figmaLink": "https://www.figma.com/design/c8MaVgwxOlxm4wr8wnH0Z4/HDS-Tokens-Components?node-id=35-29",
-      "consumers": [
-        "src/app/components/checkbox.test.tsx",
-        "src/app/components/radio.tsx",
-        "src/stories/checkbox.stories.tsx"
-      ],
-      "variantAxes": [],
-      "componentProperties": [],
-      "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"
-      ]
-    },
     "ToastProvider": {
       "category": "Feedback",
       "categorySource": "jsdoc",
@@ -6744,6 +6611,7 @@
         "src/form/hds-form.tsx",
         "src/form/index.ts",
         "src/form/use-hds-form.ts",
+        "src/index.ts",
         "src/stories/form.stories.tsx",
         "src/stories/patterns-layout.stories.tsx"
       ],
@@ -7481,6 +7349,7 @@
       "consumers": [
         "src/app/components/side-nav.test.tsx",
         "src/app/layouts/HdsDocsShell.tsx",
+        "src/index.ts",
         "src/stories/side-nav.stories.tsx"
       ],
       "tokenMapping": {},
@@ -7529,6 +7398,7 @@
       "consumers": [
         "src/app/data/nav-model.test.ts",
         "src/app/lib/hds-search.ts",
+        "src/index.ts",
         "src/stories/command-palette.stories.tsx"
       ],
       "tokenMapping": {},
@@ -7572,6 +7442,7 @@
       "consumers": [
         "src/app/components/image-lightbox.test.tsx",
         "src/app/data/hdsEditorial.tsx",
+        "src/index.ts",
         "src/stories/asset-img.stories.tsx",
         "src/stories/image-lightbox.stories.tsx"
       ],
@@ -7644,6 +7515,7 @@
       },
       "consumers": [
         "src/app/components/app-shell.test.tsx",
+        "src/index.ts",
         "src/stories/app-shell.stories.tsx"
       ],
       "tokenMapping": {},
@@ -7683,6 +7555,7 @@
       },
       "consumers": [
         "src/app/components/file-input.test.tsx",
+        "src/index.ts",
         "src/stories/file-input.stories.tsx"
       ],
       "tokenMapping": {},
@@ -7794,6 +7667,7 @@
       },
       "consumers": [
         "src/app/components/overflow-list.test.tsx",
+        "src/index.ts",
         "src/stories/overflow-list.stories.tsx"
       ],
       "tokenMapping": {},
@@ -7956,6 +7830,7 @@
       "consumers": [
         "src/app/components/top-nav.test.tsx",
         "src/app/layouts/HdsDocsShell.tsx",
+        "src/index.ts",
         "src/stories/top-nav.stories.tsx"
       ],
       "tokenMapping": {},
@@ -8011,6 +7886,7 @@
       },
       "consumers": [
         "src/app/components/carousel.test.tsx",
+        "src/index.ts",
         "src/stories/carousel.stories.tsx"
       ],
       "tokenMapping": {},
@@ -8061,6 +7937,7 @@
       },
       "consumers": [
         "src/app/components/stepper.test.tsx",
+        "src/index.ts",
         "src/stories/stepper.stories.tsx"
       ],
       "tokenMapping": {},
@@ -8114,6 +7991,7 @@
       },
       "consumers": [
         "src/app/components/toolbar.test.tsx",
+        "src/index.ts",
         "src/stories/toolbar.stories.tsx"
       ],
       "tokenMapping": {},
@@ -8156,6 +8034,7 @@
       },
       "consumers": [
         "src/app/components/tree-list.test.tsx",
+        "src/index.ts",
         "src/stories/tree-list.stories.tsx"
       ],
       "tokenMapping": {},
@@ -8295,6 +8174,7 @@
         "src/app/components/date-input.tsx",
         "src/app/components/date-range-input.tsx",
         "src/app/components/date-time-input.tsx",
+        "src/index.ts",
         "src/stories/calendar.stories.tsx",
         "src/stories/date-input.stories.tsx",
         "src/stories/date-range-input.stories.tsx",
@@ -9462,6 +9342,7 @@
       "consumers": [
         "src/app/components/pin.tsx",
         "src/app/components/reveal.test.tsx",
+        "src/index.ts",
         "src/stories/patterns-scroll.stories.tsx",
         "src/stories/reveal.stories.tsx"
       ],
@@ -10304,29 +10185,32 @@
         "primitives-dialog--no-close-affordance"
       ]
     },
-    "HdsTooltip": {
+    "Tooltip": {
       "category": "Internal",
       "categorySource": "internal-jsdoc",
       "governedCategory": true,
       "hidden": true,
       "docExempt": true,
       "filePath": "src/app/components/hds-tooltip.tsx",
-      "description": "Tooltip root. Bakes in the Radix Provider so a single `<HdsTooltip>` is self-contained — no app-level provider required. Controlled via `open`/`onOpenChange`, or uncontrolled with `defaultOpen`.",
+      "description": "Tooltip root. Bakes in the Radix Provider so a single `<Tooltip>` is self-contained — no app-level provider required. Controlled via `open`/`onOpenChange`, or uncontrolled with `defaultOpen`.",
       "figmaUrl": null,
       "figmaId": null,
-      "figmaLink": null,
       "tier": "primitive",
       "preview": {
-        "exportName": "HdsTooltip",
+        "exportName": "Tooltip",
         "sizing": "panel"
       },
       "consumers": [
+        "src/app/components/asset-img.tsx",
         "src/app/components/hover-card.tsx",
+        "src/app/data/hdsEditorial.tsx",
+        "src/index.ts",
         "src/stories/hds-tooltip.stories.tsx"
       ],
       "tokenMapping": {},
       "variantAxes": [],
       "componentProperties": [],
+      "figmaLink": null,
       "props": {},
       "allowedChildren": [
         "*"
@@ -10365,7 +10249,7 @@
         "src/app/components/hover-card.tsx",
         "src/app/components/menu.test.tsx",
         "src/app/components/multi-selector.tsx",
-        "src/app/components/shell-controls.tsx",
+        "src/docs-tooling/shell-controls.tsx",
         "src/stories/menu.stories.tsx"
       ],
       "tokenMapping": {},
@@ -10513,6 +10397,64 @@
         "layout-hdsdocsshell--with-top-offset"
       ]
     },
+    "Checkbox": {
+      "category": "Inputs",
+      "categorySource": "jsdoc",
+      "governedCategory": true,
+      "hidden": false,
+      "docExempt": false,
+      "filePath": "src/app/components/checkbox.tsx",
+      "description": "Checkbox — custom-drawn checkbox with check / indeterminate glyph.",
+      "figmaUrl": "https://www.figma.com/design/c8MaVgwxOlxm4wr8wnH0Z4/HDS-Tokens-Components?node-id=35-29",
+      "figmaId": null,
+      "figmaLink": "https://www.figma.com/design/c8MaVgwxOlxm4wr8wnH0Z4/HDS-Tokens-Components?node-id=35-29",
+      "tier": "primitive",
+      "preview": {
+        "exportName": "Checkbox",
+        "sizing": "panel"
+      },
+      "consumers": [
+        "src/app/components/checkbox.test.tsx",
+        "src/app/components/radio.tsx",
+        "src/index.ts",
+        "src/stories/checkbox.stories.tsx"
+      ],
+      "tokenMapping": {},
+      "variantAxes": [],
+      "componentProperties": [],
+      "props": {
+        "checked": {
+          "type": "boolean"
+        },
+        "indeterminate": {
+          "type": "boolean",
+          "default": false
+        },
+        "label": {
+          "type": "string"
+        },
+        "onChange": {
+          "type": "(v: boolean) => void"
+        }
+      },
+      "allowedChildren": [
+        "*"
+      ],
+      "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"
+      ]
+    },
     "HdsPhosphor": {
       "category": "Compiler",
       "filePath": "scripts/hds-jsx-compiler.mjs",
@@ -10593,6 +10535,22 @@
       "storyFiles": [],
       "storyIds": []
     },
+    "HdsCheckbox": {
+      "category": "Compiler",
+      "filePath": "scripts/hds-jsx-compiler.mjs",
+      "description": "Compiler-recognized checkbox instance stub for generated JSX validation.",
+      "hidden": true,
+      "tier": "utility",
+      "props": {},
+      "allowedChildren": [
+        "*"
+      ],
+      "propConstraints": {},
+      "requiredProps": [],
+      "a11yRules": [],
+      "storyFiles": [],
+      "storyIds": []
+    },
     "HdsChip": {
       "category": "Compiler",
       "filePath": "scripts/hds-jsx-compiler.mjs",
@@ -10899,11 +10857,12 @@
       "tokenMapping": {},
       "tier": "utility"
     },
-    "HdsChip": {
+    "HdsCheckbox": {
       "category": "Compiler",
       "filePath": "scripts/hds-jsx-compiler.mjs",
-      "description": "Compiler-recognized chip instance stub for generated JSX validation.",
+      "description": "Compiler-recognized checkbox instance stub for generated JSX validation.",
       "hidden": true,
+      "tier": "utility",
       "props": {},
       "allowedChildren": [
         "*"
@@ -10911,14 +10870,13 @@
       "propConstraints": {},
       "requiredProps": [],
       "a11yRules": [],
-      "preview": {},
-      "tokenMapping": {},
-      "tier": "utility"
+      "storyFiles": [],
+      "storyIds": []
     },
-    "HdsAvatar": {
+    "HdsChip": {
       "category": "Compiler",
       "filePath": "scripts/hds-jsx-compiler.mjs",
-      "description": "User identity glyph. Square or circle, sized on the 8px grid (24/32/40/48/64). Initial-letter fallback uses semantic.typography.small (font-medium, never bold). Image variant is object-cover, never object-fill. Radius is semantic.radius.action for square or semantic.radius.pill for circle.",
+      "description": "Compiler-recognized chip instance stub for generated JSX validation.",
       "hidden": true,
       "props": {},
       "allowedChildren": [
@@ -10931,47 +10889,11 @@
       "tokenMapping": {},
       "tier": "utility"
     },
-    "AutoPreviewSpecimen": {
-      "category": "Uncategorized",
-      "categorySource": "internal-jsdoc",
-      "governedCategory": true,
-      "hidden": true,
-      "docExempt": true,
-      "filePath": "src/app/components/componentPreviewRegistry.tsx",
-      "description": "/** @internal @doc-exempt: demo-preview-helper — not part of @hirobius/design-system public API.",
-      "figmaUrl": null,
-      "figmaId": null,
-      "figmaLink": null,
-      "tier": "utility",
-      "preview": {
-        "exportName": "AutoPreviewSpecimen",
-        "sizing": "panel"
-      },
-      "consumers": [
-        "src/app/components/specimen-block.tsx"
-      ],
-      "tokenMapping": {},
-      "variantAxes": [],
-      "componentProperties": []
-    },
-    "VariantPreviewDeck": {
-      "category": "Uncategorized",
-      "categorySource": "internal-jsdoc",
-      "governedCategory": true,
+    "HdsAvatar": {
+      "category": "Compiler",
+      "filePath": "scripts/hds-jsx-compiler.mjs",
+      "description": "User identity glyph. Square or circle, sized on the 8px grid (24/32/40/48/64). Initial-letter fallback uses semantic.typography.small (font-medium, never bold). Image variant is object-cover, never object-fill. Radius is semantic.radius.action for square or semantic.radius.pill for circle.",
       "hidden": true,
-      "filePath": "src/app/components/variant-preview-deck.tsx",
-      "description": "/** @internal @doc-exempt: demo-preview-helper — not part of @hirobius/design-system public API.",
-      "figmaUrl": null,
-      "figmaId": null,
-      "preview": {
-        "exportName": "VariantPreviewDeck",
-        "sizing": "panel"
-      },
-      "consumers": [
-        "src/app/components/componentPreviewRegistry.tsx",
-        "src/app/components/specimen-block.tsx"
-      ],
-      "tokenMapping": {},
       "props": {},
       "allowedChildren": [
         "*"
@@ -10979,11 +10901,9 @@
       "propConstraints": {},
       "requiredProps": [],
       "a11yRules": [],
-      "tier": "utility",
-      "docExempt": true,
-      "variantAxes": [],
-      "componentProperties": [],
-      "figmaLink": null
+      "preview": {},
+      "tokenMapping": {},
+      "tier": "utility"
     },
     "HistoryCard": {
       "category": "Uncategorized",
@@ -10999,7 +10919,6 @@
         "sizing": "panel"
       },
       "consumers": [
-        "src/app/components/componentPreviewRegistry.tsx",
         "src/stories/history-card.stories.tsx"
       ],
       "tokenMapping": {},
@@ -11029,7 +10948,7 @@
       "categorySource": "internal-jsdoc",
       "governedCategory": true,
       "hidden": true,
-      "filePath": "src/app/components/component-preview.tsx",
+      "filePath": "src/docs-tooling/component-preview.tsx",
       "description": "ComponentPreview - framed preview harness for utility and lab specimens.",
       "figmaUrl": null,
       "figmaId": null,
@@ -11038,7 +10957,6 @@
         "sizing": "panel"
       },
       "consumers": [
-        "src/app/components/componentPreviewRegistry.tsx",
         "src/app/data/hdsEditorial.tsx"
       ],
       "tokenMapping": {},
@@ -11068,9 +10986,7 @@
         "exportName": "AnimatedLabel",
         "sizing": "compact"
       },
-      "consumers": [
-        "src/app/components/componentPreviewRegistry.tsx"
-      ],
+      "consumers": [],
       "tokenMapping": {},
       "props": {},
       "allowedChildren": [
@@ -11090,7 +11006,7 @@
       "categorySource": "internal-jsdoc",
       "governedCategory": true,
       "hidden": true,
-      "filePath": "src/app/components/controls-panel.tsx",
+      "filePath": "src/docs-tooling/controls-panel.tsx",
       "description": "shared shell composition documented alongside the HDS doc utilities.",
       "figmaUrl": null,
       "figmaId": null,
@@ -11099,7 +11015,6 @@
         "sizing": "panel"
       },
       "consumers": [
-        "src/app/components/componentPreviewRegistry.tsx",
         "src/app/data/hdsEditorial.tsx"
       ],
       "tokenMapping": {},
@@ -11121,7 +11036,7 @@
       "categorySource": "internal-jsdoc",
       "governedCategory": true,
       "hidden": true,
-      "filePath": "src/app/components/controls-panel.tsx",
+      "filePath": "src/docs-tooling/controls-panel.tsx",
       "description": "shared shell composition documented alongside the HDS doc utilities.",
       "figmaUrl": null,
       "figmaId": null,
@@ -11130,7 +11045,6 @@
         "sizing": "panel"
       },
       "consumers": [
-        "src/app/components/componentPreviewRegistry.tsx",
         "src/app/data/hdsEditorial.tsx"
       ],
       "tokenMapping": {},
@@ -11152,7 +11066,7 @@
       "categorySource": "internal-jsdoc",
       "governedCategory": true,
       "hidden": true,
-      "filePath": "src/app/components/shell-controls.tsx",
+      "filePath": "src/docs-tooling/shell-controls.tsx",
       "description": "shell-only extraction for HDS navigation chrome, not a consumer-facing reusable HDS component.",
       "figmaUrl": null,
       "figmaId": null,
@@ -11160,9 +11074,7 @@
         "exportName": "HdsMobileTopBar",
         "sizing": "panel"
       },
-      "consumers": [
-        "src/app/components/componentPreviewRegistry.tsx"
-      ],
+      "consumers": [],
       "tokenMapping": {},
       "props": {},
       "allowedChildren": [
@@ -11182,7 +11094,7 @@
       "categorySource": "missing-jsdoc",
       "governedCategory": false,
       "hidden": false,
-      "filePath": "src/app/components/preview-frame.tsx",
+      "filePath": "src/docs-tooling/preview-frame.tsx",
       "description": "PreviewFrame - documentation preview shell for storefront component demos.",
       "figmaUrl": null,
       "figmaId": null,
@@ -11191,9 +11103,7 @@
         "sizing": "panel"
       },
       "consumers": [
-        "src/app/components/componentPreviewRegistry.tsx",
-        "src/app/components/demo-block.tsx",
-        "src/app/components/specimen-block.tsx"
+        "src/docs-tooling/demo-block.tsx"
       ],
       "tokenMapping": {},
       "props": {},
@@ -11214,7 +11124,7 @@
       "categorySource": "internal-jsdoc",
       "governedCategory": true,
       "hidden": true,
-      "filePath": "src/app/components/shell-controls.tsx",
+      "filePath": "src/docs-tooling/shell-controls.tsx",
       "description": "shell-only extraction for HDS navigation chrome, not a consumer-facing reusable HDS component.",
       "figmaUrl": null,
       "figmaId": null,
@@ -11222,9 +11132,7 @@
         "exportName": "HdsSidebarUtilityButton",
         "sizing": "compact"
       },
-      "consumers": [
-        "src/app/components/componentPreviewRegistry.tsx"
-      ],
+      "consumers": [],
       "tokenMapping": {},
       "props": {},
       "allowedChildren": [
@@ -11274,7 +11182,7 @@
       "categorySource": "internal-jsdoc",
       "governedCategory": true,
       "hidden": true,
-      "filePath": "src/app/components/sketch-controls.tsx",
+      "filePath": "src/docs-tooling/sketch-controls.tsx",
       "description": "",
       "figmaUrl": null,
       "figmaId": null,
@@ -11302,7 +11210,7 @@
       "categorySource": "internal-jsdoc",
       "governedCategory": true,
       "hidden": true,
-      "filePath": "src/app/components/sketch-controls.tsx",
+      "filePath": "src/docs-tooling/sketch-controls.tsx",
       "description": "",
       "figmaUrl": null,
       "figmaId": null,
@@ -11330,7 +11238,7 @@
       "categorySource": "internal-jsdoc",
       "governedCategory": true,
       "hidden": true,
-      "filePath": "src/app/components/sketch-controls.tsx",
+      "filePath": "src/docs-tooling/sketch-controls.tsx",
       "description": "",
       "figmaUrl": null,
       "figmaId": null,
@@ -11358,7 +11266,7 @@
       "categorySource": "internal-jsdoc",
       "governedCategory": true,
       "hidden": true,
-      "filePath": "src/app/components/sketch-controls.tsx",
+      "filePath": "src/docs-tooling/sketch-controls.tsx",
       "description": "",
       "figmaUrl": null,
       "figmaId": null,
@@ -11386,7 +11294,7 @@
       "categorySource": "internal-jsdoc",
       "governedCategory": true,
       "hidden": true,
-      "filePath": "src/app/components/sketch-controls.tsx",
+      "filePath": "src/docs-tooling/sketch-controls.tsx",
       "description": "",
       "figmaUrl": null,
       "figmaId": null,
@@ -11409,53 +11317,6 @@
       "componentProperties": [],
       "figmaLink": null
     },
-    "MorphCard": {
-      "category": "Uncategorized",
-      "categorySource": "internal-jsdoc",
-      "governedCategory": true,
-      "hidden": true,
-      "docExempt": true,
-      "filePath": "src/app/components/morph-card.tsx",
-      "description": "",
-      "figmaUrl": null,
-      "figmaId": null,
-      "tier": "utility",
-      "preview": {
-        "exportName": "MorphCard",
-        "sizing": "panel"
-      },
-      "consumers": [],
-      "tokenMapping": {},
-      "variantAxes": [],
-      "componentProperties": [],
-      "figmaLink": null
-    },
-    "Tooltip": {
-      "category": "Uncategorized",
-      "categorySource": "internal-jsdoc",
-      "governedCategory": true,
-      "hidden": true,
-      "docExempt": true,
-      "filePath": "src/app/components/tooltip.tsx",
-      "description": "",
-      "figmaUrl": null,
-      "figmaId": null,
-      "tier": "utility",
-      "preview": {
-        "exportName": "Tooltip",
-        "sizing": "panel"
-      },
-      "consumers": [
-        "src/app/components/asset-img.tsx",
-        "src/app/components/hds-tooltip.tsx",
-        "src/app/data/hdsEditorial.tsx",
-        "src/stories/hds-tooltip.stories.tsx"
-      ],
-      "tokenMapping": {},
-      "variantAxes": [],
-      "componentProperties": [],
-      "figmaLink": null
-    },
     "NotFoundPattern": {
       "category": "Feedback",
       "categorySource": "internal-jsdoc",
@@ -11487,34 +11348,13 @@
       "docExempt": true,
       "figmaLink": null
     },
-    "CascadeText": {
-      "category": "Uncategorized",
-      "categorySource": "internal-jsdoc",
-      "governedCategory": true,
-      "hidden": true,
-      "docExempt": true,
-      "filePath": "src/app/components/CascadeText.tsx",
-      "description": "",
-      "figmaUrl": null,
-      "figmaId": null,
-      "tier": "utility",
-      "preview": {
-        "exportName": "CascadeText",
-        "sizing": "panel"
-      },
-      "consumers": [],
-      "tokenMapping": {},
-      "variantAxes": [],
-      "componentProperties": [],
-      "figmaLink": null
-    },
     "DocPageSpec": {
       "category": "Uncategorized",
       "categorySource": "internal-jsdoc",
       "governedCategory": true,
       "hidden": true,
       "docExempt": true,
-      "filePath": "src/app/components/DocPageSpec.tsx",
+      "filePath": "src/docs-tooling/DocPageSpec.tsx",
       "description": "",
       "figmaUrl": null,
       "figmaId": null,
@@ -11535,7 +11375,7 @@
       "governedCategory": true,
       "hidden": true,
       "docExempt": true,
-      "filePath": "src/app/components/TokenDisplayToggle.tsx",
+      "filePath": "src/docs-tooling/TokenDisplayToggle.tsx",
       "description": "",
       "figmaUrl": null,
       "figmaId": null,
@@ -11557,7 +11397,7 @@
       "categorySource": "missing-jsdoc",
       "governedCategory": false,
       "hidden": false,
-      "filePath": "src/app/components/lab/legacy-token-detail.tsx",
+      "filePath": "src/docs-tooling/lab/legacy-token-detail.tsx",
       "description": "LegacyTokenDetail - lab-facing token inspection panels used to maintain legacy token views.",
       "figmaUrl": null,
       "figmaId": null,
@@ -11566,8 +11406,7 @@
         "sizing": "panel"
       },
       "consumers": [
-        "src/app/components/componentPreviewRegistry.tsx",
-        "src/app/components/health-rail.tsx"
+        "src/docs-tooling/health-rail.tsx"
       ],
       "tokenMapping": {},
       "props": {
@@ -11603,7 +11442,7 @@
       "categorySource": "jsdoc",
       "governedCategory": true,
       "hidden": false,
-      "filePath": "src/app/components/lab/legacy-token-list.tsx",
+      "filePath": "src/docs-tooling/lab/legacy-token-list.tsx",
       "description": "LegacyTokenList - legacy token grouping list retained for lab-side maintenance workflows. architecture per TASKS.md \"Stale / Superseded\" → \"Live token inspector UI\". Pruning deferred until /hds/tokens is retired or rewritten — see docs/archive/work/2026-05-01-token-explorer-prune-deferred.md.",
       "figmaUrl": null,
       "figmaId": null,
@@ -11611,9 +11450,7 @@
         "exportName": "LegacyTokenList",
         "sizing": "panel"
       },
-      "consumers": [
-        "src/app/components/componentPreviewRegistry.tsx"
-      ],
+      "consumers": [],
       "tokenMapping": {},
       "props": {
         "isDark": {
@@ -11649,7 +11486,7 @@
       "categorySource": "jsdoc",
       "governedCategory": true,
       "hidden": false,
-      "filePath": "src/app/components/lab/token-collection-list.tsx",
+      "filePath": "src/docs-tooling/lab/token-collection-list.tsx",
       "description": "TokenCollectionList - grouped token inventory list for lab and explorer maintenance. architecture per TASKS.md \"Stale / Superseded\" → \"Live token inspector UI\". Pruning deferred until /hds/tokens is retired or rewritten — see docs/archive/work/2026-05-01-token-explorer-prune-deferred.md.",
       "figmaUrl": null,
       "figmaId": null,
@@ -11658,8 +11495,7 @@
         "sizing": "panel"
       },
       "consumers": [
-        "src/app/components/componentPreviewRegistry.tsx",
-        "src/app/components/lab/legacy-token-list.tsx"
+        "src/docs-tooling/lab/legacy-token-list.tsx"
       ],
       "tokenMapping": {},
       "props": {
@@ -11690,7 +11526,7 @@
       "categorySource": "missing-jsdoc",
       "governedCategory": false,
       "hidden": false,
-      "filePath": "src/app/components/lab/token-list.tsx",
+      "filePath": "src/docs-tooling/lab/token-list.tsx",
       "description": "TokenList - searchable token rail for interactive lab-side token inspection.",
       "figmaUrl": null,
       "figmaId": null,
@@ -11698,9 +11534,7 @@
         "exportName": "TokenList",
         "sizing": "panel"
       },
-      "consumers": [
-        "src/app/components/componentPreviewRegistry.tsx"
-      ],
+      "consumers": [],
       "tokenMapping": {},
       "props": {},
       "allowedChildren": [
@@ -11746,7 +11580,7 @@
       "governedCategory": true,
       "hidden": false,
       "docExempt": true,
-      "filePath": "src/app/components/api-reference.tsx",
+      "filePath": "src/docs-tooling/api-reference.tsx",
       "description": "ApiReference — collapsed <details> rendering of a component's public API. Returns `null` when: - The component is missing from the manifest (nothing to render). - The component is a template and `forceForTemplate` is not set. - The component has no props AND no slots (genuinely empty surface).",
       "figmaUrl": null,
       "figmaId": null,
@@ -11767,7 +11601,7 @@
       "governedCategory": true,
       "hidden": true,
       "docExempt": false,
-      "filePath": "src/app/components/doc-page-header.tsx",
+      "filePath": "src/docs-tooling/doc-page-header.tsx",
       "description": "DocPageHeader — standardized header zone mounted at the top of every primitive / pattern / template doc page. Projected from the live HDS manifest; the unit `9d-9` batch refactor wires this component into the doc routes — this file only CREATES the surface. 9d-4 contract (from `docs/ai/orchestration.json`): - H1: component name - Lede: single-line summary derived from `componentSpec.description` (truncated at the first newline / sentence break for the header zone; the full description still flows into the doc body downstream). - Status badge: Stable / Beta — derived from a new optional `componentSpec.stability` field (additive, schema 9d-4). When absent, the default falls back to the unit-spec rule: primitives → 'stable'; patterns and templates → 'beta' when they lack `slots[]` or carry propConstraints warnings, otherwise 'stable'. - Tier chip: primitive / pattern / template / utility (manifest field). - Source link: GitHub blob URL projected from `componentSpec.filePath` against the repo's origin remote (hirobius/adrian-milsap, branch `main` for canonical permalinks). - Figma link: rendered when `componentSpec.figmaUrl` is non-null. Surface rules (component-zone CLAUDE.md): - Heavy prop restriction — one slot, no business logic. - Theming via CSS variables / role tokens only (no inline hex). - Composes Stack rather than re-implementing layout primitives. Anti-goals: - Not a doc-shell — `DocShell` already owns the wordmark, search, theme-toggle, and rail nav. This component lives INSIDE the content column, not the header bar. - Does not render badges as decorative stickers next to prose; they sit in a dedicated metadata row below the H1, per CLAUDE.md.",
       "figmaUrl": null,
       "figmaId": null,
@@ -11777,7 +11611,9 @@
         "exportName": "DocPageHeader",
         "sizing": "panel"
       },
-      "consumers": [],
+      "consumers": [
+        "src/docs-tooling/doc-page-header.test.tsx"
+      ],
       "tokenMapping": {},
       "variantAxes": [],
       "componentProperties": []
@@ -11788,7 +11624,7 @@
       "governedCategory": true,
       "hidden": true,
       "docExempt": false,
-      "filePath": "src/app/components/theme-toggle.tsx",
+      "filePath": "src/docs-tooling/theme-toggle.tsx",
       "description": "ThemeToggle — System / Light / Dark theme dropdown for the doc shell. 9d-3 baseline: a header-slot dropdown with three options: - System — follow `prefers-color-scheme`, react live to OS changes. - Light — force light mode. - Dark — force dark mode. Persistence: - Stored in localStorage under `hds-theme-mode` ('system' | 'light' | 'dark'). - Mirrored to the legacy `hds-theme` key ('light' | 'dark') so the existing ThemeContext binary toggle (if mounted) stays in sync without a hard dependency between the two. Application: - Sets `data-theme=\"light\"` or `data-theme=\"dark\"` on `<html>` so the 8e-2 `role.*` alias layer (theme-aware CSS vars) flips automatically. - Also toggles `<html>.dark` for parity with Tailwind's class-based dark variant (matching the convention already used in ThemeContext). Dependencies: - Zero new npm deps. Native button + click-outside listener. - SVG icons inlined (Sun / Moon / Monitor) — no icon-library dep added. Slot: - Renders into the `data-hds-slot=\"theme-toggle\"` zone in DocShell.",
       "figmaUrl": null,
       "figmaId": null,
@@ -11811,7 +11647,7 @@
       "governedCategory": true,
       "hidden": true,
       "docExempt": true,
-      "filePath": "src/app/components/variant-strip.tsx",
+      "filePath": "src/docs-tooling/variant-strip.tsx",
       "description": "VariantStrip renders a horizontal family strip of component specimens with short labels. Designed for component docs to show all variants, sizes, or tones in a single scannable row.",
       "figmaUrl": null,
       "figmaId": null,
@@ -11832,7 +11668,7 @@
       "governedCategory": true,
       "hidden": true,
       "docExempt": true,
-      "filePath": "src/app/components/demo-block.tsx",
+      "filePath": "src/docs-tooling/demo-block.tsx",
       "figmaUrl": null,
       "figmaId": null,
       "figmaLink": null,
@@ -11852,7 +11688,7 @@
       "governedCategory": true,
       "hidden": false,
       "docExempt": false,
-      "filePath": "src/app/components/page-footer.tsx",
+      "filePath": "src/docs-tooling/page-footer.tsx",
       "description": "PageFooter — minimal page footer rendered by the route shell. Currently houses a binary light/dark theme toggle on the left, with the footer owning its own bottom breathing room so the toggle never pins to the viewport edge. Add elements here as the page footer grows — keeping the shape in one place so every HDSLayout-mounted page gets a consistent footer surface without per-page rendering.",
       "figmaUrl": null,
       "figmaId": null,
@@ -11866,6 +11702,29 @@
       "tokenMapping": {},
       "variantAxes": [],
       "componentProperties": []
+    },
+    "ExpandTooltip": {
+      "category": "Internal",
+      "categorySource": "internal-jsdoc",
+      "governedCategory": true,
+      "hidden": true,
+      "docExempt": true,
+      "filePath": "src/app/components/tooltip.tsx",
+      "figmaUrl": null,
+      "figmaId": null,
+      "figmaLink": null,
+      "tier": "utility",
+      "preview": {
+        "exportName": "ExpandTooltip",
+        "sizing": "panel"
+      },
+      "consumers": [
+        "src/app/components/asset-img.tsx",
+        "src/app/components/hds-tooltip.tsx"
+      ],
+      "tokenMapping": {},
+      "variantAxes": [],
+      "componentProperties": []
     }
   },
   "tokens": {
@@ -12500,62 +12359,71 @@
         "path": "primitive.typography.size.xs",
         "cssVar": "--primitive-typography-size-xs",
         "type": "dimension",
-        "value": "13px"
+        "description": "Tailwind 4 default text-xs (hds#283 ramp).",
+        "value": "12px"
       },
       {
         "path": "primitive.typography.size.sm",
         "cssVar": "--primitive-typography-size-sm",
         "type": "dimension",
-        "value": "15px"
+        "description": "Tailwind 4 default text-sm (hds#283 ramp).",
+        "value": "14px"
       },
       {
         "path": "primitive.typography.size.base",
         "cssVar": "--primitive-typography-size-base",
         "type": "dimension",
-        "value": "17px"
+        "description": "Tailwind 4 default text-base (hds#283 ramp).",
+        "value": "16px"
       },
       {
         "path": "primitive.typography.size.lg",
         "cssVar": "--primitive-typography-size-lg",
         "type": "dimension",
-        "value": "20px"
+        "description": "Tailwind 4 default text-lg (hds#283 ramp).",
+        "value": "18px"
       },
       {
         "path": "primitive.typography.size.xl",
         "cssVar": "--primitive-typography-size-xl",
         "type": "dimension",
-        "value": "24px"
+        "description": "Tailwind 4 default text-xl (hds#283 ramp).",
+        "value": "20px"
       },
       {
         "path": "primitive.typography.size.2xl",
         "cssVar": "--primitive-typography-size-2xl",
         "type": "dimension",
-        "value": "30px"
+        "description": "Tailwind 4 default text-2xl (hds#283 ramp).",
+        "value": "24px"
       },
       {
         "path": "primitive.typography.size.3xl",
         "cssVar": "--primitive-typography-size-3xl",
         "type": "dimension",
-        "value": "36px"
+        "description": "Tailwind 4 default text-3xl (hds#283 ramp).",
+        "value": "30px"
       },
       {
         "path": "primitive.typography.size.4xl",
         "cssVar": "--primitive-typography-size-4xl",
         "type": "dimension",
-        "value": "48px"
+        "description": "Tailwind 4 default text-4xl (hds#283 ramp).",
+        "value": "36px"
       },
       {
         "path": "primitive.typography.size.5xl",
         "cssVar": "--primitive-typography-size-5xl",
         "type": "dimension",
-        "description": "Swiss-canon display size. Static desktop value; fluid in theme.css.",
-        "value": "72px"
+        "description": "Tailwind 4 default text-5xl (hds#283 ramp).",
+        "value": "48px"
       },
       {
         "path": "primitive.typography.size.6xl",
         "cssVar": "--primitive-typography-size-6xl",
         "type": "dimension",
-        "value": "80px"
+        "description": "Swiss-canon display size (hds#283 ramp). Static desktop value; fluid in theme.css. Tailwind 4 default text-6xl.",
+        "value": "60px"
       },
       {
         "path": "primitive.typography.weight.regular",
@@ -12961,6 +12829,14 @@
           "easing": "cubic-bezier(0.4, 0, 1, 1)"
         }
       },
+      {
+        "path": "semantic.motion.distance",
+        "cssVar": "--semantic-motion-distance",
+        "type": "dimension",
+        "description": "Travel distance for a scroll-reveal translateY offset. Coincides in value with semantic.space.scale.md today, but names a motion travel distance rather than a spacing tier (hds#242).",
+        "alias": "{primitive.space.6}",
+        "resolvedValue": "24px"
+      },
       {
         "path": "semantic.color.surface.page",
         "cssVar": "--semantic-color-surface-page",
@@ -13400,6 +13276,62 @@
           "resolvedValue": "#2e1065"
         }
       },
+      {
+        "path": "semantic.space.scale.xs",
+        "cssVar": "--semantic-space-scale-xs",
+        "type": "dimension",
+        "description": "8px — smallest step. Same value as component.gap (deprecated alias).",
+        "alias": "{primitive.space.2}",
+        "resolvedValue": "8px"
+      },
+      {
+        "path": "semantic.space.scale.sm",
+        "cssVar": "--semantic-space-scale-sm",
+        "type": "dimension",
+        "description": "16px — same value as layout.tight (deprecated alias).",
+        "alias": "{primitive.space.4}",
+        "resolvedValue": "16px"
+      },
+      {
+        "path": "semantic.space.scale.md",
+        "cssVar": "--semantic-space-scale-md",
+        "type": "dimension",
+        "description": "24px — same value as layout.normal (deprecated alias). Default of the overridable roles surface.padding and region.gutter, which replace the deprecated component.padding / layout.gutter.",
+        "alias": "{primitive.space.6}",
+        "resolvedValue": "24px"
+      },
+      {
+        "path": "semantic.space.scale.lg",
+        "cssVar": "--semantic-space-scale-lg",
+        "type": "dimension",
+        "description": "32px — same value as layout.inset (deprecated alias).",
+        "alias": "{primitive.space.8}",
+        "resolvedValue": "32px"
+      },
+      {
+        "path": "semantic.space.scale.xl",
+        "cssVar": "--semantic-space-scale-xl",
+        "type": "dimension",
+        "description": "48px — same value as layout.spacious (deprecated alias).",
+        "alias": "{primitive.space.12}",
+        "resolvedValue": "48px"
+      },
+      {
+        "path": "semantic.space.surface.padding",
+        "cssVar": "--semantic-space-surface-padding",
+        "type": "dimension",
+        "description": "24px (scale.md) default inset for cards, forms, panels, and grouped surfaces. Tenants override it with another scale step (tenants/*/tokens.json, incl. a Compact density mode). Replaces the deprecated semantic.space.component.padding.",
+        "alias": "{semantic.space.scale.md}",
+        "resolvedValue": "24px"
+      },
+      {
+        "path": "semantic.space.region.gutter",
+        "cssVar": "--semantic-space-region-gutter",
+        "type": "dimension",
+        "description": "24px (scale.md) column and region gutters. theme.css sets it responsively to scale.lg (32px) and, below 640px, scale.sm (16px). Replaces the deprecated semantic.space.layout.gutter.",
+        "alias": "{semantic.space.scale.md}",
+        "resolvedValue": "24px"
+      },
       {
         "path": "semantic.space.subgrid.hairline",
         "cssVar": "--semantic-space-subgrid-hairline",
@@ -13428,7 +13360,7 @@
         "path": "semantic.space.component.gap",
         "cssVar": "--semantic-space-component-gap",
         "type": "dimension",
-        "description": "8px label↔input rhythm and closely coupled control spacing.",
+        "description": "8px label↔input rhythm and closely coupled control spacing. DEPRECATED alias (hds#206) — use semantic.space.scale.xs; kept live, no removal yet.",
         "alias": "{primitive.space.2}",
         "resolvedValue": "8px"
       },
@@ -13444,15 +13376,15 @@
         "path": "semantic.space.component.padding",
         "cssVar": "--semantic-space-component-padding",
         "type": "dimension",
-        "description": "24px default inset for cards, forms, panels, and grouped surfaces.",
-        "alias": "{primitive.space.6}",
+        "description": "24px default inset for cards, forms, panels, and grouped surfaces. DEPRECATED alias (hds#206) — use semantic.space.surface.padding (tenant/density-overridable); kept live, no removal yet.",
+        "alias": "{semantic.space.surface.padding}",
         "resolvedValue": "24px"
       },
       {
         "path": "semantic.space.layout.tight",
         "cssVar": "--semantic-space-layout-tight",
         "type": "dimension",
-        "description": "16px default HdsStack gap and inter-component spacing.",
+        "description": "16px default HdsStack gap and inter-component spacing. DEPRECATED alias (hds#206) — use semantic.space.scale.sm; kept live, no removal yet.",
         "alias": "{primitive.space.4}",
         "resolvedValue": "16px"
       },
@@ -13460,7 +13392,7 @@
         "path": "semantic.space.layout.normal",
         "cssVar": "--semantic-space-layout-normal",
         "type": "dimension",
-        "description": "24px column gutters and sidebar gutter spacing.",
+        "description": "24px column gutters and sidebar gutter spacing. DEPRECATED alias (hds#206) — use semantic.space.scale.md; kept live, no removal yet.",
         "alias": "{primitive.space.6}",
         "resolvedValue": "24px"
       },
@@ -13468,15 +13400,15 @@
         "path": "semantic.space.layout.gutter",
         "cssVar": "--semantic-space-layout-gutter",
         "type": "dimension",
-        "description": "24px column and region gutters (alias for layout.normal).",
-        "alias": "{primitive.space.6}",
+        "description": "24px column and region gutters. DEPRECATED alias (hds#206) — use semantic.space.region.gutter (responsive in theme.css); kept live, no removal yet.",
+        "alias": "{semantic.space.region.gutter}",
         "resolvedValue": "24px"
       },
       {
         "path": "semantic.space.layout.inset",
         "cssVar": "--semantic-space-layout-inset",
         "type": "dimension",
-        "description": "32px major block separation and inset inter-component gaps.",
+        "description": "32px major block separation and inset inter-component gaps. DEPRECATED alias (hds#206) — use semantic.space.scale.lg; kept live, no removal yet.",
         "alias": "{primitive.space.8}",
         "resolvedValue": "32px"
       },
@@ -13484,7 +13416,7 @@
         "path": "semantic.space.layout.spacious",
         "cssVar": "--semantic-space-layout-spacious",
         "type": "dimension",
-        "description": "48px section break and whitespace separator between major content blocks.",
+        "description": "48px section break and whitespace separator between major content blocks. DEPRECATED alias (hds#206) — use semantic.space.scale.xl; kept live, no removal yet.",
         "alias": "{primitive.space.12}",
         "resolvedValue": "48px"
       },
@@ -13628,10 +13560,10 @@
         "path": "semantic.typography.display",
         "cssVar": "--semantic-typography-display",
         "type": "typography",
-        "description": "Display headline. 72px / Satoshi bold 700 / leading-none.",
+        "description": "Display headline. 60px / Satoshi bold 700 / leading-none (hds#283: was 72px/5xl).",
         "composite": {
           "fontFamily": "Satoshi, system-ui, -apple-system, BlinkMacSystemFont, \"Segoe UI\", sans-serif",
-          "fontSize": "72px",
+          "fontSize": "60px",
           "fontWeight": "700",
           "letterSpacing": "-0.01em",
           "lineHeight": "1"
@@ -13641,7 +13573,7 @@
         "path": "semantic.typography.h1",
         "cssVar": "--semantic-typography-h1",
         "type": "typography",
-        "description": "Primary section headings (h1). 48px / Satoshi bold 700 / leading-tight.",
+        "description": "Primary section headings (h1). 48px / Satoshi bold 700 / leading-tight (hds#283: rung renamed 4xl→5xl, px unchanged).",
         "composite": {
           "fontFamily": "Satoshi, system-ui, -apple-system, BlinkMacSystemFont, \"Segoe UI\", sans-serif",
           "fontSize": "48px",
@@ -13654,20 +13586,20 @@
         "path": "semantic.typography.h2",
         "cssVar": "--semantic-typography-h2",
         "type": "typography",
-        "description": "Secondary section headings (h2). Satoshi bold 700, 30px, line-height 42px.",
+        "description": "Secondary section headings (h2). Satoshi bold 700, 30px, line-height 40px (hds#283: rung renamed, was 42px).",
         "composite": {
           "fontFamily": "Satoshi, system-ui, -apple-system, BlinkMacSystemFont, \"Segoe UI\", sans-serif",
           "fontSize": "30px",
           "fontWeight": "700",
           "letterSpacing": "-0.01em",
-          "lineHeight": "42px"
+          "lineHeight": "40px"
         }
       },
       {
         "path": "semantic.typography.h3",
         "cssVar": "--semantic-typography-h3",
         "type": "typography",
-        "description": "Component and card headers (h3). 20px / Satoshi bold 700 500 / leading-snug.",
+        "description": "Component and card headers (h3). 20px / Satoshi bold 700 500 / leading-snug (hds#283: rung renamed lg→xl, px unchanged).",
         "composite": {
           "fontFamily": "Satoshi, system-ui, -apple-system, BlinkMacSystemFont, \"Segoe UI\", sans-serif",
           "fontSize": "20px",
@@ -13680,13 +13612,13 @@
         "path": "semantic.typography.body",
         "cssVar": "--semantic-typography-body",
         "type": "typography",
-        "description": "Body prose. Satoshi medium, 17px, line-height 28px, max 60ch measure.",
+        "description": "Body prose. Satoshi medium, 16px, line-height 24px, max 60ch measure (hds#283: was 17px/28px).",
         "composite": {
           "fontFamily": "Satoshi, system-ui, -apple-system, BlinkMacSystemFont, \"Segoe UI\", sans-serif",
-          "fontSize": "17px",
+          "fontSize": "16px",
           "fontWeight": "500",
           "letterSpacing": "0em",
-          "lineHeight": "28px",
+          "lineHeight": "24px",
           "maxWidth": "60ch"
         }
       },
@@ -13694,13 +13626,13 @@
         "path": "semantic.typography.ui",
         "cssVar": "--semantic-typography-ui",
         "type": "typography",
-        "description": "UI text for nav, labels, captions. Satoshi medium, 15px, line-height 24px.",
+        "description": "UI text for nav, labels, captions. Satoshi medium, 14px, line-height 20px (hds#283: was 15px/24px).",
         "composite": {
           "fontFamily": "Satoshi, system-ui, -apple-system, BlinkMacSystemFont, \"Segoe UI\", sans-serif",
-          "fontSize": "15px",
+          "fontSize": "14px",
           "fontWeight": "500",
           "letterSpacing": "0em",
-          "lineHeight": "24px",
+          "lineHeight": "20px",
           "maxWidth": "60ch"
         }
       },
@@ -13708,7 +13640,7 @@
         "path": "semantic.typography.caption",
         "cssVar": "--semantic-typography-caption",
         "type": "typography",
-        "description": "Caption / helper text. Satoshi medium, 12px, line-height 16px. Matches the Figma typography/caption text style.",
+        "description": "Caption / helper text. Satoshi medium, 12px, line-height 16px. Matches the Figma typography/caption text style; now sourced from primitive.xs (hds#283).",
         "composite": {
           "fontFamily": "Satoshi, system-ui, -apple-system, BlinkMacSystemFont, \"Segoe UI\", sans-serif",
           "fontSize": "12px",
@@ -13721,13 +13653,13 @@
         "path": "semantic.typography.eyebrow",
         "cssVar": "--semantic-typography-eyebrow",
         "type": "typography",
-        "description": "Eyebrow / kicker label. Satoshi medium, 13px, caps tracking, uppercase.",
+        "description": "Eyebrow / kicker label. Satoshi medium, 12px, caps tracking, uppercase (hds#283: was 13px/20px).",
         "composite": {
           "fontFamily": "Satoshi, system-ui, -apple-system, BlinkMacSystemFont, \"Segoe UI\", sans-serif",
-          "fontSize": "13px",
+          "fontSize": "12px",
           "fontWeight": "500",
           "letterSpacing": "0.06em",
-          "lineHeight": "20px",
+          "lineHeight": "16px",
           "textTransform": "uppercase"
         }
       },
@@ -13735,10 +13667,10 @@
         "path": "semantic.typography.mono",
         "cssVar": "--semantic-typography-mono",
         "type": "typography",
-        "description": "Monospace for code, token names, shortcuts. Geist Mono regular, 13px.",
+        "description": "Monospace for code, token names, shortcuts. Geist Mono regular, 14px (hds#283: repointed xs→sm; xs alone would give 12px).",
         "composite": {
           "fontFamily": "\"Geist Mono\", \"Courier New\", monospace",
-          "fontSize": "13px",
+          "fontSize": "14px",
           "fontWeight": "400",
           "letterSpacing": "0em",
           "lineHeight": "20px",
@@ -13881,6 +13813,14 @@
         "alias": "{primitive.radius.8}",
         "resolvedValue": "8px"
       },
+      {
+        "path": "semantic.radius.control",
+        "cssVar": "--semantic-radius-control",
+        "type": "dimension",
+        "description": "Corner radius for small interactive control glyphs (e.g. checkbox glyph box) that are not fully round and not the standard action radius. Real design-scale value, distinct from semantic.radius.action (hds#242).",
+        "alias": "{primitive.radius.4}",
+        "resolvedValue": "4px"
+      },
       {
         "path": "semantic.borderWidth.default",
         "cssVar": "--semantic-borderWidth-default",
@@ -13985,6 +13925,94 @@
           },
           "border": null
         }
+      },
+      {
+        "path": "semantic.size.control.sm",
+        "cssVar": "--semantic-size-control-sm",
+        "type": "dimension",
+        "description": "Small control element — radio dot, slider fill bar height.",
+        "alias": "{primitive.size.8}",
+        "resolvedValue": "8px"
+      },
+      {
+        "path": "semantic.size.control.md",
+        "cssVar": "--semantic-size-control-md",
+        "type": "dimension",
+        "description": "Medium control element — checkbox glyph box, slider track wrapper height.",
+        "alias": "{primitive.size.20}",
+        "resolvedValue": "20px"
+      },
+      {
+        "path": "semantic.size.control.lg",
+        "cssVar": "--semantic-size-control-lg",
+        "type": "dimension",
+        "description": "Large control footprint — code-block inline-wrapper min-height / copy-button-matched pre padding.",
+        "alias": "{primitive.size.32}",
+        "resolvedValue": "32px"
+      },
+      {
+        "path": "semantic.size.icon.sm",
+        "cssVar": "--semantic-size-icon-sm",
+        "type": "dimension",
+        "description": "Small icon box — matches --hds-icon-small.",
+        "alias": "{primitive.size.16}",
+        "resolvedValue": "16px"
+      },
+      {
+        "path": "semantic.size.icon.md",
+        "cssVar": "--semantic-size-icon-md",
+        "type": "dimension",
+        "description": "Medium icon box — matches --hds-icon-medium.",
+        "alias": "{primitive.size.20}",
+        "resolvedValue": "20px"
+      },
+      {
+        "path": "semantic.size.icon.lg",
+        "cssVar": "--semantic-size-icon-lg",
+        "type": "dimension",
+        "description": "Large icon box — matches --hds-icon-large.",
+        "alias": "{primitive.size.24}",
+        "resolvedValue": "24px"
+      },
+      {
+        "path": "semantic.size.avatar",
+        "cssVar": "--semantic-size-avatar",
+        "type": "dimension",
+        "description": "Avatar diagonal (width/height) for activity-feed and similar identity glyphs. Coincides in pixels with row.compact today; kept as a separate role per hds#242 so either can change independently.",
+        "alias": "{primitive.size.40}",
+        "resolvedValue": "40px"
+      },
+      {
+        "path": "semantic.size.row.compact",
+        "cssVar": "--semantic-size-row-compact",
+        "type": "dimension",
+        "description": "Compact-density row minimum height.",
+        "alias": "{primitive.size.40}",
+        "resolvedValue": "40px"
+      },
+      {
+        "path": "semantic.size.row.comfortable",
+        "cssVar": "--semantic-size-row-comfortable",
+        "type": "dimension",
+        "description": "Comfortable-density row minimum height.",
+        "alias": "{primitive.size.48}",
+        "resolvedValue": "48px"
+      },
+      {
+        "path": "semantic.zIndex.control",
+        "cssVar": "--semantic-zIndex-control",
+        "type": "number",
+        "description": "Raises an interactive control (e.g. a native range input) above its visual decoration for hit-testing.",
+        "alias": "{primitive.zIndex.10}",
+        "resolvedValue": "10"
+      },
+      {
+        "path": "semantic.zIndex.sticky",
+        "cssVar": "--semantic-zIndex-sticky",
+        "type": "number",
+        "description": "Sticky-positioned elements, such as a table header row.",
+        "alias": "{primitive.zIndex.100}",
+        "resolvedValue": "100"
       }
     ],
     "component": [
@@ -14090,7 +14118,7 @@
         "type": "dimension",
         "description": "Tag type size.",
         "alias": "{primitive.typography.size.xs}",
-        "resolvedValue": "13px"
+        "resolvedValue": "12px"
       },
       {
         "path": "component.tag.fontWeight",
@@ -14178,7 +14206,7 @@
         "type": "dimension",
         "description": "Badge type size.",
         "alias": "{primitive.typography.size.xs}",
-        "resolvedValue": "13px"
+        "resolvedValue": "12px"
       },
       {
         "path": "component.badge.fontWeight",
@@ -14316,9 +14344,9 @@
         "path": "component.button.size.sm.fontSize",
         "cssVar": "--component-button-size-sm-fontSize",
         "type": "dimension",
-        "description": "Small button label size (13px).",
+        "description": "Small button label size (12px, hds#283: was 13px).",
         "alias": "{primitive.typography.size.xs}",
-        "resolvedValue": "13px"
+        "resolvedValue": "12px"
       },
       {
         "path": "component.button.size.sm.iconSize",
@@ -14364,9 +14392,9 @@
         "path": "component.button.size.md.fontSize",
         "cssVar": "--component-button-size-md-fontSize",
         "type": "dimension",
-        "description": "Medium button label size (15px).",
+        "description": "Medium button label size (14px, hds#283: was 15px).",
         "alias": "{primitive.typography.size.sm}",
-        "resolvedValue": "15px"
+        "resolvedValue": "14px"
       },
       {
         "path": "component.button.size.md.iconSize",
@@ -14412,9 +14440,9 @@
         "path": "component.button.size.lg.fontSize",
         "cssVar": "--component-button-size-lg-fontSize",
         "type": "dimension",
-        "description": "Large button label size (17px).",
+        "description": "Large button label size (16px, hds#283: was 17px).",
         "alias": "{primitive.typography.size.base}",
-        "resolvedValue": "17px"
+        "resolvedValue": "16px"
       },
       {
         "path": "component.button.size.lg.iconSize",