@invoiceonline/ui-react 0.0.0 → 0.2.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 (731) hide show
  1. package/AGENTS.md +100 -0
  2. package/CHANGELOG.md +149 -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-picker/DatePicker.d.ts +53 -0
  60. package/dist/components/date-picker/DatePicker.js +329 -0
  61. package/dist/components/date-picker/index.d.ts +2 -0
  62. package/dist/components/date-picker/index.js +1 -0
  63. package/dist/components/divider/Divider.d.ts +81 -0
  64. package/dist/components/divider/Divider.js +93 -0
  65. package/dist/components/divider/index.d.ts +2 -0
  66. package/dist/components/divider/index.js +1 -0
  67. package/dist/components/drawer/Drawer.d.ts +128 -0
  68. package/dist/components/drawer/Drawer.js +367 -0
  69. package/dist/components/drawer/index.d.ts +2 -0
  70. package/dist/components/drawer/index.js +1 -0
  71. package/dist/components/dropdown-button/DropdownButton.d.ts +72 -0
  72. package/dist/components/dropdown-button/DropdownButton.js +122 -0
  73. package/dist/components/dropdown-button/index.d.ts +2 -0
  74. package/dist/components/dropdown-button/index.js +1 -0
  75. package/dist/components/faq/FAQ.d.ts +135 -0
  76. package/dist/components/faq/FAQ.js +258 -0
  77. package/dist/components/faq/index.d.ts +2 -0
  78. package/dist/components/faq/index.js +1 -0
  79. package/dist/components/field/Field.d.ts +119 -0
  80. package/dist/components/field/Field.js +332 -0
  81. package/dist/components/field/index.d.ts +2 -0
  82. package/dist/components/field/index.js +1 -0
  83. package/dist/components/field-pair/FieldPair.d.ts +210 -0
  84. package/dist/components/field-pair/FieldPair.js +335 -0
  85. package/dist/components/field-pair/index.d.ts +2 -0
  86. package/dist/components/field-pair/index.js +1 -0
  87. package/dist/components/file-upload/FileUpload.d.ts +137 -0
  88. package/dist/components/file-upload/FileUpload.js +434 -0
  89. package/dist/components/file-upload/index.d.ts +2 -0
  90. package/dist/components/file-upload/index.js +1 -0
  91. package/dist/components/filter-chip/FilterChip.d.ts +373 -0
  92. package/dist/components/filter-chip/FilterChip.js +517 -0
  93. package/dist/components/filter-chip/index.d.ts +2 -0
  94. package/dist/components/filter-chip/index.js +1 -0
  95. package/dist/components/filter-facet/FilterFacet.d.ts +116 -0
  96. package/dist/components/filter-facet/FilterFacet.js +632 -0
  97. package/dist/components/filter-facet/index.d.ts +2 -0
  98. package/dist/components/filter-facet/index.js +1 -0
  99. package/dist/components/firm-avatar/FirmAvatar.d.ts +75 -0
  100. package/dist/components/firm-avatar/FirmAvatar.js +119 -0
  101. package/dist/components/firm-avatar/index.d.ts +2 -0
  102. package/dist/components/firm-avatar/index.js +1 -0
  103. package/dist/components/form-actions/FormActions.d.ts +123 -0
  104. package/dist/components/form-actions/FormActions.js +195 -0
  105. package/dist/components/form-actions/index.d.ts +2 -0
  106. package/dist/components/form-actions/index.js +1 -0
  107. package/dist/components/form-block/FormBlock.d.ts +252 -0
  108. package/dist/components/form-block/FormBlock.js +420 -0
  109. package/dist/components/form-block/index.d.ts +3 -0
  110. package/dist/components/form-block/index.js +3 -0
  111. package/dist/components/form-section/FormSection.d.ts +130 -0
  112. package/dist/components/form-section/FormSection.js +206 -0
  113. package/dist/components/form-section/index.d.ts +2 -0
  114. package/dist/components/form-section/index.js +1 -0
  115. package/dist/components/heading/Heading.d.ts +69 -0
  116. package/dist/components/heading/Heading.js +79 -0
  117. package/dist/components/heading/index.d.ts +2 -0
  118. package/dist/components/heading/index.js +1 -0
  119. package/dist/components/heading-group/HeadingGroup.d.ts +258 -0
  120. package/dist/components/heading-group/HeadingGroup.js +255 -0
  121. package/dist/components/heading-group/index.d.ts +2 -0
  122. package/dist/components/heading-group/index.js +1 -0
  123. package/dist/components/hero/Hero.d.ts +268 -0
  124. package/dist/components/hero/Hero.js +316 -0
  125. package/dist/components/hero/index.d.ts +2 -0
  126. package/dist/components/hero/index.js +1 -0
  127. package/dist/components/icon/Icon.d.ts +27 -0
  128. package/dist/components/icon/Icon.js +30 -0
  129. package/dist/components/icon/index.d.ts +3 -0
  130. package/dist/components/icon/index.js +3 -0
  131. package/dist/components/icon-button/IconButton.d.ts +75 -0
  132. package/dist/components/icon-button/IconButton.js +151 -0
  133. package/dist/components/icon-button/index.d.ts +2 -0
  134. package/dist/components/icon-button/index.js +1 -0
  135. package/dist/components/item-row/ItemRow.d.ts +253 -0
  136. package/dist/components/item-row/ItemRow.js +496 -0
  137. package/dist/components/item-row/index.d.ts +2 -0
  138. package/dist/components/item-row/index.js +1 -0
  139. package/dist/components/list-row/ListRow.d.ts +165 -0
  140. package/dist/components/list-row/ListRow.js +233 -0
  141. package/dist/components/list-row/index.d.ts +2 -0
  142. package/dist/components/list-row/index.js +1 -0
  143. package/dist/components/menu/Menu.d.ts +64 -0
  144. package/dist/components/menu/Menu.js +186 -0
  145. package/dist/components/menu/index.d.ts +2 -0
  146. package/dist/components/menu/index.js +1 -0
  147. package/dist/components/modal/Modal.d.ts +272 -0
  148. package/dist/components/modal/Modal.js +788 -0
  149. package/dist/components/modal/index.d.ts +2 -0
  150. package/dist/components/modal/index.js +1 -0
  151. package/dist/components/nav-link/NavLink.d.ts +123 -0
  152. package/dist/components/nav-link/NavLink.js +157 -0
  153. package/dist/components/nav-link/index.d.ts +2 -0
  154. package/dist/components/nav-link/index.js +1 -0
  155. package/dist/components/number-field/NumberField.d.ts +62 -0
  156. package/dist/components/number-field/NumberField.js +210 -0
  157. package/dist/components/number-field/index.d.ts +2 -0
  158. package/dist/components/number-field/index.js +1 -0
  159. package/dist/components/pagination/Pagination.d.ts +133 -0
  160. package/dist/components/pagination/Pagination.js +217 -0
  161. package/dist/components/pagination/index.d.ts +3 -0
  162. package/dist/components/pagination/index.js +3 -0
  163. package/dist/components/popover-surface/index.d.ts +2 -0
  164. package/dist/components/popover-surface/index.js +1 -0
  165. package/dist/components/progress-bar/ProgressBar.d.ts +260 -0
  166. package/dist/components/progress-bar/ProgressBar.js +470 -0
  167. package/dist/components/progress-bar/index.d.ts +2 -0
  168. package/dist/components/progress-bar/index.js +1 -0
  169. package/dist/components/promo-sticker/PromoSticker.d.ts +204 -0
  170. package/dist/components/promo-sticker/PromoSticker.js +177 -0
  171. package/dist/components/promo-sticker/index.d.ts +2 -0
  172. package/dist/components/promo-sticker/index.js +1 -0
  173. package/dist/components/promo-surface/PromoSurface.d.ts +94 -0
  174. package/dist/components/promo-surface/PromoSurface.js +119 -0
  175. package/dist/components/promo-surface/index.d.ts +2 -0
  176. package/dist/components/promo-surface/index.js +1 -0
  177. package/dist/components/radio/Radio.d.ts +92 -0
  178. package/dist/components/radio/Radio.js +171 -0
  179. package/dist/components/radio/index.d.ts +2 -0
  180. package/dist/components/radio/index.js +1 -0
  181. package/dist/components/radio-group/RadioGroup.d.ts +61 -0
  182. package/dist/components/radio-group/RadioGroup.js +51 -0
  183. package/dist/components/radio-group/index.d.ts +2 -0
  184. package/dist/components/radio-group/index.js +1 -0
  185. package/dist/components/select/Select.d.ts +65 -0
  186. package/dist/components/select/Select.js +176 -0
  187. package/dist/components/select/index.d.ts +2 -0
  188. package/dist/components/select/index.js +1 -0
  189. package/dist/components/select-field/SelectField.d.ts +16 -0
  190. package/dist/components/select-field/SelectField.js +55 -0
  191. package/dist/components/select-field/index.d.ts +2 -0
  192. package/dist/components/select-field/index.js +1 -0
  193. package/dist/components/skeleton/Skeleton.d.ts +64 -0
  194. package/dist/components/skeleton/Skeleton.js +65 -0
  195. package/dist/components/skeleton/index.d.ts +2 -0
  196. package/dist/components/skeleton/index.js +1 -0
  197. package/dist/components/split-button/SplitButton.d.ts +80 -0
  198. package/dist/components/split-button/SplitButton.js +182 -0
  199. package/dist/components/split-button/index.d.ts +2 -0
  200. package/dist/components/split-button/index.js +1 -0
  201. package/dist/components/status-summary-bar/StatusSummaryBar.d.ts +118 -0
  202. package/dist/components/status-summary-bar/StatusSummaryBar.js +278 -0
  203. package/dist/components/status-summary-bar/index.d.ts +2 -0
  204. package/dist/components/status-summary-bar/index.js +1 -0
  205. package/dist/components/subject-lookup-field/SubjectLookupField.d.ts +157 -0
  206. package/dist/components/subject-lookup-field/SubjectLookupField.js +663 -0
  207. package/dist/components/subject-lookup-field/index.d.ts +2 -0
  208. package/dist/components/subject-lookup-field/index.js +1 -0
  209. package/dist/components/switch/Switch.d.ts +152 -0
  210. package/dist/components/switch/Switch.js +307 -0
  211. package/dist/components/switch/index.d.ts +2 -0
  212. package/dist/components/switch/index.js +1 -0
  213. package/dist/components/table/Table.d.ts +5 -0
  214. package/dist/components/table/Table.js +601 -0
  215. package/dist/components/table/index.d.ts +6 -0
  216. package/dist/components/table/index.js +6 -0
  217. package/dist/components/text-field/TextField.d.ts +160 -0
  218. package/dist/components/text-field/TextField.js +244 -0
  219. package/dist/components/text-field/index.d.ts +2 -0
  220. package/dist/components/text-field/index.js +1 -0
  221. package/dist/components/text-link/TextLink.d.ts +260 -0
  222. package/dist/components/text-link/TextLink.js +303 -0
  223. package/dist/components/text-link/index.d.ts +2 -0
  224. package/dist/components/text-link/index.js +1 -0
  225. package/dist/components/textarea/Textarea.d.ts +93 -0
  226. package/dist/components/textarea/Textarea.js +256 -0
  227. package/dist/components/textarea/index.d.ts +2 -0
  228. package/dist/components/textarea/index.js +1 -0
  229. package/dist/components/tooltip/Tooltip.d.ts +129 -0
  230. package/dist/components/tooltip/Tooltip.js +457 -0
  231. package/dist/components/tooltip/index.d.ts +2 -0
  232. package/dist/components/tooltip/index.js +1 -0
  233. package/dist/components/unit-field/UnitField.d.ts +46 -0
  234. package/dist/components/unit-field/UnitField.js +133 -0
  235. package/dist/components/unit-field/index.d.ts +2 -0
  236. package/dist/components/unit-field/index.js +1 -0
  237. package/dist/icons/icon-registry.generated.js +500 -0
  238. package/dist/icons/icon-types.generated.d.ts +2 -0
  239. package/dist/icons/icon-types.generated.js +126 -0
  240. package/dist/index.d.ts +130 -0
  241. package/dist/index.js +74 -0
  242. package/dist/internal/BottomSheet.js +496 -0
  243. package/dist/internal/FodsProvider.d.ts +25 -0
  244. package/dist/internal/FodsProvider.js +32 -0
  245. package/dist/internal/MotionCaret.js +35 -0
  246. package/dist/internal/NumberFormatInput.d.ts +21 -0
  247. package/dist/internal/NumberFormatInput.js +126 -0
  248. package/dist/internal/SummaryDonut.d.ts +3 -0
  249. package/dist/internal/SummaryDonut.js +300 -0
  250. package/dist/internal/buttonSegment.d.ts +44 -0
  251. package/dist/internal/buttonSegment.js +126 -0
  252. package/dist/internal/collapseRoom.js +128 -0
  253. package/dist/internal/comboboxKeys.js +44 -0
  254. package/dist/internal/contentPresence.js +46 -0
  255. package/dist/internal/dayCell.js +95 -0
  256. package/dist/internal/dialogPortal.d.ts +2 -0
  257. package/dist/internal/dialogPortal.js +21 -0
  258. package/dist/internal/donutSweeps.js +65 -0
  259. package/dist/internal/enterOnViewGeometry.js +46 -0
  260. package/dist/internal/faqItem.js +80 -0
  261. package/dist/internal/floatingLabelMotion.js +68 -0
  262. package/dist/internal/formBlockContext.d.ts +22 -0
  263. package/dist/internal/formBlockContext.js +20 -0
  264. package/dist/internal/heightRoom.js +87 -0
  265. package/dist/internal/numberSeparators.js +62 -0
  266. package/dist/internal/overlayMotion.js +48 -0
  267. package/dist/internal/paginationItem.d.ts +8 -0
  268. package/dist/internal/paginationItem.js +22 -0
  269. package/dist/internal/popoverSurface.d.ts +8 -0
  270. package/dist/internal/popoverSurface.js +23 -0
  271. package/dist/internal/portalContainer.d.ts +1 -0
  272. package/dist/internal/portalContainer.js +6 -0
  273. package/dist/internal/progressBarItem.d.ts +207 -0
  274. package/dist/internal/progressBarItem.js +264 -0
  275. package/dist/internal/selectionControlText.js +12 -0
  276. package/dist/internal/statusSummaryParts.js +371 -0
  277. package/dist/internal/summaryMotion.js +75 -0
  278. package/dist/internal/table/ChildConnector.js +62 -0
  279. package/dist/internal/table/ChildRowPrefix.d.ts +9 -0
  280. package/dist/internal/table/ChildRowPrefix.js +27 -0
  281. package/dist/internal/table/ColumnSettings.js +135 -0
  282. package/dist/internal/table/ScrollRegion.js +114 -0
  283. package/dist/internal/table/TableEmpty.js +93 -0
  284. package/dist/internal/table/TableLayout.d.ts +17 -0
  285. package/dist/internal/table/TableLayout.js +29 -0
  286. package/dist/internal/table/TableLoadStatus.js +56 -0
  287. package/dist/internal/table/TableMobile.js +488 -0
  288. package/dist/internal/table/TruncatedCell.js +33 -0
  289. package/dist/internal/table/emptyValue.js +10 -0
  290. package/dist/internal/table/features.d.ts +41 -0
  291. package/dist/internal/table/features.js +31 -0
  292. package/dist/internal/table/recipes.js +227 -0
  293. package/dist/internal/table/rowClick.js +9 -0
  294. package/dist/internal/table/types.d.ts +325 -0
  295. package/dist/internal/table/types.js +13 -0
  296. package/dist/internal/tailwind-variants.d.ts +3 -0
  297. package/dist/internal/tailwind-variants.js +37 -0
  298. package/dist/internal/tooltipContext.js +5 -0
  299. package/dist/internal/tw-merge-config.generated.js +314 -0
  300. package/dist/internal/useAnchoredPanel.d.ts +87 -0
  301. package/dist/internal/useAnchoredPanel.js +108 -0
  302. package/dist/internal/useCountUp.js +53 -0
  303. package/dist/internal/useDateFieldTrigger.d.ts +60 -0
  304. package/dist/internal/useDateFieldTrigger.js +235 -0
  305. package/dist/internal/useEChart.js +59 -0
  306. package/dist/internal/useEnterOnView.js +42 -0
  307. package/dist/internal/useFloatingBar.js +100 -0
  308. package/dist/internal/useFormReset.js +44 -0
  309. package/dist/internal/useIsMobile.js +44 -0
  310. package/dist/internal/useOneRowOverflow.js +88 -0
  311. package/dist/internal/usePrefersReducedMotion.js +25 -0
  312. package/dist/internal/useReturnFocus.js +26 -0
  313. package/dist/internal/utils.d.ts +7 -0
  314. package/dist/internal/utils.js +58 -0
  315. package/dist/node_modules/@tanstack/store/dist/store.d.ts +29 -0
  316. package/dist/node_modules/@tanstack/store/dist/types.d.ts +38 -0
  317. package/dist/node_modules/@tanstack/table-core/dist/core/cells/coreCellsFeature.d.ts +6 -0
  318. package/dist/node_modules/@tanstack/table-core/dist/core/cells/coreCellsFeature.types.d.ts +53 -0
  319. package/dist/node_modules/@tanstack/table-core/dist/core/columns/coreColumnsFeature.d.ts +6 -0
  320. package/dist/node_modules/@tanstack/table-core/dist/core/columns/coreColumnsFeature.types.d.ts +90 -0
  321. package/dist/node_modules/@tanstack/table-core/dist/core/coreFeatures.d.ts +17 -0
  322. package/dist/node_modules/@tanstack/table-core/dist/core/headers/coreHeadersFeature.d.ts +6 -0
  323. package/dist/node_modules/@tanstack/table-core/dist/core/headers/coreHeadersFeature.types.d.ts +114 -0
  324. package/dist/node_modules/@tanstack/table-core/dist/core/reactivity/coreReactivityFeature.types.d.ts +51 -0
  325. package/dist/node_modules/@tanstack/table-core/dist/core/row-models/coreRowModelsFeature.d.ts +6 -0
  326. package/dist/node_modules/@tanstack/table-core/dist/core/row-models/coreRowModelsFeature.types.d.ts +29 -0
  327. package/dist/node_modules/@tanstack/table-core/dist/core/rows/coreRowsFeature.d.ts +6 -0
  328. package/dist/node_modules/@tanstack/table-core/dist/core/rows/coreRowsFeature.types.d.ts +129 -0
  329. package/dist/node_modules/@tanstack/table-core/dist/core/table/coreTablesFeature.d.ts +6 -0
  330. package/dist/node_modules/@tanstack/table-core/dist/core/table/coreTablesFeature.types.d.ts +203 -0
  331. package/dist/node_modules/@tanstack/table-core/dist/features/cell-selection/cellSelectionFeature.d.ts +6 -0
  332. package/dist/node_modules/@tanstack/table-core/dist/features/cell-selection/cellSelectionFeature.types.d.ts +294 -0
  333. package/dist/node_modules/@tanstack/table-core/dist/features/cell-spanning/cellSpanningFeature.d.ts +11 -0
  334. package/dist/node_modules/@tanstack/table-core/dist/features/cell-spanning/cellSpanningFeature.types.d.ts +148 -0
  335. package/dist/node_modules/@tanstack/table-core/dist/features/column-faceting/columnFacetingFeature.d.ts +12 -0
  336. package/dist/node_modules/@tanstack/table-core/dist/features/column-faceting/columnFacetingFeature.types.d.ts +63 -0
  337. package/dist/node_modules/@tanstack/table-core/dist/features/column-filtering/columnFilteringFeature.d.ts +6 -0
  338. package/dist/node_modules/@tanstack/table-core/dist/features/column-filtering/columnFilteringFeature.types.d.ts +209 -0
  339. package/dist/node_modules/@tanstack/table-core/dist/features/column-filtering/filterFns.d.ts +35 -0
  340. package/dist/node_modules/@tanstack/table-core/dist/features/column-grouping/columnGroupingFeature.d.ts +6 -0
  341. package/dist/node_modules/@tanstack/table-core/dist/features/column-grouping/columnGroupingFeature.types.d.ts +128 -0
  342. package/dist/node_modules/@tanstack/table-core/dist/features/column-ordering/columnOrderingFeature.d.ts +6 -0
  343. package/dist/node_modules/@tanstack/table-core/dist/features/column-ordering/columnOrderingFeature.types.d.ts +82 -0
  344. package/dist/node_modules/@tanstack/table-core/dist/features/column-pinning/columnPinningFeature.d.ts +11 -0
  345. package/dist/node_modules/@tanstack/table-core/dist/features/column-pinning/columnPinningFeature.types.d.ts +195 -0
  346. package/dist/node_modules/@tanstack/table-core/dist/features/column-resizing/columnResizingFeature.d.ts +6 -0
  347. package/dist/node_modules/@tanstack/table-core/dist/features/column-resizing/columnResizingFeature.types.d.ts +73 -0
  348. package/dist/node_modules/@tanstack/table-core/dist/features/column-sizing/columnSizingFeature.d.ts +6 -0
  349. package/dist/node_modules/@tanstack/table-core/dist/features/column-sizing/columnSizingFeature.types.d.ts +134 -0
  350. package/dist/node_modules/@tanstack/table-core/dist/features/column-visibility/columnVisibilityFeature.d.ts +6 -0
  351. package/dist/node_modules/@tanstack/table-core/dist/features/column-visibility/columnVisibilityFeature.types.d.ts +92 -0
  352. package/dist/node_modules/@tanstack/table-core/dist/features/global-filtering/globalFilteringFeature.d.ts +6 -0
  353. package/dist/node_modules/@tanstack/table-core/dist/features/global-filtering/globalFilteringFeature.types.d.ts +67 -0
  354. package/dist/node_modules/@tanstack/table-core/dist/features/row-aggregation/aggregationFns.d.ts +23 -0
  355. package/dist/node_modules/@tanstack/table-core/dist/features/row-aggregation/rowAggregationFeature.d.ts +6 -0
  356. package/dist/node_modules/@tanstack/table-core/dist/features/row-aggregation/rowAggregationFeature.types.d.ts +183 -0
  357. package/dist/node_modules/@tanstack/table-core/dist/features/row-aggregation/rowAggregationFeature.utils.d.ts +18 -0
  358. package/dist/node_modules/@tanstack/table-core/dist/features/row-expanding/rowExpandingFeature.d.ts +6 -0
  359. package/dist/node_modules/@tanstack/table-core/dist/features/row-expanding/rowExpandingFeature.types.d.ts +125 -0
  360. package/dist/node_modules/@tanstack/table-core/dist/features/row-pagination/rowPaginationFeature.d.ts +6 -0
  361. package/dist/node_modules/@tanstack/table-core/dist/features/row-pagination/rowPaginationFeature.types.d.ts +135 -0
  362. package/dist/node_modules/@tanstack/table-core/dist/features/row-pinning/rowPinningFeature.d.ts +6 -0
  363. package/dist/node_modules/@tanstack/table-core/dist/features/row-pinning/rowPinningFeature.types.d.ts +76 -0
  364. package/dist/node_modules/@tanstack/table-core/dist/features/row-selection/rowSelectionFeature.d.ts +6 -0
  365. package/dist/node_modules/@tanstack/table-core/dist/features/row-selection/rowSelectionFeature.types.d.ts +187 -0
  366. package/dist/node_modules/@tanstack/table-core/dist/features/row-sorting/rowSortingFeature.d.ts +6 -0
  367. package/dist/node_modules/@tanstack/table-core/dist/features/row-sorting/rowSortingFeature.types.d.ts +236 -0
  368. package/dist/node_modules/@tanstack/table-core/dist/features/row-sorting/sortFns.d.ts +23 -0
  369. package/dist/node_modules/@tanstack/table-core/dist/features/stockFeatures.d.ts +37 -0
  370. package/dist/node_modules/@tanstack/table-core/dist/helpers/columnHelper.d.ts +47 -0
  371. package/dist/node_modules/@tanstack/table-core/dist/types/Cell.d.ts +16 -0
  372. package/dist/node_modules/@tanstack/table-core/dist/types/Column.d.ts +30 -0
  373. package/dist/node_modules/@tanstack/table-core/dist/types/ColumnDef.d.ts +123 -0
  374. package/dist/node_modules/@tanstack/table-core/dist/types/Header.d.ts +12 -0
  375. package/dist/node_modules/@tanstack/table-core/dist/types/HeaderGroup.d.ts +6 -0
  376. package/dist/node_modules/@tanstack/table-core/dist/types/Row.d.ts +24 -0
  377. package/dist/node_modules/@tanstack/table-core/dist/types/RowModel.d.ts +19 -0
  378. package/dist/node_modules/@tanstack/table-core/dist/types/RowModelFns.d.ts +11 -0
  379. package/dist/node_modules/@tanstack/table-core/dist/types/Table.d.ts +53 -0
  380. package/dist/node_modules/@tanstack/table-core/dist/types/TableFeatures.d.ts +416 -0
  381. package/dist/node_modules/@tanstack/table-core/dist/types/TableOptions.d.ts +78 -0
  382. package/dist/node_modules/@tanstack/table-core/dist/types/TableState.d.ts +46 -0
  383. package/dist/node_modules/@tanstack/table-core/dist/types/type-utils.d.ts +25 -0
  384. package/dist/shared.css +179 -0
  385. package/dist/styles.css +5467 -0
  386. package/dist/theme.css +314 -0
  387. package/dist/theme.map.json +278 -0
  388. package/dist/tokens/index.d.ts +2 -0
  389. package/dist/tokens/index.js +1 -0
  390. package/dist/tokens/tokens.generated.d.ts +2040 -0
  391. package/dist/tokens/tokens.generated.js +2053 -0
  392. package/dist/tokens.css +484 -0
  393. package/dist/tokens.flat.json +429 -0
  394. package/docs/Consuming.mdx +396 -0
  395. package/docs/Contributing.mdx +78 -0
  396. package/docs/ForAgents.mdx +53 -0
  397. package/docs/Introduction.mdx +54 -0
  398. package/llms.txt +550 -0
  399. package/package.json +347 -3
  400. package/src/components/action-row/ActionRow.mdx +686 -0
  401. package/src/components/action-row/ActionRow.stories.tsx +669 -0
  402. package/src/components/action-row/ActionRow.tsx +632 -0
  403. package/src/components/action-row/index.ts +9 -0
  404. package/src/components/alert/Alert.mdx +377 -0
  405. package/src/components/alert/Alert.stories.tsx +674 -0
  406. package/src/components/alert/Alert.tsx +579 -0
  407. package/src/components/alert/index.ts +13 -0
  408. package/src/components/anchored-panel/AnchoredPanel.mdx +381 -0
  409. package/src/components/anchored-panel/AnchoredPanel.stories.tsx +593 -0
  410. package/src/components/anchored-panel/AnchoredPanel.tsx +176 -0
  411. package/src/components/anchored-panel/index.ts +15 -0
  412. package/src/components/badge/Badge.mdx +487 -0
  413. package/src/components/badge/Badge.stories.tsx +375 -0
  414. package/src/components/badge/Badge.tsx +360 -0
  415. package/src/components/badge/index.ts +10 -0
  416. package/src/components/banner/Banner.mdx +704 -0
  417. package/src/components/banner/Banner.stories.tsx +448 -0
  418. package/src/components/banner/Banner.tsx +602 -0
  419. package/src/components/banner/index.ts +14 -0
  420. package/src/components/button/Button.mdx +286 -0
  421. package/src/components/button/Button.stories.tsx +381 -0
  422. package/src/components/button/Button.tsx +384 -0
  423. package/src/components/button/index.ts +1 -0
  424. package/src/components/button-group/ButtonGroup.mdx +512 -0
  425. package/src/components/button-group/ButtonGroup.stories.tsx +714 -0
  426. package/src/components/button-group/ButtonGroup.tsx +491 -0
  427. package/src/components/button-group/index.ts +10 -0
  428. package/src/components/card-select/CardSelect.mdx +662 -0
  429. package/src/components/card-select/CardSelect.stories.tsx +784 -0
  430. package/src/components/card-select/CardSelect.tsx +783 -0
  431. package/src/components/card-select/CardSelectGroup.tsx +169 -0
  432. package/src/components/card-select/index.ts +18 -0
  433. package/src/components/checkbox/Checkbox.mdx +269 -0
  434. package/src/components/checkbox/Checkbox.stories.tsx +306 -0
  435. package/src/components/checkbox/Checkbox.tsx +343 -0
  436. package/src/components/checkbox/index.ts +1 -0
  437. package/src/components/chip/Chip.mdx +683 -0
  438. package/src/components/chip/Chip.stories.tsx +734 -0
  439. package/src/components/chip/Chip.tsx +732 -0
  440. package/src/components/chip/index.ts +9 -0
  441. package/src/components/column-header/ColumnHeader.mdx +301 -0
  442. package/src/components/column-header/ColumnHeader.stories.tsx +319 -0
  443. package/src/components/column-header/ColumnHeader.tsx +287 -0
  444. package/src/components/column-header/index.ts +7 -0
  445. package/src/components/combobox-field/Combobox.tsx +693 -0
  446. package/src/components/combobox-field/ComboboxField.mdx +525 -0
  447. package/src/components/combobox-field/ComboboxField.stories.tsx +502 -0
  448. package/src/components/combobox-field/ComboboxField.tsx +259 -0
  449. package/src/components/combobox-field/index.ts +12 -0
  450. package/src/components/date-picker/DatePicker.mdx +440 -0
  451. package/src/components/date-picker/DatePicker.stories.tsx +458 -0
  452. package/src/components/date-picker/DatePicker.tsx +688 -0
  453. package/src/components/date-picker/index.ts +9 -0
  454. package/src/components/divider/Divider.mdx +256 -0
  455. package/src/components/divider/Divider.stories.tsx +177 -0
  456. package/src/components/divider/Divider.tsx +193 -0
  457. package/src/components/divider/index.ts +1 -0
  458. package/src/components/drawer/Drawer.mdx +518 -0
  459. package/src/components/drawer/Drawer.stories.tsx +392 -0
  460. package/src/components/drawer/Drawer.tsx +683 -0
  461. package/src/components/drawer/index.ts +1 -0
  462. package/src/components/dropdown-button/DropdownButton.mdx +285 -0
  463. package/src/components/dropdown-button/DropdownButton.stories.tsx +398 -0
  464. package/src/components/dropdown-button/DropdownButton.tsx +198 -0
  465. package/src/components/dropdown-button/index.ts +7 -0
  466. package/src/components/faq/FAQ.mdx +364 -0
  467. package/src/components/faq/FAQ.stories.tsx +343 -0
  468. package/src/components/faq/FAQ.tsx +337 -0
  469. package/src/components/faq/index.ts +1 -0
  470. package/src/components/field/Field.mdx +129 -0
  471. package/src/components/field/Field.stories.tsx +461 -0
  472. package/src/components/field/Field.tsx +787 -0
  473. package/src/components/field/index.ts +20 -0
  474. package/src/components/field-pair/FieldPair.mdx +312 -0
  475. package/src/components/field-pair/FieldPair.stories.tsx +539 -0
  476. package/src/components/field-pair/FieldPair.tsx +845 -0
  477. package/src/components/field-pair/index.ts +9 -0
  478. package/src/components/file-upload/FileUpload.mdx +345 -0
  479. package/src/components/file-upload/FileUpload.stories.tsx +698 -0
  480. package/src/components/file-upload/FileUpload.tsx +802 -0
  481. package/src/components/file-upload/index.ts +6 -0
  482. package/src/components/filter-chip/FilterChip.mdx +778 -0
  483. package/src/components/filter-chip/FilterChip.stories.tsx +827 -0
  484. package/src/components/filter-chip/FilterChip.tsx +881 -0
  485. package/src/components/filter-chip/index.ts +11 -0
  486. package/src/components/filter-facet/FilterFacet.mdx +536 -0
  487. package/src/components/filter-facet/FilterFacet.stories.tsx +506 -0
  488. package/src/components/filter-facet/FilterFacet.tsx +1160 -0
  489. package/src/components/filter-facet/index.ts +7 -0
  490. package/src/components/firm-avatar/FirmAvatar.mdx +280 -0
  491. package/src/components/firm-avatar/FirmAvatar.stories.tsx +147 -0
  492. package/src/components/firm-avatar/FirmAvatar.tsx +172 -0
  493. package/src/components/firm-avatar/index.ts +7 -0
  494. package/src/components/form-actions/FormActions.mdx +518 -0
  495. package/src/components/form-actions/FormActions.stories.tsx +621 -0
  496. package/src/components/form-actions/FormActions.tsx +273 -0
  497. package/src/components/form-actions/index.ts +6 -0
  498. package/src/components/form-block/FormBlock.mdx +728 -0
  499. package/src/components/form-block/FormBlock.stories.tsx +813 -0
  500. package/src/components/form-block/FormBlock.tsx +679 -0
  501. package/src/components/form-block/index.ts +13 -0
  502. package/src/components/form-section/FormSection.mdx +436 -0
  503. package/src/components/form-section/FormSection.stories.tsx +407 -0
  504. package/src/components/form-section/FormSection.tsx +290 -0
  505. package/src/components/form-section/index.ts +17 -0
  506. package/src/components/heading/Heading.mdx +206 -0
  507. package/src/components/heading/Heading.stories.tsx +169 -0
  508. package/src/components/heading/Heading.tsx +124 -0
  509. package/src/components/heading/index.ts +8 -0
  510. package/src/components/heading-group/HeadingGroup.mdx +521 -0
  511. package/src/components/heading-group/HeadingGroup.stories.tsx +353 -0
  512. package/src/components/heading-group/HeadingGroup.tsx +396 -0
  513. package/src/components/heading-group/index.ts +7 -0
  514. package/src/components/hero/Hero.mdx +742 -0
  515. package/src/components/hero/Hero.stories.tsx +527 -0
  516. package/src/components/hero/Hero.tsx +807 -0
  517. package/src/components/hero/index.ts +1 -0
  518. package/src/components/icon/Icon.mdx +329 -0
  519. package/src/components/icon/Icon.stories.tsx +398 -0
  520. package/src/components/icon/Icon.tsx +97 -0
  521. package/src/components/icon/index.ts +2 -0
  522. package/src/components/icon-button/IconButton.mdx +206 -0
  523. package/src/components/icon-button/IconButton.stories.tsx +341 -0
  524. package/src/components/icon-button/IconButton.tsx +273 -0
  525. package/src/components/icon-button/index.ts +1 -0
  526. package/src/components/item-row/ItemRow.mdx +533 -0
  527. package/src/components/item-row/ItemRow.stories.tsx +434 -0
  528. package/src/components/item-row/ItemRow.tsx +676 -0
  529. package/src/components/item-row/index.ts +9 -0
  530. package/src/components/list-row/ListRow.mdx +404 -0
  531. package/src/components/list-row/ListRow.stories.tsx +404 -0
  532. package/src/components/list-row/ListRow.tsx +424 -0
  533. package/src/components/list-row/index.ts +1 -0
  534. package/src/components/menu/Menu.mdx +268 -0
  535. package/src/components/menu/Menu.stories.tsx +455 -0
  536. package/src/components/menu/Menu.tsx +452 -0
  537. package/src/components/menu/index.ts +1 -0
  538. package/src/components/modal/Modal.mdx +854 -0
  539. package/src/components/modal/Modal.stories.tsx +881 -0
  540. package/src/components/modal/Modal.tsx +1434 -0
  541. package/src/components/modal/index.ts +1 -0
  542. package/src/components/nav-link/NavLink.mdx +196 -0
  543. package/src/components/nav-link/NavLink.stories.tsx +243 -0
  544. package/src/components/nav-link/NavLink.tsx +222 -0
  545. package/src/components/nav-link/index.ts +1 -0
  546. package/src/components/number-field/NumberField.mdx +223 -0
  547. package/src/components/number-field/NumberField.stories.tsx +291 -0
  548. package/src/components/number-field/NumberField.tsx +388 -0
  549. package/src/components/number-field/index.ts +6 -0
  550. package/src/components/pagination/Pagination.mdx +305 -0
  551. package/src/components/pagination/Pagination.stories.tsx +333 -0
  552. package/src/components/pagination/Pagination.tsx +343 -0
  553. package/src/components/pagination/index.ts +8 -0
  554. package/src/components/popover-surface/PopoverSurface.mdx +158 -0
  555. package/src/components/popover-surface/PopoverSurface.stories.tsx +421 -0
  556. package/src/components/popover-surface/index.ts +1 -0
  557. package/src/components/progress-bar/ProgressBar.mdx +802 -0
  558. package/src/components/progress-bar/ProgressBar.stories.tsx +533 -0
  559. package/src/components/progress-bar/ProgressBar.tsx +654 -0
  560. package/src/components/progress-bar/index.ts +9 -0
  561. package/src/components/promo-sticker/PromoSticker.mdx +436 -0
  562. package/src/components/promo-sticker/PromoSticker.stories.tsx +363 -0
  563. package/src/components/promo-sticker/PromoSticker.tsx +313 -0
  564. package/src/components/promo-sticker/index.ts +7 -0
  565. package/src/components/promo-surface/PromoSurface.mdx +399 -0
  566. package/src/components/promo-surface/PromoSurface.stories.tsx +270 -0
  567. package/src/components/promo-surface/PromoSurface.tsx +305 -0
  568. package/src/components/promo-surface/index.ts +7 -0
  569. package/src/components/radio/Radio.mdx +243 -0
  570. package/src/components/radio/Radio.stories.tsx +307 -0
  571. package/src/components/radio/Radio.tsx +288 -0
  572. package/src/components/radio/index.ts +1 -0
  573. package/src/components/radio-group/RadioGroup.mdx +119 -0
  574. package/src/components/radio-group/RadioGroup.stories.tsx +225 -0
  575. package/src/components/radio-group/RadioGroup.tsx +139 -0
  576. package/src/components/radio-group/index.ts +1 -0
  577. package/src/components/select/Select.mdx +241 -0
  578. package/src/components/select/Select.stories.tsx +404 -0
  579. package/src/components/select/Select.tsx +381 -0
  580. package/src/components/select/index.ts +1 -0
  581. package/src/components/select-field/SelectField.mdx +324 -0
  582. package/src/components/select-field/SelectField.stories.tsx +460 -0
  583. package/src/components/select-field/SelectField.tsx +138 -0
  584. package/src/components/select-field/index.ts +1 -0
  585. package/src/components/skeleton/Skeleton.mdx +194 -0
  586. package/src/components/skeleton/Skeleton.stories.tsx +260 -0
  587. package/src/components/skeleton/Skeleton.tsx +107 -0
  588. package/src/components/skeleton/index.ts +1 -0
  589. package/src/components/split-button/SplitButton.mdx +445 -0
  590. package/src/components/split-button/SplitButton.stories.tsx +465 -0
  591. package/src/components/split-button/SplitButton.tsx +361 -0
  592. package/src/components/split-button/index.ts +7 -0
  593. package/src/components/status-summary-bar/StatusSummaryBar.mdx +338 -0
  594. package/src/components/status-summary-bar/StatusSummaryBar.stories.tsx +408 -0
  595. package/src/components/status-summary-bar/StatusSummaryBar.tsx +428 -0
  596. package/src/components/status-summary-bar/index.ts +8 -0
  597. package/src/components/subject-lookup-field/SubjectLookupField.mdx +378 -0
  598. package/src/components/subject-lookup-field/SubjectLookupField.stories.tsx +393 -0
  599. package/src/components/subject-lookup-field/SubjectLookupField.tsx +1079 -0
  600. package/src/components/subject-lookup-field/index.ts +11 -0
  601. package/src/components/switch/Switch.mdx +376 -0
  602. package/src/components/switch/Switch.stories.tsx +296 -0
  603. package/src/components/switch/Switch.tsx +483 -0
  604. package/src/components/switch/index.ts +1 -0
  605. package/src/components/table/Table.mdx +575 -0
  606. package/src/components/table/Table.stories.tsx +1049 -0
  607. package/src/components/table/Table.tsx +745 -0
  608. package/src/components/table/TableConsumers.stories.tsx +195 -0
  609. package/src/components/table/_tableFixtures.ts +1189 -0
  610. package/src/components/table/index.ts +22 -0
  611. package/src/components/text-field/TextField.mdx +699 -0
  612. package/src/components/text-field/TextField.stories.tsx +674 -0
  613. package/src/components/text-field/TextField.tsx +645 -0
  614. package/src/components/text-field/index.ts +11 -0
  615. package/src/components/text-link/TextLink.mdx +353 -0
  616. package/src/components/text-link/TextLink.stories.tsx +458 -0
  617. package/src/components/text-link/TextLink.tsx +504 -0
  618. package/src/components/text-link/index.ts +10 -0
  619. package/src/components/textarea/Textarea.mdx +244 -0
  620. package/src/components/textarea/Textarea.stories.tsx +371 -0
  621. package/src/components/textarea/Textarea.tsx +489 -0
  622. package/src/components/textarea/index.ts +9 -0
  623. package/src/components/tooltip/Tooltip.mdx +462 -0
  624. package/src/components/tooltip/Tooltip.stories.tsx +500 -0
  625. package/src/components/tooltip/Tooltip.tsx +756 -0
  626. package/src/components/tooltip/index.ts +13 -0
  627. package/src/components/unit-field/UnitField.mdx +215 -0
  628. package/src/components/unit-field/UnitField.stories.tsx +291 -0
  629. package/src/components/unit-field/UnitField.tsx +255 -0
  630. package/src/components/unit-field/index.ts +7 -0
  631. package/src/icons/icon-registry.generated.ts +510 -0
  632. package/src/icons/icon-types.generated.ts +256 -0
  633. package/src/index.ts +70 -0
  634. package/src/internal/BottomSheet.tsx +714 -0
  635. package/src/internal/FodsProvider.tsx +36 -0
  636. package/src/internal/MotionCaret.tsx +53 -0
  637. package/src/internal/NumberFormatInput.tsx +276 -0
  638. package/src/internal/SummaryDonut.tsx +359 -0
  639. package/src/internal/buttonSegment.ts +241 -0
  640. package/src/internal/collapseRoom.ts +130 -0
  641. package/src/internal/comboboxKeys.ts +90 -0
  642. package/src/internal/contentPresence.ts +46 -0
  643. package/src/internal/dayCell.ts +274 -0
  644. package/src/internal/dialogPortal.ts +50 -0
  645. package/src/internal/donutSweeps.ts +77 -0
  646. package/src/internal/enterOnViewGeometry.ts +53 -0
  647. package/src/internal/faqItem.ts +104 -0
  648. package/src/internal/floatingLabelMotion.tsx +109 -0
  649. package/src/internal/formBlockContext.ts +27 -0
  650. package/src/internal/heightRoom.ts +135 -0
  651. package/src/internal/numberSeparators.ts +93 -0
  652. package/src/internal/overlayMotion.tsx +32 -0
  653. package/src/internal/paginationItem.ts +106 -0
  654. package/src/internal/popoverSurface.ts +78 -0
  655. package/src/internal/portalContainer.ts +11 -0
  656. package/src/internal/progressBarItem.ts +356 -0
  657. package/src/internal/selectionControlText.ts +42 -0
  658. package/src/internal/statusSummaryParts.tsx +475 -0
  659. package/src/internal/summaryMotion.ts +111 -0
  660. package/src/internal/table/ChildConnector.tsx +57 -0
  661. package/src/internal/table/ChildRowPrefix.tsx +21 -0
  662. package/src/internal/table/ColumnSettings.tsx +194 -0
  663. package/src/internal/table/ScrollRegion.tsx +176 -0
  664. package/src/internal/table/TableEmpty.tsx +99 -0
  665. package/src/internal/table/TableLayout.tsx +29 -0
  666. package/src/internal/table/TableLoadStatus.tsx +60 -0
  667. package/src/internal/table/TableMobile.tsx +582 -0
  668. package/src/internal/table/TruncatedCell.tsx +35 -0
  669. package/src/internal/table/emptyValue.ts +11 -0
  670. package/src/internal/table/features.ts +44 -0
  671. package/src/internal/table/recipes.ts +263 -0
  672. package/src/internal/table/rowClick.ts +8 -0
  673. package/src/internal/table/types.ts +342 -0
  674. package/src/internal/tailwind-variants.ts +65 -0
  675. package/src/internal/tooltipContext.ts +15 -0
  676. package/src/internal/tw-merge-config.generated.ts +275 -0
  677. package/src/internal/useAnchoredPanel.ts +340 -0
  678. package/src/internal/useCountUp.ts +65 -0
  679. package/src/internal/useDateFieldTrigger.tsx +497 -0
  680. package/src/internal/useEChart.ts +88 -0
  681. package/src/internal/useEnterOnView.ts +80 -0
  682. package/src/internal/useFloatingBar.ts +125 -0
  683. package/src/internal/useFormReset.ts +57 -0
  684. package/src/internal/useIsMobile.ts +64 -0
  685. package/src/internal/useNoImplicitSubmit.ts +41 -0
  686. package/src/internal/useOneRowOverflow.ts +103 -0
  687. package/src/internal/usePrefersReducedMotion.ts +27 -0
  688. package/src/internal/useReturnFocus.ts +34 -0
  689. package/src/internal/utils.ts +58 -0
  690. package/src/recipes/EmptyState.stories.tsx +105 -0
  691. package/src/recipes/Form.stories.tsx +360 -0
  692. package/src/recipes/ModalWithForm.stories.tsx +219 -0
  693. package/src/recipes/Recipes.mdx +61 -0
  694. package/src/recipes/TableWithFilters.stories.tsx +278 -0
  695. package/src/storybook/FodsFamily.tsx +39 -0
  696. package/src/storybook/Section.tsx +36 -0
  697. package/src/storybook/a11y.ts +24 -0
  698. package/src/storybook/assets/banner-character-bartender.webp +0 -0
  699. package/src/storybook/assets/banner-invoice-sheet-left.webp +0 -0
  700. package/src/storybook/assets/banner-invoice-sheet-right.webp +0 -0
  701. package/src/storybook/assets/invoice-hero.webp +0 -0
  702. package/src/storybook/assets/invoice.webp +0 -0
  703. package/src/storybook/assets/section-document-info.svg +21 -0
  704. package/src/storybook/assets/section-gear-checklist.svg +11 -0
  705. package/src/storybook/assets/section-person-arrow-in.svg +15 -0
  706. package/src/storybook/assets/section-person-arrow-out.svg +22 -0
  707. package/src/storybook/assets/section-receipt-dollar.svg +23 -0
  708. package/src/storybook/assets/table-empty-folder-empty.png +0 -0
  709. package/src/storybook/assets/table-empty-folder-magnifying-glass.png +0 -0
  710. package/src/storybook/assets/table-empty-funnel.png +0 -0
  711. package/src/storybook/assets/table-empty-load-failed.png +0 -0
  712. package/src/storybook/assets/wallet-spot.png +0 -0
  713. package/src/storybook/assets.d.ts +17 -0
  714. package/src/storybook/componentDoc.ts +41 -0
  715. package/src/storybook/fitFrame.tsx +70 -0
  716. package/src/storybook/forceStates.tsx +647 -0
  717. package/src/storybook/illustrations.tsx +66 -0
  718. package/src/storybook/viewportFrame.tsx +58 -0
  719. package/src/styles/assets/label-brush-1.svg +6 -0
  720. package/src/styles/assets/pattern-dark.svg +113 -0
  721. package/src/styles/base.css +106 -0
  722. package/src/styles/index.css +15 -0
  723. package/src/styles/motion.css +157 -0
  724. package/src/styles/promo-sticker.css +27 -0
  725. package/src/styles/promo-surface.css +49 -0
  726. package/src/styles/shared.css +11 -0
  727. package/src/styles/theme.generated.css +314 -0
  728. package/src/styles/theme.map.json +278 -0
  729. package/src/styles/tracking.generated.css +12 -0
  730. package/src/tokens/index.ts +4 -0
  731. package/src/tokens/tokens.generated.ts +542 -0
@@ -0,0 +1,654 @@
1
+ "use client";
2
+ import * as React from 'react';
3
+ import { flushSync } from 'react-dom';
4
+ import { tv } from '../../internal/tailwind-variants';
5
+ import {
6
+ progressBarItemVariants,
7
+ type ProgressBarItemLayout,
8
+ type ProgressBarItemSize,
9
+ type ProgressBarItemState,
10
+ type ProgressBarItemVariant,
11
+ } from '../../internal/progressBarItem';
12
+ import { cn } from '../../internal/utils';
13
+
14
+ /**
15
+ * Phosphor `check-circle` (regular), drawn at the ring's diameter — Done's marker glyph.
16
+ * Circle outline and check are ONE path coloured as a unit through `currentColor`, which
17
+ * is what `families[].states.done.icon` describes.
18
+ *
19
+ * NOT a systemic gap any more: `<Icon name="check-circle" />` renders this exact
20
+ * Phosphor drawing as an SVG. It stays inline for a GEOMETRY reason, not an
21
+ * availability one. `size-full` makes the glyph exactly the ring's diameter by
22
+ * construction, which is what `sizes[].note` ("the same Ø as the ring, so the markers
23
+ * keep one baseline") asks for. An `Icon` is sized as a `--size-icon*` slot box, and
24
+ * the drawing fills only 0.82 of that box, so matching the ring would mean writing
25
+ * the 24 / 22 diameters a second time as a glyph size next to the recipe that already owns
26
+ * them — a duplicated magic number where there is none today. Revisit if the marker ever
27
+ * gets a real icon slot in `internal/progressBarItem.ts`.
28
+ */
29
+ const CHECK_CIRCLE_PATH =
30
+ 'M173.66,98.34a8,8,0,0,1,0,11.32l-56,56a8,8,0,0,1-11.32,0l-24-24a8,8,0,0,1,11.32-11.32L112,148.69l50.34-50.35A8,8,0,0,1,173.66,98.34ZM232,128A104,104,0,1,1,128,24,104.11,104.11,0,0,1,232,128Zm-16,0a88,88,0,1,0-88,88A88.1,88.1,0,0,0,216,128Z';
31
+
32
+ /**
33
+ * The pointer callout's rounded-corner triangle, pointing DOWN at the marker. Decorative —
34
+ * the callout's meaning is carried by the label text next to it.
35
+ *
36
+ * The path was traced from a marketing-artboard instance (11.7965 × 8.36064) and normalised
37
+ * into this 12 × 9 viewBox. The FODS master is 16 × 12 and constant across both sizes
38
+ * (`parts.pointer-label.note`), so the RENDERED size comes from `pointerArrow` in
39
+ * `internal/progressBarItem.ts`, not from the viewBox: 12 : 9 and 16 : 12 are the same 4 : 3,
40
+ * so the box scales the traced path exactly, with no redraw.
41
+ */
42
+ const POINTER_ARROW_PATH =
43
+ 'M5.106 8.61a1.13 1.13 0 0 0 1.585 0l4.896-6.36c.506-.658.037-1.61-.793-1.61H1.002c-.83 0-1.299.952-.793 1.61z';
44
+
45
+ /**
46
+ * ProgressBar — a multi-step progress indicator (spec 04-molecules/progress-bar.md,
47
+ * manifest progress-bar.manifest.json 1.11.1; the step is the private
48
+ * _progress-bar-item.manifest.json 3.4.0, whose recipe lives in
49
+ * `internal/progressBarItem.ts`).
50
+ *
51
+ * One continuous rail behind self-describing markers, filled up to the Current step. Use
52
+ * it for a fixed, ordered sequence whose position must be visible at a glance — a wizard
53
+ * step band (Small) or a marketing rollout narrative (Large). NOT for paging a result set
54
+ * (→ Pagination), NOT for a percentage or indeterminate load (it has no such mode), NOT
55
+ * for independent actions (→ Button Group).
56
+ *
57
+ * ─── The bar owns ONE track ───────────────────────────────────────────────────
58
+ *
59
+ * `intent.rules[0]`: the rail and the fill belong to the BAR, never to the steps. That is
60
+ * the whole reason the v1 shape (StepperItem with per-item connector halves) is retired —
61
+ * a single element can slide forward, N joined segments cannot. Track and fill are two
62
+ * absolutely positioned elements rendered BEFORE the step list — as a SIBLING of the
63
+ * `<ol>`, never inside it, so the list holds the steps and nothing else — and the paint
64
+ * order comes out rail → fill → halo → marker from DOM order alone (`delivery.react`).
65
+ * The only `z-index` in the bar is the Done wash's `::before` layer (`-z-10`), scoped
66
+ * by the root's `isolate` so it paints under the rail and never escapes the bar.
67
+ *
68
+ * Progress is expressed entirely through the children: everything before `currentStep` is
69
+ * Done, `currentStep` is Current, everything after is Upcoming. The fill length is derived
70
+ * from that invariant — `(currentStep / (stepCount − 1)) * 100%` — and is never settable
71
+ * on its own. At the 2-step floor the two valid renders (0% and 100%) are correct results
72
+ * of that formula, not edge cases (`intent.rules[5]`).
73
+ *
74
+ * ─── Rail geometry: measured from real marker CENTRES ─────────────────────────
75
+ *
76
+ * `motion.states.value.note`, verbatim: "Measure the rail's ends from the real marker centres,
77
+ * not from a halo-derived inset: a titled step is as wide as its text, so a halo-based
78
+ * inset leaves the rail sticking out past the first marker."
79
+ *
80
+ * Both layouts get that from CSS grid, with no measurement and no JS. The grid is owned
81
+ * by the root wrapper; the `<ol>` spans it and takes over its tracks through `subgrid`,
82
+ * so the steps sit in the wrapper's tracks while the track — the `<ol>`'s sibling — is
83
+ * placed into the same grid areas as before. `subgrid`, not `display: contents`: the
84
+ * Row → Stack fallback measures real boxes, and a `contents` list has none (older WebKit
85
+ * also drops its list role).
86
+ *
87
+ * - Row — N equal columns (`gridTemplateColumns: repeat(N, minmax(0, 1fr))`), each marker
88
+ * horizontally centred in its own column, so the first and last marker centres sit
89
+ * exactly half a column in from each edge: `left = right = 50 / N %`. The track is an
90
+ * ABSOLUTELY positioned grid child placed into the grid area `1 / -1` of row 1 — a grid
91
+ * area is the containing block for an abspos grid child, which is what makes the
92
+ * percentage resolve against the steps' box (and keeps the rail inside the pointer's top
93
+ * padding instead of measuring from the border edge).
94
+ *
95
+ * - Stack — N rows; the marker is at the top of its step, so its centre is half a marker
96
+ * box below the step's top edge. The track is placed in grid area `1 / N`, then `top:
97
+ * box/2` walks its head onto the first marker's centre and a negative `bottom` walks its
98
+ * tail onto the last one's. That bottom inset is `−(row gap + box/2)`, NOT `−box/2`: a
99
+ * grid area ending on line N reaches the END of track N−1, and the last track starts one
100
+ * GUTTER further down — so the rail would otherwise stop --space-200 short of the last
101
+ * marker, at every step count. The gap term stays a `calc()` on the token so the rail
102
+ * follows a retune of the row gap instead of silently drifting.
103
+ *
104
+ * Halving the marker BOX (13 / 12), not the halo: the halo is centred on the box and only
105
+ * describes how much air the rail loses at each marker, never where the centre is.
106
+ *
107
+ * ─── Motion ───────────────────────────────────────────────────────────────────
108
+ *
109
+ * The fill transitions `width` (Row) / `height` (Stack) over --duration-normal with
110
+ * --easing-standard. `motion` calls this the deliberate exception to the
111
+ * transform-and-opacity-only rule: the fill's ENDS carry the meaning (it must stop exactly
112
+ * on a marker centre) and a scaled transform would distort the --radius-200 cap.
113
+ *
114
+ * The arriving Current dot fades in (opacity 0 → 1, no scale) over --duration-fast on
115
+ * --easing-enter, delayed by (normal − fast) so it lands exactly as the fill arrives
116
+ * (`_progress-bar-item` 3.4.1 `motion.states.value`, inherited by the bar). It is a named keyframe, not a
117
+ * transition, because the dot is a newly MOUNTED element on every step change — and it is
118
+ * armed only after the first `currentStep` change, since "a mounted bar renders its
119
+ * position with no animation" (`motion.trigger`).
120
+ *
121
+ * Under prefers-reduced-motion both are KEPT and shortened to --duration-instant, never
122
+ * removed: a progress indicator is essential motion, and a frozen bar is indistinguishable
123
+ * from a stalled one (`motion.reducedMotion`).
124
+ *
125
+ * ─── Row ↔ Stack: the bar's own content-fit fallback (1.9.0) ─────────────────
126
+ *
127
+ * `layout` is the PREFERRED layout, not a breakpoint. Given Row, the bar renders Row,
128
+ * measures real overflow of its own root (`scrollWidth > clientWidth`) and falls back to
129
+ * Stack by itself — the same principle as 06-patterns/responsive-collapse.md
130
+ * (`delivery.react`: "A consumer passes the preferred Layout and never has to wire the
131
+ * fallback"). `_progress-bar-item` `sizes[].minWidthWhen` (150 on a step with text) is the
132
+ * clip floor that makes that measurement fire. The question is only ever asked in Row —
133
+ * asked while stacked it would always answer "fits" and the bar could never go back — so
134
+ * every width change of the PARENT re-renders Row once and measures it before paint. The
135
+ * parent, not the root: a stacked bar may be content-sized (`max-w-fit`) and then never
136
+ * resizes. The rendered layout is published as `data-layout` for consumer styling. DOM
137
+ * order is sequence order in both layouts, so `aria-current` needs no per-layout
138
+ * special-casing.
139
+ *
140
+ * ─── Done steps are the only interactive element ──────────────────────────────
141
+ *
142
+ * `_progress-bar-item` 3.0.0 gave the step an Interaction axis (Default · Hover · Active)
143
+ * on State=Done: a completed step is a button that returns the flow to it. Current and
144
+ * Upcoming stay inert — a user cannot skip ahead — the bar itself never holds focus, and
145
+ * nothing here takes `disabled`. The ring attaches to the step's own button (manifest
146
+ * `focus`), NOT at this level as the pre-3.0.0 comment here predicted.
147
+ *
148
+ * It is OPT-IN, through `onStepClick` (manifest 1.10.0, `_progress-bar-item` 3.1.0): a
149
+ * product wizard wires the return; a marketing timeline (the e-invoice rollout) renders
150
+ * Done static — no button, no hover / press wash, no focus stop. Without the callback the
151
+ * markup is exactly what shipped before 3.0.0.
152
+ *
153
+ * ─── Accessibility (spec § Accessibility) ─────────────────────────────────────
154
+ *
155
+ * `<ol>` + one `<li>` per step carries the sequence; `aria-current="step"` marks the
156
+ * Current one. Marker, halo, ring and glyph are decorative and `aria-hidden` — a step's
157
+ * accessible name is its Title. In the bare-marker mode (both text booleans off) there is
158
+ * no Title to draw that name from, so `stepLabels` becomes REQUIRED through the props
159
+ * union and renders visually hidden: `aria-current` alone does not let a screen-reader
160
+ * user place themselves in the sequence. A step that merely omits its `title` under the
161
+ * default `showTitle` is outside what the union can see, so it gets a dev-only warning
162
+ * when no `stepLabels` entry covers it — a clickable Done step would otherwise be a
163
+ * nameless button. State is coded by marker SHAPE as well as colour
164
+ * (check / ring / ring + digit), so it survives a grayscale rendering.
165
+ *
166
+ * SIX sub-AA ratios here are REGISTERED upstream exceptions, not oversights — do not
167
+ * re-derive or "fix" them. accessibility.md carries one named section per case:
168
+ * the Upcoming digit's --text-placeholder (2.71:1, decorative-duplicated), the Orange
169
+ * fill (2.37:1 / 1.79:1, confined to the marketing slots), the --outline-default rail
170
+ * (1.32:1 — the rail is ground, not a signal), the pointer callout's --primary label
171
+ * and arrow (2.37:1, `Show pointer` defaults off outside marketing) and the Upcoming
172
+ * ring's --outline-strong (1.73:1, same token and reasoning as the resting control &
173
+ * field edge border) and the Done step's --bg-hover / --bg-active wash (cursor and focus
174
+ * ring duplicate the state).
175
+ */
176
+ const progressBarVariants = tv({
177
+ slots: {
178
+ /**
179
+ * The wrapper: owns the grid in both layouts and is the positioning context for the
180
+ * track. `isolate` scopes the Done wash — a `-z-10` pseudo on the step button, see
181
+ * `internal/progressBarItem.ts` — to the bar, so it paints under the rail.
182
+ */
183
+ root: 'relative isolate grid',
184
+ /** The `<ol>`: the steps and nothing else, laid onto the root's tracks via `subgrid`. */
185
+ list: 'grid list-none',
186
+ /** The neutral rail (`parts.track`) — accent-independent, --outline-default in both accents. */
187
+ track: 'absolute rounded-200 bg-outline-default',
188
+ /**
189
+ * The progressed run (`parts.track-fill`) — same geometry as the rail, ending on the
190
+ * Current marker's centre. Its length is an inline percentage, see the header.
191
+ */
192
+ fill: 'absolute rounded-200',
193
+ },
194
+ variants: {
195
+ size: {
196
+ lg: {},
197
+ sm: {},
198
+ },
199
+ layout: {
200
+ row: {
201
+ // Track 4px thick in both sizes (sizes[].note) = --space-200.
202
+ track: 'h-200',
203
+ fill: 'inset-y-0 left-0 transition-[width] duration-normal ease-standard motion-reduce:duration-instant',
204
+ },
205
+ stack: {
206
+ // Step pitch = the item's min-height 64 plus this --space-200 row gap.
207
+ root: 'gap-200',
208
+ track: 'w-200',
209
+ fill: 'inset-x-0 top-0 transition-[height] duration-normal ease-standard motion-reduce:duration-instant',
210
+ },
211
+ },
212
+ /** Manifest Accent. The rail stays neutral in both; only the fill takes the accent. */
213
+ variant: {
214
+ blue: { fill: 'bg-secondary-solid' },
215
+ orange: { fill: 'bg-primary' },
216
+ },
217
+ /**
218
+ * Row only: reserves the height the floating pointer callout occupies. Applied at the
219
+ * BAR level and driven by "any step has a pointer", never by which step is Current —
220
+ * otherwise every marker would jump by the reserve as the sequence advances.
221
+ */
222
+ hasPointer: {
223
+ true: {},
224
+ false: {},
225
+ },
226
+ },
227
+ compoundVariants: [
228
+ // Row: the rail's centre line is the marker's centre line — box/2 minus half the
229
+ // rail's own 4px thickness, measured from the top of the steps' grid area.
230
+ {
231
+ layout: 'row',
232
+ size: 'lg',
233
+ class: {
234
+ // fods-lint-disable-next-line 11 = marker box 26 / 2 - rail 4 / 2, i.e. the rail centred on the Large marker centre line; a derived offset, not a spacing step
235
+ track: 'top-[11px]',
236
+ },
237
+ },
238
+ // Small: 24 / 2 − 2 = 10 = --space-450.
239
+ { layout: 'row', size: 'sm', class: { track: 'top-450' } },
240
+ // Stack: same centring horizontally, plus the two ends walked onto the first and
241
+ // last marker centres (see the header). Large: box 26 → 11 / 13 / −13.
242
+ {
243
+ layout: 'stack',
244
+ size: 'lg',
245
+ class: {
246
+ track: [
247
+ // fods-lint-disable-next-line 11 = marker box 26 / 2 - rail 4 / 2 — the rail centred on the Large marker column
248
+ 'left-[11px]',
249
+ // fods-lint-disable-next-line 13 = marker box 26 / 2 — the first marker's centre, measured from the step's top edge
250
+ 'top-[13px]',
251
+ '-bottom-[calc(var(--space-200)_+_13px)]',
252
+ ],
253
+ },
254
+ },
255
+ // Small: box 24 → 10 (--space-450) / 12 (--space-500) / −(gap + 12).
256
+ {
257
+ layout: 'stack',
258
+ size: 'sm',
259
+ class: { track: ['left-450', 'top-500', '-bottom-[calc(var(--space-200)_+_12px)]'] },
260
+ },
261
+ // 40px of clearance for the Caveat label plus its 9px arrow and 5px tip gap.
262
+ { layout: 'row', hasPointer: true, class: { root: 'pt-1000' } },
263
+ ],
264
+ defaultVariants: {
265
+ // properties[0].default = Small — the product wizard band is the common case;
266
+ // Large is the marketing/hero exception you opt into.
267
+ size: 'sm',
268
+ layout: 'row',
269
+ variant: 'blue',
270
+ hasPointer: false,
271
+ },
272
+ });
273
+
274
+ /** Manifest Size axis — `lg` = marketing / hero, `sm` = the product wizard band. */
275
+ export type ProgressBarSize = ProgressBarItemSize;
276
+ /** Manifest Layout axis — the PREFERRED layout; Row falls back to Stack when it overflows. */
277
+ export type ProgressBarLayout = ProgressBarItemLayout;
278
+ /** Manifest Accent axis — `orange` only in the four marketing / signature slots. */
279
+ export type ProgressBarVariant = ProgressBarItemVariant;
280
+
281
+ export interface ProgressBarStep {
282
+ /** Step label — short, active-voice, ~28 chars; wraps rather than truncates. */
283
+ title?: string;
284
+ /** One supporting line, ~55 chars, ellipsis past two lines. */
285
+ detail?: string;
286
+ /**
287
+ * Current-only marketing callout, e.g. "Jste tady". Row only — Stack masters carry no
288
+ * pointer node. A fixed short phrase in the hand-lettered marketing voice, never user
289
+ * content and never a wizard tone.
290
+ */
291
+ pointerLabel?: string;
292
+ }
293
+
294
+ export interface ProgressBarBaseProps
295
+ extends Omit<React.HTMLAttributes<HTMLDivElement>, 'children'> {
296
+ /**
297
+ * The sequence, 2–6 steps (`intent.variants`). Content, not a variant: there is no
298
+ * Steps axis. Below 2 there is no progression to show and the fill renders 0%.
299
+ */
300
+ steps: ProgressBarStep[];
301
+ /**
302
+ * 0-based index of the Current step. Everything before it is Done, everything after is
303
+ * Upcoming, and the fill length follows — exactly one Current per bar.
304
+ */
305
+ currentStep: number;
306
+ size?: ProgressBarSize;
307
+ /**
308
+ * The preferred layout. Row falls back to Stack on its own whenever it overflows the
309
+ * available width (1.9.0) — never wire the fallback in the consumer. Stack is final.
310
+ */
311
+ layout?: ProgressBarLayout;
312
+ variant?: ProgressBarVariant;
313
+ /** Figma `Show title`. Off + `showDetail` off = the bare-marker wizard band. */
314
+ showTitle?: boolean;
315
+ /** Figma `Show detail`. */
316
+ showDetail?: boolean;
317
+ /**
318
+ * Figma `Show number` (`properties[Show number].maps`), code-only on the bar: it covers
319
+ * every Upcoming step at once, because Figma cannot bind a parent boolean to a nested
320
+ * instance's property. Off leaves the neutral ring EMPTY at the same size — Current keeps
321
+ * its centre dot, so the states still differ by shape rather than by colour alone.
322
+ */
323
+ showNumbers?: boolean;
324
+ /**
325
+ * Makes every Done step a button that calls back with its 0-based index
326
+ * (`_progress-bar-item` 3.0.0 Interaction). Current and Upcoming never become
327
+ * interactive, whatever this is set to.
328
+ *
329
+ * Opt-in on purpose: the manifest states the button unconditionally because it
330
+ * describes a wizard, but a bar that narrates a fixed timeline has nowhere to jump
331
+ * back to, and buttons there are dead tab stops. Omit it and the step renders
332
+ * exactly as it did before 3.0.0.
333
+ */
334
+ onStepClick?: (index: number) => void;
335
+ }
336
+
337
+ /**
338
+ * `stepLabels` is REQUIRED once the Title is hidden — enforced in the type rather than at
339
+ * runtime, the same shape `FilterChipProps` uses for its clear-button name. Spec
340
+ * § Accessibility: "In the bare-marker mode (Small × Row, both text booleans off) there is
341
+ * no Title to draw that name from, so the consumer must supply a visually-hidden ordinal
342
+ * label per step." The design system is locale-agnostic — these strings come from the
343
+ * consumer's own translations ("Krok 1", "Step 1", …), never from a default here.
344
+ */
345
+ export type ProgressBarProps = ProgressBarBaseProps &
346
+ (
347
+ | { showTitle?: true; stepLabels?: string[] }
348
+ | { showTitle: false; stepLabels: string[] }
349
+ );
350
+
351
+ const ProgressBar = React.forwardRef<HTMLDivElement, ProgressBarProps>(
352
+ (
353
+ {
354
+ className,
355
+ style,
356
+ steps,
357
+ currentStep,
358
+ size = 'sm',
359
+ layout = 'row',
360
+ variant = 'blue',
361
+ showTitle = true,
362
+ showDetail = true,
363
+ showNumbers = true,
364
+ onStepClick,
365
+ stepLabels,
366
+ ...props
367
+ },
368
+ ref,
369
+ ) => {
370
+ /**
371
+ * The bloom is armed by the first `currentStep` CHANGE, never by mount: a bar that
372
+ * renders straight into step 3 must show step 3, not animate into it
373
+ * (`motion.trigger`). Once armed it stays armed — the animation itself re-plays on
374
+ * its own, because the arriving marker's dot is a fresh element every time.
375
+ */
376
+ const seenStep = React.useRef(currentStep);
377
+ const [bloomArmed, setBloomArmed] = React.useState(false);
378
+ React.useEffect(() => {
379
+ if (seenStep.current === currentStep) return;
380
+ seenStep.current = currentStep;
381
+ setBloomArmed(true);
382
+ }, [currentStep]);
383
+
384
+ const rootRef = React.useRef<HTMLDivElement | null>(null);
385
+ const setRefs = React.useCallback(
386
+ (node: HTMLDivElement | null) => {
387
+ rootRef.current = node;
388
+ if (typeof ref === 'function') ref(node);
389
+ else if (ref) ref.current = node;
390
+ },
391
+ [ref],
392
+ );
393
+
394
+ /*
395
+ * Content-fit fallback, see the header. `measure` renders Row for one layout pass;
396
+ * the layout effect reads the overflow before paint and settles on Row or Stack.
397
+ * Re-measured on every width change of the parent, whenever the content changes and
398
+ * when a web font finishes loading.
399
+ */
400
+ const [fit, setFit] = React.useState<'measure' | 'row' | 'stack'>('measure');
401
+ const contentKey = `${steps.map(step => `${step.title ?? ''}|${step.detail ?? ''}|${step.pointerLabel ?? ''}`).join('/')}|${size}|${String(showTitle)}|${String(showDetail)}`;
402
+
403
+ React.useLayoutEffect(() => {
404
+ setFit('measure');
405
+ }, [layout, contentKey]);
406
+
407
+ React.useLayoutEffect(() => {
408
+ if (fit !== 'measure' || layout !== 'row') return;
409
+ const root = rootRef.current;
410
+ setFit(root && root.scrollWidth > root.clientWidth ? 'stack' : 'row');
411
+ }, [fit, layout]);
412
+
413
+ React.useLayoutEffect(() => {
414
+ const host = rootRef.current?.parentElement;
415
+ if (layout !== 'row' || !host || typeof ResizeObserver === 'undefined') return undefined;
416
+ // Synchronous, so the Row probe and its verdict land in the same frame.
417
+ const remeasure = () => flushSync(() => setFit('measure'));
418
+ let lastWidth = host.clientWidth;
419
+ let frame: number | undefined;
420
+ const observer = new ResizeObserver(() => {
421
+ if (host.clientWidth === lastWidth) return;
422
+ lastWidth = host.clientWidth;
423
+ // Deferred to the next frame: the probe changes the host's height, and doing that
424
+ // inside the observer callback trips "ResizeObserver loop completed with
425
+ // undelivered notifications".
426
+ if (frame !== undefined) cancelAnimationFrame(frame);
427
+ frame = requestAnimationFrame(() => {
428
+ frame = undefined;
429
+ remeasure();
430
+ });
431
+ });
432
+ observer.observe(host);
433
+ // A web font landing after the first probe widens the text without resizing the host.
434
+ const fonts = typeof document !== 'undefined' ? document.fonts : undefined;
435
+ fonts?.addEventListener('loadingdone', remeasure);
436
+ return () => {
437
+ observer.disconnect();
438
+ if (frame !== undefined) cancelAnimationFrame(frame);
439
+ fonts?.removeEventListener('loadingdone', remeasure);
440
+ };
441
+ }, [layout]);
442
+
443
+ const effectiveLayout: ProgressBarLayout = layout === 'row' && fit === 'stack' ? 'stack' : layout;
444
+
445
+ const stepCount = steps.length;
446
+ const lastIndex = stepCount - 1;
447
+ const activeStep = Math.min(Math.max(currentStep, 0), Math.max(lastIndex, 0));
448
+
449
+ // Indices of clickable Done steps whose `<button>` would have no accessible name:
450
+ // no visible Title, no visible detail, and no ordinal to stand in — the case the
451
+ // props union cannot express (a `title` missing under `showTitle`).
452
+ const unnamedSteps = onStepClick
453
+ ? steps
454
+ .map((step, index) =>
455
+ index < activeStep &&
456
+ !(showTitle && step.title) &&
457
+ !(showDetail && step.detail) &&
458
+ !stepLabels?.[index]
459
+ ? index
460
+ : -1,
461
+ )
462
+ .filter(index => index >= 0)
463
+ .join(', ')
464
+ : '';
465
+ React.useEffect(() => {
466
+ if (process.env.NODE_ENV === 'production' || !unnamedSteps) return;
467
+ // eslint-disable-next-line no-console
468
+ console.warn(
469
+ `ProgressBar: Done step(s) ${unnamedSteps} render as buttons with no title, no detail and no \`stepLabels\` entry, so they have no accessible name. Pass a \`stepLabels\` entry for every step without a visible title.`,
470
+ );
471
+ }, [unnamedSteps]);
472
+ // Guarded division: a single step has no rail to travel along (manifest floor is 2).
473
+ const fillPercent = lastIndex > 0 ? (activeStep / lastIndex) * 100 : 0;
474
+
475
+ const isRow = effectiveLayout === 'row';
476
+ // Reserved for the whole bar, not for the Current step — see the recipe's `hasPointer`.
477
+ const hasPointer = isRow && steps.some(step => Boolean(step.pointerLabel));
478
+
479
+ const slots = progressBarVariants({ size, layout: effectiveLayout, variant, hasPointer });
480
+
481
+ return (
482
+ <div
483
+ ref={setRefs}
484
+ data-fods-component="progress-bar"
485
+ data-fods-part="root"
486
+ {...props}
487
+ data-layout={effectiveLayout}
488
+ className={cn(slots.root(), className)}
489
+ style={{
490
+ ...(isRow
491
+ ? { gridTemplateColumns: `repeat(${Math.max(stepCount, 1)}, minmax(0, 1fr))` }
492
+ : { gridTemplateRows: `repeat(${Math.max(stepCount, 1)}, auto)` }),
493
+ ...style,
494
+ }}
495
+ >
496
+ {stepCount > 1 && (
497
+ <div
498
+ aria-hidden="true"
499
+ data-fods-part="track"
500
+ className={slots.track()}
501
+ style={
502
+ isRow
503
+ // Half a column in from each edge = the first / last marker's centre.
504
+ ? { gridRow: 1, gridColumn: '1 / -1', left: `${50 / stepCount}%`, right: `${50 / stepCount}%` }
505
+ // Rows 1..N−1, i.e. down to the last step's top edge; the recipe's
506
+ // negative bottom inset walks it on to that step's marker centre.
507
+ : { gridColumn: 1, gridRow: `1 / ${stepCount}` }
508
+ }
509
+ >
510
+ <span
511
+ data-fods-part="track-fill"
512
+ className={slots.fill()}
513
+ style={isRow ? { width: `${fillPercent}%` } : { height: `${fillPercent}%` }}
514
+ />
515
+ </div>
516
+ )}
517
+
518
+ <ol
519
+ // <ol> is the sequence semantics; `role="list"` keeps them in Safari, where
520
+ // `list-style: none` (Tailwind preflight) otherwise drops the list role.
521
+ role="list"
522
+ className={slots.list()}
523
+ style={
524
+ isRow
525
+ ? { gridRow: 1, gridColumn: '1 / -1', gridTemplateColumns: 'subgrid' }
526
+ : { gridColumn: 1, gridRow: '1 / -1', gridTemplateRows: 'subgrid' }
527
+ }
528
+ >
529
+
530
+ {steps.map((step, index) => {
531
+ let state: ProgressBarItemState = 'upcoming';
532
+ if (index < activeStep) state = 'done';
533
+ else if (index === activeStep) state = 'current';
534
+
535
+ const titleVisible = showTitle && Boolean(step.title);
536
+ const detailVisible = showDetail && Boolean(step.detail);
537
+
538
+ const item = progressBarItemVariants({
539
+ size,
540
+ layout: effectiveLayout,
541
+ variant,
542
+ state,
543
+ bloom: bloomArmed && state === 'current',
544
+ // Row's 150 text floor rides on this: a marker-only step must not carry
545
+ // it, or the item outgrows its 1fr column and the rail — which measures
546
+ // from COLUMN centres — no longer lands on the markers. See the compound
547
+ // in internal/progressBarItem.ts.
548
+ hasText: titleVisible || detailVisible,
549
+ });
550
+ // The ordinal stands in for the Title whenever the Title is not rendered — that
551
+ // is the whole point of the type union above.
552
+ const ordinalLabel = titleVisible ? undefined : stepLabels?.[index];
553
+ // Row × Current only; Stack masters carry no pointer node (parts.pointer-label).
554
+ const pointerVisible = isRow && state === 'current' && Boolean(step.pointerLabel);
555
+
556
+ // Done alone is interactive (`properties[Interaction]`), and only where the
557
+ // consumer gave the click somewhere to go.
558
+ const clickable = state === 'done' && Boolean(onStepClick);
559
+
560
+ // The item's content is the same either way — what changes is whether a
561
+ // button wraps it. Naming it once keeps the two branches from drifting.
562
+ const content = (
563
+ <>
564
+ <span className={item.markerBox()}>
565
+ <span aria-hidden="true" data-fods-part="halo" className={item.halo()} />
566
+ <span aria-hidden="true" data-fods-part="marker" className={item.marker()}>
567
+ {state === 'done' && (
568
+ <svg viewBox="0 0 256 256" fill="currentColor" className="size-full">
569
+ <path d={CHECK_CIRCLE_PATH} />
570
+ </svg>
571
+ )}
572
+ {state === 'current' && (
573
+ <span data-fods-part="dot" className={item.dot()} />
574
+ )}
575
+ {state === 'upcoming' && showNumbers && (
576
+ <span data-fods-part="number" className={item.number()}>
577
+ {index + 1}
578
+ </span>
579
+ )}
580
+ </span>
581
+ {pointerVisible && (
582
+ <span data-fods-part="pointer-label" className={item.pointer()}>
583
+ <span className={item.pointerLabel()}>
584
+ {step.pointerLabel}
585
+ </span>
586
+ <svg
587
+ viewBox="0 0 12 9"
588
+ fill="currentColor"
589
+ aria-hidden="true"
590
+ className={item.pointerArrow()}
591
+ >
592
+ <path d={POINTER_ARROW_PATH} />
593
+ </svg>
594
+ </span>
595
+ )}
596
+ </span>
597
+
598
+ {/*
599
+ The visually-hidden ordinal sits OUTSIDE the text column: in bare-marker
600
+ mode that column would otherwise render as an empty flex box and add its
601
+ gap under every marker.
602
+ */}
603
+ {ordinalLabel && <span className="sr-only">{ordinalLabel}</span>}
604
+
605
+ {(titleVisible || detailVisible) && (
606
+ <span className={item.text()}>
607
+ {titleVisible && (
608
+ <span data-fods-part="title" className={item.title()}>
609
+ {step.title}
610
+ </span>
611
+ )}
612
+ {detailVisible && (
613
+ <span data-fods-part="detail" className={item.detail()}>
614
+ {step.detail}
615
+ </span>
616
+ )}
617
+ </span>
618
+ )}
619
+ </>
620
+ );
621
+
622
+ return (
623
+ <li
624
+ key={index}
625
+ data-fods-part="step"
626
+ data-fods-state={state}
627
+ aria-current={state === 'current' ? 'step' : undefined}
628
+ // The `<li>` hands its layout to the button when there is one, so the
629
+ // wash and the ring wrap the whole item rather than a box inside it.
630
+ className={clickable ? item.stepCell() : item.step()}
631
+ >
632
+ {clickable ? (
633
+ <button
634
+ type="button"
635
+ data-fods-part="surface"
636
+ onClick={() => onStepClick?.(index)}
637
+ className={cn(item.step(), item.surface())}
638
+ >
639
+ {content}
640
+ </button>
641
+ ) : (
642
+ content
643
+ )}
644
+ </li>
645
+ );
646
+ })}
647
+ </ol>
648
+ </div>
649
+ );
650
+ },
651
+ );
652
+ ProgressBar.displayName = 'ProgressBar';
653
+
654
+ export { ProgressBar, progressBarVariants };
@@ -0,0 +1,9 @@
1
+ export {
2
+ ProgressBar,
3
+ progressBarVariants,
4
+ type ProgressBarProps,
5
+ type ProgressBarStep,
6
+ type ProgressBarSize,
7
+ type ProgressBarLayout,
8
+ type ProgressBarVariant,
9
+ } from './ProgressBar';