@invoiceonline/ui-react 0.0.0 → 0.1.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 (738) hide show
  1. package/AGENTS.md +99 -0
  2. package/CHANGELOG.md +131 -0
  3. package/LICENSE +9 -0
  4. package/README.md +77 -1
  5. package/dist/assets/label-brush-1.svg +6 -0
  6. package/dist/assets/pattern-dark.svg +113 -0
  7. package/dist/components/action-row/ActionRow.d.ts +178 -0
  8. package/dist/components/action-row/ActionRow.js +340 -0
  9. package/dist/components/action-row/index.d.ts +2 -0
  10. package/dist/components/action-row/index.js +1 -0
  11. package/dist/components/alert/Alert.d.ts +314 -0
  12. package/dist/components/alert/Alert.js +446 -0
  13. package/dist/components/alert/index.d.ts +2 -0
  14. package/dist/components/alert/index.js +1 -0
  15. package/dist/components/anchored-panel/AnchoredPanel.d.ts +41 -0
  16. package/dist/components/anchored-panel/AnchoredPanel.js +72 -0
  17. package/dist/components/anchored-panel/index.d.ts +3 -0
  18. package/dist/components/anchored-panel/index.js +3 -0
  19. package/dist/components/badge/Badge.d.ts +146 -0
  20. package/dist/components/badge/Badge.js +258 -0
  21. package/dist/components/badge/index.d.ts +2 -0
  22. package/dist/components/badge/index.js +1 -0
  23. package/dist/components/banner/Banner.d.ts +209 -0
  24. package/dist/components/banner/Banner.js +339 -0
  25. package/dist/components/banner/index.d.ts +2 -0
  26. package/dist/components/banner/index.js +1 -0
  27. package/dist/components/button/Button.d.ts +54 -0
  28. package/dist/components/button/Button.js +312 -0
  29. package/dist/components/button/index.d.ts +2 -0
  30. package/dist/components/button/index.js +1 -0
  31. package/dist/components/button-group/ButtonGroup.d.ts +187 -0
  32. package/dist/components/button-group/ButtonGroup.js +217 -0
  33. package/dist/components/button-group/index.d.ts +2 -0
  34. package/dist/components/button-group/index.js +1 -0
  35. package/dist/components/card-select/CardSelect.d.ts +274 -0
  36. package/dist/components/card-select/CardSelect.js +561 -0
  37. package/dist/components/card-select/CardSelectGroup.d.ts +92 -0
  38. package/dist/components/card-select/CardSelectGroup.js +72 -0
  39. package/dist/components/card-select/index.d.ts +3 -0
  40. package/dist/components/card-select/index.js +3 -0
  41. package/dist/components/checkbox/Checkbox.d.ts +104 -0
  42. package/dist/components/checkbox/Checkbox.js +194 -0
  43. package/dist/components/checkbox/index.d.ts +2 -0
  44. package/dist/components/checkbox/index.js +1 -0
  45. package/dist/components/chip/Chip.d.ts +250 -0
  46. package/dist/components/chip/Chip.js +441 -0
  47. package/dist/components/chip/index.d.ts +2 -0
  48. package/dist/components/chip/index.js +1 -0
  49. package/dist/components/column-header/ColumnHeader.d.ts +144 -0
  50. package/dist/components/column-header/ColumnHeader.js +209 -0
  51. package/dist/components/column-header/index.d.ts +2 -0
  52. package/dist/components/column-header/index.js +1 -0
  53. package/dist/components/combobox-field/Combobox.d.ts +104 -0
  54. package/dist/components/combobox-field/Combobox.js +355 -0
  55. package/dist/components/combobox-field/ComboboxField.d.ts +76 -0
  56. package/dist/components/combobox-field/ComboboxField.js +98 -0
  57. package/dist/components/combobox-field/index.d.ts +3 -0
  58. package/dist/components/combobox-field/index.js +3 -0
  59. package/dist/components/date-field/DateField.d.ts +52 -0
  60. package/dist/components/date-field/DateField.js +45 -0
  61. package/dist/components/date-field/index.d.ts +2 -0
  62. package/dist/components/date-field/index.js +1 -0
  63. package/dist/components/date-picker/DatePicker.d.ts +53 -0
  64. package/dist/components/date-picker/DatePicker.js +329 -0
  65. package/dist/components/date-picker/index.d.ts +2 -0
  66. package/dist/components/date-picker/index.js +1 -0
  67. package/dist/components/divider/Divider.d.ts +81 -0
  68. package/dist/components/divider/Divider.js +93 -0
  69. package/dist/components/divider/index.d.ts +2 -0
  70. package/dist/components/divider/index.js +1 -0
  71. package/dist/components/drawer/Drawer.d.ts +128 -0
  72. package/dist/components/drawer/Drawer.js +367 -0
  73. package/dist/components/drawer/index.d.ts +2 -0
  74. package/dist/components/drawer/index.js +1 -0
  75. package/dist/components/dropdown-button/DropdownButton.d.ts +72 -0
  76. package/dist/components/dropdown-button/DropdownButton.js +122 -0
  77. package/dist/components/dropdown-button/index.d.ts +2 -0
  78. package/dist/components/dropdown-button/index.js +1 -0
  79. package/dist/components/faq/FAQ.d.ts +135 -0
  80. package/dist/components/faq/FAQ.js +258 -0
  81. package/dist/components/faq/index.d.ts +2 -0
  82. package/dist/components/faq/index.js +1 -0
  83. package/dist/components/field/Field.d.ts +118 -0
  84. package/dist/components/field/Field.js +327 -0
  85. package/dist/components/field/index.d.ts +2 -0
  86. package/dist/components/field/index.js +1 -0
  87. package/dist/components/field-pair/FieldPair.d.ts +194 -0
  88. package/dist/components/field-pair/FieldPair.js +321 -0
  89. package/dist/components/field-pair/index.d.ts +2 -0
  90. package/dist/components/field-pair/index.js +1 -0
  91. package/dist/components/file-upload/FileUpload.d.ts +137 -0
  92. package/dist/components/file-upload/FileUpload.js +434 -0
  93. package/dist/components/file-upload/index.d.ts +2 -0
  94. package/dist/components/file-upload/index.js +1 -0
  95. package/dist/components/filter-chip/FilterChip.d.ts +373 -0
  96. package/dist/components/filter-chip/FilterChip.js +517 -0
  97. package/dist/components/filter-chip/index.d.ts +2 -0
  98. package/dist/components/filter-chip/index.js +1 -0
  99. package/dist/components/filter-facet/FilterFacet.d.ts +116 -0
  100. package/dist/components/filter-facet/FilterFacet.js +632 -0
  101. package/dist/components/filter-facet/index.d.ts +2 -0
  102. package/dist/components/filter-facet/index.js +1 -0
  103. package/dist/components/firm-avatar/FirmAvatar.d.ts +75 -0
  104. package/dist/components/firm-avatar/FirmAvatar.js +119 -0
  105. package/dist/components/firm-avatar/index.d.ts +2 -0
  106. package/dist/components/firm-avatar/index.js +1 -0
  107. package/dist/components/form-actions/FormActions.d.ts +123 -0
  108. package/dist/components/form-actions/FormActions.js +195 -0
  109. package/dist/components/form-actions/index.d.ts +2 -0
  110. package/dist/components/form-actions/index.js +1 -0
  111. package/dist/components/form-block/FormBlock.d.ts +252 -0
  112. package/dist/components/form-block/FormBlock.js +420 -0
  113. package/dist/components/form-block/index.d.ts +3 -0
  114. package/dist/components/form-block/index.js +3 -0
  115. package/dist/components/form-section/FormSection.d.ts +130 -0
  116. package/dist/components/form-section/FormSection.js +206 -0
  117. package/dist/components/form-section/index.d.ts +2 -0
  118. package/dist/components/form-section/index.js +1 -0
  119. package/dist/components/heading/Heading.d.ts +69 -0
  120. package/dist/components/heading/Heading.js +79 -0
  121. package/dist/components/heading/index.d.ts +2 -0
  122. package/dist/components/heading/index.js +1 -0
  123. package/dist/components/heading-group/HeadingGroup.d.ts +258 -0
  124. package/dist/components/heading-group/HeadingGroup.js +255 -0
  125. package/dist/components/heading-group/index.d.ts +2 -0
  126. package/dist/components/heading-group/index.js +1 -0
  127. package/dist/components/hero/Hero.d.ts +268 -0
  128. package/dist/components/hero/Hero.js +316 -0
  129. package/dist/components/hero/index.d.ts +2 -0
  130. package/dist/components/hero/index.js +1 -0
  131. package/dist/components/icon/Icon.d.ts +27 -0
  132. package/dist/components/icon/Icon.js +30 -0
  133. package/dist/components/icon/index.d.ts +3 -0
  134. package/dist/components/icon/index.js +3 -0
  135. package/dist/components/icon-button/IconButton.d.ts +75 -0
  136. package/dist/components/icon-button/IconButton.js +151 -0
  137. package/dist/components/icon-button/index.d.ts +2 -0
  138. package/dist/components/icon-button/index.js +1 -0
  139. package/dist/components/item-row/ItemRow.d.ts +253 -0
  140. package/dist/components/item-row/ItemRow.js +496 -0
  141. package/dist/components/item-row/index.d.ts +2 -0
  142. package/dist/components/item-row/index.js +1 -0
  143. package/dist/components/list-row/ListRow.d.ts +165 -0
  144. package/dist/components/list-row/ListRow.js +233 -0
  145. package/dist/components/list-row/index.d.ts +2 -0
  146. package/dist/components/list-row/index.js +1 -0
  147. package/dist/components/menu/Menu.d.ts +64 -0
  148. package/dist/components/menu/Menu.js +186 -0
  149. package/dist/components/menu/index.d.ts +2 -0
  150. package/dist/components/menu/index.js +1 -0
  151. package/dist/components/modal/Modal.d.ts +272 -0
  152. package/dist/components/modal/Modal.js +788 -0
  153. package/dist/components/modal/index.d.ts +2 -0
  154. package/dist/components/modal/index.js +1 -0
  155. package/dist/components/nav-link/NavLink.d.ts +123 -0
  156. package/dist/components/nav-link/NavLink.js +157 -0
  157. package/dist/components/nav-link/index.d.ts +2 -0
  158. package/dist/components/nav-link/index.js +1 -0
  159. package/dist/components/number-field/NumberField.d.ts +62 -0
  160. package/dist/components/number-field/NumberField.js +210 -0
  161. package/dist/components/number-field/index.d.ts +2 -0
  162. package/dist/components/number-field/index.js +1 -0
  163. package/dist/components/pagination/Pagination.d.ts +133 -0
  164. package/dist/components/pagination/Pagination.js +217 -0
  165. package/dist/components/pagination/index.d.ts +3 -0
  166. package/dist/components/pagination/index.js +3 -0
  167. package/dist/components/popover-surface/index.d.ts +2 -0
  168. package/dist/components/popover-surface/index.js +1 -0
  169. package/dist/components/progress-bar/ProgressBar.d.ts +260 -0
  170. package/dist/components/progress-bar/ProgressBar.js +470 -0
  171. package/dist/components/progress-bar/index.d.ts +2 -0
  172. package/dist/components/progress-bar/index.js +1 -0
  173. package/dist/components/promo-sticker/PromoSticker.d.ts +204 -0
  174. package/dist/components/promo-sticker/PromoSticker.js +177 -0
  175. package/dist/components/promo-sticker/index.d.ts +2 -0
  176. package/dist/components/promo-sticker/index.js +1 -0
  177. package/dist/components/promo-surface/PromoSurface.d.ts +94 -0
  178. package/dist/components/promo-surface/PromoSurface.js +119 -0
  179. package/dist/components/promo-surface/index.d.ts +2 -0
  180. package/dist/components/promo-surface/index.js +1 -0
  181. package/dist/components/radio/Radio.d.ts +92 -0
  182. package/dist/components/radio/Radio.js +171 -0
  183. package/dist/components/radio/index.d.ts +2 -0
  184. package/dist/components/radio/index.js +1 -0
  185. package/dist/components/radio-group/RadioGroup.d.ts +61 -0
  186. package/dist/components/radio-group/RadioGroup.js +51 -0
  187. package/dist/components/radio-group/index.d.ts +2 -0
  188. package/dist/components/radio-group/index.js +1 -0
  189. package/dist/components/select/Select.d.ts +65 -0
  190. package/dist/components/select/Select.js +176 -0
  191. package/dist/components/select/index.d.ts +2 -0
  192. package/dist/components/select/index.js +1 -0
  193. package/dist/components/select-field/SelectField.d.ts +16 -0
  194. package/dist/components/select-field/SelectField.js +55 -0
  195. package/dist/components/select-field/index.d.ts +2 -0
  196. package/dist/components/select-field/index.js +1 -0
  197. package/dist/components/skeleton/Skeleton.d.ts +64 -0
  198. package/dist/components/skeleton/Skeleton.js +65 -0
  199. package/dist/components/skeleton/index.d.ts +2 -0
  200. package/dist/components/skeleton/index.js +1 -0
  201. package/dist/components/split-button/SplitButton.d.ts +80 -0
  202. package/dist/components/split-button/SplitButton.js +182 -0
  203. package/dist/components/split-button/index.d.ts +2 -0
  204. package/dist/components/split-button/index.js +1 -0
  205. package/dist/components/status-summary-bar/StatusSummaryBar.d.ts +118 -0
  206. package/dist/components/status-summary-bar/StatusSummaryBar.js +278 -0
  207. package/dist/components/status-summary-bar/index.d.ts +2 -0
  208. package/dist/components/status-summary-bar/index.js +1 -0
  209. package/dist/components/subject-lookup-field/SubjectLookupField.d.ts +157 -0
  210. package/dist/components/subject-lookup-field/SubjectLookupField.js +663 -0
  211. package/dist/components/subject-lookup-field/index.d.ts +2 -0
  212. package/dist/components/subject-lookup-field/index.js +1 -0
  213. package/dist/components/switch/Switch.d.ts +152 -0
  214. package/dist/components/switch/Switch.js +307 -0
  215. package/dist/components/switch/index.d.ts +2 -0
  216. package/dist/components/switch/index.js +1 -0
  217. package/dist/components/table/Table.d.ts +5 -0
  218. package/dist/components/table/Table.js +601 -0
  219. package/dist/components/table/index.d.ts +6 -0
  220. package/dist/components/table/index.js +6 -0
  221. package/dist/components/text-field/TextField.d.ts +65 -0
  222. package/dist/components/text-field/TextField.js +173 -0
  223. package/dist/components/text-field/index.d.ts +2 -0
  224. package/dist/components/text-field/index.js +1 -0
  225. package/dist/components/text-link/TextLink.d.ts +260 -0
  226. package/dist/components/text-link/TextLink.js +303 -0
  227. package/dist/components/text-link/index.d.ts +2 -0
  228. package/dist/components/text-link/index.js +1 -0
  229. package/dist/components/textarea/Textarea.d.ts +93 -0
  230. package/dist/components/textarea/Textarea.js +256 -0
  231. package/dist/components/textarea/index.d.ts +2 -0
  232. package/dist/components/textarea/index.js +1 -0
  233. package/dist/components/tooltip/Tooltip.d.ts +129 -0
  234. package/dist/components/tooltip/Tooltip.js +457 -0
  235. package/dist/components/tooltip/index.d.ts +2 -0
  236. package/dist/components/tooltip/index.js +1 -0
  237. package/dist/components/unit-field/UnitField.d.ts +46 -0
  238. package/dist/components/unit-field/UnitField.js +133 -0
  239. package/dist/components/unit-field/index.d.ts +2 -0
  240. package/dist/components/unit-field/index.js +1 -0
  241. package/dist/icons/icon-registry.generated.js +500 -0
  242. package/dist/icons/icon-types.generated.d.ts +2 -0
  243. package/dist/icons/icon-types.generated.js +126 -0
  244. package/dist/index.d.ts +132 -0
  245. package/dist/index.js +75 -0
  246. package/dist/internal/BottomSheet.js +496 -0
  247. package/dist/internal/FodsProvider.d.ts +25 -0
  248. package/dist/internal/FodsProvider.js +32 -0
  249. package/dist/internal/MotionCaret.js +35 -0
  250. package/dist/internal/NumberFormatInput.d.ts +21 -0
  251. package/dist/internal/NumberFormatInput.js +126 -0
  252. package/dist/internal/SummaryDonut.d.ts +3 -0
  253. package/dist/internal/SummaryDonut.js +300 -0
  254. package/dist/internal/buttonSegment.d.ts +44 -0
  255. package/dist/internal/buttonSegment.js +126 -0
  256. package/dist/internal/collapseRoom.js +128 -0
  257. package/dist/internal/comboboxKeys.js +44 -0
  258. package/dist/internal/contentPresence.js +46 -0
  259. package/dist/internal/dayCell.js +95 -0
  260. package/dist/internal/dialogPortal.d.ts +2 -0
  261. package/dist/internal/dialogPortal.js +21 -0
  262. package/dist/internal/donutSweeps.js +65 -0
  263. package/dist/internal/enterOnViewGeometry.js +46 -0
  264. package/dist/internal/faqItem.js +80 -0
  265. package/dist/internal/floatingLabelMotion.js +68 -0
  266. package/dist/internal/formBlockContext.d.ts +22 -0
  267. package/dist/internal/formBlockContext.js +20 -0
  268. package/dist/internal/heightRoom.js +87 -0
  269. package/dist/internal/numberSeparators.js +62 -0
  270. package/dist/internal/overlayMotion.js +48 -0
  271. package/dist/internal/paginationItem.d.ts +8 -0
  272. package/dist/internal/paginationItem.js +22 -0
  273. package/dist/internal/popoverSurface.d.ts +8 -0
  274. package/dist/internal/popoverSurface.js +23 -0
  275. package/dist/internal/portalContainer.d.ts +1 -0
  276. package/dist/internal/portalContainer.js +6 -0
  277. package/dist/internal/progressBarItem.d.ts +207 -0
  278. package/dist/internal/progressBarItem.js +264 -0
  279. package/dist/internal/selectionControlText.js +12 -0
  280. package/dist/internal/statusSummaryParts.js +371 -0
  281. package/dist/internal/summaryMotion.js +75 -0
  282. package/dist/internal/table/ChildConnector.js +62 -0
  283. package/dist/internal/table/ChildRowPrefix.d.ts +9 -0
  284. package/dist/internal/table/ChildRowPrefix.js +27 -0
  285. package/dist/internal/table/ColumnSettings.js +135 -0
  286. package/dist/internal/table/ScrollRegion.js +114 -0
  287. package/dist/internal/table/TableEmpty.js +93 -0
  288. package/dist/internal/table/TableLayout.d.ts +17 -0
  289. package/dist/internal/table/TableLayout.js +29 -0
  290. package/dist/internal/table/TableLoadStatus.js +56 -0
  291. package/dist/internal/table/TableMobile.js +488 -0
  292. package/dist/internal/table/TruncatedCell.js +33 -0
  293. package/dist/internal/table/emptyValue.js +10 -0
  294. package/dist/internal/table/features.d.ts +41 -0
  295. package/dist/internal/table/features.js +31 -0
  296. package/dist/internal/table/recipes.js +227 -0
  297. package/dist/internal/table/rowClick.js +9 -0
  298. package/dist/internal/table/types.d.ts +325 -0
  299. package/dist/internal/table/types.js +13 -0
  300. package/dist/internal/tailwind-variants.d.ts +3 -0
  301. package/dist/internal/tailwind-variants.js +37 -0
  302. package/dist/internal/tooltipContext.js +5 -0
  303. package/dist/internal/tw-merge-config.generated.js +314 -0
  304. package/dist/internal/useAnchoredPanel.d.ts +87 -0
  305. package/dist/internal/useAnchoredPanel.js +108 -0
  306. package/dist/internal/useCountUp.js +53 -0
  307. package/dist/internal/useDateFieldTrigger.js +183 -0
  308. package/dist/internal/useEChart.js +59 -0
  309. package/dist/internal/useEnterOnView.js +42 -0
  310. package/dist/internal/useFloatingBar.js +100 -0
  311. package/dist/internal/useFormReset.js +37 -0
  312. package/dist/internal/useIsMobile.js +44 -0
  313. package/dist/internal/useOneRowOverflow.js +88 -0
  314. package/dist/internal/usePrefersReducedMotion.js +25 -0
  315. package/dist/internal/useReturnFocus.js +26 -0
  316. package/dist/internal/utils.d.ts +7 -0
  317. package/dist/internal/utils.js +58 -0
  318. package/dist/node_modules/@tanstack/store/dist/store.d.ts +29 -0
  319. package/dist/node_modules/@tanstack/store/dist/types.d.ts +38 -0
  320. package/dist/node_modules/@tanstack/table-core/dist/core/cells/coreCellsFeature.d.ts +6 -0
  321. package/dist/node_modules/@tanstack/table-core/dist/core/cells/coreCellsFeature.types.d.ts +53 -0
  322. package/dist/node_modules/@tanstack/table-core/dist/core/columns/coreColumnsFeature.d.ts +6 -0
  323. package/dist/node_modules/@tanstack/table-core/dist/core/columns/coreColumnsFeature.types.d.ts +90 -0
  324. package/dist/node_modules/@tanstack/table-core/dist/core/coreFeatures.d.ts +17 -0
  325. package/dist/node_modules/@tanstack/table-core/dist/core/headers/coreHeadersFeature.d.ts +6 -0
  326. package/dist/node_modules/@tanstack/table-core/dist/core/headers/coreHeadersFeature.types.d.ts +114 -0
  327. package/dist/node_modules/@tanstack/table-core/dist/core/reactivity/coreReactivityFeature.types.d.ts +51 -0
  328. package/dist/node_modules/@tanstack/table-core/dist/core/row-models/coreRowModelsFeature.d.ts +6 -0
  329. package/dist/node_modules/@tanstack/table-core/dist/core/row-models/coreRowModelsFeature.types.d.ts +29 -0
  330. package/dist/node_modules/@tanstack/table-core/dist/core/rows/coreRowsFeature.d.ts +6 -0
  331. package/dist/node_modules/@tanstack/table-core/dist/core/rows/coreRowsFeature.types.d.ts +129 -0
  332. package/dist/node_modules/@tanstack/table-core/dist/core/table/coreTablesFeature.d.ts +6 -0
  333. package/dist/node_modules/@tanstack/table-core/dist/core/table/coreTablesFeature.types.d.ts +203 -0
  334. package/dist/node_modules/@tanstack/table-core/dist/features/cell-selection/cellSelectionFeature.d.ts +6 -0
  335. package/dist/node_modules/@tanstack/table-core/dist/features/cell-selection/cellSelectionFeature.types.d.ts +294 -0
  336. package/dist/node_modules/@tanstack/table-core/dist/features/cell-spanning/cellSpanningFeature.d.ts +11 -0
  337. package/dist/node_modules/@tanstack/table-core/dist/features/cell-spanning/cellSpanningFeature.types.d.ts +148 -0
  338. package/dist/node_modules/@tanstack/table-core/dist/features/column-faceting/columnFacetingFeature.d.ts +12 -0
  339. package/dist/node_modules/@tanstack/table-core/dist/features/column-faceting/columnFacetingFeature.types.d.ts +63 -0
  340. package/dist/node_modules/@tanstack/table-core/dist/features/column-filtering/columnFilteringFeature.d.ts +6 -0
  341. package/dist/node_modules/@tanstack/table-core/dist/features/column-filtering/columnFilteringFeature.types.d.ts +209 -0
  342. package/dist/node_modules/@tanstack/table-core/dist/features/column-filtering/filterFns.d.ts +35 -0
  343. package/dist/node_modules/@tanstack/table-core/dist/features/column-grouping/columnGroupingFeature.d.ts +6 -0
  344. package/dist/node_modules/@tanstack/table-core/dist/features/column-grouping/columnGroupingFeature.types.d.ts +128 -0
  345. package/dist/node_modules/@tanstack/table-core/dist/features/column-ordering/columnOrderingFeature.d.ts +6 -0
  346. package/dist/node_modules/@tanstack/table-core/dist/features/column-ordering/columnOrderingFeature.types.d.ts +82 -0
  347. package/dist/node_modules/@tanstack/table-core/dist/features/column-pinning/columnPinningFeature.d.ts +11 -0
  348. package/dist/node_modules/@tanstack/table-core/dist/features/column-pinning/columnPinningFeature.types.d.ts +195 -0
  349. package/dist/node_modules/@tanstack/table-core/dist/features/column-resizing/columnResizingFeature.d.ts +6 -0
  350. package/dist/node_modules/@tanstack/table-core/dist/features/column-resizing/columnResizingFeature.types.d.ts +73 -0
  351. package/dist/node_modules/@tanstack/table-core/dist/features/column-sizing/columnSizingFeature.d.ts +6 -0
  352. package/dist/node_modules/@tanstack/table-core/dist/features/column-sizing/columnSizingFeature.types.d.ts +134 -0
  353. package/dist/node_modules/@tanstack/table-core/dist/features/column-visibility/columnVisibilityFeature.d.ts +6 -0
  354. package/dist/node_modules/@tanstack/table-core/dist/features/column-visibility/columnVisibilityFeature.types.d.ts +92 -0
  355. package/dist/node_modules/@tanstack/table-core/dist/features/global-filtering/globalFilteringFeature.d.ts +6 -0
  356. package/dist/node_modules/@tanstack/table-core/dist/features/global-filtering/globalFilteringFeature.types.d.ts +67 -0
  357. package/dist/node_modules/@tanstack/table-core/dist/features/row-aggregation/aggregationFns.d.ts +23 -0
  358. package/dist/node_modules/@tanstack/table-core/dist/features/row-aggregation/rowAggregationFeature.d.ts +6 -0
  359. package/dist/node_modules/@tanstack/table-core/dist/features/row-aggregation/rowAggregationFeature.types.d.ts +183 -0
  360. package/dist/node_modules/@tanstack/table-core/dist/features/row-aggregation/rowAggregationFeature.utils.d.ts +18 -0
  361. package/dist/node_modules/@tanstack/table-core/dist/features/row-expanding/rowExpandingFeature.d.ts +6 -0
  362. package/dist/node_modules/@tanstack/table-core/dist/features/row-expanding/rowExpandingFeature.types.d.ts +125 -0
  363. package/dist/node_modules/@tanstack/table-core/dist/features/row-pagination/rowPaginationFeature.d.ts +6 -0
  364. package/dist/node_modules/@tanstack/table-core/dist/features/row-pagination/rowPaginationFeature.types.d.ts +135 -0
  365. package/dist/node_modules/@tanstack/table-core/dist/features/row-pinning/rowPinningFeature.d.ts +6 -0
  366. package/dist/node_modules/@tanstack/table-core/dist/features/row-pinning/rowPinningFeature.types.d.ts +76 -0
  367. package/dist/node_modules/@tanstack/table-core/dist/features/row-selection/rowSelectionFeature.d.ts +6 -0
  368. package/dist/node_modules/@tanstack/table-core/dist/features/row-selection/rowSelectionFeature.types.d.ts +187 -0
  369. package/dist/node_modules/@tanstack/table-core/dist/features/row-sorting/rowSortingFeature.d.ts +6 -0
  370. package/dist/node_modules/@tanstack/table-core/dist/features/row-sorting/rowSortingFeature.types.d.ts +236 -0
  371. package/dist/node_modules/@tanstack/table-core/dist/features/row-sorting/sortFns.d.ts +23 -0
  372. package/dist/node_modules/@tanstack/table-core/dist/features/stockFeatures.d.ts +37 -0
  373. package/dist/node_modules/@tanstack/table-core/dist/helpers/columnHelper.d.ts +47 -0
  374. package/dist/node_modules/@tanstack/table-core/dist/types/Cell.d.ts +16 -0
  375. package/dist/node_modules/@tanstack/table-core/dist/types/Column.d.ts +30 -0
  376. package/dist/node_modules/@tanstack/table-core/dist/types/ColumnDef.d.ts +123 -0
  377. package/dist/node_modules/@tanstack/table-core/dist/types/Header.d.ts +12 -0
  378. package/dist/node_modules/@tanstack/table-core/dist/types/HeaderGroup.d.ts +6 -0
  379. package/dist/node_modules/@tanstack/table-core/dist/types/Row.d.ts +24 -0
  380. package/dist/node_modules/@tanstack/table-core/dist/types/RowModel.d.ts +19 -0
  381. package/dist/node_modules/@tanstack/table-core/dist/types/RowModelFns.d.ts +11 -0
  382. package/dist/node_modules/@tanstack/table-core/dist/types/Table.d.ts +53 -0
  383. package/dist/node_modules/@tanstack/table-core/dist/types/TableFeatures.d.ts +416 -0
  384. package/dist/node_modules/@tanstack/table-core/dist/types/TableOptions.d.ts +78 -0
  385. package/dist/node_modules/@tanstack/table-core/dist/types/TableState.d.ts +46 -0
  386. package/dist/node_modules/@tanstack/table-core/dist/types/type-utils.d.ts +25 -0
  387. package/dist/shared.css +179 -0
  388. package/dist/styles.css +5467 -0
  389. package/dist/theme.css +314 -0
  390. package/dist/theme.map.json +278 -0
  391. package/dist/tokens/index.d.ts +2 -0
  392. package/dist/tokens/index.js +1 -0
  393. package/dist/tokens/tokens.generated.d.ts +2040 -0
  394. package/dist/tokens/tokens.generated.js +2053 -0
  395. package/dist/tokens.css +484 -0
  396. package/dist/tokens.flat.json +429 -0
  397. package/docs/Consuming.mdx +379 -0
  398. package/docs/Contributing.mdx +78 -0
  399. package/docs/ForAgents.mdx +53 -0
  400. package/docs/Introduction.mdx +54 -0
  401. package/llms.txt +556 -0
  402. package/package.json +351 -3
  403. package/src/components/action-row/ActionRow.mdx +686 -0
  404. package/src/components/action-row/ActionRow.stories.tsx +669 -0
  405. package/src/components/action-row/ActionRow.tsx +632 -0
  406. package/src/components/action-row/index.ts +9 -0
  407. package/src/components/alert/Alert.mdx +377 -0
  408. package/src/components/alert/Alert.stories.tsx +674 -0
  409. package/src/components/alert/Alert.tsx +579 -0
  410. package/src/components/alert/index.ts +13 -0
  411. package/src/components/anchored-panel/AnchoredPanel.mdx +381 -0
  412. package/src/components/anchored-panel/AnchoredPanel.stories.tsx +593 -0
  413. package/src/components/anchored-panel/AnchoredPanel.tsx +176 -0
  414. package/src/components/anchored-panel/index.ts +15 -0
  415. package/src/components/badge/Badge.mdx +487 -0
  416. package/src/components/badge/Badge.stories.tsx +375 -0
  417. package/src/components/badge/Badge.tsx +360 -0
  418. package/src/components/badge/index.ts +10 -0
  419. package/src/components/banner/Banner.mdx +704 -0
  420. package/src/components/banner/Banner.stories.tsx +448 -0
  421. package/src/components/banner/Banner.tsx +602 -0
  422. package/src/components/banner/index.ts +14 -0
  423. package/src/components/button/Button.mdx +286 -0
  424. package/src/components/button/Button.stories.tsx +381 -0
  425. package/src/components/button/Button.tsx +384 -0
  426. package/src/components/button/index.ts +1 -0
  427. package/src/components/button-group/ButtonGroup.mdx +512 -0
  428. package/src/components/button-group/ButtonGroup.stories.tsx +714 -0
  429. package/src/components/button-group/ButtonGroup.tsx +491 -0
  430. package/src/components/button-group/index.ts +10 -0
  431. package/src/components/card-select/CardSelect.mdx +662 -0
  432. package/src/components/card-select/CardSelect.stories.tsx +784 -0
  433. package/src/components/card-select/CardSelect.tsx +783 -0
  434. package/src/components/card-select/CardSelectGroup.tsx +169 -0
  435. package/src/components/card-select/index.ts +18 -0
  436. package/src/components/checkbox/Checkbox.mdx +269 -0
  437. package/src/components/checkbox/Checkbox.stories.tsx +306 -0
  438. package/src/components/checkbox/Checkbox.tsx +343 -0
  439. package/src/components/checkbox/index.ts +1 -0
  440. package/src/components/chip/Chip.mdx +683 -0
  441. package/src/components/chip/Chip.stories.tsx +734 -0
  442. package/src/components/chip/Chip.tsx +732 -0
  443. package/src/components/chip/index.ts +9 -0
  444. package/src/components/column-header/ColumnHeader.mdx +301 -0
  445. package/src/components/column-header/ColumnHeader.stories.tsx +319 -0
  446. package/src/components/column-header/ColumnHeader.tsx +287 -0
  447. package/src/components/column-header/index.ts +7 -0
  448. package/src/components/combobox-field/Combobox.tsx +693 -0
  449. package/src/components/combobox-field/ComboboxField.mdx +525 -0
  450. package/src/components/combobox-field/ComboboxField.stories.tsx +502 -0
  451. package/src/components/combobox-field/ComboboxField.tsx +259 -0
  452. package/src/components/combobox-field/index.ts +12 -0
  453. package/src/components/date-field/DateField.mdx +340 -0
  454. package/src/components/date-field/DateField.stories.tsx +221 -0
  455. package/src/components/date-field/DateField.tsx +176 -0
  456. package/src/components/date-field/index.ts +1 -0
  457. package/src/components/date-picker/DatePicker.mdx +436 -0
  458. package/src/components/date-picker/DatePicker.stories.tsx +458 -0
  459. package/src/components/date-picker/DatePicker.tsx +688 -0
  460. package/src/components/date-picker/index.ts +9 -0
  461. package/src/components/divider/Divider.mdx +256 -0
  462. package/src/components/divider/Divider.stories.tsx +177 -0
  463. package/src/components/divider/Divider.tsx +193 -0
  464. package/src/components/divider/index.ts +1 -0
  465. package/src/components/drawer/Drawer.mdx +518 -0
  466. package/src/components/drawer/Drawer.stories.tsx +392 -0
  467. package/src/components/drawer/Drawer.tsx +683 -0
  468. package/src/components/drawer/index.ts +1 -0
  469. package/src/components/dropdown-button/DropdownButton.mdx +285 -0
  470. package/src/components/dropdown-button/DropdownButton.stories.tsx +398 -0
  471. package/src/components/dropdown-button/DropdownButton.tsx +198 -0
  472. package/src/components/dropdown-button/index.ts +7 -0
  473. package/src/components/faq/FAQ.mdx +364 -0
  474. package/src/components/faq/FAQ.stories.tsx +343 -0
  475. package/src/components/faq/FAQ.tsx +337 -0
  476. package/src/components/faq/index.ts +1 -0
  477. package/src/components/field/Field.mdx +129 -0
  478. package/src/components/field/Field.stories.tsx +461 -0
  479. package/src/components/field/Field.tsx +765 -0
  480. package/src/components/field/index.ts +20 -0
  481. package/src/components/field-pair/FieldPair.mdx +308 -0
  482. package/src/components/field-pair/FieldPair.stories.tsx +530 -0
  483. package/src/components/field-pair/FieldPair.tsx +796 -0
  484. package/src/components/field-pair/index.ts +9 -0
  485. package/src/components/file-upload/FileUpload.mdx +345 -0
  486. package/src/components/file-upload/FileUpload.stories.tsx +698 -0
  487. package/src/components/file-upload/FileUpload.tsx +802 -0
  488. package/src/components/file-upload/index.ts +6 -0
  489. package/src/components/filter-chip/FilterChip.mdx +778 -0
  490. package/src/components/filter-chip/FilterChip.stories.tsx +827 -0
  491. package/src/components/filter-chip/FilterChip.tsx +881 -0
  492. package/src/components/filter-chip/index.ts +11 -0
  493. package/src/components/filter-facet/FilterFacet.mdx +536 -0
  494. package/src/components/filter-facet/FilterFacet.stories.tsx +506 -0
  495. package/src/components/filter-facet/FilterFacet.tsx +1160 -0
  496. package/src/components/filter-facet/index.ts +7 -0
  497. package/src/components/firm-avatar/FirmAvatar.mdx +280 -0
  498. package/src/components/firm-avatar/FirmAvatar.stories.tsx +147 -0
  499. package/src/components/firm-avatar/FirmAvatar.tsx +172 -0
  500. package/src/components/firm-avatar/index.ts +7 -0
  501. package/src/components/form-actions/FormActions.mdx +518 -0
  502. package/src/components/form-actions/FormActions.stories.tsx +621 -0
  503. package/src/components/form-actions/FormActions.tsx +273 -0
  504. package/src/components/form-actions/index.ts +6 -0
  505. package/src/components/form-block/FormBlock.mdx +728 -0
  506. package/src/components/form-block/FormBlock.stories.tsx +813 -0
  507. package/src/components/form-block/FormBlock.tsx +679 -0
  508. package/src/components/form-block/index.ts +13 -0
  509. package/src/components/form-section/FormSection.mdx +436 -0
  510. package/src/components/form-section/FormSection.stories.tsx +407 -0
  511. package/src/components/form-section/FormSection.tsx +290 -0
  512. package/src/components/form-section/index.ts +17 -0
  513. package/src/components/heading/Heading.mdx +206 -0
  514. package/src/components/heading/Heading.stories.tsx +169 -0
  515. package/src/components/heading/Heading.tsx +124 -0
  516. package/src/components/heading/index.ts +8 -0
  517. package/src/components/heading-group/HeadingGroup.mdx +521 -0
  518. package/src/components/heading-group/HeadingGroup.stories.tsx +353 -0
  519. package/src/components/heading-group/HeadingGroup.tsx +396 -0
  520. package/src/components/heading-group/index.ts +7 -0
  521. package/src/components/hero/Hero.mdx +742 -0
  522. package/src/components/hero/Hero.stories.tsx +527 -0
  523. package/src/components/hero/Hero.tsx +807 -0
  524. package/src/components/hero/index.ts +1 -0
  525. package/src/components/icon/Icon.mdx +329 -0
  526. package/src/components/icon/Icon.stories.tsx +398 -0
  527. package/src/components/icon/Icon.tsx +97 -0
  528. package/src/components/icon/index.ts +2 -0
  529. package/src/components/icon-button/IconButton.mdx +206 -0
  530. package/src/components/icon-button/IconButton.stories.tsx +341 -0
  531. package/src/components/icon-button/IconButton.tsx +273 -0
  532. package/src/components/icon-button/index.ts +1 -0
  533. package/src/components/item-row/ItemRow.mdx +533 -0
  534. package/src/components/item-row/ItemRow.stories.tsx +434 -0
  535. package/src/components/item-row/ItemRow.tsx +676 -0
  536. package/src/components/item-row/index.ts +9 -0
  537. package/src/components/list-row/ListRow.mdx +404 -0
  538. package/src/components/list-row/ListRow.stories.tsx +404 -0
  539. package/src/components/list-row/ListRow.tsx +424 -0
  540. package/src/components/list-row/index.ts +1 -0
  541. package/src/components/menu/Menu.mdx +268 -0
  542. package/src/components/menu/Menu.stories.tsx +455 -0
  543. package/src/components/menu/Menu.tsx +452 -0
  544. package/src/components/menu/index.ts +1 -0
  545. package/src/components/modal/Modal.mdx +854 -0
  546. package/src/components/modal/Modal.stories.tsx +881 -0
  547. package/src/components/modal/Modal.tsx +1434 -0
  548. package/src/components/modal/index.ts +1 -0
  549. package/src/components/nav-link/NavLink.mdx +196 -0
  550. package/src/components/nav-link/NavLink.stories.tsx +243 -0
  551. package/src/components/nav-link/NavLink.tsx +222 -0
  552. package/src/components/nav-link/index.ts +1 -0
  553. package/src/components/number-field/NumberField.mdx +223 -0
  554. package/src/components/number-field/NumberField.stories.tsx +291 -0
  555. package/src/components/number-field/NumberField.tsx +388 -0
  556. package/src/components/number-field/index.ts +6 -0
  557. package/src/components/pagination/Pagination.mdx +305 -0
  558. package/src/components/pagination/Pagination.stories.tsx +333 -0
  559. package/src/components/pagination/Pagination.tsx +343 -0
  560. package/src/components/pagination/index.ts +8 -0
  561. package/src/components/popover-surface/PopoverSurface.mdx +158 -0
  562. package/src/components/popover-surface/PopoverSurface.stories.tsx +421 -0
  563. package/src/components/popover-surface/index.ts +1 -0
  564. package/src/components/progress-bar/ProgressBar.mdx +802 -0
  565. package/src/components/progress-bar/ProgressBar.stories.tsx +533 -0
  566. package/src/components/progress-bar/ProgressBar.tsx +654 -0
  567. package/src/components/progress-bar/index.ts +9 -0
  568. package/src/components/promo-sticker/PromoSticker.mdx +436 -0
  569. package/src/components/promo-sticker/PromoSticker.stories.tsx +363 -0
  570. package/src/components/promo-sticker/PromoSticker.tsx +313 -0
  571. package/src/components/promo-sticker/index.ts +7 -0
  572. package/src/components/promo-surface/PromoSurface.mdx +399 -0
  573. package/src/components/promo-surface/PromoSurface.stories.tsx +270 -0
  574. package/src/components/promo-surface/PromoSurface.tsx +305 -0
  575. package/src/components/promo-surface/index.ts +7 -0
  576. package/src/components/radio/Radio.mdx +243 -0
  577. package/src/components/radio/Radio.stories.tsx +307 -0
  578. package/src/components/radio/Radio.tsx +288 -0
  579. package/src/components/radio/index.ts +1 -0
  580. package/src/components/radio-group/RadioGroup.mdx +119 -0
  581. package/src/components/radio-group/RadioGroup.stories.tsx +225 -0
  582. package/src/components/radio-group/RadioGroup.tsx +139 -0
  583. package/src/components/radio-group/index.ts +1 -0
  584. package/src/components/select/Select.mdx +241 -0
  585. package/src/components/select/Select.stories.tsx +404 -0
  586. package/src/components/select/Select.tsx +381 -0
  587. package/src/components/select/index.ts +1 -0
  588. package/src/components/select-field/SelectField.mdx +324 -0
  589. package/src/components/select-field/SelectField.stories.tsx +460 -0
  590. package/src/components/select-field/SelectField.tsx +138 -0
  591. package/src/components/select-field/index.ts +1 -0
  592. package/src/components/skeleton/Skeleton.mdx +194 -0
  593. package/src/components/skeleton/Skeleton.stories.tsx +260 -0
  594. package/src/components/skeleton/Skeleton.tsx +107 -0
  595. package/src/components/skeleton/index.ts +1 -0
  596. package/src/components/split-button/SplitButton.mdx +445 -0
  597. package/src/components/split-button/SplitButton.stories.tsx +465 -0
  598. package/src/components/split-button/SplitButton.tsx +361 -0
  599. package/src/components/split-button/index.ts +7 -0
  600. package/src/components/status-summary-bar/StatusSummaryBar.mdx +338 -0
  601. package/src/components/status-summary-bar/StatusSummaryBar.stories.tsx +408 -0
  602. package/src/components/status-summary-bar/StatusSummaryBar.tsx +428 -0
  603. package/src/components/status-summary-bar/index.ts +8 -0
  604. package/src/components/subject-lookup-field/SubjectLookupField.mdx +378 -0
  605. package/src/components/subject-lookup-field/SubjectLookupField.stories.tsx +393 -0
  606. package/src/components/subject-lookup-field/SubjectLookupField.tsx +1079 -0
  607. package/src/components/subject-lookup-field/index.ts +11 -0
  608. package/src/components/switch/Switch.mdx +376 -0
  609. package/src/components/switch/Switch.stories.tsx +296 -0
  610. package/src/components/switch/Switch.tsx +483 -0
  611. package/src/components/switch/index.ts +1 -0
  612. package/src/components/table/Table.mdx +575 -0
  613. package/src/components/table/Table.stories.tsx +1049 -0
  614. package/src/components/table/Table.tsx +745 -0
  615. package/src/components/table/TableConsumers.stories.tsx +195 -0
  616. package/src/components/table/_tableFixtures.ts +1189 -0
  617. package/src/components/table/index.ts +22 -0
  618. package/src/components/text-field/TextField.mdx +479 -0
  619. package/src/components/text-field/TextField.stories.tsx +366 -0
  620. package/src/components/text-field/TextField.tsx +391 -0
  621. package/src/components/text-field/index.ts +8 -0
  622. package/src/components/text-link/TextLink.mdx +353 -0
  623. package/src/components/text-link/TextLink.stories.tsx +458 -0
  624. package/src/components/text-link/TextLink.tsx +504 -0
  625. package/src/components/text-link/index.ts +10 -0
  626. package/src/components/textarea/Textarea.mdx +244 -0
  627. package/src/components/textarea/Textarea.stories.tsx +371 -0
  628. package/src/components/textarea/Textarea.tsx +489 -0
  629. package/src/components/textarea/index.ts +9 -0
  630. package/src/components/tooltip/Tooltip.mdx +462 -0
  631. package/src/components/tooltip/Tooltip.stories.tsx +500 -0
  632. package/src/components/tooltip/Tooltip.tsx +756 -0
  633. package/src/components/tooltip/index.ts +13 -0
  634. package/src/components/unit-field/UnitField.mdx +215 -0
  635. package/src/components/unit-field/UnitField.stories.tsx +291 -0
  636. package/src/components/unit-field/UnitField.tsx +255 -0
  637. package/src/components/unit-field/index.ts +7 -0
  638. package/src/icons/icon-registry.generated.ts +510 -0
  639. package/src/icons/icon-types.generated.ts +256 -0
  640. package/src/index.ts +71 -0
  641. package/src/internal/BottomSheet.tsx +714 -0
  642. package/src/internal/FodsProvider.tsx +36 -0
  643. package/src/internal/MotionCaret.tsx +53 -0
  644. package/src/internal/NumberFormatInput.tsx +276 -0
  645. package/src/internal/SummaryDonut.tsx +359 -0
  646. package/src/internal/buttonSegment.ts +241 -0
  647. package/src/internal/collapseRoom.ts +130 -0
  648. package/src/internal/comboboxKeys.ts +90 -0
  649. package/src/internal/contentPresence.ts +46 -0
  650. package/src/internal/dayCell.ts +274 -0
  651. package/src/internal/dialogPortal.ts +50 -0
  652. package/src/internal/donutSweeps.ts +77 -0
  653. package/src/internal/enterOnViewGeometry.ts +53 -0
  654. package/src/internal/faqItem.ts +104 -0
  655. package/src/internal/floatingLabelMotion.tsx +109 -0
  656. package/src/internal/formBlockContext.ts +27 -0
  657. package/src/internal/heightRoom.ts +135 -0
  658. package/src/internal/numberSeparators.ts +93 -0
  659. package/src/internal/overlayMotion.tsx +32 -0
  660. package/src/internal/paginationItem.ts +106 -0
  661. package/src/internal/popoverSurface.ts +78 -0
  662. package/src/internal/portalContainer.ts +11 -0
  663. package/src/internal/progressBarItem.ts +356 -0
  664. package/src/internal/selectionControlText.ts +42 -0
  665. package/src/internal/statusSummaryParts.tsx +475 -0
  666. package/src/internal/summaryMotion.ts +111 -0
  667. package/src/internal/table/ChildConnector.tsx +57 -0
  668. package/src/internal/table/ChildRowPrefix.tsx +21 -0
  669. package/src/internal/table/ColumnSettings.tsx +194 -0
  670. package/src/internal/table/ScrollRegion.tsx +176 -0
  671. package/src/internal/table/TableEmpty.tsx +99 -0
  672. package/src/internal/table/TableLayout.tsx +29 -0
  673. package/src/internal/table/TableLoadStatus.tsx +60 -0
  674. package/src/internal/table/TableMobile.tsx +582 -0
  675. package/src/internal/table/TruncatedCell.tsx +35 -0
  676. package/src/internal/table/emptyValue.ts +11 -0
  677. package/src/internal/table/features.ts +44 -0
  678. package/src/internal/table/recipes.ts +263 -0
  679. package/src/internal/table/rowClick.ts +8 -0
  680. package/src/internal/table/types.ts +342 -0
  681. package/src/internal/tailwind-variants.ts +65 -0
  682. package/src/internal/tooltipContext.ts +15 -0
  683. package/src/internal/tw-merge-config.generated.ts +275 -0
  684. package/src/internal/useAnchoredPanel.ts +340 -0
  685. package/src/internal/useCountUp.ts +65 -0
  686. package/src/internal/useDateFieldTrigger.tsx +357 -0
  687. package/src/internal/useEChart.ts +88 -0
  688. package/src/internal/useEnterOnView.ts +80 -0
  689. package/src/internal/useFloatingBar.ts +125 -0
  690. package/src/internal/useFormReset.ts +47 -0
  691. package/src/internal/useIsMobile.ts +64 -0
  692. package/src/internal/useNoImplicitSubmit.ts +41 -0
  693. package/src/internal/useOneRowOverflow.ts +103 -0
  694. package/src/internal/usePrefersReducedMotion.ts +27 -0
  695. package/src/internal/useReturnFocus.ts +34 -0
  696. package/src/internal/utils.ts +58 -0
  697. package/src/recipes/EmptyState.stories.tsx +105 -0
  698. package/src/recipes/Form.stories.tsx +355 -0
  699. package/src/recipes/ModalWithForm.stories.tsx +219 -0
  700. package/src/recipes/Recipes.mdx +61 -0
  701. package/src/recipes/TableWithFilters.stories.tsx +278 -0
  702. package/src/storybook/FodsFamily.tsx +39 -0
  703. package/src/storybook/Section.tsx +36 -0
  704. package/src/storybook/a11y.ts +24 -0
  705. package/src/storybook/assets/banner-character-bartender.webp +0 -0
  706. package/src/storybook/assets/banner-invoice-sheet-left.webp +0 -0
  707. package/src/storybook/assets/banner-invoice-sheet-right.webp +0 -0
  708. package/src/storybook/assets/invoice-hero.webp +0 -0
  709. package/src/storybook/assets/invoice.webp +0 -0
  710. package/src/storybook/assets/section-document-info.svg +21 -0
  711. package/src/storybook/assets/section-gear-checklist.svg +11 -0
  712. package/src/storybook/assets/section-person-arrow-in.svg +15 -0
  713. package/src/storybook/assets/section-person-arrow-out.svg +22 -0
  714. package/src/storybook/assets/section-receipt-dollar.svg +23 -0
  715. package/src/storybook/assets/table-empty-folder-empty.png +0 -0
  716. package/src/storybook/assets/table-empty-folder-magnifying-glass.png +0 -0
  717. package/src/storybook/assets/table-empty-funnel.png +0 -0
  718. package/src/storybook/assets/table-empty-load-failed.png +0 -0
  719. package/src/storybook/assets/wallet-spot.png +0 -0
  720. package/src/storybook/assets.d.ts +17 -0
  721. package/src/storybook/componentDoc.ts +41 -0
  722. package/src/storybook/fitFrame.tsx +70 -0
  723. package/src/storybook/forceStates.tsx +647 -0
  724. package/src/storybook/illustrations.tsx +66 -0
  725. package/src/storybook/viewportFrame.tsx +58 -0
  726. package/src/styles/assets/label-brush-1.svg +6 -0
  727. package/src/styles/assets/pattern-dark.svg +113 -0
  728. package/src/styles/base.css +106 -0
  729. package/src/styles/index.css +15 -0
  730. package/src/styles/motion.css +157 -0
  731. package/src/styles/promo-sticker.css +27 -0
  732. package/src/styles/promo-surface.css +49 -0
  733. package/src/styles/shared.css +11 -0
  734. package/src/styles/theme.generated.css +314 -0
  735. package/src/styles/theme.map.json +278 -0
  736. package/src/styles/tracking.generated.css +12 -0
  737. package/src/tokens/index.ts +4 -0
  738. package/src/tokens/tokens.generated.ts +542 -0
@@ -0,0 +1,802 @@
1
+ import { Meta, Canvas, Controls } from '@storybook/addon-docs/blocks';
2
+ import * as ProgressBarStories from './ProgressBar.stories';
3
+
4
+
5
+ <Meta of={ProgressBarStories} tags={['autodocs']} />
6
+
7
+ # ProgressBar
8
+
9
+ ## Metadata
10
+
11
+ - **Layer:** molecule
12
+ - **Status:** draft
13
+ - **Manifest version:** `1.12.1`
14
+ - **Step manifest:** `_progress-bar-item` version `3.4.1` — the private per-step contract (marker, halo, text runs, and the Done button's surface); no doc page of its own, everything a dev needs lives here
15
+ - **Tokens used:** `--bg-active`, `--bg-hover`, `--bg-primary`, `--border-width-200`, `--font-body`, `--font-decorative`, `--font-size-base`, `--font-size-lg`, `--font-size-sm`, `--font-size-xs`, `--font-weight-semibold`, `--leading-compact`, `--leading-loose`, `--leading-relaxed`, `--outline-default`, `--outline-focus`, `--outline-strong`, `--primary`, `--radius-200`, `--radius-300`, `--radius-full`, `--secondary-solid`, `--size-icon`, `--space-100`, `--space-1000`, `--space-1200`, `--space-200`, `--space-400`, `--space-450`, `--space-500`, `--space-600`, `--space-800`, `--status-success-solid`, `--text-placeholder`, `--text-primary`, `--text-secondary`, `--text-wrap-body`
16
+
17
+ The manifests are `spec/04-molecules/progress-bar.manifest.json` and
18
+ `spec/03-atoms/_progress-bar-item.manifest.json` (versions above); a bump of either one
19
+ re-opens the component per Definition of Done (e) (`COMPONENT-CODE-CONVENTIONS.md` §6).
20
+
21
+ ## Overview
22
+
23
+ ProgressBar is a **multi-step progress indicator**: one continuous rail behind a row (or column)
24
+ of self-describing step markers, filled up to the Current step. Progress is expressed entirely by
25
+ the children — everything before `currentStep` is Done, `currentStep` is Current, everything after
26
+ is Upcoming, and the fill's length follows from that invariant.
27
+
28
+ **Use it** for a fixed, ordered sequence whose position must be visible at a glance: a product
29
+ wizard's step band (Small) or a marketing rollout / timeline narrative (Large).
30
+
31
+ **Do not use it** for paging a result set (that is `Pagination`), for a percentage or an
32
+ indeterminate load (the component has no such mode — there is no `value` prop, only `currentStep`),
33
+ or for a set of independent actions with no fixed order (that is `ButtonGroup`).
34
+
35
+ ## Rationale
36
+
37
+ **One rail, owned by the bar.** The rail and the fill are two absolutely positioned elements
38
+ rendered *before* the step list; a step draws no connecting line of its own. That is the whole
39
+ reason the v1 shape — `StepperItem` with a connector half on each item — is retired: a single
40
+ element can slide forward, N joined half-segments cannot, and they break at every seam. The
41
+ manifest states it as `intent.rules[0]`, and the item manifest repeats it from the other side
42
+ ("The item draws NO connecting line").
43
+
44
+ **The state is derived, never passed.** There is no `state` prop and no marker-content choice: the
45
+ index compared against `currentStep` picks Done / Current / Upcoming, and the marker construction
46
+ follows that state 1:1. A degree of freedom that was never real (a Done step is never anything but
47
+ a checkmark) is simply gone.
48
+
49
+ **The halo travels with the step.** The page-coloured disc under each marker belongs to the step,
50
+ not to the rail, so any composition that puts a rail behind these markers gets the track-to-marker
51
+ air for free instead of hand-placing ellipses (upstream had already drifted that geometry twice).
52
+
53
+ **Row ↔ Stack is the bar's own content-fit fallback.** Not a breakpoint, and not something the
54
+ consumer wires — it passes the preferred layout, see [Layout](#layout-row--stack).
55
+
56
+ ## Anatomy
57
+
58
+ The rendered tree, with the `data-fods-part` markers the FODS probe grades against:
59
+
60
+ - **Root** (`<div>`, `data-fods-part="root"`) — `relative isolate grid`. It binds no colour of its
61
+ own; what it owns is the grid the rail geometry is measured against. Row sets
62
+ `grid-template-columns: repeat(N, minmax(0, 1fr))`, Stack sets `grid-template-rows: repeat(N, auto)`
63
+ plus a `--space-200` row gutter — both inline from `steps.length`, because the count is content and
64
+ no recipe variant could carry it. Your `className`, `style` and the forwarded `ref` land here.
65
+ - **Track** (`<div aria-hidden="true">`, `data-fods-part="track"`) — the neutral rail,
66
+ `--outline-default`, `--radius-200`, 4px thick (`h-200` in Row, `w-200` in Stack). It sits
67
+ **outside** the list, as the `<ol>`'s sibling inside the root, so the list holds the steps and
68
+ nothing else. It is a grid child of the root and takes its geometry from the same tracks the steps
69
+ sit in. `aria-hidden` keeps it out of what a reader hears. It renders only when there are more than
70
+ one step.
71
+ - **Track fill** (`<span>`, `data-fods-part="track-fill"`) — the progressed run, same geometry as the
72
+ rail, accent-coloured: `--secondary-solid` (Blue) / `--primary` (Orange). Its length is the inline
73
+ percentage `(currentStep / (stepCount − 1)) * 100%` — the manifest's own formula, chosen so it needs
74
+ no measurement and survives a container resize.
75
+ - **List** (`<ol role="list">`) — the steps and nothing else. It spans the root's grid and adopts its
76
+ tracks through `subgrid` (`display: contents` would leave the Row → Stack fallback no box to
77
+ measure). `role="list"` next to `<ol>` is not redundant: Tailwind preflight sets
78
+ `list-style: none`, which drops the list role in Safari.
79
+ - **Step** (`<li>`, `data-fods-part="step"`, `data-fods-state="done" | "current" | "upcoming"`) — one
80
+ per entry in `steps`. It carries no ink; what it carries is the state attribute every descendant
81
+ part narrows on, and `aria-current="step"` when it is the Current one.
82
+ - **Marker box** — the layout anchor, 26 / 24 (`sizes[].box`) — the marker's own Ø, not including
83
+ the halo, which overhangs it by 2 on every side (Ø 30 / 28). Half of this box is the offset that
84
+ puts the rail on the marker's centre line.
85
+ - **Halo** (`data-fods-part="halo"`, `aria-hidden`) — the page-coloured disc (`--bg-primary`) under the
86
+ marker, `--radius-full`, absolutely centred on the box. It is the air between the rail and the
87
+ marker edge. Constant across every state and accent.
88
+ - **Marker** (`data-fods-part="marker"`, `aria-hidden`) — the ring / glyph, `--radius-full`.
89
+ `relative` is load-bearing: the halo is an absolutely positioned *sibling*, and a positioned element
90
+ paints above non-positioned in-flow content whatever the DOM order, so the marker has to be
91
+ positioned too to land on top of its own halo.
92
+ - **Marker contents** — one of three, by state: an inline `check-circle` path filled with
93
+ `--status-success-solid` (Done), a centre **dot** (`data-fods-part="dot"`, accent fill) inside the
94
+ ring (Current), or the ordinal **number** (`data-fods-part="number"`, `--text-placeholder`) (Upcoming, unless
95
+ `showNumbers` is off — then the ring stays empty at the same size).
96
+ The Done path stays inline for geometry, not availability: the icon set does ship this drawing
97
+ (`<Icon name="check-circle" />`), but `size-full` ties the glyph to the
98
+ ring's diameter by construction, where an `<Icon>` glyph is sized as a `--size-icon*` slot box and
99
+ the drawing fills only part of it, so matching the ring would repeat the 24 / 22 numbers the recipe
100
+ already owns.
101
+ - **Text column** — **Title** (`data-fods-part="title"`, `--font-body` Semibold, `--text-primary` on
102
+ Done and Current, `--text-secondary` on Upcoming, wraps via `--text-wrap-body`) and **Detail**
103
+ (`data-fods-part="detail"`, constant `--text-secondary`, clamped at two lines). Row puts the column
104
+ under the marker and centres it, Stack puts it beside the marker.
105
+ - **Pointer callout** (`data-fods-part="pointer-label"`) — Row × Current only, see
106
+ [Pointer callout](#pointer-callout).
107
+
108
+ ### Paint order comes out of the DOM, with one scoped `z-index`
109
+
110
+ rail → fill → halo → marker: the track pair renders **before** the step list, so each step paints
111
+ over it; inside a step the halo is absolutely positioned and the marker is `relative`, so the
112
+ marker paints over its own halo. Break that order and the geometry reads wrong. The only `z-index`
113
+ in the bar is the Done wash's: its `::before` layer is `-z-10` inside the root's `isolate` context,
114
+ which puts it under the rail — exactly where the button's own background used to paint — without
115
+ leaking out of the bar.
116
+
117
+ ### Rail geometry, without measuring anything
118
+
119
+ The manifest is explicit (`motion.states.value.note`, verbatim): *"Measure the rail's ends from the real
120
+ marker centres, not from a halo-derived inset: a titled step is as wide as its text, so a halo-based
121
+ inset leaves the rail sticking out past the first marker."* Both layouts get that from CSS grid — the
122
+ track geometry itself needs no JS and no `ResizeObserver` (the only measurement the component does
123
+ is the Row ↔ Stack content-fit fallback since 1.9.0, which uses a `ResizeObserver` on the parent and
124
+ never touches the rail):
125
+
126
+ <table>
127
+ <thead>
128
+ <tr><th>Layout</th><th>Grid placement</th><th>Ends</th></tr>
129
+ </thead>
130
+ <tbody>
131
+ <tr>
132
+ <td><code>row</code></td>
133
+ <td>absolutely positioned child of grid area <code>1 / -1</code> in row 1</td>
134
+ <td><code>left</code> = <code>right</code> = <code>50 / N %</code> — with N equal columns each marker is centred in its own column, so the first and last centres sit exactly half a column in from each edge. The grid <em>area</em> is the containing block for an abspos grid child, which is what makes the percentage resolve against the steps' box rather than against the root's border edge (and keeps the rail below the pointer's top reserve).</td>
135
+ </tr>
136
+ <tr>
137
+ <td><code>stack</code></td>
138
+ <td>grid area <code>1 / N</code> in column 1</td>
139
+ <td><code>top</code> = half a marker box walks the head onto the first marker's centre; a negative <code>bottom</code> of <code>calc(--space-200 + box/2)</code> walks the tail onto the last one's. The gap term is <strong>not</strong> a typo: a grid area ending on line N reaches the end of track N−1, and the last track starts one gutter further down — without it the rail stops <code>--space-200</code> short of the last marker at every step count. Keeping it as a <code>calc()</code> on the token means the rail follows a retune of the row gap instead of silently drifting.</td>
140
+ </tr>
141
+ </tbody>
142
+ </table>
143
+
144
+ What is halved is the marker **box**, never the halo: the halo is centred on the box and only
145
+ describes how much air the rail loses at each marker, never where the centre is.
146
+
147
+ ## Variants
148
+
149
+ <Canvas of={ProgressBarStories.Matrix} />
150
+
151
+ Three axes, 8 built variants — **Size** (Large · Small) × **Layout** (Row · Stack) × **Accent**
152
+ (Blue · Orange). Size and Layout get their own sections below; the Accent axis is the only one that
153
+ carries colour:
154
+
155
+ <table>
156
+ <thead>
157
+ <tr><th>Accent</th><th>When</th><th>Tokens</th></tr>
158
+ </thead>
159
+ <tbody>
160
+ <tr>
161
+ <td><code>blue</code> (default)</td>
162
+ <td>Everywhere in product, wizards included.</td>
163
+ <td>fill <code>--secondary-solid</code>; Current ring <code>--secondary-solid</code>; Current dot <code>--secondary-solid</code></td>
164
+ </tr>
165
+ <tr>
166
+ <td><code>orange</code></td>
167
+ <td>The four marketing / signature slots only — brand governance, not decoration.</td>
168
+ <td>fill <code>--primary</code>; Current ring <code>--primary</code>; Current dot <code>--primary</code></td>
169
+ </tr>
170
+ </tbody>
171
+ </table>
172
+
173
+ Accent-**independent** in both families: the rail (`--outline-default`), the Done check
174
+ (`--status-success-solid`), the Upcoming ring (`--outline-strong`), the Upcoming digit
175
+ (`--text-placeholder`), the halo (`--bg-primary`), Title, Detail — and the pointer label, which stays
176
+ `--primary` even inside a Blue bar because it is a brand flourish, not status ink. That callout is the
177
+ one place in this component the Accent axis does not reach.
178
+
179
+ ### Layout (Row ↔ Stack)
180
+
181
+ <Canvas of={ProgressBarStories.ContentFitFallback} />
182
+
183
+ `layout` is the **preferred** layout, not a breakpoint. Since 1.9.0 the bar owns the content-fit
184
+ fallback (`delivery.react`): given Row it renders Row, measures real overflow of its own root
185
+ (`scrollWidth > clientWidth`) and falls back to Stack by itself — the same principle as
186
+ `06-patterns/responsive-collapse.md`. The consumer never wires the fallback. The question is only
187
+ asked in Row (asked while stacked it would always answer "fits"), so every width change of the
188
+ bar's **parent** re-renders Row once and measures it before paint; the parent, because a stacked
189
+ bar may be content-sized and then never resizes. A web font that finishes loading after the first
190
+ probe widens the text without resizing anything, so `document.fonts` `loadingdone` re-measures too.
191
+ The rendered layout is published as
192
+ `data-layout="row" | "stack"` on the root for consumer styling (`data-[layout=stack]:…`).
193
+
194
+ The clip floor that makes the measurement fire is `_progress-bar-item` `sizes[].minWidthWhen` —
195
+ `min-width: 150px` on a Row step that renders a Title or a Detail (3.0.1). A marker-only step has no
196
+ floor beyond its halo, which is what lets the 480 × 4 wizard band (120 per step) render as Row.
197
+
198
+ DOM order is sequence order in both layouts, so `aria-current` needs no per-layout special-casing.
199
+
200
+ ### Boolean switches — what each one hides
201
+
202
+ Three independent booleans, each hiding exactly one thing and moving nothing else.
203
+
204
+ <Canvas of={ProgressBarStories.BareMarkers} />
205
+
206
+ `showTitle` and `showDetail` gate the two text runs (both default `true`); a run also needs the step
207
+ to actually carry the string, so a step with no `title` renders no Title even with `showTitle` on.
208
+ Both booleans off is the **bare-marker wizard band** — and in that mode `stepLabels` is required by
209
+ the props union, see [Accessibility](#accessibility).
210
+
211
+ <Canvas of={ProgressBarStories.NumberlessMarkers} />
212
+
213
+ `showNumbers` (default `true`) gates the ordinal digit in the Upcoming ring. The ring keeps its
214
+ diameter and renders empty, so nothing reflows; Done keeps its check and Current its centre dot,
215
+ which is why the three states stay apart by shape even with the digits gone. It is a bar-level prop
216
+ rather than per-step because Figma cannot bind a parent boolean to a nested instance property.
217
+
218
+ ### Step count is content
219
+
220
+ <Canvas of={ProgressBarStories.StepCount} />
221
+
222
+ There is no Steps axis: the count is `steps.length`, bounded **2–6** by the manifest. Below 2 there is
223
+ no progression to show — the component clamps `fillPercent` to 0 when there is a single step and
224
+ renders no rail at all. Above 6 a Row band stops fitting a modal's capped column and the sequence
225
+ stops being glanceable; split the flow into more steps of fewer items instead of growing the bar.
226
+
227
+ At the 2-step floor the fill has exactly two valid renders — zero-length (Current is first) and
228
+ spanning the whole rail (Current is last). Both fall out of the same formula and both are correct,
229
+ not edge cases to special-case.
230
+
231
+ `currentStep` is clamped into range before anything is derived, so an out-of-range index degrades to
232
+ the first or the last step rather than rendering a bar with no Current at all.
233
+
234
+ ## Sizes
235
+
236
+ <Canvas of={ProgressBarStories.Sizes} />
237
+
238
+ <table>
239
+ <thead>
240
+ <tr>
241
+ <th>Size</th>
242
+ <th>Marker box / halo</th>
243
+ <th>Ring / dot</th>
244
+ <th>Type</th>
245
+ <th>Rail offset</th>
246
+ </tr>
247
+ </thead>
248
+ <tbody>
249
+ <tr>
250
+ <td><code>lg</code> — marketing / hero</td>
251
+ <td>box 26px, halo 30px</td>
252
+ <td>ring 24px (<code>--size-icon</code>) at <code>--border-width-200</code>, dot 12px (<code>--space-500</code>)</td>
253
+ <td>Title <code>--font-size-base</code> Semibold, Detail <code>--font-size-sm</code> / <code>--leading-loose</code></td>
254
+ <td>Row <code>top: 11px</code>; Stack <code>left: 11px</code>, <code>top: 13px</code></td>
255
+ </tr>
256
+ <tr>
257
+ <td><code>sm</code> — product wizard band (default)</td>
258
+ <td>box 24px (<code>--space-800</code>), halo 28px</td>
259
+ <td>ring 22px at <code>--border-width-200</code>, dot 10px (<code>--space-450</code>)</td>
260
+ <td>Title <code>--font-size-sm</code> / <code>--leading-loose</code> Semibold, Detail <code>--font-size-xs</code></td>
261
+ <td>Row <code>top: --space-450</code>; Stack <code>left: --space-450</code>, <code>top: --space-500</code></td>
262
+ </tr>
263
+ </tbody>
264
+ </table>
265
+
266
+ Every construction on Small is one step smaller than on Large, with no exceptions — ring Ø = marker
267
+ box − 2 in **every** state, one rule since the 2026-08-21 unification. The rail is 4px
268
+ (`--space-200`) with `--radius-200` ends at both sizes; the rail offsets above are simply half the
269
+ marker box, minus half the rail thickness in Row.
270
+
271
+ Rhythm, identical in both sizes: Row marker → text `--space-400`; Stack marker → text `--space-600`,
272
+ Title → Detail `--space-200`, text block-padding `--space-100`, step floor `--space-1200`.
273
+
274
+ Never mix sizes inside one bar — pick by surface, not by taste.
275
+
276
+ **Row hugs its height** (1.11.1). The bar, the list and the steps carry no height of their own — a
277
+ `sm` marker-only band is as tall as its halo, an `lg` titled band as tall as marker + Title +
278
+ Detail. The fixed Figma row heights 64 / 130 this replaced left dead space under the markers; the
279
+ code row never had them. A consumer band that needs a floor (the Modal Wizard band) sets it on its
280
+ own chrome, not on the bar.
281
+
282
+ > ℹ️ **Resolved upstream.** `progress-bar.md` § Sizes used to describe "one deliberate
283
+ > asymmetry" — Large's Current ring one size step smaller than the Done/Upcoming rings — while the
284
+ > item manifest's 2026-08-21 changelog lists exactly that as one of three **corrected inversions** and
285
+ > gives Large a single ring Ø 24. The § Sizes paragraph was dropped in `progress-bar` 1.6.1 and the
286
+ > matching § Do / Don't bullet in 1.7.1, so spec and
287
+ > manifest now agree: Large's Current and Upcoming rings match.
288
+
289
+ ## States
290
+
291
+ <Canvas of={ProgressBarStories.States} />
292
+
293
+ The bar itself has no state variants. Each step has three, derived from its index against
294
+ `currentStep`, and the marker construction follows the state 1:1 — there is no marker-content axis:
295
+
296
+ <table>
297
+ <thead>
298
+ <tr><th>State</th><th>When</th><th>Marker</th><th>Title ink</th></tr>
299
+ </thead>
300
+ <tbody>
301
+ <tr>
302
+ <td><code>done</code></td>
303
+ <td>index &lt; <code>currentStep</code></td>
304
+ <td>check-circle glyph, <code>--status-success-solid</code>, drawn at the ring's diameter. No ring stroke, no dot.</td>
305
+ <td><code>--text-primary</code></td>
306
+ </tr>
307
+ <tr>
308
+ <td><code>current</code></td>
309
+ <td>index = <code>currentStep</code> — exactly one per bar</td>
310
+ <td>Accent ring (<code>--border-width-200</code>, <code>--secondary-solid</code> / <code>--primary</code>) on <code>--bg-primary</code>, plus an accent centre dot at half the ring.</td>
311
+ <td><code>--text-primary</code></td>
312
+ </tr>
313
+ <tr>
314
+ <td><code>upcoming</code></td>
315
+ <td>index &gt; <code>currentStep</code></td>
316
+ <td>Neutral ring (<code>--border-width-200</code>, <code>--outline-strong</code>) on <code>--bg-primary</code> with the ordinal digit — Semibold <code>--font-size-sm</code>, <code>--text-placeholder</code>, <code>leading-none</code> so the ring rather than the line box centres it. With <code>showNumbers=&#123;false&#125;</code> the ring renders empty at the same size.</td>
317
+ <td><code>--text-secondary</code></td>
318
+ </tr>
319
+ </tbody>
320
+ </table>
321
+
322
+ The state therefore reads by **shape** as well as by colour (check vs. ring vs. ring + digit), so it
323
+ survives a grayscale or colour-blind rendering. Detail ink is constant `--text-secondary` in all three.
324
+ That still holds with `showNumbers` off, where Upcoming drops to an empty ring — see
325
+ [Boolean switches](#boolean-switches--what-each-one-hides).
326
+
327
+ The stories render the states **statically** — one bar per `currentStep` value — rather than forcing
328
+ them with a pseudo-state addon, because Done / Current / Upcoming are data, not pseudo-classes: moving
329
+ `currentStep` is the only way to reach them, and it is also how a consumer reaches them.
330
+
331
+ ### Interaction — Done steps, and nothing else
332
+
333
+ <Canvas of={ProgressBarStories.Interaction} />
334
+
335
+ `_progress-bar-item` 3.0.0 gave the step an **Interaction axis** (Default · Hover · Active) on
336
+ `State=Done` alone. A completed step is a `<button>` that returns the flow to it, and the target is
337
+ the **whole item** — marker and text in one, never the marker on its own. It paints `--bg-hover` /
338
+ `--bg-active` at `--radius-300`, and its keyboard ring is the shared
339
+ `06-patterns/focus-ring.md`
340
+ offset idiom: `--outline-focus` at `--border-width-200`, offset 2. The manifest asks for the ring's
341
+ radius to be one step up (`--radius-400`) and that costs no class — CSS derives an outline's radius
342
+ as border-radius + outline-offset, and `6 + 2` **is** the 8px `--radius-400`. The ring is drawn
343
+ "2px outside the **surface**" (`focus.note`), and in Row the surface is the grown hit box, not the
344
+ in-flow button — so the outline rides a pseudo-element (`::after`) with the surface's own geometry,
345
+ and the button's native outline is off. See the geometry paragraph below.
346
+
347
+ **Current and Upcoming stay inert.** A user cannot skip ahead, the bar itself never holds focus, and
348
+ no state takes `disabled`. This reverses the pre-3.0.0 contract, which called the step passive
349
+ display and said the ring would attach at the **bar** level if a step ever became clickable; it
350
+ attaches on the step's own button instead.
351
+
352
+ In code the axis is **opt-in, through `onStepClick`**, as the manifest states since 1.10.0: a Done
353
+ step is a button only where the flow can return to it. A product wizard wires the return; a
354
+ marketing timeline (Large — the e-invoice rollout) renders Done static, with no button, no hover /
355
+ press wash and no focus stop. Omit the callback and the markup is
356
+ exactly what shipped before 3.0.0 — the `<li>` keeps the layout and the bar has no tab stop at all.
357
+ Asserted in `ProgressBar.test.tsx` in both directions.
358
+
359
+ <Canvas of={ProgressBarStories.StaticDone} />
360
+
361
+ The wash rows in the canvas above are forced with a bare class rather than a pseudo-state addon:
362
+ Hover and Active are one 3 % step apart, so a row the addon quietly failed to force would be
363
+ indistinguishable from Default and the matrix would read as passing while showing nothing. The focus
364
+ ring is a real `:focus-visible` and cannot be shown that way — Tab into the bar to see it.
365
+
366
+ The geometry differs by layout (`_progress-bar-item` 3.2.0, `parts.surface.note`). **Row only:** the
367
+ surface spans the step's full column width and extends `--space-400` above and below the item so the
368
+ tint clears the halo without moving any content, with a 44px minimum height — in bare-marker mode the
369
+ marker is 26 / 24, so box + 16 would land at 42 / 40 and ship a sub-44 target. The extension is the
370
+ button's absolutely positioned `::before` (which also carries the wash), so the `<li>` keeps the
371
+ item's natural height and a Done step is exactly as tall as Current and Upcoming. The focus ring
372
+ circles that same grown box: it is the outline of an `::after` with the `::before` geometry, kept
373
+ at z auto so the rail cannot paint over its legs, where the wash sits at `-z-10` under the content.
374
+ **Stack has no extension:** the surface is the item's own bounds (both pseudos at `inset-0`), and
375
+ its `min-height` of 64 already clears the 44px target.
376
+
377
+ ### Pointer callout
378
+
379
+ <Canvas of={ProgressBarStories.PointerCallout} />
380
+
381
+ The Current step of a **Row** bar may float a marketing callout above its marker: the hand-lettered
382
+ `--font-decorative` label at `--font-size-lg` / `--leading-compact` on `--primary`, plus a
383
+ rounded-corner arrow pointing down at the marker with **5px** clearance from its top edge — the
384
+ manifest's `parts.pointer-label.geometry` (`arrow-tip-clearance` 5; the older "2px" in the part note
385
+ was corrected upstream). The label keeps `--leading-compact`, because the body 1.5 leading would
386
+ inflate the 26px label box by 4px. 5 falls between `--space-100` and
387
+ `--space-300`, so it is the one raw value here. It is a fixed short phrase in the
388
+ marketing voice ("Jste tady"), never user content, never a wizard tone — Stack masters carry no
389
+ pointer node at all.
390
+
391
+ The height it occupies (`--space-1000`) is reserved on the **bar**, driven by "any step has a
392
+ pointer" rather than by which step is Current — otherwise every marker would jump by the reserve as
393
+ the sequence advances.
394
+
395
+ ### Motion
396
+
397
+ <table>
398
+ <thead>
399
+ <tr><th>What</th><th>How</th><th>Reduced motion</th></tr>
400
+ </thead>
401
+ <tbody>
402
+ <tr>
403
+ <td>Fill travel</td>
404
+ <td><code>transition</code> on <code>width</code> (Row) / <code>height</code> (Stack), <code>--duration-normal</code>, <code>--easing-standard</code> (<code>motion.states.value</code>). Only on a Current change — a mounted bar renders its position with no animation (<code>motion.trigger</code>).</td>
405
+ <td>Kept, shortened to <code>--duration-instant</code>.</td>
406
+ </tr>
407
+ <tr>
408
+ <td>Arriving Current dot</td>
409
+ <td>A named keyframe: opacity 0 → 1, <strong>no scale</strong>, over <code>--duration-fast</code> with <code>--easing-enter</code>, delayed by (normal − fast) so it lands exactly as the fill arrives (<code>_progress-bar-item</code> 3.4.1 <code>motion.states.value</code>). Opacity only — never the marker's box, which would shift the layout.</td>
410
+ <td>Same keyframe at <code>--duration-instant</code>, no delay.</td>
411
+ </tr>
412
+ <tr>
413
+ <td>Pointer callout entrance</td>
414
+ <td>A named keyframe: opacity 0 → 1, over <code>--duration-normal</code> with <code>--easing-enter</code> (<code>_progress-bar-item</code> 3.4.1 <code>motion.enter</code>). The callout stays where it is — it never rises and never scales; no exit — when the step stops being Current the callout is simply removed. Plays once per Current step, never loops.</td>
415
+ <td>Same keyframe at <code>--duration-instant</code>.</td>
416
+ </tr>
417
+ </tbody>
418
+ </table>
419
+
420
+ Four things worth knowing:
421
+
422
+ - **`width` / `height` is a deliberate exception** to the transform-and-opacity-only rule in
423
+ `motion-system.md`. The fill's *ends* carry the meaning — it must stop exactly on a marker centre —
424
+ and a scaled transform would distort the `--radius-200` cap. The rail is 4px and the animation is a
425
+ single element, so the layout cost is negligible.
426
+ - **The dot is a keyframe, not a transition,** because it is a freshly *mounted* element on every step
427
+ change and a transition has no start value to travel from.
428
+ - **Reduced motion shortens, it does not remove.** A progress indicator is essential motion: a frozen
429
+ bar is indistinguishable from a stalled one. The bloom is also armed only by the first `currentStep`
430
+ *change* — a bar that mounts straight into step 3 shows step 3 rather than animating into it.
431
+ - **The pointer callout is the opposite on mount:** it *does* animate when the bar mounts with a step
432
+ already Current, and again on every Current change (the callout only exists on the Current step, so
433
+ it remounts). It is decorative, attention-seeking motion, so reduced motion shortens it for that
434
+ reason rather than the essential-motion one. Its keyframe animates `opacity` only, so it cannot
435
+ touch the callout's horizontal centring (`-translate-x-1/2`).
436
+
437
+ The story below replays the callout entrance: step Current back and forth with **Zpět** / **Další krok**
438
+ and the callout enters once on each newly Current step, then rests.
439
+
440
+ <Canvas of={ProgressBarStories.CalloutEntrance} />
441
+
442
+ ## API
443
+
444
+ <Controls />
445
+
446
+ <table>
447
+ <thead>
448
+ <tr><th>Prop</th><th>Type</th><th>Default</th><th>Notes</th></tr>
449
+ </thead>
450
+ <tbody>
451
+ <tr>
452
+ <td><code>steps</code></td>
453
+ <td><code>ProgressBarStep[]</code></td>
454
+ <td>—</td>
455
+ <td>Required. Each entry may carry <code>title</code>, <code>detail</code> and <code>pointerLabel</code>. Length is the step count, bounded 2–6.</td>
456
+ </tr>
457
+ <tr>
458
+ <td><code>currentStep</code></td>
459
+ <td><code>number</code></td>
460
+ <td>—</td>
461
+ <td>Required, 0-based. Clamped into range; everything before it is Done, everything after Upcoming.</td>
462
+ </tr>
463
+ <tr>
464
+ <td><code>size</code></td>
465
+ <td><code>'lg' | 'sm'</code></td>
466
+ <td><code>'sm'</code></td>
467
+ <td>Figma <code>lg</code> / <code>sm</code> (renamed from Large / Small in 1.11.0).</td>
468
+ </tr>
469
+ <tr>
470
+ <td><code>layout</code></td>
471
+ <td><code>'row' | 'stack'</code></td>
472
+ <td><code>'row'</code></td>
473
+ <td>Figma Row / Stack. The <em>preferred</em> layout: Row falls back to Stack by itself when it overflows; the rendered one is on <code>data-layout</code>.</td>
474
+ </tr>
475
+ <tr>
476
+ <td><code>variant</code></td>
477
+ <td><code>'blue' | 'orange'</code></td>
478
+ <td><code>'blue'</code></td>
479
+ <td>Figma Accent.</td>
480
+ </tr>
481
+ <tr>
482
+ <td><code>showTitle</code></td>
483
+ <td><code>boolean</code></td>
484
+ <td><code>true</code></td>
485
+ <td>Setting it to <code>false</code> makes <code>stepLabels</code> mandatory at the type level.</td>
486
+ </tr>
487
+ <tr>
488
+ <td><code>showDetail</code></td>
489
+ <td><code>boolean</code></td>
490
+ <td><code>true</code></td>
491
+ <td>—</td>
492
+ </tr>
493
+ <tr>
494
+ <td><code>showNumbers</code></td>
495
+ <td><code>boolean</code></td>
496
+ <td><code>true</code></td>
497
+ <td>Figma <code>Show number</code>, code-only on the bar: it covers every Upcoming step at once. Off leaves the neutral ring empty at the same size.</td>
498
+ </tr>
499
+ <tr>
500
+ <td><code>onStepClick</code></td>
501
+ <td><code>(index: number) =&gt; void</code></td>
502
+ <td>—</td>
503
+ <td>Turns every <strong>Done</strong> step into a button that calls back with its 0-based index (<code>_progress-bar-item</code> 3.0.0 Interaction). Current and Upcoming never become interactive. Opt-in on purpose — see <a href="#interaction--done-steps-and-nothing-else">Interaction</a>; omit it and the bar keeps no tab stops.</td>
504
+ </tr>
505
+ <tr>
506
+ <td><code>stepLabels</code></td>
507
+ <td><code>string[]</code></td>
508
+ <td>—</td>
509
+ <td>Visually hidden ordinal per step. Optional while the Title is shown, required once it is not. Rendered whenever a step has no visible Title. It is also what names the Done button in bare-marker mode.</td>
510
+ </tr>
511
+ </tbody>
512
+ </table>
513
+
514
+ The rest of `React.HTMLAttributes<HTMLDivElement>` (minus `children`) is forwarded to the root
515
+ `<div>`, and the `ref` points at it. There is deliberately **no** `state`, no `value` and no `fillPercent`
516
+ prop — the fill length is derived and is never settable on its own.
517
+
518
+ ## Do / Don't
519
+
520
+ - ✅ Derive progress from `currentStep` and let the component do the rest — exactly one step is
521
+ Current at any time (manifest `intent.rules[3]`).
522
+ - ✅ Treat the step count as content: add or remove entries in `steps`, never hunt for a "5-step"
523
+ variant (spec § Do / Don't).
524
+ - ✅ Pick Accent by surface — Blue everywhere in product, wizards included; Orange only in the four
525
+ marketing / signature slots (spec § Do / Don't, `color-system.md`).
526
+ - ✅ Let Row fall back to Stack by measuring real overflow, not at a fixed screen width
527
+ (spec § Do / Don't).
528
+ - ✅ Pass `stepLabels` whenever the Title is hidden — the type union already forces it, but pass a
529
+ *translated* string, not a hardcoded Czech one (spec § Accessibility; the design system ships no
530
+ locale).
531
+ - ❌ Don't reach for ProgressBar to show a percentage or an indeterminate load; it has no such mode
532
+ (spec § Do / Don't).
533
+ - ❌ Don't try to give a step its own connector line or its own marker glyph — both are owned by the
534
+ parent / fixed to State (spec § Do / Don't).
535
+ - ❌ Don't reuse the pointer callout in a product wizard: it is a marketing flourish in the
536
+ hand-lettered voice, not a wizard label (spec § Copy).
537
+ - ❌ Don't mix sizes inside one bar (manifest `intent.sizing`).
538
+ - ❌ Don't darken the Upcoming digit, the Orange fill, the rail, the pointer callout ink or the
539
+ Upcoming ring, or swap the Done-step hover / press wash for a stronger one, to chase a contrast ratio —
540
+ all six are registered upstream exceptions, see below.
541
+ - ❌ *Recommendation:* don't wire `layout` to a media query "because it is basically mobile" — a
542
+ narrow container inside a wide viewport is exactly the case the overflow measurement catches and a
543
+ breakpoint does not.
544
+ - ❌ *Recommendation:* don't let a Title grow past a line or two of copy — it wraps rather than
545
+ truncates, so a long title silently grows the whole band (spec § Copy calls out ~28 characters).
546
+
547
+ ## Accessibility
548
+
549
+ - **Keyboard** — without `onStepClick` there is nothing to describe, on purpose: the bar renders no
550
+ interactive element and sets no `tabIndex`, so it takes no Tab stop and answers no key. With the
551
+ callback, every **Done** step becomes a real `<button>` and the keyboard comes free — Tab reaches
552
+ them in sequence order, Enter and Space activate them, and the `:focus-visible` ring is the shared
553
+ offset pattern. Current and Upcoming are never reachable, so nobody can Tab their way forward
554
+ through a flow they have not completed, and the bar itself still never holds focus.
555
+ - **ARIA** — an `<ol role="list">` carries the sequence, one `<li>` per step, and the Current step
556
+ carries `aria-current="step"`. The explicit `role="list"` compensates for `list-style: none`, which
557
+ drops the implicit role in Safari. The rail is a `<div aria-hidden="true">` outside the `<ol>`, so
558
+ the list a reader hears is the steps alone. Halo, marker, glyph, dot and the
559
+ pointer arrow are all `aria-hidden` or unlabelled decoration.
560
+ - **Screen reader** — a step's accessible name is its **Title**. In the bare-marker mode there is no
561
+ Title, so `stepLabels` becomes **required through the props union** (the same shape `FilterChip`
562
+ uses for its clear button) and renders as a visually hidden span: `aria-current` alone does not let
563
+ a screen-reader user place themselves in a sequence — it says "you are here", never "here is step
564
+ three of four". The strings come from the consumer's own translations ("Krok 1", "Step 1", …); the
565
+ design system is locale-agnostic and ships no default. Enforcing it in the type rather than at
566
+ runtime means a call site cannot forget it. A step that just omits its `title` under the default
567
+ `showTitle` is outside what the type can see; it logs a development-only `console.warn` when no
568
+ `stepLabels` entry names it, because a clickable Done step would otherwise be a nameless button.
569
+ - **Colour is not the only carrier** — Done / Current / Upcoming differ in marker *shape* (check ·
570
+ ring + dot · ring, with or without the digit), not just in ink. The same holds for the Done
571
+ button's hover: the pointer cursor and the focus ring say what the 3 % wash says.
572
+ - **Target size** — in Row a Done button spans the step's full column width and the extended
573
+ surface height (its `::before` layer), with a 44px floor (the extension is Row only). In bare-marker mode the marker is 26 / 24, so the surface's own construction
574
+ (box + 16) would land at 42 / 40; the floor is what keeps it clear of
575
+ `accessibility.md` § Touch targets. Stack has no extension — the surface is the item's own
576
+ bounds, already floored by its `min-height` of 64.
577
+ - **Contrast — six registered sub-AA exceptions.** These are owner-signed upstream decisions, not
578
+ oversights; do not re-derive them and do not "fix" them:
579
+
580
+ <table>
581
+ <thead>
582
+ <tr><th>What</th><th>Ratio</th><th>Grounds</th></tr>
583
+ </thead>
584
+ <tbody>
585
+ <tr>
586
+ <td>Upcoming ordinal digit, <code>--text-placeholder</code></td>
587
+ <td>2.71:1</td>
588
+ <td>Decorative-duplicated — the step's ordinal is already given by its position in the sequence, and the state is carried by the marker construction plus the fill's end. Registered 2026-08-20; <code>accessibility.md</code> § Accepted exception — Progress Bar Upcoming digit ink.</td>
589
+ </tr>
590
+ <tr>
591
+ <td>Accent=Orange fill, <code>--primary</code></td>
592
+ <td>2.37:1 on <code>--bg-primary</code>, 1.79:1 against the rail</td>
593
+ <td>Progress is never carried by the fill's colour alone — each marker states its state by construction and the fill's <em>length</em> states how far the sequence has run. Confined to the marketing slots; in-product bars are Blue and clear the floor. Registered 2026-08-21.</td>
594
+ </tr>
595
+ <tr>
596
+ <td>Pointer callout label + arrow, <code>--primary</code></td>
597
+ <td>2.37:1</td>
598
+ <td>A decorative marketing marker, never the sole carrier of meaning — the Current marker's own shape and the connector's colour hand-off already say which step is current. <code>Show pointer</code> defaults off outside marketing use. Owner, 2026-08-14.</td>
599
+ </tr>
600
+ <tr>
601
+ <td>Upcoming ring, <code>--outline-strong</code></td>
602
+ <td>1.73:1</td>
603
+ <td>Same token, ratio and reasoning as the resting control &amp; field edge border exception, which names Checkbox / Radio and the field shells but not this ring. Owner, 2026-08-21.</td>
604
+ </tr>
605
+ <tr>
606
+ <td>Rail, <code>--outline-default</code></td>
607
+ <td>1.32:1</td>
608
+ <td>1.4.11 governs the graphical object a reader needs in order to understand the content — here that is the fill and its boundary, not the ground behind it.</td>
609
+ </tr>
610
+ <tr>
611
+ <td>Done-step hover / press wash, <code>--bg-hover</code> / <code>--bg-active</code></td>
612
+ <td>below 3:1 (3 % / 6 % over <code>--bg-primary</code>)</td>
613
+ <td>The system's one quiet interaction highlight, not retuned per surface; never the sole carrier — the pointer cursor, the separate <code>:focus-visible</code> ring and the Done check-circle duplicate it. Only where a Done step is a button (product wizard). Owner 2026-09-17, registered 2026-10-05; <code>accessibility.md</code> § Accepted exception — Progress Bar's Done-step hover / press wash.</td>
614
+ </tr>
615
+ </tbody>
616
+ </table>
617
+
618
+ - **Motion** — see [Motion](#motion). Under `prefers-reduced-motion` all three animations are kept and
619
+ shortened to `--duration-instant` rather than removed: the fill and the dot because a progress
620
+ indicator is essential motion, the pointer callout because the manifest keeps its transition and
621
+ only drops the emphasis.
622
+
623
+ Accessibility floor for every FODS component: `spec/01-foundations/accessibility.md`.
624
+
625
+ ## Copy
626
+
627
+ Voice: the product tone of voice, impersonal and in-app. The pointer callout is the one exception
628
+ (see below).
629
+
630
+ - **Step label** (`steps[].title`) — a short, active-voice noun or verb phrase naming the step,
631
+ sentence case, no terminal period. It wraps rather than truncates, max 28 characters: a long
632
+ title crowds a dense Row band. In the bare-marker mode it is replaced by a visually hidden
633
+ ordinal label (`stepLabels`), never omitted entirely.
634
+ - **Detail** (`steps[].detail`) — one short supporting line under the title. It truncates past two
635
+ lines, so don't rely on a third line ever being visible.
636
+ - **Ordinal digit** — not authored copy; it is generated from the step's position (1–99).
637
+ - **Pointer label** (`steps[].pointerLabel`, Current step only) — a short, fixed phrase in the
638
+ hand-lettered marketing voice, not user content and not the neutral wizard tone. Never reuse it
639
+ in a product wizard.
640
+
641
+ Example texts from the spec:
642
+
643
+ <table>
644
+ <thead>
645
+ <tr><th>Run</th><th>Examples</th></tr>
646
+ </thead>
647
+ <tbody>
648
+ <tr><td>Step label</td><td>Implementujeme · Máme hotovo · Jste tady</td></tr>
649
+ <tr><td>Pointer label</td><td>Jste tady</td></tr>
650
+ </tbody>
651
+ </table>
652
+
653
+ ## Usage
654
+
655
+ <Canvas of={ProgressBarStories.Playground} />
656
+
657
+ ```tsx
658
+ // Good — a marketing rollout narrative: Large, titled steps, the callout on Current only.
659
+ <ProgressBar
660
+ size="lg"
661
+ variant="orange"
662
+ currentStep={1}
663
+ steps={[
664
+ { title: 'Implementujeme', detail: 'Máme hotovo' },
665
+ { title: 'Vy testujete', detail: 'Budete mít dva měsíce na testování', pointerLabel: 'Jste tady' },
666
+ { title: 'Je to povinné', detail: 'Zatím není účinné' },
667
+ ]}
668
+ />
669
+ ```
670
+
671
+ ```tsx
672
+ // Good — the wizard band: bare markers, so every step brings a translated ordinal.
673
+ <ProgressBar
674
+ currentStep={step}
675
+ showTitle={false}
676
+ showDetail={false}
677
+ steps={[{}, {}, {}, {}]}
678
+ stepLabels={[t('wizard.step1'), t('wizard.step2'), t('wizard.step3'), t('wizard.step4')]}
679
+ />
680
+ ```
681
+
682
+ ```tsx
683
+ // Good — pass the PREFERRED layout; the bar measures its own overflow and falls back
684
+ // to Stack by itself (1.9.0), re-checking whenever its parent's width changes.
685
+ <ProgressBar layout="row" currentStep={2} steps={steps} />
686
+
687
+ // Don't — measure in the consumer and feed the verdict back in; that is the bar's job.
688
+ <ProgressBar layout={measuredLayout} currentStep={2} steps={steps} />
689
+ ```
690
+
691
+ ```tsx
692
+ // Don't — the fill is derived; there is no percentage API and no indeterminate mode.
693
+ <ProgressBar value={65} steps={steps} />
694
+
695
+ // Don't — a bare-marker bar with no ordinals. The type union rejects this, and a
696
+ // screen-reader user would hear four unnamed list items.
697
+ <ProgressBar currentStep={2} showTitle={false} steps={[{}, {}, {}, {}]} />
698
+
699
+ // Don't — Orange in a product wizard. Accent is brand governance, not decoration.
700
+ <ProgressBar variant="orange" currentStep={1} steps={wizardSteps} />
701
+ ```
702
+
703
+ ## Related
704
+
705
+ - **Siblings:** [`Pagination`](?path=/docs/design-system-molecules-pagination--docs) — the paging
706
+ footer, for a result set rather than a fixed ordered flow.
707
+ [`ButtonGroup`](?path=/docs/design-system-molecules-buttongroup--docs) — for independent actions
708
+ with no fixed order. [`Skeleton`](?path=/docs/design-system-atoms-skeleton--docs) — the rail
709
+ used to borrow its `--bg-skeleton`; since 1.8.1 it binds the structural `--outline-default` (same
710
+ primitive, different intent).
711
+ - **Radix:** none — ProgressBar is plain semantic HTML (`<ol>` / `<li>`), no Radix primitive is
712
+ involved.
713
+ - **Spec:** `spec/04-molecules/progress-bar.md`,
714
+ `spec/04-molecules/progress-bar.manifest.json`,
715
+ `spec/03-atoms/_progress-bar-item.manifest.json`.
716
+ A runnable motion reference sits beside the spec as `progress-bar.motion.html` — hand-authored and
717
+ **not** authoritative; the manifest's `motion` block is.
718
+ - **Open upstream items:** none. The Done hover / active wash was registered in `accessibility.md`
719
+ with `_progress-bar-item` 3.3.1 (see [Accessibility](#accessibility)); it, the § Sizes ring
720
+ asymmetry (including its § Do / Don't bullet), the Stack rail overshoot and the Row-only
721
+ click-surface extension are resolved.
722
+
723
+ ## Migration notes
724
+
725
+ ProgressBar replaces the **retired** standalone atom `StepperItem`. Its v1 shape drew a connector half
726
+ on every item and exposed a Marker-content axis independent of State; upstream deleted
727
+ `stepper-item.manifest.json` and shipped `progress-bar` 1.4.0 plus the private `_progress-bar-item`
728
+ 2.2.1 in its place (today 1.11.2 / 3.4.1). That v1 shape is **superseded, not a reference** — do not build new consumers
729
+ against it.
730
+
731
+ Diff v1 (`StepperItem`) → v2 (`ProgressBar`), taken from the `_progress-bar-item` changelog entries of
732
+ 2026-08-20 and 2026-08-21:
733
+
734
+ <table>
735
+ <thead>
736
+ <tr><th>v1 — Stepper Item</th><th>v2 — Progress Bar</th><th>Why</th></tr>
737
+ </thead>
738
+ <tbody>
739
+ <tr>
740
+ <td>Connector halves on every item</td>
741
+ <td><strong>Gone.</strong> The parent owns one continuous track.</td>
742
+ <td>A single element can slide forward; N joined half-segments break at the seams.</td>
743
+ </tr>
744
+ <tr>
745
+ <td><code>Marker content</code> axis, independent of State</td>
746
+ <td><strong>Gone.</strong> The marker construction follows State 1:1.</td>
747
+ <td>A Done step is never anything but a checkmark — the freedom was never real.</td>
748
+ </tr>
749
+ <tr>
750
+ <td>No Size axis</td>
751
+ <td><strong>Added</strong> — Large · Small (<code>size</code>).</td>
752
+ <td>Marketing/hero versus the product wizard band.</td>
753
+ </tr>
754
+ <tr>
755
+ <td>Halo hand-placed by each composition</td>
756
+ <td><strong>Added</strong> to the step as its bottom marker layer.</td>
757
+ <td>The geometry had already drifted twice; now every composition gets the air for free.</td>
758
+ </tr>
759
+ <tr>
760
+ <td>Current = an empty accent ring</td>
761
+ <td><strong>Added</strong> an accent centre <code>dot</code>, Ø half the ring.</td>
762
+ <td>Part of the 2026-08-21 marker-geometry unification.</td>
763
+ </tr>
764
+ <tr>
765
+ <td>No title toggle</td>
766
+ <td><strong>Added</strong> <code>showTitle</code>; with <code>showDetail</code> off it forms the bare-marker mode.</td>
767
+ <td>The Modal Wizard band needs markers with no copy.</td>
768
+ </tr>
769
+ <tr>
770
+ <td>Marker always carried its ordinal</td>
771
+ <td><strong>Added</strong> <code>showNumbers</code>; off leaves the Upcoming ring empty at the same Ø.</td>
772
+ <td>Added with <code>progress-bar</code> 1.5.0, later than the rest of this diff — a band can want the shape without the count.</td>
773
+ </tr>
774
+ <tr>
775
+ <td>Upcoming digit on the default ink</td>
776
+ <td>Recoloured to <code>--text-placeholder</code>.</td>
777
+ <td>Registered sub-AA exception — see Accessibility.</td>
778
+ </tr>
779
+ <tr>
780
+ <td>Mixed ring strokes</td>
781
+ <td>All ring strokes on <code>--border-width-200</code>, ring Ø = marker box − 2 in every state.</td>
782
+ <td>Corrects three inversions where Small was not uniformly smaller than Large.</td>
783
+ </tr>
784
+ </tbody>
785
+ </table>
786
+
787
+ Call-site mapping: a `StepperItem` list becomes one `ProgressBar` with a `steps` array; the per-item
788
+ `state` prop becomes the single `currentStep` index on the parent; any per-item connector or marker
789
+ override has no equivalent and should simply be dropped.
790
+
791
+ **Not yet built:** Blocked and Error are decided upstream as a *modifier* over Done/Current rather
792
+ than as new State values (Error = `warning-circle` on `--status-danger`, Blocked = `prohibit` on
793
+ `--icon-muted`, and the fill does not reach past a Blocked step). Neither exists in this component
794
+ today.
795
+
796
+ **Manifest 1.11.1 → 1.11.2 / `_progress-bar-item` 3.4.0 → 3.4.1 (motion audit, 2026-11-03).** The fill
797
+ transition moves from `motion.enter` to `motion.states.value` (same `--duration-normal` / `--easing-standard`
798
+ on `width` / `height`; the duplicate `enter` block contradicted the no-animation-on-mount trigger) and the bar
799
+ `inherits` `_progress-bar-item`. Two code changes follow from the item: the arriving dot **fades in only**
800
+ (the `scale(0)` bloom is gone) on `--easing-enter` instead of `--easing-standard`, and the pointer callout
801
+ **fades in only** (the `translateY(4px)` rise is dropped). Timing and reduced-motion handling are unchanged —
802
+ see [Motion](#motion).