@hirobius/design-system 0.15.0 → 0.17.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (96) hide show
  1. package/README.md +26 -70
  2. package/dist/chunks/LanguageContext-CH_bwzCq.js +83 -0
  3. package/dist/chunks/TokenDisplayContext-evZi_214.js +18 -0
  4. package/dist/chunks/activity-feed-C8_e-Btq.js +19955 -0
  5. package/dist/contexts.js +17 -16
  6. package/dist/hirobius-ui.js +3590 -21800
  7. package/dist/manifest.js +11 -11
  8. package/dist/patterns.js +423 -0
  9. package/dist/static.css +4 -4
  10. package/dist/styles.css +1 -1
  11. package/dist/tokens.css +1 -1
  12. package/dist/tokens.js +74 -35
  13. package/dist/types/src/app/components/activity-feed.d.ts +6 -4
  14. package/dist/types/src/app/components/app-shell.d.ts +6 -4
  15. package/dist/types/src/app/components/asset-img.d.ts +3 -1
  16. package/dist/types/src/app/components/avatar-group.d.ts +3 -3
  17. package/dist/types/src/app/components/avatar.d.ts +3 -3
  18. package/dist/types/src/app/components/badge.d.ts +3 -3
  19. package/dist/types/src/app/components/blockquote.d.ts +3 -3
  20. package/dist/types/src/app/components/breadcrumb.d.ts +3 -3
  21. package/dist/types/src/app/components/button-group.d.ts +3 -3
  22. package/dist/types/src/app/components/button.d.ts +6 -6
  23. package/dist/types/src/app/components/calendar.d.ts +3 -1
  24. package/dist/types/src/app/components/callout.d.ts +4 -4
  25. package/dist/types/src/app/components/card.d.ts +5 -5
  26. package/dist/types/src/app/components/carousel.d.ts +6 -4
  27. package/dist/types/src/app/components/checkbox.d.ts +3 -3
  28. package/dist/types/src/app/components/cinematic-link.d.ts +7 -1
  29. package/dist/types/src/app/components/circular-progress.d.ts +3 -3
  30. package/dist/types/src/app/components/code-block.d.ts +20 -18
  31. package/dist/types/src/app/components/command-palette.d.ts +9 -9
  32. package/dist/types/src/app/components/component-instance-matrix.d.ts +8 -2
  33. package/dist/types/src/app/components/disclosure.d.ts +3 -3
  34. package/dist/types/src/app/components/divider.d.ts +4 -4
  35. package/dist/types/src/app/components/doc-link-card.d.ts +6 -4
  36. package/dist/types/src/app/components/error-pattern.d.ts +3 -1
  37. package/dist/types/src/app/components/field.d.ts +4 -4
  38. package/dist/types/src/app/components/file-input.d.ts +7 -5
  39. package/dist/types/src/app/components/foundation-swatch.d.ts +6 -0
  40. package/dist/types/src/app/components/hds-tooltip.d.ts +11 -11
  41. package/dist/types/src/app/components/heading-stack.d.ts +6 -6
  42. package/dist/types/src/app/components/hover-card.d.ts +1 -1
  43. package/dist/types/src/app/components/image-lightbox.d.ts +2 -0
  44. package/dist/types/src/app/components/inline-code.d.ts +3 -3
  45. package/dist/types/src/app/components/input-group.d.ts +3 -3
  46. package/dist/types/src/app/components/input.d.ts +5 -5
  47. package/dist/types/src/app/components/kbd.d.ts +3 -3
  48. package/dist/types/src/app/components/metadata-list.d.ts +3 -3
  49. package/dist/types/src/app/components/nav-group.d.ts +3 -3
  50. package/dist/types/src/app/components/nav-item.d.ts +10 -8
  51. package/dist/types/src/app/components/overflow-list.d.ts +3 -1
  52. package/dist/types/src/app/components/page.d.ts +3 -1
  53. package/dist/types/src/app/components/progress.d.ts +3 -3
  54. package/dist/types/src/app/components/radio.d.ts +3 -3
  55. package/dist/types/src/app/components/reveal.d.ts +3 -1
  56. package/dist/types/src/app/components/segmented-control.d.ts +31 -31
  57. package/dist/types/src/app/components/select.d.ts +29 -0
  58. package/dist/types/src/app/components/selectable-card.d.ts +3 -3
  59. package/dist/types/src/app/components/side-nav.d.ts +6 -4
  60. package/dist/types/src/app/components/skeleton.d.ts +3 -3
  61. package/dist/types/src/app/components/sketch.d.ts +6 -0
  62. package/dist/types/src/app/components/slider.d.ts +3 -3
  63. package/dist/types/src/app/components/spinner.d.ts +3 -3
  64. package/dist/types/src/app/components/stacked-card-rail.d.ts +32 -0
  65. package/dist/types/src/app/components/stat.d.ts +3 -3
  66. package/dist/types/src/app/components/status-dot.d.ts +4 -4
  67. package/dist/types/src/app/components/status-list-item.d.ts +3 -3
  68. package/dist/types/src/app/components/stepper.d.ts +6 -4
  69. package/dist/types/src/app/components/surface.d.ts +4 -4
  70. package/dist/types/src/app/components/table.d.ts +22 -11
  71. package/dist/types/src/app/components/tag.d.ts +4 -4
  72. package/dist/types/src/app/components/text.d.ts +3 -3
  73. package/dist/types/src/app/components/textarea.d.ts +4 -4
  74. package/dist/types/src/app/components/time-input.d.ts +3 -3
  75. package/dist/types/src/app/components/toast.d.ts +3 -3
  76. package/dist/types/src/app/components/toggle-button.d.ts +4 -4
  77. package/dist/types/src/app/components/toggle.d.ts +3 -3
  78. package/dist/types/src/app/components/token.d.ts +23 -17
  79. package/dist/types/src/app/components/toolbar.d.ts +1 -1
  80. package/dist/types/src/app/components/tooltip.d.ts +2 -2
  81. package/dist/types/src/app/components/top-nav.d.ts +3 -1
  82. package/dist/types/src/app/components/tree-list.d.ts +3 -1
  83. package/dist/types/src/app/design-system/generated-token-refs.d.ts +39 -6
  84. package/dist/types/src/app/design-system/generated-token-values.d.ts +12 -16
  85. package/dist/types/src/app/design-system/tokens.d.ts +16 -5
  86. package/dist/types/src/app/layouts/DocLayout.d.ts +0 -2
  87. package/dist/types/src/app/layouts/HdsDocsShell.d.ts +72 -0
  88. package/dist/types/src/app/layouts/HdsSystemDocLayout.d.ts +8 -1
  89. package/dist/types/src/index.d.ts +216 -39
  90. package/dist/types/src/patterns.d.ts +37 -0
  91. package/dist/variables.css +100 -28
  92. package/hirobius.tokens.json +199 -88
  93. package/package.json +43 -28
  94. package/public/hds-manifest.json +1916 -601
  95. package/dist/chunks/TokenDisplayContext-B3gxyQN7.js +0 -96
  96. /package/dist/types/src/app/components/{lab/tokenUtils.d.ts → tokenUtils.d.ts} +0 -0
@@ -2,7 +2,7 @@
2
2
  "name": "Hirobius Design System",
3
3
  "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.",
4
4
  "version": "1",
5
- "generated": "2026-09-23T02:51:22.454Z",
5
+ "generated": "2026-09-28T00:14:31.544Z",
6
6
  "source": "hirobius.tokens.json",
7
7
  "format": "W3C DTCG 2025.10",
8
8
  "docs": "https://adrianmilsap.com/hds",
@@ -64,6 +64,7 @@
64
64
  "CardTitle",
65
65
  "Carousel",
66
66
  "Center",
67
+ "Checkbox",
67
68
  "CinematicLink",
68
69
  "CircularProgress",
69
70
  "Cluster",
@@ -99,13 +100,8 @@
99
100
  "FoundationSwatch",
100
101
  "Frame",
101
102
  "Grid",
102
- "HdsCheckbox",
103
- "HdsRadio",
104
- "HdsSelect",
105
- "HdsSlider",
103
+ "HdsDocsShell",
106
104
  "HdsThemeProvider",
107
- "HdsToggle",
108
- "HdsTooltip",
109
105
  "HeadingStack",
110
106
  "HoverCard",
111
107
  "Icon",
@@ -127,14 +123,16 @@
127
123
  "Pin",
128
124
  "Popover",
129
125
  "Progress",
126
+ "Radio",
130
127
  "Reveal",
131
128
  "SegmentedControl",
129
+ "Select",
132
130
  "SelectableCard",
133
131
  "Sidebar",
134
132
  "SideNav",
135
133
  "Skeleton",
136
134
  "Sketch",
137
- "SpecimenBlock",
135
+ "Slider",
138
136
  "Spinner",
139
137
  "Stack",
140
138
  "StackedCardRail",
@@ -159,10 +157,12 @@
159
157
  "TimeInput",
160
158
  "Timestamp",
161
159
  "ToastProvider",
160
+ "Toggle",
162
161
  "ToggleButton",
163
162
  "Token",
164
163
  "Tokenizer",
165
164
  "Toolbar",
165
+ "Tooltip",
166
166
  "TopNav",
167
167
  "TreeList",
168
168
  "VisuallyHidden"
@@ -576,63 +576,10 @@
576
576
  "uncategorized": [
577
577
  {
578
578
  "name": "HdsLegacyTokenGovernancePanel",
579
- "filePath": "src/app/components/lab/legacy-token-detail.tsx"
579
+ "filePath": "src/docs-tooling/lab/legacy-token-detail.tsx"
580
580
  }
581
581
  ],
582
- "namespaceViolations": [
583
- {
584
- "name": "HdsCheckbox",
585
- "filePath": "src/app/components/checkbox.tsx"
586
- },
587
- {
588
- "name": "HdsLegacyTokenGovernancePanel",
589
- "filePath": "src/app/components/lab/legacy-token-detail.tsx"
590
- },
591
- {
592
- "name": "HdsMobileTopBar",
593
- "filePath": "src/app/components/shell-controls.tsx"
594
- },
595
- {
596
- "name": "HdsRadio",
597
- "filePath": "src/app/components/controls.tsx"
598
- },
599
- {
600
- "name": "HdsRadio",
601
- "filePath": "src/app/components/radio.tsx"
602
- },
603
- {
604
- "name": "HdsSelect",
605
- "filePath": "src/app/components/controls.tsx"
606
- },
607
- {
608
- "name": "HdsSelect",
609
- "filePath": "src/app/components/select.tsx"
610
- },
611
- {
612
- "name": "HdsSidebarUtilityButton",
613
- "filePath": "src/app/components/shell-controls.tsx"
614
- },
615
- {
616
- "name": "HdsSlider",
617
- "filePath": "src/app/components/controls.tsx"
618
- },
619
- {
620
- "name": "HdsSlider",
621
- "filePath": "src/app/components/slider.tsx"
622
- },
623
- {
624
- "name": "HdsToggle",
625
- "filePath": "src/app/components/controls.tsx"
626
- },
627
- {
628
- "name": "HdsToggle",
629
- "filePath": "src/app/components/toggle.tsx"
630
- },
631
- {
632
- "name": "HdsTooltip",
633
- "filePath": "src/app/components/hds-tooltip.tsx"
634
- }
635
- ]
582
+ "namespaceViolations": []
636
583
  },
637
584
  "agentEntrypoint": "CLAUDE.md",
638
585
  "breakingChangePolicy": "Version increments on any prop rename, token path rename, or removed component. Additions are non-breaking.",
@@ -726,7 +673,9 @@
726
673
  ],
727
674
  "tier": "template",
728
675
  "docExempt": false,
729
- "figmaLink": null
676
+ "figmaLink": null,
677
+ "storyFiles": [],
678
+ "storyIds": []
730
679
  },
731
680
  "Alert": {
732
681
  "category": "Feedback",
@@ -742,7 +691,6 @@
742
691
  "sizing": "panel"
743
692
  },
744
693
  "consumers": [
745
- "src/app/components/componentPreviewRegistry.tsx",
746
694
  "src/app/data/hdsEditorial.tsx",
747
695
  "src/stories/alert.stories.tsx",
748
696
  "src/stories/static-primitives.stories.tsx"
@@ -853,7 +801,18 @@
853
801
  "info"
854
802
  ]
855
803
  }
856
- }
804
+ },
805
+ "storyFiles": [
806
+ "src/stories/alert.stories.tsx"
807
+ ],
808
+ "storyIds": [
809
+ "primitives-alert--all-variants",
810
+ "primitives-alert--error",
811
+ "primitives-alert--info",
812
+ "primitives-alert--success",
813
+ "primitives-alert--warning",
814
+ "primitives-alert--with-title"
815
+ ]
857
816
  },
858
817
  "CinematicLink": {
859
818
  "category": "Branding",
@@ -870,7 +829,6 @@
870
829
  },
871
830
  "consumers": [
872
831
  "src/app/components/animated-label.tsx",
873
- "src/app/components/componentPreviewRegistry.tsx",
874
832
  "src/stories/cinematic-link.stories.tsx"
875
833
  ],
876
834
  "tokenMapping": {},
@@ -893,7 +851,16 @@
893
851
  "tier": "primitive",
894
852
  "docExempt": false,
895
853
  "sourcePath": "src/app/components/CinematicLink.tsx",
896
- "figmaLink": null
854
+ "figmaLink": null,
855
+ "storyFiles": [
856
+ "src/stories/cinematic-link.stories.tsx"
857
+ ],
858
+ "storyIds": [
859
+ "primitives-cinematic-link--default",
860
+ "primitives-cinematic-link--external-href",
861
+ "primitives-cinematic-link--long-label",
862
+ "primitives-cinematic-link--short-label"
863
+ ]
897
864
  },
898
865
  "CodeBlock": {
899
866
  "category": "Display",
@@ -909,8 +876,8 @@
909
876
  "sizing": "panel"
910
877
  },
911
878
  "consumers": [
912
- "src/app/components/componentPreviewRegistry.tsx",
913
- "src/app/components/lab/legacy-token-detail.tsx",
879
+ "src/docs-tooling/lab/legacy-token-detail.tsx",
880
+ "src/index.ts",
914
881
  "src/stories/code-block.stories.tsx"
915
882
  ],
916
883
  "tokenMapping": {
@@ -961,7 +928,17 @@
961
928
  "tier": "primitive",
962
929
  "docExempt": false,
963
930
  "sourcePath": "src/app/components/CodeBlock.tsx",
964
- "figmaLink": "https://www.figma.com/design/c8MaVgwxOlxm4wr8wnH0Z4/HDS-Tokens-Components?node-id=89-154"
931
+ "figmaLink": "https://www.figma.com/design/c8MaVgwxOlxm4wr8wnH0Z4/HDS-Tokens-Components?node-id=89-154",
932
+ "storyFiles": [
933
+ "src/stories/code-block.stories.tsx"
934
+ ],
935
+ "storyIds": [
936
+ "primitives-code-block--collapsible",
937
+ "primitives-code-block--css-highlighting",
938
+ "primitives-code-block--default",
939
+ "primitives-code-block--inline",
940
+ "primitives-code-block--json-highlighting"
941
+ ]
965
942
  },
966
943
  "Container": {
967
944
  "category": "Layout",
@@ -1026,7 +1003,14 @@
1026
1003
  "tier": "primitive",
1027
1004
  "docExempt": false,
1028
1005
  "sourcePath": "src/app/components/Container.tsx",
1029
- "figmaLink": null
1006
+ "figmaLink": null,
1007
+ "storyFiles": [
1008
+ "src/stories/container.stories.tsx"
1009
+ ],
1010
+ "storyIds": [
1011
+ "primitives-container--content-width",
1012
+ "primitives-container--max-width"
1013
+ ]
1030
1014
  },
1031
1015
  "Disclosure": {
1032
1016
  "category": "Layout",
@@ -1042,8 +1026,8 @@
1042
1026
  "sizing": "panel"
1043
1027
  },
1044
1028
  "consumers": [
1045
- "src/app/components/componentPreviewRegistry.tsx",
1046
1029
  "src/app/components/nav-group.tsx",
1030
+ "src/app/layouts/HdsDocsShell.tsx",
1047
1031
  "src/stories/disclosure.stories.tsx",
1048
1032
  "src/stories/nav-group.stories.tsx"
1049
1033
  ],
@@ -1141,7 +1125,16 @@
1141
1125
  }
1142
1126
  ],
1143
1127
  "sourcePath": "src/app/components/Disclosure.tsx",
1144
- "figmaLink": "https://www.figma.com/design/c8MaVgwxOlxm4wr8wnH0Z4/HDS-Tokens-Components?node-id=88-453"
1128
+ "figmaLink": "https://www.figma.com/design/c8MaVgwxOlxm4wr8wnH0Z4/HDS-Tokens-Components?node-id=88-453",
1129
+ "storyFiles": [
1130
+ "src/stories/disclosure.stories.tsx"
1131
+ ],
1132
+ "storyIds": [
1133
+ "primitives-disclosure--controlled",
1134
+ "primitives-disclosure--multiple-items",
1135
+ "primitives-disclosure--open-by-default",
1136
+ "primitives-disclosure--panel"
1137
+ ]
1145
1138
  },
1146
1139
  "Divider": {
1147
1140
  "category": "Layout",
@@ -1157,7 +1150,6 @@
1157
1150
  "sizing": "panel"
1158
1151
  },
1159
1152
  "consumers": [
1160
- "src/app/components/componentPreviewRegistry.tsx",
1161
1153
  "src/app/components/metadata-list.tsx",
1162
1154
  "src/app/data/hdsEditorial.tsx",
1163
1155
  "src/stories/divider.stories.tsx",
@@ -1236,7 +1228,18 @@
1236
1228
  "default"
1237
1229
  ]
1238
1230
  }
1239
- }
1231
+ },
1232
+ "storyFiles": [
1233
+ "src/stories/divider.stories.tsx"
1234
+ ],
1235
+ "storyIds": [
1236
+ "primitives-divider--between-sections",
1237
+ "primitives-divider--horizontal",
1238
+ "primitives-divider--horizontal-strong",
1239
+ "primitives-divider--legacy-strong-prop",
1240
+ "primitives-divider--vertical",
1241
+ "primitives-divider--with-spacing"
1242
+ ]
1240
1243
  },
1241
1244
  "DocLinkCard": {
1242
1245
  "category": "Navigation",
@@ -1279,13 +1282,23 @@
1279
1282
  "figmaId": null,
1280
1283
  "figmaLink": null,
1281
1284
  "consumers": [
1282
- "src/app/components/componentPreviewRegistry.tsx",
1283
1285
  "src/app/components/doc-link-card.test.tsx",
1284
1286
  "src/app/data/hdsEditorial.tsx",
1287
+ "src/index.ts",
1285
1288
  "src/stories/doc-link-card.stories.tsx"
1286
1289
  ],
1287
1290
  "variantAxes": [],
1288
- "componentProperties": []
1291
+ "componentProperties": [],
1292
+ "storyFiles": [
1293
+ "src/stories/doc-link-card.stories.tsx"
1294
+ ],
1295
+ "storyIds": [
1296
+ "primitives-doc-link-card--accent",
1297
+ "primitives-doc-link-card--default",
1298
+ "primitives-doc-link-card--disabled",
1299
+ "primitives-doc-link-card--pager-back",
1300
+ "primitives-doc-link-card--pager-forward"
1301
+ ]
1289
1302
  },
1290
1303
  "ErrorPattern": {
1291
1304
  "category": "Feedback",
@@ -1302,6 +1315,7 @@
1302
1315
  },
1303
1316
  "consumers": [
1304
1317
  "src/app/components/not-found-pattern.tsx",
1318
+ "src/index.ts",
1305
1319
  "src/stories/error-pattern.stories.tsx",
1306
1320
  "src/stories/not-found-pattern.stories.tsx"
1307
1321
  ],
@@ -1372,7 +1386,16 @@
1372
1386
  ],
1373
1387
  "tier": "template",
1374
1388
  "docExempt": false,
1375
- "figmaLink": null
1389
+ "figmaLink": null,
1390
+ "storyFiles": [
1391
+ "src/stories/error-pattern.stories.tsx"
1392
+ ],
1393
+ "storyIds": [
1394
+ "feedback-error-pattern--default",
1395
+ "feedback-error-pattern--not-found",
1396
+ "feedback-error-pattern--server-error",
1397
+ "feedback-error-pattern--unauthorized"
1398
+ ]
1376
1399
  },
1377
1400
  "FoundationSwatch": {
1378
1401
  "category": "Utilities",
@@ -1388,7 +1411,6 @@
1388
1411
  "sizing": "full"
1389
1412
  },
1390
1413
  "consumers": [
1391
- "src/app/components/componentPreviewRegistry.tsx",
1392
1414
  "src/stories/foundation-swatch.stories.tsx"
1393
1415
  ],
1394
1416
  "tokenMapping": {},
@@ -1493,7 +1515,17 @@
1493
1515
  }
1494
1516
  ],
1495
1517
  "sourcePath": "src/app/components/FoundationSwatch.tsx",
1496
- "figmaLink": null
1518
+ "figmaLink": null,
1519
+ "storyFiles": [
1520
+ "src/stories/foundation-swatch.stories.tsx"
1521
+ ],
1522
+ "storyIds": [
1523
+ "primitives-foundation-swatch--color-grid",
1524
+ "primitives-foundation-swatch--default",
1525
+ "primitives-foundation-swatch--feedback-palette",
1526
+ "primitives-foundation-swatch--with-details",
1527
+ "primitives-foundation-swatch--with-specimen"
1528
+ ]
1497
1529
  },
1498
1530
  "Grid": {
1499
1531
  "category": "Layout",
@@ -1511,15 +1543,15 @@
1511
1543
  "consumers": [
1512
1544
  "src/app/components/box.tsx",
1513
1545
  "src/app/components/cluster.tsx",
1514
- "src/app/components/componentPreviewRegistry.tsx",
1515
1546
  "src/app/components/foundation-swatch.tsx",
1516
1547
  "src/app/components/image-lightbox.tsx",
1517
1548
  "src/app/components/segmented-control.test.tsx",
1518
- "src/app/components/shell-controls.tsx",
1519
1549
  "src/app/components/sidebar.tsx",
1520
- "src/app/components/sketch-controls.tsx",
1521
1550
  "src/app/components/stack.tsx",
1551
+ "src/app/components/table.tsx",
1522
1552
  "src/app/components/tooltip.tsx",
1553
+ "src/docs-tooling/shell-controls.tsx",
1554
+ "src/docs-tooling/sketch-controls.tsx",
1523
1555
  "src/stories/box.stories.tsx",
1524
1556
  "src/stories/foundation-swatch.stories.tsx",
1525
1557
  "src/stories/grid.stories.tsx",
@@ -1617,7 +1649,16 @@
1617
1649
  "tier": "primitive",
1618
1650
  "docExempt": false,
1619
1651
  "sourcePath": "src/app/components/Grid.tsx",
1620
- "figmaLink": null
1652
+ "figmaLink": null,
1653
+ "storyFiles": [
1654
+ "src/stories/grid.stories.tsx"
1655
+ ],
1656
+ "storyIds": [
1657
+ "primitives-grid--aside-layout",
1658
+ "primitives-grid--auto-fit",
1659
+ "primitives-grid--three-column",
1660
+ "primitives-grid--two-column"
1661
+ ]
1621
1662
  },
1622
1663
  "Icon": {
1623
1664
  "category": "Display",
@@ -1640,7 +1681,6 @@
1640
1681
  "src/app/components/checkbox.tsx",
1641
1682
  "src/app/components/code-block.tsx",
1642
1683
  "src/app/components/combobox.tsx",
1643
- "src/app/components/componentPreviewRegistry.tsx",
1644
1684
  "src/app/components/context-menu.tsx",
1645
1685
  "src/app/components/disclosure.tsx",
1646
1686
  "src/app/components/doc-link-card.tsx",
@@ -1648,17 +1688,18 @@
1648
1688
  "src/app/components/icon-button.tsx",
1649
1689
  "src/app/components/image-lightbox.tsx",
1650
1690
  "src/app/components/inline-link.tsx",
1651
- "src/app/components/lab/legacy-token-detail.tsx",
1652
- "src/app/components/lab/tokenUtils.ts",
1653
1691
  "src/app/components/menu.tsx",
1654
1692
  "src/app/components/multi-selector.tsx",
1655
1693
  "src/app/components/select.tsx",
1656
- "src/app/components/shell-controls.tsx",
1694
+ "src/app/components/table.tsx",
1657
1695
  "src/app/components/text-lockup.tsx",
1658
- "src/app/components/theme-toggle.tsx",
1659
1696
  "src/app/components/toast.tsx",
1660
1697
  "src/app/components/tokenTableUtils.ts",
1698
+ "src/app/components/tokenUtils.ts",
1661
1699
  "src/app/data/hdsEditorial.tsx",
1700
+ "src/docs-tooling/lab/legacy-token-detail.tsx",
1701
+ "src/docs-tooling/shell-controls.tsx",
1702
+ "src/docs-tooling/theme-toggle.tsx",
1662
1703
  "src/stories/activity-feed.stories.tsx",
1663
1704
  "src/stories/icon-button.stories.tsx",
1664
1705
  "src/stories/icon.stories.tsx",
@@ -1771,7 +1812,18 @@
1771
1812
  "tier": "primitive",
1772
1813
  "docExempt": false,
1773
1814
  "sourcePath": "src/app/components/Icon.tsx",
1774
- "figmaLink": null
1815
+ "figmaLink": null,
1816
+ "storyFiles": [
1817
+ "src/stories/icon.stories.tsx"
1818
+ ],
1819
+ "storyIds": [
1820
+ "primitives-icon--default",
1821
+ "primitives-icon--large",
1822
+ "primitives-icon--medium",
1823
+ "primitives-icon--semantic-color",
1824
+ "primitives-icon--semantic-colors",
1825
+ "primitives-icon--size-gallery"
1826
+ ]
1775
1827
  },
1776
1828
  "IconButton": {
1777
1829
  "category": "Actions",
@@ -1787,14 +1839,13 @@
1787
1839
  "sizing": "panel"
1788
1840
  },
1789
1841
  "consumers": [
1790
- "src/app/components/componentPreviewRegistry.tsx",
1791
1842
  "src/app/components/hds-tooltip.tsx",
1792
1843
  "src/app/components/inline-code.tsx",
1793
- "src/app/components/page-footer.tsx",
1794
1844
  "src/app/components/pagination.tsx",
1795
- "src/app/components/shell-controls.tsx",
1796
1845
  "src/app/components/stepper-field.tsx",
1797
1846
  "src/app/data/hdsEditorial.tsx",
1847
+ "src/docs-tooling/page-footer.tsx",
1848
+ "src/docs-tooling/shell-controls.tsx",
1798
1849
  "src/stories/icon-button.stories.tsx"
1799
1850
  ],
1800
1851
  "tokenMapping": {
@@ -1901,7 +1952,17 @@
1901
1952
  }
1902
1953
  ],
1903
1954
  "sourcePath": "src/app/components/IconButton.tsx",
1904
- "figmaLink": "https://www.figma.com/design/c8MaVgwxOlxm4wr8wnH0Z4/HDS-Tokens-Components?node-id=40-39"
1955
+ "figmaLink": "https://www.figma.com/design/c8MaVgwxOlxm4wr8wnH0Z4/HDS-Tokens-Components?node-id=40-39",
1956
+ "storyFiles": [
1957
+ "src/stories/icon-button.stories.tsx"
1958
+ ],
1959
+ "storyIds": [
1960
+ "primitives-icon-button--default",
1961
+ "primitives-icon-button--disabled",
1962
+ "primitives-icon-button--primary",
1963
+ "primitives-icon-button--size-gallery",
1964
+ "primitives-icon-button--tertiary"
1965
+ ]
1905
1966
  },
1906
1967
  "InlineCode": {
1907
1968
  "category": "Display",
@@ -1917,7 +1978,6 @@
1917
1978
  "sizing": "panel"
1918
1979
  },
1919
1980
  "consumers": [
1920
- "src/app/components/componentPreviewRegistry.tsx",
1921
1981
  "src/app/components/metadata-list.tsx",
1922
1982
  "src/app/data/hdsEditorial.tsx",
1923
1983
  "src/stories/inline-code.stories.tsx",
@@ -1956,7 +2016,19 @@
1956
2016
  "tier": "primitive",
1957
2017
  "docExempt": false,
1958
2018
  "sourcePath": "src/app/components/InlineCode.tsx",
1959
- "figmaLink": "https://www.figma.com/design/c8MaVgwxOlxm4wr8wnH0Z4/HDS-Tokens-Components?node-id=89-155"
2019
+ "figmaLink": "https://www.figma.com/design/c8MaVgwxOlxm4wr8wnH0Z4/HDS-Tokens-Components?node-id=89-155",
2020
+ "storyFiles": [
2021
+ "src/stories/inline-code.stories.tsx"
2022
+ ],
2023
+ "storyIds": [
2024
+ "primitives-inline-code--comfortable",
2025
+ "primitives-inline-code--compact",
2026
+ "primitives-inline-code--compact-deprecated-alias",
2027
+ "primitives-inline-code--copyable",
2028
+ "primitives-inline-code--copyable-in-prose",
2029
+ "primitives-inline-code--default",
2030
+ "primitives-inline-code--in-prose"
2031
+ ]
1960
2032
  },
1961
2033
  "InlineLink": {
1962
2034
  "category": "Navigation",
@@ -1972,10 +2044,9 @@
1972
2044
  "sizing": "panel"
1973
2045
  },
1974
2046
  "consumers": [
1975
- "src/app/components/componentPreviewRegistry.tsx",
1976
2047
  "src/app/components/hover-card.tsx",
1977
2048
  "src/app/components/image-lightbox.tsx",
1978
- "src/app/components/lab/legacy-token-detail.tsx",
2049
+ "src/docs-tooling/lab/legacy-token-detail.tsx",
1979
2050
  "src/stories/inline-link.stories.tsx"
1980
2051
  ],
1981
2052
  "tokenMapping": {
@@ -2015,7 +2086,16 @@
2015
2086
  "tier": "primitive",
2016
2087
  "docExempt": false,
2017
2088
  "sourcePath": "src/app/components/InlineLink.tsx",
2018
- "figmaLink": "https://www.figma.com/design/c8MaVgwxOlxm4wr8wnH0Z4/HDS-Tokens-Components?node-id=89-161"
2089
+ "figmaLink": "https://www.figma.com/design/c8MaVgwxOlxm4wr8wnH0Z4/HDS-Tokens-Components?node-id=89-161",
2090
+ "storyFiles": [
2091
+ "src/stories/inline-link.stories.tsx"
2092
+ ],
2093
+ "storyIds": [
2094
+ "primitives-inline-link--default",
2095
+ "primitives-inline-link--external-no-icon",
2096
+ "primitives-inline-link--in-body-copy",
2097
+ "primitives-inline-link--internal-route"
2098
+ ]
2019
2099
  },
2020
2100
  "Input": {
2021
2101
  "category": "Inputs",
@@ -2031,7 +2111,6 @@
2031
2111
  "sizing": "panel"
2032
2112
  },
2033
2113
  "consumers": [
2034
- "src/app/components/componentPreviewRegistry.tsx",
2035
2114
  "src/app/components/form.tsx",
2036
2115
  "src/app/components/segmented-control.tsx",
2037
2116
  "src/app/components/stepper-field.tsx",
@@ -2258,7 +2337,19 @@
2258
2337
  ],
2259
2338
  "tier": "primitive",
2260
2339
  "docExempt": false,
2261
- "figmaLink": "https://www.figma.com/design/c8MaVgwxOlxm4wr8wnH0Z4/HDS-Tokens-Components?node-id=38-20"
2340
+ "figmaLink": "https://www.figma.com/design/c8MaVgwxOlxm4wr8wnH0Z4/HDS-Tokens-Components?node-id=38-20",
2341
+ "storyFiles": [
2342
+ "src/stories/input.stories.tsx"
2343
+ ],
2344
+ "storyIds": [
2345
+ "primitives-input--default",
2346
+ "primitives-input--disabled",
2347
+ "primitives-input--loading",
2348
+ "primitives-input--mono",
2349
+ "primitives-input--size-variants",
2350
+ "primitives-input--with-error",
2351
+ "primitives-input--with-helper"
2352
+ ]
2262
2353
  },
2263
2354
  "NavGroup": {
2264
2355
  "category": "Navigation",
@@ -2274,7 +2365,6 @@
2274
2365
  "sizing": "panel"
2275
2366
  },
2276
2367
  "consumers": [
2277
- "src/app/components/componentPreviewRegistry.tsx",
2278
2368
  "src/app/lib/nav-active.ts",
2279
2369
  "src/stories/nav-group.stories.tsx"
2280
2370
  ],
@@ -2366,7 +2456,17 @@
2366
2456
  }
2367
2457
  ],
2368
2458
  "sourcePath": "src/app/components/NavGroup.tsx",
2369
- "figmaLink": "https://www.figma.com/design/c8MaVgwxOlxm4wr8wnH0Z4/HDS-Tokens-Components?node-id=86-304"
2459
+ "figmaLink": "https://www.figma.com/design/c8MaVgwxOlxm4wr8wnH0Z4/HDS-Tokens-Components?node-id=86-304",
2460
+ "storyFiles": [
2461
+ "src/stories/nav-group.stories.tsx"
2462
+ ],
2463
+ "storyIds": [
2464
+ "primitives-nav-group--collapsible",
2465
+ "primitives-nav-group--default",
2466
+ "primitives-nav-group--no-label",
2467
+ "primitives-nav-group--toc-variant",
2468
+ "primitives-nav-group--with-disabled-item"
2469
+ ]
2370
2470
  },
2371
2471
  "NavItem": {
2372
2472
  "category": "Navigation",
@@ -2382,11 +2482,12 @@
2382
2482
  "sizing": "panel"
2383
2483
  },
2384
2484
  "consumers": [
2385
- "src/app/components/componentPreviewRegistry.tsx",
2386
2485
  "src/app/components/nav-group.tsx",
2387
2486
  "src/app/context/DemoStateContext.tsx",
2388
2487
  "src/app/data/hds-nav-data.ts",
2389
2488
  "src/app/hooks/useInteractionState.ts",
2489
+ "src/app/layouts/HdsDocsShell.tsx",
2490
+ "src/index.ts",
2390
2491
  "src/stories/nav-group.stories.tsx",
2391
2492
  "src/stories/nav-item.stories.tsx"
2392
2493
  ],
@@ -2440,7 +2541,19 @@
2440
2541
  "tier": "primitive",
2441
2542
  "docExempt": false,
2442
2543
  "sourcePath": "src/app/components/NavItem.tsx",
2443
- "figmaLink": "https://www.figma.com/design/c8MaVgwxOlxm4wr8wnH0Z4/HDS-Tokens-Components?node-id=86-258"
2544
+ "figmaLink": "https://www.figma.com/design/c8MaVgwxOlxm4wr8wnH0Z4/HDS-Tokens-Components?node-id=86-258",
2545
+ "storyFiles": [
2546
+ "src/stories/nav-item.stories.tsx"
2547
+ ],
2548
+ "storyIds": [
2549
+ "primitives-nav-item--active",
2550
+ "primitives-nav-item--button-mode",
2551
+ "primitives-nav-item--default",
2552
+ "primitives-nav-item--disabled",
2553
+ "primitives-nav-item--nested-level",
2554
+ "primitives-nav-item--toc-active",
2555
+ "primitives-nav-item--toc-variant"
2556
+ ]
2444
2557
  },
2445
2558
  "SegmentedControl": {
2446
2559
  "category": "Inputs",
@@ -2456,11 +2569,10 @@
2456
2569
  "sizing": "panel"
2457
2570
  },
2458
2571
  "consumers": [
2459
- "src/app/components/componentPreviewRegistry.tsx",
2460
2572
  "src/app/components/segmented-control.test.tsx",
2461
- "src/app/components/TokenDisplayToggle.tsx",
2462
2573
  "src/app/data/hdsEditorial.tsx",
2463
2574
  "src/app/hooks/useInteractionState.ts",
2575
+ "src/docs-tooling/TokenDisplayToggle.tsx",
2464
2576
  "src/stories/segmented-control.stories.tsx"
2465
2577
  ],
2466
2578
  "tokenMapping": {
@@ -2539,7 +2651,16 @@
2539
2651
  "tier": "primitive",
2540
2652
  "docExempt": false,
2541
2653
  "sourcePath": "src/app/components/SegmentedControl.tsx",
2542
- "figmaLink": "https://www.figma.com/design/c8MaVgwxOlxm4wr8wnH0Z4/HDS-Tokens-Components?node-id=82-334"
2654
+ "figmaLink": "https://www.figma.com/design/c8MaVgwxOlxm4wr8wnH0Z4/HDS-Tokens-Components?node-id=82-334",
2655
+ "storyFiles": [
2656
+ "src/stories/segmented-control.stories.tsx"
2657
+ ],
2658
+ "storyIds": [
2659
+ "primitives-segmented-control--compact",
2660
+ "primitives-segmented-control--full-width",
2661
+ "primitives-segmented-control--primary",
2662
+ "primitives-segmented-control--secondary"
2663
+ ]
2543
2664
  },
2544
2665
  "Sketch": {
2545
2666
  "category": "Layout",
@@ -2609,7 +2730,15 @@
2609
2730
  }
2610
2731
  ],
2611
2732
  "sourcePath": "src/app/components/Sketch.tsx",
2612
- "figmaLink": null
2733
+ "figmaLink": null,
2734
+ "storyFiles": [
2735
+ "src/stories/sketch.stories.tsx"
2736
+ ],
2737
+ "storyIds": [
2738
+ "layout-sketch--default",
2739
+ "layout-sketch--narrow-canvas",
2740
+ "layout-sketch--with-controls"
2741
+ ]
2613
2742
  },
2614
2743
  "Stack": {
2615
2744
  "category": "Layout",
@@ -2628,28 +2757,27 @@
2628
2757
  "src/app/components/activity-feed.tsx",
2629
2758
  "src/app/components/box.tsx",
2630
2759
  "src/app/components/cluster.tsx",
2631
- "src/app/components/componentPreviewRegistry.tsx",
2632
2760
  "src/app/components/container.tsx",
2633
- "src/app/components/controls-panel.tsx",
2634
2761
  "src/app/components/cover.tsx",
2635
2762
  "src/app/components/disclosure.tsx",
2636
- "src/app/components/doc-page-header.tsx",
2637
2763
  "src/app/components/error-boundary.tsx",
2638
2764
  "src/app/components/error-pattern.tsx",
2639
2765
  "src/app/components/foundation-swatch.tsx",
2640
2766
  "src/app/components/grid.tsx",
2641
2767
  "src/app/components/heading-stack.tsx",
2642
2768
  "src/app/components/image-lightbox.tsx",
2643
- "src/app/components/lab/token-collection-list.tsx",
2644
2769
  "src/app/components/nav-group.tsx",
2645
2770
  "src/app/components/page.tsx",
2646
- "src/app/components/shell-controls.tsx",
2647
- "src/app/components/sketch-controls.tsx",
2648
2771
  "src/app/components/sketch.tsx",
2649
2772
  "src/app/components/tooltip.tsx",
2650
2773
  "src/app/data/hdsEditorial.tsx",
2651
2774
  "src/app/layouts/CaseStudyLayout.tsx",
2652
2775
  "src/app/layouts/DocLayout.tsx",
2776
+ "src/docs-tooling/controls-panel.tsx",
2777
+ "src/docs-tooling/doc-page-header.tsx",
2778
+ "src/docs-tooling/lab/token-collection-list.tsx",
2779
+ "src/docs-tooling/shell-controls.tsx",
2780
+ "src/docs-tooling/sketch-controls.tsx",
2653
2781
  "src/stories/box.stories.tsx",
2654
2782
  "src/stories/code-block.stories.tsx",
2655
2783
  "src/stories/grid.stories.tsx",
@@ -2798,7 +2926,17 @@
2798
2926
  "tier": "primitive",
2799
2927
  "docExempt": false,
2800
2928
  "sourcePath": "src/app/components/Stack.tsx",
2801
- "figmaLink": null
2929
+ "figmaLink": null,
2930
+ "storyFiles": [
2931
+ "src/stories/stack.stories.tsx"
2932
+ ],
2933
+ "storyIds": [
2934
+ "primitives-stack--column",
2935
+ "primitives-stack--row",
2936
+ "primitives-stack--space-between",
2937
+ "primitives-stack--spacious-gap",
2938
+ "primitives-stack--tight-gap"
2939
+ ]
2802
2940
  },
2803
2941
  "StepperField": {
2804
2942
  "category": "Inputs",
@@ -2814,7 +2952,6 @@
2814
2952
  "sizing": "panel"
2815
2953
  },
2816
2954
  "consumers": [
2817
- "src/app/components/componentPreviewRegistry.tsx",
2818
2955
  "src/stories/stepper-field.stories.tsx"
2819
2956
  ],
2820
2957
  "tokenMapping": {},
@@ -2889,7 +3026,17 @@
2889
3026
  }
2890
3027
  ],
2891
3028
  "sourcePath": "src/app/components/StepperField.tsx",
2892
- "figmaLink": "https://www.figma.com/design/c8MaVgwxOlxm4wr8wnH0Z4/HDS-Tokens-Components?node-id=82-425"
3029
+ "figmaLink": "https://www.figma.com/design/c8MaVgwxOlxm4wr8wnH0Z4/HDS-Tokens-Components?node-id=82-425",
3030
+ "storyFiles": [
3031
+ "src/stories/stepper-field.stories.tsx"
3032
+ ],
3033
+ "storyIds": [
3034
+ "primitives-stepper-field--column-count",
3035
+ "primitives-stepper-field--decimal",
3036
+ "primitives-stepper-field--default",
3037
+ "primitives-stepper-field--dimension-panel",
3038
+ "primitives-stepper-field--font-size"
3039
+ ]
2893
3040
  },
2894
3041
  "Table": {
2895
3042
  "category": "Display",
@@ -2905,10 +3052,10 @@
2905
3052
  "sizing": "full"
2906
3053
  },
2907
3054
  "consumers": [
2908
- "src/app/components/api-reference.tsx",
2909
- "src/app/components/componentPreviewRegistry.tsx",
2910
- "src/app/components/propTableUtils.tsx",
3055
+ "src/app/components/table.test.tsx",
2911
3056
  "src/app/data/hdsEditorial.tsx",
3057
+ "src/docs-tooling/api-reference.tsx",
3058
+ "src/docs-tooling/propTableUtils.tsx",
2912
3059
  "src/stories/nav-group.stories.tsx",
2913
3060
  "src/stories/nav-item.stories.tsx",
2914
3061
  "src/stories/segmented-control.stories.tsx",
@@ -2975,7 +3122,19 @@
2975
3122
  "tier": "primitive",
2976
3123
  "docExempt": false,
2977
3124
  "sourcePath": "src/app/components/Table.tsx",
2978
- "figmaLink": "https://www.figma.com/design/c8MaVgwxOlxm4wr8wnH0Z4/HDS-Tokens-Components?node-id=89-300"
3125
+ "figmaLink": "https://www.figma.com/design/c8MaVgwxOlxm4wr8wnH0Z4/HDS-Tokens-Components?node-id=89-300",
3126
+ "storyFiles": [
3127
+ "src/stories/table.stories.tsx"
3128
+ ],
3129
+ "storyIds": [
3130
+ "primitives-table--default",
3131
+ "primitives-table--density-comfortable",
3132
+ "primitives-table--density-compact",
3133
+ "primitives-table--flush",
3134
+ "primitives-table--sortable",
3135
+ "primitives-table--with-badge-slots",
3136
+ "primitives-table--with-caption"
3137
+ ]
2979
3138
  },
2980
3139
  "Tag": {
2981
3140
  "category": "Inputs",
@@ -2998,7 +3157,6 @@
2998
3157
  "src/app/components/card.tsx",
2999
3158
  "src/app/components/center.tsx",
3000
3159
  "src/app/components/cluster.tsx",
3001
- "src/app/components/componentPreviewRegistry.tsx",
3002
3160
  "src/app/components/cover.tsx",
3003
3161
  "src/app/components/file-input.tsx",
3004
3162
  "src/app/components/frame.tsx",
@@ -3134,7 +3292,18 @@
3134
3292
  "tier": "primitive",
3135
3293
  "docExempt": false,
3136
3294
  "sourcePath": "src/app/components/Tag.tsx",
3137
- "figmaLink": "https://www.figma.com/design/c8MaVgwxOlxm4wr8wnH0Z4/HDS-Tokens-Components?node-id=32-11"
3295
+ "figmaLink": "https://www.figma.com/design/c8MaVgwxOlxm4wr8wnH0Z4/HDS-Tokens-Components?node-id=32-11",
3296
+ "storyFiles": [
3297
+ "src/stories/tag.stories.tsx"
3298
+ ],
3299
+ "storyIds": [
3300
+ "primitives-tag--active",
3301
+ "primitives-tag--default",
3302
+ "primitives-tag--disabled",
3303
+ "primitives-tag--filter-row",
3304
+ "primitives-tag--interactive",
3305
+ "primitives-tag--state-matrix"
3306
+ ]
3138
3307
  },
3139
3308
  "Token": {
3140
3309
  "category": "Display",
@@ -3154,18 +3323,17 @@
3154
3323
  "src/app/components/box-sx.ts",
3155
3324
  "src/app/components/box.tsx",
3156
3325
  "src/app/components/code-block.tsx",
3157
- "src/app/components/componentPreviewRegistry.tsx",
3158
3326
  "src/app/components/foundation-swatch.tsx",
3159
- "src/app/components/health-rail.tsx",
3160
- "src/app/components/lab/legacy-token-detail.tsx",
3161
- "src/app/components/lab/legacy-token-list.tsx",
3162
- "src/app/components/lab/token-collection-list.tsx",
3163
3327
  "src/app/components/side-nav.tsx",
3164
- "src/app/components/TokenDisplayToggle.tsx",
3165
3328
  "src/app/data/hdsEditorial.tsx",
3166
3329
  "src/app/design-system/generated-token-descriptions.ts",
3167
3330
  "src/app/lib/hds-search.ts",
3168
3331
  "src/app/stores/mobiusStore.ts",
3332
+ "src/docs-tooling/health-rail.tsx",
3333
+ "src/docs-tooling/lab/legacy-token-detail.tsx",
3334
+ "src/docs-tooling/lab/legacy-token-list.tsx",
3335
+ "src/docs-tooling/lab/token-collection-list.tsx",
3336
+ "src/docs-tooling/TokenDisplayToggle.tsx",
3169
3337
  "src/index.ts",
3170
3338
  "src/stories/activity-feed.stories.tsx",
3171
3339
  "src/stories/card.stories.tsx",
@@ -3293,7 +3461,18 @@
3293
3461
  "tier": "primitive",
3294
3462
  "docExempt": false,
3295
3463
  "sourcePath": "src/app/components/Token.tsx",
3296
- "figmaLink": null
3464
+ "figmaLink": null,
3465
+ "storyFiles": [
3466
+ "src/stories/token.stories.tsx"
3467
+ ],
3468
+ "storyIds": [
3469
+ "primitives-token--color-token",
3470
+ "primitives-token--compressed-path",
3471
+ "primitives-token--default",
3472
+ "primitives-token--explicit-swatch",
3473
+ "primitives-token--selected",
3474
+ "primitives-token--source-node"
3475
+ ]
3297
3476
  },
3298
3477
  "Surface": {
3299
3478
  "category": "Layout",
@@ -3309,33 +3488,33 @@
3309
3488
  "sizing": "panel"
3310
3489
  },
3311
3490
  "consumers": [
3312
- "src/app/components/api-reference.tsx",
3313
- "src/app/components/component-preview.tsx",
3314
3491
  "src/app/components/container.tsx",
3315
- "src/app/components/controls-panel.tsx",
3316
3492
  "src/app/components/dialog.tsx",
3317
3493
  "src/app/components/disclosure.tsx",
3318
- "src/app/components/doc-page-header.tsx",
3319
3494
  "src/app/components/empty-state.tsx",
3320
3495
  "src/app/components/error-boundary.tsx",
3321
3496
  "src/app/components/error-pattern.tsx",
3322
3497
  "src/app/components/foundation-swatch.tsx",
3323
3498
  "src/app/components/image-lightbox.tsx",
3324
- "src/app/components/lab/token-list.tsx",
3325
- "src/app/components/lab/tokenUtils.ts",
3326
3499
  "src/app/components/popover.tsx",
3327
- "src/app/components/preview-frame.tsx",
3328
- "src/app/components/shell-controls.tsx",
3329
- "src/app/components/sketch-controls.tsx",
3330
3500
  "src/app/components/sketch.tsx",
3331
3501
  "src/app/components/slider.tsx",
3332
3502
  "src/app/components/stepper-field.tsx",
3333
3503
  "src/app/components/surface-padding.ts",
3334
3504
  "src/app/components/table.tsx",
3335
3505
  "src/app/components/tokenTableUtils.ts",
3506
+ "src/app/components/tokenUtils.ts",
3336
3507
  "src/app/components/tooltip.tsx",
3337
3508
  "src/app/data/hdsEditorial.tsx",
3338
3509
  "src/app/layouts/CaseStudyLayout.tsx",
3510
+ "src/docs-tooling/api-reference.tsx",
3511
+ "src/docs-tooling/component-preview.tsx",
3512
+ "src/docs-tooling/controls-panel.tsx",
3513
+ "src/docs-tooling/doc-page-header.tsx",
3514
+ "src/docs-tooling/lab/token-list.tsx",
3515
+ "src/docs-tooling/preview-frame.tsx",
3516
+ "src/docs-tooling/shell-controls.tsx",
3517
+ "src/docs-tooling/sketch-controls.tsx",
3339
3518
  "src/stories/card.stories.tsx",
3340
3519
  "src/stories/container.stories.tsx",
3341
3520
  "src/stories/grid.stories.tsx",
@@ -3384,6 +3563,16 @@
3384
3563
  "figmaLink": "https://www.figma.com/design/c8MaVgwxOlxm4wr8wnH0Z4/HDS-Tokens-Components?node-id=89-27",
3385
3564
  "states": [
3386
3565
  "default"
3566
+ ],
3567
+ "storyFiles": [
3568
+ "src/stories/surface.stories.tsx"
3569
+ ],
3570
+ "storyIds": [
3571
+ "primitives-surface--card-grid",
3572
+ "primitives-surface--default",
3573
+ "primitives-surface--forced-dark",
3574
+ "primitives-surface--item-padding",
3575
+ "primitives-surface--with-shadow"
3387
3576
  ]
3388
3577
  },
3389
3578
  "Card": {
@@ -3617,7 +3806,22 @@
3617
3806
  "className": {
3618
3807
  "type": "string"
3619
3808
  }
3620
- }
3809
+ },
3810
+ "storyFiles": [
3811
+ "src/stories/card.stories.tsx"
3812
+ ],
3813
+ "storyIds": [
3814
+ "primitives-card--bordered",
3815
+ "primitives-card--default",
3816
+ "primitives-card--elevated",
3817
+ "primitives-card--feedback-tones",
3818
+ "primitives-card--full-anatomy",
3819
+ "primitives-card--header-only",
3820
+ "primitives-card--metric-slot",
3821
+ "primitives-card--padding-variants",
3822
+ "primitives-card--progress-slot",
3823
+ "primitives-card--variant-accent"
3824
+ ]
3621
3825
  },
3622
3826
  "ComponentInstanceMatrix": {
3623
3827
  "category": "Utilities",
@@ -3633,7 +3837,6 @@
3633
3837
  "sizing": "full"
3634
3838
  },
3635
3839
  "consumers": [
3636
- "src/app/components/componentPreviewRegistry.tsx",
3637
3840
  "src/stories/component-instance-matrix.stories.tsx"
3638
3841
  ],
3639
3842
  "tokenMapping": {},
@@ -3649,39 +3852,15 @@
3649
3852
  "variantAxes": [],
3650
3853
  "componentProperties": [],
3651
3854
  "sourcePath": "src/app/components/ComponentInstanceMatrix.tsx",
3652
- "figmaLink": null
3653
- },
3654
- "SpecimenBlock": {
3655
- "category": "Utilities",
3656
- "categorySource": "jsdoc",
3657
- "governedCategory": true,
3658
- "hidden": false,
3659
- "filePath": "src/app/components/specimen-block.tsx",
3660
- "description": "SpecimenBlock — shared component-doc specimen block with preview, variant deck, and optional matrix.",
3661
- "figmaUrl": null,
3662
- "figmaId": null,
3663
- "preview": {
3664
- "exportName": "SpecimenBlock",
3665
- "sizing": "panel"
3666
- },
3667
- "consumers": [
3668
- "src/app/components/api-reference.tsx",
3669
- "src/app/components/componentPreviewRegistry.tsx"
3670
- ],
3671
- "tokenMapping": {},
3672
- "props": {},
3673
- "allowedChildren": [
3674
- "*"
3855
+ "figmaLink": null,
3856
+ "storyFiles": [
3857
+ "src/stories/component-instance-matrix.stories.tsx"
3675
3858
  ],
3676
- "propConstraints": {},
3677
- "requiredProps": [],
3678
- "a11yRules": [],
3679
- "tier": "primitive",
3680
- "docExempt": true,
3681
- "variantAxes": [],
3682
- "componentProperties": [],
3683
- "sourcePath": "src/app/components/SpecimenBlock.tsx",
3684
- "figmaLink": null
3859
+ "storyIds": [
3860
+ "primitives-component-instance-matrix--default",
3861
+ "primitives-component-instance-matrix--frozen-row-state",
3862
+ "primitives-component-instance-matrix--mobile-layout"
3863
+ ]
3685
3864
  },
3686
3865
  "ActivityFeed": {
3687
3866
  "category": "Display",
@@ -3698,6 +3877,7 @@
3698
3877
  },
3699
3878
  "consumers": [
3700
3879
  "src/app/components/activity-feed.test.tsx",
3880
+ "src/index.ts",
3701
3881
  "src/stories/activity-feed.stories.tsx"
3702
3882
  ],
3703
3883
  "tokenMapping": {},
@@ -3757,7 +3937,16 @@
3757
3937
  }
3758
3938
  ],
3759
3939
  "sourcePath": "src/app/components/ActivityFeed.tsx",
3760
- "figmaLink": null
3940
+ "figmaLink": null,
3941
+ "storyFiles": [
3942
+ "src/stories/activity-feed.stories.tsx"
3943
+ ],
3944
+ "storyIds": [
3945
+ "primitives-activity-feed--all-success",
3946
+ "primitives-activity-feed--default",
3947
+ "primitives-activity-feed--errors-and-warnings",
3948
+ "primitives-activity-feed--single-event"
3949
+ ]
3761
3950
  },
3762
3951
  "HeadingStack": {
3763
3952
  "category": "Typography",
@@ -3856,7 +4045,18 @@
3856
4045
  "tier": "primitive",
3857
4046
  "docExempt": true,
3858
4047
  "sourcePath": "src/app/components/HeadingStack.tsx",
3859
- "figmaLink": null
4048
+ "figmaLink": null,
4049
+ "storyFiles": [
4050
+ "src/stories/heading-stack.stories.tsx"
4051
+ ],
4052
+ "storyIds": [
4053
+ "primitives-heading-stack--all-levels",
4054
+ "primitives-heading-stack--default",
4055
+ "primitives-heading-stack--heading-1",
4056
+ "primitives-heading-stack--heading-2",
4057
+ "primitives-heading-stack--heading-3",
4058
+ "primitives-heading-stack--tight-gap"
4059
+ ]
3860
4060
  },
3861
4061
  "HdsSystemDocLayout": {
3862
4062
  "category": "Uncategorized",
@@ -3864,7 +4064,7 @@
3864
4064
  "governedCategory": false,
3865
4065
  "hidden": false,
3866
4066
  "filePath": "src/app/layouts/HdsSystemDocLayout.tsx",
3867
- "description": "HdsSystemDocLayout — three-column doc layout with sidebar, nav, and content.",
4067
+ "description": "HdsSystemDocLayout — single centered content column for documentation pages. Thin wrapper around DocLayout: takes only `contentSlot` and `contentMaxWidth`, with no sidebar or nav region to pass one into. Not the three-column docs shell (left rail + content + right rail) — that is tracked as its own shell component (hds#280).",
3868
4068
  "figmaUrl": null,
3869
4069
  "figmaId": null,
3870
4070
  "preview": {
@@ -3872,6 +4072,7 @@
3872
4072
  "sizing": "panel"
3873
4073
  },
3874
4074
  "consumers": [
4075
+ "src/app/layouts/DocLayout.tsx",
3875
4076
  "src/index.ts"
3876
4077
  ],
3877
4078
  "tokenMapping": {
@@ -3942,7 +4143,9 @@
3942
4143
  }
3943
4144
  }
3944
4145
  ],
3945
- "figmaLink": null
4146
+ "figmaLink": null,
4147
+ "storyFiles": [],
4148
+ "storyIds": []
3946
4149
  },
3947
4150
  "Text": {
3948
4151
  "category": "Typography",
@@ -3999,13 +4202,13 @@
3999
4202
  "src/app/components/foundation-swatch.tsx",
4000
4203
  "src/app/components/hds-tooltip.tsx",
4001
4204
  "src/app/components/nav-item.tsx",
4002
- "src/app/components/preview-frame.tsx",
4003
4205
  "src/app/components/table.tsx",
4004
4206
  "src/app/components/text-lockup.tsx",
4005
4207
  "src/app/components/tokenTableUtils.ts",
4006
4208
  "src/app/components/toolbar.test.tsx",
4007
4209
  "src/app/design-system/generated-token-descriptions.ts",
4008
4210
  "src/brand/overlay.ts",
4211
+ "src/docs-tooling/preview-frame.tsx",
4009
4212
  "src/stories/container.stories.tsx",
4010
4213
  "src/stories/disclosure.stories.tsx",
4011
4214
  "src/stories/error-boundary.stories.tsx",
@@ -4026,7 +4229,24 @@
4026
4229
  "tier": "primitive",
4027
4230
  "docExempt": true,
4028
4231
  "sourcePath": "src/app/components/Text.tsx",
4029
- "figmaLink": null
4232
+ "figmaLink": null,
4233
+ "storyFiles": [
4234
+ "src/stories/error-boundary.stories.tsx",
4235
+ "src/stories/text.stories.tsx"
4236
+ ],
4237
+ "storyIds": [
4238
+ "feedback-error-boundary--default",
4239
+ "feedback-error-boundary--with-min-height",
4240
+ "primitives-text--body",
4241
+ "primitives-text--caption",
4242
+ "primitives-text--display",
4243
+ "primitives-text--full-ramp",
4244
+ "primitives-text--heading-1",
4245
+ "primitives-text--heading-2",
4246
+ "primitives-text--heading-3",
4247
+ "primitives-text--technical",
4248
+ "primitives-text--ui"
4249
+ ]
4030
4250
  },
4031
4251
  "Dialog": {
4032
4252
  "category": "Overlays",
@@ -4222,7 +4442,16 @@
4222
4442
  "modal": {
4223
4443
  "type": "boolean"
4224
4444
  }
4225
- }
4445
+ },
4446
+ "storyFiles": [
4447
+ "src/stories/dialog.stories.tsx"
4448
+ ],
4449
+ "storyIds": [
4450
+ "primitives-dialog--default",
4451
+ "primitives-dialog--destructive",
4452
+ "primitives-dialog--information",
4453
+ "primitives-dialog--no-close-affordance"
4454
+ ]
4226
4455
  },
4227
4456
  "StackedCardRail": {
4228
4457
  "category": "Display",
@@ -4241,6 +4470,7 @@
4241
4470
  "sizing": "panel"
4242
4471
  },
4243
4472
  "consumers": [
4473
+ "src/index.ts",
4244
4474
  "src/stories/stacked-card-rail.stories.tsx"
4245
4475
  ],
4246
4476
  "tokenMapping": {},
@@ -4257,7 +4487,15 @@
4257
4487
  "requiredProps": [
4258
4488
  "cards"
4259
4489
  ],
4260
- "a11yRules": []
4490
+ "a11yRules": [],
4491
+ "storyFiles": [
4492
+ "src/stories/stacked-card-rail.stories.tsx"
4493
+ ],
4494
+ "storyIds": [
4495
+ "patterns-stacked-card-rail--default",
4496
+ "patterns-stacked-card-rail--sparse",
4497
+ "patterns-stacked-card-rail--with-links"
4498
+ ]
4261
4499
  },
4262
4500
  "Button": {
4263
4501
  "category": "Actions",
@@ -4279,11 +4517,9 @@
4279
4517
  "src/app/components/activity-feed.tsx",
4280
4518
  "src/app/components/alert-dialog.tsx",
4281
4519
  "src/app/components/animated-label.tsx",
4282
- "src/app/components/api-reference.tsx",
4283
4520
  "src/app/components/button-group.test.tsx",
4284
4521
  "src/app/components/button-group.tsx",
4285
4522
  "src/app/components/card.tsx",
4286
- "src/app/components/componentPreviewRegistry.tsx",
4287
4523
  "src/app/components/dialog.tsx",
4288
4524
  "src/app/components/error-boundary.tsx",
4289
4525
  "src/app/components/error-pattern.tsx",
@@ -4295,13 +4531,15 @@
4295
4531
  "src/app/components/pagination.tsx",
4296
4532
  "src/app/components/popover.tsx",
4297
4533
  "src/app/components/segmented-control.tsx",
4298
- "src/app/components/sketch-controls.tsx",
4299
4534
  "src/app/components/toast.tsx",
4300
4535
  "src/app/components/toolbar.test.tsx",
4301
4536
  "src/app/components/toolbar.tsx",
4302
- "src/app/components/variant-strip.tsx",
4303
4537
  "src/app/context/DemoStateContext.tsx",
4304
4538
  "src/app/design-system/generated-token-descriptions.ts",
4539
+ "src/docs-tooling/api-reference.tsx",
4540
+ "src/docs-tooling/doc-page-header.test.tsx",
4541
+ "src/docs-tooling/sketch-controls.tsx",
4542
+ "src/docs-tooling/variant-strip.tsx",
4305
4543
  "src/form/index.ts",
4306
4544
  "src/mui/index.ts",
4307
4545
  "src/stories/alert-dialog.stories.tsx",
@@ -4491,7 +4729,21 @@
4491
4729
  "iconOnly": {
4492
4730
  "type": "boolean"
4493
4731
  }
4494
- }
4732
+ },
4733
+ "storyFiles": [
4734
+ "src/stories/button.stories.tsx"
4735
+ ],
4736
+ "storyIds": [
4737
+ "primitives-button--all-variants-row",
4738
+ "primitives-button--disabled",
4739
+ "primitives-button--large",
4740
+ "primitives-button--loading",
4741
+ "primitives-button--medium",
4742
+ "primitives-button--primary",
4743
+ "primitives-button--secondary",
4744
+ "primitives-button--small",
4745
+ "primitives-button--tertiary"
4746
+ ]
4495
4747
  },
4496
4748
  "Callout": {
4497
4749
  "category": "Feedback",
@@ -4556,6 +4808,18 @@
4556
4808
  "rule": "Callout is decorative; tone is signaled visually — pair with semantic role when meaning matters",
4557
4809
  "required": false
4558
4810
  }
4811
+ ],
4812
+ "storyFiles": [
4813
+ "src/stories/callout.stories.tsx"
4814
+ ],
4815
+ "storyIds": [
4816
+ "primitives-callout--accent",
4817
+ "primitives-callout--all-tones",
4818
+ "primitives-callout--danger",
4819
+ "primitives-callout--default",
4820
+ "primitives-callout--italic",
4821
+ "primitives-callout--success",
4822
+ "primitives-callout--warning"
4559
4823
  ]
4560
4824
  },
4561
4825
  "EmptyState": {
@@ -4575,7 +4839,7 @@
4575
4839
  "sizing": "panel"
4576
4840
  },
4577
4841
  "consumers": [
4578
- "src/app/components/lab/legacy-token-detail.tsx",
4842
+ "src/docs-tooling/lab/legacy-token-detail.tsx",
4579
4843
  "src/stories/empty-state.stories.tsx",
4580
4844
  "src/stories/patterns-layout.stories.tsx"
4581
4845
  ],
@@ -4600,7 +4864,16 @@
4600
4864
  ],
4601
4865
  "propConstraints": {},
4602
4866
  "requiredProps": [],
4603
- "a11yRules": []
4867
+ "a11yRules": [],
4868
+ "storyFiles": [
4869
+ "src/stories/empty-state.stories.tsx"
4870
+ ],
4871
+ "storyIds": [
4872
+ "primitives-empty-state--default",
4873
+ "primitives-empty-state--in-grid",
4874
+ "primitives-empty-state--title-only",
4875
+ "primitives-empty-state--with-description"
4876
+ ]
4604
4877
  },
4605
4878
  "Field": {
4606
4879
  "category": "Display",
@@ -4682,6 +4955,20 @@
4682
4955
  "rule": "Label must describe the value; pair with aria-describedby when value is non-trivial",
4683
4956
  "required": false
4684
4957
  }
4958
+ ],
4959
+ "storyFiles": [
4960
+ "src/stories/field.stories.tsx"
4961
+ ],
4962
+ "storyIds": [
4963
+ "primitives-field--all-tones",
4964
+ "primitives-field--danger",
4965
+ "primitives-field--default",
4966
+ "primitives-field--info",
4967
+ "primitives-field--metadata-grid",
4968
+ "primitives-field--mono",
4969
+ "primitives-field--success",
4970
+ "primitives-field--warning",
4971
+ "primitives-field--with-children"
4685
4972
  ]
4686
4973
  },
4687
4974
  "Page": {
@@ -4708,6 +4995,7 @@
4708
4995
  "src/app/components/toast.tsx",
4709
4996
  "src/app/design-system/generated-token-descriptions.ts",
4710
4997
  "src/brand/overlay.ts",
4998
+ "src/index.ts",
4711
4999
  "src/stories/error-pattern.stories.tsx",
4712
5000
  "src/stories/heading-stack.stories.tsx",
4713
5001
  "src/stories/not-found-pattern.stories.tsx",
@@ -4751,7 +5039,21 @@
4751
5039
  ],
4752
5040
  "propConstraints": {},
4753
5041
  "requiredProps": [],
4754
- "a11yRules": []
5042
+ "a11yRules": [],
5043
+ "storyFiles": [
5044
+ "src/stories/page.stories.tsx",
5045
+ "src/stories/patterns-layout.stories.tsx"
5046
+ ],
5047
+ "storyIds": [
5048
+ "layout-page--compact-padding",
5049
+ "layout-page--content-width",
5050
+ "layout-page--default",
5051
+ "layout-page--no-padding",
5052
+ "patterns-layout--dashboard-grid",
5053
+ "patterns-layout--detail-page",
5054
+ "patterns-layout--empty-state-screen",
5055
+ "patterns-layout--form-screen"
5056
+ ]
4755
5057
  },
4756
5058
  "Stat": {
4757
5059
  "category": "Display",
@@ -4821,6 +5123,17 @@
4821
5123
  "rule": "Provide an accessible name for the stat when value is symbolic (—, ✓, etc.)",
4822
5124
  "required": false
4823
5125
  }
5126
+ ],
5127
+ "storyFiles": [
5128
+ "src/stories/stat.stories.tsx"
5129
+ ],
5130
+ "storyIds": [
5131
+ "primitives-stat--all-tones",
5132
+ "primitives-stat--danger",
5133
+ "primitives-stat--default",
5134
+ "primitives-stat--success",
5135
+ "primitives-stat--warning",
5136
+ "primitives-stat--with-sub"
4824
5137
  ]
4825
5138
  },
4826
5139
  "StatusListItem": {
@@ -4891,6 +5204,17 @@
4891
5204
  "rule": "Status dot is decorative (aria-hidden); convey status meaning via title or trailing badge",
4892
5205
  "required": true
4893
5206
  }
5207
+ ],
5208
+ "storyFiles": [
5209
+ "src/stories/status-list-item.stories.tsx"
5210
+ ],
5211
+ "storyIds": [
5212
+ "primitives-status-list-item--danger",
5213
+ "primitives-status-list-item--default",
5214
+ "primitives-status-list-item--info",
5215
+ "primitives-status-list-item--success",
5216
+ "primitives-status-list-item--warning",
5217
+ "primitives-status-list-item--with-trailing"
4894
5218
  ]
4895
5219
  },
4896
5220
  "StatusTile": {
@@ -4945,7 +5269,17 @@
4945
5269
  ],
4946
5270
  "propConstraints": {},
4947
5271
  "requiredProps": [],
4948
- "a11yRules": []
5272
+ "a11yRules": [],
5273
+ "storyFiles": [
5274
+ "src/stories/status-tile.stories.tsx"
5275
+ ],
5276
+ "storyIds": [
5277
+ "primitives-status-tile--danger",
5278
+ "primitives-status-tile--default",
5279
+ "primitives-status-tile--tile-grid",
5280
+ "primitives-status-tile--warning",
5281
+ "primitives-status-tile--with-trailing-badge"
5282
+ ]
4949
5283
  },
4950
5284
  "TileGrid": {
4951
5285
  "category": "Layout",
@@ -4990,7 +5324,17 @@
4990
5324
  ],
4991
5325
  "propConstraints": {},
4992
5326
  "requiredProps": [],
4993
- "a11yRules": []
5327
+ "a11yRules": [],
5328
+ "storyFiles": [
5329
+ "src/stories/tile-grid.stories.tsx"
5330
+ ],
5331
+ "storyIds": [
5332
+ "primitives-tile-grid--default",
5333
+ "primitives-tile-grid--gap-md",
5334
+ "primitives-tile-grid--gap-xs",
5335
+ "primitives-tile-grid--narrow-tiles",
5336
+ "primitives-tile-grid--wide-tiles"
5337
+ ]
4994
5338
  },
4995
5339
  "Badge": {
4996
5340
  "variantAxes": [
@@ -5032,10 +5376,9 @@
5032
5376
  "consumers": [
5033
5377
  "src/app/components/alert.tsx",
5034
5378
  "src/app/components/card.tsx",
5035
- "src/app/components/componentPreviewRegistry.tsx",
5036
- "src/app/components/lab/legacy-token-detail.tsx",
5037
5379
  "src/app/data/hdsEditorial.tsx",
5038
5380
  "src/app/design-system/generated-token-descriptions.ts",
5381
+ "src/docs-tooling/lab/legacy-token-detail.tsx",
5039
5382
  "src/mui/index.ts",
5040
5383
  "src/stories/badge.stories.tsx",
5041
5384
  "src/stories/code-block.stories.tsx",
@@ -5046,7 +5389,18 @@
5046
5389
  "src/stories/static-primitives.stories.tsx",
5047
5390
  "src/stories/table.stories.tsx"
5048
5391
  ],
5049
- "tokenMapping": {}
5392
+ "tokenMapping": {},
5393
+ "storyFiles": [
5394
+ "src/stories/badge.stories.tsx"
5395
+ ],
5396
+ "storyIds": [
5397
+ "primitives-badge--all-tones",
5398
+ "primitives-badge--danger",
5399
+ "primitives-badge--info",
5400
+ "primitives-badge--neutral",
5401
+ "primitives-badge--success",
5402
+ "primitives-badge--warning"
5403
+ ]
5050
5404
  },
5051
5405
  "TextLockup": {
5052
5406
  "variantAxes": [
@@ -5102,10 +5456,20 @@
5102
5456
  "sizing": "compact"
5103
5457
  },
5104
5458
  "consumers": [
5105
- "src/app/components/componentPreviewRegistry.tsx",
5106
5459
  "src/stories/text-lockup.stories.tsx"
5107
5460
  ],
5108
- "tokenMapping": {}
5461
+ "tokenMapping": {},
5462
+ "storyFiles": [
5463
+ "src/stories/text-lockup.stories.tsx"
5464
+ ],
5465
+ "storyIds": [
5466
+ "primitives-text-lockup--centered",
5467
+ "primitives-text-lockup--detail",
5468
+ "primitives-text-lockup--hero",
5469
+ "primitives-text-lockup--numbered",
5470
+ "primitives-text-lockup--section",
5471
+ "primitives-text-lockup--with-eyebrow"
5472
+ ]
5109
5473
  },
5110
5474
  "AssetImg": {
5111
5475
  "category": "Display",
@@ -5124,11 +5488,11 @@
5124
5488
  "sizing": "panel"
5125
5489
  },
5126
5490
  "consumers": [
5127
- "src/app/components/componentPreviewRegistry.tsx",
5128
5491
  "src/app/components/hds-tooltip.tsx",
5129
5492
  "src/app/components/image-lightbox.tsx",
5130
5493
  "src/app/components/tooltip.tsx",
5131
5494
  "src/app/data/hdsEditorial.tsx",
5495
+ "src/index.ts",
5132
5496
  "src/stories/asset-img.stories.tsx"
5133
5497
  ],
5134
5498
  "tokenMapping": {},
@@ -5270,6 +5634,16 @@
5270
5634
  "rule": "Caption or description should be associated via aria-describedby when present",
5271
5635
  "required": false
5272
5636
  }
5637
+ ],
5638
+ "storyFiles": [
5639
+ "src/stories/asset-img.stories.tsx"
5640
+ ],
5641
+ "storyIds": [
5642
+ "primitives-asset-img--default",
5643
+ "primitives-asset-img--detail-context",
5644
+ "primitives-asset-img--lightbox-context",
5645
+ "primitives-asset-img--placeholder-fallback",
5646
+ "primitives-asset-img--with-title"
5273
5647
  ]
5274
5648
  },
5275
5649
  "Tabs": {
@@ -5306,7 +5680,16 @@
5306
5680
  ],
5307
5681
  "propConstraints": {},
5308
5682
  "requiredProps": [],
5309
- "a11yRules": []
5683
+ "a11yRules": [],
5684
+ "storyFiles": [
5685
+ "src/stories/tabs.stories.tsx"
5686
+ ],
5687
+ "storyIds": [
5688
+ "primitives-tabs--controlled",
5689
+ "primitives-tabs--default",
5690
+ "primitives-tabs--many-tabs",
5691
+ "primitives-tabs--with-disabled-tab"
5692
+ ]
5310
5693
  },
5311
5694
  "TabsContent": {
5312
5695
  "category": "Navigation",
@@ -5341,7 +5724,16 @@
5341
5724
  ],
5342
5725
  "propConstraints": {},
5343
5726
  "requiredProps": [],
5344
- "a11yRules": []
5727
+ "a11yRules": [],
5728
+ "storyFiles": [
5729
+ "src/stories/tabs.stories.tsx"
5730
+ ],
5731
+ "storyIds": [
5732
+ "primitives-tabs--controlled",
5733
+ "primitives-tabs--default",
5734
+ "primitives-tabs--many-tabs",
5735
+ "primitives-tabs--with-disabled-tab"
5736
+ ]
5345
5737
  },
5346
5738
  "TabsList": {
5347
5739
  "category": "Navigation",
@@ -5376,7 +5768,16 @@
5376
5768
  ],
5377
5769
  "propConstraints": {},
5378
5770
  "requiredProps": [],
5379
- "a11yRules": []
5771
+ "a11yRules": [],
5772
+ "storyFiles": [
5773
+ "src/stories/tabs.stories.tsx"
5774
+ ],
5775
+ "storyIds": [
5776
+ "primitives-tabs--controlled",
5777
+ "primitives-tabs--default",
5778
+ "primitives-tabs--many-tabs",
5779
+ "primitives-tabs--with-disabled-tab"
5780
+ ]
5380
5781
  },
5381
5782
  "TabsTrigger": {
5382
5783
  "category": "Navigation",
@@ -5411,28 +5812,37 @@
5411
5812
  ],
5412
5813
  "propConstraints": {},
5413
5814
  "requiredProps": [],
5414
- "a11yRules": []
5815
+ "a11yRules": [],
5816
+ "storyFiles": [
5817
+ "src/stories/tabs.stories.tsx"
5818
+ ],
5819
+ "storyIds": [
5820
+ "primitives-tabs--controlled",
5821
+ "primitives-tabs--default",
5822
+ "primitives-tabs--many-tabs",
5823
+ "primitives-tabs--with-disabled-tab"
5824
+ ]
5415
5825
  },
5416
- "HdsRadio": {
5826
+ "Radio": {
5417
5827
  "category": "Inputs",
5418
5828
  "categorySource": "jsdoc",
5419
5829
  "governedCategory": true,
5420
5830
  "hidden": false,
5421
5831
  "filePath": "src/app/components/radio.tsx",
5422
- "description": "HdsRadio — radio button with animated selection indicator.",
5832
+ "description": "Radio — radio button with animated selection indicator.",
5423
5833
  "figmaUrl": "https://www.figma.com/design/c8MaVgwxOlxm4wr8wnH0Z4/HDS-Tokens-Components?node-id=36-17",
5424
5834
  "figmaId": null,
5425
5835
  "preview": {
5426
- "exportName": "HdsRadio",
5836
+ "exportName": "Radio",
5427
5837
  "sizing": "panel"
5428
5838
  },
5429
5839
  "consumers": [
5430
- "src/app/components/componentPreviewRegistry.tsx",
5431
- "src/app/components/controls.tsx",
5840
+ "src/app/components/checkbox.tsx",
5432
5841
  "src/app/components/radio.test.tsx",
5433
- "src/app/data/hdsEditorial.tsx",
5434
5842
  "src/app/hooks/useInteractionState.test.ts",
5435
5843
  "src/app/hooks/useInteractionState.ts",
5844
+ "src/index.ts",
5845
+ "src/stories/menu.stories.tsx",
5436
5846
  "src/stories/radio.stories.tsx"
5437
5847
  ],
5438
5848
  "tokenMapping": {
@@ -5469,26 +5879,46 @@
5469
5879
  "componentProperties": [],
5470
5880
  "tier": "primitive",
5471
5881
  "docExempt": false,
5472
- "figmaLink": "https://www.figma.com/design/c8MaVgwxOlxm4wr8wnH0Z4/HDS-Tokens-Components?node-id=36-17"
5882
+ "figmaLink": "https://www.figma.com/design/c8MaVgwxOlxm4wr8wnH0Z4/HDS-Tokens-Components?node-id=36-17",
5883
+ "storyFiles": [
5884
+ "src/stories/radio.stories.tsx"
5885
+ ],
5886
+ "storyIds": [
5887
+ "primitives-radio--default",
5888
+ "primitives-radio--disabled",
5889
+ "primitives-radio--disabled-selected",
5890
+ "primitives-radio--group",
5891
+ "primitives-radio--selected"
5892
+ ]
5473
5893
  },
5474
- "HdsSelect": {
5894
+ "Select": {
5475
5895
  "category": "Inputs",
5476
5896
  "categorySource": "jsdoc",
5477
5897
  "governedCategory": true,
5478
5898
  "hidden": false,
5479
5899
  "filePath": "src/app/components/select.tsx",
5480
- "description": "HdsSelect — dropdown selector built on Radix Select.",
5900
+ "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.",
5481
5901
  "figmaUrl": "https://www.figma.com/design/c8MaVgwxOlxm4wr8wnH0Z4/HDS-Tokens-Components?node-id=82-49",
5482
5902
  "figmaId": null,
5483
5903
  "preview": {
5484
- "exportName": "HdsSelect",
5904
+ "exportName": "Select",
5485
5905
  "sizing": "panel"
5486
5906
  },
5487
5907
  "consumers": [
5488
- "src/app/components/componentPreviewRegistry.tsx",
5489
- "src/app/components/controls.tsx",
5908
+ "src/app/components/checkbox.test.tsx",
5909
+ "src/app/components/combobox.test.tsx",
5910
+ "src/app/components/combobox.tsx",
5911
+ "src/app/components/date-range-input.test.tsx",
5912
+ "src/app/components/date-range-input.tsx",
5913
+ "src/app/components/form.tsx",
5914
+ "src/app/components/multi-selector.test.tsx",
5915
+ "src/app/components/multi-selector.tsx",
5490
5916
  "src/app/components/select.test.tsx",
5491
5917
  "src/app/data/hdsEditorial.tsx",
5918
+ "src/docs-tooling/lab/legacy-token-detail.tsx",
5919
+ "src/index.ts",
5920
+ "src/stories/checkbox.stories.tsx",
5921
+ "src/stories/combobox.stories.tsx",
5492
5922
  "src/stories/select.stories.tsx"
5493
5923
  ],
5494
5924
  "tokenMapping": {
@@ -5527,25 +5957,30 @@
5527
5957
  "componentProperties": [],
5528
5958
  "tier": "primitive",
5529
5959
  "docExempt": false,
5530
- "figmaLink": "https://www.figma.com/design/c8MaVgwxOlxm4wr8wnH0Z4/HDS-Tokens-Components?node-id=82-49"
5960
+ "figmaLink": "https://www.figma.com/design/c8MaVgwxOlxm4wr8wnH0Z4/HDS-Tokens-Components?node-id=82-49",
5961
+ "storyFiles": [
5962
+ "src/stories/select.stories.tsx"
5963
+ ],
5964
+ "storyIds": [
5965
+ "primitives-select--default",
5966
+ "primitives-select--no-label"
5967
+ ]
5531
5968
  },
5532
- "HdsSlider": {
5969
+ "Slider": {
5533
5970
  "category": "Inputs",
5534
5971
  "categorySource": "jsdoc",
5535
5972
  "governedCategory": true,
5536
5973
  "hidden": false,
5537
5974
  "filePath": "src/app/components/slider.tsx",
5538
- "description": "HdsSlider — range slider with label and value display.",
5975
+ "description": "Slider — range slider with label and value display.",
5539
5976
  "figmaUrl": "https://www.figma.com/design/c8MaVgwxOlxm4wr8wnH0Z4/HDS-Tokens-Components?node-id=82-265",
5540
5977
  "figmaId": null,
5541
5978
  "preview": {
5542
- "exportName": "HdsSlider",
5979
+ "exportName": "Slider",
5543
5980
  "sizing": "panel"
5544
5981
  },
5545
5982
  "consumers": [
5546
- "src/app/components/componentPreviewRegistry.tsx",
5547
- "src/app/components/controls.tsx",
5548
- "src/app/data/hdsEditorial.tsx",
5983
+ "src/index.ts",
5549
5984
  "src/stories/slider.stories.tsx"
5550
5985
  ],
5551
5986
  "tokenMapping": {
@@ -5585,29 +6020,40 @@
5585
6020
  "componentProperties": [],
5586
6021
  "tier": "primitive",
5587
6022
  "docExempt": false,
5588
- "figmaLink": "https://www.figma.com/design/c8MaVgwxOlxm4wr8wnH0Z4/HDS-Tokens-Components?node-id=82-265"
6023
+ "figmaLink": "https://www.figma.com/design/c8MaVgwxOlxm4wr8wnH0Z4/HDS-Tokens-Components?node-id=82-265",
6024
+ "storyFiles": [
6025
+ "src/stories/slider.stories.tsx"
6026
+ ],
6027
+ "storyIds": [
6028
+ "primitives-slider--decimal",
6029
+ "primitives-slider--default",
6030
+ "primitives-slider--stepped",
6031
+ "primitives-slider--typography-controls"
6032
+ ]
5589
6033
  },
5590
- "HdsToggle": {
6034
+ "Toggle": {
5591
6035
  "category": "Inputs",
5592
6036
  "categorySource": "jsdoc",
5593
6037
  "governedCategory": true,
5594
6038
  "hidden": false,
5595
6039
  "filePath": "src/app/components/toggle.tsx",
5596
- "description": "HdsToggle — boolean on/off toggle with animated thumb.",
6040
+ "description": "Toggle — boolean on/off toggle with animated thumb.",
5597
6041
  "figmaUrl": "https://www.figma.com/design/c8MaVgwxOlxm4wr8wnH0Z4/HDS-Tokens-Components?node-id=37-19",
5598
6042
  "figmaId": null,
5599
6043
  "preview": {
5600
- "exportName": "HdsToggle",
6044
+ "exportName": "Toggle",
5601
6045
  "sizing": "panel"
5602
6046
  },
5603
6047
  "consumers": [
5604
- "src/app/components/componentPreviewRegistry.tsx",
5605
- "src/app/components/controls.tsx",
6048
+ "src/app/components/checkbox.tsx",
5606
6049
  "src/app/components/radio.tsx",
6050
+ "src/app/components/toggle-button.tsx",
5607
6051
  "src/app/components/toggle.test.tsx",
5608
6052
  "src/app/data/hdsEditorial.tsx",
5609
6053
  "src/app/hooks/useInteractionState.test.ts",
5610
6054
  "src/app/hooks/useInteractionState.ts",
6055
+ "src/docs-tooling/shell-controls.tsx",
6056
+ "src/index.ts",
5611
6057
  "src/stories/toggle.stories.tsx"
5612
6058
  ],
5613
6059
  "tokenMapping": {
@@ -5645,7 +6091,17 @@
5645
6091
  "componentProperties": [],
5646
6092
  "tier": "primitive",
5647
6093
  "docExempt": false,
5648
- "figmaLink": "https://www.figma.com/design/c8MaVgwxOlxm4wr8wnH0Z4/HDS-Tokens-Components?node-id=37-19"
6094
+ "figmaLink": "https://www.figma.com/design/c8MaVgwxOlxm4wr8wnH0Z4/HDS-Tokens-Components?node-id=37-19",
6095
+ "storyFiles": [
6096
+ "src/stories/toggle.stories.tsx"
6097
+ ],
6098
+ "storyIds": [
6099
+ "primitives-toggle--default",
6100
+ "primitives-toggle--disabled",
6101
+ "primitives-toggle--disabled-on",
6102
+ "primitives-toggle--on",
6103
+ "primitives-toggle--settings-group"
6104
+ ]
5649
6105
  },
5650
6106
  "Avatar": {
5651
6107
  "category": "Display",
@@ -5667,6 +6123,7 @@
5667
6123
  "src/app/components/avatar-group.test.tsx",
5668
6124
  "src/app/components/avatar-group.tsx",
5669
6125
  "src/app/components/avatar.test.tsx",
6126
+ "src/app/design-system/generated-token-descriptions.ts",
5670
6127
  "src/stories/avatar-group.stories.tsx",
5671
6128
  "src/stories/avatar.stories.tsx"
5672
6129
  ],
@@ -5702,7 +6159,18 @@
5702
6159
  ],
5703
6160
  "propConstraints": {},
5704
6161
  "requiredProps": [],
5705
- "a11yRules": []
6162
+ "a11yRules": [],
6163
+ "storyFiles": [
6164
+ "src/stories/avatar.stories.tsx"
6165
+ ],
6166
+ "storyIds": [
6167
+ "primitives-avatar--all-sizes",
6168
+ "primitives-avatar--default",
6169
+ "primitives-avatar--explicit-initials",
6170
+ "primitives-avatar--large",
6171
+ "primitives-avatar--small",
6172
+ "primitives-avatar--with-image"
6173
+ ]
5706
6174
  },
5707
6175
  "Progress": {
5708
6176
  "category": "Feedback",
@@ -5755,7 +6223,16 @@
5755
6223
  ],
5756
6224
  "propConstraints": {},
5757
6225
  "requiredProps": [],
5758
- "a11yRules": []
6226
+ "a11yRules": [],
6227
+ "storyFiles": [
6228
+ "src/stories/progress.stories.tsx"
6229
+ ],
6230
+ "storyIds": [
6231
+ "primitives-progress--all-sizes",
6232
+ "primitives-progress--complete",
6233
+ "primitives-progress--default",
6234
+ "primitives-progress--indeterminate"
6235
+ ]
5759
6236
  },
5760
6237
  "Skeleton": {
5761
6238
  "category": "Feedback",
@@ -5806,7 +6283,17 @@
5806
6283
  ],
5807
6284
  "propConstraints": {},
5808
6285
  "requiredProps": [],
5809
- "a11yRules": []
6286
+ "a11yRules": [],
6287
+ "storyFiles": [
6288
+ "src/stories/skeleton.stories.tsx"
6289
+ ],
6290
+ "storyIds": [
6291
+ "primitives-skeleton--all-variants",
6292
+ "primitives-skeleton--card-placeholder",
6293
+ "primitives-skeleton--circular",
6294
+ "primitives-skeleton--default",
6295
+ "primitives-skeleton--text"
6296
+ ]
5810
6297
  },
5811
6298
  "Spinner": {
5812
6299
  "category": "Feedback",
@@ -5851,7 +6338,18 @@
5851
6338
  ],
5852
6339
  "propConstraints": {},
5853
6340
  "requiredProps": [],
5854
- "a11yRules": []
6341
+ "a11yRules": [],
6342
+ "storyFiles": [
6343
+ "src/stories/spinner.stories.tsx"
6344
+ ],
6345
+ "storyIds": [
6346
+ "primitives-spinner--all-sizes",
6347
+ "primitives-spinner--color-inheritance",
6348
+ "primitives-spinner--custom-label",
6349
+ "primitives-spinner--default",
6350
+ "primitives-spinner--large",
6351
+ "primitives-spinner--small"
6352
+ ]
5855
6353
  },
5856
6354
  "Breadcrumb": {
5857
6355
  "category": "Navigation",
@@ -5891,7 +6389,17 @@
5891
6389
  ],
5892
6390
  "propConstraints": {},
5893
6391
  "requiredProps": [],
5894
- "a11yRules": []
6392
+ "a11yRules": [],
6393
+ "storyFiles": [
6394
+ "src/stories/breadcrumb.stories.tsx"
6395
+ ],
6396
+ "storyIds": [
6397
+ "primitives-breadcrumb--custom-label",
6398
+ "primitives-breadcrumb--deep-trail",
6399
+ "primitives-breadcrumb--default",
6400
+ "primitives-breadcrumb--shallow-trail",
6401
+ "primitives-breadcrumb--single-crumb"
6402
+ ]
5895
6403
  },
5896
6404
  "Pagination": {
5897
6405
  "category": "Navigation",
@@ -5940,39 +6448,17 @@
5940
6448
  ],
5941
6449
  "propConstraints": {},
5942
6450
  "requiredProps": [],
5943
- "a11yRules": []
5944
- },
5945
- "HdsCheckbox": {
5946
- "category": "Inputs",
5947
- "filePath": "src/app/components/checkbox.tsx",
5948
- "description": "HdsCheckbox — custom-drawn checkbox with check / indeterminate glyph.",
5949
- "hidden": false,
5950
- "props": {},
5951
- "allowedChildren": [
5952
- "*"
5953
- ],
5954
- "propConstraints": {},
5955
- "requiredProps": [],
5956
6451
  "a11yRules": [],
5957
- "preview": {
5958
- "exportName": "HdsCheckbox",
5959
- "sizing": "panel"
5960
- },
5961
- "tokenMapping": {},
5962
- "tier": "primitive",
5963
- "categorySource": "jsdoc",
5964
- "governedCategory": true,
5965
- "docExempt": false,
5966
- "figmaUrl": "https://www.figma.com/design/c8MaVgwxOlxm4wr8wnH0Z4/HDS-Tokens-Components?node-id=35-29",
5967
- "figmaId": null,
5968
- "figmaLink": "https://www.figma.com/design/c8MaVgwxOlxm4wr8wnH0Z4/HDS-Tokens-Components?node-id=35-29",
5969
- "consumers": [
5970
- "src/app/components/checkbox.test.tsx",
5971
- "src/app/components/radio.tsx",
5972
- "src/stories/checkbox.stories.tsx"
6452
+ "storyFiles": [
6453
+ "src/stories/pagination.stories.tsx"
5973
6454
  ],
5974
- "variantAxes": [],
5975
- "componentProperties": []
6455
+ "storyIds": [
6456
+ "primitives-pagination--default",
6457
+ "primitives-pagination--few-pages",
6458
+ "primitives-pagination--last-page",
6459
+ "primitives-pagination--middle-page",
6460
+ "primitives-pagination--wide-siblings"
6461
+ ]
5976
6462
  },
5977
6463
  "ToastProvider": {
5978
6464
  "category": "Feedback",
@@ -6012,7 +6498,17 @@
6012
6498
  ],
6013
6499
  "propConstraints": {},
6014
6500
  "requiredProps": [],
6015
- "a11yRules": []
6501
+ "a11yRules": [],
6502
+ "storyFiles": [
6503
+ "src/stories/toast.stories.tsx"
6504
+ ],
6505
+ "storyIds": [
6506
+ "primitives-toast--danger",
6507
+ "primitives-toast--default",
6508
+ "primitives-toast--info",
6509
+ "primitives-toast--success",
6510
+ "primitives-toast--warning"
6511
+ ]
6016
6512
  },
6017
6513
  "Combobox": {
6018
6514
  "category": "Inputs",
@@ -6081,7 +6577,17 @@
6081
6577
  ],
6082
6578
  "propConstraints": {},
6083
6579
  "requiredProps": [],
6084
- "a11yRules": []
6580
+ "a11yRules": [],
6581
+ "storyFiles": [
6582
+ "src/stories/combobox.stories.tsx"
6583
+ ],
6584
+ "storyIds": [
6585
+ "primitives-combobox--default",
6586
+ "primitives-combobox--disabled-trigger",
6587
+ "primitives-combobox--few-options",
6588
+ "primitives-combobox--pre-selected",
6589
+ "primitives-combobox--with-disabled-option"
6590
+ ]
6085
6591
  },
6086
6592
  "Form": {
6087
6593
  "category": "Inputs",
@@ -6105,6 +6611,7 @@
6105
6611
  "src/form/hds-form.tsx",
6106
6612
  "src/form/index.ts",
6107
6613
  "src/form/use-hds-form.ts",
6614
+ "src/index.ts",
6108
6615
  "src/stories/form.stories.tsx",
6109
6616
  "src/stories/patterns-layout.stories.tsx"
6110
6617
  ],
@@ -6117,7 +6624,16 @@
6117
6624
  ],
6118
6625
  "propConstraints": {},
6119
6626
  "requiredProps": [],
6120
- "a11yRules": []
6627
+ "a11yRules": [],
6628
+ "storyFiles": [
6629
+ "src/stories/form.stories.tsx"
6630
+ ],
6631
+ "storyIds": [
6632
+ "patterns-form--controlled",
6633
+ "patterns-form--default",
6634
+ "patterns-form--with-description",
6635
+ "patterns-form--with-error"
6636
+ ]
6121
6637
  },
6122
6638
  "FormField": {
6123
6639
  "category": "Inputs",
@@ -6178,7 +6694,16 @@
6178
6694
  ],
6179
6695
  "propConstraints": {},
6180
6696
  "requiredProps": [],
6181
- "a11yRules": []
6697
+ "a11yRules": [],
6698
+ "storyFiles": [
6699
+ "src/stories/form.stories.tsx"
6700
+ ],
6701
+ "storyIds": [
6702
+ "patterns-form--controlled",
6703
+ "patterns-form--default",
6704
+ "patterns-form--with-description",
6705
+ "patterns-form--with-error"
6706
+ ]
6182
6707
  },
6183
6708
  "FormFieldShell": {
6184
6709
  "category": "Inputs",
@@ -6234,7 +6759,16 @@
6234
6759
  ],
6235
6760
  "propConstraints": {},
6236
6761
  "requiredProps": [],
6237
- "a11yRules": []
6762
+ "a11yRules": [],
6763
+ "storyFiles": [
6764
+ "src/stories/form.stories.tsx"
6765
+ ],
6766
+ "storyIds": [
6767
+ "patterns-form--controlled",
6768
+ "patterns-form--default",
6769
+ "patterns-form--with-description",
6770
+ "patterns-form--with-error"
6771
+ ]
6238
6772
  },
6239
6773
  "HdsThemeProvider": {
6240
6774
  "category": "Theming",
@@ -6306,7 +6840,9 @@
6306
6840
  ],
6307
6841
  "propConstraints": {},
6308
6842
  "requiredProps": [],
6309
- "a11yRules": []
6843
+ "a11yRules": [],
6844
+ "storyFiles": [],
6845
+ "storyIds": []
6310
6846
  },
6311
6847
  "AvatarGroup": {
6312
6848
  "category": "Display",
@@ -6349,7 +6885,15 @@
6349
6885
  ],
6350
6886
  "propConstraints": {},
6351
6887
  "requiredProps": [],
6352
- "a11yRules": []
6888
+ "a11yRules": [],
6889
+ "storyFiles": [
6890
+ "src/stories/avatar-group.stories.tsx"
6891
+ ],
6892
+ "storyIds": [
6893
+ "primitives-avatar-group--default",
6894
+ "primitives-avatar-group--sizes",
6895
+ "primitives-avatar-group--with-overflow"
6896
+ ]
6353
6897
  },
6354
6898
  "Blockquote": {
6355
6899
  "category": "Typography",
@@ -6394,7 +6938,15 @@
6394
6938
  ],
6395
6939
  "propConstraints": {},
6396
6940
  "requiredProps": [],
6397
- "a11yRules": []
6941
+ "a11yRules": [],
6942
+ "storyFiles": [
6943
+ "src/stories/blockquote.stories.tsx"
6944
+ ],
6945
+ "storyIds": [
6946
+ "primitives-blockquote--default",
6947
+ "primitives-blockquote--sizes",
6948
+ "primitives-blockquote--with-attribution"
6949
+ ]
6398
6950
  },
6399
6951
  "ButtonGroup": {
6400
6952
  "category": "Actions",
@@ -6434,7 +6986,14 @@
6434
6986
  ],
6435
6987
  "propConstraints": {},
6436
6988
  "requiredProps": [],
6437
- "a11yRules": []
6989
+ "a11yRules": [],
6990
+ "storyFiles": [
6991
+ "src/stories/button-group.stories.tsx"
6992
+ ],
6993
+ "storyIds": [
6994
+ "primitives-button-group--default",
6995
+ "primitives-button-group--vertical"
6996
+ ]
6438
6997
  },
6439
6998
  "InputGroup": {
6440
6999
  "category": "Inputs",
@@ -6487,7 +7046,14 @@
6487
7046
  ],
6488
7047
  "propConstraints": {},
6489
7048
  "requiredProps": [],
6490
- "a11yRules": []
7049
+ "a11yRules": [],
7050
+ "storyFiles": [
7051
+ "src/stories/input-group.stories.tsx"
7052
+ ],
7053
+ "storyIds": [
7054
+ "primitives-input-group--default",
7055
+ "primitives-input-group--with-adornments"
7056
+ ]
6491
7057
  },
6492
7058
  "Kbd": {
6493
7059
  "category": "Display",
@@ -6528,7 +7094,15 @@
6528
7094
  ],
6529
7095
  "propConstraints": {},
6530
7096
  "requiredProps": [],
6531
- "a11yRules": []
7097
+ "a11yRules": [],
7098
+ "storyFiles": [
7099
+ "src/stories/kbd.stories.tsx"
7100
+ ],
7101
+ "storyIds": [
7102
+ "primitives-kbd--combination",
7103
+ "primitives-kbd--default",
7104
+ "primitives-kbd--sizes"
7105
+ ]
6532
7106
  },
6533
7107
  "StatusDot": {
6534
7108
  "category": "Feedback",
@@ -6585,7 +7159,15 @@
6585
7159
  ],
6586
7160
  "propConstraints": {},
6587
7161
  "requiredProps": [],
6588
- "a11yRules": []
7162
+ "a11yRules": [],
7163
+ "storyFiles": [
7164
+ "src/stories/status-dot.stories.tsx"
7165
+ ],
7166
+ "storyIds": [
7167
+ "primitives-status-dot--default",
7168
+ "primitives-status-dot--tones",
7169
+ "primitives-status-dot--with-label-text"
7170
+ ]
6589
7171
  },
6590
7172
  "Timestamp": {
6591
7173
  "category": "Display",
@@ -6638,7 +7220,14 @@
6638
7220
  ],
6639
7221
  "propConstraints": {},
6640
7222
  "requiredProps": [],
6641
- "a11yRules": []
7223
+ "a11yRules": [],
7224
+ "storyFiles": [
7225
+ "src/stories/timestamp.stories.tsx"
7226
+ ],
7227
+ "storyIds": [
7228
+ "primitives-timestamp--default",
7229
+ "primitives-timestamp--formats"
7230
+ ]
6642
7231
  },
6643
7232
  "VisuallyHidden": {
6644
7233
  "category": "Utility",
@@ -6674,7 +7263,13 @@
6674
7263
  ],
6675
7264
  "propConstraints": {},
6676
7265
  "requiredProps": [],
6677
- "a11yRules": []
7266
+ "a11yRules": [],
7267
+ "storyFiles": [
7268
+ "src/stories/visually-hidden.stories.tsx"
7269
+ ],
7270
+ "storyIds": [
7271
+ "primitives-visually-hidden--default"
7272
+ ]
6678
7273
  },
6679
7274
  "CircularProgress": {
6680
7275
  "category": "Feedback",
@@ -6731,7 +7326,16 @@
6731
7326
  ],
6732
7327
  "propConstraints": {},
6733
7328
  "requiredProps": [],
6734
- "a11yRules": []
7329
+ "a11yRules": [],
7330
+ "storyFiles": [
7331
+ "src/stories/circular-progress.stories.tsx"
7332
+ ],
7333
+ "storyIds": [
7334
+ "primitives-circular-progress--default",
7335
+ "primitives-circular-progress--indeterminate",
7336
+ "primitives-circular-progress--sizes",
7337
+ "primitives-circular-progress--tones"
7338
+ ]
6735
7339
  },
6736
7340
  "SideNav": {
6737
7341
  "category": "Navigation",
@@ -6744,6 +7348,8 @@
6744
7348
  "figmaId": null,
6745
7349
  "consumers": [
6746
7350
  "src/app/components/side-nav.test.tsx",
7351
+ "src/app/layouts/HdsDocsShell.tsx",
7352
+ "src/index.ts",
6747
7353
  "src/stories/side-nav.stories.tsx"
6748
7354
  ],
6749
7355
  "tokenMapping": {},
@@ -6762,7 +7368,16 @@
6762
7368
  "docExempt": false,
6763
7369
  "variantAxes": [],
6764
7370
  "componentProperties": [],
6765
- "figmaLink": "https://www.figma.com/design/c8MaVgwxOlxm4wr8wnH0Z4/HDS-Tokens-Components?node-id=86-332"
7371
+ "figmaLink": "https://www.figma.com/design/c8MaVgwxOlxm4wr8wnH0Z4/HDS-Tokens-Components?node-id=86-332",
7372
+ "storyFiles": [
7373
+ "src/stories/side-nav.stories.tsx"
7374
+ ],
7375
+ "storyIds": [
7376
+ "navigation-side-nav--disabled",
7377
+ "navigation-side-nav--nested-active",
7378
+ "navigation-side-nav--root",
7379
+ "navigation-side-nav--sidebar-group"
7380
+ ]
6766
7381
  },
6767
7382
  "CommandPalette": {
6768
7383
  "category": "Overlays",
@@ -6783,6 +7398,7 @@
6783
7398
  "consumers": [
6784
7399
  "src/app/data/nav-model.test.ts",
6785
7400
  "src/app/lib/hds-search.ts",
7401
+ "src/index.ts",
6786
7402
  "src/stories/command-palette.stories.tsx"
6787
7403
  ],
6788
7404
  "tokenMapping": {},
@@ -6799,7 +7415,13 @@
6799
7415
  ],
6800
7416
  "propConstraints": {},
6801
7417
  "requiredProps": [],
6802
- "a11yRules": []
7418
+ "a11yRules": [],
7419
+ "storyFiles": [
7420
+ "src/stories/command-palette.stories.tsx"
7421
+ ],
7422
+ "storyIds": [
7423
+ "primitives-command-palette--default"
7424
+ ]
6803
7425
  },
6804
7426
  "Lightbox": {
6805
7427
  "category": "Overlays",
@@ -6820,6 +7442,7 @@
6820
7442
  "consumers": [
6821
7443
  "src/app/components/image-lightbox.test.tsx",
6822
7444
  "src/app/data/hdsEditorial.tsx",
7445
+ "src/index.ts",
6823
7446
  "src/stories/asset-img.stories.tsx",
6824
7447
  "src/stories/image-lightbox.stories.tsx"
6825
7448
  ],
@@ -6866,7 +7489,13 @@
6866
7489
  ],
6867
7490
  "propConstraints": {},
6868
7491
  "requiredProps": [],
6869
- "a11yRules": []
7492
+ "a11yRules": [],
7493
+ "storyFiles": [
7494
+ "src/stories/image-lightbox.stories.tsx"
7495
+ ],
7496
+ "storyIds": [
7497
+ "primitives-image-lightbox--default"
7498
+ ]
6870
7499
  },
6871
7500
  "AppShell": {
6872
7501
  "category": "Layout",
@@ -6886,6 +7515,7 @@
6886
7515
  },
6887
7516
  "consumers": [
6888
7517
  "src/app/components/app-shell.test.tsx",
7518
+ "src/index.ts",
6889
7519
  "src/stories/app-shell.stories.tsx"
6890
7520
  ],
6891
7521
  "tokenMapping": {},
@@ -6897,7 +7527,15 @@
6897
7527
  ],
6898
7528
  "propConstraints": {},
6899
7529
  "requiredProps": [],
6900
- "a11yRules": []
7530
+ "a11yRules": [],
7531
+ "storyFiles": [
7532
+ "src/stories/app-shell.stories.tsx"
7533
+ ],
7534
+ "storyIds": [
7535
+ "patterns-app-shell--default",
7536
+ "patterns-app-shell--no-sidebar",
7537
+ "patterns-app-shell--wide-sidebar"
7538
+ ]
6901
7539
  },
6902
7540
  "FileInput": {
6903
7541
  "category": "Inputs",
@@ -6917,6 +7555,7 @@
6917
7555
  },
6918
7556
  "consumers": [
6919
7557
  "src/app/components/file-input.test.tsx",
7558
+ "src/index.ts",
6920
7559
  "src/stories/file-input.stories.tsx"
6921
7560
  ],
6922
7561
  "tokenMapping": {},
@@ -6949,7 +7588,15 @@
6949
7588
  ],
6950
7589
  "propConstraints": {},
6951
7590
  "requiredProps": [],
6952
- "a11yRules": []
7591
+ "a11yRules": [],
7592
+ "storyFiles": [
7593
+ "src/stories/file-input.stories.tsx"
7594
+ ],
7595
+ "storyIds": [
7596
+ "patterns-file-input--default",
7597
+ "patterns-file-input--disabled",
7598
+ "patterns-file-input--multiple-images"
7599
+ ]
6953
7600
  },
6954
7601
  "MetadataList": {
6955
7602
  "category": "Display",
@@ -6992,7 +7639,15 @@
6992
7639
  ],
6993
7640
  "propConstraints": {},
6994
7641
  "requiredProps": [],
6995
- "a11yRules": []
7642
+ "a11yRules": [],
7643
+ "storyFiles": [
7644
+ "src/stories/metadata-list.stories.tsx"
7645
+ ],
7646
+ "storyIds": [
7647
+ "patterns-metadata-list--default",
7648
+ "patterns-metadata-list--divided",
7649
+ "patterns-metadata-list--horizontal"
7650
+ ]
6996
7651
  },
6997
7652
  "OverflowList": {
6998
7653
  "category": "Layout",
@@ -7012,6 +7667,7 @@
7012
7667
  },
7013
7668
  "consumers": [
7014
7669
  "src/app/components/overflow-list.test.tsx",
7670
+ "src/index.ts",
7015
7671
  "src/stories/overflow-list.stories.tsx"
7016
7672
  ],
7017
7673
  "tokenMapping": {},
@@ -7035,7 +7691,14 @@
7035
7691
  ],
7036
7692
  "propConstraints": {},
7037
7693
  "requiredProps": [],
7038
- "a11yRules": []
7694
+ "a11yRules": [],
7695
+ "storyFiles": [
7696
+ "src/stories/overflow-list.stories.tsx"
7697
+ ],
7698
+ "storyIds": [
7699
+ "patterns-overflow-list--default",
7700
+ "patterns-overflow-list--with-overflow"
7701
+ ]
7039
7702
  },
7040
7703
  "SelectableCard": {
7041
7704
  "category": "Actions",
@@ -7079,7 +7742,16 @@
7079
7742
  ],
7080
7743
  "propConstraints": {},
7081
7744
  "requiredProps": [],
7082
- "a11yRules": []
7745
+ "a11yRules": [],
7746
+ "storyFiles": [
7747
+ "src/stories/selectable-card.stories.tsx"
7748
+ ],
7749
+ "storyIds": [
7750
+ "patterns-selectable-card--default",
7751
+ "patterns-selectable-card--disabled",
7752
+ "patterns-selectable-card--plan-picker",
7753
+ "patterns-selectable-card--selected"
7754
+ ]
7083
7755
  },
7084
7756
  "Tokenizer": {
7085
7757
  "category": "Inputs",
@@ -7129,7 +7801,15 @@
7129
7801
  ],
7130
7802
  "propConstraints": {},
7131
7803
  "requiredProps": [],
7132
- "a11yRules": []
7804
+ "a11yRules": [],
7805
+ "storyFiles": [
7806
+ "src/stories/tokenizer.stories.tsx"
7807
+ ],
7808
+ "storyIds": [
7809
+ "patterns-tokenizer--default",
7810
+ "patterns-tokenizer--disabled",
7811
+ "patterns-tokenizer--empty"
7812
+ ]
7133
7813
  },
7134
7814
  "TopNav": {
7135
7815
  "category": "Navigation",
@@ -7149,6 +7829,8 @@
7149
7829
  },
7150
7830
  "consumers": [
7151
7831
  "src/app/components/top-nav.test.tsx",
7832
+ "src/app/layouts/HdsDocsShell.tsx",
7833
+ "src/index.ts",
7152
7834
  "src/stories/top-nav.stories.tsx"
7153
7835
  ],
7154
7836
  "tokenMapping": {},
@@ -7177,7 +7859,14 @@
7177
7859
  ],
7178
7860
  "propConstraints": {},
7179
7861
  "requiredProps": [],
7180
- "a11yRules": []
7862
+ "a11yRules": [],
7863
+ "storyFiles": [
7864
+ "src/stories/top-nav.stories.tsx"
7865
+ ],
7866
+ "storyIds": [
7867
+ "patterns-top-nav--default",
7868
+ "patterns-top-nav--sticky"
7869
+ ]
7181
7870
  },
7182
7871
  "Carousel": {
7183
7872
  "category": "Display",
@@ -7197,6 +7886,7 @@
7197
7886
  },
7198
7887
  "consumers": [
7199
7888
  "src/app/components/carousel.test.tsx",
7889
+ "src/index.ts",
7200
7890
  "src/stories/carousel.stories.tsx"
7201
7891
  ],
7202
7892
  "tokenMapping": {},
@@ -7220,7 +7910,14 @@
7220
7910
  ],
7221
7911
  "propConstraints": {},
7222
7912
  "requiredProps": [],
7223
- "a11yRules": []
7913
+ "a11yRules": [],
7914
+ "storyFiles": [
7915
+ "src/stories/carousel.stories.tsx"
7916
+ ],
7917
+ "storyIds": [
7918
+ "patterns-carousel--default",
7919
+ "patterns-carousel--no-controls"
7920
+ ]
7224
7921
  },
7225
7922
  "Stepper": {
7226
7923
  "category": "Navigation",
@@ -7240,6 +7937,7 @@
7240
7937
  },
7241
7938
  "consumers": [
7242
7939
  "src/app/components/stepper.test.tsx",
7940
+ "src/index.ts",
7243
7941
  "src/stories/stepper.stories.tsx"
7244
7942
  ],
7245
7943
  "tokenMapping": {},
@@ -7266,7 +7964,14 @@
7266
7964
  ],
7267
7965
  "propConstraints": {},
7268
7966
  "requiredProps": [],
7269
- "a11yRules": []
7967
+ "a11yRules": [],
7968
+ "storyFiles": [
7969
+ "src/stories/stepper.stories.tsx"
7970
+ ],
7971
+ "storyIds": [
7972
+ "patterns-stepper--default",
7973
+ "patterns-stepper--vertical"
7974
+ ]
7270
7975
  },
7271
7976
  "Toolbar": {
7272
7977
  "category": "Actions",
@@ -7286,6 +7991,7 @@
7286
7991
  },
7287
7992
  "consumers": [
7288
7993
  "src/app/components/toolbar.test.tsx",
7994
+ "src/index.ts",
7289
7995
  "src/stories/toolbar.stories.tsx"
7290
7996
  ],
7291
7997
  "tokenMapping": {},
@@ -7302,7 +8008,13 @@
7302
8008
  ],
7303
8009
  "propConstraints": {},
7304
8010
  "requiredProps": [],
7305
- "a11yRules": []
8011
+ "a11yRules": [],
8012
+ "storyFiles": [
8013
+ "src/stories/toolbar.stories.tsx"
8014
+ ],
8015
+ "storyIds": [
8016
+ "patterns-toolbar--default"
8017
+ ]
7306
8018
  },
7307
8019
  "TreeList": {
7308
8020
  "category": "Navigation",
@@ -7322,6 +8034,7 @@
7322
8034
  },
7323
8035
  "consumers": [
7324
8036
  "src/app/components/tree-list.test.tsx",
8037
+ "src/index.ts",
7325
8038
  "src/stories/tree-list.stories.tsx"
7326
8039
  ],
7327
8040
  "tokenMapping": {},
@@ -7345,7 +8058,14 @@
7345
8058
  ],
7346
8059
  "propConstraints": {},
7347
8060
  "requiredProps": [],
7348
- "a11yRules": []
8061
+ "a11yRules": [],
8062
+ "storyFiles": [
8063
+ "src/stories/tree-list.stories.tsx"
8064
+ ],
8065
+ "storyIds": [
8066
+ "patterns-tree-list--default",
8067
+ "patterns-tree-list--with-default-expanded"
8068
+ ]
7349
8069
  },
7350
8070
  "AlertDialog": {
7351
8071
  "category": "Overlays",
@@ -7376,7 +8096,13 @@
7376
8096
  ],
7377
8097
  "propConstraints": {},
7378
8098
  "requiredProps": [],
7379
- "a11yRules": []
8099
+ "a11yRules": [],
8100
+ "storyFiles": [
8101
+ "src/stories/alert-dialog.stories.tsx"
8102
+ ],
8103
+ "storyIds": [
8104
+ "primitives-alert-dialog--default"
8105
+ ]
7380
8106
  },
7381
8107
  "AspectRatio": {
7382
8108
  "category": "Layout",
@@ -7418,7 +8144,14 @@
7418
8144
  ],
7419
8145
  "propConstraints": {},
7420
8146
  "requiredProps": [],
7421
- "a11yRules": []
8147
+ "a11yRules": [],
8148
+ "storyFiles": [
8149
+ "src/stories/aspect-ratio.stories.tsx"
8150
+ ],
8151
+ "storyIds": [
8152
+ "primitives-aspect-ratio--square",
8153
+ "primitives-aspect-ratio--widescreen"
8154
+ ]
7422
8155
  },
7423
8156
  "Calendar": {
7424
8157
  "category": "Inputs",
@@ -7441,6 +8174,7 @@
7441
8174
  "src/app/components/date-input.tsx",
7442
8175
  "src/app/components/date-range-input.tsx",
7443
8176
  "src/app/components/date-time-input.tsx",
8177
+ "src/index.ts",
7444
8178
  "src/stories/calendar.stories.tsx",
7445
8179
  "src/stories/date-input.stories.tsx",
7446
8180
  "src/stories/date-range-input.stories.tsx",
@@ -7455,7 +8189,14 @@
7455
8189
  ],
7456
8190
  "propConstraints": {},
7457
8191
  "requiredProps": [],
7458
- "a11yRules": []
8192
+ "a11yRules": [],
8193
+ "storyFiles": [
8194
+ "src/stories/calendar.stories.tsx"
8195
+ ],
8196
+ "storyIds": [
8197
+ "primitives-calendar--range",
8198
+ "primitives-calendar--single"
8199
+ ]
7459
8200
  },
7460
8201
  "ContextMenu": {
7461
8202
  "category": "Overlays",
@@ -7486,7 +8227,13 @@
7486
8227
  ],
7487
8228
  "propConstraints": {},
7488
8229
  "requiredProps": [],
7489
- "a11yRules": []
8230
+ "a11yRules": [],
8231
+ "storyFiles": [
8232
+ "src/stories/context-menu.stories.tsx"
8233
+ ],
8234
+ "storyIds": [
8235
+ "primitives-context-menu--default"
8236
+ ]
7490
8237
  },
7491
8238
  "DateInput": {
7492
8239
  "category": "Inputs",
@@ -7546,7 +8293,14 @@
7546
8293
  ],
7547
8294
  "propConstraints": {},
7548
8295
  "requiredProps": [],
7549
- "a11yRules": []
8296
+ "a11yRules": [],
8297
+ "storyFiles": [
8298
+ "src/stories/date-input.stories.tsx"
8299
+ ],
8300
+ "storyIds": [
8301
+ "patterns-date-input--default",
8302
+ "patterns-date-input--with-initial-value"
8303
+ ]
7550
8304
  },
7551
8305
  "DateRangeInput": {
7552
8306
  "category": "Inputs",
@@ -7610,7 +8364,15 @@
7610
8364
  ],
7611
8365
  "propConstraints": {},
7612
8366
  "requiredProps": [],
7613
- "a11yRules": []
8367
+ "a11yRules": [],
8368
+ "storyFiles": [
8369
+ "src/stories/date-range-input.stories.tsx"
8370
+ ],
8371
+ "storyIds": [
8372
+ "patterns-date-range-input--default",
8373
+ "patterns-date-range-input--disabled-trigger",
8374
+ "patterns-date-range-input--pre-selected"
8375
+ ]
7614
8376
  },
7615
8377
  "DateTimeInput": {
7616
8378
  "category": "Inputs",
@@ -7666,7 +8428,14 @@
7666
8428
  ],
7667
8429
  "propConstraints": {},
7668
8430
  "requiredProps": [],
7669
- "a11yRules": []
8431
+ "a11yRules": [],
8432
+ "storyFiles": [
8433
+ "src/stories/date-time-input.stories.tsx"
8434
+ ],
8435
+ "storyIds": [
8436
+ "patterns-date-time-input--default",
8437
+ "patterns-date-time-input--with-initial-value"
8438
+ ]
7670
8439
  },
7671
8440
  "HoverCard": {
7672
8441
  "category": "Overlays",
@@ -7697,7 +8466,13 @@
7697
8466
  ],
7698
8467
  "propConstraints": {},
7699
8468
  "requiredProps": [],
7700
- "a11yRules": []
8469
+ "a11yRules": [],
8470
+ "storyFiles": [
8471
+ "src/stories/hover-card.stories.tsx"
8472
+ ],
8473
+ "storyIds": [
8474
+ "primitives-hover-card--default"
8475
+ ]
7701
8476
  },
7702
8477
  "MultiSelector": {
7703
8478
  "category": "Inputs",
@@ -7750,7 +8525,15 @@
7750
8525
  ],
7751
8526
  "propConstraints": {},
7752
8527
  "requiredProps": [],
7753
- "a11yRules": []
8528
+ "a11yRules": [],
8529
+ "storyFiles": [
8530
+ "src/stories/multi-selector.stories.tsx"
8531
+ ],
8532
+ "storyIds": [
8533
+ "patterns-multi-selector--default",
8534
+ "patterns-multi-selector--disabled-trigger",
8535
+ "patterns-multi-selector--pre-selected"
8536
+ ]
7754
8537
  },
7755
8538
  "TimeInput": {
7756
8539
  "category": "Inputs",
@@ -7793,7 +8576,14 @@
7793
8576
  ],
7794
8577
  "propConstraints": {},
7795
8578
  "requiredProps": [],
7796
- "a11yRules": []
8579
+ "a11yRules": [],
8580
+ "storyFiles": [
8581
+ "src/stories/time-input.stories.tsx"
8582
+ ],
8583
+ "storyIds": [
8584
+ "primitives-time-input--default",
8585
+ "primitives-time-input--sizes"
8586
+ ]
7797
8587
  },
7798
8588
  "ToggleButton": {
7799
8589
  "category": "Actions",
@@ -7846,7 +8636,15 @@
7846
8636
  ],
7847
8637
  "propConstraints": {},
7848
8638
  "requiredProps": [],
7849
- "a11yRules": []
8639
+ "a11yRules": [],
8640
+ "storyFiles": [
8641
+ "src/stories/toggle-button.stories.tsx"
8642
+ ],
8643
+ "storyIds": [
8644
+ "primitives-toggle-button--default",
8645
+ "primitives-toggle-button--pressed",
8646
+ "primitives-toggle-button--variants"
8647
+ ]
7850
8648
  },
7851
8649
  "Box": {
7852
8650
  "category": "Layout",
@@ -7901,7 +8699,18 @@
7901
8699
  ],
7902
8700
  "propConstraints": {},
7903
8701
  "requiredProps": [],
7904
- "a11yRules": []
8702
+ "a11yRules": [],
8703
+ "storyFiles": [
8704
+ "src/stories/box.stories.tsx"
8705
+ ],
8706
+ "storyIds": [
8707
+ "primitives-box--ampersand-selectors",
8708
+ "primitives-box--ampersand-with-responsive",
8709
+ "primitives-box--polymorphic-as",
8710
+ "primitives-box--responsive-values",
8711
+ "primitives-box--spacing-shorthands",
8712
+ "primitives-box--token-colors"
8713
+ ]
7905
8714
  },
7906
8715
  "Bleed": {
7907
8716
  "category": "Layout",
@@ -7967,7 +8776,14 @@
7967
8776
  ],
7968
8777
  "propConstraints": {},
7969
8778
  "requiredProps": [],
7970
- "a11yRules": []
8779
+ "a11yRules": [],
8780
+ "storyFiles": [
8781
+ "src/stories/bleed.stories.tsx"
8782
+ ],
8783
+ "storyIds": [
8784
+ "primitives-bleed--bleed-both",
8785
+ "primitives-bleed--bleed-x"
8786
+ ]
7971
8787
  },
7972
8788
  "Center": {
7973
8789
  "category": "Layout",
@@ -8036,7 +8852,15 @@
8036
8852
  ],
8037
8853
  "propConstraints": {},
8038
8854
  "requiredProps": [],
8039
- "a11yRules": []
8855
+ "a11yRules": [],
8856
+ "storyFiles": [
8857
+ "src/stories/center.stories.tsx"
8858
+ ],
8859
+ "storyIds": [
8860
+ "primitives-center--content-width",
8861
+ "primitives-center--max-width",
8862
+ "primitives-center--with-gutter"
8863
+ ]
8040
8864
  },
8041
8865
  "Cluster": {
8042
8866
  "category": "Layout",
@@ -8115,7 +8939,15 @@
8115
8939
  ],
8116
8940
  "propConstraints": {},
8117
8941
  "requiredProps": [],
8118
- "a11yRules": []
8942
+ "a11yRules": [],
8943
+ "storyFiles": [
8944
+ "src/stories/cluster.stories.tsx"
8945
+ ],
8946
+ "storyIds": [
8947
+ "primitives-cluster--default",
8948
+ "primitives-cluster--space-between",
8949
+ "primitives-cluster--spacious-gap"
8950
+ ]
8119
8951
  },
8120
8952
  "Cover": {
8121
8953
  "category": "Layout",
@@ -8191,7 +9023,15 @@
8191
9023
  ],
8192
9024
  "propConstraints": {},
8193
9025
  "requiredProps": [],
8194
- "a11yRules": []
9026
+ "a11yRules": [],
9027
+ "storyFiles": [
9028
+ "src/stories/cover.stories.tsx"
9029
+ ],
9030
+ "storyIds": [
9031
+ "primitives-cover--header-main-footer",
9032
+ "primitives-cover--header-only",
9033
+ "primitives-cover--main-only"
9034
+ ]
8195
9035
  },
8196
9036
  "Frame": {
8197
9037
  "category": "Layout",
@@ -8253,7 +9093,15 @@
8253
9093
  ],
8254
9094
  "propConstraints": {},
8255
9095
  "requiredProps": [],
8256
- "a11yRules": []
9096
+ "a11yRules": [],
9097
+ "storyFiles": [
9098
+ "src/stories/frame.stories.tsx"
9099
+ ],
9100
+ "storyIds": [
9101
+ "primitives-frame--no-radius",
9102
+ "primitives-frame--square",
9103
+ "primitives-frame--widescreen"
9104
+ ]
8257
9105
  },
8258
9106
  "Sidebar": {
8259
9107
  "category": "Layout",
@@ -8333,7 +9181,15 @@
8333
9181
  ],
8334
9182
  "propConstraints": {},
8335
9183
  "requiredProps": [],
8336
- "a11yRules": []
9184
+ "a11yRules": [],
9185
+ "storyFiles": [
9186
+ "src/stories/sidebar.stories.tsx"
9187
+ ],
9188
+ "storyIds": [
9189
+ "primitives-sidebar--narrow-container-stacks",
9190
+ "primitives-sidebar--rail-end",
9191
+ "primitives-sidebar--rail-start"
9192
+ ]
8337
9193
  },
8338
9194
  "Switcher": {
8339
9195
  "category": "Layout",
@@ -8398,7 +9254,15 @@
8398
9254
  ],
8399
9255
  "propConstraints": {},
8400
9256
  "requiredProps": [],
8401
- "a11yRules": []
9257
+ "a11yRules": [],
9258
+ "storyFiles": [
9259
+ "src/stories/switcher.stories.tsx"
9260
+ ],
9261
+ "storyIds": [
9262
+ "primitives-switcher--default",
9263
+ "primitives-switcher--limit-forces-stacked",
9264
+ "primitives-switcher--narrow-container-stacks"
9265
+ ]
8402
9266
  },
8403
9267
  "Pin": {
8404
9268
  "category": "Layout",
@@ -8451,7 +9315,13 @@
8451
9315
  ],
8452
9316
  "propConstraints": {},
8453
9317
  "requiredProps": [],
8454
- "a11yRules": []
9318
+ "a11yRules": [],
9319
+ "storyFiles": [
9320
+ "src/stories/pin.stories.tsx"
9321
+ ],
9322
+ "storyIds": [
9323
+ "primitives-pin--sidebar"
9324
+ ]
8455
9325
  },
8456
9326
  "Reveal": {
8457
9327
  "category": "Motion",
@@ -8472,6 +9342,7 @@
8472
9342
  "consumers": [
8473
9343
  "src/app/components/pin.tsx",
8474
9344
  "src/app/components/reveal.test.tsx",
9345
+ "src/index.ts",
8475
9346
  "src/stories/patterns-scroll.stories.tsx",
8476
9347
  "src/stories/reveal.stories.tsx"
8477
9348
  ],
@@ -8510,7 +9381,18 @@
8510
9381
  ],
8511
9382
  "propConstraints": {},
8512
9383
  "requiredProps": [],
8513
- "a11yRules": []
9384
+ "a11yRules": [],
9385
+ "storyFiles": [
9386
+ "src/stories/patterns-scroll.stories.tsx",
9387
+ "src/stories/reveal.stories.tsx"
9388
+ ],
9389
+ "storyIds": [
9390
+ "patterns-scroll--pinned-scale-reveal",
9391
+ "patterns-scroll--reveal-sequence",
9392
+ "patterns-scroll--simple-parallax",
9393
+ "primitives-reveal--animations",
9394
+ "primitives-reveal--scale-reveal-scene"
9395
+ ]
8514
9396
  },
8515
9397
  "Textarea": {
8516
9398
  "category": "Inputs",
@@ -8573,7 +9455,17 @@
8573
9455
  ],
8574
9456
  "propConstraints": {},
8575
9457
  "requiredProps": [],
8576
- "a11yRules": []
9458
+ "a11yRules": [],
9459
+ "storyFiles": [
9460
+ "src/stories/textarea.stories.tsx"
9461
+ ],
9462
+ "storyIds": [
9463
+ "primitives-textarea--all-states",
9464
+ "primitives-textarea--default",
9465
+ "primitives-textarea--disabled",
9466
+ "primitives-textarea--error",
9467
+ "primitives-textarea--with-helper"
9468
+ ]
8577
9469
  },
8578
9470
  "CardBody": {
8579
9471
  "category": "Display",
@@ -8601,7 +9493,22 @@
8601
9493
  ],
8602
9494
  "propConstraints": {},
8603
9495
  "requiredProps": [],
8604
- "a11yRules": []
9496
+ "a11yRules": [],
9497
+ "storyFiles": [
9498
+ "src/stories/card.stories.tsx"
9499
+ ],
9500
+ "storyIds": [
9501
+ "primitives-card--bordered",
9502
+ "primitives-card--default",
9503
+ "primitives-card--elevated",
9504
+ "primitives-card--feedback-tones",
9505
+ "primitives-card--full-anatomy",
9506
+ "primitives-card--header-only",
9507
+ "primitives-card--metric-slot",
9508
+ "primitives-card--padding-variants",
9509
+ "primitives-card--progress-slot",
9510
+ "primitives-card--variant-accent"
9511
+ ]
8605
9512
  },
8606
9513
  "CardDescription": {
8607
9514
  "category": "Display",
@@ -8629,7 +9536,22 @@
8629
9536
  ],
8630
9537
  "propConstraints": {},
8631
9538
  "requiredProps": [],
8632
- "a11yRules": []
9539
+ "a11yRules": [],
9540
+ "storyFiles": [
9541
+ "src/stories/card.stories.tsx"
9542
+ ],
9543
+ "storyIds": [
9544
+ "primitives-card--bordered",
9545
+ "primitives-card--default",
9546
+ "primitives-card--elevated",
9547
+ "primitives-card--feedback-tones",
9548
+ "primitives-card--full-anatomy",
9549
+ "primitives-card--header-only",
9550
+ "primitives-card--metric-slot",
9551
+ "primitives-card--padding-variants",
9552
+ "primitives-card--progress-slot",
9553
+ "primitives-card--variant-accent"
9554
+ ]
8633
9555
  },
8634
9556
  "CardFooter": {
8635
9557
  "category": "Display",
@@ -8657,7 +9579,22 @@
8657
9579
  ],
8658
9580
  "propConstraints": {},
8659
9581
  "requiredProps": [],
8660
- "a11yRules": []
9582
+ "a11yRules": [],
9583
+ "storyFiles": [
9584
+ "src/stories/card.stories.tsx"
9585
+ ],
9586
+ "storyIds": [
9587
+ "primitives-card--bordered",
9588
+ "primitives-card--default",
9589
+ "primitives-card--elevated",
9590
+ "primitives-card--feedback-tones",
9591
+ "primitives-card--full-anatomy",
9592
+ "primitives-card--header-only",
9593
+ "primitives-card--metric-slot",
9594
+ "primitives-card--padding-variants",
9595
+ "primitives-card--progress-slot",
9596
+ "primitives-card--variant-accent"
9597
+ ]
8661
9598
  },
8662
9599
  "CardHeader": {
8663
9600
  "category": "Display",
@@ -8690,7 +9627,22 @@
8690
9627
  ],
8691
9628
  "propConstraints": {},
8692
9629
  "requiredProps": [],
8693
- "a11yRules": []
9630
+ "a11yRules": [],
9631
+ "storyFiles": [
9632
+ "src/stories/card.stories.tsx"
9633
+ ],
9634
+ "storyIds": [
9635
+ "primitives-card--bordered",
9636
+ "primitives-card--default",
9637
+ "primitives-card--elevated",
9638
+ "primitives-card--feedback-tones",
9639
+ "primitives-card--full-anatomy",
9640
+ "primitives-card--header-only",
9641
+ "primitives-card--metric-slot",
9642
+ "primitives-card--padding-variants",
9643
+ "primitives-card--progress-slot",
9644
+ "primitives-card--variant-accent"
9645
+ ]
8694
9646
  },
8695
9647
  "CardMetric": {
8696
9648
  "category": "Display",
@@ -8740,7 +9692,22 @@
8740
9692
  ],
8741
9693
  "propConstraints": {},
8742
9694
  "requiredProps": [],
8743
- "a11yRules": []
9695
+ "a11yRules": [],
9696
+ "storyFiles": [
9697
+ "src/stories/card.stories.tsx"
9698
+ ],
9699
+ "storyIds": [
9700
+ "primitives-card--bordered",
9701
+ "primitives-card--default",
9702
+ "primitives-card--elevated",
9703
+ "primitives-card--feedback-tones",
9704
+ "primitives-card--full-anatomy",
9705
+ "primitives-card--header-only",
9706
+ "primitives-card--metric-slot",
9707
+ "primitives-card--padding-variants",
9708
+ "primitives-card--progress-slot",
9709
+ "primitives-card--variant-accent"
9710
+ ]
8744
9711
  },
8745
9712
  "CardProgress": {
8746
9713
  "category": "Display",
@@ -8791,7 +9758,22 @@
8791
9758
  ],
8792
9759
  "propConstraints": {},
8793
9760
  "requiredProps": [],
8794
- "a11yRules": []
9761
+ "a11yRules": [],
9762
+ "storyFiles": [
9763
+ "src/stories/card.stories.tsx"
9764
+ ],
9765
+ "storyIds": [
9766
+ "primitives-card--bordered",
9767
+ "primitives-card--default",
9768
+ "primitives-card--elevated",
9769
+ "primitives-card--feedback-tones",
9770
+ "primitives-card--full-anatomy",
9771
+ "primitives-card--header-only",
9772
+ "primitives-card--metric-slot",
9773
+ "primitives-card--padding-variants",
9774
+ "primitives-card--progress-slot",
9775
+ "primitives-card--variant-accent"
9776
+ ]
8795
9777
  },
8796
9778
  "CardTitle": {
8797
9779
  "category": "Display",
@@ -8819,7 +9801,22 @@
8819
9801
  ],
8820
9802
  "propConstraints": {},
8821
9803
  "requiredProps": [],
8822
- "a11yRules": []
9804
+ "a11yRules": [],
9805
+ "storyFiles": [
9806
+ "src/stories/card.stories.tsx"
9807
+ ],
9808
+ "storyIds": [
9809
+ "primitives-card--bordered",
9810
+ "primitives-card--default",
9811
+ "primitives-card--elevated",
9812
+ "primitives-card--feedback-tones",
9813
+ "primitives-card--full-anatomy",
9814
+ "primitives-card--header-only",
9815
+ "primitives-card--metric-slot",
9816
+ "primitives-card--padding-variants",
9817
+ "primitives-card--progress-slot",
9818
+ "primitives-card--variant-accent"
9819
+ ]
8823
9820
  },
8824
9821
  "DialogClose": {
8825
9822
  "category": "Overlays",
@@ -8852,7 +9849,16 @@
8852
9849
  ],
8853
9850
  "propConstraints": {},
8854
9851
  "requiredProps": [],
8855
- "a11yRules": []
9852
+ "a11yRules": [],
9853
+ "storyFiles": [
9854
+ "src/stories/dialog.stories.tsx"
9855
+ ],
9856
+ "storyIds": [
9857
+ "primitives-dialog--default",
9858
+ "primitives-dialog--destructive",
9859
+ "primitives-dialog--information",
9860
+ "primitives-dialog--no-close-affordance"
9861
+ ]
8856
9862
  },
8857
9863
  "DialogContent": {
8858
9864
  "category": "Overlays",
@@ -8889,7 +9895,16 @@
8889
9895
  ],
8890
9896
  "propConstraints": {},
8891
9897
  "requiredProps": [],
8892
- "a11yRules": []
9898
+ "a11yRules": [],
9899
+ "storyFiles": [
9900
+ "src/stories/dialog.stories.tsx"
9901
+ ],
9902
+ "storyIds": [
9903
+ "primitives-dialog--default",
9904
+ "primitives-dialog--destructive",
9905
+ "primitives-dialog--information",
9906
+ "primitives-dialog--no-close-affordance"
9907
+ ]
8893
9908
  },
8894
9909
  "DialogDescription": {
8895
9910
  "category": "Overlays",
@@ -8922,7 +9937,16 @@
8922
9937
  ],
8923
9938
  "propConstraints": {},
8924
9939
  "requiredProps": [],
8925
- "a11yRules": []
9940
+ "a11yRules": [],
9941
+ "storyFiles": [
9942
+ "src/stories/dialog.stories.tsx"
9943
+ ],
9944
+ "storyIds": [
9945
+ "primitives-dialog--default",
9946
+ "primitives-dialog--destructive",
9947
+ "primitives-dialog--information",
9948
+ "primitives-dialog--no-close-affordance"
9949
+ ]
8926
9950
  },
8927
9951
  "DialogFooter": {
8928
9952
  "category": "Overlays",
@@ -8950,7 +9974,16 @@
8950
9974
  ],
8951
9975
  "propConstraints": {},
8952
9976
  "requiredProps": [],
8953
- "a11yRules": []
9977
+ "a11yRules": [],
9978
+ "storyFiles": [
9979
+ "src/stories/dialog.stories.tsx"
9980
+ ],
9981
+ "storyIds": [
9982
+ "primitives-dialog--default",
9983
+ "primitives-dialog--destructive",
9984
+ "primitives-dialog--information",
9985
+ "primitives-dialog--no-close-affordance"
9986
+ ]
8954
9987
  },
8955
9988
  "DialogHeader": {
8956
9989
  "category": "Overlays",
@@ -8978,7 +10011,16 @@
8978
10011
  ],
8979
10012
  "propConstraints": {},
8980
10013
  "requiredProps": [],
8981
- "a11yRules": []
10014
+ "a11yRules": [],
10015
+ "storyFiles": [
10016
+ "src/stories/dialog.stories.tsx"
10017
+ ],
10018
+ "storyIds": [
10019
+ "primitives-dialog--default",
10020
+ "primitives-dialog--destructive",
10021
+ "primitives-dialog--information",
10022
+ "primitives-dialog--no-close-affordance"
10023
+ ]
8982
10024
  },
8983
10025
  "DialogOverlay": {
8984
10026
  "category": "Overlays",
@@ -9011,7 +10053,16 @@
9011
10053
  ],
9012
10054
  "propConstraints": {},
9013
10055
  "requiredProps": [],
9014
- "a11yRules": []
10056
+ "a11yRules": [],
10057
+ "storyFiles": [
10058
+ "src/stories/dialog.stories.tsx"
10059
+ ],
10060
+ "storyIds": [
10061
+ "primitives-dialog--default",
10062
+ "primitives-dialog--destructive",
10063
+ "primitives-dialog--information",
10064
+ "primitives-dialog--no-close-affordance"
10065
+ ]
9015
10066
  },
9016
10067
  "DialogPortal": {
9017
10068
  "category": "Overlays",
@@ -9039,7 +10090,16 @@
9039
10090
  ],
9040
10091
  "propConstraints": {},
9041
10092
  "requiredProps": [],
9042
- "a11yRules": []
10093
+ "a11yRules": [],
10094
+ "storyFiles": [
10095
+ "src/stories/dialog.stories.tsx"
10096
+ ],
10097
+ "storyIds": [
10098
+ "primitives-dialog--default",
10099
+ "primitives-dialog--destructive",
10100
+ "primitives-dialog--information",
10101
+ "primitives-dialog--no-close-affordance"
10102
+ ]
9043
10103
  },
9044
10104
  "DialogTitle": {
9045
10105
  "category": "Overlays",
@@ -9072,7 +10132,16 @@
9072
10132
  ],
9073
10133
  "propConstraints": {},
9074
10134
  "requiredProps": [],
9075
- "a11yRules": []
10135
+ "a11yRules": [],
10136
+ "storyFiles": [
10137
+ "src/stories/dialog.stories.tsx"
10138
+ ],
10139
+ "storyIds": [
10140
+ "primitives-dialog--default",
10141
+ "primitives-dialog--destructive",
10142
+ "primitives-dialog--information",
10143
+ "primitives-dialog--no-close-affordance"
10144
+ ]
9076
10145
  },
9077
10146
  "DialogTrigger": {
9078
10147
  "category": "Overlays",
@@ -9105,38 +10174,57 @@
9105
10174
  ],
9106
10175
  "propConstraints": {},
9107
10176
  "requiredProps": [],
9108
- "a11yRules": []
10177
+ "a11yRules": [],
10178
+ "storyFiles": [
10179
+ "src/stories/dialog.stories.tsx"
10180
+ ],
10181
+ "storyIds": [
10182
+ "primitives-dialog--default",
10183
+ "primitives-dialog--destructive",
10184
+ "primitives-dialog--information",
10185
+ "primitives-dialog--no-close-affordance"
10186
+ ]
9109
10187
  },
9110
- "HdsTooltip": {
10188
+ "Tooltip": {
9111
10189
  "category": "Internal",
9112
10190
  "categorySource": "internal-jsdoc",
9113
10191
  "governedCategory": true,
9114
10192
  "hidden": true,
9115
10193
  "docExempt": true,
9116
10194
  "filePath": "src/app/components/hds-tooltip.tsx",
9117
- "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`.",
10195
+ "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`.",
9118
10196
  "figmaUrl": null,
9119
10197
  "figmaId": null,
9120
- "figmaLink": null,
9121
10198
  "tier": "primitive",
9122
10199
  "preview": {
9123
- "exportName": "HdsTooltip",
10200
+ "exportName": "Tooltip",
9124
10201
  "sizing": "panel"
9125
10202
  },
9126
10203
  "consumers": [
10204
+ "src/app/components/asset-img.tsx",
9127
10205
  "src/app/components/hover-card.tsx",
10206
+ "src/app/data/hdsEditorial.tsx",
10207
+ "src/index.ts",
9128
10208
  "src/stories/hds-tooltip.stories.tsx"
9129
10209
  ],
9130
10210
  "tokenMapping": {},
9131
10211
  "variantAxes": [],
9132
10212
  "componentProperties": [],
10213
+ "figmaLink": null,
9133
10214
  "props": {},
9134
10215
  "allowedChildren": [
9135
10216
  "*"
9136
10217
  ],
9137
10218
  "propConstraints": {},
9138
10219
  "requiredProps": [],
9139
- "a11yRules": []
10220
+ "a11yRules": [],
10221
+ "storyFiles": [
10222
+ "src/stories/hds-tooltip.stories.tsx"
10223
+ ],
10224
+ "storyIds": [
10225
+ "primitives-hds-tooltip--default",
10226
+ "primitives-hds-tooltip--placement"
10227
+ ]
9140
10228
  },
9141
10229
  "Menu": {
9142
10230
  "category": "Overlays",
@@ -9161,7 +10249,7 @@
9161
10249
  "src/app/components/hover-card.tsx",
9162
10250
  "src/app/components/menu.test.tsx",
9163
10251
  "src/app/components/multi-selector.tsx",
9164
- "src/app/components/shell-controls.tsx",
10252
+ "src/docs-tooling/shell-controls.tsx",
9165
10253
  "src/stories/menu.stories.tsx"
9166
10254
  ],
9167
10255
  "tokenMapping": {},
@@ -9173,7 +10261,16 @@
9173
10261
  ],
9174
10262
  "propConstraints": {},
9175
10263
  "requiredProps": [],
9176
- "a11yRules": []
10264
+ "a11yRules": [],
10265
+ "storyFiles": [
10266
+ "src/stories/menu.stories.tsx"
10267
+ ],
10268
+ "storyIds": [
10269
+ "primitives-menu--default",
10270
+ "primitives-menu--with-checkbox-items",
10271
+ "primitives-menu--with-radio-group",
10272
+ "primitives-menu--with-submenu"
10273
+ ]
9177
10274
  },
9178
10275
  "Popover": {
9179
10276
  "category": "Overlays",
@@ -9223,7 +10320,140 @@
9223
10320
  ],
9224
10321
  "propConstraints": {},
9225
10322
  "requiredProps": [],
9226
- "a11yRules": []
10323
+ "a11yRules": [],
10324
+ "storyFiles": [
10325
+ "src/stories/popover.stories.tsx"
10326
+ ],
10327
+ "storyIds": [
10328
+ "primitives-popover--aligned-start",
10329
+ "primitives-popover--default",
10330
+ "primitives-popover--info-tip",
10331
+ "primitives-popover--with-dismiss"
10332
+ ]
10333
+ },
10334
+ "HdsDocsShell": {
10335
+ "category": "Layout",
10336
+ "categorySource": "jsdoc",
10337
+ "governedCategory": true,
10338
+ "hidden": false,
10339
+ "docExempt": false,
10340
+ "filePath": "src/app/layouts/HdsDocsShell.tsx",
10341
+ "description": "HdsDocsShell — three-region docs shell (left nav rail, content, right TOC rail), driven by grid columns that default to 0 and are set per breakpoint. hds#280 slice: this is the SHELL MECHANICS ONLY — the smallest shippable piece of the docs-shell epic. It ships: - A 3-column grid (`leftRail | content | rightRail`), both rail columns defaulting to `0px` and set to `semantic.space.sidebar.railWidth` (hds#280 token, our own 280px — not HeroUI's 268px) per breakpoint via Tailwind's arbitrary-property + responsive-variant syntax, the same technique Fumadocs/HeroUI uses. `md768:` brings in the left rail, `xl1280:` brings in the right rail — matching the three-stage table in hds#280. - Each rail is `position: sticky` and scrolls independently of content and of the other rail, clipped to the viewport minus `topOffset`. - `topOffset` composes (it is one CSS length a caller supplies, e.g. its own sticky header's height token) rather than a hardcoded pixel value — the first stage of the row-cascade pattern hds#280 asks for. A second region (a tabs row, hds#280's PR-comment addendum) would extend this by adding its own height into the same `calc()` chain, not by hardcoding a second offset. Deliberately NOT in this slice (tracked as proposed follow-up issues, not filed — see the PR/commit this ships in): - Below the TOC breakpoint, `rightRail` is omitted from the grid rather than becoming a reachable popover. The DoD explicitly wants a popover, not \"merely hidden\" — that is real, separate UI work (a sticky current-section breadcrumb bar), not shell mechanics. - Left-rail collapsible groups (chevron, active-section pill) and right-rail active-anchor styling (vertical rule, filled pill) are content the caller supplies via `leftRail`/`rightRail` — this shell does not build SideNav/Disclosure/NavItem composition for the caller. - `check-rendered-geometry` verification at every breakpoint in the DoD's table (needs a built Storybook + a live run, not exercised here). - Named CSS `grid-template-areas` (the DoD's literal ask) — this ships a 3-column grid with DOM order instead, which is behaviorally identical for a single linear row of regions and needs no separate stylesheet. Areas earn their keep once a 4th region (a tabs row spanning full width) is added — call out then, not before.",
10342
+ "figmaUrl": null,
10343
+ "figmaId": null,
10344
+ "figmaLink": null,
10345
+ "tier": "pattern",
10346
+ "preview": {
10347
+ "exportName": "HdsDocsShell",
10348
+ "sizing": "panel"
10349
+ },
10350
+ "consumers": [
10351
+ "src/app/design-system/generated-token-descriptions.ts",
10352
+ "src/app/layouts/HdsDocsShell.test.tsx",
10353
+ "src/index.ts",
10354
+ "src/stories/hds-docs-shell.stories.tsx"
10355
+ ],
10356
+ "tokenMapping": {},
10357
+ "variantAxes": [],
10358
+ "componentProperties": [],
10359
+ "props": {
10360
+ "children": {
10361
+ "type": "ReactNode"
10362
+ },
10363
+ "className": {
10364
+ "type": "string",
10365
+ "optional": true
10366
+ },
10367
+ "leftRail": {
10368
+ "type": "ReactNode",
10369
+ "optional": true
10370
+ },
10371
+ "rightRail": {
10372
+ "type": "ReactNode",
10373
+ "optional": true
10374
+ },
10375
+ "style": {
10376
+ "type": "CSSProperties",
10377
+ "optional": true
10378
+ },
10379
+ "topOffset": {
10380
+ "type": "string",
10381
+ "default": "0px"
10382
+ }
10383
+ },
10384
+ "allowedChildren": [
10385
+ "*"
10386
+ ],
10387
+ "propConstraints": {},
10388
+ "requiredProps": [],
10389
+ "a11yRules": [],
10390
+ "storyFiles": [
10391
+ "src/stories/hds-docs-shell.stories.tsx"
10392
+ ],
10393
+ "storyIds": [
10394
+ "layout-hdsdocsshell--content-only",
10395
+ "layout-hdsdocsshell--default",
10396
+ "layout-hdsdocsshell--no-right-rail",
10397
+ "layout-hdsdocsshell--with-top-offset"
10398
+ ]
10399
+ },
10400
+ "Checkbox": {
10401
+ "category": "Inputs",
10402
+ "categorySource": "jsdoc",
10403
+ "governedCategory": true,
10404
+ "hidden": false,
10405
+ "docExempt": false,
10406
+ "filePath": "src/app/components/checkbox.tsx",
10407
+ "description": "Checkbox — custom-drawn checkbox with check / indeterminate glyph.",
10408
+ "figmaUrl": "https://www.figma.com/design/c8MaVgwxOlxm4wr8wnH0Z4/HDS-Tokens-Components?node-id=35-29",
10409
+ "figmaId": null,
10410
+ "figmaLink": "https://www.figma.com/design/c8MaVgwxOlxm4wr8wnH0Z4/HDS-Tokens-Components?node-id=35-29",
10411
+ "tier": "primitive",
10412
+ "preview": {
10413
+ "exportName": "Checkbox",
10414
+ "sizing": "panel"
10415
+ },
10416
+ "consumers": [
10417
+ "src/app/components/checkbox.test.tsx",
10418
+ "src/app/components/radio.tsx",
10419
+ "src/index.ts",
10420
+ "src/stories/checkbox.stories.tsx"
10421
+ ],
10422
+ "tokenMapping": {},
10423
+ "variantAxes": [],
10424
+ "componentProperties": [],
10425
+ "props": {
10426
+ "checked": {
10427
+ "type": "boolean"
10428
+ },
10429
+ "indeterminate": {
10430
+ "type": "boolean",
10431
+ "default": false
10432
+ },
10433
+ "label": {
10434
+ "type": "string"
10435
+ },
10436
+ "onChange": {
10437
+ "type": "(v: boolean) => void"
10438
+ }
10439
+ },
10440
+ "allowedChildren": [
10441
+ "*"
10442
+ ],
10443
+ "propConstraints": {},
10444
+ "requiredProps": [],
10445
+ "a11yRules": [],
10446
+ "storyFiles": [
10447
+ "src/stories/checkbox.stories.tsx"
10448
+ ],
10449
+ "storyIds": [
10450
+ "primitives-checkbox--checked",
10451
+ "primitives-checkbox--default",
10452
+ "primitives-checkbox--disabled",
10453
+ "primitives-checkbox--disabled-checked",
10454
+ "primitives-checkbox--group",
10455
+ "primitives-checkbox--indeterminate"
10456
+ ]
9227
10457
  },
9228
10458
  "HdsPhosphor": {
9229
10459
  "category": "Compiler",
@@ -9237,7 +10467,9 @@
9237
10467
  ],
9238
10468
  "propConstraints": {},
9239
10469
  "requiredProps": [],
9240
- "a11yRules": []
10470
+ "a11yRules": [],
10471
+ "storyFiles": [],
10472
+ "storyIds": []
9241
10473
  },
9242
10474
  "HdsFrame": {
9243
10475
  "category": "Compiler",
@@ -9251,7 +10483,9 @@
9251
10483
  ],
9252
10484
  "propConstraints": {},
9253
10485
  "requiredProps": [],
9254
- "a11yRules": []
10486
+ "a11yRules": [],
10487
+ "storyFiles": [],
10488
+ "storyIds": []
9255
10489
  },
9256
10490
  "HdsHeading": {
9257
10491
  "category": "Compiler",
@@ -9265,7 +10499,9 @@
9265
10499
  ],
9266
10500
  "propConstraints": {},
9267
10501
  "requiredProps": [],
9268
- "a11yRules": []
10502
+ "a11yRules": [],
10503
+ "storyFiles": [],
10504
+ "storyIds": []
9269
10505
  },
9270
10506
  "HdsLabel": {
9271
10507
  "category": "Compiler",
@@ -9279,7 +10515,9 @@
9279
10515
  ],
9280
10516
  "propConstraints": {},
9281
10517
  "requiredProps": [],
9282
- "a11yRules": []
10518
+ "a11yRules": [],
10519
+ "storyFiles": [],
10520
+ "storyIds": []
9283
10521
  },
9284
10522
  "HdsCaption": {
9285
10523
  "category": "Compiler",
@@ -9293,7 +10531,25 @@
9293
10531
  ],
9294
10532
  "propConstraints": {},
9295
10533
  "requiredProps": [],
9296
- "a11yRules": []
10534
+ "a11yRules": [],
10535
+ "storyFiles": [],
10536
+ "storyIds": []
10537
+ },
10538
+ "HdsCheckbox": {
10539
+ "category": "Compiler",
10540
+ "filePath": "scripts/hds-jsx-compiler.mjs",
10541
+ "description": "Compiler-recognized checkbox instance stub for generated JSX validation.",
10542
+ "hidden": true,
10543
+ "tier": "utility",
10544
+ "props": {},
10545
+ "allowedChildren": [
10546
+ "*"
10547
+ ],
10548
+ "propConstraints": {},
10549
+ "requiredProps": [],
10550
+ "a11yRules": [],
10551
+ "storyFiles": [],
10552
+ "storyIds": []
9297
10553
  },
9298
10554
  "HdsChip": {
9299
10555
  "category": "Compiler",
@@ -9307,7 +10563,9 @@
9307
10563
  ],
9308
10564
  "propConstraints": {},
9309
10565
  "requiredProps": [],
9310
- "a11yRules": []
10566
+ "a11yRules": [],
10567
+ "storyFiles": [],
10568
+ "storyIds": []
9311
10569
  },
9312
10570
  "HdsAvatar": {
9313
10571
  "category": "Compiler",
@@ -9321,7 +10579,9 @@
9321
10579
  ],
9322
10580
  "propConstraints": {},
9323
10581
  "requiredProps": [],
9324
- "a11yRules": []
10582
+ "a11yRules": [],
10583
+ "storyFiles": [],
10584
+ "storyIds": []
9325
10585
  }
9326
10586
  },
9327
10587
  "utilities": {
@@ -9597,11 +10857,12 @@
9597
10857
  "tokenMapping": {},
9598
10858
  "tier": "utility"
9599
10859
  },
9600
- "HdsChip": {
10860
+ "HdsCheckbox": {
9601
10861
  "category": "Compiler",
9602
10862
  "filePath": "scripts/hds-jsx-compiler.mjs",
9603
- "description": "Compiler-recognized chip instance stub for generated JSX validation.",
10863
+ "description": "Compiler-recognized checkbox instance stub for generated JSX validation.",
9604
10864
  "hidden": true,
10865
+ "tier": "utility",
9605
10866
  "props": {},
9606
10867
  "allowedChildren": [
9607
10868
  "*"
@@ -9609,14 +10870,13 @@
9609
10870
  "propConstraints": {},
9610
10871
  "requiredProps": [],
9611
10872
  "a11yRules": [],
9612
- "preview": {},
9613
- "tokenMapping": {},
9614
- "tier": "utility"
10873
+ "storyFiles": [],
10874
+ "storyIds": []
9615
10875
  },
9616
- "HdsAvatar": {
10876
+ "HdsChip": {
9617
10877
  "category": "Compiler",
9618
10878
  "filePath": "scripts/hds-jsx-compiler.mjs",
9619
- "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.",
10879
+ "description": "Compiler-recognized chip instance stub for generated JSX validation.",
9620
10880
  "hidden": true,
9621
10881
  "props": {},
9622
10882
  "allowedChildren": [
@@ -9629,47 +10889,11 @@
9629
10889
  "tokenMapping": {},
9630
10890
  "tier": "utility"
9631
10891
  },
9632
- "AutoPreviewSpecimen": {
9633
- "category": "Uncategorized",
9634
- "categorySource": "internal-jsdoc",
9635
- "governedCategory": true,
9636
- "hidden": true,
9637
- "docExempt": true,
9638
- "filePath": "src/app/components/componentPreviewRegistry.tsx",
9639
- "description": "/** @internal @doc-exempt: demo-preview-helper — not part of @hirobius/design-system public API.",
9640
- "figmaUrl": null,
9641
- "figmaId": null,
9642
- "figmaLink": null,
9643
- "tier": "utility",
9644
- "preview": {
9645
- "exportName": "AutoPreviewSpecimen",
9646
- "sizing": "panel"
9647
- },
9648
- "consumers": [
9649
- "src/app/components/specimen-block.tsx"
9650
- ],
9651
- "tokenMapping": {},
9652
- "variantAxes": [],
9653
- "componentProperties": []
9654
- },
9655
- "VariantPreviewDeck": {
9656
- "category": "Uncategorized",
9657
- "categorySource": "internal-jsdoc",
9658
- "governedCategory": true,
9659
- "hidden": true,
9660
- "filePath": "src/app/components/variant-preview-deck.tsx",
9661
- "description": "/** @internal @doc-exempt: demo-preview-helper — not part of @hirobius/design-system public API.",
9662
- "figmaUrl": null,
9663
- "figmaId": null,
9664
- "preview": {
9665
- "exportName": "VariantPreviewDeck",
9666
- "sizing": "panel"
9667
- },
9668
- "consumers": [
9669
- "src/app/components/componentPreviewRegistry.tsx",
9670
- "src/app/components/specimen-block.tsx"
9671
- ],
9672
- "tokenMapping": {},
10892
+ "HdsAvatar": {
10893
+ "category": "Compiler",
10894
+ "filePath": "scripts/hds-jsx-compiler.mjs",
10895
+ "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.",
10896
+ "hidden": true,
9673
10897
  "props": {},
9674
10898
  "allowedChildren": [
9675
10899
  "*"
@@ -9677,11 +10901,9 @@
9677
10901
  "propConstraints": {},
9678
10902
  "requiredProps": [],
9679
10903
  "a11yRules": [],
9680
- "tier": "utility",
9681
- "docExempt": true,
9682
- "variantAxes": [],
9683
- "componentProperties": [],
9684
- "figmaLink": null
10904
+ "preview": {},
10905
+ "tokenMapping": {},
10906
+ "tier": "utility"
9685
10907
  },
9686
10908
  "HistoryCard": {
9687
10909
  "category": "Uncategorized",
@@ -9697,7 +10919,6 @@
9697
10919
  "sizing": "panel"
9698
10920
  },
9699
10921
  "consumers": [
9700
- "src/app/components/componentPreviewRegistry.tsx",
9701
10922
  "src/stories/history-card.stories.tsx"
9702
10923
  ],
9703
10924
  "tokenMapping": {},
@@ -9727,7 +10948,7 @@
9727
10948
  "categorySource": "internal-jsdoc",
9728
10949
  "governedCategory": true,
9729
10950
  "hidden": true,
9730
- "filePath": "src/app/components/component-preview.tsx",
10951
+ "filePath": "src/docs-tooling/component-preview.tsx",
9731
10952
  "description": "ComponentPreview - framed preview harness for utility and lab specimens.",
9732
10953
  "figmaUrl": null,
9733
10954
  "figmaId": null,
@@ -9736,7 +10957,6 @@
9736
10957
  "sizing": "panel"
9737
10958
  },
9738
10959
  "consumers": [
9739
- "src/app/components/componentPreviewRegistry.tsx",
9740
10960
  "src/app/data/hdsEditorial.tsx"
9741
10961
  ],
9742
10962
  "tokenMapping": {},
@@ -9766,9 +10986,7 @@
9766
10986
  "exportName": "AnimatedLabel",
9767
10987
  "sizing": "compact"
9768
10988
  },
9769
- "consumers": [
9770
- "src/app/components/componentPreviewRegistry.tsx"
9771
- ],
10989
+ "consumers": [],
9772
10990
  "tokenMapping": {},
9773
10991
  "props": {},
9774
10992
  "allowedChildren": [
@@ -9788,7 +11006,7 @@
9788
11006
  "categorySource": "internal-jsdoc",
9789
11007
  "governedCategory": true,
9790
11008
  "hidden": true,
9791
- "filePath": "src/app/components/controls-panel.tsx",
11009
+ "filePath": "src/docs-tooling/controls-panel.tsx",
9792
11010
  "description": "shared shell composition documented alongside the HDS doc utilities.",
9793
11011
  "figmaUrl": null,
9794
11012
  "figmaId": null,
@@ -9797,7 +11015,6 @@
9797
11015
  "sizing": "panel"
9798
11016
  },
9799
11017
  "consumers": [
9800
- "src/app/components/componentPreviewRegistry.tsx",
9801
11018
  "src/app/data/hdsEditorial.tsx"
9802
11019
  ],
9803
11020
  "tokenMapping": {},
@@ -9819,7 +11036,7 @@
9819
11036
  "categorySource": "internal-jsdoc",
9820
11037
  "governedCategory": true,
9821
11038
  "hidden": true,
9822
- "filePath": "src/app/components/controls-panel.tsx",
11039
+ "filePath": "src/docs-tooling/controls-panel.tsx",
9823
11040
  "description": "shared shell composition documented alongside the HDS doc utilities.",
9824
11041
  "figmaUrl": null,
9825
11042
  "figmaId": null,
@@ -9828,7 +11045,6 @@
9828
11045
  "sizing": "panel"
9829
11046
  },
9830
11047
  "consumers": [
9831
- "src/app/components/componentPreviewRegistry.tsx",
9832
11048
  "src/app/data/hdsEditorial.tsx"
9833
11049
  ],
9834
11050
  "tokenMapping": {},
@@ -9850,7 +11066,7 @@
9850
11066
  "categorySource": "internal-jsdoc",
9851
11067
  "governedCategory": true,
9852
11068
  "hidden": true,
9853
- "filePath": "src/app/components/shell-controls.tsx",
11069
+ "filePath": "src/docs-tooling/shell-controls.tsx",
9854
11070
  "description": "shell-only extraction for HDS navigation chrome, not a consumer-facing reusable HDS component.",
9855
11071
  "figmaUrl": null,
9856
11072
  "figmaId": null,
@@ -9858,9 +11074,7 @@
9858
11074
  "exportName": "HdsMobileTopBar",
9859
11075
  "sizing": "panel"
9860
11076
  },
9861
- "consumers": [
9862
- "src/app/components/componentPreviewRegistry.tsx"
9863
- ],
11077
+ "consumers": [],
9864
11078
  "tokenMapping": {},
9865
11079
  "props": {},
9866
11080
  "allowedChildren": [
@@ -9880,7 +11094,7 @@
9880
11094
  "categorySource": "missing-jsdoc",
9881
11095
  "governedCategory": false,
9882
11096
  "hidden": false,
9883
- "filePath": "src/app/components/preview-frame.tsx",
11097
+ "filePath": "src/docs-tooling/preview-frame.tsx",
9884
11098
  "description": "PreviewFrame - documentation preview shell for storefront component demos.",
9885
11099
  "figmaUrl": null,
9886
11100
  "figmaId": null,
@@ -9889,9 +11103,7 @@
9889
11103
  "sizing": "panel"
9890
11104
  },
9891
11105
  "consumers": [
9892
- "src/app/components/componentPreviewRegistry.tsx",
9893
- "src/app/components/demo-block.tsx",
9894
- "src/app/components/specimen-block.tsx"
11106
+ "src/docs-tooling/demo-block.tsx"
9895
11107
  ],
9896
11108
  "tokenMapping": {},
9897
11109
  "props": {},
@@ -9912,7 +11124,7 @@
9912
11124
  "categorySource": "internal-jsdoc",
9913
11125
  "governedCategory": true,
9914
11126
  "hidden": true,
9915
- "filePath": "src/app/components/shell-controls.tsx",
11127
+ "filePath": "src/docs-tooling/shell-controls.tsx",
9916
11128
  "description": "shell-only extraction for HDS navigation chrome, not a consumer-facing reusable HDS component.",
9917
11129
  "figmaUrl": null,
9918
11130
  "figmaId": null,
@@ -9920,9 +11132,7 @@
9920
11132
  "exportName": "HdsSidebarUtilityButton",
9921
11133
  "sizing": "compact"
9922
11134
  },
9923
- "consumers": [
9924
- "src/app/components/componentPreviewRegistry.tsx"
9925
- ],
11135
+ "consumers": [],
9926
11136
  "tokenMapping": {},
9927
11137
  "props": {},
9928
11138
  "allowedChildren": [
@@ -9972,7 +11182,7 @@
9972
11182
  "categorySource": "internal-jsdoc",
9973
11183
  "governedCategory": true,
9974
11184
  "hidden": true,
9975
- "filePath": "src/app/components/sketch-controls.tsx",
11185
+ "filePath": "src/docs-tooling/sketch-controls.tsx",
9976
11186
  "description": "",
9977
11187
  "figmaUrl": null,
9978
11188
  "figmaId": null,
@@ -10000,7 +11210,7 @@
10000
11210
  "categorySource": "internal-jsdoc",
10001
11211
  "governedCategory": true,
10002
11212
  "hidden": true,
10003
- "filePath": "src/app/components/sketch-controls.tsx",
11213
+ "filePath": "src/docs-tooling/sketch-controls.tsx",
10004
11214
  "description": "",
10005
11215
  "figmaUrl": null,
10006
11216
  "figmaId": null,
@@ -10028,7 +11238,7 @@
10028
11238
  "categorySource": "internal-jsdoc",
10029
11239
  "governedCategory": true,
10030
11240
  "hidden": true,
10031
- "filePath": "src/app/components/sketch-controls.tsx",
11241
+ "filePath": "src/docs-tooling/sketch-controls.tsx",
10032
11242
  "description": "",
10033
11243
  "figmaUrl": null,
10034
11244
  "figmaId": null,
@@ -10056,7 +11266,7 @@
10056
11266
  "categorySource": "internal-jsdoc",
10057
11267
  "governedCategory": true,
10058
11268
  "hidden": true,
10059
- "filePath": "src/app/components/sketch-controls.tsx",
11269
+ "filePath": "src/docs-tooling/sketch-controls.tsx",
10060
11270
  "description": "",
10061
11271
  "figmaUrl": null,
10062
11272
  "figmaId": null,
@@ -10084,7 +11294,7 @@
10084
11294
  "categorySource": "internal-jsdoc",
10085
11295
  "governedCategory": true,
10086
11296
  "hidden": true,
10087
- "filePath": "src/app/components/sketch-controls.tsx",
11297
+ "filePath": "src/docs-tooling/sketch-controls.tsx",
10088
11298
  "description": "",
10089
11299
  "figmaUrl": null,
10090
11300
  "figmaId": null,
@@ -10107,53 +11317,6 @@
10107
11317
  "componentProperties": [],
10108
11318
  "figmaLink": null
10109
11319
  },
10110
- "MorphCard": {
10111
- "category": "Uncategorized",
10112
- "categorySource": "internal-jsdoc",
10113
- "governedCategory": true,
10114
- "hidden": true,
10115
- "docExempt": true,
10116
- "filePath": "src/app/components/morph-card.tsx",
10117
- "description": "",
10118
- "figmaUrl": null,
10119
- "figmaId": null,
10120
- "tier": "utility",
10121
- "preview": {
10122
- "exportName": "MorphCard",
10123
- "sizing": "panel"
10124
- },
10125
- "consumers": [],
10126
- "tokenMapping": {},
10127
- "variantAxes": [],
10128
- "componentProperties": [],
10129
- "figmaLink": null
10130
- },
10131
- "Tooltip": {
10132
- "category": "Uncategorized",
10133
- "categorySource": "internal-jsdoc",
10134
- "governedCategory": true,
10135
- "hidden": true,
10136
- "docExempt": true,
10137
- "filePath": "src/app/components/tooltip.tsx",
10138
- "description": "",
10139
- "figmaUrl": null,
10140
- "figmaId": null,
10141
- "tier": "utility",
10142
- "preview": {
10143
- "exportName": "Tooltip",
10144
- "sizing": "panel"
10145
- },
10146
- "consumers": [
10147
- "src/app/components/asset-img.tsx",
10148
- "src/app/components/hds-tooltip.tsx",
10149
- "src/app/data/hdsEditorial.tsx",
10150
- "src/stories/hds-tooltip.stories.tsx"
10151
- ],
10152
- "tokenMapping": {},
10153
- "variantAxes": [],
10154
- "componentProperties": [],
10155
- "figmaLink": null
10156
- },
10157
11320
  "NotFoundPattern": {
10158
11321
  "category": "Feedback",
10159
11322
  "categorySource": "internal-jsdoc",
@@ -10185,34 +11348,13 @@
10185
11348
  "docExempt": true,
10186
11349
  "figmaLink": null
10187
11350
  },
10188
- "CascadeText": {
10189
- "category": "Uncategorized",
10190
- "categorySource": "internal-jsdoc",
10191
- "governedCategory": true,
10192
- "hidden": true,
10193
- "docExempt": true,
10194
- "filePath": "src/app/components/CascadeText.tsx",
10195
- "description": "",
10196
- "figmaUrl": null,
10197
- "figmaId": null,
10198
- "tier": "utility",
10199
- "preview": {
10200
- "exportName": "CascadeText",
10201
- "sizing": "panel"
10202
- },
10203
- "consumers": [],
10204
- "tokenMapping": {},
10205
- "variantAxes": [],
10206
- "componentProperties": [],
10207
- "figmaLink": null
10208
- },
10209
11351
  "DocPageSpec": {
10210
11352
  "category": "Uncategorized",
10211
11353
  "categorySource": "internal-jsdoc",
10212
11354
  "governedCategory": true,
10213
11355
  "hidden": true,
10214
11356
  "docExempt": true,
10215
- "filePath": "src/app/components/DocPageSpec.tsx",
11357
+ "filePath": "src/docs-tooling/DocPageSpec.tsx",
10216
11358
  "description": "",
10217
11359
  "figmaUrl": null,
10218
11360
  "figmaId": null,
@@ -10233,7 +11375,7 @@
10233
11375
  "governedCategory": true,
10234
11376
  "hidden": true,
10235
11377
  "docExempt": true,
10236
- "filePath": "src/app/components/TokenDisplayToggle.tsx",
11378
+ "filePath": "src/docs-tooling/TokenDisplayToggle.tsx",
10237
11379
  "description": "",
10238
11380
  "figmaUrl": null,
10239
11381
  "figmaId": null,
@@ -10255,7 +11397,7 @@
10255
11397
  "categorySource": "missing-jsdoc",
10256
11398
  "governedCategory": false,
10257
11399
  "hidden": false,
10258
- "filePath": "src/app/components/lab/legacy-token-detail.tsx",
11400
+ "filePath": "src/docs-tooling/lab/legacy-token-detail.tsx",
10259
11401
  "description": "LegacyTokenDetail - lab-facing token inspection panels used to maintain legacy token views.",
10260
11402
  "figmaUrl": null,
10261
11403
  "figmaId": null,
@@ -10264,8 +11406,7 @@
10264
11406
  "sizing": "panel"
10265
11407
  },
10266
11408
  "consumers": [
10267
- "src/app/components/componentPreviewRegistry.tsx",
10268
- "src/app/components/health-rail.tsx"
11409
+ "src/docs-tooling/health-rail.tsx"
10269
11410
  ],
10270
11411
  "tokenMapping": {},
10271
11412
  "props": {
@@ -10301,7 +11442,7 @@
10301
11442
  "categorySource": "jsdoc",
10302
11443
  "governedCategory": true,
10303
11444
  "hidden": false,
10304
- "filePath": "src/app/components/lab/legacy-token-list.tsx",
11445
+ "filePath": "src/docs-tooling/lab/legacy-token-list.tsx",
10305
11446
  "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.",
10306
11447
  "figmaUrl": null,
10307
11448
  "figmaId": null,
@@ -10309,9 +11450,7 @@
10309
11450
  "exportName": "LegacyTokenList",
10310
11451
  "sizing": "panel"
10311
11452
  },
10312
- "consumers": [
10313
- "src/app/components/componentPreviewRegistry.tsx"
10314
- ],
11453
+ "consumers": [],
10315
11454
  "tokenMapping": {},
10316
11455
  "props": {
10317
11456
  "isDark": {
@@ -10347,7 +11486,7 @@
10347
11486
  "categorySource": "jsdoc",
10348
11487
  "governedCategory": true,
10349
11488
  "hidden": false,
10350
- "filePath": "src/app/components/lab/token-collection-list.tsx",
11489
+ "filePath": "src/docs-tooling/lab/token-collection-list.tsx",
10351
11490
  "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.",
10352
11491
  "figmaUrl": null,
10353
11492
  "figmaId": null,
@@ -10356,8 +11495,7 @@
10356
11495
  "sizing": "panel"
10357
11496
  },
10358
11497
  "consumers": [
10359
- "src/app/components/componentPreviewRegistry.tsx",
10360
- "src/app/components/lab/legacy-token-list.tsx"
11498
+ "src/docs-tooling/lab/legacy-token-list.tsx"
10361
11499
  ],
10362
11500
  "tokenMapping": {},
10363
11501
  "props": {
@@ -10388,7 +11526,7 @@
10388
11526
  "categorySource": "missing-jsdoc",
10389
11527
  "governedCategory": false,
10390
11528
  "hidden": false,
10391
- "filePath": "src/app/components/lab/token-list.tsx",
11529
+ "filePath": "src/docs-tooling/lab/token-list.tsx",
10392
11530
  "description": "TokenList - searchable token rail for interactive lab-side token inspection.",
10393
11531
  "figmaUrl": null,
10394
11532
  "figmaId": null,
@@ -10396,9 +11534,7 @@
10396
11534
  "exportName": "TokenList",
10397
11535
  "sizing": "panel"
10398
11536
  },
10399
- "consumers": [
10400
- "src/app/components/componentPreviewRegistry.tsx"
10401
- ],
11537
+ "consumers": [],
10402
11538
  "tokenMapping": {},
10403
11539
  "props": {},
10404
11540
  "allowedChildren": [
@@ -10444,7 +11580,7 @@
10444
11580
  "governedCategory": true,
10445
11581
  "hidden": false,
10446
11582
  "docExempt": true,
10447
- "filePath": "src/app/components/api-reference.tsx",
11583
+ "filePath": "src/docs-tooling/api-reference.tsx",
10448
11584
  "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).",
10449
11585
  "figmaUrl": null,
10450
11586
  "figmaId": null,
@@ -10465,7 +11601,7 @@
10465
11601
  "governedCategory": true,
10466
11602
  "hidden": true,
10467
11603
  "docExempt": false,
10468
- "filePath": "src/app/components/doc-page-header.tsx",
11604
+ "filePath": "src/docs-tooling/doc-page-header.tsx",
10469
11605
  "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.",
10470
11606
  "figmaUrl": null,
10471
11607
  "figmaId": null,
@@ -10475,7 +11611,9 @@
10475
11611
  "exportName": "DocPageHeader",
10476
11612
  "sizing": "panel"
10477
11613
  },
10478
- "consumers": [],
11614
+ "consumers": [
11615
+ "src/docs-tooling/doc-page-header.test.tsx"
11616
+ ],
10479
11617
  "tokenMapping": {},
10480
11618
  "variantAxes": [],
10481
11619
  "componentProperties": []
@@ -10486,7 +11624,7 @@
10486
11624
  "governedCategory": true,
10487
11625
  "hidden": true,
10488
11626
  "docExempt": false,
10489
- "filePath": "src/app/components/theme-toggle.tsx",
11627
+ "filePath": "src/docs-tooling/theme-toggle.tsx",
10490
11628
  "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.",
10491
11629
  "figmaUrl": null,
10492
11630
  "figmaId": null,
@@ -10509,7 +11647,7 @@
10509
11647
  "governedCategory": true,
10510
11648
  "hidden": true,
10511
11649
  "docExempt": true,
10512
- "filePath": "src/app/components/variant-strip.tsx",
11650
+ "filePath": "src/docs-tooling/variant-strip.tsx",
10513
11651
  "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.",
10514
11652
  "figmaUrl": null,
10515
11653
  "figmaId": null,
@@ -10530,7 +11668,7 @@
10530
11668
  "governedCategory": true,
10531
11669
  "hidden": true,
10532
11670
  "docExempt": true,
10533
- "filePath": "src/app/components/demo-block.tsx",
11671
+ "filePath": "src/docs-tooling/demo-block.tsx",
10534
11672
  "figmaUrl": null,
10535
11673
  "figmaId": null,
10536
11674
  "figmaLink": null,
@@ -10550,7 +11688,7 @@
10550
11688
  "governedCategory": true,
10551
11689
  "hidden": false,
10552
11690
  "docExempt": false,
10553
- "filePath": "src/app/components/page-footer.tsx",
11691
+ "filePath": "src/docs-tooling/page-footer.tsx",
10554
11692
  "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.",
10555
11693
  "figmaUrl": null,
10556
11694
  "figmaId": null,
@@ -10564,6 +11702,29 @@
10564
11702
  "tokenMapping": {},
10565
11703
  "variantAxes": [],
10566
11704
  "componentProperties": []
11705
+ },
11706
+ "ExpandTooltip": {
11707
+ "category": "Internal",
11708
+ "categorySource": "internal-jsdoc",
11709
+ "governedCategory": true,
11710
+ "hidden": true,
11711
+ "docExempt": true,
11712
+ "filePath": "src/app/components/tooltip.tsx",
11713
+ "figmaUrl": null,
11714
+ "figmaId": null,
11715
+ "figmaLink": null,
11716
+ "tier": "utility",
11717
+ "preview": {
11718
+ "exportName": "ExpandTooltip",
11719
+ "sizing": "panel"
11720
+ },
11721
+ "consumers": [
11722
+ "src/app/components/asset-img.tsx",
11723
+ "src/app/components/hds-tooltip.tsx"
11724
+ ],
11725
+ "tokenMapping": {},
11726
+ "variantAxes": [],
11727
+ "componentProperties": []
10567
11728
  }
10568
11729
  },
10569
11730
  "tokens": {
@@ -11194,79 +12355,75 @@
11194
12355
  "description": "Monospace face: Geist Mono. Falls back to Courier New, monospace.",
11195
12356
  "value": "\"Geist Mono\", \"Courier New\", monospace"
11196
12357
  },
11197
- {
11198
- "path": "primitive.typography.size.2xs",
11199
- "cssVar": "--primitive-typography-size-2xs",
11200
- "type": "dimension",
11201
- "value": "10px"
11202
- },
11203
12358
  {
11204
12359
  "path": "primitive.typography.size.xs",
11205
12360
  "cssVar": "--primitive-typography-size-xs",
11206
12361
  "type": "dimension",
11207
- "value": "13px"
12362
+ "description": "Tailwind 4 default text-xs (hds#283 ramp).",
12363
+ "value": "12px"
11208
12364
  },
11209
12365
  {
11210
12366
  "path": "primitive.typography.size.sm",
11211
12367
  "cssVar": "--primitive-typography-size-sm",
11212
12368
  "type": "dimension",
11213
- "value": "15px"
12369
+ "description": "Tailwind 4 default text-sm (hds#283 ramp).",
12370
+ "value": "14px"
11214
12371
  },
11215
12372
  {
11216
12373
  "path": "primitive.typography.size.base",
11217
12374
  "cssVar": "--primitive-typography-size-base",
11218
12375
  "type": "dimension",
11219
- "value": "17px"
12376
+ "description": "Tailwind 4 default text-base (hds#283 ramp).",
12377
+ "value": "16px"
11220
12378
  },
11221
12379
  {
11222
12380
  "path": "primitive.typography.size.lg",
11223
12381
  "cssVar": "--primitive-typography-size-lg",
11224
12382
  "type": "dimension",
11225
- "value": "20px"
12383
+ "description": "Tailwind 4 default text-lg (hds#283 ramp).",
12384
+ "value": "18px"
11226
12385
  },
11227
12386
  {
11228
12387
  "path": "primitive.typography.size.xl",
11229
12388
  "cssVar": "--primitive-typography-size-xl",
11230
12389
  "type": "dimension",
11231
- "value": "24px"
12390
+ "description": "Tailwind 4 default text-xl (hds#283 ramp).",
12391
+ "value": "20px"
11232
12392
  },
11233
12393
  {
11234
12394
  "path": "primitive.typography.size.2xl",
11235
12395
  "cssVar": "--primitive-typography-size-2xl",
11236
12396
  "type": "dimension",
11237
- "value": "30px"
12397
+ "description": "Tailwind 4 default text-2xl (hds#283 ramp).",
12398
+ "value": "24px"
11238
12399
  },
11239
12400
  {
11240
12401
  "path": "primitive.typography.size.3xl",
11241
12402
  "cssVar": "--primitive-typography-size-3xl",
11242
12403
  "type": "dimension",
11243
- "value": "36px"
12404
+ "description": "Tailwind 4 default text-3xl (hds#283 ramp).",
12405
+ "value": "30px"
11244
12406
  },
11245
12407
  {
11246
12408
  "path": "primitive.typography.size.4xl",
11247
12409
  "cssVar": "--primitive-typography-size-4xl",
11248
12410
  "type": "dimension",
11249
- "value": "48px"
12411
+ "description": "Tailwind 4 default text-4xl (hds#283 ramp).",
12412
+ "value": "36px"
11250
12413
  },
11251
12414
  {
11252
12415
  "path": "primitive.typography.size.5xl",
11253
12416
  "cssVar": "--primitive-typography-size-5xl",
11254
12417
  "type": "dimension",
11255
- "description": "Swiss-canon display size. Static desktop value; fluid in theme.css.",
11256
- "value": "72px"
12418
+ "description": "Tailwind 4 default text-5xl (hds#283 ramp).",
12419
+ "value": "48px"
11257
12420
  },
11258
12421
  {
11259
12422
  "path": "primitive.typography.size.6xl",
11260
12423
  "cssVar": "--primitive-typography-size-6xl",
11261
12424
  "type": "dimension",
11262
- "value": "80px"
11263
- },
11264
- {
11265
- "path": "primitive.typography.weight.light",
11266
- "cssVar": "--primitive-typography-weight-light",
11267
- "type": "fontWeight",
11268
- "description": "Swiss-canon heading weight. Display and h1/h2 composites only.",
11269
- "value": "300"
12425
+ "description": "Swiss-canon display size (hds#283 ramp). Static desktop value; fluid in theme.css. Tailwind 4 default text-6xl.",
12426
+ "value": "60px"
11270
12427
  },
11271
12428
  {
11272
12429
  "path": "primitive.typography.weight.regular",
@@ -11280,12 +12437,6 @@
11280
12437
  "type": "fontWeight",
11281
12438
  "value": "500"
11282
12439
  },
11283
- {
11284
- "path": "primitive.typography.weight.semibold",
11285
- "cssVar": "--primitive-typography-weight-semibold",
11286
- "type": "fontWeight",
11287
- "value": "600"
11288
- },
11289
12440
  {
11290
12441
  "path": "primitive.typography.weight.bold",
11291
12442
  "cssVar": "--primitive-typography-weight-bold",
@@ -11330,12 +12481,6 @@
11330
12481
  "description": "Swiss-canon relaxed rhythm (10t-5). Used by body/small/mono composites for long-form prose comfort.",
11331
12482
  "value": "1.625"
11332
12483
  },
11333
- {
11334
- "path": "primitive.typography.letterSpacing.tighter",
11335
- "cssVar": "--primitive-typography-letterSpacing-tighter",
11336
- "type": "dimension",
11337
- "value": "-0.02em"
11338
- },
11339
12484
  {
11340
12485
  "path": "primitive.typography.letterSpacing.tight",
11341
12486
  "cssVar": "--primitive-typography-letterSpacing-tight",
@@ -11348,18 +12493,6 @@
11348
12493
  "type": "dimension",
11349
12494
  "value": "0em"
11350
12495
  },
11351
- {
11352
- "path": "primitive.typography.letterSpacing.wide",
11353
- "cssVar": "--primitive-typography-letterSpacing-wide",
11354
- "type": "dimension",
11355
- "value": "0.01em"
11356
- },
11357
- {
11358
- "path": "primitive.typography.letterSpacing.wider",
11359
- "cssVar": "--primitive-typography-letterSpacing-wider",
11360
- "type": "dimension",
11361
- "value": "0.02em"
11362
- },
11363
12496
  {
11364
12497
  "path": "primitive.typography.letterSpacing.caps",
11365
12498
  "cssVar": "--primitive-typography-letterSpacing-caps",
@@ -11555,6 +12688,13 @@
11555
12688
  "description": "Minimum interactive hit target size.",
11556
12689
  "value": "44px"
11557
12690
  },
12691
+ {
12692
+ "path": "primitive.size.interactive.minCompact",
12693
+ "cssVar": "--primitive-size-interactive-minCompact",
12694
+ "type": "dimension",
12695
+ "description": "WCAG 2.2 AA (2.5.8) minimum target size for a compact inline control, such as a tokenizer chip's remove button, where the 44px AAA floor (2.5.5) does not apply.",
12696
+ "value": "24px"
12697
+ },
11558
12698
  {
11559
12699
  "path": "primitive.size.width.96",
11560
12700
  "cssVar": "--primitive-size-width-96",
@@ -11562,6 +12702,13 @@
11562
12702
  "description": "96px width step.",
11563
12703
  "value": "96px"
11564
12704
  },
12705
+ {
12706
+ "path": "primitive.size.width.280",
12707
+ "cssVar": "--primitive-size-width-280",
12708
+ "type": "dimension",
12709
+ "description": "Docs-shell rail width (hds#280). Our own number, not HeroUI's 268px — wide enough for the longest top-level nav label at the default type ramp with room to spare.",
12710
+ "value": "280px"
12711
+ },
11565
12712
  {
11566
12713
  "path": "primitive.size.width.760",
11567
12714
  "cssVar": "--primitive-size-width-760",
@@ -11682,6 +12829,14 @@
11682
12829
  "easing": "cubic-bezier(0.4, 0, 1, 1)"
11683
12830
  }
11684
12831
  },
12832
+ {
12833
+ "path": "semantic.motion.distance",
12834
+ "cssVar": "--semantic-motion-distance",
12835
+ "type": "dimension",
12836
+ "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).",
12837
+ "alias": "{primitive.space.6}",
12838
+ "resolvedValue": "24px"
12839
+ },
11685
12840
  {
11686
12841
  "path": "semantic.color.surface.page",
11687
12842
  "cssVar": "--semantic-color-surface-page",
@@ -12121,6 +13276,62 @@
12121
13276
  "resolvedValue": "#2e1065"
12122
13277
  }
12123
13278
  },
13279
+ {
13280
+ "path": "semantic.space.scale.xs",
13281
+ "cssVar": "--semantic-space-scale-xs",
13282
+ "type": "dimension",
13283
+ "description": "8px — smallest step. Same value as component.gap (deprecated alias).",
13284
+ "alias": "{primitive.space.2}",
13285
+ "resolvedValue": "8px"
13286
+ },
13287
+ {
13288
+ "path": "semantic.space.scale.sm",
13289
+ "cssVar": "--semantic-space-scale-sm",
13290
+ "type": "dimension",
13291
+ "description": "16px — same value as layout.tight (deprecated alias).",
13292
+ "alias": "{primitive.space.4}",
13293
+ "resolvedValue": "16px"
13294
+ },
13295
+ {
13296
+ "path": "semantic.space.scale.md",
13297
+ "cssVar": "--semantic-space-scale-md",
13298
+ "type": "dimension",
13299
+ "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.",
13300
+ "alias": "{primitive.space.6}",
13301
+ "resolvedValue": "24px"
13302
+ },
13303
+ {
13304
+ "path": "semantic.space.scale.lg",
13305
+ "cssVar": "--semantic-space-scale-lg",
13306
+ "type": "dimension",
13307
+ "description": "32px — same value as layout.inset (deprecated alias).",
13308
+ "alias": "{primitive.space.8}",
13309
+ "resolvedValue": "32px"
13310
+ },
13311
+ {
13312
+ "path": "semantic.space.scale.xl",
13313
+ "cssVar": "--semantic-space-scale-xl",
13314
+ "type": "dimension",
13315
+ "description": "48px — same value as layout.spacious (deprecated alias).",
13316
+ "alias": "{primitive.space.12}",
13317
+ "resolvedValue": "48px"
13318
+ },
13319
+ {
13320
+ "path": "semantic.space.surface.padding",
13321
+ "cssVar": "--semantic-space-surface-padding",
13322
+ "type": "dimension",
13323
+ "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.",
13324
+ "alias": "{semantic.space.scale.md}",
13325
+ "resolvedValue": "24px"
13326
+ },
13327
+ {
13328
+ "path": "semantic.space.region.gutter",
13329
+ "cssVar": "--semantic-space-region-gutter",
13330
+ "type": "dimension",
13331
+ "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.",
13332
+ "alias": "{semantic.space.scale.md}",
13333
+ "resolvedValue": "24px"
13334
+ },
12124
13335
  {
12125
13336
  "path": "semantic.space.subgrid.hairline",
12126
13337
  "cssVar": "--semantic-space-subgrid-hairline",
@@ -12149,7 +13360,7 @@
12149
13360
  "path": "semantic.space.component.gap",
12150
13361
  "cssVar": "--semantic-space-component-gap",
12151
13362
  "type": "dimension",
12152
- "description": "8px label↔input rhythm and closely coupled control spacing.",
13363
+ "description": "8px label↔input rhythm and closely coupled control spacing. DEPRECATED alias (hds#206) — use semantic.space.scale.xs; kept live, no removal yet.",
12153
13364
  "alias": "{primitive.space.2}",
12154
13365
  "resolvedValue": "8px"
12155
13366
  },
@@ -12165,15 +13376,15 @@
12165
13376
  "path": "semantic.space.component.padding",
12166
13377
  "cssVar": "--semantic-space-component-padding",
12167
13378
  "type": "dimension",
12168
- "description": "24px default inset for cards, forms, panels, and grouped surfaces.",
12169
- "alias": "{primitive.space.6}",
13379
+ "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.",
13380
+ "alias": "{semantic.space.surface.padding}",
12170
13381
  "resolvedValue": "24px"
12171
13382
  },
12172
13383
  {
12173
13384
  "path": "semantic.space.layout.tight",
12174
13385
  "cssVar": "--semantic-space-layout-tight",
12175
13386
  "type": "dimension",
12176
- "description": "16px default HdsStack gap and inter-component spacing.",
13387
+ "description": "16px default HdsStack gap and inter-component spacing. DEPRECATED alias (hds#206) — use semantic.space.scale.sm; kept live, no removal yet.",
12177
13388
  "alias": "{primitive.space.4}",
12178
13389
  "resolvedValue": "16px"
12179
13390
  },
@@ -12181,7 +13392,7 @@
12181
13392
  "path": "semantic.space.layout.normal",
12182
13393
  "cssVar": "--semantic-space-layout-normal",
12183
13394
  "type": "dimension",
12184
- "description": "24px column gutters and sidebar gutter spacing.",
13395
+ "description": "24px column gutters and sidebar gutter spacing. DEPRECATED alias (hds#206) — use semantic.space.scale.md; kept live, no removal yet.",
12185
13396
  "alias": "{primitive.space.6}",
12186
13397
  "resolvedValue": "24px"
12187
13398
  },
@@ -12189,15 +13400,15 @@
12189
13400
  "path": "semantic.space.layout.gutter",
12190
13401
  "cssVar": "--semantic-space-layout-gutter",
12191
13402
  "type": "dimension",
12192
- "description": "24px column and region gutters (alias for layout.normal).",
12193
- "alias": "{primitive.space.6}",
13403
+ "description": "24px column and region gutters. DEPRECATED alias (hds#206) — use semantic.space.region.gutter (responsive in theme.css); kept live, no removal yet.",
13404
+ "alias": "{semantic.space.region.gutter}",
12194
13405
  "resolvedValue": "24px"
12195
13406
  },
12196
13407
  {
12197
13408
  "path": "semantic.space.layout.inset",
12198
13409
  "cssVar": "--semantic-space-layout-inset",
12199
13410
  "type": "dimension",
12200
- "description": "32px major block separation and inset inter-component gaps.",
13411
+ "description": "32px major block separation and inset inter-component gaps. DEPRECATED alias (hds#206) — use semantic.space.scale.lg; kept live, no removal yet.",
12201
13412
  "alias": "{primitive.space.8}",
12202
13413
  "resolvedValue": "32px"
12203
13414
  },
@@ -12205,7 +13416,7 @@
12205
13416
  "path": "semantic.space.layout.spacious",
12206
13417
  "cssVar": "--semantic-space-layout-spacious",
12207
13418
  "type": "dimension",
12208
- "description": "48px section break and whitespace separator between major content blocks.",
13419
+ "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.",
12209
13420
  "alias": "{primitive.space.12}",
12210
13421
  "resolvedValue": "48px"
12211
13422
  },
@@ -12265,6 +13476,14 @@
12265
13476
  "alias": "{primitive.space.5}",
12266
13477
  "resolvedValue": "20px"
12267
13478
  },
13479
+ {
13480
+ "path": "semantic.space.sidebar.railWidth",
13481
+ "cssVar": "--semantic-space-sidebar-railWidth",
13482
+ "type": "dimension",
13483
+ "description": "Docs-shell left nav rail and right TOC rail width (hds#280). Both rails share one width token; default 0 below their breakpoint (see HdsDocsShell).",
13484
+ "alias": "{primitive.size.width.280}",
13485
+ "resolvedValue": "280px"
13486
+ },
12268
13487
  {
12269
13488
  "path": "semantic.layout.width.content",
12270
13489
  "cssVar": "--semantic-layout-width-content",
@@ -12341,10 +13560,10 @@
12341
13560
  "path": "semantic.typography.display",
12342
13561
  "cssVar": "--semantic-typography-display",
12343
13562
  "type": "typography",
12344
- "description": "Display headline. 72px / Satoshi bold 700 / leading-none.",
13563
+ "description": "Display headline. 60px / Satoshi bold 700 / leading-none (hds#283: was 72px/5xl).",
12345
13564
  "composite": {
12346
13565
  "fontFamily": "Satoshi, system-ui, -apple-system, BlinkMacSystemFont, \"Segoe UI\", sans-serif",
12347
- "fontSize": "72px",
13566
+ "fontSize": "60px",
12348
13567
  "fontWeight": "700",
12349
13568
  "letterSpacing": "-0.01em",
12350
13569
  "lineHeight": "1"
@@ -12354,7 +13573,7 @@
12354
13573
  "path": "semantic.typography.h1",
12355
13574
  "cssVar": "--semantic-typography-h1",
12356
13575
  "type": "typography",
12357
- "description": "Primary section headings (h1). 48px / Satoshi bold 700 / leading-tight.",
13576
+ "description": "Primary section headings (h1). 48px / Satoshi bold 700 / leading-tight (hds#283: rung renamed 4xl→5xl, px unchanged).",
12358
13577
  "composite": {
12359
13578
  "fontFamily": "Satoshi, system-ui, -apple-system, BlinkMacSystemFont, \"Segoe UI\", sans-serif",
12360
13579
  "fontSize": "48px",
@@ -12367,20 +13586,20 @@
12367
13586
  "path": "semantic.typography.h2",
12368
13587
  "cssVar": "--semantic-typography-h2",
12369
13588
  "type": "typography",
12370
- "description": "Secondary section headings (h2). Satoshi bold 700, 30px, line-height 42px.",
13589
+ "description": "Secondary section headings (h2). Satoshi bold 700, 30px, line-height 40px (hds#283: rung renamed, was 42px).",
12371
13590
  "composite": {
12372
13591
  "fontFamily": "Satoshi, system-ui, -apple-system, BlinkMacSystemFont, \"Segoe UI\", sans-serif",
12373
13592
  "fontSize": "30px",
12374
13593
  "fontWeight": "700",
12375
13594
  "letterSpacing": "-0.01em",
12376
- "lineHeight": "42px"
13595
+ "lineHeight": "40px"
12377
13596
  }
12378
13597
  },
12379
13598
  {
12380
13599
  "path": "semantic.typography.h3",
12381
13600
  "cssVar": "--semantic-typography-h3",
12382
13601
  "type": "typography",
12383
- "description": "Component and card headers (h3). 20px / Satoshi bold 700 500 / leading-snug.",
13602
+ "description": "Component and card headers (h3). 20px / Satoshi bold 700 500 / leading-snug (hds#283: rung renamed lg→xl, px unchanged).",
12384
13603
  "composite": {
12385
13604
  "fontFamily": "Satoshi, system-ui, -apple-system, BlinkMacSystemFont, \"Segoe UI\", sans-serif",
12386
13605
  "fontSize": "20px",
@@ -12393,13 +13612,13 @@
12393
13612
  "path": "semantic.typography.body",
12394
13613
  "cssVar": "--semantic-typography-body",
12395
13614
  "type": "typography",
12396
- "description": "Body prose. Satoshi medium, 17px, line-height 28px, max 60ch measure.",
13615
+ "description": "Body prose. Satoshi medium, 16px, line-height 24px, max 60ch measure (hds#283: was 17px/28px).",
12397
13616
  "composite": {
12398
13617
  "fontFamily": "Satoshi, system-ui, -apple-system, BlinkMacSystemFont, \"Segoe UI\", sans-serif",
12399
- "fontSize": "17px",
13618
+ "fontSize": "16px",
12400
13619
  "fontWeight": "500",
12401
13620
  "letterSpacing": "0em",
12402
- "lineHeight": "28px",
13621
+ "lineHeight": "24px",
12403
13622
  "maxWidth": "60ch"
12404
13623
  }
12405
13624
  },
@@ -12407,13 +13626,13 @@
12407
13626
  "path": "semantic.typography.ui",
12408
13627
  "cssVar": "--semantic-typography-ui",
12409
13628
  "type": "typography",
12410
- "description": "UI text for nav, labels, captions. Satoshi medium, 15px, line-height 24px.",
13629
+ "description": "UI text for nav, labels, captions. Satoshi medium, 14px, line-height 20px (hds#283: was 15px/24px).",
12411
13630
  "composite": {
12412
13631
  "fontFamily": "Satoshi, system-ui, -apple-system, BlinkMacSystemFont, \"Segoe UI\", sans-serif",
12413
- "fontSize": "15px",
13632
+ "fontSize": "14px",
12414
13633
  "fontWeight": "500",
12415
13634
  "letterSpacing": "0em",
12416
- "lineHeight": "24px",
13635
+ "lineHeight": "20px",
12417
13636
  "maxWidth": "60ch"
12418
13637
  }
12419
13638
  },
@@ -12421,7 +13640,7 @@
12421
13640
  "path": "semantic.typography.caption",
12422
13641
  "cssVar": "--semantic-typography-caption",
12423
13642
  "type": "typography",
12424
- "description": "Caption / helper text. Satoshi medium, 12px, line-height 16px. Matches the Figma typography/caption text style.",
13643
+ "description": "Caption / helper text. Satoshi medium, 12px, line-height 16px. Matches the Figma typography/caption text style; now sourced from primitive.xs (hds#283).",
12425
13644
  "composite": {
12426
13645
  "fontFamily": "Satoshi, system-ui, -apple-system, BlinkMacSystemFont, \"Segoe UI\", sans-serif",
12427
13646
  "fontSize": "12px",
@@ -12434,13 +13653,13 @@
12434
13653
  "path": "semantic.typography.eyebrow",
12435
13654
  "cssVar": "--semantic-typography-eyebrow",
12436
13655
  "type": "typography",
12437
- "description": "Eyebrow / kicker label. Satoshi medium, 13px, caps tracking, uppercase.",
13656
+ "description": "Eyebrow / kicker label. Satoshi medium, 12px, caps tracking, uppercase (hds#283: was 13px/20px).",
12438
13657
  "composite": {
12439
13658
  "fontFamily": "Satoshi, system-ui, -apple-system, BlinkMacSystemFont, \"Segoe UI\", sans-serif",
12440
- "fontSize": "13px",
13659
+ "fontSize": "12px",
12441
13660
  "fontWeight": "500",
12442
13661
  "letterSpacing": "0.06em",
12443
- "lineHeight": "20px",
13662
+ "lineHeight": "16px",
12444
13663
  "textTransform": "uppercase"
12445
13664
  }
12446
13665
  },
@@ -12448,10 +13667,10 @@
12448
13667
  "path": "semantic.typography.mono",
12449
13668
  "cssVar": "--semantic-typography-mono",
12450
13669
  "type": "typography",
12451
- "description": "Monospace for code, token names, shortcuts. Geist Mono regular, 13px.",
13670
+ "description": "Monospace for code, token names, shortcuts. Geist Mono regular, 14px (hds#283: repointed xs→sm; xs alone would give 12px).",
12452
13671
  "composite": {
12453
13672
  "fontFamily": "\"Geist Mono\", \"Courier New\", monospace",
12454
- "fontSize": "13px",
13673
+ "fontSize": "14px",
12455
13674
  "fontWeight": "400",
12456
13675
  "letterSpacing": "0em",
12457
13676
  "lineHeight": "20px",
@@ -12594,6 +13813,14 @@
12594
13813
  "alias": "{primitive.radius.8}",
12595
13814
  "resolvedValue": "8px"
12596
13815
  },
13816
+ {
13817
+ "path": "semantic.radius.control",
13818
+ "cssVar": "--semantic-radius-control",
13819
+ "type": "dimension",
13820
+ "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).",
13821
+ "alias": "{primitive.radius.4}",
13822
+ "resolvedValue": "4px"
13823
+ },
12597
13824
  {
12598
13825
  "path": "semantic.borderWidth.default",
12599
13826
  "cssVar": "--semantic-borderWidth-default",
@@ -12698,6 +13925,94 @@
12698
13925
  },
12699
13926
  "border": null
12700
13927
  }
13928
+ },
13929
+ {
13930
+ "path": "semantic.size.control.sm",
13931
+ "cssVar": "--semantic-size-control-sm",
13932
+ "type": "dimension",
13933
+ "description": "Small control element — radio dot, slider fill bar height.",
13934
+ "alias": "{primitive.size.8}",
13935
+ "resolvedValue": "8px"
13936
+ },
13937
+ {
13938
+ "path": "semantic.size.control.md",
13939
+ "cssVar": "--semantic-size-control-md",
13940
+ "type": "dimension",
13941
+ "description": "Medium control element — checkbox glyph box, slider track wrapper height.",
13942
+ "alias": "{primitive.size.20}",
13943
+ "resolvedValue": "20px"
13944
+ },
13945
+ {
13946
+ "path": "semantic.size.control.lg",
13947
+ "cssVar": "--semantic-size-control-lg",
13948
+ "type": "dimension",
13949
+ "description": "Large control footprint — code-block inline-wrapper min-height / copy-button-matched pre padding.",
13950
+ "alias": "{primitive.size.32}",
13951
+ "resolvedValue": "32px"
13952
+ },
13953
+ {
13954
+ "path": "semantic.size.icon.sm",
13955
+ "cssVar": "--semantic-size-icon-sm",
13956
+ "type": "dimension",
13957
+ "description": "Small icon box — matches --hds-icon-small.",
13958
+ "alias": "{primitive.size.16}",
13959
+ "resolvedValue": "16px"
13960
+ },
13961
+ {
13962
+ "path": "semantic.size.icon.md",
13963
+ "cssVar": "--semantic-size-icon-md",
13964
+ "type": "dimension",
13965
+ "description": "Medium icon box — matches --hds-icon-medium.",
13966
+ "alias": "{primitive.size.20}",
13967
+ "resolvedValue": "20px"
13968
+ },
13969
+ {
13970
+ "path": "semantic.size.icon.lg",
13971
+ "cssVar": "--semantic-size-icon-lg",
13972
+ "type": "dimension",
13973
+ "description": "Large icon box — matches --hds-icon-large.",
13974
+ "alias": "{primitive.size.24}",
13975
+ "resolvedValue": "24px"
13976
+ },
13977
+ {
13978
+ "path": "semantic.size.avatar",
13979
+ "cssVar": "--semantic-size-avatar",
13980
+ "type": "dimension",
13981
+ "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.",
13982
+ "alias": "{primitive.size.40}",
13983
+ "resolvedValue": "40px"
13984
+ },
13985
+ {
13986
+ "path": "semantic.size.row.compact",
13987
+ "cssVar": "--semantic-size-row-compact",
13988
+ "type": "dimension",
13989
+ "description": "Compact-density row minimum height.",
13990
+ "alias": "{primitive.size.40}",
13991
+ "resolvedValue": "40px"
13992
+ },
13993
+ {
13994
+ "path": "semantic.size.row.comfortable",
13995
+ "cssVar": "--semantic-size-row-comfortable",
13996
+ "type": "dimension",
13997
+ "description": "Comfortable-density row minimum height.",
13998
+ "alias": "{primitive.size.48}",
13999
+ "resolvedValue": "48px"
14000
+ },
14001
+ {
14002
+ "path": "semantic.zIndex.control",
14003
+ "cssVar": "--semantic-zIndex-control",
14004
+ "type": "number",
14005
+ "description": "Raises an interactive control (e.g. a native range input) above its visual decoration for hit-testing.",
14006
+ "alias": "{primitive.zIndex.10}",
14007
+ "resolvedValue": "10"
14008
+ },
14009
+ {
14010
+ "path": "semantic.zIndex.sticky",
14011
+ "cssVar": "--semantic-zIndex-sticky",
14012
+ "type": "number",
14013
+ "description": "Sticky-positioned elements, such as a table header row.",
14014
+ "alias": "{primitive.zIndex.100}",
14015
+ "resolvedValue": "100"
12701
14016
  }
12702
14017
  ],
12703
14018
  "component": [
@@ -12803,7 +14118,7 @@
12803
14118
  "type": "dimension",
12804
14119
  "description": "Tag type size.",
12805
14120
  "alias": "{primitive.typography.size.xs}",
12806
- "resolvedValue": "13px"
14121
+ "resolvedValue": "12px"
12807
14122
  },
12808
14123
  {
12809
14124
  "path": "component.tag.fontWeight",
@@ -12891,7 +14206,7 @@
12891
14206
  "type": "dimension",
12892
14207
  "description": "Badge type size.",
12893
14208
  "alias": "{primitive.typography.size.xs}",
12894
- "resolvedValue": "13px"
14209
+ "resolvedValue": "12px"
12895
14210
  },
12896
14211
  {
12897
14212
  "path": "component.badge.fontWeight",
@@ -13029,9 +14344,9 @@
13029
14344
  "path": "component.button.size.sm.fontSize",
13030
14345
  "cssVar": "--component-button-size-sm-fontSize",
13031
14346
  "type": "dimension",
13032
- "description": "Small button label size (13px).",
14347
+ "description": "Small button label size (12px, hds#283: was 13px).",
13033
14348
  "alias": "{primitive.typography.size.xs}",
13034
- "resolvedValue": "13px"
14349
+ "resolvedValue": "12px"
13035
14350
  },
13036
14351
  {
13037
14352
  "path": "component.button.size.sm.iconSize",
@@ -13077,9 +14392,9 @@
13077
14392
  "path": "component.button.size.md.fontSize",
13078
14393
  "cssVar": "--component-button-size-md-fontSize",
13079
14394
  "type": "dimension",
13080
- "description": "Medium button label size (15px).",
14395
+ "description": "Medium button label size (14px, hds#283: was 15px).",
13081
14396
  "alias": "{primitive.typography.size.sm}",
13082
- "resolvedValue": "15px"
14397
+ "resolvedValue": "14px"
13083
14398
  },
13084
14399
  {
13085
14400
  "path": "component.button.size.md.iconSize",
@@ -13125,9 +14440,9 @@
13125
14440
  "path": "component.button.size.lg.fontSize",
13126
14441
  "cssVar": "--component-button-size-lg-fontSize",
13127
14442
  "type": "dimension",
13128
- "description": "Large button label size (17px).",
14443
+ "description": "Large button label size (16px, hds#283: was 17px).",
13129
14444
  "alias": "{primitive.typography.size.base}",
13130
- "resolvedValue": "17px"
14445
+ "resolvedValue": "16px"
13131
14446
  },
13132
14447
  {
13133
14448
  "path": "component.button.size.lg.iconSize",