@invoiceonline/ui-react 0.0.0 → 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (738) hide show
  1. package/AGENTS.md +99 -0
  2. package/CHANGELOG.md +131 -0
  3. package/LICENSE +9 -0
  4. package/README.md +77 -1
  5. package/dist/assets/label-brush-1.svg +6 -0
  6. package/dist/assets/pattern-dark.svg +113 -0
  7. package/dist/components/action-row/ActionRow.d.ts +178 -0
  8. package/dist/components/action-row/ActionRow.js +340 -0
  9. package/dist/components/action-row/index.d.ts +2 -0
  10. package/dist/components/action-row/index.js +1 -0
  11. package/dist/components/alert/Alert.d.ts +314 -0
  12. package/dist/components/alert/Alert.js +446 -0
  13. package/dist/components/alert/index.d.ts +2 -0
  14. package/dist/components/alert/index.js +1 -0
  15. package/dist/components/anchored-panel/AnchoredPanel.d.ts +41 -0
  16. package/dist/components/anchored-panel/AnchoredPanel.js +72 -0
  17. package/dist/components/anchored-panel/index.d.ts +3 -0
  18. package/dist/components/anchored-panel/index.js +3 -0
  19. package/dist/components/badge/Badge.d.ts +146 -0
  20. package/dist/components/badge/Badge.js +258 -0
  21. package/dist/components/badge/index.d.ts +2 -0
  22. package/dist/components/badge/index.js +1 -0
  23. package/dist/components/banner/Banner.d.ts +209 -0
  24. package/dist/components/banner/Banner.js +339 -0
  25. package/dist/components/banner/index.d.ts +2 -0
  26. package/dist/components/banner/index.js +1 -0
  27. package/dist/components/button/Button.d.ts +54 -0
  28. package/dist/components/button/Button.js +312 -0
  29. package/dist/components/button/index.d.ts +2 -0
  30. package/dist/components/button/index.js +1 -0
  31. package/dist/components/button-group/ButtonGroup.d.ts +187 -0
  32. package/dist/components/button-group/ButtonGroup.js +217 -0
  33. package/dist/components/button-group/index.d.ts +2 -0
  34. package/dist/components/button-group/index.js +1 -0
  35. package/dist/components/card-select/CardSelect.d.ts +274 -0
  36. package/dist/components/card-select/CardSelect.js +561 -0
  37. package/dist/components/card-select/CardSelectGroup.d.ts +92 -0
  38. package/dist/components/card-select/CardSelectGroup.js +72 -0
  39. package/dist/components/card-select/index.d.ts +3 -0
  40. package/dist/components/card-select/index.js +3 -0
  41. package/dist/components/checkbox/Checkbox.d.ts +104 -0
  42. package/dist/components/checkbox/Checkbox.js +194 -0
  43. package/dist/components/checkbox/index.d.ts +2 -0
  44. package/dist/components/checkbox/index.js +1 -0
  45. package/dist/components/chip/Chip.d.ts +250 -0
  46. package/dist/components/chip/Chip.js +441 -0
  47. package/dist/components/chip/index.d.ts +2 -0
  48. package/dist/components/chip/index.js +1 -0
  49. package/dist/components/column-header/ColumnHeader.d.ts +144 -0
  50. package/dist/components/column-header/ColumnHeader.js +209 -0
  51. package/dist/components/column-header/index.d.ts +2 -0
  52. package/dist/components/column-header/index.js +1 -0
  53. package/dist/components/combobox-field/Combobox.d.ts +104 -0
  54. package/dist/components/combobox-field/Combobox.js +355 -0
  55. package/dist/components/combobox-field/ComboboxField.d.ts +76 -0
  56. package/dist/components/combobox-field/ComboboxField.js +98 -0
  57. package/dist/components/combobox-field/index.d.ts +3 -0
  58. package/dist/components/combobox-field/index.js +3 -0
  59. package/dist/components/date-field/DateField.d.ts +52 -0
  60. package/dist/components/date-field/DateField.js +45 -0
  61. package/dist/components/date-field/index.d.ts +2 -0
  62. package/dist/components/date-field/index.js +1 -0
  63. package/dist/components/date-picker/DatePicker.d.ts +53 -0
  64. package/dist/components/date-picker/DatePicker.js +329 -0
  65. package/dist/components/date-picker/index.d.ts +2 -0
  66. package/dist/components/date-picker/index.js +1 -0
  67. package/dist/components/divider/Divider.d.ts +81 -0
  68. package/dist/components/divider/Divider.js +93 -0
  69. package/dist/components/divider/index.d.ts +2 -0
  70. package/dist/components/divider/index.js +1 -0
  71. package/dist/components/drawer/Drawer.d.ts +128 -0
  72. package/dist/components/drawer/Drawer.js +367 -0
  73. package/dist/components/drawer/index.d.ts +2 -0
  74. package/dist/components/drawer/index.js +1 -0
  75. package/dist/components/dropdown-button/DropdownButton.d.ts +72 -0
  76. package/dist/components/dropdown-button/DropdownButton.js +122 -0
  77. package/dist/components/dropdown-button/index.d.ts +2 -0
  78. package/dist/components/dropdown-button/index.js +1 -0
  79. package/dist/components/faq/FAQ.d.ts +135 -0
  80. package/dist/components/faq/FAQ.js +258 -0
  81. package/dist/components/faq/index.d.ts +2 -0
  82. package/dist/components/faq/index.js +1 -0
  83. package/dist/components/field/Field.d.ts +118 -0
  84. package/dist/components/field/Field.js +327 -0
  85. package/dist/components/field/index.d.ts +2 -0
  86. package/dist/components/field/index.js +1 -0
  87. package/dist/components/field-pair/FieldPair.d.ts +194 -0
  88. package/dist/components/field-pair/FieldPair.js +321 -0
  89. package/dist/components/field-pair/index.d.ts +2 -0
  90. package/dist/components/field-pair/index.js +1 -0
  91. package/dist/components/file-upload/FileUpload.d.ts +137 -0
  92. package/dist/components/file-upload/FileUpload.js +434 -0
  93. package/dist/components/file-upload/index.d.ts +2 -0
  94. package/dist/components/file-upload/index.js +1 -0
  95. package/dist/components/filter-chip/FilterChip.d.ts +373 -0
  96. package/dist/components/filter-chip/FilterChip.js +517 -0
  97. package/dist/components/filter-chip/index.d.ts +2 -0
  98. package/dist/components/filter-chip/index.js +1 -0
  99. package/dist/components/filter-facet/FilterFacet.d.ts +116 -0
  100. package/dist/components/filter-facet/FilterFacet.js +632 -0
  101. package/dist/components/filter-facet/index.d.ts +2 -0
  102. package/dist/components/filter-facet/index.js +1 -0
  103. package/dist/components/firm-avatar/FirmAvatar.d.ts +75 -0
  104. package/dist/components/firm-avatar/FirmAvatar.js +119 -0
  105. package/dist/components/firm-avatar/index.d.ts +2 -0
  106. package/dist/components/firm-avatar/index.js +1 -0
  107. package/dist/components/form-actions/FormActions.d.ts +123 -0
  108. package/dist/components/form-actions/FormActions.js +195 -0
  109. package/dist/components/form-actions/index.d.ts +2 -0
  110. package/dist/components/form-actions/index.js +1 -0
  111. package/dist/components/form-block/FormBlock.d.ts +252 -0
  112. package/dist/components/form-block/FormBlock.js +420 -0
  113. package/dist/components/form-block/index.d.ts +3 -0
  114. package/dist/components/form-block/index.js +3 -0
  115. package/dist/components/form-section/FormSection.d.ts +130 -0
  116. package/dist/components/form-section/FormSection.js +206 -0
  117. package/dist/components/form-section/index.d.ts +2 -0
  118. package/dist/components/form-section/index.js +1 -0
  119. package/dist/components/heading/Heading.d.ts +69 -0
  120. package/dist/components/heading/Heading.js +79 -0
  121. package/dist/components/heading/index.d.ts +2 -0
  122. package/dist/components/heading/index.js +1 -0
  123. package/dist/components/heading-group/HeadingGroup.d.ts +258 -0
  124. package/dist/components/heading-group/HeadingGroup.js +255 -0
  125. package/dist/components/heading-group/index.d.ts +2 -0
  126. package/dist/components/heading-group/index.js +1 -0
  127. package/dist/components/hero/Hero.d.ts +268 -0
  128. package/dist/components/hero/Hero.js +316 -0
  129. package/dist/components/hero/index.d.ts +2 -0
  130. package/dist/components/hero/index.js +1 -0
  131. package/dist/components/icon/Icon.d.ts +27 -0
  132. package/dist/components/icon/Icon.js +30 -0
  133. package/dist/components/icon/index.d.ts +3 -0
  134. package/dist/components/icon/index.js +3 -0
  135. package/dist/components/icon-button/IconButton.d.ts +75 -0
  136. package/dist/components/icon-button/IconButton.js +151 -0
  137. package/dist/components/icon-button/index.d.ts +2 -0
  138. package/dist/components/icon-button/index.js +1 -0
  139. package/dist/components/item-row/ItemRow.d.ts +253 -0
  140. package/dist/components/item-row/ItemRow.js +496 -0
  141. package/dist/components/item-row/index.d.ts +2 -0
  142. package/dist/components/item-row/index.js +1 -0
  143. package/dist/components/list-row/ListRow.d.ts +165 -0
  144. package/dist/components/list-row/ListRow.js +233 -0
  145. package/dist/components/list-row/index.d.ts +2 -0
  146. package/dist/components/list-row/index.js +1 -0
  147. package/dist/components/menu/Menu.d.ts +64 -0
  148. package/dist/components/menu/Menu.js +186 -0
  149. package/dist/components/menu/index.d.ts +2 -0
  150. package/dist/components/menu/index.js +1 -0
  151. package/dist/components/modal/Modal.d.ts +272 -0
  152. package/dist/components/modal/Modal.js +788 -0
  153. package/dist/components/modal/index.d.ts +2 -0
  154. package/dist/components/modal/index.js +1 -0
  155. package/dist/components/nav-link/NavLink.d.ts +123 -0
  156. package/dist/components/nav-link/NavLink.js +157 -0
  157. package/dist/components/nav-link/index.d.ts +2 -0
  158. package/dist/components/nav-link/index.js +1 -0
  159. package/dist/components/number-field/NumberField.d.ts +62 -0
  160. package/dist/components/number-field/NumberField.js +210 -0
  161. package/dist/components/number-field/index.d.ts +2 -0
  162. package/dist/components/number-field/index.js +1 -0
  163. package/dist/components/pagination/Pagination.d.ts +133 -0
  164. package/dist/components/pagination/Pagination.js +217 -0
  165. package/dist/components/pagination/index.d.ts +3 -0
  166. package/dist/components/pagination/index.js +3 -0
  167. package/dist/components/popover-surface/index.d.ts +2 -0
  168. package/dist/components/popover-surface/index.js +1 -0
  169. package/dist/components/progress-bar/ProgressBar.d.ts +260 -0
  170. package/dist/components/progress-bar/ProgressBar.js +470 -0
  171. package/dist/components/progress-bar/index.d.ts +2 -0
  172. package/dist/components/progress-bar/index.js +1 -0
  173. package/dist/components/promo-sticker/PromoSticker.d.ts +204 -0
  174. package/dist/components/promo-sticker/PromoSticker.js +177 -0
  175. package/dist/components/promo-sticker/index.d.ts +2 -0
  176. package/dist/components/promo-sticker/index.js +1 -0
  177. package/dist/components/promo-surface/PromoSurface.d.ts +94 -0
  178. package/dist/components/promo-surface/PromoSurface.js +119 -0
  179. package/dist/components/promo-surface/index.d.ts +2 -0
  180. package/dist/components/promo-surface/index.js +1 -0
  181. package/dist/components/radio/Radio.d.ts +92 -0
  182. package/dist/components/radio/Radio.js +171 -0
  183. package/dist/components/radio/index.d.ts +2 -0
  184. package/dist/components/radio/index.js +1 -0
  185. package/dist/components/radio-group/RadioGroup.d.ts +61 -0
  186. package/dist/components/radio-group/RadioGroup.js +51 -0
  187. package/dist/components/radio-group/index.d.ts +2 -0
  188. package/dist/components/radio-group/index.js +1 -0
  189. package/dist/components/select/Select.d.ts +65 -0
  190. package/dist/components/select/Select.js +176 -0
  191. package/dist/components/select/index.d.ts +2 -0
  192. package/dist/components/select/index.js +1 -0
  193. package/dist/components/select-field/SelectField.d.ts +16 -0
  194. package/dist/components/select-field/SelectField.js +55 -0
  195. package/dist/components/select-field/index.d.ts +2 -0
  196. package/dist/components/select-field/index.js +1 -0
  197. package/dist/components/skeleton/Skeleton.d.ts +64 -0
  198. package/dist/components/skeleton/Skeleton.js +65 -0
  199. package/dist/components/skeleton/index.d.ts +2 -0
  200. package/dist/components/skeleton/index.js +1 -0
  201. package/dist/components/split-button/SplitButton.d.ts +80 -0
  202. package/dist/components/split-button/SplitButton.js +182 -0
  203. package/dist/components/split-button/index.d.ts +2 -0
  204. package/dist/components/split-button/index.js +1 -0
  205. package/dist/components/status-summary-bar/StatusSummaryBar.d.ts +118 -0
  206. package/dist/components/status-summary-bar/StatusSummaryBar.js +278 -0
  207. package/dist/components/status-summary-bar/index.d.ts +2 -0
  208. package/dist/components/status-summary-bar/index.js +1 -0
  209. package/dist/components/subject-lookup-field/SubjectLookupField.d.ts +157 -0
  210. package/dist/components/subject-lookup-field/SubjectLookupField.js +663 -0
  211. package/dist/components/subject-lookup-field/index.d.ts +2 -0
  212. package/dist/components/subject-lookup-field/index.js +1 -0
  213. package/dist/components/switch/Switch.d.ts +152 -0
  214. package/dist/components/switch/Switch.js +307 -0
  215. package/dist/components/switch/index.d.ts +2 -0
  216. package/dist/components/switch/index.js +1 -0
  217. package/dist/components/table/Table.d.ts +5 -0
  218. package/dist/components/table/Table.js +601 -0
  219. package/dist/components/table/index.d.ts +6 -0
  220. package/dist/components/table/index.js +6 -0
  221. package/dist/components/text-field/TextField.d.ts +65 -0
  222. package/dist/components/text-field/TextField.js +173 -0
  223. package/dist/components/text-field/index.d.ts +2 -0
  224. package/dist/components/text-field/index.js +1 -0
  225. package/dist/components/text-link/TextLink.d.ts +260 -0
  226. package/dist/components/text-link/TextLink.js +303 -0
  227. package/dist/components/text-link/index.d.ts +2 -0
  228. package/dist/components/text-link/index.js +1 -0
  229. package/dist/components/textarea/Textarea.d.ts +93 -0
  230. package/dist/components/textarea/Textarea.js +256 -0
  231. package/dist/components/textarea/index.d.ts +2 -0
  232. package/dist/components/textarea/index.js +1 -0
  233. package/dist/components/tooltip/Tooltip.d.ts +129 -0
  234. package/dist/components/tooltip/Tooltip.js +457 -0
  235. package/dist/components/tooltip/index.d.ts +2 -0
  236. package/dist/components/tooltip/index.js +1 -0
  237. package/dist/components/unit-field/UnitField.d.ts +46 -0
  238. package/dist/components/unit-field/UnitField.js +133 -0
  239. package/dist/components/unit-field/index.d.ts +2 -0
  240. package/dist/components/unit-field/index.js +1 -0
  241. package/dist/icons/icon-registry.generated.js +500 -0
  242. package/dist/icons/icon-types.generated.d.ts +2 -0
  243. package/dist/icons/icon-types.generated.js +126 -0
  244. package/dist/index.d.ts +132 -0
  245. package/dist/index.js +75 -0
  246. package/dist/internal/BottomSheet.js +496 -0
  247. package/dist/internal/FodsProvider.d.ts +25 -0
  248. package/dist/internal/FodsProvider.js +32 -0
  249. package/dist/internal/MotionCaret.js +35 -0
  250. package/dist/internal/NumberFormatInput.d.ts +21 -0
  251. package/dist/internal/NumberFormatInput.js +126 -0
  252. package/dist/internal/SummaryDonut.d.ts +3 -0
  253. package/dist/internal/SummaryDonut.js +300 -0
  254. package/dist/internal/buttonSegment.d.ts +44 -0
  255. package/dist/internal/buttonSegment.js +126 -0
  256. package/dist/internal/collapseRoom.js +128 -0
  257. package/dist/internal/comboboxKeys.js +44 -0
  258. package/dist/internal/contentPresence.js +46 -0
  259. package/dist/internal/dayCell.js +95 -0
  260. package/dist/internal/dialogPortal.d.ts +2 -0
  261. package/dist/internal/dialogPortal.js +21 -0
  262. package/dist/internal/donutSweeps.js +65 -0
  263. package/dist/internal/enterOnViewGeometry.js +46 -0
  264. package/dist/internal/faqItem.js +80 -0
  265. package/dist/internal/floatingLabelMotion.js +68 -0
  266. package/dist/internal/formBlockContext.d.ts +22 -0
  267. package/dist/internal/formBlockContext.js +20 -0
  268. package/dist/internal/heightRoom.js +87 -0
  269. package/dist/internal/numberSeparators.js +62 -0
  270. package/dist/internal/overlayMotion.js +48 -0
  271. package/dist/internal/paginationItem.d.ts +8 -0
  272. package/dist/internal/paginationItem.js +22 -0
  273. package/dist/internal/popoverSurface.d.ts +8 -0
  274. package/dist/internal/popoverSurface.js +23 -0
  275. package/dist/internal/portalContainer.d.ts +1 -0
  276. package/dist/internal/portalContainer.js +6 -0
  277. package/dist/internal/progressBarItem.d.ts +207 -0
  278. package/dist/internal/progressBarItem.js +264 -0
  279. package/dist/internal/selectionControlText.js +12 -0
  280. package/dist/internal/statusSummaryParts.js +371 -0
  281. package/dist/internal/summaryMotion.js +75 -0
  282. package/dist/internal/table/ChildConnector.js +62 -0
  283. package/dist/internal/table/ChildRowPrefix.d.ts +9 -0
  284. package/dist/internal/table/ChildRowPrefix.js +27 -0
  285. package/dist/internal/table/ColumnSettings.js +135 -0
  286. package/dist/internal/table/ScrollRegion.js +114 -0
  287. package/dist/internal/table/TableEmpty.js +93 -0
  288. package/dist/internal/table/TableLayout.d.ts +17 -0
  289. package/dist/internal/table/TableLayout.js +29 -0
  290. package/dist/internal/table/TableLoadStatus.js +56 -0
  291. package/dist/internal/table/TableMobile.js +488 -0
  292. package/dist/internal/table/TruncatedCell.js +33 -0
  293. package/dist/internal/table/emptyValue.js +10 -0
  294. package/dist/internal/table/features.d.ts +41 -0
  295. package/dist/internal/table/features.js +31 -0
  296. package/dist/internal/table/recipes.js +227 -0
  297. package/dist/internal/table/rowClick.js +9 -0
  298. package/dist/internal/table/types.d.ts +325 -0
  299. package/dist/internal/table/types.js +13 -0
  300. package/dist/internal/tailwind-variants.d.ts +3 -0
  301. package/dist/internal/tailwind-variants.js +37 -0
  302. package/dist/internal/tooltipContext.js +5 -0
  303. package/dist/internal/tw-merge-config.generated.js +314 -0
  304. package/dist/internal/useAnchoredPanel.d.ts +87 -0
  305. package/dist/internal/useAnchoredPanel.js +108 -0
  306. package/dist/internal/useCountUp.js +53 -0
  307. package/dist/internal/useDateFieldTrigger.js +183 -0
  308. package/dist/internal/useEChart.js +59 -0
  309. package/dist/internal/useEnterOnView.js +42 -0
  310. package/dist/internal/useFloatingBar.js +100 -0
  311. package/dist/internal/useFormReset.js +37 -0
  312. package/dist/internal/useIsMobile.js +44 -0
  313. package/dist/internal/useOneRowOverflow.js +88 -0
  314. package/dist/internal/usePrefersReducedMotion.js +25 -0
  315. package/dist/internal/useReturnFocus.js +26 -0
  316. package/dist/internal/utils.d.ts +7 -0
  317. package/dist/internal/utils.js +58 -0
  318. package/dist/node_modules/@tanstack/store/dist/store.d.ts +29 -0
  319. package/dist/node_modules/@tanstack/store/dist/types.d.ts +38 -0
  320. package/dist/node_modules/@tanstack/table-core/dist/core/cells/coreCellsFeature.d.ts +6 -0
  321. package/dist/node_modules/@tanstack/table-core/dist/core/cells/coreCellsFeature.types.d.ts +53 -0
  322. package/dist/node_modules/@tanstack/table-core/dist/core/columns/coreColumnsFeature.d.ts +6 -0
  323. package/dist/node_modules/@tanstack/table-core/dist/core/columns/coreColumnsFeature.types.d.ts +90 -0
  324. package/dist/node_modules/@tanstack/table-core/dist/core/coreFeatures.d.ts +17 -0
  325. package/dist/node_modules/@tanstack/table-core/dist/core/headers/coreHeadersFeature.d.ts +6 -0
  326. package/dist/node_modules/@tanstack/table-core/dist/core/headers/coreHeadersFeature.types.d.ts +114 -0
  327. package/dist/node_modules/@tanstack/table-core/dist/core/reactivity/coreReactivityFeature.types.d.ts +51 -0
  328. package/dist/node_modules/@tanstack/table-core/dist/core/row-models/coreRowModelsFeature.d.ts +6 -0
  329. package/dist/node_modules/@tanstack/table-core/dist/core/row-models/coreRowModelsFeature.types.d.ts +29 -0
  330. package/dist/node_modules/@tanstack/table-core/dist/core/rows/coreRowsFeature.d.ts +6 -0
  331. package/dist/node_modules/@tanstack/table-core/dist/core/rows/coreRowsFeature.types.d.ts +129 -0
  332. package/dist/node_modules/@tanstack/table-core/dist/core/table/coreTablesFeature.d.ts +6 -0
  333. package/dist/node_modules/@tanstack/table-core/dist/core/table/coreTablesFeature.types.d.ts +203 -0
  334. package/dist/node_modules/@tanstack/table-core/dist/features/cell-selection/cellSelectionFeature.d.ts +6 -0
  335. package/dist/node_modules/@tanstack/table-core/dist/features/cell-selection/cellSelectionFeature.types.d.ts +294 -0
  336. package/dist/node_modules/@tanstack/table-core/dist/features/cell-spanning/cellSpanningFeature.d.ts +11 -0
  337. package/dist/node_modules/@tanstack/table-core/dist/features/cell-spanning/cellSpanningFeature.types.d.ts +148 -0
  338. package/dist/node_modules/@tanstack/table-core/dist/features/column-faceting/columnFacetingFeature.d.ts +12 -0
  339. package/dist/node_modules/@tanstack/table-core/dist/features/column-faceting/columnFacetingFeature.types.d.ts +63 -0
  340. package/dist/node_modules/@tanstack/table-core/dist/features/column-filtering/columnFilteringFeature.d.ts +6 -0
  341. package/dist/node_modules/@tanstack/table-core/dist/features/column-filtering/columnFilteringFeature.types.d.ts +209 -0
  342. package/dist/node_modules/@tanstack/table-core/dist/features/column-filtering/filterFns.d.ts +35 -0
  343. package/dist/node_modules/@tanstack/table-core/dist/features/column-grouping/columnGroupingFeature.d.ts +6 -0
  344. package/dist/node_modules/@tanstack/table-core/dist/features/column-grouping/columnGroupingFeature.types.d.ts +128 -0
  345. package/dist/node_modules/@tanstack/table-core/dist/features/column-ordering/columnOrderingFeature.d.ts +6 -0
  346. package/dist/node_modules/@tanstack/table-core/dist/features/column-ordering/columnOrderingFeature.types.d.ts +82 -0
  347. package/dist/node_modules/@tanstack/table-core/dist/features/column-pinning/columnPinningFeature.d.ts +11 -0
  348. package/dist/node_modules/@tanstack/table-core/dist/features/column-pinning/columnPinningFeature.types.d.ts +195 -0
  349. package/dist/node_modules/@tanstack/table-core/dist/features/column-resizing/columnResizingFeature.d.ts +6 -0
  350. package/dist/node_modules/@tanstack/table-core/dist/features/column-resizing/columnResizingFeature.types.d.ts +73 -0
  351. package/dist/node_modules/@tanstack/table-core/dist/features/column-sizing/columnSizingFeature.d.ts +6 -0
  352. package/dist/node_modules/@tanstack/table-core/dist/features/column-sizing/columnSizingFeature.types.d.ts +134 -0
  353. package/dist/node_modules/@tanstack/table-core/dist/features/column-visibility/columnVisibilityFeature.d.ts +6 -0
  354. package/dist/node_modules/@tanstack/table-core/dist/features/column-visibility/columnVisibilityFeature.types.d.ts +92 -0
  355. package/dist/node_modules/@tanstack/table-core/dist/features/global-filtering/globalFilteringFeature.d.ts +6 -0
  356. package/dist/node_modules/@tanstack/table-core/dist/features/global-filtering/globalFilteringFeature.types.d.ts +67 -0
  357. package/dist/node_modules/@tanstack/table-core/dist/features/row-aggregation/aggregationFns.d.ts +23 -0
  358. package/dist/node_modules/@tanstack/table-core/dist/features/row-aggregation/rowAggregationFeature.d.ts +6 -0
  359. package/dist/node_modules/@tanstack/table-core/dist/features/row-aggregation/rowAggregationFeature.types.d.ts +183 -0
  360. package/dist/node_modules/@tanstack/table-core/dist/features/row-aggregation/rowAggregationFeature.utils.d.ts +18 -0
  361. package/dist/node_modules/@tanstack/table-core/dist/features/row-expanding/rowExpandingFeature.d.ts +6 -0
  362. package/dist/node_modules/@tanstack/table-core/dist/features/row-expanding/rowExpandingFeature.types.d.ts +125 -0
  363. package/dist/node_modules/@tanstack/table-core/dist/features/row-pagination/rowPaginationFeature.d.ts +6 -0
  364. package/dist/node_modules/@tanstack/table-core/dist/features/row-pagination/rowPaginationFeature.types.d.ts +135 -0
  365. package/dist/node_modules/@tanstack/table-core/dist/features/row-pinning/rowPinningFeature.d.ts +6 -0
  366. package/dist/node_modules/@tanstack/table-core/dist/features/row-pinning/rowPinningFeature.types.d.ts +76 -0
  367. package/dist/node_modules/@tanstack/table-core/dist/features/row-selection/rowSelectionFeature.d.ts +6 -0
  368. package/dist/node_modules/@tanstack/table-core/dist/features/row-selection/rowSelectionFeature.types.d.ts +187 -0
  369. package/dist/node_modules/@tanstack/table-core/dist/features/row-sorting/rowSortingFeature.d.ts +6 -0
  370. package/dist/node_modules/@tanstack/table-core/dist/features/row-sorting/rowSortingFeature.types.d.ts +236 -0
  371. package/dist/node_modules/@tanstack/table-core/dist/features/row-sorting/sortFns.d.ts +23 -0
  372. package/dist/node_modules/@tanstack/table-core/dist/features/stockFeatures.d.ts +37 -0
  373. package/dist/node_modules/@tanstack/table-core/dist/helpers/columnHelper.d.ts +47 -0
  374. package/dist/node_modules/@tanstack/table-core/dist/types/Cell.d.ts +16 -0
  375. package/dist/node_modules/@tanstack/table-core/dist/types/Column.d.ts +30 -0
  376. package/dist/node_modules/@tanstack/table-core/dist/types/ColumnDef.d.ts +123 -0
  377. package/dist/node_modules/@tanstack/table-core/dist/types/Header.d.ts +12 -0
  378. package/dist/node_modules/@tanstack/table-core/dist/types/HeaderGroup.d.ts +6 -0
  379. package/dist/node_modules/@tanstack/table-core/dist/types/Row.d.ts +24 -0
  380. package/dist/node_modules/@tanstack/table-core/dist/types/RowModel.d.ts +19 -0
  381. package/dist/node_modules/@tanstack/table-core/dist/types/RowModelFns.d.ts +11 -0
  382. package/dist/node_modules/@tanstack/table-core/dist/types/Table.d.ts +53 -0
  383. package/dist/node_modules/@tanstack/table-core/dist/types/TableFeatures.d.ts +416 -0
  384. package/dist/node_modules/@tanstack/table-core/dist/types/TableOptions.d.ts +78 -0
  385. package/dist/node_modules/@tanstack/table-core/dist/types/TableState.d.ts +46 -0
  386. package/dist/node_modules/@tanstack/table-core/dist/types/type-utils.d.ts +25 -0
  387. package/dist/shared.css +179 -0
  388. package/dist/styles.css +5467 -0
  389. package/dist/theme.css +314 -0
  390. package/dist/theme.map.json +278 -0
  391. package/dist/tokens/index.d.ts +2 -0
  392. package/dist/tokens/index.js +1 -0
  393. package/dist/tokens/tokens.generated.d.ts +2040 -0
  394. package/dist/tokens/tokens.generated.js +2053 -0
  395. package/dist/tokens.css +484 -0
  396. package/dist/tokens.flat.json +429 -0
  397. package/docs/Consuming.mdx +379 -0
  398. package/docs/Contributing.mdx +78 -0
  399. package/docs/ForAgents.mdx +53 -0
  400. package/docs/Introduction.mdx +54 -0
  401. package/llms.txt +556 -0
  402. package/package.json +351 -3
  403. package/src/components/action-row/ActionRow.mdx +686 -0
  404. package/src/components/action-row/ActionRow.stories.tsx +669 -0
  405. package/src/components/action-row/ActionRow.tsx +632 -0
  406. package/src/components/action-row/index.ts +9 -0
  407. package/src/components/alert/Alert.mdx +377 -0
  408. package/src/components/alert/Alert.stories.tsx +674 -0
  409. package/src/components/alert/Alert.tsx +579 -0
  410. package/src/components/alert/index.ts +13 -0
  411. package/src/components/anchored-panel/AnchoredPanel.mdx +381 -0
  412. package/src/components/anchored-panel/AnchoredPanel.stories.tsx +593 -0
  413. package/src/components/anchored-panel/AnchoredPanel.tsx +176 -0
  414. package/src/components/anchored-panel/index.ts +15 -0
  415. package/src/components/badge/Badge.mdx +487 -0
  416. package/src/components/badge/Badge.stories.tsx +375 -0
  417. package/src/components/badge/Badge.tsx +360 -0
  418. package/src/components/badge/index.ts +10 -0
  419. package/src/components/banner/Banner.mdx +704 -0
  420. package/src/components/banner/Banner.stories.tsx +448 -0
  421. package/src/components/banner/Banner.tsx +602 -0
  422. package/src/components/banner/index.ts +14 -0
  423. package/src/components/button/Button.mdx +286 -0
  424. package/src/components/button/Button.stories.tsx +381 -0
  425. package/src/components/button/Button.tsx +384 -0
  426. package/src/components/button/index.ts +1 -0
  427. package/src/components/button-group/ButtonGroup.mdx +512 -0
  428. package/src/components/button-group/ButtonGroup.stories.tsx +714 -0
  429. package/src/components/button-group/ButtonGroup.tsx +491 -0
  430. package/src/components/button-group/index.ts +10 -0
  431. package/src/components/card-select/CardSelect.mdx +662 -0
  432. package/src/components/card-select/CardSelect.stories.tsx +784 -0
  433. package/src/components/card-select/CardSelect.tsx +783 -0
  434. package/src/components/card-select/CardSelectGroup.tsx +169 -0
  435. package/src/components/card-select/index.ts +18 -0
  436. package/src/components/checkbox/Checkbox.mdx +269 -0
  437. package/src/components/checkbox/Checkbox.stories.tsx +306 -0
  438. package/src/components/checkbox/Checkbox.tsx +343 -0
  439. package/src/components/checkbox/index.ts +1 -0
  440. package/src/components/chip/Chip.mdx +683 -0
  441. package/src/components/chip/Chip.stories.tsx +734 -0
  442. package/src/components/chip/Chip.tsx +732 -0
  443. package/src/components/chip/index.ts +9 -0
  444. package/src/components/column-header/ColumnHeader.mdx +301 -0
  445. package/src/components/column-header/ColumnHeader.stories.tsx +319 -0
  446. package/src/components/column-header/ColumnHeader.tsx +287 -0
  447. package/src/components/column-header/index.ts +7 -0
  448. package/src/components/combobox-field/Combobox.tsx +693 -0
  449. package/src/components/combobox-field/ComboboxField.mdx +525 -0
  450. package/src/components/combobox-field/ComboboxField.stories.tsx +502 -0
  451. package/src/components/combobox-field/ComboboxField.tsx +259 -0
  452. package/src/components/combobox-field/index.ts +12 -0
  453. package/src/components/date-field/DateField.mdx +340 -0
  454. package/src/components/date-field/DateField.stories.tsx +221 -0
  455. package/src/components/date-field/DateField.tsx +176 -0
  456. package/src/components/date-field/index.ts +1 -0
  457. package/src/components/date-picker/DatePicker.mdx +436 -0
  458. package/src/components/date-picker/DatePicker.stories.tsx +458 -0
  459. package/src/components/date-picker/DatePicker.tsx +688 -0
  460. package/src/components/date-picker/index.ts +9 -0
  461. package/src/components/divider/Divider.mdx +256 -0
  462. package/src/components/divider/Divider.stories.tsx +177 -0
  463. package/src/components/divider/Divider.tsx +193 -0
  464. package/src/components/divider/index.ts +1 -0
  465. package/src/components/drawer/Drawer.mdx +518 -0
  466. package/src/components/drawer/Drawer.stories.tsx +392 -0
  467. package/src/components/drawer/Drawer.tsx +683 -0
  468. package/src/components/drawer/index.ts +1 -0
  469. package/src/components/dropdown-button/DropdownButton.mdx +285 -0
  470. package/src/components/dropdown-button/DropdownButton.stories.tsx +398 -0
  471. package/src/components/dropdown-button/DropdownButton.tsx +198 -0
  472. package/src/components/dropdown-button/index.ts +7 -0
  473. package/src/components/faq/FAQ.mdx +364 -0
  474. package/src/components/faq/FAQ.stories.tsx +343 -0
  475. package/src/components/faq/FAQ.tsx +337 -0
  476. package/src/components/faq/index.ts +1 -0
  477. package/src/components/field/Field.mdx +129 -0
  478. package/src/components/field/Field.stories.tsx +461 -0
  479. package/src/components/field/Field.tsx +765 -0
  480. package/src/components/field/index.ts +20 -0
  481. package/src/components/field-pair/FieldPair.mdx +308 -0
  482. package/src/components/field-pair/FieldPair.stories.tsx +530 -0
  483. package/src/components/field-pair/FieldPair.tsx +796 -0
  484. package/src/components/field-pair/index.ts +9 -0
  485. package/src/components/file-upload/FileUpload.mdx +345 -0
  486. package/src/components/file-upload/FileUpload.stories.tsx +698 -0
  487. package/src/components/file-upload/FileUpload.tsx +802 -0
  488. package/src/components/file-upload/index.ts +6 -0
  489. package/src/components/filter-chip/FilterChip.mdx +778 -0
  490. package/src/components/filter-chip/FilterChip.stories.tsx +827 -0
  491. package/src/components/filter-chip/FilterChip.tsx +881 -0
  492. package/src/components/filter-chip/index.ts +11 -0
  493. package/src/components/filter-facet/FilterFacet.mdx +536 -0
  494. package/src/components/filter-facet/FilterFacet.stories.tsx +506 -0
  495. package/src/components/filter-facet/FilterFacet.tsx +1160 -0
  496. package/src/components/filter-facet/index.ts +7 -0
  497. package/src/components/firm-avatar/FirmAvatar.mdx +280 -0
  498. package/src/components/firm-avatar/FirmAvatar.stories.tsx +147 -0
  499. package/src/components/firm-avatar/FirmAvatar.tsx +172 -0
  500. package/src/components/firm-avatar/index.ts +7 -0
  501. package/src/components/form-actions/FormActions.mdx +518 -0
  502. package/src/components/form-actions/FormActions.stories.tsx +621 -0
  503. package/src/components/form-actions/FormActions.tsx +273 -0
  504. package/src/components/form-actions/index.ts +6 -0
  505. package/src/components/form-block/FormBlock.mdx +728 -0
  506. package/src/components/form-block/FormBlock.stories.tsx +813 -0
  507. package/src/components/form-block/FormBlock.tsx +679 -0
  508. package/src/components/form-block/index.ts +13 -0
  509. package/src/components/form-section/FormSection.mdx +436 -0
  510. package/src/components/form-section/FormSection.stories.tsx +407 -0
  511. package/src/components/form-section/FormSection.tsx +290 -0
  512. package/src/components/form-section/index.ts +17 -0
  513. package/src/components/heading/Heading.mdx +206 -0
  514. package/src/components/heading/Heading.stories.tsx +169 -0
  515. package/src/components/heading/Heading.tsx +124 -0
  516. package/src/components/heading/index.ts +8 -0
  517. package/src/components/heading-group/HeadingGroup.mdx +521 -0
  518. package/src/components/heading-group/HeadingGroup.stories.tsx +353 -0
  519. package/src/components/heading-group/HeadingGroup.tsx +396 -0
  520. package/src/components/heading-group/index.ts +7 -0
  521. package/src/components/hero/Hero.mdx +742 -0
  522. package/src/components/hero/Hero.stories.tsx +527 -0
  523. package/src/components/hero/Hero.tsx +807 -0
  524. package/src/components/hero/index.ts +1 -0
  525. package/src/components/icon/Icon.mdx +329 -0
  526. package/src/components/icon/Icon.stories.tsx +398 -0
  527. package/src/components/icon/Icon.tsx +97 -0
  528. package/src/components/icon/index.ts +2 -0
  529. package/src/components/icon-button/IconButton.mdx +206 -0
  530. package/src/components/icon-button/IconButton.stories.tsx +341 -0
  531. package/src/components/icon-button/IconButton.tsx +273 -0
  532. package/src/components/icon-button/index.ts +1 -0
  533. package/src/components/item-row/ItemRow.mdx +533 -0
  534. package/src/components/item-row/ItemRow.stories.tsx +434 -0
  535. package/src/components/item-row/ItemRow.tsx +676 -0
  536. package/src/components/item-row/index.ts +9 -0
  537. package/src/components/list-row/ListRow.mdx +404 -0
  538. package/src/components/list-row/ListRow.stories.tsx +404 -0
  539. package/src/components/list-row/ListRow.tsx +424 -0
  540. package/src/components/list-row/index.ts +1 -0
  541. package/src/components/menu/Menu.mdx +268 -0
  542. package/src/components/menu/Menu.stories.tsx +455 -0
  543. package/src/components/menu/Menu.tsx +452 -0
  544. package/src/components/menu/index.ts +1 -0
  545. package/src/components/modal/Modal.mdx +854 -0
  546. package/src/components/modal/Modal.stories.tsx +881 -0
  547. package/src/components/modal/Modal.tsx +1434 -0
  548. package/src/components/modal/index.ts +1 -0
  549. package/src/components/nav-link/NavLink.mdx +196 -0
  550. package/src/components/nav-link/NavLink.stories.tsx +243 -0
  551. package/src/components/nav-link/NavLink.tsx +222 -0
  552. package/src/components/nav-link/index.ts +1 -0
  553. package/src/components/number-field/NumberField.mdx +223 -0
  554. package/src/components/number-field/NumberField.stories.tsx +291 -0
  555. package/src/components/number-field/NumberField.tsx +388 -0
  556. package/src/components/number-field/index.ts +6 -0
  557. package/src/components/pagination/Pagination.mdx +305 -0
  558. package/src/components/pagination/Pagination.stories.tsx +333 -0
  559. package/src/components/pagination/Pagination.tsx +343 -0
  560. package/src/components/pagination/index.ts +8 -0
  561. package/src/components/popover-surface/PopoverSurface.mdx +158 -0
  562. package/src/components/popover-surface/PopoverSurface.stories.tsx +421 -0
  563. package/src/components/popover-surface/index.ts +1 -0
  564. package/src/components/progress-bar/ProgressBar.mdx +802 -0
  565. package/src/components/progress-bar/ProgressBar.stories.tsx +533 -0
  566. package/src/components/progress-bar/ProgressBar.tsx +654 -0
  567. package/src/components/progress-bar/index.ts +9 -0
  568. package/src/components/promo-sticker/PromoSticker.mdx +436 -0
  569. package/src/components/promo-sticker/PromoSticker.stories.tsx +363 -0
  570. package/src/components/promo-sticker/PromoSticker.tsx +313 -0
  571. package/src/components/promo-sticker/index.ts +7 -0
  572. package/src/components/promo-surface/PromoSurface.mdx +399 -0
  573. package/src/components/promo-surface/PromoSurface.stories.tsx +270 -0
  574. package/src/components/promo-surface/PromoSurface.tsx +305 -0
  575. package/src/components/promo-surface/index.ts +7 -0
  576. package/src/components/radio/Radio.mdx +243 -0
  577. package/src/components/radio/Radio.stories.tsx +307 -0
  578. package/src/components/radio/Radio.tsx +288 -0
  579. package/src/components/radio/index.ts +1 -0
  580. package/src/components/radio-group/RadioGroup.mdx +119 -0
  581. package/src/components/radio-group/RadioGroup.stories.tsx +225 -0
  582. package/src/components/radio-group/RadioGroup.tsx +139 -0
  583. package/src/components/radio-group/index.ts +1 -0
  584. package/src/components/select/Select.mdx +241 -0
  585. package/src/components/select/Select.stories.tsx +404 -0
  586. package/src/components/select/Select.tsx +381 -0
  587. package/src/components/select/index.ts +1 -0
  588. package/src/components/select-field/SelectField.mdx +324 -0
  589. package/src/components/select-field/SelectField.stories.tsx +460 -0
  590. package/src/components/select-field/SelectField.tsx +138 -0
  591. package/src/components/select-field/index.ts +1 -0
  592. package/src/components/skeleton/Skeleton.mdx +194 -0
  593. package/src/components/skeleton/Skeleton.stories.tsx +260 -0
  594. package/src/components/skeleton/Skeleton.tsx +107 -0
  595. package/src/components/skeleton/index.ts +1 -0
  596. package/src/components/split-button/SplitButton.mdx +445 -0
  597. package/src/components/split-button/SplitButton.stories.tsx +465 -0
  598. package/src/components/split-button/SplitButton.tsx +361 -0
  599. package/src/components/split-button/index.ts +7 -0
  600. package/src/components/status-summary-bar/StatusSummaryBar.mdx +338 -0
  601. package/src/components/status-summary-bar/StatusSummaryBar.stories.tsx +408 -0
  602. package/src/components/status-summary-bar/StatusSummaryBar.tsx +428 -0
  603. package/src/components/status-summary-bar/index.ts +8 -0
  604. package/src/components/subject-lookup-field/SubjectLookupField.mdx +378 -0
  605. package/src/components/subject-lookup-field/SubjectLookupField.stories.tsx +393 -0
  606. package/src/components/subject-lookup-field/SubjectLookupField.tsx +1079 -0
  607. package/src/components/subject-lookup-field/index.ts +11 -0
  608. package/src/components/switch/Switch.mdx +376 -0
  609. package/src/components/switch/Switch.stories.tsx +296 -0
  610. package/src/components/switch/Switch.tsx +483 -0
  611. package/src/components/switch/index.ts +1 -0
  612. package/src/components/table/Table.mdx +575 -0
  613. package/src/components/table/Table.stories.tsx +1049 -0
  614. package/src/components/table/Table.tsx +745 -0
  615. package/src/components/table/TableConsumers.stories.tsx +195 -0
  616. package/src/components/table/_tableFixtures.ts +1189 -0
  617. package/src/components/table/index.ts +22 -0
  618. package/src/components/text-field/TextField.mdx +479 -0
  619. package/src/components/text-field/TextField.stories.tsx +366 -0
  620. package/src/components/text-field/TextField.tsx +391 -0
  621. package/src/components/text-field/index.ts +8 -0
  622. package/src/components/text-link/TextLink.mdx +353 -0
  623. package/src/components/text-link/TextLink.stories.tsx +458 -0
  624. package/src/components/text-link/TextLink.tsx +504 -0
  625. package/src/components/text-link/index.ts +10 -0
  626. package/src/components/textarea/Textarea.mdx +244 -0
  627. package/src/components/textarea/Textarea.stories.tsx +371 -0
  628. package/src/components/textarea/Textarea.tsx +489 -0
  629. package/src/components/textarea/index.ts +9 -0
  630. package/src/components/tooltip/Tooltip.mdx +462 -0
  631. package/src/components/tooltip/Tooltip.stories.tsx +500 -0
  632. package/src/components/tooltip/Tooltip.tsx +756 -0
  633. package/src/components/tooltip/index.ts +13 -0
  634. package/src/components/unit-field/UnitField.mdx +215 -0
  635. package/src/components/unit-field/UnitField.stories.tsx +291 -0
  636. package/src/components/unit-field/UnitField.tsx +255 -0
  637. package/src/components/unit-field/index.ts +7 -0
  638. package/src/icons/icon-registry.generated.ts +510 -0
  639. package/src/icons/icon-types.generated.ts +256 -0
  640. package/src/index.ts +71 -0
  641. package/src/internal/BottomSheet.tsx +714 -0
  642. package/src/internal/FodsProvider.tsx +36 -0
  643. package/src/internal/MotionCaret.tsx +53 -0
  644. package/src/internal/NumberFormatInput.tsx +276 -0
  645. package/src/internal/SummaryDonut.tsx +359 -0
  646. package/src/internal/buttonSegment.ts +241 -0
  647. package/src/internal/collapseRoom.ts +130 -0
  648. package/src/internal/comboboxKeys.ts +90 -0
  649. package/src/internal/contentPresence.ts +46 -0
  650. package/src/internal/dayCell.ts +274 -0
  651. package/src/internal/dialogPortal.ts +50 -0
  652. package/src/internal/donutSweeps.ts +77 -0
  653. package/src/internal/enterOnViewGeometry.ts +53 -0
  654. package/src/internal/faqItem.ts +104 -0
  655. package/src/internal/floatingLabelMotion.tsx +109 -0
  656. package/src/internal/formBlockContext.ts +27 -0
  657. package/src/internal/heightRoom.ts +135 -0
  658. package/src/internal/numberSeparators.ts +93 -0
  659. package/src/internal/overlayMotion.tsx +32 -0
  660. package/src/internal/paginationItem.ts +106 -0
  661. package/src/internal/popoverSurface.ts +78 -0
  662. package/src/internal/portalContainer.ts +11 -0
  663. package/src/internal/progressBarItem.ts +356 -0
  664. package/src/internal/selectionControlText.ts +42 -0
  665. package/src/internal/statusSummaryParts.tsx +475 -0
  666. package/src/internal/summaryMotion.ts +111 -0
  667. package/src/internal/table/ChildConnector.tsx +57 -0
  668. package/src/internal/table/ChildRowPrefix.tsx +21 -0
  669. package/src/internal/table/ColumnSettings.tsx +194 -0
  670. package/src/internal/table/ScrollRegion.tsx +176 -0
  671. package/src/internal/table/TableEmpty.tsx +99 -0
  672. package/src/internal/table/TableLayout.tsx +29 -0
  673. package/src/internal/table/TableLoadStatus.tsx +60 -0
  674. package/src/internal/table/TableMobile.tsx +582 -0
  675. package/src/internal/table/TruncatedCell.tsx +35 -0
  676. package/src/internal/table/emptyValue.ts +11 -0
  677. package/src/internal/table/features.ts +44 -0
  678. package/src/internal/table/recipes.ts +263 -0
  679. package/src/internal/table/rowClick.ts +8 -0
  680. package/src/internal/table/types.ts +342 -0
  681. package/src/internal/tailwind-variants.ts +65 -0
  682. package/src/internal/tooltipContext.ts +15 -0
  683. package/src/internal/tw-merge-config.generated.ts +275 -0
  684. package/src/internal/useAnchoredPanel.ts +340 -0
  685. package/src/internal/useCountUp.ts +65 -0
  686. package/src/internal/useDateFieldTrigger.tsx +357 -0
  687. package/src/internal/useEChart.ts +88 -0
  688. package/src/internal/useEnterOnView.ts +80 -0
  689. package/src/internal/useFloatingBar.ts +125 -0
  690. package/src/internal/useFormReset.ts +47 -0
  691. package/src/internal/useIsMobile.ts +64 -0
  692. package/src/internal/useNoImplicitSubmit.ts +41 -0
  693. package/src/internal/useOneRowOverflow.ts +103 -0
  694. package/src/internal/usePrefersReducedMotion.ts +27 -0
  695. package/src/internal/useReturnFocus.ts +34 -0
  696. package/src/internal/utils.ts +58 -0
  697. package/src/recipes/EmptyState.stories.tsx +105 -0
  698. package/src/recipes/Form.stories.tsx +355 -0
  699. package/src/recipes/ModalWithForm.stories.tsx +219 -0
  700. package/src/recipes/Recipes.mdx +61 -0
  701. package/src/recipes/TableWithFilters.stories.tsx +278 -0
  702. package/src/storybook/FodsFamily.tsx +39 -0
  703. package/src/storybook/Section.tsx +36 -0
  704. package/src/storybook/a11y.ts +24 -0
  705. package/src/storybook/assets/banner-character-bartender.webp +0 -0
  706. package/src/storybook/assets/banner-invoice-sheet-left.webp +0 -0
  707. package/src/storybook/assets/banner-invoice-sheet-right.webp +0 -0
  708. package/src/storybook/assets/invoice-hero.webp +0 -0
  709. package/src/storybook/assets/invoice.webp +0 -0
  710. package/src/storybook/assets/section-document-info.svg +21 -0
  711. package/src/storybook/assets/section-gear-checklist.svg +11 -0
  712. package/src/storybook/assets/section-person-arrow-in.svg +15 -0
  713. package/src/storybook/assets/section-person-arrow-out.svg +22 -0
  714. package/src/storybook/assets/section-receipt-dollar.svg +23 -0
  715. package/src/storybook/assets/table-empty-folder-empty.png +0 -0
  716. package/src/storybook/assets/table-empty-folder-magnifying-glass.png +0 -0
  717. package/src/storybook/assets/table-empty-funnel.png +0 -0
  718. package/src/storybook/assets/table-empty-load-failed.png +0 -0
  719. package/src/storybook/assets/wallet-spot.png +0 -0
  720. package/src/storybook/assets.d.ts +17 -0
  721. package/src/storybook/componentDoc.ts +41 -0
  722. package/src/storybook/fitFrame.tsx +70 -0
  723. package/src/storybook/forceStates.tsx +647 -0
  724. package/src/storybook/illustrations.tsx +66 -0
  725. package/src/storybook/viewportFrame.tsx +58 -0
  726. package/src/styles/assets/label-brush-1.svg +6 -0
  727. package/src/styles/assets/pattern-dark.svg +113 -0
  728. package/src/styles/base.css +106 -0
  729. package/src/styles/index.css +15 -0
  730. package/src/styles/motion.css +157 -0
  731. package/src/styles/promo-sticker.css +27 -0
  732. package/src/styles/promo-surface.css +49 -0
  733. package/src/styles/shared.css +11 -0
  734. package/src/styles/theme.generated.css +314 -0
  735. package/src/styles/theme.map.json +278 -0
  736. package/src/styles/tracking.generated.css +12 -0
  737. package/src/tokens/index.ts +4 -0
  738. package/src/tokens/tokens.generated.ts +542 -0
@@ -0,0 +1,807 @@
1
+ "use client";
2
+ import * as React from 'react';
3
+ import { tv } from '../../internal/tailwind-variants';
4
+ import { cn } from '../../internal/utils';
5
+ import { PromoSurface, type PromoSurfaceSurface } from '../promo-surface/PromoSurface';
6
+ import { useEnterOnView } from '../../internal/useEnterOnView';
7
+
8
+ /**
9
+ * Hero — the first-screen panel of a public page (`hero.manifest.json`, organism,
10
+ * v1.5.4, `kind: "region"`).
11
+ *
12
+ * A promo plaque carrying the page's single claim, at most two actions and — where the
13
+ * page has one — one image. Landing pages, the homepage, the news index, the register
14
+ * search. Never an in-app card, section or callout: the plaque comes from Promo
15
+ * Surface, a public-page-only atom (`intent.whenToUse`).
16
+ *
17
+ * ## No chrome of its own
18
+ *
19
+ * The fill, the tiled pattern and the veil are delegated WHOLE to `<PromoSurface>`.
20
+ * `container.note` is explicit that the root has no fill and no border — `--bg-primary`
21
+ * is the page canvas *behind* the component, not chrome. Per `delivery.react` the
22
+ * surface renders as "a sibling background layer, absolutely positioned to the panel's
23
+ * bounds", so the text column and the image are siblings ABOVE it, never inside it.
24
+ *
25
+ * Because an absolutely positioned sibling paints over static in-flow siblings, the
26
+ * content layers (`text-column`, `image`) are `relative`. Same trick ListRow /
27
+ * ActionRow use for their `::before` wash — no z-index needed.
28
+ *
29
+ * ## Axes: Breakpoint x Visual (+ sparse Actions width), 12 variants — only two are props
30
+ *
31
+ * `intent.sizing`: "No size axis — Breakpoint IS the sizing". The five breakpoints are
32
+ * pure CSS responsiveness, so there is no `size` and no `breakpoint` prop. Figma
33
+ * breakpoint -> Tailwind prefix: Mobile 390 = unprefixed, SM 600 = `sm:`, MD 720 =
34
+ * `md:`, LG 960 = `lg:`, XL 1270 = `xl:`.
35
+ *
36
+ * `visual` IS a prop, and a discriminated union rather than a boolean, because
37
+ * `intent.rules[1]` / `regions.image.note` / `intent.variants` all say the same thing
38
+ * three times: "An empty Image slot is not a centred hero — Visual=Off is the centred
39
+ * composition, built centred from the start, not an image slot left empty beside a
40
+ * full-width text column." It therefore has NO default: the page has to make the
41
+ * compositional choice consciously, and the union makes TypeScript enforce it (no
42
+ * runtime guard required).
43
+ *
44
+ * ## Booleans are slots
45
+ *
46
+ * The Figma booleans `Kicker` / `Body` / `Actions` / `Format icon` / `Sub`
47
+ * (`properties[]`) map onto slot PRESENCE — an undefined slot does not render. A Figma
48
+ * boolean plus an instance swap is one slot prop, never two props.
49
+ *
50
+ * ## No states
51
+ *
52
+ * `intent.states`: no interaction states on the shell. No hover, no active, no
53
+ * disabled, no loading — whatever lands in `actions` / `formatIcon` / `sub` owns its
54
+ * own states.
55
+ *
56
+ * ## Motion — one entrance, once
57
+ *
58
+ * `motion.enter` (1.5.2): kicker → heading → body → CTA fade in one after another over
59
+ * --duration-slow / --easing-enter, each settling --space-200 up into place; at
60
+ * Visual=On the image follows the text and only fades. It plays once, on first viewport
61
+ * entry (IntersectionObserver 0.3) — `useEnterOnView` drives `data-hero-motion` on the
62
+ * root and the pieces read it through the named group `hero`. The stagger has no token
63
+ * (manifest `gaps[]`), so each piece carries its step in `--hero-step` and the keyframe
64
+ * derives the delay from --duration-instant (the theme's `hero-enter-*`). The
65
+ * Format icon and `sub` are not in the sequence and never move. Every gating class is
66
+ * `motion-safe:`: under reduced motion the content is there at once, no fade-up.
67
+ * (`tailwindcss-animate` is not installed, so the keyframes are named, not `animate-in`.)
68
+ */
69
+ const heroVariants = tv({
70
+ slots: {
71
+ root: [
72
+ // No fill, no border: container.note — --bg-primary is the page canvas behind the
73
+ // component, not chrome. No `mx-auto` either: the root is full width of whatever
74
+ // container it is dropped into, and that container does the centring.
75
+ // `group/hero` — the entrance pieces read the root's `data-hero-motion`.
76
+ 'group/hero flex w-full flex-col',
77
+ /*
78
+ * VERTICAL ONLY. The horizontal half of what the manifest draws on this root — the
79
+ * 16/24/32/40 side gutter and the 1270/960/720/600 width ladder (intent.sizing) — is
80
+ * the PAGE CONTAINER, not chrome of this component. container.note says so itself:
81
+ * the root side padding is "the same 16/24/32/40/40 ladder Nav Bar cites", whose
82
+ * "code equivalent" it hands to layout-system.md — i.e. the layout layer. That layer
83
+ * is the consuming page's own container, and Hero repeating the ladder inside it made
84
+ * the plaque narrower than the page content
85
+ * (720 wide at an 900px viewport against a 786 feed). Storybook has no page container, so
86
+ * meta.decorators supplies the same container and the breakpoint stories still
87
+ * reproduce their Figma artboards.
88
+ *
89
+ * What stays is the root's own top/bottom band (container.note): Mobile 16 /
90
+ * --space-600, SM and up 24 / --space-800.
91
+ */
92
+ 'py-600 sm:py-800',
93
+ // Root gap = panel -> sub (container.note): --space-800 at MD/SM/Mobile,
94
+ // --space-900 at XL/LG.
95
+ 'gap-800 lg:gap-900',
96
+ ],
97
+ panel: [
98
+ // `relative` so the absolutely positioned Promo Surface layers resolve against the
99
+ // panel box (delivery.react: sized to the panel bounds).
100
+ 'relative flex flex-col',
101
+ // regions.panel.note: radius --radius-800, matching Promo Surface.
102
+ 'rounded-800',
103
+ /*
104
+ * The plaque's own vertical padding — 64 / --space-1200 — and it exists ONLY in the
105
+ * stacked composition. From `lg` up the text column sits BESIDE the image and carries
106
+ * the whole vertical rhythm itself (40 at LG, 64 at XL), so the panel goes back to
107
+ * zero; below `lg` the copy sits ABOVE the image and Figma adds this band on the panel
108
+ * on top of the text column's own 16/24.
109
+ *
110
+ * `pt` and not `py`: the bottom belongs to the Visual=Off arm only. At Visual=On the
111
+ * image is flush with the plaque's rounded bottom edge, so a bottom padding here would
112
+ * lift it off the edge — measured on 7252:122568 (Mobile) and 7308:123115 (MD), both
113
+ * `pt-[var(--space/1200)]` with no `pb`.
114
+ *
115
+ * regions.panel.padding (1.1.0) records it: "MD, SM and Mobile carry --space-1200/64
116
+ * top and bottom; XL and LG carry none... At Visual=On the bottom padding is dropped
117
+ * (top only) so the image meets the rounded bottom edge." The resulting distance from
118
+ * the plaque edge to the kicker (XL 64 / LG 40 / MD 88 / SM 88 / Mobile 80) is
119
+ * NON-MONOTONIC on purpose - the stacked composition gets more air above the kicker
120
+ * than XL does.
121
+ */
122
+ 'pt-1200 lg:pt-0',
123
+ // Deliberately NO overflow-hidden here. The Format icon bleeds over this very edge
124
+ // by design (intent.rules[3], "not a bug, a signature bleed"), so clipping the panel
125
+ // would erase the signature. The clip the image needs lives on the image slot
126
+ // instead, where it is the only thing being clipped.
127
+ ],
128
+ // The plaque ink lives on the PANEL, not on the root, on purpose: chrome.ink pairs the
129
+ // ink with the FILL, and `sub` sits OUTSIDE the fill (regions.sub.note: "page chrome,
130
+ // not plaque chrome"), so it must not inherit the plaque ink.
131
+ textColumn: [
132
+ // `relative` so the in-flow content paints ABOVE the absolutely positioned surface
133
+ // siblings; a positioned sibling otherwise paints over static content.
134
+ 'relative flex flex-col',
135
+ // regions.text-column.gap — copy block -> Actions. 32, not the 16 the runs inside the
136
+ // copy use: once the D2 ladder split those into 8 and 16 (see the `text` slot), the
137
+ // break before Actions had to read as visibly larger than either of them (1.3.0).
138
+ 'gap-900',
139
+ // regions.text-column.padding, per breakpoint. Mobile 24 L/R + 16 T/B; MD and SM are
140
+ // identical at 32 L/R + 24 T/B; LG 40 all round; XL 64 T/B.
141
+ //
142
+ // The XL HORIZONTAL row is deliberately absent here: the manifest conditions the
143
+ // asymmetric 64 left / 24 right on the variant — "XL at Visual=On... the one
144
+ // asymmetric case, opening toward the image" — so it lives on the `visual.on` arm.
145
+ // "XL at Visual=Off: --space-1000/40 left+right", which is what `lg:p-1000` already
146
+ // gives: the centred composition has nothing to open toward, and the asymmetry would
147
+ // throw the copy 20px off the panel's axis.
148
+ //
149
+ // Mobile top/bottom is --space-600. The manifest used to name the Layout-collection
150
+ // side-padding var there; 1.1.0 replaced it with the --space token, since that var is
151
+ // the container's HORIZONTAL token and was being read off its own axis.
152
+ 'px-800 py-600 sm:px-900 sm:py-800 lg:p-1000 xl:py-1200',
153
+ ],
154
+ formatIcon: [
155
+ // Decorative art in a fixed box. intent.rules[2]: the ONE slot that is never
156
+ // stretched, everything else in the anatomy is auto-layout-sized.
157
+ 'shrink-0',
158
+ // intent.rules[2] (1.5.1): a SQUARE 48x48 box (--size-illustration-spot) at every breakpoint.
159
+ 'size-illustration-spot',
160
+ // The artwork is FITTED into the box (object-fit: contain), never cropped — cover
161
+ // would cut the sides off any mark whose ratio differs from the box. The slot owns
162
+ // the fit, so consumers pass a bare <img alt="">.
163
+ '[&_svg]:size-full [&_img]:size-full [&_img]:object-contain',
164
+ ],
165
+ /*
166
+ * The copy block. regions.text-column.note (1.2.0) makes it TWO-TIER, matching the
167
+ * Heading Group molecule's D2 gap ladder: a `title-group` (kicker + heading) nested
168
+ * inside this block, which then holds title-group + body. It used to be one flat
169
+ * --space-500 (12) across all three runs.
170
+ *
171
+ * Figma names the outer frame `text`; the part keeps the name `copy` the manifest uses
172
+ * in prose ("the copy block") and the parts map already measures.
173
+ */
174
+ copy: [
175
+ 'flex flex-col',
176
+ // title-group -> body.
177
+ 'gap-600',
178
+ // The 580px measure — notes[2]: "--ds-content-narrow, the system measure — not a
179
+ // component-owned raw value". Bound to the token, not restated as a literal.
180
+ 'max-w-content-narrow',
181
+ ],
182
+ titleGroup: [
183
+ 'flex flex-col',
184
+ // kicker -> heading.
185
+ 'gap-400',
186
+ ],
187
+ kicker: [
188
+ // text.kicker: Caveat 20/26 at Mobile stepping to 32/40 at XL. --font-decorative
189
+ // (Caveat) reaches Tailwind as `font-caveat`, added to the config with this
190
+ // component as its first consumer.
191
+ 'font-caveat',
192
+ // 20px = --font-size-lg = text-body-xl; 32px = --font-size-4xl = text-heading-xxl.
193
+ //
194
+ // The LEADING IS PX, and that is the sanctioned form, not a workaround. text-styles
195
+ // (Decorative/Caveat/32 and /20) sets lineHeight to null with the reason: "Caveat
196
+ // binds px leading on purpose — its sizes are not responsive, so px cannot drift, and
197
+ // a ratio token for one decorative style would widen the scale for nothing."
198
+ // --leading-compact is 1.3, which renders Caveat/32 at 41.6 rather than the drawn 40;
199
+ // Caveat/20 coincides with it at 26 but is written px too, so one rule stays one rule.
200
+ //
201
+ // Repeated at `md:` because `text-heading-xxl` ships --leading-loose inside its
202
+ // fontSize tuple and Tailwind emits every `md:` rule after every unprefixed one.
203
+ // fods-lint-disable-next-line Caveat px leading (26 at Mobile / 40 from MD) per spec/02-tokens/text-styles.json — Decorative/Caveat binds px on purpose, no leading token carries 1.25
204
+ 'text-body-xl leading-[26px] md:text-heading-xxl md:leading-[40px]',
205
+ // motion.enter — first in the sequence (see the JSDoc § Motion).
206
+ 'motion-safe:group-data-[hero-motion=armed]/hero:opacity-0 motion-safe:group-data-[hero-motion=play]/hero:animate-hero-enter-rise',
207
+ ],
208
+ heading: [
209
+ // text.heading: Poppins Bold, 130% leading, 40px at XL down to 32px at Mobile.
210
+ //
211
+ // ONE class, no `md:` pair: --font-size-display-d2 already carries that step
212
+ // itself. tokens.css redefines the primitive inside `@media (max-width: 767px)`
213
+ // (2.5rem -> 2rem), so `text-display-d2` resolves to 40px from MD up and 32px
214
+ // below it — exactly the two numbers text.heading names.
215
+ //
216
+ // Do NOT reach for `text-display-d3` at mobile to spell the 32 out: d3 has its
217
+ // OWN mobile override (2rem -> 1.625rem), so `text-display-d3 md:text-display-d2`
218
+ // renders the claim at 26px below 768px, not 32px. Measured against
219
+ // the mobile override of --ds-font-size-display-d3 in tokens.css.
220
+ //
221
+ // No separate leading class: the `display-d2` scale entry in the theme
222
+ // carries --leading-compact (1.3 = the 130% the manifest asks for) in its
223
+ // fontSize tuple, and the ratio follows the mobile font-size step on its own.
224
+ 'font-poppins font-bold',
225
+ 'text-display-d2',
226
+ // A 5-to-7-word claim (text.heading) reads badly with one orphaned word.
227
+ // Bound to the token, not the bare `text-balance` utility: the value is the
228
+ // same today, but only the token is what `$textWrapRule` (Display + Heading
229
+ // styles bind --text-wrap-heading) lets a check against the manifest grade.
230
+ '[text-wrap:var(--text-wrap-heading)]',
231
+ // motion.enter — after the kicker.
232
+ 'motion-safe:group-data-[hero-motion=armed]/hero:opacity-0 motion-safe:group-data-[hero-motion=play]/hero:animate-hero-enter-rise',
233
+ ],
234
+ body: [
235
+ // typography.runs.body: Body/XL — 20px/150% at EVERY breakpoint. Not the Section
236
+ // Header D2 -> Body/L ladder default: a Promo Surface plaque's body is a lead
237
+ // paragraph, so it takes the promo-plaque carve-out (the same Body/XL Banner holds).
238
+ //
239
+ // ONE class, no `md:` pair and no explicit leading: Body/XL binds --font-size-lg with
240
+ // --leading-relaxed, which is exactly what `text-body-xl` already carries in its
241
+ // tuple (the theme). The Typography collection does not step Body styles,
242
+ // so 20 holds on Mobile too.
243
+ 'font-inter',
244
+ 'text-body-xl',
245
+ // Body/XL binds --text-wrap-body (pretty) via $textWrapRule — the token, not
246
+ // the bare `text-pretty` utility, so the binding is measurable.
247
+ '[text-wrap:var(--text-wrap-body)]',
248
+ // motion.enter — after the heading.
249
+ 'motion-safe:group-data-[hero-motion=armed]/hero:opacity-0 motion-safe:group-data-[hero-motion=play]/hero:animate-hero-enter-rise',
250
+ ],
251
+ actions: [
252
+ // slots.actions: ONE block stretched to the text column, up to 2 children,
253
+ // itemSpacing --space-400. The width cap is on the `actionsWidth` variant, not
254
+ // here — see that variant for why the slot has two.
255
+ 'flex flex-wrap items-center gap-400',
256
+ 'w-full',
257
+ // motion.enter — the CTA closes the text sequence.
258
+ 'motion-safe:group-data-[hero-motion=armed]/hero:opacity-0 motion-safe:group-data-[hero-motion=play]/hero:animate-hero-enter-rise',
259
+ ],
260
+ image: [
261
+ // `relative` for the same paint-order reason as the text column.
262
+ 'relative flex w-full',
263
+ // overflow-hidden belongs HERE and not on the panel. regions.image says the graphic
264
+ // is clipped to the slot, but intent.rules[3] says the Format icon must overflow the
265
+ // panel edge; one `overflow-hidden` on the shared ancestor cannot do both, so the
266
+ // clip is scoped to the only child that needs it. The panel radius therefore has to
267
+ // be repeated on this slot, on the corners the image actually touches: the bottom
268
+ // pair while stacked, the right pair once it sits beside the text column. Corners are
269
+ // set one by one at lg: `lg:rounded-b-none` + `lg:rounded-r-800` collide on the
270
+ // bottom-right corner and the later rule in the built CSS zeroes it.
271
+ 'overflow-hidden rounded-b-800 lg:rounded-bl-none lg:rounded-tr-800 lg:rounded-br-800',
272
+ // Bottom anchoring, required beside the text column and harmless while stacked (the
273
+ // graphic spans the full slot width there, so there is no slack to anchor). NOT
274
+ // items-stretch: stretching an img with height:auto would distort the 4:3 ratio.
275
+ 'items-end justify-start',
276
+ // intent.sizing / regions.image / delivery.react (1.4.0), per COMPOSITION:
277
+ // stacked (MD, SM, Mobile) the graphic takes the slot WIDTH, height follows, in flow,
278
+ // nothing clipped.
279
+ '[&_img]:h-auto [&_img]:w-full',
280
+ // Side by side (XL, LG) it takes the slot HEIGHT, anchored bottom-left, width from
281
+ // the ratio; the overrun is cut on the RIGHT by this slot's overflow-hidden, and a
282
+ // narrower graphic leaves the remainder empty. Out of flow, so it never feeds the
283
+ // panel's HUG height — the text column sets it. `max-w-none` lifts the preflight
284
+ // `max-width: 100%`, which would otherwise squeeze the width and distort the ratio.
285
+ 'lg:[&_img]:absolute lg:[&_img]:bottom-0 lg:[&_img]:left-0',
286
+ 'lg:[&_img]:h-full lg:[&_img]:w-auto lg:[&_img]:max-w-none',
287
+ // motion.enter — after the text, and a fade only: the image never slides.
288
+ 'motion-safe:group-data-[hero-motion=armed]/hero:opacity-0 motion-safe:group-data-[hero-motion=play]/hero:animate-hero-enter-fade',
289
+ ],
290
+ sub: [
291
+ // regions.sub.note: row at XL/LG/MD, column at SM/Mobile, FILL width. The maxWidth
292
+ // numbers recorded there track the ROOT, which a FILL-width child of the root is
293
+ // already bounded by, so they are inert in code and no cap is emitted here.
294
+ // No gap: the slot takes exactly ONE child (a format switcher, a figure strip or a
295
+ // progress component), which owns its own internal spacing.
296
+ 'flex w-full flex-col md:flex-row',
297
+ ],
298
+ },
299
+ variants: {
300
+ /*
301
+ * Which content band the actions block is capped to.
302
+ *
303
+ * `axes.actions-width` (1.3.0): Narrow binds --ds-content-narrow (580, the default),
304
+ * Medium binds --ds-content-medium (786, the width a featured card is drawn at).
305
+ * 580 is "the measure" — right for the two prose-scale fillings, a button group
306
+ * or a search field, which should not run wider than the claim above them.
307
+ *
308
+ * Featured content is the case it does not fit: the featured-content hero (Figma:
309
+ * node 283:7000) fills the slot with a bordered card 786 wide,
310
+ * centred in the 1190 panel (x=202, 1190 − 2·202 = 786). At 580 that card would clamp
311
+ * and re-centre, which is not the design.
312
+ *
313
+ * SPARSE on purpose — the axis exists only at XL·Off and LG·Off, "the two cells whose
314
+ * text column fits 786"; every other cell's column is narrower than the Narrow cap
315
+ * already. The copy block keeps its 580 prose measure on both values.
316
+ */
317
+ actionsWidth: {
318
+ narrow: { actions: 'max-w-content-narrow' },
319
+ medium: { actions: 'max-w-content-medium' },
320
+ },
321
+ /*
322
+ * Ink follows the plaque fill (promo-surface.manifest.json chrome.ink). Mixing one
323
+ * surface fill with another surface ink is the failure that axis exists to prevent.
324
+ *
325
+ * `chrome.ink` is the PANEL's ink, not every run's: on the two LIGHT plaques the copy
326
+ * carries two inks — heading --text-primary, kicker and body
327
+ * --secondary-tint-foreground, which is the token documented for "text inside
328
+ * blue-tinted badges, banners, tinted sections" and the one --secondary-subtle pairs
329
+ * itself with. The manifest has nowhere to state a per-run ink (banner.manifest.json
330
+ * records the same gap as BLOCKED on schema shape), so it stays here.
331
+ *
332
+ * The DARK plaques keep inheriting the panel ink: blue/900 on a blue/600 or blue/900
333
+ * fill is unreadable, and `chrome.ink` is unambiguous for those two.
334
+ */
335
+ surface: {
336
+ brand: {
337
+ panel: 'text-text-primary',
338
+ kicker: 'text-secondary-tint-foreground',
339
+ body: 'text-secondary-tint-foreground',
340
+ },
341
+ utility: {
342
+ panel: 'text-text-primary',
343
+ kicker: 'text-secondary-tint-foreground',
344
+ body: 'text-secondary-tint-foreground',
345
+ },
346
+ solid: { panel: 'text-secondary-foreground' },
347
+ inverse: { panel: 'text-text-inverted' },
348
+ },
349
+ // regions.panel.note. Visual=On: two children side by side at XL/LG, stacked at
350
+ // MD/SM/Mobile. Visual=Off: one child, centred, no image child at all.
351
+ visual: {
352
+ on: {
353
+ panel: 'lg:flex-row',
354
+ /*
355
+ * The side-by-side split, as a flex BASIS on both children rather than a fixed
356
+ * width on one of them.
357
+ *
358
+ * `intent.sizing` gives the text column a per-breakpoint px width and lets the
359
+ * image take "the rest": XL panel 1190 = 639 + 551 (53.7% / 46.3%), LG panel
360
+ * 880 = 480 + 400 (54.5% / 45.5%). At the container caps the two bases sum to
361
+ * the panel exactly, so these numbers reproduce Figma to the pixel.
362
+ *
363
+ * LG is "text column 480 (copy 400 plus --space-1000 on each side) / image 400"
364
+ * (1.4.0; 1.3.x said 400 for the column, which was the copy width).
365
+ *
366
+ * Why not `w-[639px] shrink-0` on the column with `flex-1` on the image — which
367
+ * is what this was first built as, and it was WRONG: `flex-1` is `flex: 1 1 0%`,
368
+ * so the image's basis is 0 and it absorbs the ENTIRE deficit whenever the panel
369
+ * comes out narrower than the cap. In the Storybook docs iframe (panel ~892px)
370
+ * that rendered a 639/892 = 72% text column against a squeezed image, nothing
371
+ * like the near-half split the design asks for.
372
+ *
373
+ * With a real basis on both and shrink on both, flexbox distributes any deficit
374
+ * in PROPORTION to the bases, so the ratio survives at any container width while
375
+ * still being exact at 1190 and 880. Growth cannot drift it either: at every
376
+ * breakpoint the root's own cap makes the panel equal the sum of the bases.
377
+ */
378
+ textColumn: [
379
+ /*
380
+ * Alignment follows the COMPOSITION, not the Visual variant: stacked is
381
+ * centred, side-by-side is flush left. Verified against the Figma renders —
382
+ * MD·On (7308:123114) and Mobile·On (7252:122567) centre the kicker, heading
383
+ * and body, while LG·On (7308:123084) sets all three flush left. It is the same
384
+ * `lg` seam the Promo Surface layout swap uses above, and for the same reason:
385
+ * below it the copy sits ABOVE the image, so centring it is what balances the
386
+ * column; from `lg` up it sits BESIDE the image and centring would push the
387
+ * text away from the edge it should align to.
388
+ *
389
+ * regions.text-column.align (1.1.0) now says it in the manifest, in these terms:
390
+ * "Follows the COMPOSITION, not the Visual variant: stacked is centred (MD/SM/
391
+ * Mobile at Visual=On, and every Visual=Off), side-by-side is left (XL/LG at
392
+ * Visual=On). This is the same boundary regions.panel.note switches the Promo
393
+ * Surface Layout on." It closes with the trap this was first built into:
394
+ * "Reading 'Visual=On is the left-aligned composition' from intent.rules and
395
+ * applying it at every breakpoint is the wrong result."
396
+ */
397
+ 'items-center text-center lg:items-start lg:text-left',
398
+ 'lg:grow-0 lg:shrink',
399
+ // fods-lint-disable-next-line LG text-column basis from intent.sizing (panel 880 = 480 + 400, a 400 copy plus 40 each side); a composition measure, no semantic space token reaches 480
400
+ 'lg:basis-[480px]',
401
+ // fods-lint-disable-next-line XL text-column basis from intent.sizing (panel 1190 = 639 + 551); a composition measure, no semantic space token reaches 639
402
+ 'xl:basis-[639px]',
403
+ // regions.text-column.padding, "XL at Visual=On: --space-1200/64 left+top+bottom,
404
+ // --space-800/24 right (the one asymmetric case, opening toward the image)". The
405
+ // manifest conditions it on the variant, which is why it is not in the base slot
406
+ // — see the padding comment there. `xl:` is emitted after `lg:`, so this overrides
407
+ // the symmetric `lg:p-1000` without depending on utility order inside one query.
408
+ 'xl:pl-1200 xl:pr-800',
409
+ ],
410
+ // The 580 measure cap is centred in the column while stacked and flush left once
411
+ // the column sits beside the image — same seam as the alignment above.
412
+ copy: 'mx-auto lg:mx-0',
413
+ // Actions follow the copy: a centred claim over left-aligned buttons reads as a
414
+ // mistake, and `slots.actions` calls the block "stretched to the text column",
415
+ // which centring does not change.
416
+ actions: 'justify-center lg:justify-start',
417
+ // intent.rules[3]: MD/SM/Mobile keep the icon in flow, centred above the kicker,
418
+ // "because there is no side margin left to bleed into". XL/LG hang it left of the
419
+ // text column, absolutely positioned, overflowing the panel edge. The text column
420
+ // is flush with the panel edge in this composition, so a negative left offset on
421
+ // the column IS the panel-edge overflow.
422
+ formatIcon: [
423
+ 'self-center lg:absolute lg:self-auto',
424
+ // Top-aligned with the copy block, i.e. level with the kicker (1.4.0
425
+ // regions.text-column.note). The offset is therefore the text column's own top
426
+ // padding: 40 at LG, 64 at XL.
427
+ 'lg:top-1000 xl:top-1200',
428
+ // LG overflows by 20 = --space-700.
429
+ 'lg:-left-700',
430
+ // XL overflows by 19, not 20. notes[1] calls the 19-vs-20 difference intentional
431
+ // variation and says explicitly it is "not meant to be equalized to one identical
432
+ // value", so it is reproduced rather than rounded onto the grid.
433
+ // fods-lint-disable-next-line 19px XL signature bleed; notes[1] forbids equalizing it with the LG 20px value, and 19 is off the --space grid by design
434
+ 'xl:-left-[19px]',
435
+ ],
436
+ // Beside the text column from LG up; full panel width while stacked. The basis is
437
+ // the other half of the split above — the remainder of the panel at each cap
438
+ // (LG 880 − 480 = 400, XL 1190 − 639 = 551) — so a deficit is shared in
439
+ // proportion instead of landing entirely here. `min-w-0` still lets it go below
440
+ // its content width rather than pushing the panel wider.
441
+ image: [
442
+ 'lg:min-w-0 lg:grow lg:shrink',
443
+ // fods-lint-disable-next-line LG image basis from intent.sizing (panel 880 − 480 text); a composition measure with no semantic space token
444
+ 'lg:basis-[400px]',
445
+ // fods-lint-disable-next-line XL image basis from intent.sizing (panel 1190 − 639 text); a composition measure with no semantic space token
446
+ 'xl:basis-[551px]',
447
+ ],
448
+ },
449
+ off: {
450
+ // The centred composition, built centred (intent.rules[1]).
451
+ //
452
+ // The bottom half of the plaque's vertical band (see the `panel` slot for the top):
453
+ // with no image to reach the rounded bottom edge, the 64 / --space-1200 closes the
454
+ // plaque symmetrically while stacked, and goes to zero from `lg` up with the top.
455
+ panel: ['items-center text-center', 'pb-1200 lg:pb-0'],
456
+ textColumn: 'w-full items-center',
457
+ copy: 'mx-auto',
458
+ actions: 'mx-auto justify-center',
459
+ // No absolute bleed in this composition: with the text column centred, "left of
460
+ // the text column" lands INSIDE the plaque instead of over its edge, which is not
461
+ // the signature intent.rules[3] describes. The icon stays in flow and centred
462
+ // above the kicker at every breakpoint.
463
+ formatIcon: 'self-center',
464
+ },
465
+ },
466
+ },
467
+ defaultVariants: {
468
+ surface: 'brand',
469
+ actionsWidth: 'narrow',
470
+ },
471
+ });
472
+
473
+ /**
474
+ * The plaque tone, passed straight through to `<PromoSurface surface>`, which owns the
475
+ * fill. Hero only pairs the matching ink with it (`chrome.ink`).
476
+ *
477
+ * `solid` and `inverse` are DARK plaques, and two obligations ride on the consumer there
478
+ * (`intent.rules`):
479
+ *
480
+ * 1. ONE brand CTA, no secondary action — the same rule Banner holds. `Secondary` and
481
+ * `Tertiary` both ink their label with `--secondary`, which measures 1.33:1 on
482
+ * `--secondary-solid` and 1.59:1 on `--bg-inverse`; the label disappears and all that
483
+ * is left of the button is its border. No Button family is built for a dark ground and
484
+ * none is coming — the stance is compose, not recolour
485
+ * (`spec/06-patterns/inverse-surface.md`).
486
+ * 2. The default focus ring is under the 3:1 non-text floor there, so anything focusable
487
+ * composed into `actions` MUST bind `--outline-focus-inverse`
488
+ * (`focus-visible:outline-outline-focus-inverse`). It is `outline-*`, never `ring-*`:
489
+ * the floor wants an additive offset OUTLINE, and a ring is a box-shadow that would
490
+ * sit alongside the real one instead of replacing it. Hero cannot do that for you:
491
+ * it owns no focusable element and never overrides the focus behaviour of its slot
492
+ * content — see `ActionsBlock` in the stories for the shape. The obligation is
493
+ * Actions-only: `regions.sub.note` puts `sub` OUTSIDE the plaque fill, so a white
494
+ * inverse ring would be wrong there.
495
+ */
496
+ export type HeroSurface = PromoSurfaceSurface;
497
+
498
+ /**
499
+ * The entrance order, one `--hero-step` per piece that is actually rendered — an absent
500
+ * kicker or body does not leave a gap in the sequence. Literal classes, so Tailwind sees
501
+ * them; five pieces at most (kicker, heading, body, actions, image).
502
+ */
503
+ const ENTER_STEP = [
504
+ '[--hero-step:0]',
505
+ '[--hero-step:1]',
506
+ '[--hero-step:2]',
507
+ '[--hero-step:3]',
508
+ '[--hero-step:4]',
509
+ ] as const;
510
+
511
+ type HeroEnterPart = 'kicker' | 'heading' | 'body' | 'actions' | 'image';
512
+ const HERO_ENTER_ORDER: readonly HeroEnterPart[] = ['kicker', 'heading', 'body', 'actions', 'image'];
513
+
514
+ /** The step class of every rendered piece, numbered in `HERO_ENTER_ORDER` over the present ones. */
515
+ const heroEnterSteps = (present: Record<HeroEnterPart, boolean>): Partial<Record<HeroEnterPart, string>> => {
516
+ const steps: Partial<Record<HeroEnterPart, string>> = {};
517
+ HERO_ENTER_ORDER.filter(part => present[part]).forEach((part, index) => {
518
+ steps[part] = ENTER_STEP[Math.min(index, ENTER_STEP.length - 1)];
519
+ });
520
+ return steps;
521
+ };
522
+
523
+ /**
524
+ * Which content band `actions` is capped to — `narrow` (580, the measure) for buttons
525
+ * and search fields, `medium` (786, the non-prose column) for a featured-content card.
526
+ * See the `actionsWidth` variant in the recipe for the reasoning.
527
+ */
528
+ export type HeroActionsWidth = 'narrow' | 'medium';
529
+
530
+ export interface HeroBase extends Omit<React.HTMLAttributes<HTMLElement>, 'children'> {
531
+ /**
532
+ * The page claim. Rendered as the page's `<h1>` (`delivery.react`), so there must be
533
+ * exactly one Hero per page. Wraps, ~70 characters (`text.heading`).
534
+ */
535
+ heading: React.ReactNode;
536
+ /**
537
+ * The line ABOVE the heading. A plain text line, never a heading itself
538
+ * (`delivery.react`, `text.kicker`) — do not pass a heading element and do not give it
539
+ * `role="heading"`; that breaks the page heading order for screen-reader users.
540
+ * Wraps to 2 lines, ~60 characters.
541
+ */
542
+ kicker?: React.ReactNode;
543
+ /**
544
+ * ONE block, not a row of loose buttons (`slots.actions`): a button group, a search
545
+ * field or a featured-content component, up to 2 children, stretched to the text
546
+ * column. The block keeps its own hover / focus / active / disabled states — see
547
+ * `surface` for the one obligation it inherits from the plaque.
548
+ */
549
+ actions?: React.ReactNode;
550
+ /**
551
+ * The width cap on the `actions` block. Defaults to `narrow` (`--ds-content-narrow`,
552
+ * 580 = the measure), which is right for a button group or a search field. Set `medium`
553
+ * (`--ds-content-medium`, 786) only when the slot carries FEATURED CONTENT — a bordered
554
+ * card, which the measure would clamp and re-centre. Ignored when `actions` is not set.
555
+ *
556
+ * The axis is SPARSE upstream: `axes.actions-width` exists only at XL·Off and LG·Off,
557
+ * "the two cells whose text column fits 786" (`slots.actions.note`). Every other cell's
558
+ * column is narrower than the Narrow cap already, so `medium` has nothing to buy there.
559
+ * The copy block keeps its 580 prose measure on both values — only this slot swaps.
560
+ */
561
+ actionsWidth?: HeroActionsWidth;
562
+ /**
563
+ * A document-format mark — Word / Excel / PDF / Sheets / Docs. A closed vocabulary by
564
+ * convention; Figma stopped enforcing it in 1.0.0 (`changelog`), the intent did not
565
+ * change: a format mark, not arbitrary art.
566
+ *
567
+ * ARTWORK, NOT A GLYPH. The slot holds the format's own mark artwork — the square
568
+ * Word / Excel / PDF / Sheets / Docs images a template landing page
569
+ * ships — not an icon glyph; Sheets and Docs are deliberately NOT being added to the
570
+ * icon set. `intent.rules[2]` (1.5.1) sizes the box a square 48×48 (`--size-illustration-spot`) at
571
+ * every breakpoint, and the slot fits the artwork into it (`object-fit: contain`), never
572
+ * crops it. Pass a bare `<img alt="">` — the slot owns geometry and fit.
573
+ *
574
+ * Purely decorative. The wrapper carries `aria-hidden="true"` because the format is
575
+ * always named in the copy, so the mark never carries its own accessible name.
576
+ */
577
+ formatIcon?: React.ReactNode;
578
+ /**
579
+ * The strip UNDER the plaque — a format switcher, a figure strip or progress. It sits
580
+ * outside the Promo Surface fill: page chrome, not plaque chrome (`regions.sub.note`),
581
+ * so it does not inherit the plaque ink. Off unless the page opts in.
582
+ */
583
+ sub?: React.ReactNode;
584
+ /** The plaque tone. Defaults to `brand`. */
585
+ surface?: HeroSurface;
586
+ className?: string;
587
+ }
588
+
589
+ /**
590
+ * The lead under the heading, in one of two mutually exclusive forms — a union rather than
591
+ * two loose optionals, so the compiler rejects passing both instead of the component having
592
+ * to pick a winner at runtime. Same device, and same reason, as the `visual` / `image` pair.
593
+ *
594
+ * `body` is the normal one: a node, rendered inside the component's own `<p>`.
595
+ *
596
+ * `bodyHtml` exists for ONE case — a lead that arrives as rich text from a CMS. Such a CMS wraps
597
+ * every `perex` in its own `<p>`, and a `<p>` inside a `<p>` is not merely invalid: the HTML
598
+ * parser splits it into siblings, so on a server-rendered page (`renderToString` on the
599
+ * server, `hydrateRoot` on the client) the parsed tree stops matching what React expects and
600
+ * the whole SSR tree is thrown away and repainted. This arm therefore renders a `<div>` — the
601
+ * CMS supplies the paragraph semantics itself, one level in.
602
+ *
603
+ * `<p>` is NOT a contract here, which is what makes this legal: `delivery.react` is the one
604
+ * place the manifest names elements and it names `<h1>` for the heading and `<img>` for the
605
+ * image — `body` is absent from it, `text.body` records only overflow and length, and
606
+ * `typography.runs.body` calls the lead a "paragraph" as a TYPOGRAPHIC reading (it is
607
+ * justifying Body/XL over Body/L), not as markup.
608
+ *
609
+ * `bodyHtml?: undefined` on the other arm, NOT `bodyHtml?: never` — for the reason already
610
+ * written out on `image` below.
611
+ */
612
+ type HeroBodyProps =
613
+ | { body?: React.ReactNode; bodyHtml?: undefined }
614
+ /**
615
+ * TRUSTED, EDITORIAL HTML ONLY. This is the only `dangerouslySetInnerHTML` in the design
616
+ * system, and it stays that way on purpose: the string must come from a CMS the team
617
+ * controls, never from anything a visitor can write, and sanitising it is the caller's job
618
+ * — Hero cannot tell the two apart.
619
+ *
620
+ * `text.body` still holds: one lead paragraph, 3 lines / ~120 characters. Tailwind's
621
+ * preflight zeroes `<p>` margins, so two paragraphs would run together — the component
622
+ * deliberately adds no spacing for that, because the spec does not expect a second one.
623
+ */
624
+ | { bodyHtml: string; body?: undefined };
625
+
626
+ /**
627
+ * `visual` has NO default. Visual=Off is not "Visual=On without an image", it is a
628
+ * different composition (`intent.rules[1]`), so the page has to choose.
629
+ *
630
+ * The `image` node is the consumer's own `<img>` or visual component, which means the
631
+ * ALT TEXT is the consumer's responsibility — and it is required: give it real alt text
632
+ * describing the page claim, not `alt=""` and not the file name. Hero cannot supply it,
633
+ * hence no `imageAlt` prop.
634
+ */
635
+ export type HeroProps = HeroBase &
636
+ (
637
+ | { visual: 'on'; image: React.ReactNode }
638
+ // `image?: undefined`, NOT `image?: never`. Both forbid passing a node on the Off
639
+ // arm, which is the contract that matters, but `never` also rejects an explicit
640
+ // `image={undefined}` — so a caller that spreads a shared prop bag, and every
641
+ // Storybook story that overrides the meta-level `image`, could not turn the image
642
+ // off without a cast. Caught by `tsc` on the CentredNoVisual story.
643
+ | { visual: 'off'; image?: undefined }
644
+ ) &
645
+ HeroBodyProps;
646
+
647
+ const Hero = React.forwardRef<HTMLElement, HeroProps>((props, ref) => {
648
+ // Annotating the binding pattern instead of casting: every arm of both unions is
649
+ // assignable to this shape (`image?: undefined` widens to `image?: React.ReactNode`, and
650
+ // the same for `bodyHtml?: undefined` against `string`), so `image`, `body` and `bodyHtml`
651
+ // can be destructured out of the rest props without an assertion.
652
+ const {
653
+ heading,
654
+ kicker,
655
+ body,
656
+ bodyHtml,
657
+ actions,
658
+ actionsWidth = 'narrow',
659
+ formatIcon,
660
+ sub,
661
+ surface = 'brand',
662
+ visual,
663
+ image,
664
+ className,
665
+ ...rest
666
+ }: HeroBase & {
667
+ visual: 'on' | 'off';
668
+ image?: React.ReactNode;
669
+ body?: React.ReactNode;
670
+ bodyHtml?: string;
671
+ } = props;
672
+
673
+ const slots = heroVariants({ surface, visual, actionsWidth });
674
+
675
+ const rootRef = React.useRef<HTMLElement | null>(null);
676
+ const setRootRef = React.useCallback((node: HTMLElement | null) => {
677
+ rootRef.current = node;
678
+ if (typeof ref === 'function') ref(node);
679
+ else if (ref) ref.current = node;
680
+ }, [ref]);
681
+ const enter = useEnterOnView(rootRef);
682
+ const step = heroEnterSteps({
683
+ kicker: kicker != null,
684
+ heading: true,
685
+ body: bodyHtml != null || body != null,
686
+ actions: actions != null,
687
+ image: visual === 'on',
688
+ });
689
+
690
+ return (
691
+ // A plain <section>, left deliberately UNNAMED: an unnamed section is exposed as
692
+ // generic, while naming it would add a `region` landmark on top of the page's own
693
+ // banner/main structure. The <h1> below already labels this content.
694
+ <section
695
+ ref={setRootRef}
696
+ data-fods-component="hero"
697
+ data-fods-part="root"
698
+ className={cn(slots.root(), className)}
699
+ {...rest}
700
+ // After the rest props, so a consumer cannot shadow the entrance state by accident.
701
+ data-hero-motion={enter === 'static' ? undefined : enter}
702
+ >
703
+ <div data-fods-part="panel" className={slots.panel()}>
704
+ {visual === 'off' ? (
705
+ /*
706
+ * Visual=Off is a SINGLE surface instance: regions.panel.note pins
707
+ * Layout=Vertical to *every* Visual=Off variant, so there is nothing
708
+ * breakpoint-dependent left to switch.
709
+ */
710
+ <PromoSurface layout="vertical" surface={surface} className="absolute inset-0" />
711
+ ) : (
712
+ /*
713
+ * Visual=On needs TWO instances, swapped by visibility at the `lg` boundary.
714
+ *
715
+ * Why not one: regions.panel.note pins Layout=Side at XL/LG and Layout=Top at
716
+ * MD/SM/Mobile, but PromoSurface takes `layout` as a PROP and turns it into
717
+ * inline custom properties (`--promo-veil-*`) for the veil geometry. An inline
718
+ * style cannot carry a media query, so a single instance can never be
719
+ * responsive — the layout has to be chosen in CSS, i.e. by rendering both and
720
+ * hiding one.
721
+ *
722
+ * Why `lg` (>=1024): Side covers XL+LG, Top covers MD/SM/Mobile, and `lg` is
723
+ * exactly that seam.
724
+ *
725
+ * Why it matters: the wrong Layout puts the decorative pattern UNDER the
726
+ * headline instead of clearing it (intent.rules[4]) — the single failure the
727
+ * veil exists to prevent.
728
+ */
729
+ <>
730
+ <PromoSurface
731
+ layout="top"
732
+ surface={surface}
733
+ className="absolute inset-0 lg:hidden"
734
+ />
735
+ <PromoSurface
736
+ layout="side"
737
+ surface={surface}
738
+ className="absolute inset-0 hidden lg:block"
739
+ />
740
+ </>
741
+ )}
742
+
743
+ <div data-fods-part="text-column" className={slots.textColumn()}>
744
+ {formatIcon != null && (
745
+ <span
746
+ aria-hidden="true"
747
+ data-fods-part="format-icon"
748
+ className={slots.formatIcon()}
749
+ >
750
+ {formatIcon}
751
+ </span>
752
+ )}
753
+ <div data-fods-part="copy" className={slots.copy()}>
754
+ <div data-fods-part="title-group" className={slots.titleGroup()}>
755
+ {kicker != null && (
756
+ <p data-fods-part="kicker" className={cn(slots.kicker(), step.kicker)}>
757
+ {kicker}
758
+ </p>
759
+ )}
760
+ <h1 data-fods-part="heading" className={cn(slots.heading(), step.heading)}>
761
+ {heading}
762
+ </h1>
763
+ </div>
764
+ {/*
765
+ One part, two elements. `bodyHtml` takes the `<div>` because CMS rich text
766
+ brings its own `<p>` — see HeroBodyProps for why that cannot nest. Both carry
767
+ the SAME `data-fods-part` and the SAME recipe slot, so the parts map, the
768
+ S7c/d markup pairing and every typography assertion keep measuring one thing.
769
+ */}
770
+ {bodyHtml != null ? (
771
+ <div
772
+ data-fods-part="body"
773
+ className={cn(slots.body(), step.body)}
774
+ dangerouslySetInnerHTML={{ __html: bodyHtml }}
775
+ />
776
+ ) : body != null ? (
777
+ <p data-fods-part="body" className={cn(slots.body(), step.body)}>
778
+ {body}
779
+ </p>
780
+ ) : null}
781
+ </div>
782
+ {actions != null && (
783
+ <div data-fods-part="actions" className={cn(slots.actions(), step.actions)}>
784
+ {actions}
785
+ </div>
786
+ )}
787
+ </div>
788
+
789
+ {/* regions.image: absent entirely at Visual=Off — not hidden, not an empty slot. */}
790
+ {visual === 'on' && (
791
+ <div data-fods-part="image" className={cn(slots.image(), step.image)}>
792
+ {image}
793
+ </div>
794
+ )}
795
+ </div>
796
+
797
+ {sub != null && (
798
+ <div data-fods-part="sub" className={slots.sub()}>
799
+ {sub}
800
+ </div>
801
+ )}
802
+ </section>
803
+ );
804
+ });
805
+ Hero.displayName = 'Hero';
806
+
807
+ export { Hero, heroVariants };