@invoiceonline/ui-react 0.0.0-stage → 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 +78 -2
  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 +357 -4
  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,204 @@
1
+ import { VariantProps } from "../../internal/tailwind-variants.js";
2
+ import * as React from "react";
3
+ /**
4
+ * PromoSticker — the hand-brushed promo smear (`promo-sticker.manifest.json`, atom,
5
+ * v1.4.2).
6
+ *
7
+ * The brand speaking ON TOP of content: a recommendation marker on a card corner
8
+ * ("Doporučené" on a featured card) or a readiness claim on a marketing
9
+ * surface ("KSeF / integracja"). It clings to the carrier's EDGE, half its body
10
+ * outside, slightly tilted (`intent.whenToUse`). For read-only status inside the
11
+ * content flow the right atom is Badge; for an interactive tag, Chip.
12
+ *
13
+ * `kind: structure` — no interaction, no lifecycle. `intent.states` is explicit: "None
14
+ * — a static, non-interactive marker. No hover/focus/disabled by design; it is never a
15
+ * click target." So this file declares no state prop, no `role`, no `tabIndex` and no
16
+ * hover/focus class. There is nothing to disable, hence no `disabled` prop and no
17
+ * nested control to propagate it to (the whole tree is two-to-three `<span>`s).
18
+ *
19
+ * Motion: none. (`tailwindcss-animate` is not installed in this repo either, so
20
+ * `animate-in` / `fade-in-*` would generate zero CSS.)
21
+ *
22
+ * ROTATION AND OFFSETS BELONG TO THE CONSUMER. `intent.states`: "Tilt is applied by
23
+ * the CONSUMER (component ships at 0°)", and `delivery.react` repeats it: "rotation
24
+ * and corner offsets applied by the consumer via transform". So the component holds no
25
+ * `rotate-*`, no `absolute`, no `inset-*` and no negative offset of its own — the
26
+ * consumer positions it, e.g.
27
+ * `<PromoSticker className="absolute -top-500 -right-400 -rotate-3">`.
28
+ * The tilt itself is OPTIONAL: `intent.rules[1]` sanctions "tilt ±3° default (≤4° max),
29
+ * or 0° — flat is a sanctioned choice the consumer may make, not a missed rotation".
30
+ * The consumer MUST also keep `overflow: visible` on the carrier; where it cannot, the
31
+ * in-flow placement is the fallback — the brush is never clipped (`intent.rules[1]`).
32
+ *
33
+ * Two equally-ranked axes, 4 cells (`intent.variants`):
34
+ * - `layout` — Label (one marker line, Heading/H5 since 1.3.0) / Tile (H1 title + 12px subtitle).
35
+ * - `color` — Promo (brand orange) / Ready (info blue). Chosen by MESSAGE, never by
36
+ * surface (`intent.rules[0]`): Promo = the brand recommends, Ready = a factual readiness
37
+ * claim. Max ONE Promo sticker per screen/region — a composition rule the consumer
38
+ * owns, this atom cannot enforce it.
39
+ *
40
+ * CONTRAST — registered exception, do not "fix" it. White on `--primary-solid` is
41
+ * 2.37:1, below the 4.5:1 text floor. It is an atom-scoped exception in
42
+ * `accessibility.md` → Contrast (owner decision 2026-07-17) granted on the grounds
43
+ * that the sticker is a decorative marker, is never the only carrier of its meaning
44
+ * (see `decorative` below), is never interactive, and never renders a line below 12px
45
+ * or below semibold. Swapping the ink to a darker token would break
46
+ * `chrome.promo.text` and the brand slot the exception exists to license.
47
+ */
48
+ declare const promoStickerVariants: import("tailwind-variants").TVReturnType<{
49
+ layout: {
50
+ label: {
51
+ root: string;
52
+ };
53
+ tile: {
54
+ root: string;
55
+ };
56
+ };
57
+ color: {
58
+ promo: {
59
+ root: string;
60
+ brush: string;
61
+ };
62
+ ready: {
63
+ root: string;
64
+ brush: string;
65
+ };
66
+ };
67
+ }, {
68
+ /**
69
+ * Hug × hug, content centred (`chrome.label.note` / `chrome.tile.note`). `w-fit`
70
+ * is load-bearing: `inline-flex` alone still stretches when the sticker is placed
71
+ * as a grid/flex item, and a stretched root would stretch the brush with it.
72
+ *
73
+ * `relative` is the anchor for the absolutely-positioned brush only — it is NOT
74
+ * placement; see the note about consumer-owned offsets above.
75
+ */
76
+ root: string;
77
+ /**
78
+ * The smear: an absolutely-positioned layer at the BACK of the stack filling the
79
+ * frame (`chrome.brush.note`). It is FIRST in the DOM and the text runs below are
80
+ * `relative`, which is what puts them in front — both layers are positioned with
81
+ * `z-index: auto`, so painting follows document order and no `z-index` is needed.
82
+ * (A static text run would paint in the inline phase, i.e. BEHIND the positioned
83
+ * brush — hence `relative` on every run, not decoration.)
84
+ *
85
+ * The colour is a real `background-color` on this element; the vector only masks
86
+ * it. See `styles/promo-sticker.css` for why it cannot be a `background-image`.
87
+ */
88
+ brush: string;
89
+ /**
90
+ * `chrome.label` / `typography.runs.label` — Heading/H5: Poppins SemiBold at
91
+ * `--font-size-heading-h5`, `--leading-relaxed`.
92
+ *
93
+ * This was built against the measurement while the manifest still said Body/XXS
94
+ * (12px Inter) on a 34px floor; 1.3.0 corrected the manifest to what the set draws,
95
+ * and the three measurements it cites are the ones this deviation was argued from:
96
+ * the master variant resolves Heading/H5 + space/700 + space/500, the desktop
97
+ * instance measures 140 x 48, and the mobile instance measures 127 x 45 — "which
98
+ * only a style that steps at 767 can produce. A fixed 12px run explains none of them."
99
+ *
100
+ * No leading is spelled out: `text-heading-h5` carries Heading/H5's own
101
+ * --leading-relaxed.
102
+ *
103
+ * No `truncate` and no `whitespace-nowrap`: `text.label.overflow` is "wrap" and
104
+ * the note is explicit — "The brush stretches with the string — no truncation".
105
+ *
106
+ * `[text-wrap:var(--text-wrap-heading)]` is the fourth half of the published style:
107
+ * every Heading style binds a text-wrap token (`text-styles.json $textWrapRule`), and
108
+ * Tailwind has no `textWrap` namespace, so the arbitrary property is the only spelling
109
+ * that carries the token. `text-balance` renders the same today and would drop the
110
+ * binding. Same precedent as `Field.tsx` `helperTextVariants` with `--text-wrap-body`.
111
+ */
112
+ label: string;
113
+ /**
114
+ * `typography.runs.title` — Heading/H1: `--font-heading` (Poppins) at
115
+ * `--font-size-heading-h1` (26), `--font-weight-bold`, `--leading-tight`.
116
+ *
117
+ * No leading is spelled out: `text-heading-h1` carries Heading/H1's own
118
+ * --leading-tight, which is the rhythm the −6px gap below is calibrated against.
119
+ *
120
+ * `[text-wrap:var(--text-wrap-heading)]` — see the note on `label` above.
121
+ */
122
+ title: string;
123
+ /**
124
+ * `typography.runs.subtitle` — Body/XXS/Semibold, its OWN run. Since 1.3.0 the Label
125
+ * run is Heading/H5, and `typography.runs.label.note` says so outright: "The Tile
126
+ * subtitle does NOT ride this style — it has its own `subtitle` run".
127
+ *
128
+ * `-mt-300` is `chrome.tile.gap: -6`. The manifest calls the −6px "a
129
+ * component-level fact, not a new token" (`notes[5]`), but −6px is NOT off-grid:
130
+ * `--space-300` IS 6px, so the negative gap maps onto the existing scale and needs
131
+ * no arbitrary value. `notes[5]` means only that no NEW token is being minted.
132
+ *
133
+ * `[text-wrap:var(--text-wrap-body)]` — the Body half of the same rule; see `label`.
134
+ */
135
+ subtitle: string;
136
+ }, undefined, undefined, undefined, undefined>;
137
+ /**
138
+ * Layout — the content axis (`axes.content`, default Label).
139
+ *
140
+ * Recorded under `axes.content` rather than `axes.variant` because the manifest schema
141
+ * has a fixed set of axis keys; `properties[].maps` is what governs the API and it
142
+ * says `layout`. Values are lowercase-kebab — the Figma casing never reaches code.
143
+ */
144
+ export type PromoStickerLayout = 'label' | 'tile';
145
+ /** Color — the family / message axis (`axes.variant`, default Promo). */
146
+ export type PromoStickerColor = 'promo' | 'ready';
147
+ type PromoStickerBase = Omit<React.HTMLAttributes<HTMLSpanElement>, 'role' | 'children' | 'title'> & Pick<VariantProps<typeof promoStickerVariants>, 'color'> & {
148
+ /**
149
+ * The family / message axis (`properties` "Color"). Promo (orange) = the brand
150
+ * recommends or promotes; Ready (info blue) = a factual readiness claim.
151
+ * Picked from the MESSAGE, never from the surface it sits on
152
+ * (`intent.rules[0]`).
153
+ */
154
+ color?: PromoStickerColor;
155
+ /**
156
+ * Whether the sticker's message is already readable in the surrounding text.
157
+ *
158
+ * The spec's `## Accessibility` is conditional, not a blanket `aria-hidden`:
159
+ * "when the message is duplicated by nearby text, render with
160
+ * `aria-hidden="true"`; otherwise give the sticker a visually-hidden text
161
+ * equivalent so the claim is not colour/image-only."
162
+ *
163
+ * - `true` (default) — the marker only restates what the carrier already says
164
+ * (a "Doporučené" corner marker on a card whose copy carries the
165
+ * recommendation). Hiding it stops a screen reader repeating the same word.
166
+ * - `false` — the sticker IS the claim (a marketing "KSeF / integracja" tile,
167
+ * where nothing else on the surface states the readiness). The root is then
168
+ * left OUT of `aria-hidden`, which is all it takes: the title/subtitle/label
169
+ * runs are real text nodes in the DOM, so they are already the accessible
170
+ * text equivalent. Adding a duplicate `sr-only` span on top would make an AT
171
+ * read the claim twice, and the visually-hidden wording in the spec is about
172
+ * the message not being image-only — which real text already satisfies.
173
+ *
174
+ * The default is `true` because the marker placement is the common one and it is
175
+ * the safer failure mode: a duplicated announcement is a defect, a missing one on
176
+ * an already-announced word is not.
177
+ */
178
+ decorative?: boolean;
179
+ };
180
+ /**
181
+ * Label carries its text as `children` — `properties` "Label text" maps to
182
+ * "children (Label layout)". Tile takes `title` + `subtitle` instead, both required:
183
+ * `intent.variants` defines the Tile as "H1 title + 12px subtitle", so a Tile with one
184
+ * run is not a smaller Tile, it is a Label.
185
+ *
186
+ * `?: undefined` on the unused arm, NOT `?: never`. Both forbid passing a node to the
187
+ * wrong arm, which is the contract that matters, but `never` also rejects an explicit
188
+ * `title={undefined}` — so a caller spreading a shared prop bag, or a Storybook story
189
+ * overriding a meta-level arg, could not switch layout without a cast. (This exact
190
+ * shape bit `tsc` on Hero's CentredNoVisual story.)
191
+ */
192
+ export type PromoStickerProps = PromoStickerBase & ({
193
+ layout?: 'label';
194
+ children: React.ReactNode;
195
+ title?: undefined;
196
+ subtitle?: undefined;
197
+ } | {
198
+ layout: 'tile';
199
+ title: React.ReactNode;
200
+ subtitle: React.ReactNode;
201
+ children?: undefined;
202
+ });
203
+ declare const PromoSticker: React.ForwardRefExoticComponent<PromoStickerProps & React.RefAttributes<HTMLSpanElement>>;
204
+ export { PromoSticker, promoStickerVariants };
@@ -0,0 +1,177 @@
1
+ "use client";
2
+ import { tv } from "../../internal/tailwind-variants.js";
3
+ import { cn } from "../../internal/utils.js";
4
+ import * as React from "react";
5
+ import { Fragment, jsx, jsxs } from "react/jsx-runtime";
6
+ // src/components/promo-sticker/PromoSticker.tsx
7
+ /**
8
+ * PromoSticker — the hand-brushed promo smear (`promo-sticker.manifest.json`, atom,
9
+ * v1.4.2).
10
+ *
11
+ * The brand speaking ON TOP of content: a recommendation marker on a card corner
12
+ * ("Doporučené" on a featured card) or a readiness claim on a marketing
13
+ * surface ("KSeF / integracja"). It clings to the carrier's EDGE, half its body
14
+ * outside, slightly tilted (`intent.whenToUse`). For read-only status inside the
15
+ * content flow the right atom is Badge; for an interactive tag, Chip.
16
+ *
17
+ * `kind: structure` — no interaction, no lifecycle. `intent.states` is explicit: "None
18
+ * — a static, non-interactive marker. No hover/focus/disabled by design; it is never a
19
+ * click target." So this file declares no state prop, no `role`, no `tabIndex` and no
20
+ * hover/focus class. There is nothing to disable, hence no `disabled` prop and no
21
+ * nested control to propagate it to (the whole tree is two-to-three `<span>`s).
22
+ *
23
+ * Motion: none. (`tailwindcss-animate` is not installed in this repo either, so
24
+ * `animate-in` / `fade-in-*` would generate zero CSS.)
25
+ *
26
+ * ROTATION AND OFFSETS BELONG TO THE CONSUMER. `intent.states`: "Tilt is applied by
27
+ * the CONSUMER (component ships at 0°)", and `delivery.react` repeats it: "rotation
28
+ * and corner offsets applied by the consumer via transform". So the component holds no
29
+ * `rotate-*`, no `absolute`, no `inset-*` and no negative offset of its own — the
30
+ * consumer positions it, e.g.
31
+ * `<PromoSticker className="absolute -top-500 -right-400 -rotate-3">`.
32
+ * The tilt itself is OPTIONAL: `intent.rules[1]` sanctions "tilt ±3° default (≤4° max),
33
+ * or 0° — flat is a sanctioned choice the consumer may make, not a missed rotation".
34
+ * The consumer MUST also keep `overflow: visible` on the carrier; where it cannot, the
35
+ * in-flow placement is the fallback — the brush is never clipped (`intent.rules[1]`).
36
+ *
37
+ * Two equally-ranked axes, 4 cells (`intent.variants`):
38
+ * - `layout` — Label (one marker line, Heading/H5 since 1.3.0) / Tile (H1 title + 12px subtitle).
39
+ * - `color` — Promo (brand orange) / Ready (info blue). Chosen by MESSAGE, never by
40
+ * surface (`intent.rules[0]`): Promo = the brand recommends, Ready = a factual readiness
41
+ * claim. Max ONE Promo sticker per screen/region — a composition rule the consumer
42
+ * owns, this atom cannot enforce it.
43
+ *
44
+ * CONTRAST — registered exception, do not "fix" it. White on `--primary-solid` is
45
+ * 2.37:1, below the 4.5:1 text floor. It is an atom-scoped exception in
46
+ * `accessibility.md` → Contrast (owner decision 2026-07-17) granted on the grounds
47
+ * that the sticker is a decorative marker, is never the only carrier of its meaning
48
+ * (see `decorative` below), is never interactive, and never renders a line below 12px
49
+ * or below semibold. Swapping the ink to a darker token would break
50
+ * `chrome.promo.text` and the brand slot the exception exists to license.
51
+ */
52
+ const promoStickerVariants = tv({
53
+ slots: {
54
+ /**
55
+ * Hug × hug, content centred (`chrome.label.note` / `chrome.tile.note`). `w-fit`
56
+ * is load-bearing: `inline-flex` alone still stretches when the sticker is placed
57
+ * as a grid/flex item, and a stretched root would stretch the brush with it.
58
+ *
59
+ * `relative` is the anchor for the absolutely-positioned brush only — it is NOT
60
+ * placement; see the note about consumer-owned offsets above.
61
+ */
62
+ root: "relative inline-flex w-fit items-center justify-center text-center",
63
+ /**
64
+ * The smear: an absolutely-positioned layer at the BACK of the stack filling the
65
+ * frame (`chrome.brush.note`). It is FIRST in the DOM and the text runs below are
66
+ * `relative`, which is what puts them in front — both layers are positioned with
67
+ * `z-index: auto`, so painting follows document order and no `z-index` is needed.
68
+ * (A static text run would paint in the inline phase, i.e. BEHIND the positioned
69
+ * brush — hence `relative` on every run, not decoration.)
70
+ *
71
+ * The colour is a real `background-color` on this element; the vector only masks
72
+ * it. See `styles/promo-sticker.css` for why it cannot be a `background-image`.
73
+ */
74
+ brush: "fods-promo-sticker-brush absolute inset-0",
75
+ /**
76
+ * `chrome.label` / `typography.runs.label` — Heading/H5: Poppins SemiBold at
77
+ * `--font-size-heading-h5`, `--leading-relaxed`.
78
+ *
79
+ * This was built against the measurement while the manifest still said Body/XXS
80
+ * (12px Inter) on a 34px floor; 1.3.0 corrected the manifest to what the set draws,
81
+ * and the three measurements it cites are the ones this deviation was argued from:
82
+ * the master variant resolves Heading/H5 + space/700 + space/500, the desktop
83
+ * instance measures 140 x 48, and the mobile instance measures 127 x 45 — "which
84
+ * only a style that steps at 767 can produce. A fixed 12px run explains none of them."
85
+ *
86
+ * No leading is spelled out: `text-heading-h5` carries Heading/H5's own
87
+ * --leading-relaxed.
88
+ *
89
+ * No `truncate` and no `whitespace-nowrap`: `text.label.overflow` is "wrap" and
90
+ * the note is explicit — "The brush stretches with the string — no truncation".
91
+ *
92
+ * `[text-wrap:var(--text-wrap-heading)]` is the fourth half of the published style:
93
+ * every Heading style binds a text-wrap token (`text-styles.json $textWrapRule`), and
94
+ * Tailwind has no `textWrap` namespace, so the arbitrary property is the only spelling
95
+ * that carries the token. `text-balance` renders the same today and would drop the
96
+ * binding. Same precedent as `Field.tsx` `helperTextVariants` with `--text-wrap-body`.
97
+ */
98
+ label: "relative font-poppins text-heading-h5 font-semibold [text-wrap:var(--text-wrap-heading)]",
99
+ /**
100
+ * `typography.runs.title` — Heading/H1: `--font-heading` (Poppins) at
101
+ * `--font-size-heading-h1` (26), `--font-weight-bold`, `--leading-tight`.
102
+ *
103
+ * No leading is spelled out: `text-heading-h1` carries Heading/H1's own
104
+ * --leading-tight, which is the rhythm the −6px gap below is calibrated against.
105
+ *
106
+ * `[text-wrap:var(--text-wrap-heading)]` — see the note on `label` above.
107
+ */
108
+ title: "relative font-poppins text-heading-h1 font-bold [text-wrap:var(--text-wrap-heading)]",
109
+ /**
110
+ * `typography.runs.subtitle` — Body/XXS/Semibold, its OWN run. Since 1.3.0 the Label
111
+ * run is Heading/H5, and `typography.runs.label.note` says so outright: "The Tile
112
+ * subtitle does NOT ride this style — it has its own `subtitle` run".
113
+ *
114
+ * `-mt-300` is `chrome.tile.gap: -6`. The manifest calls the −6px "a
115
+ * component-level fact, not a new token" (`notes[5]`), but −6px is NOT off-grid:
116
+ * `--space-300` IS 6px, so the negative gap maps onto the existing scale and needs
117
+ * no arbitrary value. `notes[5]` means only that no NEW token is being minted.
118
+ *
119
+ * `[text-wrap:var(--text-wrap-body)]` — the Body half of the same rule; see `label`.
120
+ */
121
+ subtitle: "relative -mt-300 text-body-xxs font-semibold [text-wrap:var(--text-wrap-body)]"
122
+ },
123
+ variants: {
124
+ layout: {
125
+ label: { root: "px-700 py-500" },
126
+ tile: { root: "h-[72px] flex-col px-800 py-500" }
127
+ },
128
+ color: {
129
+ promo: {
130
+ root: "text-primary-foreground",
131
+ brush: "bg-primary-solid"
132
+ },
133
+ ready: {
134
+ root: "text-status-info-foreground",
135
+ brush: "bg-status-info-solid"
136
+ }
137
+ }
138
+ },
139
+ defaultVariants: {
140
+ layout: "label",
141
+ color: "promo"
142
+ }
143
+ });
144
+ const PromoSticker = React.forwardRef((props, ref) => {
145
+ const { layout = "label", color = "promo", decorative = true, children, title, subtitle, className, ...rest } = props;
146
+ const slots = promoStickerVariants({
147
+ layout,
148
+ color
149
+ });
150
+ return /* @__PURE__ */ jsxs("span", {
151
+ ref,
152
+ "aria-hidden": decorative ? "true" : void 0,
153
+ "data-fods-component": "promo-sticker",
154
+ "data-fods-part": "root",
155
+ className: cn(slots.root(), className),
156
+ ...rest,
157
+ children: [/* @__PURE__ */ jsx("span", {
158
+ "aria-hidden": "true",
159
+ "data-fods-part": "brush",
160
+ className: slots.brush()
161
+ }), layout === "tile" ? /* @__PURE__ */ jsxs(Fragment, { children: [/* @__PURE__ */ jsx("span", {
162
+ "data-fods-part": "title",
163
+ className: slots.title(),
164
+ children: title
165
+ }), /* @__PURE__ */ jsx("span", {
166
+ "data-fods-part": "subtitle",
167
+ className: slots.subtitle(),
168
+ children: subtitle
169
+ })] }) : /* @__PURE__ */ jsx("span", {
170
+ "data-fods-part": "label",
171
+ className: slots.label(),
172
+ children
173
+ })]
174
+ });
175
+ });
176
+ PromoSticker.displayName = "PromoSticker";
177
+ export { PromoSticker, promoStickerVariants };
@@ -0,0 +1,2 @@
1
+ import { PromoSticker, PromoStickerColor, PromoStickerLayout, PromoStickerProps, promoStickerVariants } from "./PromoSticker.js";
2
+ export { PromoSticker, type PromoStickerColor, type PromoStickerLayout, type PromoStickerProps, promoStickerVariants };
@@ -0,0 +1 @@
1
+ export { PromoSticker, promoStickerVariants } from "./PromoSticker.js";
@@ -0,0 +1,94 @@
1
+ import { VariantProps } from "../../internal/tailwind-variants.js";
2
+ import * as React from "react";
3
+ /**
4
+ * PromoSurface — the promo plaque (`promo-surface.manifest.json`, atom, v1.5.0).
5
+ *
6
+ * The BOTTOM layer of a promotional panel on a public page: it paints the fill, the
7
+ * tiled pattern and the veil that keeps the reading area clear. Consumed by Hero and
8
+ * Banner through an instance swap, so choosing a tone here never multiplies either
9
+ * consumer's own variant matrix.
10
+ *
11
+ * It is chrome only. Per `delivery.react` it is "a presentational element with no
12
+ * children and no ARIA role" — the consumer composes its text column and visual as a
13
+ * SIBLING layer ABOVE the surface, never inside it. Hence `children` and `role` are
14
+ * omitted from the props type: the contract is enforced by the compiler, not by a
15
+ * comment.
16
+ *
17
+ * Two equally-ranked axes, 12 cells (`intent.variants`):
18
+ * - `layout` — Vertical / Side / Top. Sets the veil geometry, i.e. WHERE the plaque
19
+ * stays clear of the pattern. Picked from where the copy sits, never from the
20
+ * breakpoint (`intent.rules[0]`).
21
+ * - `surface` — Brand / Utility / Solid / Inverse. Sets the fill, and with it the ink
22
+ * the consumer must use on top (`chrome.ink`): Brand and Utility take
23
+ * `--text-primary`, Solid `--secondary-foreground`, Inverse `--text-inverted`.
24
+ *
25
+ * No `size` axis (`intent.sizing`) and no states (`intent.states`) — a background
26
+ * plaque has no interaction and no lifecycle. No motion of its own, so this file
27
+ * declares no animation class. (`tailwindcss-animate` is not installed in this repo,
28
+ * so `animate-in` / `fade-in-*` would generate zero CSS anyway.)
29
+ *
30
+ * The component takes NO width or height of its own (`delivery.react`: "Both painted
31
+ * layers fill the panel on both axes; the component takes no width or height of its
32
+ * own"). The consumer positions it — typically `className="absolute inset-0"` inside a
33
+ * `relative` panel. A fixed-height surface is the canonical breakage (`intent.sizing`).
34
+ */
35
+ declare const promoSurfaceVariants: import("tailwind-variants").TVReturnType<{
36
+ surface: {
37
+ brand: {
38
+ root: string;
39
+ pattern: string;
40
+ };
41
+ utility: {
42
+ root: string;
43
+ pattern: string;
44
+ };
45
+ solid: {
46
+ root: string;
47
+ pattern: string;
48
+ };
49
+ inverse: {
50
+ root: string;
51
+ pattern: string;
52
+ };
53
+ };
54
+ }, {
55
+ root: string;
56
+ pattern: string;
57
+ }, undefined, undefined, undefined, undefined>;
58
+ /**
59
+ * Layout — the veil geometry axis (`axes.variant`, default Vertical).
60
+ *
61
+ * Recorded under `axes.variant` only because the manifest schema's axis keys are
62
+ * fixed; `properties[].maps` overrides that and is explicit: this is NOT the generic
63
+ * `variant` prop, because "the component has two equally-ranked tone axes and neither
64
+ * is 'the' variant". Values are lowercase-kebab; the Figma casing never reaches code.
65
+ */
66
+ export type PromoSurfaceLayout = 'vertical' | 'side' | 'top';
67
+ /** Surface — the fill / tone axis (`axes.surface`, default Brand). */
68
+ export type PromoSurfaceSurface = 'brand' | 'utility' | 'solid' | 'inverse';
69
+ export interface PromoSurfaceProps extends Omit<React.HTMLAttributes<HTMLDivElement>, 'role' | 'children'>, VariantProps<typeof promoSurfaceVariants> {
70
+ /**
71
+ * Which part of the plaque the veil keeps clear of the pattern. Pick it from where
72
+ * the copy sits, never from the breakpoint (`intent.rules[0]`).
73
+ * - `vertical` — clears a band down the middle; a wide panel with centred copy.
74
+ * - `side` — clears the left; copy in a left-hand column with a visual opposite.
75
+ * - `top` — clears a band across the top; a tall stacked panel, copy above the visual.
76
+ */
77
+ layout?: PromoSurfaceLayout;
78
+ /**
79
+ * The plaque's fill, and with it the ink the consumer must use on top
80
+ * (`chrome.ink`). Mixing one surface's fill with another's ink is the failure this
81
+ * axis exists to prevent (`intent.rules[1]`).
82
+ * - `brand` / `utility` — light plaques; content takes `--text-primary`.
83
+ * - `solid` — the bright brand fill; content takes `--secondary-foreground`.
84
+ * - `inverse` — the deep fill; content takes `--text-inverted`.
85
+ *
86
+ * On both dark plaques the default focus ring is invisible or under the 3:1
87
+ * non-text floor, so anything focusable the consumer composes on top must swap to
88
+ * `--outline-focus-inverse` (manifest `gaps[0]`, resolved). That obligation belongs
89
+ * to the consumer — this atom holds no focus itself.
90
+ */
91
+ surface?: PromoSurfaceSurface;
92
+ }
93
+ declare const PromoSurface: React.ForwardRefExoticComponent<PromoSurfaceProps & React.RefAttributes<HTMLDivElement>>;
94
+ export { PromoSurface, promoSurfaceVariants };
@@ -0,0 +1,119 @@
1
+ "use client";
2
+ import { tv } from "../../internal/tailwind-variants.js";
3
+ import { cn } from "../../internal/utils.js";
4
+ import * as React from "react";
5
+ import { jsx } from "react/jsx-runtime";
6
+ // src/components/promo-surface/PromoSurface.tsx
7
+ /**
8
+ * PromoSurface — the promo plaque (`promo-surface.manifest.json`, atom, v1.5.0).
9
+ *
10
+ * The BOTTOM layer of a promotional panel on a public page: it paints the fill, the
11
+ * tiled pattern and the veil that keeps the reading area clear. Consumed by Hero and
12
+ * Banner through an instance swap, so choosing a tone here never multiplies either
13
+ * consumer's own variant matrix.
14
+ *
15
+ * It is chrome only. Per `delivery.react` it is "a presentational element with no
16
+ * children and no ARIA role" — the consumer composes its text column and visual as a
17
+ * SIBLING layer ABOVE the surface, never inside it. Hence `children` and `role` are
18
+ * omitted from the props type: the contract is enforced by the compiler, not by a
19
+ * comment.
20
+ *
21
+ * Two equally-ranked axes, 12 cells (`intent.variants`):
22
+ * - `layout` — Vertical / Side / Top. Sets the veil geometry, i.e. WHERE the plaque
23
+ * stays clear of the pattern. Picked from where the copy sits, never from the
24
+ * breakpoint (`intent.rules[0]`).
25
+ * - `surface` — Brand / Utility / Solid / Inverse. Sets the fill, and with it the ink
26
+ * the consumer must use on top (`chrome.ink`): Brand and Utility take
27
+ * `--text-primary`, Solid `--secondary-foreground`, Inverse `--text-inverted`.
28
+ *
29
+ * No `size` axis (`intent.sizing`) and no states (`intent.states`) — a background
30
+ * plaque has no interaction and no lifecycle. No motion of its own, so this file
31
+ * declares no animation class. (`tailwindcss-animate` is not installed in this repo,
32
+ * so `animate-in` / `fade-in-*` would generate zero CSS anyway.)
33
+ *
34
+ * The component takes NO width or height of its own (`delivery.react`: "Both painted
35
+ * layers fill the panel on both axes; the component takes no width or height of its
36
+ * own"). The consumer positions it — typically `className="absolute inset-0"` inside a
37
+ * `relative` panel. A fixed-height surface is the canonical breakage (`intent.sizing`).
38
+ */
39
+ const promoSurfaceVariants = tv({
40
+ slots: {
41
+ root: "pointer-events-none relative overflow-hidden rounded-800",
42
+ pattern: "fods-promo-surface-pattern absolute inset-0"
43
+ },
44
+ variants: { surface: {
45
+ brand: {
46
+ root: "bg-secondary-subtle",
47
+ pattern: "opacity-[0.08]"
48
+ },
49
+ utility: {
50
+ root: "bg-background-secondary",
51
+ pattern: "opacity-[0.08]"
52
+ },
53
+ solid: {
54
+ root: "bg-secondary-solid",
55
+ pattern: "opacity-[0.25]"
56
+ },
57
+ inverse: {
58
+ root: "bg-background-inverse",
59
+ pattern: "opacity-[0.25]"
60
+ }
61
+ } },
62
+ defaultVariants: { surface: "brand" }
63
+ });
64
+ const VEIL_GEOMETRY = {
65
+ vertical: {
66
+ cx: "50%",
67
+ cy: "50%",
68
+ rx: "50%",
69
+ ry: "83%",
70
+ mid: "57%"
71
+ },
72
+ side: {
73
+ cx: "9%",
74
+ cy: "50%",
75
+ rx: "91%",
76
+ ry: "159%",
77
+ mid: "45%"
78
+ },
79
+ top: {
80
+ cx: "50%",
81
+ cy: "22%",
82
+ rx: "250%",
83
+ ry: "38%",
84
+ mid: "45%"
85
+ }
86
+ };
87
+ const VEIL_EDGE_ALPHA = {
88
+ brand: "70%",
89
+ utility: "50%",
90
+ solid: "100%",
91
+ inverse: "100%"
92
+ };
93
+ const PromoSurface = React.forwardRef(({ className, layout = "vertical", surface = "brand", ...props }, ref) => {
94
+ const slots = promoSurfaceVariants({ surface });
95
+ const geometry = VEIL_GEOMETRY[layout];
96
+ const patternStyle = {
97
+ "--promo-veil-cx": geometry.cx,
98
+ "--promo-veil-cy": geometry.cy,
99
+ "--promo-veil-rx": geometry.rx,
100
+ "--promo-veil-ry": geometry.ry,
101
+ "--promo-veil-mid": geometry.mid,
102
+ "--promo-veil-edge": VEIL_EDGE_ALPHA[surface]
103
+ };
104
+ return /* @__PURE__ */ jsx("div", {
105
+ ref,
106
+ "aria-hidden": "true",
107
+ "data-fods-component": "promo-surface",
108
+ "data-fods-part": "root",
109
+ className: cn(slots.root(), className),
110
+ ...props,
111
+ children: /* @__PURE__ */ jsx("span", {
112
+ "data-fods-part": "pattern",
113
+ className: slots.pattern(),
114
+ style: patternStyle
115
+ })
116
+ });
117
+ });
118
+ PromoSurface.displayName = "PromoSurface";
119
+ export { PromoSurface, promoSurfaceVariants };
@@ -0,0 +1,2 @@
1
+ import { PromoSurface, PromoSurfaceLayout, PromoSurfaceProps, PromoSurfaceSurface, promoSurfaceVariants } from "./PromoSurface.js";
2
+ export { PromoSurface, type PromoSurfaceLayout, type PromoSurfaceProps, type PromoSurfaceSurface, promoSurfaceVariants };
@@ -0,0 +1 @@
1
+ export { PromoSurface, promoSurfaceVariants } from "./PromoSurface.js";