@invoiceonline/ui-react 0.0.0 → 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (738) hide show
  1. package/AGENTS.md +99 -0
  2. package/CHANGELOG.md +131 -0
  3. package/LICENSE +9 -0
  4. package/README.md +77 -1
  5. package/dist/assets/label-brush-1.svg +6 -0
  6. package/dist/assets/pattern-dark.svg +113 -0
  7. package/dist/components/action-row/ActionRow.d.ts +178 -0
  8. package/dist/components/action-row/ActionRow.js +340 -0
  9. package/dist/components/action-row/index.d.ts +2 -0
  10. package/dist/components/action-row/index.js +1 -0
  11. package/dist/components/alert/Alert.d.ts +314 -0
  12. package/dist/components/alert/Alert.js +446 -0
  13. package/dist/components/alert/index.d.ts +2 -0
  14. package/dist/components/alert/index.js +1 -0
  15. package/dist/components/anchored-panel/AnchoredPanel.d.ts +41 -0
  16. package/dist/components/anchored-panel/AnchoredPanel.js +72 -0
  17. package/dist/components/anchored-panel/index.d.ts +3 -0
  18. package/dist/components/anchored-panel/index.js +3 -0
  19. package/dist/components/badge/Badge.d.ts +146 -0
  20. package/dist/components/badge/Badge.js +258 -0
  21. package/dist/components/badge/index.d.ts +2 -0
  22. package/dist/components/badge/index.js +1 -0
  23. package/dist/components/banner/Banner.d.ts +209 -0
  24. package/dist/components/banner/Banner.js +339 -0
  25. package/dist/components/banner/index.d.ts +2 -0
  26. package/dist/components/banner/index.js +1 -0
  27. package/dist/components/button/Button.d.ts +54 -0
  28. package/dist/components/button/Button.js +312 -0
  29. package/dist/components/button/index.d.ts +2 -0
  30. package/dist/components/button/index.js +1 -0
  31. package/dist/components/button-group/ButtonGroup.d.ts +187 -0
  32. package/dist/components/button-group/ButtonGroup.js +217 -0
  33. package/dist/components/button-group/index.d.ts +2 -0
  34. package/dist/components/button-group/index.js +1 -0
  35. package/dist/components/card-select/CardSelect.d.ts +274 -0
  36. package/dist/components/card-select/CardSelect.js +561 -0
  37. package/dist/components/card-select/CardSelectGroup.d.ts +92 -0
  38. package/dist/components/card-select/CardSelectGroup.js +72 -0
  39. package/dist/components/card-select/index.d.ts +3 -0
  40. package/dist/components/card-select/index.js +3 -0
  41. package/dist/components/checkbox/Checkbox.d.ts +104 -0
  42. package/dist/components/checkbox/Checkbox.js +194 -0
  43. package/dist/components/checkbox/index.d.ts +2 -0
  44. package/dist/components/checkbox/index.js +1 -0
  45. package/dist/components/chip/Chip.d.ts +250 -0
  46. package/dist/components/chip/Chip.js +441 -0
  47. package/dist/components/chip/index.d.ts +2 -0
  48. package/dist/components/chip/index.js +1 -0
  49. package/dist/components/column-header/ColumnHeader.d.ts +144 -0
  50. package/dist/components/column-header/ColumnHeader.js +209 -0
  51. package/dist/components/column-header/index.d.ts +2 -0
  52. package/dist/components/column-header/index.js +1 -0
  53. package/dist/components/combobox-field/Combobox.d.ts +104 -0
  54. package/dist/components/combobox-field/Combobox.js +355 -0
  55. package/dist/components/combobox-field/ComboboxField.d.ts +76 -0
  56. package/dist/components/combobox-field/ComboboxField.js +98 -0
  57. package/dist/components/combobox-field/index.d.ts +3 -0
  58. package/dist/components/combobox-field/index.js +3 -0
  59. package/dist/components/date-field/DateField.d.ts +52 -0
  60. package/dist/components/date-field/DateField.js +45 -0
  61. package/dist/components/date-field/index.d.ts +2 -0
  62. package/dist/components/date-field/index.js +1 -0
  63. package/dist/components/date-picker/DatePicker.d.ts +53 -0
  64. package/dist/components/date-picker/DatePicker.js +329 -0
  65. package/dist/components/date-picker/index.d.ts +2 -0
  66. package/dist/components/date-picker/index.js +1 -0
  67. package/dist/components/divider/Divider.d.ts +81 -0
  68. package/dist/components/divider/Divider.js +93 -0
  69. package/dist/components/divider/index.d.ts +2 -0
  70. package/dist/components/divider/index.js +1 -0
  71. package/dist/components/drawer/Drawer.d.ts +128 -0
  72. package/dist/components/drawer/Drawer.js +367 -0
  73. package/dist/components/drawer/index.d.ts +2 -0
  74. package/dist/components/drawer/index.js +1 -0
  75. package/dist/components/dropdown-button/DropdownButton.d.ts +72 -0
  76. package/dist/components/dropdown-button/DropdownButton.js +122 -0
  77. package/dist/components/dropdown-button/index.d.ts +2 -0
  78. package/dist/components/dropdown-button/index.js +1 -0
  79. package/dist/components/faq/FAQ.d.ts +135 -0
  80. package/dist/components/faq/FAQ.js +258 -0
  81. package/dist/components/faq/index.d.ts +2 -0
  82. package/dist/components/faq/index.js +1 -0
  83. package/dist/components/field/Field.d.ts +118 -0
  84. package/dist/components/field/Field.js +327 -0
  85. package/dist/components/field/index.d.ts +2 -0
  86. package/dist/components/field/index.js +1 -0
  87. package/dist/components/field-pair/FieldPair.d.ts +194 -0
  88. package/dist/components/field-pair/FieldPair.js +321 -0
  89. package/dist/components/field-pair/index.d.ts +2 -0
  90. package/dist/components/field-pair/index.js +1 -0
  91. package/dist/components/file-upload/FileUpload.d.ts +137 -0
  92. package/dist/components/file-upload/FileUpload.js +434 -0
  93. package/dist/components/file-upload/index.d.ts +2 -0
  94. package/dist/components/file-upload/index.js +1 -0
  95. package/dist/components/filter-chip/FilterChip.d.ts +373 -0
  96. package/dist/components/filter-chip/FilterChip.js +517 -0
  97. package/dist/components/filter-chip/index.d.ts +2 -0
  98. package/dist/components/filter-chip/index.js +1 -0
  99. package/dist/components/filter-facet/FilterFacet.d.ts +116 -0
  100. package/dist/components/filter-facet/FilterFacet.js +632 -0
  101. package/dist/components/filter-facet/index.d.ts +2 -0
  102. package/dist/components/filter-facet/index.js +1 -0
  103. package/dist/components/firm-avatar/FirmAvatar.d.ts +75 -0
  104. package/dist/components/firm-avatar/FirmAvatar.js +119 -0
  105. package/dist/components/firm-avatar/index.d.ts +2 -0
  106. package/dist/components/firm-avatar/index.js +1 -0
  107. package/dist/components/form-actions/FormActions.d.ts +123 -0
  108. package/dist/components/form-actions/FormActions.js +195 -0
  109. package/dist/components/form-actions/index.d.ts +2 -0
  110. package/dist/components/form-actions/index.js +1 -0
  111. package/dist/components/form-block/FormBlock.d.ts +252 -0
  112. package/dist/components/form-block/FormBlock.js +420 -0
  113. package/dist/components/form-block/index.d.ts +3 -0
  114. package/dist/components/form-block/index.js +3 -0
  115. package/dist/components/form-section/FormSection.d.ts +130 -0
  116. package/dist/components/form-section/FormSection.js +206 -0
  117. package/dist/components/form-section/index.d.ts +2 -0
  118. package/dist/components/form-section/index.js +1 -0
  119. package/dist/components/heading/Heading.d.ts +69 -0
  120. package/dist/components/heading/Heading.js +79 -0
  121. package/dist/components/heading/index.d.ts +2 -0
  122. package/dist/components/heading/index.js +1 -0
  123. package/dist/components/heading-group/HeadingGroup.d.ts +258 -0
  124. package/dist/components/heading-group/HeadingGroup.js +255 -0
  125. package/dist/components/heading-group/index.d.ts +2 -0
  126. package/dist/components/heading-group/index.js +1 -0
  127. package/dist/components/hero/Hero.d.ts +268 -0
  128. package/dist/components/hero/Hero.js +316 -0
  129. package/dist/components/hero/index.d.ts +2 -0
  130. package/dist/components/hero/index.js +1 -0
  131. package/dist/components/icon/Icon.d.ts +27 -0
  132. package/dist/components/icon/Icon.js +30 -0
  133. package/dist/components/icon/index.d.ts +3 -0
  134. package/dist/components/icon/index.js +3 -0
  135. package/dist/components/icon-button/IconButton.d.ts +75 -0
  136. package/dist/components/icon-button/IconButton.js +151 -0
  137. package/dist/components/icon-button/index.d.ts +2 -0
  138. package/dist/components/icon-button/index.js +1 -0
  139. package/dist/components/item-row/ItemRow.d.ts +253 -0
  140. package/dist/components/item-row/ItemRow.js +496 -0
  141. package/dist/components/item-row/index.d.ts +2 -0
  142. package/dist/components/item-row/index.js +1 -0
  143. package/dist/components/list-row/ListRow.d.ts +165 -0
  144. package/dist/components/list-row/ListRow.js +233 -0
  145. package/dist/components/list-row/index.d.ts +2 -0
  146. package/dist/components/list-row/index.js +1 -0
  147. package/dist/components/menu/Menu.d.ts +64 -0
  148. package/dist/components/menu/Menu.js +186 -0
  149. package/dist/components/menu/index.d.ts +2 -0
  150. package/dist/components/menu/index.js +1 -0
  151. package/dist/components/modal/Modal.d.ts +272 -0
  152. package/dist/components/modal/Modal.js +788 -0
  153. package/dist/components/modal/index.d.ts +2 -0
  154. package/dist/components/modal/index.js +1 -0
  155. package/dist/components/nav-link/NavLink.d.ts +123 -0
  156. package/dist/components/nav-link/NavLink.js +157 -0
  157. package/dist/components/nav-link/index.d.ts +2 -0
  158. package/dist/components/nav-link/index.js +1 -0
  159. package/dist/components/number-field/NumberField.d.ts +62 -0
  160. package/dist/components/number-field/NumberField.js +210 -0
  161. package/dist/components/number-field/index.d.ts +2 -0
  162. package/dist/components/number-field/index.js +1 -0
  163. package/dist/components/pagination/Pagination.d.ts +133 -0
  164. package/dist/components/pagination/Pagination.js +217 -0
  165. package/dist/components/pagination/index.d.ts +3 -0
  166. package/dist/components/pagination/index.js +3 -0
  167. package/dist/components/popover-surface/index.d.ts +2 -0
  168. package/dist/components/popover-surface/index.js +1 -0
  169. package/dist/components/progress-bar/ProgressBar.d.ts +260 -0
  170. package/dist/components/progress-bar/ProgressBar.js +470 -0
  171. package/dist/components/progress-bar/index.d.ts +2 -0
  172. package/dist/components/progress-bar/index.js +1 -0
  173. package/dist/components/promo-sticker/PromoSticker.d.ts +204 -0
  174. package/dist/components/promo-sticker/PromoSticker.js +177 -0
  175. package/dist/components/promo-sticker/index.d.ts +2 -0
  176. package/dist/components/promo-sticker/index.js +1 -0
  177. package/dist/components/promo-surface/PromoSurface.d.ts +94 -0
  178. package/dist/components/promo-surface/PromoSurface.js +119 -0
  179. package/dist/components/promo-surface/index.d.ts +2 -0
  180. package/dist/components/promo-surface/index.js +1 -0
  181. package/dist/components/radio/Radio.d.ts +92 -0
  182. package/dist/components/radio/Radio.js +171 -0
  183. package/dist/components/radio/index.d.ts +2 -0
  184. package/dist/components/radio/index.js +1 -0
  185. package/dist/components/radio-group/RadioGroup.d.ts +61 -0
  186. package/dist/components/radio-group/RadioGroup.js +51 -0
  187. package/dist/components/radio-group/index.d.ts +2 -0
  188. package/dist/components/radio-group/index.js +1 -0
  189. package/dist/components/select/Select.d.ts +65 -0
  190. package/dist/components/select/Select.js +176 -0
  191. package/dist/components/select/index.d.ts +2 -0
  192. package/dist/components/select/index.js +1 -0
  193. package/dist/components/select-field/SelectField.d.ts +16 -0
  194. package/dist/components/select-field/SelectField.js +55 -0
  195. package/dist/components/select-field/index.d.ts +2 -0
  196. package/dist/components/select-field/index.js +1 -0
  197. package/dist/components/skeleton/Skeleton.d.ts +64 -0
  198. package/dist/components/skeleton/Skeleton.js +65 -0
  199. package/dist/components/skeleton/index.d.ts +2 -0
  200. package/dist/components/skeleton/index.js +1 -0
  201. package/dist/components/split-button/SplitButton.d.ts +80 -0
  202. package/dist/components/split-button/SplitButton.js +182 -0
  203. package/dist/components/split-button/index.d.ts +2 -0
  204. package/dist/components/split-button/index.js +1 -0
  205. package/dist/components/status-summary-bar/StatusSummaryBar.d.ts +118 -0
  206. package/dist/components/status-summary-bar/StatusSummaryBar.js +278 -0
  207. package/dist/components/status-summary-bar/index.d.ts +2 -0
  208. package/dist/components/status-summary-bar/index.js +1 -0
  209. package/dist/components/subject-lookup-field/SubjectLookupField.d.ts +157 -0
  210. package/dist/components/subject-lookup-field/SubjectLookupField.js +663 -0
  211. package/dist/components/subject-lookup-field/index.d.ts +2 -0
  212. package/dist/components/subject-lookup-field/index.js +1 -0
  213. package/dist/components/switch/Switch.d.ts +152 -0
  214. package/dist/components/switch/Switch.js +307 -0
  215. package/dist/components/switch/index.d.ts +2 -0
  216. package/dist/components/switch/index.js +1 -0
  217. package/dist/components/table/Table.d.ts +5 -0
  218. package/dist/components/table/Table.js +601 -0
  219. package/dist/components/table/index.d.ts +6 -0
  220. package/dist/components/table/index.js +6 -0
  221. package/dist/components/text-field/TextField.d.ts +65 -0
  222. package/dist/components/text-field/TextField.js +173 -0
  223. package/dist/components/text-field/index.d.ts +2 -0
  224. package/dist/components/text-field/index.js +1 -0
  225. package/dist/components/text-link/TextLink.d.ts +260 -0
  226. package/dist/components/text-link/TextLink.js +303 -0
  227. package/dist/components/text-link/index.d.ts +2 -0
  228. package/dist/components/text-link/index.js +1 -0
  229. package/dist/components/textarea/Textarea.d.ts +93 -0
  230. package/dist/components/textarea/Textarea.js +256 -0
  231. package/dist/components/textarea/index.d.ts +2 -0
  232. package/dist/components/textarea/index.js +1 -0
  233. package/dist/components/tooltip/Tooltip.d.ts +129 -0
  234. package/dist/components/tooltip/Tooltip.js +457 -0
  235. package/dist/components/tooltip/index.d.ts +2 -0
  236. package/dist/components/tooltip/index.js +1 -0
  237. package/dist/components/unit-field/UnitField.d.ts +46 -0
  238. package/dist/components/unit-field/UnitField.js +133 -0
  239. package/dist/components/unit-field/index.d.ts +2 -0
  240. package/dist/components/unit-field/index.js +1 -0
  241. package/dist/icons/icon-registry.generated.js +500 -0
  242. package/dist/icons/icon-types.generated.d.ts +2 -0
  243. package/dist/icons/icon-types.generated.js +126 -0
  244. package/dist/index.d.ts +132 -0
  245. package/dist/index.js +75 -0
  246. package/dist/internal/BottomSheet.js +496 -0
  247. package/dist/internal/FodsProvider.d.ts +25 -0
  248. package/dist/internal/FodsProvider.js +32 -0
  249. package/dist/internal/MotionCaret.js +35 -0
  250. package/dist/internal/NumberFormatInput.d.ts +21 -0
  251. package/dist/internal/NumberFormatInput.js +126 -0
  252. package/dist/internal/SummaryDonut.d.ts +3 -0
  253. package/dist/internal/SummaryDonut.js +300 -0
  254. package/dist/internal/buttonSegment.d.ts +44 -0
  255. package/dist/internal/buttonSegment.js +126 -0
  256. package/dist/internal/collapseRoom.js +128 -0
  257. package/dist/internal/comboboxKeys.js +44 -0
  258. package/dist/internal/contentPresence.js +46 -0
  259. package/dist/internal/dayCell.js +95 -0
  260. package/dist/internal/dialogPortal.d.ts +2 -0
  261. package/dist/internal/dialogPortal.js +21 -0
  262. package/dist/internal/donutSweeps.js +65 -0
  263. package/dist/internal/enterOnViewGeometry.js +46 -0
  264. package/dist/internal/faqItem.js +80 -0
  265. package/dist/internal/floatingLabelMotion.js +68 -0
  266. package/dist/internal/formBlockContext.d.ts +22 -0
  267. package/dist/internal/formBlockContext.js +20 -0
  268. package/dist/internal/heightRoom.js +87 -0
  269. package/dist/internal/numberSeparators.js +62 -0
  270. package/dist/internal/overlayMotion.js +48 -0
  271. package/dist/internal/paginationItem.d.ts +8 -0
  272. package/dist/internal/paginationItem.js +22 -0
  273. package/dist/internal/popoverSurface.d.ts +8 -0
  274. package/dist/internal/popoverSurface.js +23 -0
  275. package/dist/internal/portalContainer.d.ts +1 -0
  276. package/dist/internal/portalContainer.js +6 -0
  277. package/dist/internal/progressBarItem.d.ts +207 -0
  278. package/dist/internal/progressBarItem.js +264 -0
  279. package/dist/internal/selectionControlText.js +12 -0
  280. package/dist/internal/statusSummaryParts.js +371 -0
  281. package/dist/internal/summaryMotion.js +75 -0
  282. package/dist/internal/table/ChildConnector.js +62 -0
  283. package/dist/internal/table/ChildRowPrefix.d.ts +9 -0
  284. package/dist/internal/table/ChildRowPrefix.js +27 -0
  285. package/dist/internal/table/ColumnSettings.js +135 -0
  286. package/dist/internal/table/ScrollRegion.js +114 -0
  287. package/dist/internal/table/TableEmpty.js +93 -0
  288. package/dist/internal/table/TableLayout.d.ts +17 -0
  289. package/dist/internal/table/TableLayout.js +29 -0
  290. package/dist/internal/table/TableLoadStatus.js +56 -0
  291. package/dist/internal/table/TableMobile.js +488 -0
  292. package/dist/internal/table/TruncatedCell.js +33 -0
  293. package/dist/internal/table/emptyValue.js +10 -0
  294. package/dist/internal/table/features.d.ts +41 -0
  295. package/dist/internal/table/features.js +31 -0
  296. package/dist/internal/table/recipes.js +227 -0
  297. package/dist/internal/table/rowClick.js +9 -0
  298. package/dist/internal/table/types.d.ts +325 -0
  299. package/dist/internal/table/types.js +13 -0
  300. package/dist/internal/tailwind-variants.d.ts +3 -0
  301. package/dist/internal/tailwind-variants.js +37 -0
  302. package/dist/internal/tooltipContext.js +5 -0
  303. package/dist/internal/tw-merge-config.generated.js +314 -0
  304. package/dist/internal/useAnchoredPanel.d.ts +87 -0
  305. package/dist/internal/useAnchoredPanel.js +108 -0
  306. package/dist/internal/useCountUp.js +53 -0
  307. package/dist/internal/useDateFieldTrigger.js +183 -0
  308. package/dist/internal/useEChart.js +59 -0
  309. package/dist/internal/useEnterOnView.js +42 -0
  310. package/dist/internal/useFloatingBar.js +100 -0
  311. package/dist/internal/useFormReset.js +37 -0
  312. package/dist/internal/useIsMobile.js +44 -0
  313. package/dist/internal/useOneRowOverflow.js +88 -0
  314. package/dist/internal/usePrefersReducedMotion.js +25 -0
  315. package/dist/internal/useReturnFocus.js +26 -0
  316. package/dist/internal/utils.d.ts +7 -0
  317. package/dist/internal/utils.js +58 -0
  318. package/dist/node_modules/@tanstack/store/dist/store.d.ts +29 -0
  319. package/dist/node_modules/@tanstack/store/dist/types.d.ts +38 -0
  320. package/dist/node_modules/@tanstack/table-core/dist/core/cells/coreCellsFeature.d.ts +6 -0
  321. package/dist/node_modules/@tanstack/table-core/dist/core/cells/coreCellsFeature.types.d.ts +53 -0
  322. package/dist/node_modules/@tanstack/table-core/dist/core/columns/coreColumnsFeature.d.ts +6 -0
  323. package/dist/node_modules/@tanstack/table-core/dist/core/columns/coreColumnsFeature.types.d.ts +90 -0
  324. package/dist/node_modules/@tanstack/table-core/dist/core/coreFeatures.d.ts +17 -0
  325. package/dist/node_modules/@tanstack/table-core/dist/core/headers/coreHeadersFeature.d.ts +6 -0
  326. package/dist/node_modules/@tanstack/table-core/dist/core/headers/coreHeadersFeature.types.d.ts +114 -0
  327. package/dist/node_modules/@tanstack/table-core/dist/core/reactivity/coreReactivityFeature.types.d.ts +51 -0
  328. package/dist/node_modules/@tanstack/table-core/dist/core/row-models/coreRowModelsFeature.d.ts +6 -0
  329. package/dist/node_modules/@tanstack/table-core/dist/core/row-models/coreRowModelsFeature.types.d.ts +29 -0
  330. package/dist/node_modules/@tanstack/table-core/dist/core/rows/coreRowsFeature.d.ts +6 -0
  331. package/dist/node_modules/@tanstack/table-core/dist/core/rows/coreRowsFeature.types.d.ts +129 -0
  332. package/dist/node_modules/@tanstack/table-core/dist/core/table/coreTablesFeature.d.ts +6 -0
  333. package/dist/node_modules/@tanstack/table-core/dist/core/table/coreTablesFeature.types.d.ts +203 -0
  334. package/dist/node_modules/@tanstack/table-core/dist/features/cell-selection/cellSelectionFeature.d.ts +6 -0
  335. package/dist/node_modules/@tanstack/table-core/dist/features/cell-selection/cellSelectionFeature.types.d.ts +294 -0
  336. package/dist/node_modules/@tanstack/table-core/dist/features/cell-spanning/cellSpanningFeature.d.ts +11 -0
  337. package/dist/node_modules/@tanstack/table-core/dist/features/cell-spanning/cellSpanningFeature.types.d.ts +148 -0
  338. package/dist/node_modules/@tanstack/table-core/dist/features/column-faceting/columnFacetingFeature.d.ts +12 -0
  339. package/dist/node_modules/@tanstack/table-core/dist/features/column-faceting/columnFacetingFeature.types.d.ts +63 -0
  340. package/dist/node_modules/@tanstack/table-core/dist/features/column-filtering/columnFilteringFeature.d.ts +6 -0
  341. package/dist/node_modules/@tanstack/table-core/dist/features/column-filtering/columnFilteringFeature.types.d.ts +209 -0
  342. package/dist/node_modules/@tanstack/table-core/dist/features/column-filtering/filterFns.d.ts +35 -0
  343. package/dist/node_modules/@tanstack/table-core/dist/features/column-grouping/columnGroupingFeature.d.ts +6 -0
  344. package/dist/node_modules/@tanstack/table-core/dist/features/column-grouping/columnGroupingFeature.types.d.ts +128 -0
  345. package/dist/node_modules/@tanstack/table-core/dist/features/column-ordering/columnOrderingFeature.d.ts +6 -0
  346. package/dist/node_modules/@tanstack/table-core/dist/features/column-ordering/columnOrderingFeature.types.d.ts +82 -0
  347. package/dist/node_modules/@tanstack/table-core/dist/features/column-pinning/columnPinningFeature.d.ts +11 -0
  348. package/dist/node_modules/@tanstack/table-core/dist/features/column-pinning/columnPinningFeature.types.d.ts +195 -0
  349. package/dist/node_modules/@tanstack/table-core/dist/features/column-resizing/columnResizingFeature.d.ts +6 -0
  350. package/dist/node_modules/@tanstack/table-core/dist/features/column-resizing/columnResizingFeature.types.d.ts +73 -0
  351. package/dist/node_modules/@tanstack/table-core/dist/features/column-sizing/columnSizingFeature.d.ts +6 -0
  352. package/dist/node_modules/@tanstack/table-core/dist/features/column-sizing/columnSizingFeature.types.d.ts +134 -0
  353. package/dist/node_modules/@tanstack/table-core/dist/features/column-visibility/columnVisibilityFeature.d.ts +6 -0
  354. package/dist/node_modules/@tanstack/table-core/dist/features/column-visibility/columnVisibilityFeature.types.d.ts +92 -0
  355. package/dist/node_modules/@tanstack/table-core/dist/features/global-filtering/globalFilteringFeature.d.ts +6 -0
  356. package/dist/node_modules/@tanstack/table-core/dist/features/global-filtering/globalFilteringFeature.types.d.ts +67 -0
  357. package/dist/node_modules/@tanstack/table-core/dist/features/row-aggregation/aggregationFns.d.ts +23 -0
  358. package/dist/node_modules/@tanstack/table-core/dist/features/row-aggregation/rowAggregationFeature.d.ts +6 -0
  359. package/dist/node_modules/@tanstack/table-core/dist/features/row-aggregation/rowAggregationFeature.types.d.ts +183 -0
  360. package/dist/node_modules/@tanstack/table-core/dist/features/row-aggregation/rowAggregationFeature.utils.d.ts +18 -0
  361. package/dist/node_modules/@tanstack/table-core/dist/features/row-expanding/rowExpandingFeature.d.ts +6 -0
  362. package/dist/node_modules/@tanstack/table-core/dist/features/row-expanding/rowExpandingFeature.types.d.ts +125 -0
  363. package/dist/node_modules/@tanstack/table-core/dist/features/row-pagination/rowPaginationFeature.d.ts +6 -0
  364. package/dist/node_modules/@tanstack/table-core/dist/features/row-pagination/rowPaginationFeature.types.d.ts +135 -0
  365. package/dist/node_modules/@tanstack/table-core/dist/features/row-pinning/rowPinningFeature.d.ts +6 -0
  366. package/dist/node_modules/@tanstack/table-core/dist/features/row-pinning/rowPinningFeature.types.d.ts +76 -0
  367. package/dist/node_modules/@tanstack/table-core/dist/features/row-selection/rowSelectionFeature.d.ts +6 -0
  368. package/dist/node_modules/@tanstack/table-core/dist/features/row-selection/rowSelectionFeature.types.d.ts +187 -0
  369. package/dist/node_modules/@tanstack/table-core/dist/features/row-sorting/rowSortingFeature.d.ts +6 -0
  370. package/dist/node_modules/@tanstack/table-core/dist/features/row-sorting/rowSortingFeature.types.d.ts +236 -0
  371. package/dist/node_modules/@tanstack/table-core/dist/features/row-sorting/sortFns.d.ts +23 -0
  372. package/dist/node_modules/@tanstack/table-core/dist/features/stockFeatures.d.ts +37 -0
  373. package/dist/node_modules/@tanstack/table-core/dist/helpers/columnHelper.d.ts +47 -0
  374. package/dist/node_modules/@tanstack/table-core/dist/types/Cell.d.ts +16 -0
  375. package/dist/node_modules/@tanstack/table-core/dist/types/Column.d.ts +30 -0
  376. package/dist/node_modules/@tanstack/table-core/dist/types/ColumnDef.d.ts +123 -0
  377. package/dist/node_modules/@tanstack/table-core/dist/types/Header.d.ts +12 -0
  378. package/dist/node_modules/@tanstack/table-core/dist/types/HeaderGroup.d.ts +6 -0
  379. package/dist/node_modules/@tanstack/table-core/dist/types/Row.d.ts +24 -0
  380. package/dist/node_modules/@tanstack/table-core/dist/types/RowModel.d.ts +19 -0
  381. package/dist/node_modules/@tanstack/table-core/dist/types/RowModelFns.d.ts +11 -0
  382. package/dist/node_modules/@tanstack/table-core/dist/types/Table.d.ts +53 -0
  383. package/dist/node_modules/@tanstack/table-core/dist/types/TableFeatures.d.ts +416 -0
  384. package/dist/node_modules/@tanstack/table-core/dist/types/TableOptions.d.ts +78 -0
  385. package/dist/node_modules/@tanstack/table-core/dist/types/TableState.d.ts +46 -0
  386. package/dist/node_modules/@tanstack/table-core/dist/types/type-utils.d.ts +25 -0
  387. package/dist/shared.css +179 -0
  388. package/dist/styles.css +5467 -0
  389. package/dist/theme.css +314 -0
  390. package/dist/theme.map.json +278 -0
  391. package/dist/tokens/index.d.ts +2 -0
  392. package/dist/tokens/index.js +1 -0
  393. package/dist/tokens/tokens.generated.d.ts +2040 -0
  394. package/dist/tokens/tokens.generated.js +2053 -0
  395. package/dist/tokens.css +484 -0
  396. package/dist/tokens.flat.json +429 -0
  397. package/docs/Consuming.mdx +379 -0
  398. package/docs/Contributing.mdx +78 -0
  399. package/docs/ForAgents.mdx +53 -0
  400. package/docs/Introduction.mdx +54 -0
  401. package/llms.txt +556 -0
  402. package/package.json +351 -3
  403. package/src/components/action-row/ActionRow.mdx +686 -0
  404. package/src/components/action-row/ActionRow.stories.tsx +669 -0
  405. package/src/components/action-row/ActionRow.tsx +632 -0
  406. package/src/components/action-row/index.ts +9 -0
  407. package/src/components/alert/Alert.mdx +377 -0
  408. package/src/components/alert/Alert.stories.tsx +674 -0
  409. package/src/components/alert/Alert.tsx +579 -0
  410. package/src/components/alert/index.ts +13 -0
  411. package/src/components/anchored-panel/AnchoredPanel.mdx +381 -0
  412. package/src/components/anchored-panel/AnchoredPanel.stories.tsx +593 -0
  413. package/src/components/anchored-panel/AnchoredPanel.tsx +176 -0
  414. package/src/components/anchored-panel/index.ts +15 -0
  415. package/src/components/badge/Badge.mdx +487 -0
  416. package/src/components/badge/Badge.stories.tsx +375 -0
  417. package/src/components/badge/Badge.tsx +360 -0
  418. package/src/components/badge/index.ts +10 -0
  419. package/src/components/banner/Banner.mdx +704 -0
  420. package/src/components/banner/Banner.stories.tsx +448 -0
  421. package/src/components/banner/Banner.tsx +602 -0
  422. package/src/components/banner/index.ts +14 -0
  423. package/src/components/button/Button.mdx +286 -0
  424. package/src/components/button/Button.stories.tsx +381 -0
  425. package/src/components/button/Button.tsx +384 -0
  426. package/src/components/button/index.ts +1 -0
  427. package/src/components/button-group/ButtonGroup.mdx +512 -0
  428. package/src/components/button-group/ButtonGroup.stories.tsx +714 -0
  429. package/src/components/button-group/ButtonGroup.tsx +491 -0
  430. package/src/components/button-group/index.ts +10 -0
  431. package/src/components/card-select/CardSelect.mdx +662 -0
  432. package/src/components/card-select/CardSelect.stories.tsx +784 -0
  433. package/src/components/card-select/CardSelect.tsx +783 -0
  434. package/src/components/card-select/CardSelectGroup.tsx +169 -0
  435. package/src/components/card-select/index.ts +18 -0
  436. package/src/components/checkbox/Checkbox.mdx +269 -0
  437. package/src/components/checkbox/Checkbox.stories.tsx +306 -0
  438. package/src/components/checkbox/Checkbox.tsx +343 -0
  439. package/src/components/checkbox/index.ts +1 -0
  440. package/src/components/chip/Chip.mdx +683 -0
  441. package/src/components/chip/Chip.stories.tsx +734 -0
  442. package/src/components/chip/Chip.tsx +732 -0
  443. package/src/components/chip/index.ts +9 -0
  444. package/src/components/column-header/ColumnHeader.mdx +301 -0
  445. package/src/components/column-header/ColumnHeader.stories.tsx +319 -0
  446. package/src/components/column-header/ColumnHeader.tsx +287 -0
  447. package/src/components/column-header/index.ts +7 -0
  448. package/src/components/combobox-field/Combobox.tsx +693 -0
  449. package/src/components/combobox-field/ComboboxField.mdx +525 -0
  450. package/src/components/combobox-field/ComboboxField.stories.tsx +502 -0
  451. package/src/components/combobox-field/ComboboxField.tsx +259 -0
  452. package/src/components/combobox-field/index.ts +12 -0
  453. package/src/components/date-field/DateField.mdx +340 -0
  454. package/src/components/date-field/DateField.stories.tsx +221 -0
  455. package/src/components/date-field/DateField.tsx +176 -0
  456. package/src/components/date-field/index.ts +1 -0
  457. package/src/components/date-picker/DatePicker.mdx +436 -0
  458. package/src/components/date-picker/DatePicker.stories.tsx +458 -0
  459. package/src/components/date-picker/DatePicker.tsx +688 -0
  460. package/src/components/date-picker/index.ts +9 -0
  461. package/src/components/divider/Divider.mdx +256 -0
  462. package/src/components/divider/Divider.stories.tsx +177 -0
  463. package/src/components/divider/Divider.tsx +193 -0
  464. package/src/components/divider/index.ts +1 -0
  465. package/src/components/drawer/Drawer.mdx +518 -0
  466. package/src/components/drawer/Drawer.stories.tsx +392 -0
  467. package/src/components/drawer/Drawer.tsx +683 -0
  468. package/src/components/drawer/index.ts +1 -0
  469. package/src/components/dropdown-button/DropdownButton.mdx +285 -0
  470. package/src/components/dropdown-button/DropdownButton.stories.tsx +398 -0
  471. package/src/components/dropdown-button/DropdownButton.tsx +198 -0
  472. package/src/components/dropdown-button/index.ts +7 -0
  473. package/src/components/faq/FAQ.mdx +364 -0
  474. package/src/components/faq/FAQ.stories.tsx +343 -0
  475. package/src/components/faq/FAQ.tsx +337 -0
  476. package/src/components/faq/index.ts +1 -0
  477. package/src/components/field/Field.mdx +129 -0
  478. package/src/components/field/Field.stories.tsx +461 -0
  479. package/src/components/field/Field.tsx +765 -0
  480. package/src/components/field/index.ts +20 -0
  481. package/src/components/field-pair/FieldPair.mdx +308 -0
  482. package/src/components/field-pair/FieldPair.stories.tsx +530 -0
  483. package/src/components/field-pair/FieldPair.tsx +796 -0
  484. package/src/components/field-pair/index.ts +9 -0
  485. package/src/components/file-upload/FileUpload.mdx +345 -0
  486. package/src/components/file-upload/FileUpload.stories.tsx +698 -0
  487. package/src/components/file-upload/FileUpload.tsx +802 -0
  488. package/src/components/file-upload/index.ts +6 -0
  489. package/src/components/filter-chip/FilterChip.mdx +778 -0
  490. package/src/components/filter-chip/FilterChip.stories.tsx +827 -0
  491. package/src/components/filter-chip/FilterChip.tsx +881 -0
  492. package/src/components/filter-chip/index.ts +11 -0
  493. package/src/components/filter-facet/FilterFacet.mdx +536 -0
  494. package/src/components/filter-facet/FilterFacet.stories.tsx +506 -0
  495. package/src/components/filter-facet/FilterFacet.tsx +1160 -0
  496. package/src/components/filter-facet/index.ts +7 -0
  497. package/src/components/firm-avatar/FirmAvatar.mdx +280 -0
  498. package/src/components/firm-avatar/FirmAvatar.stories.tsx +147 -0
  499. package/src/components/firm-avatar/FirmAvatar.tsx +172 -0
  500. package/src/components/firm-avatar/index.ts +7 -0
  501. package/src/components/form-actions/FormActions.mdx +518 -0
  502. package/src/components/form-actions/FormActions.stories.tsx +621 -0
  503. package/src/components/form-actions/FormActions.tsx +273 -0
  504. package/src/components/form-actions/index.ts +6 -0
  505. package/src/components/form-block/FormBlock.mdx +728 -0
  506. package/src/components/form-block/FormBlock.stories.tsx +813 -0
  507. package/src/components/form-block/FormBlock.tsx +679 -0
  508. package/src/components/form-block/index.ts +13 -0
  509. package/src/components/form-section/FormSection.mdx +436 -0
  510. package/src/components/form-section/FormSection.stories.tsx +407 -0
  511. package/src/components/form-section/FormSection.tsx +290 -0
  512. package/src/components/form-section/index.ts +17 -0
  513. package/src/components/heading/Heading.mdx +206 -0
  514. package/src/components/heading/Heading.stories.tsx +169 -0
  515. package/src/components/heading/Heading.tsx +124 -0
  516. package/src/components/heading/index.ts +8 -0
  517. package/src/components/heading-group/HeadingGroup.mdx +521 -0
  518. package/src/components/heading-group/HeadingGroup.stories.tsx +353 -0
  519. package/src/components/heading-group/HeadingGroup.tsx +396 -0
  520. package/src/components/heading-group/index.ts +7 -0
  521. package/src/components/hero/Hero.mdx +742 -0
  522. package/src/components/hero/Hero.stories.tsx +527 -0
  523. package/src/components/hero/Hero.tsx +807 -0
  524. package/src/components/hero/index.ts +1 -0
  525. package/src/components/icon/Icon.mdx +329 -0
  526. package/src/components/icon/Icon.stories.tsx +398 -0
  527. package/src/components/icon/Icon.tsx +97 -0
  528. package/src/components/icon/index.ts +2 -0
  529. package/src/components/icon-button/IconButton.mdx +206 -0
  530. package/src/components/icon-button/IconButton.stories.tsx +341 -0
  531. package/src/components/icon-button/IconButton.tsx +273 -0
  532. package/src/components/icon-button/index.ts +1 -0
  533. package/src/components/item-row/ItemRow.mdx +533 -0
  534. package/src/components/item-row/ItemRow.stories.tsx +434 -0
  535. package/src/components/item-row/ItemRow.tsx +676 -0
  536. package/src/components/item-row/index.ts +9 -0
  537. package/src/components/list-row/ListRow.mdx +404 -0
  538. package/src/components/list-row/ListRow.stories.tsx +404 -0
  539. package/src/components/list-row/ListRow.tsx +424 -0
  540. package/src/components/list-row/index.ts +1 -0
  541. package/src/components/menu/Menu.mdx +268 -0
  542. package/src/components/menu/Menu.stories.tsx +455 -0
  543. package/src/components/menu/Menu.tsx +452 -0
  544. package/src/components/menu/index.ts +1 -0
  545. package/src/components/modal/Modal.mdx +854 -0
  546. package/src/components/modal/Modal.stories.tsx +881 -0
  547. package/src/components/modal/Modal.tsx +1434 -0
  548. package/src/components/modal/index.ts +1 -0
  549. package/src/components/nav-link/NavLink.mdx +196 -0
  550. package/src/components/nav-link/NavLink.stories.tsx +243 -0
  551. package/src/components/nav-link/NavLink.tsx +222 -0
  552. package/src/components/nav-link/index.ts +1 -0
  553. package/src/components/number-field/NumberField.mdx +223 -0
  554. package/src/components/number-field/NumberField.stories.tsx +291 -0
  555. package/src/components/number-field/NumberField.tsx +388 -0
  556. package/src/components/number-field/index.ts +6 -0
  557. package/src/components/pagination/Pagination.mdx +305 -0
  558. package/src/components/pagination/Pagination.stories.tsx +333 -0
  559. package/src/components/pagination/Pagination.tsx +343 -0
  560. package/src/components/pagination/index.ts +8 -0
  561. package/src/components/popover-surface/PopoverSurface.mdx +158 -0
  562. package/src/components/popover-surface/PopoverSurface.stories.tsx +421 -0
  563. package/src/components/popover-surface/index.ts +1 -0
  564. package/src/components/progress-bar/ProgressBar.mdx +802 -0
  565. package/src/components/progress-bar/ProgressBar.stories.tsx +533 -0
  566. package/src/components/progress-bar/ProgressBar.tsx +654 -0
  567. package/src/components/progress-bar/index.ts +9 -0
  568. package/src/components/promo-sticker/PromoSticker.mdx +436 -0
  569. package/src/components/promo-sticker/PromoSticker.stories.tsx +363 -0
  570. package/src/components/promo-sticker/PromoSticker.tsx +313 -0
  571. package/src/components/promo-sticker/index.ts +7 -0
  572. package/src/components/promo-surface/PromoSurface.mdx +399 -0
  573. package/src/components/promo-surface/PromoSurface.stories.tsx +270 -0
  574. package/src/components/promo-surface/PromoSurface.tsx +305 -0
  575. package/src/components/promo-surface/index.ts +7 -0
  576. package/src/components/radio/Radio.mdx +243 -0
  577. package/src/components/radio/Radio.stories.tsx +307 -0
  578. package/src/components/radio/Radio.tsx +288 -0
  579. package/src/components/radio/index.ts +1 -0
  580. package/src/components/radio-group/RadioGroup.mdx +119 -0
  581. package/src/components/radio-group/RadioGroup.stories.tsx +225 -0
  582. package/src/components/radio-group/RadioGroup.tsx +139 -0
  583. package/src/components/radio-group/index.ts +1 -0
  584. package/src/components/select/Select.mdx +241 -0
  585. package/src/components/select/Select.stories.tsx +404 -0
  586. package/src/components/select/Select.tsx +381 -0
  587. package/src/components/select/index.ts +1 -0
  588. package/src/components/select-field/SelectField.mdx +324 -0
  589. package/src/components/select-field/SelectField.stories.tsx +460 -0
  590. package/src/components/select-field/SelectField.tsx +138 -0
  591. package/src/components/select-field/index.ts +1 -0
  592. package/src/components/skeleton/Skeleton.mdx +194 -0
  593. package/src/components/skeleton/Skeleton.stories.tsx +260 -0
  594. package/src/components/skeleton/Skeleton.tsx +107 -0
  595. package/src/components/skeleton/index.ts +1 -0
  596. package/src/components/split-button/SplitButton.mdx +445 -0
  597. package/src/components/split-button/SplitButton.stories.tsx +465 -0
  598. package/src/components/split-button/SplitButton.tsx +361 -0
  599. package/src/components/split-button/index.ts +7 -0
  600. package/src/components/status-summary-bar/StatusSummaryBar.mdx +338 -0
  601. package/src/components/status-summary-bar/StatusSummaryBar.stories.tsx +408 -0
  602. package/src/components/status-summary-bar/StatusSummaryBar.tsx +428 -0
  603. package/src/components/status-summary-bar/index.ts +8 -0
  604. package/src/components/subject-lookup-field/SubjectLookupField.mdx +378 -0
  605. package/src/components/subject-lookup-field/SubjectLookupField.stories.tsx +393 -0
  606. package/src/components/subject-lookup-field/SubjectLookupField.tsx +1079 -0
  607. package/src/components/subject-lookup-field/index.ts +11 -0
  608. package/src/components/switch/Switch.mdx +376 -0
  609. package/src/components/switch/Switch.stories.tsx +296 -0
  610. package/src/components/switch/Switch.tsx +483 -0
  611. package/src/components/switch/index.ts +1 -0
  612. package/src/components/table/Table.mdx +575 -0
  613. package/src/components/table/Table.stories.tsx +1049 -0
  614. package/src/components/table/Table.tsx +745 -0
  615. package/src/components/table/TableConsumers.stories.tsx +195 -0
  616. package/src/components/table/_tableFixtures.ts +1189 -0
  617. package/src/components/table/index.ts +22 -0
  618. package/src/components/text-field/TextField.mdx +479 -0
  619. package/src/components/text-field/TextField.stories.tsx +366 -0
  620. package/src/components/text-field/TextField.tsx +391 -0
  621. package/src/components/text-field/index.ts +8 -0
  622. package/src/components/text-link/TextLink.mdx +353 -0
  623. package/src/components/text-link/TextLink.stories.tsx +458 -0
  624. package/src/components/text-link/TextLink.tsx +504 -0
  625. package/src/components/text-link/index.ts +10 -0
  626. package/src/components/textarea/Textarea.mdx +244 -0
  627. package/src/components/textarea/Textarea.stories.tsx +371 -0
  628. package/src/components/textarea/Textarea.tsx +489 -0
  629. package/src/components/textarea/index.ts +9 -0
  630. package/src/components/tooltip/Tooltip.mdx +462 -0
  631. package/src/components/tooltip/Tooltip.stories.tsx +500 -0
  632. package/src/components/tooltip/Tooltip.tsx +756 -0
  633. package/src/components/tooltip/index.ts +13 -0
  634. package/src/components/unit-field/UnitField.mdx +215 -0
  635. package/src/components/unit-field/UnitField.stories.tsx +291 -0
  636. package/src/components/unit-field/UnitField.tsx +255 -0
  637. package/src/components/unit-field/index.ts +7 -0
  638. package/src/icons/icon-registry.generated.ts +510 -0
  639. package/src/icons/icon-types.generated.ts +256 -0
  640. package/src/index.ts +71 -0
  641. package/src/internal/BottomSheet.tsx +714 -0
  642. package/src/internal/FodsProvider.tsx +36 -0
  643. package/src/internal/MotionCaret.tsx +53 -0
  644. package/src/internal/NumberFormatInput.tsx +276 -0
  645. package/src/internal/SummaryDonut.tsx +359 -0
  646. package/src/internal/buttonSegment.ts +241 -0
  647. package/src/internal/collapseRoom.ts +130 -0
  648. package/src/internal/comboboxKeys.ts +90 -0
  649. package/src/internal/contentPresence.ts +46 -0
  650. package/src/internal/dayCell.ts +274 -0
  651. package/src/internal/dialogPortal.ts +50 -0
  652. package/src/internal/donutSweeps.ts +77 -0
  653. package/src/internal/enterOnViewGeometry.ts +53 -0
  654. package/src/internal/faqItem.ts +104 -0
  655. package/src/internal/floatingLabelMotion.tsx +109 -0
  656. package/src/internal/formBlockContext.ts +27 -0
  657. package/src/internal/heightRoom.ts +135 -0
  658. package/src/internal/numberSeparators.ts +93 -0
  659. package/src/internal/overlayMotion.tsx +32 -0
  660. package/src/internal/paginationItem.ts +106 -0
  661. package/src/internal/popoverSurface.ts +78 -0
  662. package/src/internal/portalContainer.ts +11 -0
  663. package/src/internal/progressBarItem.ts +356 -0
  664. package/src/internal/selectionControlText.ts +42 -0
  665. package/src/internal/statusSummaryParts.tsx +475 -0
  666. package/src/internal/summaryMotion.ts +111 -0
  667. package/src/internal/table/ChildConnector.tsx +57 -0
  668. package/src/internal/table/ChildRowPrefix.tsx +21 -0
  669. package/src/internal/table/ColumnSettings.tsx +194 -0
  670. package/src/internal/table/ScrollRegion.tsx +176 -0
  671. package/src/internal/table/TableEmpty.tsx +99 -0
  672. package/src/internal/table/TableLayout.tsx +29 -0
  673. package/src/internal/table/TableLoadStatus.tsx +60 -0
  674. package/src/internal/table/TableMobile.tsx +582 -0
  675. package/src/internal/table/TruncatedCell.tsx +35 -0
  676. package/src/internal/table/emptyValue.ts +11 -0
  677. package/src/internal/table/features.ts +44 -0
  678. package/src/internal/table/recipes.ts +263 -0
  679. package/src/internal/table/rowClick.ts +8 -0
  680. package/src/internal/table/types.ts +342 -0
  681. package/src/internal/tailwind-variants.ts +65 -0
  682. package/src/internal/tooltipContext.ts +15 -0
  683. package/src/internal/tw-merge-config.generated.ts +275 -0
  684. package/src/internal/useAnchoredPanel.ts +340 -0
  685. package/src/internal/useCountUp.ts +65 -0
  686. package/src/internal/useDateFieldTrigger.tsx +357 -0
  687. package/src/internal/useEChart.ts +88 -0
  688. package/src/internal/useEnterOnView.ts +80 -0
  689. package/src/internal/useFloatingBar.ts +125 -0
  690. package/src/internal/useFormReset.ts +47 -0
  691. package/src/internal/useIsMobile.ts +64 -0
  692. package/src/internal/useNoImplicitSubmit.ts +41 -0
  693. package/src/internal/useOneRowOverflow.ts +103 -0
  694. package/src/internal/usePrefersReducedMotion.ts +27 -0
  695. package/src/internal/useReturnFocus.ts +34 -0
  696. package/src/internal/utils.ts +58 -0
  697. package/src/recipes/EmptyState.stories.tsx +105 -0
  698. package/src/recipes/Form.stories.tsx +355 -0
  699. package/src/recipes/ModalWithForm.stories.tsx +219 -0
  700. package/src/recipes/Recipes.mdx +61 -0
  701. package/src/recipes/TableWithFilters.stories.tsx +278 -0
  702. package/src/storybook/FodsFamily.tsx +39 -0
  703. package/src/storybook/Section.tsx +36 -0
  704. package/src/storybook/a11y.ts +24 -0
  705. package/src/storybook/assets/banner-character-bartender.webp +0 -0
  706. package/src/storybook/assets/banner-invoice-sheet-left.webp +0 -0
  707. package/src/storybook/assets/banner-invoice-sheet-right.webp +0 -0
  708. package/src/storybook/assets/invoice-hero.webp +0 -0
  709. package/src/storybook/assets/invoice.webp +0 -0
  710. package/src/storybook/assets/section-document-info.svg +21 -0
  711. package/src/storybook/assets/section-gear-checklist.svg +11 -0
  712. package/src/storybook/assets/section-person-arrow-in.svg +15 -0
  713. package/src/storybook/assets/section-person-arrow-out.svg +22 -0
  714. package/src/storybook/assets/section-receipt-dollar.svg +23 -0
  715. package/src/storybook/assets/table-empty-folder-empty.png +0 -0
  716. package/src/storybook/assets/table-empty-folder-magnifying-glass.png +0 -0
  717. package/src/storybook/assets/table-empty-funnel.png +0 -0
  718. package/src/storybook/assets/table-empty-load-failed.png +0 -0
  719. package/src/storybook/assets/wallet-spot.png +0 -0
  720. package/src/storybook/assets.d.ts +17 -0
  721. package/src/storybook/componentDoc.ts +41 -0
  722. package/src/storybook/fitFrame.tsx +70 -0
  723. package/src/storybook/forceStates.tsx +647 -0
  724. package/src/storybook/illustrations.tsx +66 -0
  725. package/src/storybook/viewportFrame.tsx +58 -0
  726. package/src/styles/assets/label-brush-1.svg +6 -0
  727. package/src/styles/assets/pattern-dark.svg +113 -0
  728. package/src/styles/base.css +106 -0
  729. package/src/styles/index.css +15 -0
  730. package/src/styles/motion.css +157 -0
  731. package/src/styles/promo-sticker.css +27 -0
  732. package/src/styles/promo-surface.css +49 -0
  733. package/src/styles/shared.css +11 -0
  734. package/src/styles/theme.generated.css +314 -0
  735. package/src/styles/theme.map.json +278 -0
  736. package/src/styles/tracking.generated.css +12 -0
  737. package/src/tokens/index.ts +4 -0
  738. package/src/tokens/tokens.generated.ts +542 -0
@@ -0,0 +1,399 @@
1
+ import { Meta, Canvas, Controls } from '@storybook/addon-docs/blocks';
2
+ import * as PromoSurfaceStories from './PromoSurface.stories';
3
+
4
+
5
+ <Meta of={PromoSurfaceStories} tags={['autodocs']} />
6
+
7
+ # PromoSurface
8
+
9
+ ## Metadata
10
+
11
+ - **Layer:** atom
12
+ - **Kind:** structure
13
+ - **Status:** draft
14
+ - **Tokens used:** `--bg-inverse`, `--bg-secondary`, `--radius-800`, `--secondary-solid`, `--secondary-subtle`
15
+ - **Manifest version:** `1.5.0`
16
+ - **Storybook:** [design-system-atoms-promosurface](?path=/docs/design-system-atoms-promosurface--docs)
17
+
18
+ ## Overview
19
+
20
+ **PromoSurface** is the plaque behind a promotional panel on a **public page** — fill, a tiled
21
+ brand pattern, and a mask that decides where the pattern shows through. Two components consume it:
22
+ **Hero**, the first-screen panel, and **Banner**. It is chrome only: nothing lives inside it. The
23
+ consumer composes its own text column and visual **on top** and swaps this instance to change tone,
24
+ so adding a surface tone never multiplies either consumer's own variant matrix.
25
+
26
+ **Do not** use it for in-app cards, sections or callouts — those take a plain background fill
27
+ (`--bg-primary`, `--bg-secondary`) with no pattern. PromoSurface is a public-page component; it does not exist to make an ordinary panel look
28
+ "branded".
29
+
30
+ ## Rationale
31
+
32
+ The fill, the pattern and the veil move together as **one tone decision**, so pulling them out of
33
+ Hero's and Banner's own composition keeps a four-tone palette from turning into a multiplier on
34
+ either consumer's variant matrix. **Layout** lives on the surface rather than on either consumer
35
+ because the veil's geometry — which part of the plaque stays clear of the pattern — has to be
36
+ authored per layout, not computed at render time. The result is one shared atom that Hero and
37
+ Banner each swap by instance instead of re-declaring for themselves.
38
+
39
+ ## Anatomy
40
+
41
+ Three painted layers, bottom to top (manifest `chrome.layers`) — rendered by **two** DOM nodes:
42
+
43
+ - **Panel fill** — the root `<div>` (`data-fods-part="root"`). Its own background carries one of
44
+ the four Surface fills, clipped to `rounded-800` (`--radius-800`) by `overflow-hidden`. It is
45
+ `relative` and `pointer-events-none`, and deliberately carries **no width, height or inset**.
46
+ - **Pattern tile** — a `<span>` (`data-fods-part="pattern"`) at `absolute inset-0`, class
47
+ `fods-promo-surface-pattern`. `background-image: url(pattern-dark.svg)`,
48
+ `background-repeat: repeat` and `background-size: 149.33px 156px` live in
49
+ `styles/promo-surface.css` (part of the package's `shared.css`). That size
50
+ is the **motif period**, not the painted image: `chrome.pattern.tile-size` (1.3.2) states both —
51
+ the 896 × 468 image is a 6 × 3 grid of one motif, so the motif repeats at about 149 × 156. Its
52
+ opacity is a per-Surface constant.
53
+ - **Veil** — **not a third element.** It is the `mask-image` (plus `-webkit-mask-image`) on that
54
+ same pattern node: an elliptical `radial-gradient` that is transparent at the core, 18% black at
55
+ the mid stop and per-surface black at 100%. By definition a mask sits above the `background-image`
56
+ it masks, which is how three layers fit into two DOM nodes.
57
+
58
+ The gradient itself is authored in the stylesheet; the component only hands the pattern node six
59
+ CSS custom properties inline (per-instance values a stylesheet cannot know), and nothing else:
60
+
61
+ ```css
62
+ .fods-promo-surface-pattern {
63
+ mask-image: radial-gradient(
64
+ ellipse var(--promo-veil-rx) var(--promo-veil-ry) at var(--promo-veil-cx) var(--promo-veil-cy),
65
+ transparent 0%,
66
+ color-mix(in srgb, black 18%, transparent) var(--promo-veil-mid),
67
+ color-mix(in srgb, black var(--promo-veil-edge), transparent) 100%
68
+ );
69
+ }
70
+ ```
71
+
72
+ Those are CSS custom properties, not design tokens — the mask's black is an alpha channel and the
73
+ five geometry values are percentages, so none of them has a token.
74
+
75
+ Consumer content — text column, visual, slots — composes **above** this whole stack, never inside
76
+ it. The props type is `Omit<React.HTMLAttributes<HTMLDivElement>, 'role' | 'children'>`, so
77
+ "nothing lives inside it" is enforced by the **compiler**, not by a comment.
78
+
79
+ ## Variants
80
+
81
+ Two **equally-ranked** axes, twelve combinations (3 × 4). `layout` sets the veil geometry;
82
+ `surface` sets the fill.
83
+
84
+ <Canvas of={PromoSurfaceStories.Matrix} />
85
+
86
+ <table>
87
+ <thead>
88
+ <tr><th>Axis</th><th>Values</th><th>Decides</th></tr>
89
+ </thead>
90
+ <tbody>
91
+ <tr>
92
+ <td><code>layout</code></td>
93
+ <td><code>vertical</code> · <code>side</code> · <code>top</code></td>
94
+ <td>The veil's geometry — which part of the plaque stays clear of the pattern.</td>
95
+ </tr>
96
+ <tr>
97
+ <td><code>surface</code></td>
98
+ <td><code>brand</code> · <code>utility</code> · <code>solid</code> · <code>inverse</code></td>
99
+ <td>The panel fill, and with it the ink the consumer must use on top.</td>
100
+ </tr>
101
+ </tbody>
102
+ </table>
103
+
104
+ ### Layout — the veil geometry
105
+
106
+ Pick it from **where the copy sits**, never from the breakpoint (manifest `intent.rules[0]`). The
107
+ numbers below are the gradient's centre and its **radii** as percentages of the panel's own width
108
+ and height (`VEIL_GEOMETRY`); a radius above 100% runs past the panel edge, so the outermost stop
109
+ is never reached inside the visible area — deliberate on `side` and `top`, which fade rather than
110
+ complete.
111
+
112
+ <table>
113
+ <thead>
114
+ <tr>
115
+ <th>Layout</th>
116
+ <th>Clear area</th>
117
+ <th style={{ textAlign: 'right' }}>Centre (cx / cy)</th>
118
+ <th style={{ textAlign: 'right' }}>Radii (rx / ry)</th>
119
+ <th style={{ textAlign: 'right' }}>Mid stop</th>
120
+ </tr>
121
+ </thead>
122
+ <tbody>
123
+ <tr>
124
+ <td><code>vertical</code></td>
125
+ <td>A band down the middle; pattern strongest along the left and right edges — a wide panel with centred copy.</td>
126
+ <td style={{ textAlign: 'right' }}><code>50%</code> / <code>50%</code></td>
127
+ <td style={{ textAlign: 'right' }}><code>50%</code> / <code>83%</code></td>
128
+ <td style={{ textAlign: 'right' }}><code>57%</code></td>
129
+ </tr>
130
+ <tr>
131
+ <td><code>side</code></td>
132
+ <td>The left of the plaque; pattern builds toward the right edge — copy in a left-hand column with a visual opposite it.</td>
133
+ <td style={{ textAlign: 'right' }}><code>9%</code> / <code>50%</code></td>
134
+ <td style={{ textAlign: 'right' }}><code>91%</code> / <code>159%</code></td>
135
+ <td style={{ textAlign: 'right' }}><code>45%</code></td>
136
+ </tr>
137
+ <tr>
138
+ <td><code>top</code></td>
139
+ <td>A band across the top; pattern builds downward — a tall stacked panel with copy above the visual.</td>
140
+ <td style={{ textAlign: 'right' }}><code>50%</code> / <code>22%</code></td>
141
+ <td style={{ textAlign: 'right' }}><code>250%</code> / <code>38%</code></td>
142
+ <td style={{ textAlign: 'right' }}><code>45%</code></td>
143
+ </tr>
144
+ </tbody>
145
+ </table>
146
+
147
+ Put the copy **inside** the clear area of the Layout chosen. A panel whose copy falls outside it
148
+ renders the headline on top of the pattern, which is the one thing the veil exists to prevent.
149
+
150
+ ### Surface — fill and the ink that pairs with it
151
+
152
+ This is the most important table on this component: **mixing one surface's fill with another
153
+ surface's ink is the only way it fails contrast with no code defect.** The surface itself renders no
154
+ text, so every contrast obligation belongs to what the consumer composes on top.
155
+
156
+ <Canvas of={PromoSurfaceStories.InkPairing} />
157
+
158
+ <table>
159
+ <thead>
160
+ <tr>
161
+ <th>Surface</th>
162
+ <th>Fill token (class)</th>
163
+ <th>Ink the consumer must use (class)</th>
164
+ <th style={{ textAlign: 'right' }}>Pattern opacity</th>
165
+ <th style={{ textAlign: 'right' }}>Veil edge alpha</th>
166
+ </tr>
167
+ </thead>
168
+ <tbody>
169
+ <tr>
170
+ <td><code>brand</code> (default)</td>
171
+ <td><code>--secondary-subtle</code> (<code>bg-secondary-subtle</code>)</td>
172
+ <td><code>--text-primary</code> (<code>text-text-primary</code>)</td>
173
+ <td style={{ textAlign: 'right' }}><code>0.08</code></td>
174
+ <td style={{ textAlign: 'right' }}><code>70%</code></td>
175
+ </tr>
176
+ <tr>
177
+ <td><code>utility</code></td>
178
+ <td><code>--bg-secondary</code> (<code>bg-background-secondary</code>)</td>
179
+ <td><code>--text-primary</code> (<code>text-text-primary</code>)</td>
180
+ <td style={{ textAlign: 'right' }}><code>0.08</code></td>
181
+ <td style={{ textAlign: 'right' }}><code>50%</code></td>
182
+ </tr>
183
+ <tr>
184
+ <td><code>solid</code></td>
185
+ <td><code>--secondary-solid</code> (<code>bg-secondary-solid</code>)</td>
186
+ <td><code>--secondary-foreground</code> (<code>text-secondary-foreground</code>)</td>
187
+ <td style={{ textAlign: 'right' }}><code>0.25</code></td>
188
+ <td style={{ textAlign: 'right' }}><code>100%</code></td>
189
+ </tr>
190
+ <tr>
191
+ <td><code>inverse</code></td>
192
+ <td><code>--bg-inverse</code> (<code>bg-background-inverse</code>)</td>
193
+ <td><code>--text-inverted</code> (<code>text-text-inverted</code>)</td>
194
+ <td style={{ textAlign: 'right' }}><code>0.25</code></td>
195
+ <td style={{ textAlign: 'right' }}><code>100%</code></td>
196
+ </tr>
197
+ </tbody>
198
+ </table>
199
+
200
+ `solid` and `inverse` are both dark plaques and are easy to confuse: `solid` is the **bright** brand
201
+ fill (`--secondary-solid`, blue/600), `inverse` is the **deep** one (`--bg-inverse`, blue/900) and
202
+ matches what `Surface=Inverse` means elsewhere in FODS, e.g. Sticky Context Bar.
203
+
204
+ **Pattern strength is a per-surface constant, not an instance control** (manifest
205
+ `intent.rules[2]`). The two numbers in the last two columns are the whole tuning: the light plaques
206
+ hold the pattern back at the veil's edge, the two dark ones reveal it fully and are dialled at the
207
+ tile's opacity instead. There is no `opacity` prop, and the four values are tuned so all four
208
+ plaques read at one weight by eye. The tile itself is **one shared asset**, never recoloured or
209
+ re-cut per surface.
210
+
211
+ **The tile must be fully opaque, and the opacity column is the only strength dial.** The four
212
+ values are measured against an opaque tile, so a tile carrying its own alpha would multiply into all
213
+ four at once — which a consumer cannot correct per surface without breaking exactly the parity the
214
+ values exist to hold (`chrome.pattern.asset`, 1.2.0). They are also measured **before the veil**:
215
+ what reaches the eye is the value times the veil's edge alpha, so Brand lands at 0.056 and Utility
216
+ at 0.04 while Solid and Inverse arrive whole.
217
+
218
+ The repo tile used to draw its `#226FA1` strokes at `fill-opacity: 0.5`, which built the pattern at
219
+ about half the drawn strength and near-invisible on Brand and Utility; this component compensated by
220
+ painting the manifest number doubled. `assets/cta-images/pattern-dark.svg` has since been re-cut
221
+ without the alpha, so the painted opacity is now the manifest value verbatim.
222
+
223
+ **Manifest 1.3.0 retuned the column** in Figma: Brand and Utility went `0.06` → `0.03`, Solid
224
+ `0.29` → `0.20` and Inverse `0.22` → `0.20`, so the two dark plaques now share one value. Only the
225
+ strength moved — the veil stops, the geometry, the tile asset and its scale are untouched, and it is
226
+ still a per-surface constant rather than an instance control.
227
+
228
+ **Manifest 1.4.0 strengthened the column again** (2026-10-08): Brand and Utility `0.03` → `0.08`,
229
+ Solid and Inverse `0.20` → `0.25`. The light pair and the dark pair each still share one value; the
230
+ veil stops, the geometry, the tile asset and its scale are unchanged. If you have a screenshot or a Figma
231
+ frame from between 2026-09-16 and 2026-10-08, the pattern in it is weaker than what ships now.
232
+
233
+ ## Sizes
234
+
235
+ **No size axis** (manifest `intent.sizing`). The component takes no width or height of its own —
236
+ both painted layers stretch to the panel on both axes, and the consumer positions the surface from
237
+ the outside. A **fixed-height surface is the canonical breakage**: it either stops short of the
238
+ plaque or overruns it, and either result reads as a rendering fault rather than a design choice.
239
+
240
+ <Canvas of={PromoSurfaceStories.StretchContract} />
241
+
242
+ The demo panels in **`Playground` and `Matrix`** are sized from the manifest's
243
+ `delivery.storybookNote` — `vertical` and `side` at 1200 × 320, `top` at 358 × 662, the panel
244
+ sizes Hero and Banner actually ship at the widest and narrowest breakpoints. `InkPairing`
245
+ (280 × 160) and `StretchContract` (600 × 320) deliberately do not: the first is a swatch grid for
246
+ the fill/ink pairing and the second demonstrates the stretch contract, and neither is making a
247
+ claim about veil geometry. Note that even the sized panels carry `max-width: 100%`, so in a narrow
248
+ docs canvas the 1200-wide cells render narrower while the height holds — the proportions, and with
249
+ them the veil, shift accordingly. They are not decoration: the veil geometry is relative to the
250
+ panel's own proportions, so a square preview would put the clear area in the wrong place in every
251
+ one of the twelve cells.
252
+
253
+ ## States
254
+
255
+ **This component has no states**, so there is no States story and no `<Canvas>` here. A background
256
+ plaque has no interaction and no lifecycle: it takes no input, holds no focus, does not load and is
257
+ not hovered — it is either rendered with the chosen `layout` and `surface`, or not rendered at all
258
+ (manifest `intent.states`).
259
+
260
+ The manifest is explicit about the consequence for this page (`delivery.storybookStates`): *"The
261
+ Definition of Done's five-interaction-states box does not apply: this component has no states (see
262
+ intent.states). Cover the 12 Layout x Surface cells instead."* That coverage is the
263
+ [Matrix](#variants) story above.
264
+
265
+ Whatever states the consumer's content carries — hover on a button, focus on a link — belong
266
+ entirely to that content.
267
+
268
+ **Motion: none.** The manifest declares the plaque static (1.4.1 `motion.none`: „static surface“) and lists no
269
+ `inherits` — the content slot's motion is the content's own, not the surface's.
270
+
271
+ ## API
272
+
273
+ <Controls />
274
+
275
+ Two props, `layout` and `surface`, and deliberately **not** a single generic `variant`: the manifest
276
+ records Layout under `axes.variant` only because the schema's axis keys are fixed, and
277
+ `properties[].maps` overrides that — *"NOT the generic variant prop: … the component has two
278
+ equally-ranked tone axes and neither is 'the' variant."* Values are lowercase-kebab in code; the
279
+ Figma casing never reaches it.
280
+
281
+ The props type extends `Omit<React.HTMLAttributes<HTMLDivElement>, 'role' | 'children'>`. Both
282
+ omissions are load-bearing: `children` makes "nothing lives inside it" a compile error rather than a
283
+ convention, and dropping `role` keeps the element role-free as `delivery.react` requires — an
284
+ accidental `role="group"` on an `aria-hidden` node is something axe would not report.
285
+
286
+ ## Do / Don't
287
+
288
+ - ✅ Match `layout` to where the consumer's copy actually sits.
289
+ - ✅ Use the ink token that pairs with the chosen `surface` (see the table above).
290
+ - ✅ Let the surface stretch to the panel on both axes (`absolute inset-0` in a `relative` panel).
291
+ - ✅ Treat pattern strength as fixed per `surface`.
292
+ - ✅ Compose the consumer's text and visual above the whole stack, as a sibling.
293
+ - ✅ Use it as the bottom layer of a Hero or Banner panel on a public page.
294
+ - ✅ Reuse the tile already in the frontend assets.
295
+ - ❌ Pick `layout` from the breakpoint.
296
+ - ❌ Mix one surface's fill with another surface's ink.
297
+ - ❌ Give it a fixed height.
298
+ - ❌ Retune the pattern's opacity or the veil's alpha on one instance — and remember **the veil is a
299
+ mask, not a colour overlay**: its alpha decides where the pattern shows, the core hides it and the
300
+ edges reveal it, so **raising the alpha makes the pattern MORE visible, not less**.
301
+ - ❌ Put content, text or an icon inside the surface itself.
302
+ - ❌ Reach for it as a background for an in-app card, section or callout — those take a plain
303
+ background fill (`--bg-primary`, `--bg-secondary`) with no pattern.
304
+ - ❌ Export a fresh tile from Figma or re-cut one per surface.
305
+
306
+ ## Accessibility
307
+
308
+ - **Keyboard** — nothing. The surface is **not part of the tab order**: no `tabindex`, no
309
+ interactive element and no focusable child in the component.
310
+ - **ARIA** — the root carries `aria-hidden="true"` and **no role**. The whole component is
311
+ decorative, renders no text and has no accessible name to carry, because there is nothing to name.
312
+ `role` is `Omit`ted from the props type so it cannot be added by accident.
313
+ - **Screen reader** — announces nothing in any of the twelve cells; both painted layers are out of
314
+ the accessibility tree. Everything a user hears comes from the consumer's sibling content above
315
+ the surface.
316
+ - **Pointer** — `pointer-events-none` on the root. An `aria-hidden` layer that still swallowed
317
+ clicks would intercept them on their way to the copy and CTA composed above it.
318
+ - **Contrast** — the pattern tile and the veil are **decorative**: neither carries information on
319
+ its own, so neither is a graphical object WCAG **1.4.11** requires to meet a contrast minimum.
320
+ The pattern never sits under a headline — the veil's quiet core is the reading area. Text contrast
321
+ is entirely the consumer's, via the fill/ink pairing table. One recorded exception:
322
+ `--secondary-foreground` on `--secondary-solid` is **4.45:1**, an accepted brand exception scoped
323
+ to large or semibold copy — body-size copy on `solid` does not clear AA-Normal (manifest
324
+ `chrome.ink.note`).
325
+ - **Focus ring on the dark plaques** — `--outline-focus` is the same hex as `--secondary-solid`, so
326
+ the default ring is invisible on `solid`, and it measures **2.12:1** on `--bg-inverse`, under the
327
+ 3:1 non-text floor. Anything focusable composed on those two fills must swap to
328
+ `--outline-focus-inverse` (9.43:1 on `--bg-inverse`, 4.45:1 on `--secondary-solid`). Manifest
329
+ `gaps[0]`, status **resolved** — no new token needed. **That obligation belongs to the consumer,
330
+ not to this atom, which holds no focus itself.**
331
+ - **Motion** — none (manifest `motion.none`). The veil is a static mask and the pattern a static tile; the component declares
332
+ no animation class, so `prefers-reduced-motion` has nothing to do here.
333
+
334
+ Accessibility floor for every FODS component: `spec/01-foundations/accessibility.md`.
335
+
336
+ ## Usage
337
+
338
+ The surface is positioned from the outside. This is how the stories' `Panel` composes it, and how
339
+ Hero and Banner do it — the surface is a background **sibling**, never a wrapper.
340
+
341
+ <Canvas of={PromoSurfaceStories.Playground} />
342
+
343
+ ```tsx
344
+ // Good — surface stretched inside a `relative` panel, content as a sibling above it
345
+ <div className="relative">
346
+ <PromoSurface layout="side" surface="solid" className="absolute inset-0" />
347
+ <div className="relative z-10 p-800 text-secondary-foreground">
348
+ <h2 className="text-heading-lg font-semibold">Fakturujte za Acme s.r.o. online</h2>
349
+ <p className="text-body-sm">Vyzkoušejte to na firma@priklad.cz</p>
350
+ </div>
351
+ </div>
352
+ ```
353
+
354
+ ```tsx
355
+ // Don't — a height of its own instead of stretching (see the StretchContract story)
356
+ <PromoSurface layout="side" surface="brand" className="absolute inset-x-0 top-0 h-[180px]" />
357
+
358
+ // Don't — content inside the surface (also a TypeScript error: `children` is omitted)
359
+ <PromoSurface layout="vertical" surface="brand">
360
+ <h2>Fakturace pro Acme s.r.o.</h2>
361
+ </PromoSurface>
362
+
363
+ // Don't — `solid` fill with `inverse` ink; the fill/ink pairing is the whole rule
364
+ <PromoSurface layout="vertical" surface="solid" className="absolute inset-0" />
365
+ <p className="relative z-10 text-text-inverted">Acme s.r.o.</p>
366
+ ```
367
+
368
+ ## Related
369
+
370
+ - **Consumed by** — Hero and Banner, both via instance swap. Banner names its tone axis Brand /
371
+ Solid, the same values this atom's `surface` axis uses, so a Banner variant's Surface value passes
372
+ straight through with no mapping table (manifest `gaps[1]`, resolved).
373
+ - **Related surface** — Sticky Context Bar, the other FODS component whose `Surface=Inverse` binds
374
+ `--bg-inverse`.
375
+ - **Spec:** `spec/03-atoms/promo-surface.md`
376
+ and `promo-surface.manifest.json` (fill, radius, pattern opacity, veil stops and geometry per
377
+ variant).
378
+ - Not Radix-based — the component renders a plain `<div>` with one `<span>` inside.
379
+
380
+ ## Migration notes
381
+
382
+ **Motion (manifest 1.4.1, 2026-11-03) — documentation only.** The motion audit declares the plaque static
383
+ (`motion.none`). No code change.
384
+
385
+ **PromoSurface is a new component.** Per the upstream spec's `## Migration`: *"No old class names,
386
+ no legacy markup and no prior variant scheme map onto it — there is nothing to rebind and nothing to
387
+ deprecate."*
388
+
389
+ The **pattern tile** is not new. PromoSurface reuses the existing pattern tile (in this package `src/styles/assets/pattern-dark.svg`) rather than exporting a fresh one —
390
+ one tile serves every Layout and every Surface, and the only thing that differs between them is its
391
+ opacity. PromoSurface paints it at `background-size: 149.33px 156px`
392
+ (`styles/promo-surface.css`).
393
+
394
+ The file **used to** carry a built-in `fill-opacity: 0.5`, and the painted opacities were the spec
395
+ numbers doubled to compensate. Manifest 1.2.0 closed that: `chrome.pattern.asset` now requires a
396
+ fully opaque tile, because *"a tile carrying its own alpha multiplies into every one of the four
397
+ values at once, so a consumer cannot correct it per surface without breaking the parity the values
398
+ exist to hold."* The asset was re-cut without the alpha and the opacities here are the manifest
399
+ numbers verbatim.
@@ -0,0 +1,270 @@
1
+ import type { Meta, StoryObj } from '@storybook/react-vite';
2
+ import { PromoSurface } from './PromoSurface';
3
+ import { Section, Showcase } from '../../storybook/Section';
4
+ import { componentDoc } from '../../storybook/componentDoc';
5
+
6
+ const LAYOUTS = ['vertical', 'side', 'top'] as const;
7
+ const SURFACES = ['brand', 'utility', 'solid', 'inverse'] as const;
8
+
9
+ /**
10
+ * Demo panel geometry, straight from `promo-surface.manifest.json`
11
+ * `delivery.storybookNote`:
12
+ *
13
+ * "A Matrix story needs a demo panel to sit in, because the surface has no
14
+ * intrinsic size, and the veil geometry is relative to the panel's own
15
+ * proportions — a square thumbnail misrepresents every cell. Demo Vertical and
16
+ * Side at 1200 x 320 and Top at 358 x 662; those are the panel sizes Hero and
17
+ * Banner actually ship at the widest and narrowest breakpoints."
18
+ *
19
+ * The numbers are therefore NOT decoration: a square preview would put the veil's
20
+ * clear area in the wrong place in every one of the twelve cells. They are inline
21
+ * styles rather than Tailwind arbitrary utilities because they are story scaffolding,
22
+ * not component design — nothing here should end up in the token lint's field of view.
23
+ */
24
+ const PANEL_SIZE: Record<(typeof LAYOUTS)[number], { width: number; height: number }> = {
25
+ vertical: { width: 1200, height: 320 },
26
+ side: { width: 1200, height: 320 },
27
+ top: { width: 358, height: 662 },
28
+ };
29
+
30
+ /** The ink each Surface pairs with (`chrome.ink`) — the consumer's obligation. */
31
+ const INK_CLASS: Record<(typeof SURFACES)[number], string> = {
32
+ brand: 'text-text-primary',
33
+ utility: 'text-text-primary',
34
+ solid: 'text-secondary-foreground',
35
+ inverse: 'text-text-inverted',
36
+ };
37
+
38
+ const INK_TOKEN: Record<(typeof SURFACES)[number], string> = {
39
+ brand: '--text-primary',
40
+ utility: '--text-primary',
41
+ solid: '--secondary-foreground',
42
+ inverse: '--text-inverted',
43
+ };
44
+
45
+ /**
46
+ * A demo panel: `relative` box at the manifest's shipping size, with the surface
47
+ * absolutely filling it. This is exactly how Hero and Banner compose it — the surface
48
+ * is a background SIBLING, never a wrapper, so content never lands inside it
49
+ * (`intent.whenToUse`: "It is chrome only: nothing lives inside it").
50
+ */
51
+ function Panel({
52
+ layout,
53
+ surface,
54
+ label,
55
+ }: {
56
+ layout: (typeof LAYOUTS)[number];
57
+ surface: (typeof SURFACES)[number];
58
+ label?: string;
59
+ }) {
60
+ const { width, height } = PANEL_SIZE[layout];
61
+
62
+ return (
63
+ <div className="flex max-w-full flex-col gap-200">
64
+ <div
65
+ className="relative max-w-full overflow-hidden"
66
+ style={{ width, height, maxWidth: '100%' }}
67
+ >
68
+ <PromoSurface layout={layout} surface={surface} className="absolute inset-0" />
69
+ {label && (
70
+ <p
71
+ className={`relative z-10 p-800 text-body-sm font-semibold ${INK_CLASS[surface]}`}
72
+ >
73
+ {label}
74
+ </p>
75
+ )}
76
+ </div>
77
+ <p className="text-body-xs text-text-secondary">
78
+ {layout} · {surface} — {width}×{height}
79
+ </p>
80
+ </div>
81
+ );
82
+ }
83
+
84
+ const meta = {
85
+ title: 'Design System/Atoms/PromoSurface',
86
+ component: PromoSurface,
87
+ parameters: {
88
+ layout: 'fullscreen',
89
+ docs: {
90
+ description: {
91
+ component: componentDoc({
92
+ summary:
93
+ 'The promo plaque — fill, tiled brand pattern and the veil mask that keeps the reading area clear. Chrome only: it renders no text, holds no children and carries no ARIA role. Hero and Banner compose their own content as a sibling layer above it.',
94
+ useCases: [
95
+ '`layout` picks the veil geometry from **where the copy sits**, never from the breakpoint — `vertical` clears a band down the middle, `side` clears the left, `top` clears a band across the top.',
96
+ '`surface` picks the fill from the page family, and the consumer must then use the ink that pairs with it (see the Ink pairing story).',
97
+ 'Position it yourself: the component takes no width or height of its own — typically `className="absolute inset-0"` inside a `relative` panel.',
98
+ ],
99
+ bestPractices: [
100
+ 'Let the surface stretch to the panel on both axes. A fixed-height surface is the canonical breakage — it either stops short of the plaque or overruns it.',
101
+ 'Never mix one surface\'s fill with another surface\'s ink. That is the one way this component fails contrast with no code defect.',
102
+ 'Pattern strength is a per-surface constant, not an instance control. Retuning opacity on one instance breaks the parity between the four tones.',
103
+ 'Compose content ABOVE the surface as a sibling, never inside it.',
104
+ 'Public pages only. In-app cards, sections and callouts take a plain `--bg-*` fill with no pattern.',
105
+ ],
106
+ knownIssues: [
107
+ 'The veil is a **mask**, not a colour overlay: its alpha decides where the pattern shows. The core hides the pattern and the edges reveal it, so raising the veil alpha makes the pattern MORE visible, not less.',
108
+ '`solid` and `inverse` are both dark plaques and easy to confuse. `solid` is the bright brand fill (`--secondary-solid`); `inverse` is the deep one (`--bg-inverse`).',
109
+ 'On `solid` and `inverse` the default focus ring is invisible or under the 3:1 non-text floor, so anything focusable the consumer composes on top must swap to `--outline-focus-inverse`. That obligation belongs to the consumer — this atom holds no focus.',
110
+ 'No interaction states exist on this component, so the Definition of Done\'s five-state box does not apply (manifest `delivery.storybookStates`). The 12 Layout × Surface cells are the coverage instead.',
111
+ ],
112
+ docsLink: {
113
+ label: 'spec/03-atoms/promo-surface.md',
114
+ },
115
+ }),
116
+ },
117
+ },
118
+ },
119
+ argTypes: {
120
+ layout: {
121
+ control: 'inline-radio',
122
+ options: LAYOUTS,
123
+ description: 'Veil geometry — which part of the plaque stays clear of the pattern.',
124
+ },
125
+ surface: {
126
+ control: 'inline-radio',
127
+ options: SURFACES,
128
+ description: 'Panel fill, and with it the ink the consumer must use on top.',
129
+ },
130
+ },
131
+ args: {
132
+ layout: 'vertical',
133
+ surface: 'brand',
134
+ },
135
+ } satisfies Meta<typeof PromoSurface>;
136
+
137
+ export default meta;
138
+ type Story = StoryObj<typeof meta>;
139
+
140
+ /**
141
+ * The interactive cell. Rendered inside a demo panel at the manifest's shipping size
142
+ * for the chosen layout, because the veil geometry is relative to the panel's own
143
+ * proportions.
144
+ */
145
+ export const Playground: Story = {
146
+ render: ({ layout = 'vertical', surface = 'brand' }) => (
147
+ <div className="p-800">
148
+ <Panel layout={layout} surface={surface} label="Content composes above the surface" />
149
+ </div>
150
+ ),
151
+ };
152
+
153
+ /**
154
+ * All 12 cells — Layout (rows) × Surface (columns).
155
+ *
156
+ * This is the component's coverage story in place of a States matrix: the manifest is
157
+ * explicit that "the Definition of Done's five-interaction-states box does not apply:
158
+ * this component has no states. Cover the 12 Layout x Surface cells instead."
159
+ */
160
+ export const Matrix: Story = {
161
+ parameters: { controls: { disable: true } },
162
+ render: () => (
163
+ <div className="p-800">
164
+ <Showcase>
165
+ {LAYOUTS.map(layout => (
166
+ <Section
167
+ key={layout}
168
+ title={layout}
169
+ description={
170
+ layout === 'vertical'
171
+ ? 'Clears a band down the middle, pattern along the left and right edges — a wide panel with centred copy.'
172
+ : layout === 'side'
173
+ ? 'Clears the left of the plaque, pattern builds toward the right edge — copy in a left-hand column with a visual opposite it.'
174
+ : 'Clears a band across the top, pattern builds downward — a tall stacked panel with copy above the visual.'
175
+ }
176
+ layout="row"
177
+ >
178
+ {SURFACES.map(surface => (
179
+ <Panel key={surface} layout={layout} surface={surface} />
180
+ ))}
181
+ </Section>
182
+ ))}
183
+ </Showcase>
184
+ </div>
185
+ ),
186
+ };
187
+
188
+ /**
189
+ * The fill / ink pairing table, rendered live. Mixing one surface's fill with another
190
+ * surface's ink is the failure the Surface axis exists to prevent (`intent.rules[1]`),
191
+ * and it is invisible in a static class list — so it gets its own story.
192
+ */
193
+ export const InkPairing: Story = {
194
+ parameters: { controls: { disable: true } },
195
+ render: () => (
196
+ <div className="p-800">
197
+ <Showcase>
198
+ <Section
199
+ title="Fill × ink"
200
+ description="Each plaque carries the ink token it pairs with. The surface itself renders no text — every contrast obligation belongs to the content composed on top."
201
+ layout="row"
202
+ >
203
+ {SURFACES.map(surface => (
204
+ <div
205
+ key={surface}
206
+ className="relative max-w-full overflow-hidden"
207
+ style={{ width: 280, height: 160 }}
208
+ >
209
+ <PromoSurface layout="vertical" surface={surface} className="absolute inset-0" />
210
+ <div className={`relative z-10 flex h-full flex-col justify-center gap-200 p-800 ${INK_CLASS[surface]}`}>
211
+ <p className="text-body-lg font-semibold">{surface}</p>
212
+ <p className="text-body-xs">{INK_TOKEN[surface]}</p>
213
+ </div>
214
+ </div>
215
+ ))}
216
+ </Section>
217
+ </Showcase>
218
+ </div>
219
+ ),
220
+ };
221
+
222
+ /**
223
+ * The two failure modes the spec calls out, side by side with the correct build.
224
+ *
225
+ * Left: a surface given a fixed height inside a taller panel — "the canonical way this
226
+ * breaks: it either stops short of the plaque or overruns it, and either result reads
227
+ * as a rendering fault rather than a design choice" (`intent.sizing`).
228
+ *
229
+ * Right: the same panel with the surface stretched on both axes.
230
+ */
231
+ export const StretchContract: Story = {
232
+ parameters: { controls: { disable: true } },
233
+ render: () => (
234
+ <div className="p-800">
235
+ <Showcase>
236
+ <Section
237
+ title="Don't — fixed height"
238
+ description="The surface stops short of the plaque. Reads as a rendering fault, not a design."
239
+ layout="row"
240
+ >
241
+ <div className="relative max-w-full" style={{ width: 600, height: 320 }}>
242
+ {/* Deliberately wrong: a height of its own instead of stretching. 180 of
243
+ the panel's 320 — the shortfall IS the anti-pattern being shown. */}
244
+ <PromoSurface
245
+ layout="side"
246
+ surface="brand"
247
+ className="absolute inset-x-0 top-0"
248
+ style={{ height: 180 }}
249
+ />
250
+ <p className="relative z-10 p-800 text-body-sm font-semibold text-text-primary">
251
+ Fixed height
252
+ </p>
253
+ </div>
254
+ </Section>
255
+ <Section
256
+ title="Do — stretched on both axes"
257
+ description="`absolute inset-0` inside a `relative` panel; the surface always matches the plaque's bounds."
258
+ layout="row"
259
+ >
260
+ <div className="relative max-w-full" style={{ width: 600, height: 320 }}>
261
+ <PromoSurface layout="side" surface="brand" className="absolute inset-0" />
262
+ <p className="relative z-10 p-800 text-body-sm font-semibold text-text-primary">
263
+ Stretched
264
+ </p>
265
+ </div>
266
+ </Section>
267
+ </Showcase>
268
+ </div>
269
+ ),
270
+ };