@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,602 @@
1
+ "use client";
2
+
3
+ import * as React from 'react';
4
+ import { tv } from '../../internal/tailwind-variants';
5
+ import { cn } from '../../internal/utils';
6
+ import { Button } from '../button/Button';
7
+ import { Heading, type HeadingLevel } from '../heading/Heading';
8
+ import { PromoSurface } from '../promo-surface/PromoSurface';
9
+ import { Icon, type IconName } from '../icon/Icon';
10
+
11
+ /**
12
+ * Banner — a promotional panel for public pages (`banner.manifest.json`, Web layer
13
+ * `spec/07-web/`, v3.0.0, `kind: "region"`).
14
+ *
15
+ * Three artwork-and-layout recipes, closed set (`intent.rules[0]`): Person, Invoice and
16
+ * Mini. The actions are NOT a variant — they are the one Actions slot (`slots.actions`),
17
+ * passed as `children`. Content that fits none of the recipes is a Hero.
18
+ *
19
+ * ## Structure (`delivery.react`)
20
+ *
21
+ * `<section>` (24 above and below, `container.note`) → plaque (`relative rounded-800`) →
22
+ * the Promo Surface as an absolutely positioned SIBLING layer (never a wrapper), then the
23
+ * visual (Person / Invoice only), then the text column. Paint order is tree order, so
24
+ * the text column lands on top of the visual and the visual on top of the surface — no
25
+ * z-index.
26
+ *
27
+ * ## What is NOT Banner's
28
+ *
29
+ * The outer frame's width ladder, side gutter (16/24/32/40/40) and the marketing
30
+ * container cap are the PAGE container (`container.note`, spec/07-web → Page frame); the
31
+ * plaque fills whatever container it is dropped into and has no max-width of its own.
32
+ * Storybook models the container with a decorator.
33
+ *
34
+ * ## Artwork is the app's (2.2.0, `delivery.react`)
35
+ *
36
+ * The package ships no picture. Person takes `character` (`slots.character`), Person and
37
+ * Invoice take `invoiceIllustration` `{ left, right }` (`slots.invoice-illustration`),
38
+ * each a React element — an `<img alt="">` of the app's own asset. Mini takes neither;
39
+ * the props union rejects them there. Banner owns only the boxes, their positions and
40
+ * the clipping of `regions.visual`, and the whole visual layer is `aria-hidden`.
41
+ *
42
+ * ## Actions slot
43
+ *
44
+ * Accepts Button, Text Link, Text Field and Subject Lookup Field, one or two of them
45
+ * (`intent.rules[6]`). `BannerAction` is the default content — the Brand link button
46
+ * sized per Composition × Breakpoint. A field + submit pair passes `actionsForm` so the
47
+ * slot renders as a `<form>` and Enter in the field submits (spec Accessibility).
48
+ *
49
+ * ## Breakpoint is not a prop
50
+ *
51
+ * `properties[Breakpoint].maps`: the five steps are the responsive ladder, pure CSS.
52
+ * Mobile = unprefixed, SM = `sm:`, MD = `md:`, LG = `lg:`, XL = `xl:`.
53
+ *
54
+ * ## No states
55
+ *
56
+ * `intent.states`: the shell is non-interactive. The controls in the slot own every
57
+ * hover / active / focus-visible / disabled state. The one thing Banner overrides is the
58
+ * focus-ring COLOUR of every slotted control on Surface=Solid (`intent.rules[5]`).
59
+ */
60
+
61
+ /*
62
+ * Every raw px below is an authored Figma artwork / composition measurement with no
63
+ * --space token (component set 7355:3105), each under its own fods-lint suppression.
64
+ * They are written inline in the recipe, not in a shared constant, because
65
+ * a static check of the tv() literal cannot follow a reference.
66
+ */
67
+ const bannerVariants = tv({
68
+ slots: {
69
+ // A plain section, no fill: --bg-primary is the page canvas (container.fill). 2.1.0:
70
+ // the section carries the Web block band itself — --space-800 above and below at
71
+ // every step, a deliberate exception to the page's recommended P (container.note).
72
+ root: 'w-full py-800',
73
+ panel: [
74
+ // `relative` so the absolute surface and visual resolve against the plaque.
75
+ // No overflow-hidden, ever: intent.rules[3] — "The panel itself never clips."
76
+ 'relative flex rounded-800',
77
+ ],
78
+ textColumn: [
79
+ // `relative` so the in-flow column paints above the absolute siblings before it.
80
+ 'relative flex flex-col',
81
+ // regions.text-column.note: copy -> actions.
82
+ 'gap-800',
83
+ ],
84
+ copy: [
85
+ 'flex w-full flex-col',
86
+ // regions.text-column.note: heading -> body (Heading Group D2 ladder).
87
+ 'gap-600',
88
+ ],
89
+ // Typography is the Heading atom's (`d2`, Mini `d3`); only the per-surface ink lives here.
90
+ heading: '',
91
+ body: [
92
+ // typography.runs.body: Body/XL, 20 at every breakpoint (promo-plaque carve-out).
93
+ 'font-inter text-body-xl',
94
+ '[text-wrap:var(--text-wrap-body)]',
95
+ ],
96
+ /*
97
+ * regions.actions: one wrapping row at gap --space-400 (the adjacent-target minimum),
98
+ * a full-width column at Mobile (and at SM on Mini). The row direction is per
99
+ * Composition below.
100
+ */
101
+ actions: [
102
+ 'flex w-full flex-col gap-400',
103
+ // A field (any child that is not a button or a link) takes the room the button
104
+ // leaves it; flex-basis 0 so it never wraps the button onto a second line.
105
+ 'sm:[&>:not(a,button)]:min-w-0 sm:[&>:not(a,button)]:flex-1',
106
+ // slots.actions FIELD + BUTTON: no Button size is 48 (gaps[4]), so beside a field
107
+ // the submit button is stretched to Text Field md's 48. Stacked it keeps its 44.
108
+ 'sm:has-[input]:[&>button]:min-h-1100',
109
+ // slots.actions TEXT LINK TARGET: the hit area is padded to the 44 floor, in-flow
110
+ // so it never overlaps the neighbouring button; the visual stays the link's.
111
+ '[&>[data-fods-component=text-link]]:inline-flex [&>[data-fods-component=text-link]]:items-center [&>[data-fods-component=text-link]]:justify-center',
112
+ // fods-lint-disable-next-line 44px target floor for a Text Link in the slot (slots.actions TEXT LINK TARGET, Button lg height); no --space token
113
+ '[&>[data-fods-component=text-link]]:min-h-[44px]',
114
+ ],
115
+ /*
116
+ * BannerAction — the slot's default content: one Brand link button. Button has one
117
+ * size per instance, so the action renders one instance per size band and CSS shows
118
+ * exactly one — Button stays the only owner of both geometries, and `display: none`
119
+ * keeps the hidden twin out of the tab order and the accessibility tree. SSR-safe,
120
+ * no viewport hook. `pl-*` restates Button's leading-icon padding (its `hasLeading`
121
+ * compound), which the asChild branch cannot derive. `max-w-full` bounds the label
122
+ * at 320px reflow.
123
+ */
124
+ action: 'max-w-full',
125
+ /*
126
+ * 1.8.0: a label wrapped to two lines gets --space-400 above and below (54 -> 70);
127
+ * a one-line button stays 44. No CSS selector can tell a wrapped label from a
128
+ * one-line one, so the padding is unconditional and Button's 44 min-height does the
129
+ * switching: one line is 27 + 2 x 7 + 2 x 1 border = 43, under the floor, so the
130
+ * button stays 44; two lines are 54 + 14 + 2 = 70. The 1px border is subtracted
131
+ * because Figma's inside stroke sits within the 8 while a CSS border adds to it.
132
+ */
133
+ actionMobile: 'w-full pl-500 py-[calc(var(--space-400)-var(--border-width-100))] sm:hidden',
134
+ actionDesktop: 'hidden pl-600 sm:inline-flex',
135
+ // 1.7.0: at Mobile the label wraps to at most two lines and the button grows,
136
+ // overriding Button's single-line text.label; from SM it truncates on one line.
137
+ actionLabelMobile: 'min-w-0 line-clamp-2 whitespace-normal',
138
+ actionLabelDesktop: 'min-w-0 truncate',
139
+ visual: '',
140
+ artwork: [
141
+ 'absolute inset-0',
142
+ // Beside the copy the artwork starts 40 (LG) / 24 (XL) INSIDE the text column.
143
+ 'lg:-left-1000 xl:-left-800',
144
+ // Person artwork clips at the plaque's bottom edge ONLY (intent.rules[3]): it
145
+ // overhangs the top and the sides uncropped. A clip-path inset with negative
146
+ // top/sides is the one primitive that cuts a single edge.
147
+ '[clip-path:inset(-100%_-100%_0)]',
148
+ ],
149
+ invoice: [
150
+ // Two sheets as tall as this box, pinned to its opposite edges, so they spread
151
+ // apart as the box widens (regions.visual.note: Sheet·Left MIN, Sheet·Right MAX).
152
+ 'absolute inset-x-0',
153
+ // Authored 24 taller than its band and run past the bottom edge, where the band
154
+ // clips it — "sliding under the plaque's lower rim".
155
+ '-bottom-800 h-[calc(100%+var(--space-800))]',
156
+ ],
157
+ // Each sheet is sized by height only: the app's picture (`invoiceIllustration`)
158
+ // fills the box's height and its own ratio gives the width, so the box hugs it.
159
+ invoiceSheetLeft: 'absolute inset-y-0 left-0 h-full w-auto max-w-none *:block *:h-full *:w-auto *:max-w-none',
160
+ invoiceSheetRight: 'absolute inset-y-0 right-0 h-full w-auto max-w-none *:block *:h-full *:w-auto *:max-w-none',
161
+ // Person only. Bottom-anchored; the app's picture (`character`) is already cropped
162
+ // like the Figma mask, so it fills the box's width and its own ratio gives the
163
+ // height. Box 332 centred while stacked, 362 at x=32 (LG), 310 at x=114 (XL) inside
164
+ // the artwork box.
165
+ character: [
166
+ 'absolute bottom-0 h-auto max-w-none *:block *:h-auto *:w-full *:max-w-none',
167
+ 'left-1/2 -translate-x-1/2 lg:left-900 lg:translate-x-0',
168
+ // Capped at the band so a sub-332 viewport scales the character instead of
169
+ // scrolling the page sideways; every authored width is wider than the box.
170
+ // fods-lint-disable-next-line authored character box 332px (Figma Person MD/SM/Mobile); artwork geometry, no --space token
171
+ 'w-[min(332px,100%)]',
172
+ // fods-lint-disable-next-line authored character box 362px (Figma Person LG); artwork geometry, no --space token
173
+ 'lg:w-[min(362px,100%)]',
174
+ // fods-lint-disable-next-line authored character box 310px (Figma Person XL); artwork geometry, no --space token
175
+ 'xl:w-[min(310px,100%)]',
176
+ // fods-lint-disable-next-line authored XL character offset 114px inside the artwork box (Figma Person XL); artwork geometry, no --space token
177
+ 'xl:left-[114px]',
178
+ ],
179
+ },
180
+ variants: {
181
+ composition: {
182
+ person: {
183
+ // Copy above the visual while stacked, beside it (left) from LG. `-reverse`
184
+ // because the visual precedes the text column in the tree (paint order).
185
+ panel: 'flex-col-reverse lg:flex-row-reverse',
186
+ textColumn: [
187
+ // regions.text-column.align: centred at MD/SM/Mobile, left at XL/LG.
188
+ 'items-center text-center lg:items-start lg:text-left',
189
+ // Mobile 24 × 40, SM 40 × 48, MD/LG/XL 48 all round.
190
+ 'px-800 py-1000 sm:px-1000 sm:py-1100 md:p-1100',
191
+ // Side-by-side split authored as XL 648 + 552, LG 520 + 424, as a basis on
192
+ // BOTH children so the plaque (2.1.0: 1190 / 880, the block content) shares
193
+ // the deficit proportionally (Hero's `visual.on` split explains why flex-1 on
194
+ // one side is wrong).
195
+ 'lg:shrink lg:grow-0',
196
+ // fods-lint-disable-next-line authored LG text-column width 520 (Figma Person LG split); composition measure, no --space token
197
+ 'lg:basis-[520px]',
198
+ // fods-lint-disable-next-line authored XL text-column width 648 (Figma Person XL split); composition measure, no --space token
199
+ 'xl:basis-[648px]',
200
+ ],
201
+ // regions.actions.align: centred at MD/SM/Mobile, left at XL/LG.
202
+ actions: 'sm:flex-row sm:flex-wrap sm:justify-center lg:justify-start',
203
+ visual: [
204
+ 'relative',
205
+ // Stacked: an in-flow band bleeding past the plaque by the gutter on both
206
+ // sides (16 / 24 / 32), so the artwork overhangs the plaque's sides.
207
+ '-mx-600 sm:-mx-800 md:-mx-900 lg:mx-0',
208
+ // fods-lint-disable-next-line authored 324px Person visual band height (Figma MD/SM/Mobile); artwork geometry, no --space token
209
+ 'h-[324px]',
210
+ // Beside the copy: stretched to the plaque height, which the text column
211
+ // alone sets (everything inside is absolute).
212
+ 'lg:h-auto lg:min-w-0 lg:shrink lg:grow',
213
+ // fods-lint-disable-next-line authored LG visual width 424 (Figma Person LG split); composition measure, no --space token
214
+ 'lg:basis-[424px]',
215
+ // fods-lint-disable-next-line authored XL visual width 552 (Figma Person XL split); composition measure, no --space token
216
+ 'xl:basis-[552px]',
217
+ ],
218
+ // Beside the copy the invoice graphic is authored 464×356 (LG) / 576×328 (XL);
219
+ // stacked it follows the shared band + 24 recipe.
220
+ invoice: [
221
+ // fods-lint-disable-next-line authored LG invoice graphic height 356 (Figma Person LG); artwork geometry, no --space token
222
+ 'lg:h-[356px]',
223
+ // fods-lint-disable-next-line authored XL invoice graphic height 328 (Figma Person XL); artwork geometry, no --space token
224
+ 'xl:h-[328px]',
225
+ ],
226
+ },
227
+ invoice: {
228
+ // Copy centred in the plaque at every breakpoint (Promo Surface Layout=Vertical).
229
+ // Below LG the plaque adds 80 above and below on top of the column's own 80
230
+ // (copy starts 160 from the top edge); from LG the column carries 48 alone.
231
+ panel: 'flex-col items-center py-1300 lg:py-0',
232
+ textColumn: [
233
+ 'w-full items-center text-center',
234
+ // The 580 measure — the system's --ds-content-narrow.
235
+ 'max-w-content-narrow',
236
+ 'px-800 py-1300 lg:py-1100',
237
+ ],
238
+ actions: 'sm:flex-row sm:flex-wrap sm:justify-center',
239
+ // 1.8.0 (regions.visual.note): the sheets keep their authored size at every
240
+ // breakpoint. Below LG the band is a fixed authored height, so band + 24 is a
241
+ // constant already; from LG the band follows the plaque, so the graphic is
242
+ // pinned to its authored height (plaque 280 + 24 above + 24 run-past) and a
243
+ // taller plaque only moves it down with the bottom edge.
244
+ // fods-lint-disable-next-line authored 328px Invoice invoice graphic height (Figma LG/XL); artwork geometry, no --space token
245
+ invoice: 'lg:h-[328px]',
246
+ visual: [
247
+ // An ABSOLUTE band inside the plaque, inset past it by the breakpoint's gutter
248
+ // (-16 / -24 / -32 / -40 / -40), bottom flush, clipped (regions.visual.note).
249
+ 'absolute bottom-0 overflow-hidden',
250
+ '-inset-x-600 sm:-inset-x-800 md:-inset-x-900 lg:-inset-x-1000',
251
+ // fods-lint-disable-next-line authored 142px Invoice band height (Figma Mobile); artwork geometry, no --space token
252
+ 'h-[142px]',
253
+ // fods-lint-disable-next-line authored 195px Invoice band height (Figma SM); artwork geometry, no --space token
254
+ 'sm:h-[195px]',
255
+ // fods-lint-disable-next-line authored 215px Invoice band height (Figma MD); artwork geometry, no --space token
256
+ 'md:h-[215px]',
257
+ // LG/XL: the band spans the plaque and 24 above it.
258
+ 'lg:-top-800 lg:h-auto',
259
+ ],
260
+ },
261
+ /*
262
+ * Mini (2.0.0, regions.text-column.note): no copy frame, no body, no visual. At
263
+ * XL / LG / MD the heading (FILL) and the slot (HUG) share one counter-axis-centred
264
+ * row, gap --space-800, plaque padding --space-900 (Layout=Side); at SM / Mobile
265
+ * they stack heading-first, gap --space-600, padding --space-800, left-aligned,
266
+ * the slot full width (Layout=Top).
267
+ */
268
+ mini: {
269
+ panel: 'flex-col',
270
+ textColumn: [
271
+ 'w-full items-stretch text-left',
272
+ 'gap-600 p-800',
273
+ 'md:flex-row md:items-center md:gap-800 md:p-900',
274
+ ],
275
+ heading: 'min-w-0 md:flex-1',
276
+ actions: 'md:w-auto md:shrink-0 md:flex-row md:flex-wrap md:justify-end',
277
+ // Mini's action is lg at every step, so its leading-icon padding is lg's too.
278
+ actionDesktop: 'pl-500',
279
+ },
280
+ },
281
+ /*
282
+ * Surface picks the plaque AND the ink together (intent.rules[1]). The heading ink
283
+ * is set on the part itself because the Heading atom binds --text-primary in its
284
+ * own base; the body ink on Brand is --secondary-tint-foreground (changelog
285
+ * 2026-08-23).
286
+ *
287
+ * Solid: --outline-focus is the same hex as --secondary-solid, so Banner swaps the
288
+ * ring colour of EVERY control in the Actions slot to --outline-focus-inverse
289
+ * (intent.rules[5], focus.note, chrome.focus-ring). The container owns the swap,
290
+ * never the atom, so it is written as descendant rules on the slot:
291
+ * - buttons and links keep their own outline geometry; only the colour changes.
292
+ * `:is(a,button)` adds one element to the specificity, so the swap beats the
293
+ * atom's own `focus-visible:outline-outline-focus` regardless of CSS order.
294
+ * - a field's own focus is a border swap to --outline-focus, invisible on this
295
+ * plaque, so its shell — the element whose direct child is the input — gets the
296
+ * offset ring Button draws, following the shell's own --radius-400.
297
+ */
298
+ surface: {
299
+ brand: {
300
+ panel: 'text-text-primary',
301
+ heading: 'text-text-primary',
302
+ body: 'text-secondary-tint-foreground',
303
+ },
304
+ solid: {
305
+ panel: 'text-text-inverted',
306
+ heading: 'text-text-inverted',
307
+ body: 'text-text-inverted',
308
+ actions: [
309
+ '[&_:is(a,button):focus-visible]:outline-outline-focus-inverse',
310
+ '[&_:has(>input:focus-visible)]:outline [&_:has(>input:focus-visible)]:outline-200',
311
+ '[&_:has(>input:focus-visible)]:outline-offset-2 [&_:has(>input:focus-visible)]:outline-outline-focus-inverse',
312
+ ],
313
+ },
314
+ },
315
+ },
316
+ defaultVariants: {
317
+ composition: 'person',
318
+ surface: 'brand',
319
+ },
320
+ });
321
+
322
+ /** `properties[Composition].maps` — `person` · `invoice` · `mini`. */
323
+ export type BannerComposition = 'person' | 'invoice' | 'mini';
324
+ /** Passed straight through to `<PromoSurface surface>` — same spelling (`properties[Surface]`). */
325
+ export type BannerSurface = 'brand' | 'solid';
326
+
327
+ interface BannerCommon extends Omit<React.HTMLAttributes<HTMLElement>, 'children'> {
328
+ /** Plaque tone + ink. Defaults to `brand`. */
329
+ surface?: BannerSurface;
330
+ /**
331
+ * The panel's single claim — one sentence, no full stop, ~48 characters
332
+ * (`text.heading`, Mini `text.mini-heading`).
333
+ */
334
+ heading: string;
335
+ /**
336
+ * Required: the page decides (spec Accessibility) — `1` where Banner IS the first
337
+ * screen, a lower level everywhere else; inside an article Mini sits one level below
338
+ * the current section heading. Never derived from the Display size.
339
+ */
340
+ headingLevel: HeadingLevel;
341
+ /**
342
+ * The Actions slot (`slots.actions`): one or two controls from the accepted set —
343
+ * Button, Text Link, Text Field, Subject Lookup Field. `<BannerAction>` is the
344
+ * default content. On `surface="solid"` only one Brand Button or a field with its
345
+ * submit button (`intent.rules[6]`).
346
+ */
347
+ children: React.ReactNode;
348
+ /**
349
+ * Renders the Actions slot as a `<form>` with these attributes — for a field + submit
350
+ * pair, so Enter in the field performs the button's action (spec Accessibility).
351
+ */
352
+ actionsForm?: Omit<React.FormHTMLAttributes<HTMLFormElement>, 'className' | 'children'>;
353
+ className?: string;
354
+ }
355
+
356
+ /**
357
+ * The two invoice sheets of the visual (`slots.invoice-illustration`), each an element
358
+ * the app supplies — an `<img alt="">` of its own asset. The component pins `left` to
359
+ * the band's start edge and `right` to its end edge and sizes both by height.
360
+ */
361
+ export interface BannerInvoiceIllustration {
362
+ left: React.ReactElement;
363
+ right: React.ReactElement;
364
+ }
365
+
366
+ interface BannerPitchCommon extends BannerCommon {
367
+ /**
368
+ * The optional detail line (Figma `Show body` + `Body text`). Absent or empty renders
369
+ * no line. On `surface="solid"` it ships a known 4.45:1 run (spec Accessibility).
370
+ */
371
+ detail?: string;
372
+ /**
373
+ * The invoice sheets (`slots.invoice-illustration`). The package ships no picture:
374
+ * pass the app's own (`{ left: <img src={sheetLeft} alt="" />, right: … }`). The
375
+ * visual layer is `aria-hidden` — the copy carries the message.
376
+ */
377
+ invoiceIllustration: BannerInvoiceIllustration;
378
+ }
379
+
380
+ /** Person (the default composition): heading, optional detail line, actions, character + invoice sheets. */
381
+ export interface BannerPersonProps extends BannerPitchCommon {
382
+ composition?: 'person';
383
+ /**
384
+ * The character (`slots.character`), an element the app supplies — e.g.
385
+ * `<img src={bartender} alt="" />`. Sized by width; its own ratio gives the height.
386
+ */
387
+ character: React.ReactElement;
388
+ }
389
+
390
+ /** Invoice: heading, optional detail line, actions, invoice sheets — no character. */
391
+ export interface BannerInvoiceProps extends BannerPitchCommon {
392
+ composition: 'invoice';
393
+ /** Invoice has no character (`slots.character` is Person only). */
394
+ character?: never;
395
+ }
396
+
397
+ /** Person and Invoice — the compositions with a visual. */
398
+ export type BannerPitchProps = BannerPersonProps | BannerInvoiceProps;
399
+
400
+ /** Mini: a short Display/D3 heading with the actions beside it — no detail line, no artwork. */
401
+ export interface BannerMiniProps extends BannerCommon {
402
+ composition: 'mini';
403
+ /** Mini has no body run (`properties[Body text].maps`). */
404
+ detail?: undefined;
405
+ /** Mini renders no visual layer. */
406
+ character?: never;
407
+ /** Mini renders no visual layer. */
408
+ invoiceIllustration?: never;
409
+ }
410
+
411
+ export type BannerProps = BannerPersonProps | BannerInvoiceProps | BannerMiniProps;
412
+
413
+ const BannerCompositionContext = React.createContext<BannerComposition>('person');
414
+
415
+ /**
416
+ * Action size per size band (`slots.actions.default`): Person and Invoice lg at Mobile,
417
+ * xl from SM; Mini lg at every breakpoint.
418
+ */
419
+ const ACTION_SIZES: Record<BannerComposition, { mobile: 'lg'; desktop: 'lg' | 'xl' }> = {
420
+ person: { mobile: 'lg', desktop: 'xl' },
421
+ invoice: { mobile: 'lg', desktop: 'xl' },
422
+ mini: { mobile: 'lg', desktop: 'lg' },
423
+ };
424
+
425
+ export interface BannerActionProps {
426
+ href: string;
427
+ /** The action label — Button's maxChars 24 (`slots.actions`). */
428
+ children: string;
429
+ /** Leading icon. Defaults to `invoice-new` (`slots.actions.default`). */
430
+ icon?: IconName;
431
+ }
432
+
433
+ /**
434
+ * The Actions slot's default content: one Brand link button with a leading icon, sized
435
+ * by the enclosing Banner's Composition. Use it inside `<Banner>` only.
436
+ */
437
+ const BannerAction = ({ href, children, icon = 'invoice-new' }: BannerActionProps) => {
438
+ const composition = React.useContext(BannerCompositionContext);
439
+ const slots = bannerVariants({ composition });
440
+ const sizes = ACTION_SIZES[composition];
441
+
442
+ const instances = [
443
+ { size: sizes.mobile, button: slots.actionMobile(), label: slots.actionLabelMobile() },
444
+ { size: sizes.desktop, button: slots.actionDesktop(), label: slots.actionLabelDesktop() },
445
+ ];
446
+
447
+ return (
448
+ <>
449
+ {instances.map(({ size, button, label }, index) => (
450
+ <Button
451
+ key={index}
452
+ variant="brand"
453
+ size={size}
454
+ asChild
455
+ data-fods-part="action"
456
+ className={cn(slots.action(), button)}
457
+ >
458
+ <a href={href}>
459
+ <Icon name={icon} />
460
+ {/* The native branch's label span: asChild keeps children untouched,
461
+ so the label contract has to be restated here. */}
462
+ <span className={label}>{children}</span>
463
+ </a>
464
+ </Button>
465
+ ))}
466
+ </>
467
+ );
468
+ };
469
+ BannerAction.displayName = 'BannerAction';
470
+
471
+ const Banner = React.forwardRef<HTMLElement, BannerProps>((props, ref) => {
472
+ const {
473
+ composition = 'person',
474
+ surface = 'brand',
475
+ heading,
476
+ headingLevel,
477
+ detail,
478
+ character,
479
+ invoiceIllustration,
480
+ children,
481
+ actionsForm,
482
+ className,
483
+ ...rest
484
+ } = props;
485
+
486
+ const slots = bannerVariants({ composition, surface });
487
+ const isMini = composition === 'mini';
488
+ // `??` would let an empty string through and render an empty paragraph.
489
+ const hasDetail = !isMini && detail != null && detail.trim() !== '';
490
+
491
+ const invoice = (
492
+ <div data-fods-part="invoice" className={slots.invoice()}>
493
+ <div data-fods-part="invoice-sheet-left" className={slots.invoiceSheetLeft()}>
494
+ {invoiceIllustration?.left}
495
+ </div>
496
+ <div data-fods-part="invoice-sheet-right" className={slots.invoiceSheetRight()}>
497
+ {invoiceIllustration?.right}
498
+ </div>
499
+ </div>
500
+ );
501
+
502
+ /*
503
+ * The delegated Promo Surface Layout follows where the copy sits (intent.rules[2]).
504
+ * Person and Mini swap two instances — PromoSurface turns `layout` into inline custom
505
+ * properties, which cannot carry a media query (same reason as Hero's Visual=On).
506
+ * Person: Top below LG, Side from LG. Mini: Top below MD, Side from MD.
507
+ * Invoice: one Vertical instance at every breakpoint.
508
+ */
509
+ let surfaceLayer: React.ReactNode;
510
+ if (composition === 'invoice') {
511
+ surfaceLayer = <PromoSurface layout="vertical" surface={surface} className="absolute inset-0" />;
512
+ } else if (isMini) {
513
+ surfaceLayer = (
514
+ <>
515
+ <PromoSurface layout="top" surface={surface} className="absolute inset-0 md:hidden" />
516
+ <PromoSurface layout="side" surface={surface} className="absolute inset-0 hidden md:block" />
517
+ </>
518
+ );
519
+ } else {
520
+ surfaceLayer = (
521
+ <>
522
+ <PromoSurface layout="top" surface={surface} className="absolute inset-0 lg:hidden" />
523
+ <PromoSurface layout="side" surface={surface} className="absolute inset-0 hidden lg:block" />
524
+ </>
525
+ );
526
+ }
527
+
528
+ // typography.runs: Display/D2 on Person and Invoice, Display/D3 on Mini. Two literal
529
+ // branches so each part marker can be read statically.
530
+ const headingNode = isMini ? (
531
+ <Heading level={headingLevel} size="d3" data-fods-part="mini-heading" className={slots.heading()}>
532
+ {heading}
533
+ </Heading>
534
+ ) : (
535
+ <Heading level={headingLevel} size="d2" data-fods-part="heading" className={slots.heading()}>
536
+ {heading}
537
+ </Heading>
538
+ );
539
+
540
+ const actions = actionsForm ? (
541
+ <form {...actionsForm} data-fods-part="actions" className={slots.actions()}>
542
+ {children}
543
+ </form>
544
+ ) : (
545
+ <div data-fods-part="actions" className={slots.actions()}>
546
+ {children}
547
+ </div>
548
+ );
549
+
550
+ return (
551
+ // Unnamed on purpose, like Hero: a named section would add a `region` landmark;
552
+ // the heading already labels the content.
553
+ <section
554
+ ref={ref}
555
+ data-fods-component="banner"
556
+ data-fods-part="root"
557
+ className={cn(slots.root(), className)}
558
+ {...rest}
559
+ >
560
+ <div data-fods-part="panel" className={slots.panel()}>
561
+ {surfaceLayer}
562
+
563
+ {/* Decorative campaign artwork the app supplies — the copy carries the message,
564
+ so the whole layer is aria-hidden. Mini has none. */}
565
+ {!isMini && (
566
+ <div aria-hidden="true" data-fods-part="visual" className={slots.visual()}>
567
+ {composition === 'person' ? (
568
+ <div data-fods-part="artwork" className={slots.artwork()}>
569
+ {invoice}
570
+ <div data-fods-part="character" className={slots.character()}>
571
+ {character}
572
+ </div>
573
+ </div>
574
+ ) : (
575
+ invoice
576
+ )}
577
+ </div>
578
+ )}
579
+
580
+ <div data-fods-part="text-column" className={slots.textColumn()}>
581
+ {isMini ? (
582
+ headingNode
583
+ ) : (
584
+ <div data-fods-part="copy" className={slots.copy()}>
585
+ {headingNode}
586
+ {hasDetail && (
587
+ <p data-fods-part="body" className={slots.body()}>
588
+ {detail}
589
+ </p>
590
+ )}
591
+ </div>
592
+ )}
593
+
594
+ <BannerCompositionContext.Provider value={composition}>{actions}</BannerCompositionContext.Provider>
595
+ </div>
596
+ </div>
597
+ </section>
598
+ );
599
+ });
600
+ Banner.displayName = 'Banner';
601
+
602
+ export { Banner, BannerAction, bannerVariants };
@@ -0,0 +1,14 @@
1
+ export {
2
+ Banner,
3
+ BannerAction,
4
+ bannerVariants,
5
+ type BannerProps,
6
+ type BannerPitchProps,
7
+ type BannerPersonProps,
8
+ type BannerInvoiceProps,
9
+ type BannerMiniProps,
10
+ type BannerInvoiceIllustration,
11
+ type BannerActionProps,
12
+ type BannerComposition,
13
+ type BannerSurface,
14
+ } from './Banner';