@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,268 @@
1
+ import { PromoSurfaceSurface } from "../promo-surface/PromoSurface.js";
2
+ import * as React from "react";
3
+ /**
4
+ * Hero — the first-screen panel of a public page (`hero.manifest.json`, organism,
5
+ * v1.5.4, `kind: "region"`).
6
+ *
7
+ * A promo plaque carrying the page's single claim, at most two actions and — where the
8
+ * page has one — one image. Landing pages, the homepage, the news index, the register
9
+ * search. Never an in-app card, section or callout: the plaque comes from Promo
10
+ * Surface, a public-page-only atom (`intent.whenToUse`).
11
+ *
12
+ * ## No chrome of its own
13
+ *
14
+ * The fill, the tiled pattern and the veil are delegated WHOLE to `<PromoSurface>`.
15
+ * `container.note` is explicit that the root has no fill and no border — `--bg-primary`
16
+ * is the page canvas *behind* the component, not chrome. Per `delivery.react` the
17
+ * surface renders as "a sibling background layer, absolutely positioned to the panel's
18
+ * bounds", so the text column and the image are siblings ABOVE it, never inside it.
19
+ *
20
+ * Because an absolutely positioned sibling paints over static in-flow siblings, the
21
+ * content layers (`text-column`, `image`) are `relative`. Same trick ListRow /
22
+ * ActionRow use for their `::before` wash — no z-index needed.
23
+ *
24
+ * ## Axes: Breakpoint x Visual (+ sparse Actions width), 12 variants — only two are props
25
+ *
26
+ * `intent.sizing`: "No size axis — Breakpoint IS the sizing". The five breakpoints are
27
+ * pure CSS responsiveness, so there is no `size` and no `breakpoint` prop. Figma
28
+ * breakpoint -> Tailwind prefix: Mobile 390 = unprefixed, SM 600 = `sm:`, MD 720 =
29
+ * `md:`, LG 960 = `lg:`, XL 1270 = `xl:`.
30
+ *
31
+ * `visual` IS a prop, and a discriminated union rather than a boolean, because
32
+ * `intent.rules[1]` / `regions.image.note` / `intent.variants` all say the same thing
33
+ * three times: "An empty Image slot is not a centred hero — Visual=Off is the centred
34
+ * composition, built centred from the start, not an image slot left empty beside a
35
+ * full-width text column." It therefore has NO default: the page has to make the
36
+ * compositional choice consciously, and the union makes TypeScript enforce it (no
37
+ * runtime guard required).
38
+ *
39
+ * ## Booleans are slots
40
+ *
41
+ * The Figma booleans `Kicker` / `Body` / `Actions` / `Format icon` / `Sub`
42
+ * (`properties[]`) map onto slot PRESENCE — an undefined slot does not render. A Figma
43
+ * boolean plus an instance swap is one slot prop, never two props.
44
+ *
45
+ * ## No states
46
+ *
47
+ * `intent.states`: no interaction states on the shell. No hover, no active, no
48
+ * disabled, no loading — whatever lands in `actions` / `formatIcon` / `sub` owns its
49
+ * own states.
50
+ *
51
+ * ## Motion — one entrance, once
52
+ *
53
+ * `motion.enter` (1.5.2): kicker → heading → body → CTA fade in one after another over
54
+ * --duration-slow / --easing-enter, each settling --space-200 up into place; at
55
+ * Visual=On the image follows the text and only fades. It plays once, on first viewport
56
+ * entry (IntersectionObserver 0.3) — `useEnterOnView` drives `data-hero-motion` on the
57
+ * root and the pieces read it through the named group `hero`. The stagger has no token
58
+ * (manifest `gaps[]`), so each piece carries its step in `--hero-step` and the keyframe
59
+ * derives the delay from --duration-instant (the theme's `hero-enter-*`). The
60
+ * Format icon and `sub` are not in the sequence and never move. Every gating class is
61
+ * `motion-safe:`: under reduced motion the content is there at once, no fade-up.
62
+ * (`tailwindcss-animate` is not installed, so the keyframes are named, not `animate-in`.)
63
+ */
64
+ declare const heroVariants: import("tailwind-variants").TVReturnType<{
65
+ actionsWidth: {
66
+ narrow: {
67
+ actions: string;
68
+ };
69
+ medium: {
70
+ actions: string;
71
+ };
72
+ };
73
+ surface: {
74
+ brand: {
75
+ panel: string;
76
+ kicker: string;
77
+ body: string;
78
+ };
79
+ utility: {
80
+ panel: string;
81
+ kicker: string;
82
+ body: string;
83
+ };
84
+ solid: {
85
+ panel: string;
86
+ };
87
+ inverse: {
88
+ panel: string;
89
+ };
90
+ };
91
+ visual: {
92
+ on: {
93
+ panel: string;
94
+ textColumn: string[];
95
+ copy: string;
96
+ actions: string;
97
+ formatIcon: string[];
98
+ image: string[];
99
+ };
100
+ off: {
101
+ panel: string[];
102
+ textColumn: string;
103
+ copy: string;
104
+ actions: string;
105
+ formatIcon: string;
106
+ };
107
+ };
108
+ }, {
109
+ root: string[];
110
+ panel: string[];
111
+ textColumn: string[];
112
+ formatIcon: string[];
113
+ copy: string[];
114
+ titleGroup: string[];
115
+ kicker: string[];
116
+ heading: string[];
117
+ body: string[];
118
+ actions: string[];
119
+ image: string[];
120
+ sub: string[];
121
+ }, undefined, undefined, undefined, undefined>;
122
+ /**
123
+ * The plaque tone, passed straight through to `<PromoSurface surface>`, which owns the
124
+ * fill. Hero only pairs the matching ink with it (`chrome.ink`).
125
+ *
126
+ * `solid` and `inverse` are DARK plaques, and two obligations ride on the consumer there
127
+ * (`intent.rules`):
128
+ *
129
+ * 1. ONE brand CTA, no secondary action — the same rule Banner holds. `Secondary` and
130
+ * `Tertiary` both ink their label with `--secondary`, which measures 1.33:1 on
131
+ * `--secondary-solid` and 1.59:1 on `--bg-inverse`; the label disappears and all that
132
+ * is left of the button is its border. No Button family is built for a dark ground and
133
+ * none is coming — the stance is compose, not recolour
134
+ * (`spec/06-patterns/inverse-surface.md`).
135
+ * 2. The default focus ring is under the 3:1 non-text floor there, so anything focusable
136
+ * composed into `actions` MUST bind `--outline-focus-inverse`
137
+ * (`focus-visible:outline-outline-focus-inverse`). It is `outline-*`, never `ring-*`:
138
+ * the floor wants an additive offset OUTLINE, and a ring is a box-shadow that would
139
+ * sit alongside the real one instead of replacing it. Hero cannot do that for you:
140
+ * it owns no focusable element and never overrides the focus behaviour of its slot
141
+ * content — see `ActionsBlock` in the stories for the shape. The obligation is
142
+ * Actions-only: `regions.sub.note` puts `sub` OUTSIDE the plaque fill, so a white
143
+ * inverse ring would be wrong there.
144
+ */
145
+ export type HeroSurface = PromoSurfaceSurface;
146
+ /**
147
+ * Which content band `actions` is capped to — `narrow` (580, the measure) for buttons
148
+ * and search fields, `medium` (786, the non-prose column) for a featured-content card.
149
+ * See the `actionsWidth` variant in the recipe for the reasoning.
150
+ */
151
+ export type HeroActionsWidth = 'narrow' | 'medium';
152
+ export interface HeroBase extends Omit<React.HTMLAttributes<HTMLElement>, 'children'> {
153
+ /**
154
+ * The page claim. Rendered as the page's `<h1>` (`delivery.react`), so there must be
155
+ * exactly one Hero per page. Wraps, ~70 characters (`text.heading`).
156
+ */
157
+ heading: React.ReactNode;
158
+ /**
159
+ * The line ABOVE the heading. A plain text line, never a heading itself
160
+ * (`delivery.react`, `text.kicker`) — do not pass a heading element and do not give it
161
+ * `role="heading"`; that breaks the page heading order for screen-reader users.
162
+ * Wraps to 2 lines, ~60 characters.
163
+ */
164
+ kicker?: React.ReactNode;
165
+ /**
166
+ * ONE block, not a row of loose buttons (`slots.actions`): a button group, a search
167
+ * field or a featured-content component, up to 2 children, stretched to the text
168
+ * column. The block keeps its own hover / focus / active / disabled states — see
169
+ * `surface` for the one obligation it inherits from the plaque.
170
+ */
171
+ actions?: React.ReactNode;
172
+ /**
173
+ * The width cap on the `actions` block. Defaults to `narrow` (`--ds-content-narrow`,
174
+ * 580 = the measure), which is right for a button group or a search field. Set `medium`
175
+ * (`--ds-content-medium`, 786) only when the slot carries FEATURED CONTENT — a bordered
176
+ * card, which the measure would clamp and re-centre. Ignored when `actions` is not set.
177
+ *
178
+ * The axis is SPARSE upstream: `axes.actions-width` exists only at XL·Off and LG·Off,
179
+ * "the two cells whose text column fits 786" (`slots.actions.note`). Every other cell's
180
+ * column is narrower than the Narrow cap already, so `medium` has nothing to buy there.
181
+ * The copy block keeps its 580 prose measure on both values — only this slot swaps.
182
+ */
183
+ actionsWidth?: HeroActionsWidth;
184
+ /**
185
+ * A document-format mark — Word / Excel / PDF / Sheets / Docs. A closed vocabulary by
186
+ * convention; Figma stopped enforcing it in 1.0.0 (`changelog`), the intent did not
187
+ * change: a format mark, not arbitrary art.
188
+ *
189
+ * ARTWORK, NOT A GLYPH. The slot holds the format's own mark artwork — the square
190
+ * Word / Excel / PDF / Sheets / Docs images a template landing page
191
+ * ships — not an icon glyph; Sheets and Docs are deliberately NOT being added to the
192
+ * icon set. `intent.rules[2]` (1.5.1) sizes the box a square 48×48 (`--size-illustration-spot`) at
193
+ * every breakpoint, and the slot fits the artwork into it (`object-fit: contain`), never
194
+ * crops it. Pass a bare `<img alt="">` — the slot owns geometry and fit.
195
+ *
196
+ * Purely decorative. The wrapper carries `aria-hidden="true"` because the format is
197
+ * always named in the copy, so the mark never carries its own accessible name.
198
+ */
199
+ formatIcon?: React.ReactNode;
200
+ /**
201
+ * The strip UNDER the plaque — a format switcher, a figure strip or progress. It sits
202
+ * outside the Promo Surface fill: page chrome, not plaque chrome (`regions.sub.note`),
203
+ * so it does not inherit the plaque ink. Off unless the page opts in.
204
+ */
205
+ sub?: React.ReactNode;
206
+ /** The plaque tone. Defaults to `brand`. */
207
+ surface?: HeroSurface;
208
+ className?: string;
209
+ }
210
+ /**
211
+ * The lead under the heading, in one of two mutually exclusive forms — a union rather than
212
+ * two loose optionals, so the compiler rejects passing both instead of the component having
213
+ * to pick a winner at runtime. Same device, and same reason, as the `visual` / `image` pair.
214
+ *
215
+ * `body` is the normal one: a node, rendered inside the component's own `<p>`.
216
+ *
217
+ * `bodyHtml` exists for ONE case — a lead that arrives as rich text from a CMS. Such a CMS wraps
218
+ * every `perex` in its own `<p>`, and a `<p>` inside a `<p>` is not merely invalid: the HTML
219
+ * parser splits it into siblings, so on a server-rendered page (`renderToString` on the
220
+ * server, `hydrateRoot` on the client) the parsed tree stops matching what React expects and
221
+ * the whole SSR tree is thrown away and repainted. This arm therefore renders a `<div>` — the
222
+ * CMS supplies the paragraph semantics itself, one level in.
223
+ *
224
+ * `<p>` is NOT a contract here, which is what makes this legal: `delivery.react` is the one
225
+ * place the manifest names elements and it names `<h1>` for the heading and `<img>` for the
226
+ * image — `body` is absent from it, `text.body` records only overflow and length, and
227
+ * `typography.runs.body` calls the lead a "paragraph" as a TYPOGRAPHIC reading (it is
228
+ * justifying Body/XL over Body/L), not as markup.
229
+ *
230
+ * `bodyHtml?: undefined` on the other arm, NOT `bodyHtml?: never` — for the reason already
231
+ * written out on `image` below.
232
+ */
233
+ type HeroBodyProps = {
234
+ body?: React.ReactNode;
235
+ bodyHtml?: undefined;
236
+ } |
237
+ /**
238
+ * TRUSTED, EDITORIAL HTML ONLY. This is the only `dangerouslySetInnerHTML` in the design
239
+ * system, and it stays that way on purpose: the string must come from a CMS the team
240
+ * controls, never from anything a visitor can write, and sanitising it is the caller's job
241
+ * — Hero cannot tell the two apart.
242
+ *
243
+ * `text.body` still holds: one lead paragraph, 3 lines / ~120 characters. Tailwind's
244
+ * preflight zeroes `<p>` margins, so two paragraphs would run together — the component
245
+ * deliberately adds no spacing for that, because the spec does not expect a second one.
246
+ */
247
+ {
248
+ bodyHtml: string;
249
+ body?: undefined;
250
+ };
251
+ /**
252
+ * `visual` has NO default. Visual=Off is not "Visual=On without an image", it is a
253
+ * different composition (`intent.rules[1]`), so the page has to choose.
254
+ *
255
+ * The `image` node is the consumer's own `<img>` or visual component, which means the
256
+ * ALT TEXT is the consumer's responsibility — and it is required: give it real alt text
257
+ * describing the page claim, not `alt=""` and not the file name. Hero cannot supply it,
258
+ * hence no `imageAlt` prop.
259
+ */
260
+ export type HeroProps = HeroBase & ({
261
+ visual: 'on';
262
+ image: React.ReactNode;
263
+ } | {
264
+ visual: 'off';
265
+ image?: undefined;
266
+ }) & HeroBodyProps;
267
+ declare const Hero: React.ForwardRefExoticComponent<HeroProps & React.RefAttributes<HTMLElement>>;
268
+ export { Hero, heroVariants };
@@ -0,0 +1,316 @@
1
+ "use client";
2
+ import { tv } from "../../internal/tailwind-variants.js";
3
+ import { cn } from "../../internal/utils.js";
4
+ import { PromoSurface } from "../promo-surface/PromoSurface.js";
5
+ import { useEnterOnView } from "../../internal/useEnterOnView.js";
6
+ import * as React from "react";
7
+ import { Fragment, jsx, jsxs } from "react/jsx-runtime";
8
+ // src/components/hero/Hero.tsx
9
+ /**
10
+ * Hero — the first-screen panel of a public page (`hero.manifest.json`, organism,
11
+ * v1.5.4, `kind: "region"`).
12
+ *
13
+ * A promo plaque carrying the page's single claim, at most two actions and — where the
14
+ * page has one — one image. Landing pages, the homepage, the news index, the register
15
+ * search. Never an in-app card, section or callout: the plaque comes from Promo
16
+ * Surface, a public-page-only atom (`intent.whenToUse`).
17
+ *
18
+ * ## No chrome of its own
19
+ *
20
+ * The fill, the tiled pattern and the veil are delegated WHOLE to `<PromoSurface>`.
21
+ * `container.note` is explicit that the root has no fill and no border — `--bg-primary`
22
+ * is the page canvas *behind* the component, not chrome. Per `delivery.react` the
23
+ * surface renders as "a sibling background layer, absolutely positioned to the panel's
24
+ * bounds", so the text column and the image are siblings ABOVE it, never inside it.
25
+ *
26
+ * Because an absolutely positioned sibling paints over static in-flow siblings, the
27
+ * content layers (`text-column`, `image`) are `relative`. Same trick ListRow /
28
+ * ActionRow use for their `::before` wash — no z-index needed.
29
+ *
30
+ * ## Axes: Breakpoint x Visual (+ sparse Actions width), 12 variants — only two are props
31
+ *
32
+ * `intent.sizing`: "No size axis — Breakpoint IS the sizing". The five breakpoints are
33
+ * pure CSS responsiveness, so there is no `size` and no `breakpoint` prop. Figma
34
+ * breakpoint -> Tailwind prefix: Mobile 390 = unprefixed, SM 600 = `sm:`, MD 720 =
35
+ * `md:`, LG 960 = `lg:`, XL 1270 = `xl:`.
36
+ *
37
+ * `visual` IS a prop, and a discriminated union rather than a boolean, because
38
+ * `intent.rules[1]` / `regions.image.note` / `intent.variants` all say the same thing
39
+ * three times: "An empty Image slot is not a centred hero — Visual=Off is the centred
40
+ * composition, built centred from the start, not an image slot left empty beside a
41
+ * full-width text column." It therefore has NO default: the page has to make the
42
+ * compositional choice consciously, and the union makes TypeScript enforce it (no
43
+ * runtime guard required).
44
+ *
45
+ * ## Booleans are slots
46
+ *
47
+ * The Figma booleans `Kicker` / `Body` / `Actions` / `Format icon` / `Sub`
48
+ * (`properties[]`) map onto slot PRESENCE — an undefined slot does not render. A Figma
49
+ * boolean plus an instance swap is one slot prop, never two props.
50
+ *
51
+ * ## No states
52
+ *
53
+ * `intent.states`: no interaction states on the shell. No hover, no active, no
54
+ * disabled, no loading — whatever lands in `actions` / `formatIcon` / `sub` owns its
55
+ * own states.
56
+ *
57
+ * ## Motion — one entrance, once
58
+ *
59
+ * `motion.enter` (1.5.2): kicker → heading → body → CTA fade in one after another over
60
+ * --duration-slow / --easing-enter, each settling --space-200 up into place; at
61
+ * Visual=On the image follows the text and only fades. It plays once, on first viewport
62
+ * entry (IntersectionObserver 0.3) — `useEnterOnView` drives `data-hero-motion` on the
63
+ * root and the pieces read it through the named group `hero`. The stagger has no token
64
+ * (manifest `gaps[]`), so each piece carries its step in `--hero-step` and the keyframe
65
+ * derives the delay from --duration-instant (the theme's `hero-enter-*`). The
66
+ * Format icon and `sub` are not in the sequence and never move. Every gating class is
67
+ * `motion-safe:`: under reduced motion the content is there at once, no fade-up.
68
+ * (`tailwindcss-animate` is not installed, so the keyframes are named, not `animate-in`.)
69
+ */
70
+ const heroVariants = tv({
71
+ slots: {
72
+ root: [
73
+ "group/hero flex w-full flex-col",
74
+ "py-600 sm:py-800",
75
+ "gap-800 lg:gap-900"
76
+ ],
77
+ panel: [
78
+ "relative flex flex-col",
79
+ "rounded-800",
80
+ "pt-1200 lg:pt-0"
81
+ ],
82
+ textColumn: [
83
+ "relative flex flex-col",
84
+ "gap-900",
85
+ "px-800 py-600 sm:px-900 sm:py-800 lg:p-1000 xl:py-1200"
86
+ ],
87
+ formatIcon: [
88
+ "shrink-0",
89
+ "size-illustration-spot",
90
+ "[&_svg]:size-full [&_img]:size-full [&_img]:object-contain"
91
+ ],
92
+ copy: [
93
+ "flex flex-col",
94
+ "gap-600",
95
+ "max-w-content-narrow"
96
+ ],
97
+ titleGroup: ["flex flex-col", "gap-400"],
98
+ kicker: [
99
+ "font-caveat",
100
+ "text-body-xl leading-[26px] md:text-heading-xxl md:leading-[40px]",
101
+ "motion-safe:group-data-[hero-motion=armed]/hero:opacity-0 motion-safe:group-data-[hero-motion=play]/hero:animate-hero-enter-rise"
102
+ ],
103
+ heading: [
104
+ "font-poppins font-bold",
105
+ "text-display-d2",
106
+ "[text-wrap:var(--text-wrap-heading)]",
107
+ "motion-safe:group-data-[hero-motion=armed]/hero:opacity-0 motion-safe:group-data-[hero-motion=play]/hero:animate-hero-enter-rise"
108
+ ],
109
+ body: [
110
+ "font-inter",
111
+ "text-body-xl",
112
+ "[text-wrap:var(--text-wrap-body)]",
113
+ "motion-safe:group-data-[hero-motion=armed]/hero:opacity-0 motion-safe:group-data-[hero-motion=play]/hero:animate-hero-enter-rise"
114
+ ],
115
+ actions: [
116
+ "flex flex-wrap items-center gap-400",
117
+ "w-full",
118
+ "motion-safe:group-data-[hero-motion=armed]/hero:opacity-0 motion-safe:group-data-[hero-motion=play]/hero:animate-hero-enter-rise"
119
+ ],
120
+ image: [
121
+ "relative flex w-full",
122
+ "overflow-hidden rounded-b-800 lg:rounded-bl-none lg:rounded-tr-800 lg:rounded-br-800",
123
+ "items-end justify-start",
124
+ "[&_img]:h-auto [&_img]:w-full",
125
+ "lg:[&_img]:absolute lg:[&_img]:bottom-0 lg:[&_img]:left-0",
126
+ "lg:[&_img]:h-full lg:[&_img]:w-auto lg:[&_img]:max-w-none",
127
+ "motion-safe:group-data-[hero-motion=armed]/hero:opacity-0 motion-safe:group-data-[hero-motion=play]/hero:animate-hero-enter-fade"
128
+ ],
129
+ sub: ["flex w-full flex-col md:flex-row"]
130
+ },
131
+ variants: {
132
+ actionsWidth: {
133
+ narrow: { actions: "max-w-content-narrow" },
134
+ medium: { actions: "max-w-content-medium" }
135
+ },
136
+ surface: {
137
+ brand: {
138
+ panel: "text-text-primary",
139
+ kicker: "text-secondary-tint-foreground",
140
+ body: "text-secondary-tint-foreground"
141
+ },
142
+ utility: {
143
+ panel: "text-text-primary",
144
+ kicker: "text-secondary-tint-foreground",
145
+ body: "text-secondary-tint-foreground"
146
+ },
147
+ solid: { panel: "text-secondary-foreground" },
148
+ inverse: { panel: "text-text-inverted" }
149
+ },
150
+ visual: {
151
+ on: {
152
+ panel: "lg:flex-row",
153
+ textColumn: [
154
+ "items-center text-center lg:items-start lg:text-left",
155
+ "lg:grow-0 lg:shrink",
156
+ "lg:basis-[480px]",
157
+ "xl:basis-[639px]",
158
+ "xl:pl-1200 xl:pr-800"
159
+ ],
160
+ copy: "mx-auto lg:mx-0",
161
+ actions: "justify-center lg:justify-start",
162
+ formatIcon: [
163
+ "self-center lg:absolute lg:self-auto",
164
+ "lg:top-1000 xl:top-1200",
165
+ "lg:-left-700",
166
+ "xl:-left-[19px]"
167
+ ],
168
+ image: [
169
+ "lg:min-w-0 lg:grow lg:shrink",
170
+ "lg:basis-[400px]",
171
+ "xl:basis-[551px]"
172
+ ]
173
+ },
174
+ off: {
175
+ panel: ["items-center text-center", "pb-1200 lg:pb-0"],
176
+ textColumn: "w-full items-center",
177
+ copy: "mx-auto",
178
+ actions: "mx-auto justify-center",
179
+ formatIcon: "self-center"
180
+ }
181
+ }
182
+ },
183
+ defaultVariants: {
184
+ surface: "brand",
185
+ actionsWidth: "narrow"
186
+ }
187
+ });
188
+ /**
189
+ * The entrance order, one `--hero-step` per piece that is actually rendered — an absent
190
+ * kicker or body does not leave a gap in the sequence. Literal classes, so Tailwind sees
191
+ * them; five pieces at most (kicker, heading, body, actions, image).
192
+ */
193
+ const ENTER_STEP = [
194
+ "[--hero-step:0]",
195
+ "[--hero-step:1]",
196
+ "[--hero-step:2]",
197
+ "[--hero-step:3]",
198
+ "[--hero-step:4]"
199
+ ];
200
+ const HERO_ENTER_ORDER = [
201
+ "kicker",
202
+ "heading",
203
+ "body",
204
+ "actions",
205
+ "image"
206
+ ];
207
+ /** The step class of every rendered piece, numbered in `HERO_ENTER_ORDER` over the present ones. */
208
+ const heroEnterSteps = (present) => {
209
+ const steps = {};
210
+ HERO_ENTER_ORDER.filter((part) => present[part]).forEach((part, index) => {
211
+ steps[part] = ENTER_STEP[Math.min(index, ENTER_STEP.length - 1)];
212
+ });
213
+ return steps;
214
+ };
215
+ const Hero = React.forwardRef((props, ref) => {
216
+ const { heading, kicker, body, bodyHtml, actions, actionsWidth = "narrow", formatIcon, sub, surface = "brand", visual, image, className, ...rest } = props;
217
+ const slots = heroVariants({
218
+ surface,
219
+ visual,
220
+ actionsWidth
221
+ });
222
+ const rootRef = React.useRef(null);
223
+ const setRootRef = React.useCallback((node) => {
224
+ rootRef.current = node;
225
+ if (typeof ref === "function") ref(node);
226
+ else if (ref) ref.current = node;
227
+ }, [ref]);
228
+ const enter = useEnterOnView(rootRef);
229
+ const step = heroEnterSteps({
230
+ kicker: kicker != null,
231
+ heading: true,
232
+ body: bodyHtml != null || body != null,
233
+ actions: actions != null,
234
+ image: visual === "on"
235
+ });
236
+ return /* @__PURE__ */ jsxs("section", {
237
+ ref: setRootRef,
238
+ "data-fods-component": "hero",
239
+ "data-fods-part": "root",
240
+ className: cn(slots.root(), className),
241
+ ...rest,
242
+ "data-hero-motion": enter === "static" ? void 0 : enter,
243
+ children: [/* @__PURE__ */ jsxs("div", {
244
+ "data-fods-part": "panel",
245
+ className: slots.panel(),
246
+ children: [
247
+ visual === "off" ? /* @__PURE__ */ jsx(PromoSurface, {
248
+ layout: "vertical",
249
+ surface,
250
+ className: "absolute inset-0"
251
+ }) : /* @__PURE__ */ jsxs(Fragment, { children: [/* @__PURE__ */ jsx(PromoSurface, {
252
+ layout: "top",
253
+ surface,
254
+ className: "absolute inset-0 lg:hidden"
255
+ }), /* @__PURE__ */ jsx(PromoSurface, {
256
+ layout: "side",
257
+ surface,
258
+ className: "absolute inset-0 hidden lg:block"
259
+ })] }),
260
+ /* @__PURE__ */ jsxs("div", {
261
+ "data-fods-part": "text-column",
262
+ className: slots.textColumn(),
263
+ children: [
264
+ formatIcon != null && /* @__PURE__ */ jsx("span", {
265
+ "aria-hidden": "true",
266
+ "data-fods-part": "format-icon",
267
+ className: slots.formatIcon(),
268
+ children: formatIcon
269
+ }),
270
+ /* @__PURE__ */ jsxs("div", {
271
+ "data-fods-part": "copy",
272
+ className: slots.copy(),
273
+ children: [/* @__PURE__ */ jsxs("div", {
274
+ "data-fods-part": "title-group",
275
+ className: slots.titleGroup(),
276
+ children: [kicker != null && /* @__PURE__ */ jsx("p", {
277
+ "data-fods-part": "kicker",
278
+ className: cn(slots.kicker(), step.kicker),
279
+ children: kicker
280
+ }), /* @__PURE__ */ jsx("h1", {
281
+ "data-fods-part": "heading",
282
+ className: cn(slots.heading(), step.heading),
283
+ children: heading
284
+ })]
285
+ }), bodyHtml != null ? /* @__PURE__ */ jsx("div", {
286
+ "data-fods-part": "body",
287
+ className: cn(slots.body(), step.body),
288
+ dangerouslySetInnerHTML: { __html: bodyHtml }
289
+ }) : body != null ? /* @__PURE__ */ jsx("p", {
290
+ "data-fods-part": "body",
291
+ className: cn(slots.body(), step.body),
292
+ children: body
293
+ }) : null]
294
+ }),
295
+ actions != null && /* @__PURE__ */ jsx("div", {
296
+ "data-fods-part": "actions",
297
+ className: cn(slots.actions(), step.actions),
298
+ children: actions
299
+ })
300
+ ]
301
+ }),
302
+ visual === "on" && /* @__PURE__ */ jsx("div", {
303
+ "data-fods-part": "image",
304
+ className: cn(slots.image(), step.image),
305
+ children: image
306
+ })
307
+ ]
308
+ }), sub != null && /* @__PURE__ */ jsx("div", {
309
+ "data-fods-part": "sub",
310
+ className: slots.sub(),
311
+ children: sub
312
+ })]
313
+ });
314
+ });
315
+ Hero.displayName = "Hero";
316
+ export { Hero, heroVariants };
@@ -0,0 +1,2 @@
1
+ import { Hero, HeroActionsWidth, HeroProps, HeroSurface, heroVariants } from "./Hero.js";
2
+ export { Hero, type HeroActionsWidth, type HeroProps, type HeroSurface, heroVariants };
@@ -0,0 +1 @@
1
+ export { Hero, heroVariants } from "./Hero.js";
@@ -0,0 +1,27 @@
1
+ import { IconName } from "../../icons/icon-types.generated.js";
2
+ import { FunctionComponent, HTMLAttributes } from "react";
3
+ /**
4
+ * A step of the `--size-icon*` scale (spec/02-tokens: size tokens). `default` is the
5
+ * bare `--size-icon`; the others are `--size-icon-<step>`. There is no px number: an
6
+ * icon is sized by a token or not at all.
7
+ */
8
+ export type IconSize = '2xsmall' | 'xsmall' | 'small' | 'default' | 'large' | 'display';
9
+ export type IconProps = {
10
+ /**
11
+ * The canonical FODS name a manifest uses (`check-circle`, `caret-right-small`).
12
+ * The legacy icon-font spellings (`tick`, `chevron-right-small`) are not accepted:
13
+ * they belong to the legacy icon font.
14
+ */
15
+ name: IconName;
16
+ className?: string;
17
+ /**
18
+ * A step of the `--size-icon*` scale, applied as the glyph's width and height
19
+ * (`size-icon-<step>`). Without it the glyph takes `--size-icon` (24). A component
20
+ * passes its manifest `sizes[].icon` here.
21
+ */
22
+ size?: IconSize;
23
+ } & Pick<HTMLAttributes<HTMLElement>, 'aria-hidden'> & {
24
+ [dataAttribute: `data-${string}`]: string | undefined;
25
+ };
26
+ declare const Icon: FunctionComponent<IconProps>;
27
+ export { Icon, type IconName };
@@ -0,0 +1,30 @@
1
+ "use client";
2
+ import { SVG_ICONS } from "../../icons/icon-registry.generated.js";
3
+ import { cn } from "../../internal/utils.js";
4
+ import { jsx } from "react/jsx-runtime";
5
+ // src/components/icon/Icon.tsx
6
+ const SIZE_CLASS = {
7
+ "2xsmall": "size-icon-2xsmall",
8
+ xsmall: "size-icon-xsmall",
9
+ small: "size-icon-small",
10
+ default: "size-icon",
11
+ large: "size-icon-large",
12
+ display: "size-icon-display"
13
+ };
14
+ const drawings = SVG_ICONS;
15
+ const Icon = ({ name, className, size = "default", ...rest }) => {
16
+ const svg = drawings[name];
17
+ if (!svg) return null;
18
+ return /* @__PURE__ */ jsx("svg", {
19
+ viewBox: svg.viewBox,
20
+ fill: "currentColor",
21
+ className: cn("icon", `icon-${name}`, SIZE_CLASS[size], className),
22
+ "aria-hidden": "true",
23
+ ...rest,
24
+ children: /* @__PURE__ */ jsx("path", {
25
+ d: svg.d,
26
+ transform: svg.transform
27
+ })
28
+ });
29
+ };
30
+ export { Icon };
@@ -0,0 +1,3 @@
1
+ import { Icon, IconProps, IconSize } from "./Icon.js";
2
+ import { AVAILABLE_ICONS, IconName } from "../../icons/icon-types.generated.js";
3
+ export { AVAILABLE_ICONS, Icon, type IconName, type IconProps, type IconSize };
@@ -0,0 +1,3 @@
1
+ import { Icon } from "./Icon.js";
2
+ import { AVAILABLE_ICONS } from "../../icons/icon-types.generated.js";
3
+ export { AVAILABLE_ICONS, Icon };