@invoiceonline/ui-react 0.0.0 → 0.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (731) hide show
  1. package/AGENTS.md +100 -0
  2. package/CHANGELOG.md +149 -0
  3. package/LICENSE +9 -0
  4. package/README.md +77 -1
  5. package/dist/assets/label-brush-1.svg +6 -0
  6. package/dist/assets/pattern-dark.svg +113 -0
  7. package/dist/components/action-row/ActionRow.d.ts +178 -0
  8. package/dist/components/action-row/ActionRow.js +340 -0
  9. package/dist/components/action-row/index.d.ts +2 -0
  10. package/dist/components/action-row/index.js +1 -0
  11. package/dist/components/alert/Alert.d.ts +314 -0
  12. package/dist/components/alert/Alert.js +446 -0
  13. package/dist/components/alert/index.d.ts +2 -0
  14. package/dist/components/alert/index.js +1 -0
  15. package/dist/components/anchored-panel/AnchoredPanel.d.ts +41 -0
  16. package/dist/components/anchored-panel/AnchoredPanel.js +72 -0
  17. package/dist/components/anchored-panel/index.d.ts +3 -0
  18. package/dist/components/anchored-panel/index.js +3 -0
  19. package/dist/components/badge/Badge.d.ts +146 -0
  20. package/dist/components/badge/Badge.js +258 -0
  21. package/dist/components/badge/index.d.ts +2 -0
  22. package/dist/components/badge/index.js +1 -0
  23. package/dist/components/banner/Banner.d.ts +209 -0
  24. package/dist/components/banner/Banner.js +339 -0
  25. package/dist/components/banner/index.d.ts +2 -0
  26. package/dist/components/banner/index.js +1 -0
  27. package/dist/components/button/Button.d.ts +54 -0
  28. package/dist/components/button/Button.js +312 -0
  29. package/dist/components/button/index.d.ts +2 -0
  30. package/dist/components/button/index.js +1 -0
  31. package/dist/components/button-group/ButtonGroup.d.ts +187 -0
  32. package/dist/components/button-group/ButtonGroup.js +217 -0
  33. package/dist/components/button-group/index.d.ts +2 -0
  34. package/dist/components/button-group/index.js +1 -0
  35. package/dist/components/card-select/CardSelect.d.ts +274 -0
  36. package/dist/components/card-select/CardSelect.js +561 -0
  37. package/dist/components/card-select/CardSelectGroup.d.ts +92 -0
  38. package/dist/components/card-select/CardSelectGroup.js +72 -0
  39. package/dist/components/card-select/index.d.ts +3 -0
  40. package/dist/components/card-select/index.js +3 -0
  41. package/dist/components/checkbox/Checkbox.d.ts +104 -0
  42. package/dist/components/checkbox/Checkbox.js +194 -0
  43. package/dist/components/checkbox/index.d.ts +2 -0
  44. package/dist/components/checkbox/index.js +1 -0
  45. package/dist/components/chip/Chip.d.ts +250 -0
  46. package/dist/components/chip/Chip.js +441 -0
  47. package/dist/components/chip/index.d.ts +2 -0
  48. package/dist/components/chip/index.js +1 -0
  49. package/dist/components/column-header/ColumnHeader.d.ts +144 -0
  50. package/dist/components/column-header/ColumnHeader.js +209 -0
  51. package/dist/components/column-header/index.d.ts +2 -0
  52. package/dist/components/column-header/index.js +1 -0
  53. package/dist/components/combobox-field/Combobox.d.ts +104 -0
  54. package/dist/components/combobox-field/Combobox.js +355 -0
  55. package/dist/components/combobox-field/ComboboxField.d.ts +76 -0
  56. package/dist/components/combobox-field/ComboboxField.js +98 -0
  57. package/dist/components/combobox-field/index.d.ts +3 -0
  58. package/dist/components/combobox-field/index.js +3 -0
  59. package/dist/components/date-picker/DatePicker.d.ts +53 -0
  60. package/dist/components/date-picker/DatePicker.js +329 -0
  61. package/dist/components/date-picker/index.d.ts +2 -0
  62. package/dist/components/date-picker/index.js +1 -0
  63. package/dist/components/divider/Divider.d.ts +81 -0
  64. package/dist/components/divider/Divider.js +93 -0
  65. package/dist/components/divider/index.d.ts +2 -0
  66. package/dist/components/divider/index.js +1 -0
  67. package/dist/components/drawer/Drawer.d.ts +128 -0
  68. package/dist/components/drawer/Drawer.js +367 -0
  69. package/dist/components/drawer/index.d.ts +2 -0
  70. package/dist/components/drawer/index.js +1 -0
  71. package/dist/components/dropdown-button/DropdownButton.d.ts +72 -0
  72. package/dist/components/dropdown-button/DropdownButton.js +122 -0
  73. package/dist/components/dropdown-button/index.d.ts +2 -0
  74. package/dist/components/dropdown-button/index.js +1 -0
  75. package/dist/components/faq/FAQ.d.ts +135 -0
  76. package/dist/components/faq/FAQ.js +258 -0
  77. package/dist/components/faq/index.d.ts +2 -0
  78. package/dist/components/faq/index.js +1 -0
  79. package/dist/components/field/Field.d.ts +119 -0
  80. package/dist/components/field/Field.js +332 -0
  81. package/dist/components/field/index.d.ts +2 -0
  82. package/dist/components/field/index.js +1 -0
  83. package/dist/components/field-pair/FieldPair.d.ts +210 -0
  84. package/dist/components/field-pair/FieldPair.js +335 -0
  85. package/dist/components/field-pair/index.d.ts +2 -0
  86. package/dist/components/field-pair/index.js +1 -0
  87. package/dist/components/file-upload/FileUpload.d.ts +137 -0
  88. package/dist/components/file-upload/FileUpload.js +434 -0
  89. package/dist/components/file-upload/index.d.ts +2 -0
  90. package/dist/components/file-upload/index.js +1 -0
  91. package/dist/components/filter-chip/FilterChip.d.ts +373 -0
  92. package/dist/components/filter-chip/FilterChip.js +517 -0
  93. package/dist/components/filter-chip/index.d.ts +2 -0
  94. package/dist/components/filter-chip/index.js +1 -0
  95. package/dist/components/filter-facet/FilterFacet.d.ts +116 -0
  96. package/dist/components/filter-facet/FilterFacet.js +632 -0
  97. package/dist/components/filter-facet/index.d.ts +2 -0
  98. package/dist/components/filter-facet/index.js +1 -0
  99. package/dist/components/firm-avatar/FirmAvatar.d.ts +75 -0
  100. package/dist/components/firm-avatar/FirmAvatar.js +119 -0
  101. package/dist/components/firm-avatar/index.d.ts +2 -0
  102. package/dist/components/firm-avatar/index.js +1 -0
  103. package/dist/components/form-actions/FormActions.d.ts +123 -0
  104. package/dist/components/form-actions/FormActions.js +195 -0
  105. package/dist/components/form-actions/index.d.ts +2 -0
  106. package/dist/components/form-actions/index.js +1 -0
  107. package/dist/components/form-block/FormBlock.d.ts +252 -0
  108. package/dist/components/form-block/FormBlock.js +420 -0
  109. package/dist/components/form-block/index.d.ts +3 -0
  110. package/dist/components/form-block/index.js +3 -0
  111. package/dist/components/form-section/FormSection.d.ts +130 -0
  112. package/dist/components/form-section/FormSection.js +206 -0
  113. package/dist/components/form-section/index.d.ts +2 -0
  114. package/dist/components/form-section/index.js +1 -0
  115. package/dist/components/heading/Heading.d.ts +69 -0
  116. package/dist/components/heading/Heading.js +79 -0
  117. package/dist/components/heading/index.d.ts +2 -0
  118. package/dist/components/heading/index.js +1 -0
  119. package/dist/components/heading-group/HeadingGroup.d.ts +258 -0
  120. package/dist/components/heading-group/HeadingGroup.js +255 -0
  121. package/dist/components/heading-group/index.d.ts +2 -0
  122. package/dist/components/heading-group/index.js +1 -0
  123. package/dist/components/hero/Hero.d.ts +268 -0
  124. package/dist/components/hero/Hero.js +316 -0
  125. package/dist/components/hero/index.d.ts +2 -0
  126. package/dist/components/hero/index.js +1 -0
  127. package/dist/components/icon/Icon.d.ts +27 -0
  128. package/dist/components/icon/Icon.js +30 -0
  129. package/dist/components/icon/index.d.ts +3 -0
  130. package/dist/components/icon/index.js +3 -0
  131. package/dist/components/icon-button/IconButton.d.ts +75 -0
  132. package/dist/components/icon-button/IconButton.js +151 -0
  133. package/dist/components/icon-button/index.d.ts +2 -0
  134. package/dist/components/icon-button/index.js +1 -0
  135. package/dist/components/item-row/ItemRow.d.ts +253 -0
  136. package/dist/components/item-row/ItemRow.js +496 -0
  137. package/dist/components/item-row/index.d.ts +2 -0
  138. package/dist/components/item-row/index.js +1 -0
  139. package/dist/components/list-row/ListRow.d.ts +165 -0
  140. package/dist/components/list-row/ListRow.js +233 -0
  141. package/dist/components/list-row/index.d.ts +2 -0
  142. package/dist/components/list-row/index.js +1 -0
  143. package/dist/components/menu/Menu.d.ts +64 -0
  144. package/dist/components/menu/Menu.js +186 -0
  145. package/dist/components/menu/index.d.ts +2 -0
  146. package/dist/components/menu/index.js +1 -0
  147. package/dist/components/modal/Modal.d.ts +272 -0
  148. package/dist/components/modal/Modal.js +788 -0
  149. package/dist/components/modal/index.d.ts +2 -0
  150. package/dist/components/modal/index.js +1 -0
  151. package/dist/components/nav-link/NavLink.d.ts +123 -0
  152. package/dist/components/nav-link/NavLink.js +157 -0
  153. package/dist/components/nav-link/index.d.ts +2 -0
  154. package/dist/components/nav-link/index.js +1 -0
  155. package/dist/components/number-field/NumberField.d.ts +62 -0
  156. package/dist/components/number-field/NumberField.js +210 -0
  157. package/dist/components/number-field/index.d.ts +2 -0
  158. package/dist/components/number-field/index.js +1 -0
  159. package/dist/components/pagination/Pagination.d.ts +133 -0
  160. package/dist/components/pagination/Pagination.js +217 -0
  161. package/dist/components/pagination/index.d.ts +3 -0
  162. package/dist/components/pagination/index.js +3 -0
  163. package/dist/components/popover-surface/index.d.ts +2 -0
  164. package/dist/components/popover-surface/index.js +1 -0
  165. package/dist/components/progress-bar/ProgressBar.d.ts +260 -0
  166. package/dist/components/progress-bar/ProgressBar.js +470 -0
  167. package/dist/components/progress-bar/index.d.ts +2 -0
  168. package/dist/components/progress-bar/index.js +1 -0
  169. package/dist/components/promo-sticker/PromoSticker.d.ts +204 -0
  170. package/dist/components/promo-sticker/PromoSticker.js +177 -0
  171. package/dist/components/promo-sticker/index.d.ts +2 -0
  172. package/dist/components/promo-sticker/index.js +1 -0
  173. package/dist/components/promo-surface/PromoSurface.d.ts +94 -0
  174. package/dist/components/promo-surface/PromoSurface.js +119 -0
  175. package/dist/components/promo-surface/index.d.ts +2 -0
  176. package/dist/components/promo-surface/index.js +1 -0
  177. package/dist/components/radio/Radio.d.ts +92 -0
  178. package/dist/components/radio/Radio.js +171 -0
  179. package/dist/components/radio/index.d.ts +2 -0
  180. package/dist/components/radio/index.js +1 -0
  181. package/dist/components/radio-group/RadioGroup.d.ts +61 -0
  182. package/dist/components/radio-group/RadioGroup.js +51 -0
  183. package/dist/components/radio-group/index.d.ts +2 -0
  184. package/dist/components/radio-group/index.js +1 -0
  185. package/dist/components/select/Select.d.ts +65 -0
  186. package/dist/components/select/Select.js +176 -0
  187. package/dist/components/select/index.d.ts +2 -0
  188. package/dist/components/select/index.js +1 -0
  189. package/dist/components/select-field/SelectField.d.ts +16 -0
  190. package/dist/components/select-field/SelectField.js +55 -0
  191. package/dist/components/select-field/index.d.ts +2 -0
  192. package/dist/components/select-field/index.js +1 -0
  193. package/dist/components/skeleton/Skeleton.d.ts +64 -0
  194. package/dist/components/skeleton/Skeleton.js +65 -0
  195. package/dist/components/skeleton/index.d.ts +2 -0
  196. package/dist/components/skeleton/index.js +1 -0
  197. package/dist/components/split-button/SplitButton.d.ts +80 -0
  198. package/dist/components/split-button/SplitButton.js +182 -0
  199. package/dist/components/split-button/index.d.ts +2 -0
  200. package/dist/components/split-button/index.js +1 -0
  201. package/dist/components/status-summary-bar/StatusSummaryBar.d.ts +118 -0
  202. package/dist/components/status-summary-bar/StatusSummaryBar.js +278 -0
  203. package/dist/components/status-summary-bar/index.d.ts +2 -0
  204. package/dist/components/status-summary-bar/index.js +1 -0
  205. package/dist/components/subject-lookup-field/SubjectLookupField.d.ts +157 -0
  206. package/dist/components/subject-lookup-field/SubjectLookupField.js +663 -0
  207. package/dist/components/subject-lookup-field/index.d.ts +2 -0
  208. package/dist/components/subject-lookup-field/index.js +1 -0
  209. package/dist/components/switch/Switch.d.ts +152 -0
  210. package/dist/components/switch/Switch.js +307 -0
  211. package/dist/components/switch/index.d.ts +2 -0
  212. package/dist/components/switch/index.js +1 -0
  213. package/dist/components/table/Table.d.ts +5 -0
  214. package/dist/components/table/Table.js +601 -0
  215. package/dist/components/table/index.d.ts +6 -0
  216. package/dist/components/table/index.js +6 -0
  217. package/dist/components/text-field/TextField.d.ts +160 -0
  218. package/dist/components/text-field/TextField.js +244 -0
  219. package/dist/components/text-field/index.d.ts +2 -0
  220. package/dist/components/text-field/index.js +1 -0
  221. package/dist/components/text-link/TextLink.d.ts +260 -0
  222. package/dist/components/text-link/TextLink.js +303 -0
  223. package/dist/components/text-link/index.d.ts +2 -0
  224. package/dist/components/text-link/index.js +1 -0
  225. package/dist/components/textarea/Textarea.d.ts +93 -0
  226. package/dist/components/textarea/Textarea.js +256 -0
  227. package/dist/components/textarea/index.d.ts +2 -0
  228. package/dist/components/textarea/index.js +1 -0
  229. package/dist/components/tooltip/Tooltip.d.ts +129 -0
  230. package/dist/components/tooltip/Tooltip.js +457 -0
  231. package/dist/components/tooltip/index.d.ts +2 -0
  232. package/dist/components/tooltip/index.js +1 -0
  233. package/dist/components/unit-field/UnitField.d.ts +46 -0
  234. package/dist/components/unit-field/UnitField.js +133 -0
  235. package/dist/components/unit-field/index.d.ts +2 -0
  236. package/dist/components/unit-field/index.js +1 -0
  237. package/dist/icons/icon-registry.generated.js +500 -0
  238. package/dist/icons/icon-types.generated.d.ts +2 -0
  239. package/dist/icons/icon-types.generated.js +126 -0
  240. package/dist/index.d.ts +130 -0
  241. package/dist/index.js +74 -0
  242. package/dist/internal/BottomSheet.js +496 -0
  243. package/dist/internal/FodsProvider.d.ts +25 -0
  244. package/dist/internal/FodsProvider.js +32 -0
  245. package/dist/internal/MotionCaret.js +35 -0
  246. package/dist/internal/NumberFormatInput.d.ts +21 -0
  247. package/dist/internal/NumberFormatInput.js +126 -0
  248. package/dist/internal/SummaryDonut.d.ts +3 -0
  249. package/dist/internal/SummaryDonut.js +300 -0
  250. package/dist/internal/buttonSegment.d.ts +44 -0
  251. package/dist/internal/buttonSegment.js +126 -0
  252. package/dist/internal/collapseRoom.js +128 -0
  253. package/dist/internal/comboboxKeys.js +44 -0
  254. package/dist/internal/contentPresence.js +46 -0
  255. package/dist/internal/dayCell.js +95 -0
  256. package/dist/internal/dialogPortal.d.ts +2 -0
  257. package/dist/internal/dialogPortal.js +21 -0
  258. package/dist/internal/donutSweeps.js +65 -0
  259. package/dist/internal/enterOnViewGeometry.js +46 -0
  260. package/dist/internal/faqItem.js +80 -0
  261. package/dist/internal/floatingLabelMotion.js +68 -0
  262. package/dist/internal/formBlockContext.d.ts +22 -0
  263. package/dist/internal/formBlockContext.js +20 -0
  264. package/dist/internal/heightRoom.js +87 -0
  265. package/dist/internal/numberSeparators.js +62 -0
  266. package/dist/internal/overlayMotion.js +48 -0
  267. package/dist/internal/paginationItem.d.ts +8 -0
  268. package/dist/internal/paginationItem.js +22 -0
  269. package/dist/internal/popoverSurface.d.ts +8 -0
  270. package/dist/internal/popoverSurface.js +23 -0
  271. package/dist/internal/portalContainer.d.ts +1 -0
  272. package/dist/internal/portalContainer.js +6 -0
  273. package/dist/internal/progressBarItem.d.ts +207 -0
  274. package/dist/internal/progressBarItem.js +264 -0
  275. package/dist/internal/selectionControlText.js +12 -0
  276. package/dist/internal/statusSummaryParts.js +371 -0
  277. package/dist/internal/summaryMotion.js +75 -0
  278. package/dist/internal/table/ChildConnector.js +62 -0
  279. package/dist/internal/table/ChildRowPrefix.d.ts +9 -0
  280. package/dist/internal/table/ChildRowPrefix.js +27 -0
  281. package/dist/internal/table/ColumnSettings.js +135 -0
  282. package/dist/internal/table/ScrollRegion.js +114 -0
  283. package/dist/internal/table/TableEmpty.js +93 -0
  284. package/dist/internal/table/TableLayout.d.ts +17 -0
  285. package/dist/internal/table/TableLayout.js +29 -0
  286. package/dist/internal/table/TableLoadStatus.js +56 -0
  287. package/dist/internal/table/TableMobile.js +488 -0
  288. package/dist/internal/table/TruncatedCell.js +33 -0
  289. package/dist/internal/table/emptyValue.js +10 -0
  290. package/dist/internal/table/features.d.ts +41 -0
  291. package/dist/internal/table/features.js +31 -0
  292. package/dist/internal/table/recipes.js +227 -0
  293. package/dist/internal/table/rowClick.js +9 -0
  294. package/dist/internal/table/types.d.ts +325 -0
  295. package/dist/internal/table/types.js +13 -0
  296. package/dist/internal/tailwind-variants.d.ts +3 -0
  297. package/dist/internal/tailwind-variants.js +37 -0
  298. package/dist/internal/tooltipContext.js +5 -0
  299. package/dist/internal/tw-merge-config.generated.js +314 -0
  300. package/dist/internal/useAnchoredPanel.d.ts +87 -0
  301. package/dist/internal/useAnchoredPanel.js +108 -0
  302. package/dist/internal/useCountUp.js +53 -0
  303. package/dist/internal/useDateFieldTrigger.d.ts +60 -0
  304. package/dist/internal/useDateFieldTrigger.js +235 -0
  305. package/dist/internal/useEChart.js +59 -0
  306. package/dist/internal/useEnterOnView.js +42 -0
  307. package/dist/internal/useFloatingBar.js +100 -0
  308. package/dist/internal/useFormReset.js +44 -0
  309. package/dist/internal/useIsMobile.js +44 -0
  310. package/dist/internal/useOneRowOverflow.js +88 -0
  311. package/dist/internal/usePrefersReducedMotion.js +25 -0
  312. package/dist/internal/useReturnFocus.js +26 -0
  313. package/dist/internal/utils.d.ts +7 -0
  314. package/dist/internal/utils.js +58 -0
  315. package/dist/node_modules/@tanstack/store/dist/store.d.ts +29 -0
  316. package/dist/node_modules/@tanstack/store/dist/types.d.ts +38 -0
  317. package/dist/node_modules/@tanstack/table-core/dist/core/cells/coreCellsFeature.d.ts +6 -0
  318. package/dist/node_modules/@tanstack/table-core/dist/core/cells/coreCellsFeature.types.d.ts +53 -0
  319. package/dist/node_modules/@tanstack/table-core/dist/core/columns/coreColumnsFeature.d.ts +6 -0
  320. package/dist/node_modules/@tanstack/table-core/dist/core/columns/coreColumnsFeature.types.d.ts +90 -0
  321. package/dist/node_modules/@tanstack/table-core/dist/core/coreFeatures.d.ts +17 -0
  322. package/dist/node_modules/@tanstack/table-core/dist/core/headers/coreHeadersFeature.d.ts +6 -0
  323. package/dist/node_modules/@tanstack/table-core/dist/core/headers/coreHeadersFeature.types.d.ts +114 -0
  324. package/dist/node_modules/@tanstack/table-core/dist/core/reactivity/coreReactivityFeature.types.d.ts +51 -0
  325. package/dist/node_modules/@tanstack/table-core/dist/core/row-models/coreRowModelsFeature.d.ts +6 -0
  326. package/dist/node_modules/@tanstack/table-core/dist/core/row-models/coreRowModelsFeature.types.d.ts +29 -0
  327. package/dist/node_modules/@tanstack/table-core/dist/core/rows/coreRowsFeature.d.ts +6 -0
  328. package/dist/node_modules/@tanstack/table-core/dist/core/rows/coreRowsFeature.types.d.ts +129 -0
  329. package/dist/node_modules/@tanstack/table-core/dist/core/table/coreTablesFeature.d.ts +6 -0
  330. package/dist/node_modules/@tanstack/table-core/dist/core/table/coreTablesFeature.types.d.ts +203 -0
  331. package/dist/node_modules/@tanstack/table-core/dist/features/cell-selection/cellSelectionFeature.d.ts +6 -0
  332. package/dist/node_modules/@tanstack/table-core/dist/features/cell-selection/cellSelectionFeature.types.d.ts +294 -0
  333. package/dist/node_modules/@tanstack/table-core/dist/features/cell-spanning/cellSpanningFeature.d.ts +11 -0
  334. package/dist/node_modules/@tanstack/table-core/dist/features/cell-spanning/cellSpanningFeature.types.d.ts +148 -0
  335. package/dist/node_modules/@tanstack/table-core/dist/features/column-faceting/columnFacetingFeature.d.ts +12 -0
  336. package/dist/node_modules/@tanstack/table-core/dist/features/column-faceting/columnFacetingFeature.types.d.ts +63 -0
  337. package/dist/node_modules/@tanstack/table-core/dist/features/column-filtering/columnFilteringFeature.d.ts +6 -0
  338. package/dist/node_modules/@tanstack/table-core/dist/features/column-filtering/columnFilteringFeature.types.d.ts +209 -0
  339. package/dist/node_modules/@tanstack/table-core/dist/features/column-filtering/filterFns.d.ts +35 -0
  340. package/dist/node_modules/@tanstack/table-core/dist/features/column-grouping/columnGroupingFeature.d.ts +6 -0
  341. package/dist/node_modules/@tanstack/table-core/dist/features/column-grouping/columnGroupingFeature.types.d.ts +128 -0
  342. package/dist/node_modules/@tanstack/table-core/dist/features/column-ordering/columnOrderingFeature.d.ts +6 -0
  343. package/dist/node_modules/@tanstack/table-core/dist/features/column-ordering/columnOrderingFeature.types.d.ts +82 -0
  344. package/dist/node_modules/@tanstack/table-core/dist/features/column-pinning/columnPinningFeature.d.ts +11 -0
  345. package/dist/node_modules/@tanstack/table-core/dist/features/column-pinning/columnPinningFeature.types.d.ts +195 -0
  346. package/dist/node_modules/@tanstack/table-core/dist/features/column-resizing/columnResizingFeature.d.ts +6 -0
  347. package/dist/node_modules/@tanstack/table-core/dist/features/column-resizing/columnResizingFeature.types.d.ts +73 -0
  348. package/dist/node_modules/@tanstack/table-core/dist/features/column-sizing/columnSizingFeature.d.ts +6 -0
  349. package/dist/node_modules/@tanstack/table-core/dist/features/column-sizing/columnSizingFeature.types.d.ts +134 -0
  350. package/dist/node_modules/@tanstack/table-core/dist/features/column-visibility/columnVisibilityFeature.d.ts +6 -0
  351. package/dist/node_modules/@tanstack/table-core/dist/features/column-visibility/columnVisibilityFeature.types.d.ts +92 -0
  352. package/dist/node_modules/@tanstack/table-core/dist/features/global-filtering/globalFilteringFeature.d.ts +6 -0
  353. package/dist/node_modules/@tanstack/table-core/dist/features/global-filtering/globalFilteringFeature.types.d.ts +67 -0
  354. package/dist/node_modules/@tanstack/table-core/dist/features/row-aggregation/aggregationFns.d.ts +23 -0
  355. package/dist/node_modules/@tanstack/table-core/dist/features/row-aggregation/rowAggregationFeature.d.ts +6 -0
  356. package/dist/node_modules/@tanstack/table-core/dist/features/row-aggregation/rowAggregationFeature.types.d.ts +183 -0
  357. package/dist/node_modules/@tanstack/table-core/dist/features/row-aggregation/rowAggregationFeature.utils.d.ts +18 -0
  358. package/dist/node_modules/@tanstack/table-core/dist/features/row-expanding/rowExpandingFeature.d.ts +6 -0
  359. package/dist/node_modules/@tanstack/table-core/dist/features/row-expanding/rowExpandingFeature.types.d.ts +125 -0
  360. package/dist/node_modules/@tanstack/table-core/dist/features/row-pagination/rowPaginationFeature.d.ts +6 -0
  361. package/dist/node_modules/@tanstack/table-core/dist/features/row-pagination/rowPaginationFeature.types.d.ts +135 -0
  362. package/dist/node_modules/@tanstack/table-core/dist/features/row-pinning/rowPinningFeature.d.ts +6 -0
  363. package/dist/node_modules/@tanstack/table-core/dist/features/row-pinning/rowPinningFeature.types.d.ts +76 -0
  364. package/dist/node_modules/@tanstack/table-core/dist/features/row-selection/rowSelectionFeature.d.ts +6 -0
  365. package/dist/node_modules/@tanstack/table-core/dist/features/row-selection/rowSelectionFeature.types.d.ts +187 -0
  366. package/dist/node_modules/@tanstack/table-core/dist/features/row-sorting/rowSortingFeature.d.ts +6 -0
  367. package/dist/node_modules/@tanstack/table-core/dist/features/row-sorting/rowSortingFeature.types.d.ts +236 -0
  368. package/dist/node_modules/@tanstack/table-core/dist/features/row-sorting/sortFns.d.ts +23 -0
  369. package/dist/node_modules/@tanstack/table-core/dist/features/stockFeatures.d.ts +37 -0
  370. package/dist/node_modules/@tanstack/table-core/dist/helpers/columnHelper.d.ts +47 -0
  371. package/dist/node_modules/@tanstack/table-core/dist/types/Cell.d.ts +16 -0
  372. package/dist/node_modules/@tanstack/table-core/dist/types/Column.d.ts +30 -0
  373. package/dist/node_modules/@tanstack/table-core/dist/types/ColumnDef.d.ts +123 -0
  374. package/dist/node_modules/@tanstack/table-core/dist/types/Header.d.ts +12 -0
  375. package/dist/node_modules/@tanstack/table-core/dist/types/HeaderGroup.d.ts +6 -0
  376. package/dist/node_modules/@tanstack/table-core/dist/types/Row.d.ts +24 -0
  377. package/dist/node_modules/@tanstack/table-core/dist/types/RowModel.d.ts +19 -0
  378. package/dist/node_modules/@tanstack/table-core/dist/types/RowModelFns.d.ts +11 -0
  379. package/dist/node_modules/@tanstack/table-core/dist/types/Table.d.ts +53 -0
  380. package/dist/node_modules/@tanstack/table-core/dist/types/TableFeatures.d.ts +416 -0
  381. package/dist/node_modules/@tanstack/table-core/dist/types/TableOptions.d.ts +78 -0
  382. package/dist/node_modules/@tanstack/table-core/dist/types/TableState.d.ts +46 -0
  383. package/dist/node_modules/@tanstack/table-core/dist/types/type-utils.d.ts +25 -0
  384. package/dist/shared.css +179 -0
  385. package/dist/styles.css +5467 -0
  386. package/dist/theme.css +314 -0
  387. package/dist/theme.map.json +278 -0
  388. package/dist/tokens/index.d.ts +2 -0
  389. package/dist/tokens/index.js +1 -0
  390. package/dist/tokens/tokens.generated.d.ts +2040 -0
  391. package/dist/tokens/tokens.generated.js +2053 -0
  392. package/dist/tokens.css +484 -0
  393. package/dist/tokens.flat.json +429 -0
  394. package/docs/Consuming.mdx +396 -0
  395. package/docs/Contributing.mdx +78 -0
  396. package/docs/ForAgents.mdx +53 -0
  397. package/docs/Introduction.mdx +54 -0
  398. package/llms.txt +550 -0
  399. package/package.json +347 -3
  400. package/src/components/action-row/ActionRow.mdx +686 -0
  401. package/src/components/action-row/ActionRow.stories.tsx +669 -0
  402. package/src/components/action-row/ActionRow.tsx +632 -0
  403. package/src/components/action-row/index.ts +9 -0
  404. package/src/components/alert/Alert.mdx +377 -0
  405. package/src/components/alert/Alert.stories.tsx +674 -0
  406. package/src/components/alert/Alert.tsx +579 -0
  407. package/src/components/alert/index.ts +13 -0
  408. package/src/components/anchored-panel/AnchoredPanel.mdx +381 -0
  409. package/src/components/anchored-panel/AnchoredPanel.stories.tsx +593 -0
  410. package/src/components/anchored-panel/AnchoredPanel.tsx +176 -0
  411. package/src/components/anchored-panel/index.ts +15 -0
  412. package/src/components/badge/Badge.mdx +487 -0
  413. package/src/components/badge/Badge.stories.tsx +375 -0
  414. package/src/components/badge/Badge.tsx +360 -0
  415. package/src/components/badge/index.ts +10 -0
  416. package/src/components/banner/Banner.mdx +704 -0
  417. package/src/components/banner/Banner.stories.tsx +448 -0
  418. package/src/components/banner/Banner.tsx +602 -0
  419. package/src/components/banner/index.ts +14 -0
  420. package/src/components/button/Button.mdx +286 -0
  421. package/src/components/button/Button.stories.tsx +381 -0
  422. package/src/components/button/Button.tsx +384 -0
  423. package/src/components/button/index.ts +1 -0
  424. package/src/components/button-group/ButtonGroup.mdx +512 -0
  425. package/src/components/button-group/ButtonGroup.stories.tsx +714 -0
  426. package/src/components/button-group/ButtonGroup.tsx +491 -0
  427. package/src/components/button-group/index.ts +10 -0
  428. package/src/components/card-select/CardSelect.mdx +662 -0
  429. package/src/components/card-select/CardSelect.stories.tsx +784 -0
  430. package/src/components/card-select/CardSelect.tsx +783 -0
  431. package/src/components/card-select/CardSelectGroup.tsx +169 -0
  432. package/src/components/card-select/index.ts +18 -0
  433. package/src/components/checkbox/Checkbox.mdx +269 -0
  434. package/src/components/checkbox/Checkbox.stories.tsx +306 -0
  435. package/src/components/checkbox/Checkbox.tsx +343 -0
  436. package/src/components/checkbox/index.ts +1 -0
  437. package/src/components/chip/Chip.mdx +683 -0
  438. package/src/components/chip/Chip.stories.tsx +734 -0
  439. package/src/components/chip/Chip.tsx +732 -0
  440. package/src/components/chip/index.ts +9 -0
  441. package/src/components/column-header/ColumnHeader.mdx +301 -0
  442. package/src/components/column-header/ColumnHeader.stories.tsx +319 -0
  443. package/src/components/column-header/ColumnHeader.tsx +287 -0
  444. package/src/components/column-header/index.ts +7 -0
  445. package/src/components/combobox-field/Combobox.tsx +693 -0
  446. package/src/components/combobox-field/ComboboxField.mdx +525 -0
  447. package/src/components/combobox-field/ComboboxField.stories.tsx +502 -0
  448. package/src/components/combobox-field/ComboboxField.tsx +259 -0
  449. package/src/components/combobox-field/index.ts +12 -0
  450. package/src/components/date-picker/DatePicker.mdx +440 -0
  451. package/src/components/date-picker/DatePicker.stories.tsx +458 -0
  452. package/src/components/date-picker/DatePicker.tsx +688 -0
  453. package/src/components/date-picker/index.ts +9 -0
  454. package/src/components/divider/Divider.mdx +256 -0
  455. package/src/components/divider/Divider.stories.tsx +177 -0
  456. package/src/components/divider/Divider.tsx +193 -0
  457. package/src/components/divider/index.ts +1 -0
  458. package/src/components/drawer/Drawer.mdx +518 -0
  459. package/src/components/drawer/Drawer.stories.tsx +392 -0
  460. package/src/components/drawer/Drawer.tsx +683 -0
  461. package/src/components/drawer/index.ts +1 -0
  462. package/src/components/dropdown-button/DropdownButton.mdx +285 -0
  463. package/src/components/dropdown-button/DropdownButton.stories.tsx +398 -0
  464. package/src/components/dropdown-button/DropdownButton.tsx +198 -0
  465. package/src/components/dropdown-button/index.ts +7 -0
  466. package/src/components/faq/FAQ.mdx +364 -0
  467. package/src/components/faq/FAQ.stories.tsx +343 -0
  468. package/src/components/faq/FAQ.tsx +337 -0
  469. package/src/components/faq/index.ts +1 -0
  470. package/src/components/field/Field.mdx +129 -0
  471. package/src/components/field/Field.stories.tsx +461 -0
  472. package/src/components/field/Field.tsx +787 -0
  473. package/src/components/field/index.ts +20 -0
  474. package/src/components/field-pair/FieldPair.mdx +312 -0
  475. package/src/components/field-pair/FieldPair.stories.tsx +539 -0
  476. package/src/components/field-pair/FieldPair.tsx +845 -0
  477. package/src/components/field-pair/index.ts +9 -0
  478. package/src/components/file-upload/FileUpload.mdx +345 -0
  479. package/src/components/file-upload/FileUpload.stories.tsx +698 -0
  480. package/src/components/file-upload/FileUpload.tsx +802 -0
  481. package/src/components/file-upload/index.ts +6 -0
  482. package/src/components/filter-chip/FilterChip.mdx +778 -0
  483. package/src/components/filter-chip/FilterChip.stories.tsx +827 -0
  484. package/src/components/filter-chip/FilterChip.tsx +881 -0
  485. package/src/components/filter-chip/index.ts +11 -0
  486. package/src/components/filter-facet/FilterFacet.mdx +536 -0
  487. package/src/components/filter-facet/FilterFacet.stories.tsx +506 -0
  488. package/src/components/filter-facet/FilterFacet.tsx +1160 -0
  489. package/src/components/filter-facet/index.ts +7 -0
  490. package/src/components/firm-avatar/FirmAvatar.mdx +280 -0
  491. package/src/components/firm-avatar/FirmAvatar.stories.tsx +147 -0
  492. package/src/components/firm-avatar/FirmAvatar.tsx +172 -0
  493. package/src/components/firm-avatar/index.ts +7 -0
  494. package/src/components/form-actions/FormActions.mdx +518 -0
  495. package/src/components/form-actions/FormActions.stories.tsx +621 -0
  496. package/src/components/form-actions/FormActions.tsx +273 -0
  497. package/src/components/form-actions/index.ts +6 -0
  498. package/src/components/form-block/FormBlock.mdx +728 -0
  499. package/src/components/form-block/FormBlock.stories.tsx +813 -0
  500. package/src/components/form-block/FormBlock.tsx +679 -0
  501. package/src/components/form-block/index.ts +13 -0
  502. package/src/components/form-section/FormSection.mdx +436 -0
  503. package/src/components/form-section/FormSection.stories.tsx +407 -0
  504. package/src/components/form-section/FormSection.tsx +290 -0
  505. package/src/components/form-section/index.ts +17 -0
  506. package/src/components/heading/Heading.mdx +206 -0
  507. package/src/components/heading/Heading.stories.tsx +169 -0
  508. package/src/components/heading/Heading.tsx +124 -0
  509. package/src/components/heading/index.ts +8 -0
  510. package/src/components/heading-group/HeadingGroup.mdx +521 -0
  511. package/src/components/heading-group/HeadingGroup.stories.tsx +353 -0
  512. package/src/components/heading-group/HeadingGroup.tsx +396 -0
  513. package/src/components/heading-group/index.ts +7 -0
  514. package/src/components/hero/Hero.mdx +742 -0
  515. package/src/components/hero/Hero.stories.tsx +527 -0
  516. package/src/components/hero/Hero.tsx +807 -0
  517. package/src/components/hero/index.ts +1 -0
  518. package/src/components/icon/Icon.mdx +329 -0
  519. package/src/components/icon/Icon.stories.tsx +398 -0
  520. package/src/components/icon/Icon.tsx +97 -0
  521. package/src/components/icon/index.ts +2 -0
  522. package/src/components/icon-button/IconButton.mdx +206 -0
  523. package/src/components/icon-button/IconButton.stories.tsx +341 -0
  524. package/src/components/icon-button/IconButton.tsx +273 -0
  525. package/src/components/icon-button/index.ts +1 -0
  526. package/src/components/item-row/ItemRow.mdx +533 -0
  527. package/src/components/item-row/ItemRow.stories.tsx +434 -0
  528. package/src/components/item-row/ItemRow.tsx +676 -0
  529. package/src/components/item-row/index.ts +9 -0
  530. package/src/components/list-row/ListRow.mdx +404 -0
  531. package/src/components/list-row/ListRow.stories.tsx +404 -0
  532. package/src/components/list-row/ListRow.tsx +424 -0
  533. package/src/components/list-row/index.ts +1 -0
  534. package/src/components/menu/Menu.mdx +268 -0
  535. package/src/components/menu/Menu.stories.tsx +455 -0
  536. package/src/components/menu/Menu.tsx +452 -0
  537. package/src/components/menu/index.ts +1 -0
  538. package/src/components/modal/Modal.mdx +854 -0
  539. package/src/components/modal/Modal.stories.tsx +881 -0
  540. package/src/components/modal/Modal.tsx +1434 -0
  541. package/src/components/modal/index.ts +1 -0
  542. package/src/components/nav-link/NavLink.mdx +196 -0
  543. package/src/components/nav-link/NavLink.stories.tsx +243 -0
  544. package/src/components/nav-link/NavLink.tsx +222 -0
  545. package/src/components/nav-link/index.ts +1 -0
  546. package/src/components/number-field/NumberField.mdx +223 -0
  547. package/src/components/number-field/NumberField.stories.tsx +291 -0
  548. package/src/components/number-field/NumberField.tsx +388 -0
  549. package/src/components/number-field/index.ts +6 -0
  550. package/src/components/pagination/Pagination.mdx +305 -0
  551. package/src/components/pagination/Pagination.stories.tsx +333 -0
  552. package/src/components/pagination/Pagination.tsx +343 -0
  553. package/src/components/pagination/index.ts +8 -0
  554. package/src/components/popover-surface/PopoverSurface.mdx +158 -0
  555. package/src/components/popover-surface/PopoverSurface.stories.tsx +421 -0
  556. package/src/components/popover-surface/index.ts +1 -0
  557. package/src/components/progress-bar/ProgressBar.mdx +802 -0
  558. package/src/components/progress-bar/ProgressBar.stories.tsx +533 -0
  559. package/src/components/progress-bar/ProgressBar.tsx +654 -0
  560. package/src/components/progress-bar/index.ts +9 -0
  561. package/src/components/promo-sticker/PromoSticker.mdx +436 -0
  562. package/src/components/promo-sticker/PromoSticker.stories.tsx +363 -0
  563. package/src/components/promo-sticker/PromoSticker.tsx +313 -0
  564. package/src/components/promo-sticker/index.ts +7 -0
  565. package/src/components/promo-surface/PromoSurface.mdx +399 -0
  566. package/src/components/promo-surface/PromoSurface.stories.tsx +270 -0
  567. package/src/components/promo-surface/PromoSurface.tsx +305 -0
  568. package/src/components/promo-surface/index.ts +7 -0
  569. package/src/components/radio/Radio.mdx +243 -0
  570. package/src/components/radio/Radio.stories.tsx +307 -0
  571. package/src/components/radio/Radio.tsx +288 -0
  572. package/src/components/radio/index.ts +1 -0
  573. package/src/components/radio-group/RadioGroup.mdx +119 -0
  574. package/src/components/radio-group/RadioGroup.stories.tsx +225 -0
  575. package/src/components/radio-group/RadioGroup.tsx +139 -0
  576. package/src/components/radio-group/index.ts +1 -0
  577. package/src/components/select/Select.mdx +241 -0
  578. package/src/components/select/Select.stories.tsx +404 -0
  579. package/src/components/select/Select.tsx +381 -0
  580. package/src/components/select/index.ts +1 -0
  581. package/src/components/select-field/SelectField.mdx +324 -0
  582. package/src/components/select-field/SelectField.stories.tsx +460 -0
  583. package/src/components/select-field/SelectField.tsx +138 -0
  584. package/src/components/select-field/index.ts +1 -0
  585. package/src/components/skeleton/Skeleton.mdx +194 -0
  586. package/src/components/skeleton/Skeleton.stories.tsx +260 -0
  587. package/src/components/skeleton/Skeleton.tsx +107 -0
  588. package/src/components/skeleton/index.ts +1 -0
  589. package/src/components/split-button/SplitButton.mdx +445 -0
  590. package/src/components/split-button/SplitButton.stories.tsx +465 -0
  591. package/src/components/split-button/SplitButton.tsx +361 -0
  592. package/src/components/split-button/index.ts +7 -0
  593. package/src/components/status-summary-bar/StatusSummaryBar.mdx +338 -0
  594. package/src/components/status-summary-bar/StatusSummaryBar.stories.tsx +408 -0
  595. package/src/components/status-summary-bar/StatusSummaryBar.tsx +428 -0
  596. package/src/components/status-summary-bar/index.ts +8 -0
  597. package/src/components/subject-lookup-field/SubjectLookupField.mdx +378 -0
  598. package/src/components/subject-lookup-field/SubjectLookupField.stories.tsx +393 -0
  599. package/src/components/subject-lookup-field/SubjectLookupField.tsx +1079 -0
  600. package/src/components/subject-lookup-field/index.ts +11 -0
  601. package/src/components/switch/Switch.mdx +376 -0
  602. package/src/components/switch/Switch.stories.tsx +296 -0
  603. package/src/components/switch/Switch.tsx +483 -0
  604. package/src/components/switch/index.ts +1 -0
  605. package/src/components/table/Table.mdx +575 -0
  606. package/src/components/table/Table.stories.tsx +1049 -0
  607. package/src/components/table/Table.tsx +745 -0
  608. package/src/components/table/TableConsumers.stories.tsx +195 -0
  609. package/src/components/table/_tableFixtures.ts +1189 -0
  610. package/src/components/table/index.ts +22 -0
  611. package/src/components/text-field/TextField.mdx +699 -0
  612. package/src/components/text-field/TextField.stories.tsx +674 -0
  613. package/src/components/text-field/TextField.tsx +645 -0
  614. package/src/components/text-field/index.ts +11 -0
  615. package/src/components/text-link/TextLink.mdx +353 -0
  616. package/src/components/text-link/TextLink.stories.tsx +458 -0
  617. package/src/components/text-link/TextLink.tsx +504 -0
  618. package/src/components/text-link/index.ts +10 -0
  619. package/src/components/textarea/Textarea.mdx +244 -0
  620. package/src/components/textarea/Textarea.stories.tsx +371 -0
  621. package/src/components/textarea/Textarea.tsx +489 -0
  622. package/src/components/textarea/index.ts +9 -0
  623. package/src/components/tooltip/Tooltip.mdx +462 -0
  624. package/src/components/tooltip/Tooltip.stories.tsx +500 -0
  625. package/src/components/tooltip/Tooltip.tsx +756 -0
  626. package/src/components/tooltip/index.ts +13 -0
  627. package/src/components/unit-field/UnitField.mdx +215 -0
  628. package/src/components/unit-field/UnitField.stories.tsx +291 -0
  629. package/src/components/unit-field/UnitField.tsx +255 -0
  630. package/src/components/unit-field/index.ts +7 -0
  631. package/src/icons/icon-registry.generated.ts +510 -0
  632. package/src/icons/icon-types.generated.ts +256 -0
  633. package/src/index.ts +70 -0
  634. package/src/internal/BottomSheet.tsx +714 -0
  635. package/src/internal/FodsProvider.tsx +36 -0
  636. package/src/internal/MotionCaret.tsx +53 -0
  637. package/src/internal/NumberFormatInput.tsx +276 -0
  638. package/src/internal/SummaryDonut.tsx +359 -0
  639. package/src/internal/buttonSegment.ts +241 -0
  640. package/src/internal/collapseRoom.ts +130 -0
  641. package/src/internal/comboboxKeys.ts +90 -0
  642. package/src/internal/contentPresence.ts +46 -0
  643. package/src/internal/dayCell.ts +274 -0
  644. package/src/internal/dialogPortal.ts +50 -0
  645. package/src/internal/donutSweeps.ts +77 -0
  646. package/src/internal/enterOnViewGeometry.ts +53 -0
  647. package/src/internal/faqItem.ts +104 -0
  648. package/src/internal/floatingLabelMotion.tsx +109 -0
  649. package/src/internal/formBlockContext.ts +27 -0
  650. package/src/internal/heightRoom.ts +135 -0
  651. package/src/internal/numberSeparators.ts +93 -0
  652. package/src/internal/overlayMotion.tsx +32 -0
  653. package/src/internal/paginationItem.ts +106 -0
  654. package/src/internal/popoverSurface.ts +78 -0
  655. package/src/internal/portalContainer.ts +11 -0
  656. package/src/internal/progressBarItem.ts +356 -0
  657. package/src/internal/selectionControlText.ts +42 -0
  658. package/src/internal/statusSummaryParts.tsx +475 -0
  659. package/src/internal/summaryMotion.ts +111 -0
  660. package/src/internal/table/ChildConnector.tsx +57 -0
  661. package/src/internal/table/ChildRowPrefix.tsx +21 -0
  662. package/src/internal/table/ColumnSettings.tsx +194 -0
  663. package/src/internal/table/ScrollRegion.tsx +176 -0
  664. package/src/internal/table/TableEmpty.tsx +99 -0
  665. package/src/internal/table/TableLayout.tsx +29 -0
  666. package/src/internal/table/TableLoadStatus.tsx +60 -0
  667. package/src/internal/table/TableMobile.tsx +582 -0
  668. package/src/internal/table/TruncatedCell.tsx +35 -0
  669. package/src/internal/table/emptyValue.ts +11 -0
  670. package/src/internal/table/features.ts +44 -0
  671. package/src/internal/table/recipes.ts +263 -0
  672. package/src/internal/table/rowClick.ts +8 -0
  673. package/src/internal/table/types.ts +342 -0
  674. package/src/internal/tailwind-variants.ts +65 -0
  675. package/src/internal/tooltipContext.ts +15 -0
  676. package/src/internal/tw-merge-config.generated.ts +275 -0
  677. package/src/internal/useAnchoredPanel.ts +340 -0
  678. package/src/internal/useCountUp.ts +65 -0
  679. package/src/internal/useDateFieldTrigger.tsx +497 -0
  680. package/src/internal/useEChart.ts +88 -0
  681. package/src/internal/useEnterOnView.ts +80 -0
  682. package/src/internal/useFloatingBar.ts +125 -0
  683. package/src/internal/useFormReset.ts +57 -0
  684. package/src/internal/useIsMobile.ts +64 -0
  685. package/src/internal/useNoImplicitSubmit.ts +41 -0
  686. package/src/internal/useOneRowOverflow.ts +103 -0
  687. package/src/internal/usePrefersReducedMotion.ts +27 -0
  688. package/src/internal/useReturnFocus.ts +34 -0
  689. package/src/internal/utils.ts +58 -0
  690. package/src/recipes/EmptyState.stories.tsx +105 -0
  691. package/src/recipes/Form.stories.tsx +360 -0
  692. package/src/recipes/ModalWithForm.stories.tsx +219 -0
  693. package/src/recipes/Recipes.mdx +61 -0
  694. package/src/recipes/TableWithFilters.stories.tsx +278 -0
  695. package/src/storybook/FodsFamily.tsx +39 -0
  696. package/src/storybook/Section.tsx +36 -0
  697. package/src/storybook/a11y.ts +24 -0
  698. package/src/storybook/assets/banner-character-bartender.webp +0 -0
  699. package/src/storybook/assets/banner-invoice-sheet-left.webp +0 -0
  700. package/src/storybook/assets/banner-invoice-sheet-right.webp +0 -0
  701. package/src/storybook/assets/invoice-hero.webp +0 -0
  702. package/src/storybook/assets/invoice.webp +0 -0
  703. package/src/storybook/assets/section-document-info.svg +21 -0
  704. package/src/storybook/assets/section-gear-checklist.svg +11 -0
  705. package/src/storybook/assets/section-person-arrow-in.svg +15 -0
  706. package/src/storybook/assets/section-person-arrow-out.svg +22 -0
  707. package/src/storybook/assets/section-receipt-dollar.svg +23 -0
  708. package/src/storybook/assets/table-empty-folder-empty.png +0 -0
  709. package/src/storybook/assets/table-empty-folder-magnifying-glass.png +0 -0
  710. package/src/storybook/assets/table-empty-funnel.png +0 -0
  711. package/src/storybook/assets/table-empty-load-failed.png +0 -0
  712. package/src/storybook/assets/wallet-spot.png +0 -0
  713. package/src/storybook/assets.d.ts +17 -0
  714. package/src/storybook/componentDoc.ts +41 -0
  715. package/src/storybook/fitFrame.tsx +70 -0
  716. package/src/storybook/forceStates.tsx +647 -0
  717. package/src/storybook/illustrations.tsx +66 -0
  718. package/src/storybook/viewportFrame.tsx +58 -0
  719. package/src/styles/assets/label-brush-1.svg +6 -0
  720. package/src/styles/assets/pattern-dark.svg +113 -0
  721. package/src/styles/base.css +106 -0
  722. package/src/styles/index.css +15 -0
  723. package/src/styles/motion.css +157 -0
  724. package/src/styles/promo-sticker.css +27 -0
  725. package/src/styles/promo-surface.css +49 -0
  726. package/src/styles/shared.css +11 -0
  727. package/src/styles/theme.generated.css +314 -0
  728. package/src/styles/theme.map.json +278 -0
  729. package/src/styles/tracking.generated.css +12 -0
  730. package/src/tokens/index.ts +4 -0
  731. package/src/tokens/tokens.generated.ts +542 -0
@@ -0,0 +1,363 @@
1
+ import type { Meta, StoryObj } from '@storybook/react-vite';
2
+ import { PromoSticker } from './PromoSticker';
3
+ import { Section, Showcase } from '../../storybook/Section';
4
+ import { componentDoc } from '../../storybook/componentDoc';
5
+
6
+ const LAYOUTS = ['label', 'tile'] as const;
7
+ const COLORS = ['promo', 'ready'] as const;
8
+
9
+ /**
10
+ * Canonical market copy, verbatim from `promo-sticker.md` § Copy (owner
11
+ * decision 2026-07-17).
12
+ *
13
+ * The spec is explicit that these are NOT translations of one another — "each market's
14
+ * claim reflects its own legislative context (KSeF is PL-only, EET is CZ-only)" — so the
15
+ * market row exists to prove the brush hugs each string, diacritics included.
16
+ */
17
+ const MARKET_LABELS = ['Doporučené', 'Polecane', 'Empfohlen', 'Recommended'] as const;
18
+
19
+ const MARKET_TILES = [
20
+ { title: 'EET 2.0', subtitle: 'připraveno' },
21
+ { title: 'DPH', subtitle: 'pro plátce' },
22
+ { title: 'E‑faktúra', subtitle: 'pripravená' },
23
+ { title: 'KSeF', subtitle: 'integracja' },
24
+ { title: 'E-Rechnung', subtitle: 'bereit' },
25
+ ] as const;
26
+
27
+ /**
28
+ * The tilt and the offsets belong to the CONSUMER, not the component
29
+ * (`intent.states`: "Tilt is applied by the CONSUMER (component ships at 0°)").
30
+ * These wrappers are therefore story scaffolding that shows the anchor law — they are
31
+ * NOT something the component could do for you.
32
+ *
33
+ * Inline styles rather than Tailwind arbitrary values: rotation and half-out offsets are
34
+ * placement of a demo carrier, not component design, so they have no business in the
35
+ * token lint's field of view.
36
+ */
37
+ function CardCarrier({
38
+ children,
39
+ corner = 'top-right',
40
+ tilt = -3,
41
+ }: {
42
+ children: React.ReactNode;
43
+ corner?: 'top-left' | 'top-right';
44
+ /**
45
+ * Degrees, applied by the carrier. `-3` is the anchor law's default; `0` is the flat
46
+ * instance the law sanctions alongside it. It has to be a parameter, not a constant:
47
+ * the two branches below used to hard-code `rotate(-3deg)` on both sides, so a flat
48
+ * instance was drawn tilted.
49
+ */
50
+ tilt?: number;
51
+ }) {
52
+ return (
53
+ // `overflow-visible` is the carrier's side of the contract: "Never clip the brush.
54
+ // The carrier chain must keep overflow: visible for overhung placements."
55
+ <div className="relative overflow-visible rounded-500 border border-outline-default bg-background-primary p-800"
56
+ style={{ width: 320 }}>
57
+ <p className="text-body-sm font-semibold text-text-primary">Acme s.r.o.</p>
58
+ <p className="mt-200 text-body-xs text-text-secondary">Ukázková karta s doporučením</p>
59
+ <div
60
+ className="absolute"
61
+ style={{
62
+ top: 0,
63
+ ...(corner === 'top-right' ? { right: 24 } : { left: 24 }),
64
+ // `rotate(0deg)` and no rotation are the same picture, so flat needs no branch
65
+ // of its own — only a `tilt` of 0. `translateY(-50%)` is the anchor law's
66
+ // half-body overhang and applies either way.
67
+ transform: `translateY(-50%) rotate(${tilt}deg)`,
68
+ }}
69
+ >
70
+ {children}
71
+ </div>
72
+ </div>
73
+ );
74
+ }
75
+
76
+ const meta = {
77
+ title: 'Design System/Atoms/PromoSticker',
78
+ component: PromoSticker,
79
+ parameters: {
80
+ layout: 'centered',
81
+ docs: {
82
+ description: {
83
+ component: componentDoc({
84
+ summary:
85
+ 'A hand-brushed promo smear with white text that the brand places on top of content — clinging to a carrier\'s edge, half outside, slightly tilted. Two jobs, one atom: a one-word recommendation marker on a card corner, and a two-line readiness claim on marketing surfaces. Never interactive, never a click target.',
86
+ useCases: [
87
+ '`layout="label"` — one marker word, passed as `children`: *Doporučené* on a featured card.',
88
+ '`layout="tile"` — a `title` + `subtitle` claim: *KSeF / integracja* on a marketing hero.',
89
+ 'Pick `color` by **message**, not by surface: `promo` (orange) = the brand recommends or promotes; `ready` (info blue) = a factual readiness claim.',
90
+ 'For read-only status **inside** content flow use Badge; for interactive tags use Chip.',
91
+ ],
92
+ bestPractices: [
93
+ 'Maximum **one** `promo` sticker per screen or region — stacked orange markers compete for the same attention.',
94
+ 'Apply the tilt (±3°, 4° max) and the half-out offset yourself. The component ships at 0° on purpose.',
95
+ 'Keep `overflow: visible` on the whole carrier chain. Where you cannot guarantee it — scroll containers, tables — use the in-flow placement instead of clipping the brush.',
96
+ 'Let the brush hug localized copy. Never fix the text width and never truncate market strings.',
97
+ 'Bottom edges are illegal: the sticker is an announcement, not a footnote.',
98
+ ],
99
+ knownIssues: [
100
+ 'The brush is **intrinsic geometry** — never rebuild it as a rounded rectangle. It is recoloured through a `mask-image` (not a `background-image`), because the asset is filled with one colour and could not otherwise become the Ready blue.',
101
+ '`aria-hidden` is conditional. Default `decorative` is `true`, which assumes the message is duplicated by nearby text; pass `decorative={false}` when the sticker carries the claim on its own, or it becomes colour/image-only information.',
102
+ 'White on `--primary-solid` measures 2.37:1. That is a **registered, atom-scoped exception** (`accessibility.md` → Contrast, owner 2026-07-17): decorative marker, never the sole carrier of meaning, never interactive, all lines ≥12 px and ≥semibold. It licenses nothing else.',
103
+ 'Not `pointer-events-none` — unlike PromoSurface. The sticker sits on top of a carrier and is normally its DOM child, so events bubble to the carrier and the overhanging half stays part of its hit area.',
104
+ 'The `label` bindings were an open question — Figma rendered this variant as `Heading/H5` (Poppins SemiBold 16) at 20/12 padding while the manifest still said `Body/XXS/Semibold` (Inter 12) at 12/8. Manifest 1.3.0 settled it in favour of Heading/H5, which is what the code renders.',
105
+ ],
106
+ docsLink: {
107
+ label: 'spec/03-atoms/promo-sticker.md',
108
+ },
109
+ }),
110
+ },
111
+ },
112
+ },
113
+ argTypes: {
114
+ layout: { control: 'inline-radio', options: LAYOUTS },
115
+ color: {
116
+ control: 'inline-radio',
117
+ options: COLORS,
118
+ description: 'Chosen by message, never by surface.',
119
+ },
120
+ decorative: {
121
+ control: 'boolean',
122
+ description: '`true` (default) hides it from the a11y tree — use when nearby text already says it.',
123
+ },
124
+ },
125
+ args: {
126
+ layout: 'label',
127
+ color: 'promo',
128
+ children: 'Doporučené',
129
+ },
130
+ } satisfies Meta<typeof PromoSticker>;
131
+
132
+ export default meta;
133
+ type Story = StoryObj<typeof meta>;
134
+
135
+ /**
136
+ * The interactive cell.
137
+ *
138
+ * The render adapts to `layout` instead of spreading args straight through, and that is
139
+ * load-bearing for verification rather than convenience: the two layouts take DIFFERENT
140
+ * runs (`children` vs `title` + `subtitle`), so a pass-through Playground stuck on the
141
+ * `label` default would never put `title` / `subtitle` in the DOM — and the runtime probe
142
+ * finds parts by `data-fods-part`, so those two runs would go silently unmeasured while
143
+ * the report still read as clean. Flipping `layout` here renders a real Tile, which is
144
+ * what the verifier's parts map pins those parts to.
145
+ */
146
+ export const Playground: Story = {
147
+ render: ({ layout = 'label', color = 'promo', decorative }) =>
148
+ layout === 'tile' ? (
149
+ <PromoSticker layout="tile" color={color} decorative={decorative} title="KSeF" subtitle="integracja" />
150
+ ) : (
151
+ <PromoSticker color={color} decorative={decorative}>
152
+ Doporučené
153
+ </PromoSticker>
154
+ ),
155
+ };
156
+
157
+ /**
158
+ * All four cells — Layout × Color.
159
+ *
160
+ * There is no States row: the sticker has none by design (`intent.states` — "a static,
161
+ * non-interactive marker. No hover/focus/disabled"), so the 2 × 2 matrix IS the coverage.
162
+ */
163
+ export const Matrix: Story = {
164
+ parameters: { controls: { disable: true } },
165
+ render: () => (
166
+ <Showcase>
167
+ {LAYOUTS.map(layout => (
168
+ <Section
169
+ key={layout}
170
+ title={layout}
171
+ description={
172
+ layout === 'label'
173
+ ? 'One marker word (`children`). Heading/H5 SemiBold, hug × hug.'
174
+ : 'A `title` + `subtitle` claim. Heading/H1 over Body/XXS Semibold, with the −6 px stack gap.'
175
+ }
176
+ layout="row"
177
+ >
178
+ {COLORS.map(color =>
179
+ layout === 'tile' ? (
180
+ <PromoSticker key={color} layout="tile" color={color} title="KSeF" subtitle="integracja" />
181
+ ) : (
182
+ <PromoSticker key={color} color={color}>
183
+ Doporučené
184
+ </PromoSticker>
185
+ ),
186
+ )}
187
+ </Section>
188
+ ))}
189
+ </Showcase>
190
+ ),
191
+ };
192
+
193
+ /**
194
+ * A single Tile in each tone, isolated.
195
+ *
196
+ * These two exist for the verifier as much as for the reader: `title` and `subtitle` only
197
+ * render in the Tile layout, so the verifier's parts map points their
198
+ * `runtimeStateStory` here. Without a story that renders exactly one Tile per tone the
199
+ * runtime probe reported both runs as "not in DOM" and measured nothing, while the report
200
+ * still read as clean — the Playground alone cannot cover them, because one sweep drives
201
+ * one arg (`storyStateArg: "color"`) and the layout stays at its default.
202
+ */
203
+ export const TilePromo: Story = {
204
+ parameters: { controls: { disable: true } },
205
+ render: () => <PromoSticker layout="tile" color="promo" title="Akce" subtitle="sleva 20 %" />,
206
+ };
207
+
208
+ export const TileReady: Story = {
209
+ parameters: { controls: { disable: true } },
210
+ render: () => <PromoSticker layout="tile" color="ready" title="KSeF" subtitle="integracja" />,
211
+ };
212
+
213
+ /**
214
+ * Placement 1 of 3 — the **corner marker** (`notes[2]`).
215
+ *
216
+ * Top-right or top-left card corner, a single sticker, −3° or flat, half-body outside. Flat
217
+ * (0°) is a sanctioned choice for any placement; the left carrier shows it. This is the
218
+ * placement the whole anchor law is written for, and it is entirely the consumer's geometry: the component contributes no rotation and no offset — which is exactly why the
219
+ * two carriers below can differ by 3° while rendering the same atom.
220
+ */
221
+ export const CornerMarker: Story = {
222
+ parameters: { controls: { disable: true } },
223
+ render: () => (
224
+ <Showcase>
225
+ <Section
226
+ title="Corner marker"
227
+ description="Half-body outside the carrier's top edge. Left: top-right and flat (0°), a sanctioned choice for any placement. Right: top-right at −3°, the anchor law's default. Either top corner is legal; the bottom edge is not. The sticker rides on the card: the card owns the interaction, the sticker never does."
228
+ layout="row"
229
+ >
230
+ <CardCarrier corner="top-right" tilt={0}>
231
+ <PromoSticker>Doporučené</PromoSticker>
232
+ </CardCarrier>
233
+ <CardCarrier corner="top-right">
234
+ <PromoSticker>Doporučené</PromoSticker>
235
+ </CardCarrier>
236
+ </Section>
237
+ </Showcase>
238
+ ),
239
+ };
240
+
241
+ /**
242
+ * Placement 2 of 3 — the **edge stack** (`notes[2]`, `notes[3]`).
243
+ *
244
+ * Up to three Tiles on a banner's left edge, 16px gaps, alternating slight tilts,
245
+ * vertically centred on the edge as a group. The manifest is explicit that this is a
246
+ * **usage pattern, not a molecule** — there is no `StickerStack` component and there
247
+ * should not be one; the page composes it.
248
+ */
249
+ export const EdgeStack: Story = {
250
+ parameters: { controls: { disable: true } },
251
+ render: () => (
252
+ <Showcase>
253
+ <Section
254
+ title="Edge stack"
255
+ description="Max 3 Tiles, --space-600 (16 px) gaps, alternating ±3°, centred on the banner's left edge as a group."
256
+ layout="row"
257
+ >
258
+ <div className="relative overflow-visible rounded-800 bg-secondary-subtle" style={{ width: 520, height: 320 }}>
259
+ <div className="absolute left-0 top-1/2 flex -translate-y-1/2 flex-col gap-600">
260
+ {MARKET_TILES.slice(2, 5).map(({ title, subtitle }, i) => (
261
+ <div
262
+ key={title}
263
+ style={{ transform: `translateX(-50%) rotate(${i % 2 === 0 ? -3 : 3}deg)` }}
264
+ >
265
+ <PromoSticker layout="tile" color="ready" title={title} subtitle={subtitle} />
266
+ </div>
267
+ ))}
268
+ </div>
269
+ </div>
270
+ </Section>
271
+ </Showcase>
272
+ ),
273
+ };
274
+
275
+ /**
276
+ * Placement 3 of 3 — the **in-flow row** (`notes[2]`).
277
+ *
278
+ * The mobile fallback, and the answer whenever `overflow: visible` cannot be guaranteed
279
+ * (scroll containers, tables): fully inside the flow, no overhang, tilt optional. The
280
+ * spec would rather you move the sticker in-flow than clip the brush.
281
+ */
282
+ export const InFlowFallback: Story = {
283
+ parameters: { controls: { disable: true } },
284
+ render: () => (
285
+ <Showcase>
286
+ <Section
287
+ title="In-flow row"
288
+ description="No overhang, no tilt. Use this instead of clipping the brush when the carrier chain cannot keep overflow visible. This card clips its content, so the sticker sits inside the flow rather than on the edge."
289
+ layout="row"
290
+ >
291
+ <div className="flex flex-col gap-500 overflow-hidden rounded-500 border border-outline-default bg-background-primary p-800" style={{ width: 320 }}>
292
+ <PromoSticker>Doporučené</PromoSticker>
293
+ <div>
294
+ <p className="text-body-sm font-semibold text-text-primary">Acme s.r.o.</p>
295
+ <p className="mt-200 text-body-xs text-text-secondary">Ukázková karta s doporučením</p>
296
+ </div>
297
+ </div>
298
+ </Section>
299
+ </Showcase>
300
+ ),
301
+ };
302
+
303
+ /**
304
+ * The brush stretches with the string — that is the point of the SCALE-constrained
305
+ * vector, and the reason localization needs no size variants
306
+ * (`intent.sizing`, measured 78–112px across locales on Label).
307
+ *
308
+ * Each market's claim is its own, not a translation of the others.
309
+ */
310
+ export const MarketCopy: Story = {
311
+ parameters: { controls: { disable: true } },
312
+ render: () => (
313
+ <Showcase>
314
+ <Section
315
+ title="Label — one marker word per market"
316
+ description="The brush hugs each string, diacritics included. No truncation, no fixed width."
317
+ layout="row"
318
+ >
319
+ {MARKET_LABELS.map(word => (
320
+ <PromoSticker key={word}>{word}</PromoSticker>
321
+ ))}
322
+ </Section>
323
+ <Section
324
+ title="Tile — the claim per market"
325
+ description="KSeF is PL-only, EET is CZ-only. Never translate these mechanically."
326
+ layout="row"
327
+ >
328
+ {MARKET_TILES.map(({ title, subtitle }) => (
329
+ <PromoSticker key={title} layout="tile" color="ready" title={title} subtitle={subtitle} />
330
+ ))}
331
+ </Section>
332
+ </Showcase>
333
+ ),
334
+ };
335
+
336
+ /**
337
+ * The accessibility fork, side by side.
338
+ *
339
+ * `decorative` is not cosmetic — it decides whether the claim exists for a screen reader
340
+ * at all. Default `true` assumes nearby text already says it; `false` exposes the run so
341
+ * the message is not colour/image-only.
342
+ */
343
+ export const AccessibleName: Story = {
344
+ parameters: { controls: { disable: true } },
345
+ render: () => (
346
+ <Showcase>
347
+ <Section
348
+ title="decorative (default) — message duplicated nearby"
349
+ description="aria-hidden=&quot;true&quot;. The card's own heading already says Doporučené, so the sticker would only repeat it."
350
+ layout="row"
351
+ >
352
+ <PromoSticker decorative>Doporučené</PromoSticker>
353
+ </Section>
354
+ <Section
355
+ title="decorative={false} — the sticker carries the claim"
356
+ description="Exposed to the a11y tree. Use when nothing else on the surface states it."
357
+ layout="row"
358
+ >
359
+ <PromoSticker decorative={false} layout="tile" color="ready" title="KSeF" subtitle="integracja" />
360
+ </Section>
361
+ </Showcase>
362
+ ),
363
+ };
@@ -0,0 +1,313 @@
1
+ "use client";
2
+ import * as React from 'react';
3
+ import { tv, type VariantProps } from '../../internal/tailwind-variants';
4
+ import { cn } from '../../internal/utils';
5
+
6
+ /**
7
+ * PromoSticker — the hand-brushed promo smear (`promo-sticker.manifest.json`, atom,
8
+ * v1.4.2).
9
+ *
10
+ * The brand speaking ON TOP of content: a recommendation marker on a card corner
11
+ * ("Doporučené" on a featured card) or a readiness claim on a marketing
12
+ * surface ("KSeF / integracja"). It clings to the carrier's EDGE, half its body
13
+ * outside, slightly tilted (`intent.whenToUse`). For read-only status inside the
14
+ * content flow the right atom is Badge; for an interactive tag, Chip.
15
+ *
16
+ * `kind: structure` — no interaction, no lifecycle. `intent.states` is explicit: "None
17
+ * — a static, non-interactive marker. No hover/focus/disabled by design; it is never a
18
+ * click target." So this file declares no state prop, no `role`, no `tabIndex` and no
19
+ * hover/focus class. There is nothing to disable, hence no `disabled` prop and no
20
+ * nested control to propagate it to (the whole tree is two-to-three `<span>`s).
21
+ *
22
+ * Motion: none. (`tailwindcss-animate` is not installed in this repo either, so
23
+ * `animate-in` / `fade-in-*` would generate zero CSS.)
24
+ *
25
+ * ROTATION AND OFFSETS BELONG TO THE CONSUMER. `intent.states`: "Tilt is applied by
26
+ * the CONSUMER (component ships at 0°)", and `delivery.react` repeats it: "rotation
27
+ * and corner offsets applied by the consumer via transform". So the component holds no
28
+ * `rotate-*`, no `absolute`, no `inset-*` and no negative offset of its own — the
29
+ * consumer positions it, e.g.
30
+ * `<PromoSticker className="absolute -top-500 -right-400 -rotate-3">`.
31
+ * The tilt itself is OPTIONAL: `intent.rules[1]` sanctions "tilt ±3° default (≤4° max),
32
+ * or 0° — flat is a sanctioned choice the consumer may make, not a missed rotation".
33
+ * The consumer MUST also keep `overflow: visible` on the carrier; where it cannot, the
34
+ * in-flow placement is the fallback — the brush is never clipped (`intent.rules[1]`).
35
+ *
36
+ * Two equally-ranked axes, 4 cells (`intent.variants`):
37
+ * - `layout` — Label (one marker line, Heading/H5 since 1.3.0) / Tile (H1 title + 12px subtitle).
38
+ * - `color` — Promo (brand orange) / Ready (info blue). Chosen by MESSAGE, never by
39
+ * surface (`intent.rules[0]`): Promo = the brand recommends, Ready = a factual readiness
40
+ * claim. Max ONE Promo sticker per screen/region — a composition rule the consumer
41
+ * owns, this atom cannot enforce it.
42
+ *
43
+ * CONTRAST — registered exception, do not "fix" it. White on `--primary-solid` is
44
+ * 2.37:1, below the 4.5:1 text floor. It is an atom-scoped exception in
45
+ * `accessibility.md` → Contrast (owner decision 2026-07-17) granted on the grounds
46
+ * that the sticker is a decorative marker, is never the only carrier of its meaning
47
+ * (see `decorative` below), is never interactive, and never renders a line below 12px
48
+ * or below semibold. Swapping the ink to a darker token would break
49
+ * `chrome.promo.text` and the brand slot the exception exists to license.
50
+ */
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: {
126
+ /*
127
+ * `chrome.label`: padding-x --space-700 (20), padding-y --space-500 (12), gap 0
128
+ * (single run, so no gap class at all).
129
+ *
130
+ * NO min-height, and the manifest now says so itself: "Hug x hug... No min-height
131
+ * — the H5 line box plus padding is the height, which lands at 48 (--space-1100)
132
+ * on desktop and 45 below 767, where --font-size-heading-h5 steps to 14. Pinning a
133
+ * height would hold the mobile block at the desktop value and stretch the brush
134
+ * with it." The 34 that used to sit here belonged to the old 12px reading of the
135
+ * run and did not carry over.
136
+ */
137
+ root: 'px-700 py-500',
138
+ },
139
+ tile: {
140
+ // `chrome.tile`: padding-x --space-800, padding-y --space-500, height 72,
141
+ // stacked runs (hence flex-col; the −6px gap rides on the subtitle).
142
+ // fods-lint-disable-next-line authored 72px brush height (chrome.tile.height); the smear's own geometry, off the --space grid by design (nearest steps are 64 and 80)
143
+ root: 'h-[72px] flex-col px-800 py-500',
144
+ },
145
+ },
146
+ color: {
147
+ // `chrome.promo` — fill --primary-solid, text --primary-foreground.
148
+ promo: { root: 'text-primary-foreground', brush: 'bg-primary-solid' },
149
+ // `chrome.ready` — fill --status-info-solid, text --status-info-foreground.
150
+ ready: { root: 'text-status-info-foreground', brush: 'bg-status-info-solid' },
151
+ },
152
+ },
153
+ defaultVariants: {
154
+ layout: 'label',
155
+ color: 'promo',
156
+ },
157
+ });
158
+
159
+ /**
160
+ * Layout — the content axis (`axes.content`, default Label).
161
+ *
162
+ * Recorded under `axes.content` rather than `axes.variant` because the manifest schema
163
+ * has a fixed set of axis keys; `properties[].maps` is what governs the API and it
164
+ * says `layout`. Values are lowercase-kebab — the Figma casing never reaches code.
165
+ */
166
+ export type PromoStickerLayout = 'label' | 'tile';
167
+
168
+ /** Color — the family / message axis (`axes.variant`, default Promo). */
169
+ export type PromoStickerColor = 'promo' | 'ready';
170
+
171
+ type PromoStickerBase = Omit<
172
+ React.HTMLAttributes<HTMLSpanElement>,
173
+ 'role' | 'children' | 'title'
174
+ > &
175
+ Pick<VariantProps<typeof promoStickerVariants>, 'color'> & {
176
+ /**
177
+ * The family / message axis (`properties` "Color"). Promo (orange) = the brand
178
+ * recommends or promotes; Ready (info blue) = a factual readiness claim.
179
+ * Picked from the MESSAGE, never from the surface it sits on
180
+ * (`intent.rules[0]`).
181
+ */
182
+ color?: PromoStickerColor;
183
+ /**
184
+ * Whether the sticker's message is already readable in the surrounding text.
185
+ *
186
+ * The spec's `## Accessibility` is conditional, not a blanket `aria-hidden`:
187
+ * "when the message is duplicated by nearby text, render with
188
+ * `aria-hidden="true"`; otherwise give the sticker a visually-hidden text
189
+ * equivalent so the claim is not colour/image-only."
190
+ *
191
+ * - `true` (default) — the marker only restates what the carrier already says
192
+ * (a "Doporučené" corner marker on a card whose copy carries the
193
+ * recommendation). Hiding it stops a screen reader repeating the same word.
194
+ * - `false` — the sticker IS the claim (a marketing "KSeF / integracja" tile,
195
+ * where nothing else on the surface states the readiness). The root is then
196
+ * left OUT of `aria-hidden`, which is all it takes: the title/subtitle/label
197
+ * runs are real text nodes in the DOM, so they are already the accessible
198
+ * text equivalent. Adding a duplicate `sr-only` span on top would make an AT
199
+ * read the claim twice, and the visually-hidden wording in the spec is about
200
+ * the message not being image-only — which real text already satisfies.
201
+ *
202
+ * The default is `true` because the marker placement is the common one and it is
203
+ * the safer failure mode: a duplicated announcement is a defect, a missing one on
204
+ * an already-announced word is not.
205
+ */
206
+ decorative?: boolean;
207
+ };
208
+
209
+ /**
210
+ * Label carries its text as `children` — `properties` "Label text" maps to
211
+ * "children (Label layout)". Tile takes `title` + `subtitle` instead, both required:
212
+ * `intent.variants` defines the Tile as "H1 title + 12px subtitle", so a Tile with one
213
+ * run is not a smaller Tile, it is a Label.
214
+ *
215
+ * `?: undefined` on the unused arm, NOT `?: never`. Both forbid passing a node to the
216
+ * wrong arm, which is the contract that matters, but `never` also rejects an explicit
217
+ * `title={undefined}` — so a caller spreading a shared prop bag, or a Storybook story
218
+ * overriding a meta-level arg, could not switch layout without a cast. (This exact
219
+ * shape bit `tsc` on Hero's CentredNoVisual story.)
220
+ */
221
+ export type PromoStickerProps = PromoStickerBase &
222
+ (
223
+ | {
224
+ layout?: 'label';
225
+ children: React.ReactNode;
226
+ title?: undefined;
227
+ subtitle?: undefined;
228
+ }
229
+ | {
230
+ layout: 'tile';
231
+ title: React.ReactNode;
232
+ subtitle: React.ReactNode;
233
+ children?: undefined;
234
+ }
235
+ );
236
+
237
+ const PromoSticker = React.forwardRef<HTMLSpanElement, PromoStickerProps>((props, ref) => {
238
+ // Annotating the binding pattern instead of casting: both arms of the union are
239
+ // assignable to this shape, so the run props can be destructured without an
240
+ // assertion.
241
+ const {
242
+ layout = 'label',
243
+ color = 'promo',
244
+ decorative = true,
245
+ children,
246
+ title,
247
+ subtitle,
248
+ className,
249
+ ...rest
250
+ }: PromoStickerBase & {
251
+ layout?: PromoStickerLayout;
252
+ children?: React.ReactNode;
253
+ title?: React.ReactNode;
254
+ subtitle?: React.ReactNode;
255
+ } = props;
256
+
257
+ const slots = promoStickerVariants({ layout, color });
258
+
259
+ // Nothing crosses as an inline style: the vector URL is owned by the stylesheet
260
+ // (`.fods-promo-sticker-brush` in `styles/promo-sticker.css`), and colour, size,
261
+ // spacing and radius all live in the classes above.
262
+
263
+ return (
264
+ // NOT `pointer-events-none` — deliberately, and unlike PromoSurface. That plaque is
265
+ // a full-bleed layer UNDER all of a panel's content, so it has to let every click
266
+ // through. This sticker is the opposite: a small element ON TOP of a carrier and,
267
+ // in the canonical placements, a DOM CHILD of it. Events therefore bubble to the
268
+ // carrier, so nothing is lost by staying hit-testable — while the overhanging half
269
+ // stays part of the carrier's hit area, which is the behaviour a corner marker on a
270
+ // clickable card wants. `pointer-events-none` would instead punch a hole in the hit
271
+ // area of anything the sticker overlaps that is NOT its ancestor. The sticker still
272
+ // never RECEIVES an interaction of its own: no role, no tabIndex, no handler.
273
+ <span
274
+ ref={ref}
275
+ // a11y floor "Dekorativní ikony" applied at the component level, gated by the
276
+ // spec's condition. See `decorative` for why this is conditional and why the
277
+ // `false` arm needs no sr-only twin.
278
+ aria-hidden={decorative ? 'true' : undefined}
279
+ data-fods-component="promo-sticker"
280
+ data-fods-part="root"
281
+ className={cn(slots.root(), className)}
282
+ {...rest}
283
+ >
284
+ {/*
285
+ The brush is pure decoration and holds no text, so it is hidden from the a11y
286
+ tree unconditionally — on the `decorative={false}` arm the root is exposed and
287
+ this empty layer must not turn up in it as an anonymous node.
288
+ */}
289
+ <span
290
+ aria-hidden="true"
291
+ data-fods-part="brush"
292
+ className={slots.brush()}
293
+ />
294
+ {layout === 'tile' ? (
295
+ <>
296
+ <span data-fods-part="title" className={slots.title()}>
297
+ {title}
298
+ </span>
299
+ <span data-fods-part="subtitle" className={slots.subtitle()}>
300
+ {subtitle}
301
+ </span>
302
+ </>
303
+ ) : (
304
+ <span data-fods-part="label" className={slots.label()}>
305
+ {children}
306
+ </span>
307
+ )}
308
+ </span>
309
+ );
310
+ });
311
+ PromoSticker.displayName = 'PromoSticker';
312
+
313
+ export { PromoSticker, promoStickerVariants };
@@ -0,0 +1,7 @@
1
+ export {
2
+ PromoSticker,
3
+ promoStickerVariants,
4
+ type PromoStickerProps,
5
+ type PromoStickerLayout,
6
+ type PromoStickerColor,
7
+ } from './PromoSticker';