@invoiceonline/ui-react 0.0.0-stage → 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (738) hide show
  1. package/AGENTS.md +99 -0
  2. package/CHANGELOG.md +131 -0
  3. package/LICENSE +9 -0
  4. package/README.md +78 -2
  5. package/dist/assets/label-brush-1.svg +6 -0
  6. package/dist/assets/pattern-dark.svg +113 -0
  7. package/dist/components/action-row/ActionRow.d.ts +178 -0
  8. package/dist/components/action-row/ActionRow.js +340 -0
  9. package/dist/components/action-row/index.d.ts +2 -0
  10. package/dist/components/action-row/index.js +1 -0
  11. package/dist/components/alert/Alert.d.ts +314 -0
  12. package/dist/components/alert/Alert.js +446 -0
  13. package/dist/components/alert/index.d.ts +2 -0
  14. package/dist/components/alert/index.js +1 -0
  15. package/dist/components/anchored-panel/AnchoredPanel.d.ts +41 -0
  16. package/dist/components/anchored-panel/AnchoredPanel.js +72 -0
  17. package/dist/components/anchored-panel/index.d.ts +3 -0
  18. package/dist/components/anchored-panel/index.js +3 -0
  19. package/dist/components/badge/Badge.d.ts +146 -0
  20. package/dist/components/badge/Badge.js +258 -0
  21. package/dist/components/badge/index.d.ts +2 -0
  22. package/dist/components/badge/index.js +1 -0
  23. package/dist/components/banner/Banner.d.ts +209 -0
  24. package/dist/components/banner/Banner.js +339 -0
  25. package/dist/components/banner/index.d.ts +2 -0
  26. package/dist/components/banner/index.js +1 -0
  27. package/dist/components/button/Button.d.ts +54 -0
  28. package/dist/components/button/Button.js +312 -0
  29. package/dist/components/button/index.d.ts +2 -0
  30. package/dist/components/button/index.js +1 -0
  31. package/dist/components/button-group/ButtonGroup.d.ts +187 -0
  32. package/dist/components/button-group/ButtonGroup.js +217 -0
  33. package/dist/components/button-group/index.d.ts +2 -0
  34. package/dist/components/button-group/index.js +1 -0
  35. package/dist/components/card-select/CardSelect.d.ts +274 -0
  36. package/dist/components/card-select/CardSelect.js +561 -0
  37. package/dist/components/card-select/CardSelectGroup.d.ts +92 -0
  38. package/dist/components/card-select/CardSelectGroup.js +72 -0
  39. package/dist/components/card-select/index.d.ts +3 -0
  40. package/dist/components/card-select/index.js +3 -0
  41. package/dist/components/checkbox/Checkbox.d.ts +104 -0
  42. package/dist/components/checkbox/Checkbox.js +194 -0
  43. package/dist/components/checkbox/index.d.ts +2 -0
  44. package/dist/components/checkbox/index.js +1 -0
  45. package/dist/components/chip/Chip.d.ts +250 -0
  46. package/dist/components/chip/Chip.js +441 -0
  47. package/dist/components/chip/index.d.ts +2 -0
  48. package/dist/components/chip/index.js +1 -0
  49. package/dist/components/column-header/ColumnHeader.d.ts +144 -0
  50. package/dist/components/column-header/ColumnHeader.js +209 -0
  51. package/dist/components/column-header/index.d.ts +2 -0
  52. package/dist/components/column-header/index.js +1 -0
  53. package/dist/components/combobox-field/Combobox.d.ts +104 -0
  54. package/dist/components/combobox-field/Combobox.js +355 -0
  55. package/dist/components/combobox-field/ComboboxField.d.ts +76 -0
  56. package/dist/components/combobox-field/ComboboxField.js +98 -0
  57. package/dist/components/combobox-field/index.d.ts +3 -0
  58. package/dist/components/combobox-field/index.js +3 -0
  59. package/dist/components/date-field/DateField.d.ts +52 -0
  60. package/dist/components/date-field/DateField.js +45 -0
  61. package/dist/components/date-field/index.d.ts +2 -0
  62. package/dist/components/date-field/index.js +1 -0
  63. package/dist/components/date-picker/DatePicker.d.ts +53 -0
  64. package/dist/components/date-picker/DatePicker.js +329 -0
  65. package/dist/components/date-picker/index.d.ts +2 -0
  66. package/dist/components/date-picker/index.js +1 -0
  67. package/dist/components/divider/Divider.d.ts +81 -0
  68. package/dist/components/divider/Divider.js +93 -0
  69. package/dist/components/divider/index.d.ts +2 -0
  70. package/dist/components/divider/index.js +1 -0
  71. package/dist/components/drawer/Drawer.d.ts +128 -0
  72. package/dist/components/drawer/Drawer.js +367 -0
  73. package/dist/components/drawer/index.d.ts +2 -0
  74. package/dist/components/drawer/index.js +1 -0
  75. package/dist/components/dropdown-button/DropdownButton.d.ts +72 -0
  76. package/dist/components/dropdown-button/DropdownButton.js +122 -0
  77. package/dist/components/dropdown-button/index.d.ts +2 -0
  78. package/dist/components/dropdown-button/index.js +1 -0
  79. package/dist/components/faq/FAQ.d.ts +135 -0
  80. package/dist/components/faq/FAQ.js +258 -0
  81. package/dist/components/faq/index.d.ts +2 -0
  82. package/dist/components/faq/index.js +1 -0
  83. package/dist/components/field/Field.d.ts +118 -0
  84. package/dist/components/field/Field.js +327 -0
  85. package/dist/components/field/index.d.ts +2 -0
  86. package/dist/components/field/index.js +1 -0
  87. package/dist/components/field-pair/FieldPair.d.ts +194 -0
  88. package/dist/components/field-pair/FieldPair.js +321 -0
  89. package/dist/components/field-pair/index.d.ts +2 -0
  90. package/dist/components/field-pair/index.js +1 -0
  91. package/dist/components/file-upload/FileUpload.d.ts +137 -0
  92. package/dist/components/file-upload/FileUpload.js +434 -0
  93. package/dist/components/file-upload/index.d.ts +2 -0
  94. package/dist/components/file-upload/index.js +1 -0
  95. package/dist/components/filter-chip/FilterChip.d.ts +373 -0
  96. package/dist/components/filter-chip/FilterChip.js +517 -0
  97. package/dist/components/filter-chip/index.d.ts +2 -0
  98. package/dist/components/filter-chip/index.js +1 -0
  99. package/dist/components/filter-facet/FilterFacet.d.ts +116 -0
  100. package/dist/components/filter-facet/FilterFacet.js +632 -0
  101. package/dist/components/filter-facet/index.d.ts +2 -0
  102. package/dist/components/filter-facet/index.js +1 -0
  103. package/dist/components/firm-avatar/FirmAvatar.d.ts +75 -0
  104. package/dist/components/firm-avatar/FirmAvatar.js +119 -0
  105. package/dist/components/firm-avatar/index.d.ts +2 -0
  106. package/dist/components/firm-avatar/index.js +1 -0
  107. package/dist/components/form-actions/FormActions.d.ts +123 -0
  108. package/dist/components/form-actions/FormActions.js +195 -0
  109. package/dist/components/form-actions/index.d.ts +2 -0
  110. package/dist/components/form-actions/index.js +1 -0
  111. package/dist/components/form-block/FormBlock.d.ts +252 -0
  112. package/dist/components/form-block/FormBlock.js +420 -0
  113. package/dist/components/form-block/index.d.ts +3 -0
  114. package/dist/components/form-block/index.js +3 -0
  115. package/dist/components/form-section/FormSection.d.ts +130 -0
  116. package/dist/components/form-section/FormSection.js +206 -0
  117. package/dist/components/form-section/index.d.ts +2 -0
  118. package/dist/components/form-section/index.js +1 -0
  119. package/dist/components/heading/Heading.d.ts +69 -0
  120. package/dist/components/heading/Heading.js +79 -0
  121. package/dist/components/heading/index.d.ts +2 -0
  122. package/dist/components/heading/index.js +1 -0
  123. package/dist/components/heading-group/HeadingGroup.d.ts +258 -0
  124. package/dist/components/heading-group/HeadingGroup.js +255 -0
  125. package/dist/components/heading-group/index.d.ts +2 -0
  126. package/dist/components/heading-group/index.js +1 -0
  127. package/dist/components/hero/Hero.d.ts +268 -0
  128. package/dist/components/hero/Hero.js +316 -0
  129. package/dist/components/hero/index.d.ts +2 -0
  130. package/dist/components/hero/index.js +1 -0
  131. package/dist/components/icon/Icon.d.ts +27 -0
  132. package/dist/components/icon/Icon.js +30 -0
  133. package/dist/components/icon/index.d.ts +3 -0
  134. package/dist/components/icon/index.js +3 -0
  135. package/dist/components/icon-button/IconButton.d.ts +75 -0
  136. package/dist/components/icon-button/IconButton.js +151 -0
  137. package/dist/components/icon-button/index.d.ts +2 -0
  138. package/dist/components/icon-button/index.js +1 -0
  139. package/dist/components/item-row/ItemRow.d.ts +253 -0
  140. package/dist/components/item-row/ItemRow.js +496 -0
  141. package/dist/components/item-row/index.d.ts +2 -0
  142. package/dist/components/item-row/index.js +1 -0
  143. package/dist/components/list-row/ListRow.d.ts +165 -0
  144. package/dist/components/list-row/ListRow.js +233 -0
  145. package/dist/components/list-row/index.d.ts +2 -0
  146. package/dist/components/list-row/index.js +1 -0
  147. package/dist/components/menu/Menu.d.ts +64 -0
  148. package/dist/components/menu/Menu.js +186 -0
  149. package/dist/components/menu/index.d.ts +2 -0
  150. package/dist/components/menu/index.js +1 -0
  151. package/dist/components/modal/Modal.d.ts +272 -0
  152. package/dist/components/modal/Modal.js +788 -0
  153. package/dist/components/modal/index.d.ts +2 -0
  154. package/dist/components/modal/index.js +1 -0
  155. package/dist/components/nav-link/NavLink.d.ts +123 -0
  156. package/dist/components/nav-link/NavLink.js +157 -0
  157. package/dist/components/nav-link/index.d.ts +2 -0
  158. package/dist/components/nav-link/index.js +1 -0
  159. package/dist/components/number-field/NumberField.d.ts +62 -0
  160. package/dist/components/number-field/NumberField.js +210 -0
  161. package/dist/components/number-field/index.d.ts +2 -0
  162. package/dist/components/number-field/index.js +1 -0
  163. package/dist/components/pagination/Pagination.d.ts +133 -0
  164. package/dist/components/pagination/Pagination.js +217 -0
  165. package/dist/components/pagination/index.d.ts +3 -0
  166. package/dist/components/pagination/index.js +3 -0
  167. package/dist/components/popover-surface/index.d.ts +2 -0
  168. package/dist/components/popover-surface/index.js +1 -0
  169. package/dist/components/progress-bar/ProgressBar.d.ts +260 -0
  170. package/dist/components/progress-bar/ProgressBar.js +470 -0
  171. package/dist/components/progress-bar/index.d.ts +2 -0
  172. package/dist/components/progress-bar/index.js +1 -0
  173. package/dist/components/promo-sticker/PromoSticker.d.ts +204 -0
  174. package/dist/components/promo-sticker/PromoSticker.js +177 -0
  175. package/dist/components/promo-sticker/index.d.ts +2 -0
  176. package/dist/components/promo-sticker/index.js +1 -0
  177. package/dist/components/promo-surface/PromoSurface.d.ts +94 -0
  178. package/dist/components/promo-surface/PromoSurface.js +119 -0
  179. package/dist/components/promo-surface/index.d.ts +2 -0
  180. package/dist/components/promo-surface/index.js +1 -0
  181. package/dist/components/radio/Radio.d.ts +92 -0
  182. package/dist/components/radio/Radio.js +171 -0
  183. package/dist/components/radio/index.d.ts +2 -0
  184. package/dist/components/radio/index.js +1 -0
  185. package/dist/components/radio-group/RadioGroup.d.ts +61 -0
  186. package/dist/components/radio-group/RadioGroup.js +51 -0
  187. package/dist/components/radio-group/index.d.ts +2 -0
  188. package/dist/components/radio-group/index.js +1 -0
  189. package/dist/components/select/Select.d.ts +65 -0
  190. package/dist/components/select/Select.js +176 -0
  191. package/dist/components/select/index.d.ts +2 -0
  192. package/dist/components/select/index.js +1 -0
  193. package/dist/components/select-field/SelectField.d.ts +16 -0
  194. package/dist/components/select-field/SelectField.js +55 -0
  195. package/dist/components/select-field/index.d.ts +2 -0
  196. package/dist/components/select-field/index.js +1 -0
  197. package/dist/components/skeleton/Skeleton.d.ts +64 -0
  198. package/dist/components/skeleton/Skeleton.js +65 -0
  199. package/dist/components/skeleton/index.d.ts +2 -0
  200. package/dist/components/skeleton/index.js +1 -0
  201. package/dist/components/split-button/SplitButton.d.ts +80 -0
  202. package/dist/components/split-button/SplitButton.js +182 -0
  203. package/dist/components/split-button/index.d.ts +2 -0
  204. package/dist/components/split-button/index.js +1 -0
  205. package/dist/components/status-summary-bar/StatusSummaryBar.d.ts +118 -0
  206. package/dist/components/status-summary-bar/StatusSummaryBar.js +278 -0
  207. package/dist/components/status-summary-bar/index.d.ts +2 -0
  208. package/dist/components/status-summary-bar/index.js +1 -0
  209. package/dist/components/subject-lookup-field/SubjectLookupField.d.ts +157 -0
  210. package/dist/components/subject-lookup-field/SubjectLookupField.js +663 -0
  211. package/dist/components/subject-lookup-field/index.d.ts +2 -0
  212. package/dist/components/subject-lookup-field/index.js +1 -0
  213. package/dist/components/switch/Switch.d.ts +152 -0
  214. package/dist/components/switch/Switch.js +307 -0
  215. package/dist/components/switch/index.d.ts +2 -0
  216. package/dist/components/switch/index.js +1 -0
  217. package/dist/components/table/Table.d.ts +5 -0
  218. package/dist/components/table/Table.js +601 -0
  219. package/dist/components/table/index.d.ts +6 -0
  220. package/dist/components/table/index.js +6 -0
  221. package/dist/components/text-field/TextField.d.ts +65 -0
  222. package/dist/components/text-field/TextField.js +173 -0
  223. package/dist/components/text-field/index.d.ts +2 -0
  224. package/dist/components/text-field/index.js +1 -0
  225. package/dist/components/text-link/TextLink.d.ts +260 -0
  226. package/dist/components/text-link/TextLink.js +303 -0
  227. package/dist/components/text-link/index.d.ts +2 -0
  228. package/dist/components/text-link/index.js +1 -0
  229. package/dist/components/textarea/Textarea.d.ts +93 -0
  230. package/dist/components/textarea/Textarea.js +256 -0
  231. package/dist/components/textarea/index.d.ts +2 -0
  232. package/dist/components/textarea/index.js +1 -0
  233. package/dist/components/tooltip/Tooltip.d.ts +129 -0
  234. package/dist/components/tooltip/Tooltip.js +457 -0
  235. package/dist/components/tooltip/index.d.ts +2 -0
  236. package/dist/components/tooltip/index.js +1 -0
  237. package/dist/components/unit-field/UnitField.d.ts +46 -0
  238. package/dist/components/unit-field/UnitField.js +133 -0
  239. package/dist/components/unit-field/index.d.ts +2 -0
  240. package/dist/components/unit-field/index.js +1 -0
  241. package/dist/icons/icon-registry.generated.js +500 -0
  242. package/dist/icons/icon-types.generated.d.ts +2 -0
  243. package/dist/icons/icon-types.generated.js +126 -0
  244. package/dist/index.d.ts +132 -0
  245. package/dist/index.js +75 -0
  246. package/dist/internal/BottomSheet.js +496 -0
  247. package/dist/internal/FodsProvider.d.ts +25 -0
  248. package/dist/internal/FodsProvider.js +32 -0
  249. package/dist/internal/MotionCaret.js +35 -0
  250. package/dist/internal/NumberFormatInput.d.ts +21 -0
  251. package/dist/internal/NumberFormatInput.js +126 -0
  252. package/dist/internal/SummaryDonut.d.ts +3 -0
  253. package/dist/internal/SummaryDonut.js +300 -0
  254. package/dist/internal/buttonSegment.d.ts +44 -0
  255. package/dist/internal/buttonSegment.js +126 -0
  256. package/dist/internal/collapseRoom.js +128 -0
  257. package/dist/internal/comboboxKeys.js +44 -0
  258. package/dist/internal/contentPresence.js +46 -0
  259. package/dist/internal/dayCell.js +95 -0
  260. package/dist/internal/dialogPortal.d.ts +2 -0
  261. package/dist/internal/dialogPortal.js +21 -0
  262. package/dist/internal/donutSweeps.js +65 -0
  263. package/dist/internal/enterOnViewGeometry.js +46 -0
  264. package/dist/internal/faqItem.js +80 -0
  265. package/dist/internal/floatingLabelMotion.js +68 -0
  266. package/dist/internal/formBlockContext.d.ts +22 -0
  267. package/dist/internal/formBlockContext.js +20 -0
  268. package/dist/internal/heightRoom.js +87 -0
  269. package/dist/internal/numberSeparators.js +62 -0
  270. package/dist/internal/overlayMotion.js +48 -0
  271. package/dist/internal/paginationItem.d.ts +8 -0
  272. package/dist/internal/paginationItem.js +22 -0
  273. package/dist/internal/popoverSurface.d.ts +8 -0
  274. package/dist/internal/popoverSurface.js +23 -0
  275. package/dist/internal/portalContainer.d.ts +1 -0
  276. package/dist/internal/portalContainer.js +6 -0
  277. package/dist/internal/progressBarItem.d.ts +207 -0
  278. package/dist/internal/progressBarItem.js +264 -0
  279. package/dist/internal/selectionControlText.js +12 -0
  280. package/dist/internal/statusSummaryParts.js +371 -0
  281. package/dist/internal/summaryMotion.js +75 -0
  282. package/dist/internal/table/ChildConnector.js +62 -0
  283. package/dist/internal/table/ChildRowPrefix.d.ts +9 -0
  284. package/dist/internal/table/ChildRowPrefix.js +27 -0
  285. package/dist/internal/table/ColumnSettings.js +135 -0
  286. package/dist/internal/table/ScrollRegion.js +114 -0
  287. package/dist/internal/table/TableEmpty.js +93 -0
  288. package/dist/internal/table/TableLayout.d.ts +17 -0
  289. package/dist/internal/table/TableLayout.js +29 -0
  290. package/dist/internal/table/TableLoadStatus.js +56 -0
  291. package/dist/internal/table/TableMobile.js +488 -0
  292. package/dist/internal/table/TruncatedCell.js +33 -0
  293. package/dist/internal/table/emptyValue.js +10 -0
  294. package/dist/internal/table/features.d.ts +41 -0
  295. package/dist/internal/table/features.js +31 -0
  296. package/dist/internal/table/recipes.js +227 -0
  297. package/dist/internal/table/rowClick.js +9 -0
  298. package/dist/internal/table/types.d.ts +325 -0
  299. package/dist/internal/table/types.js +13 -0
  300. package/dist/internal/tailwind-variants.d.ts +3 -0
  301. package/dist/internal/tailwind-variants.js +37 -0
  302. package/dist/internal/tooltipContext.js +5 -0
  303. package/dist/internal/tw-merge-config.generated.js +314 -0
  304. package/dist/internal/useAnchoredPanel.d.ts +87 -0
  305. package/dist/internal/useAnchoredPanel.js +108 -0
  306. package/dist/internal/useCountUp.js +53 -0
  307. package/dist/internal/useDateFieldTrigger.js +183 -0
  308. package/dist/internal/useEChart.js +59 -0
  309. package/dist/internal/useEnterOnView.js +42 -0
  310. package/dist/internal/useFloatingBar.js +100 -0
  311. package/dist/internal/useFormReset.js +37 -0
  312. package/dist/internal/useIsMobile.js +44 -0
  313. package/dist/internal/useOneRowOverflow.js +88 -0
  314. package/dist/internal/usePrefersReducedMotion.js +25 -0
  315. package/dist/internal/useReturnFocus.js +26 -0
  316. package/dist/internal/utils.d.ts +7 -0
  317. package/dist/internal/utils.js +58 -0
  318. package/dist/node_modules/@tanstack/store/dist/store.d.ts +29 -0
  319. package/dist/node_modules/@tanstack/store/dist/types.d.ts +38 -0
  320. package/dist/node_modules/@tanstack/table-core/dist/core/cells/coreCellsFeature.d.ts +6 -0
  321. package/dist/node_modules/@tanstack/table-core/dist/core/cells/coreCellsFeature.types.d.ts +53 -0
  322. package/dist/node_modules/@tanstack/table-core/dist/core/columns/coreColumnsFeature.d.ts +6 -0
  323. package/dist/node_modules/@tanstack/table-core/dist/core/columns/coreColumnsFeature.types.d.ts +90 -0
  324. package/dist/node_modules/@tanstack/table-core/dist/core/coreFeatures.d.ts +17 -0
  325. package/dist/node_modules/@tanstack/table-core/dist/core/headers/coreHeadersFeature.d.ts +6 -0
  326. package/dist/node_modules/@tanstack/table-core/dist/core/headers/coreHeadersFeature.types.d.ts +114 -0
  327. package/dist/node_modules/@tanstack/table-core/dist/core/reactivity/coreReactivityFeature.types.d.ts +51 -0
  328. package/dist/node_modules/@tanstack/table-core/dist/core/row-models/coreRowModelsFeature.d.ts +6 -0
  329. package/dist/node_modules/@tanstack/table-core/dist/core/row-models/coreRowModelsFeature.types.d.ts +29 -0
  330. package/dist/node_modules/@tanstack/table-core/dist/core/rows/coreRowsFeature.d.ts +6 -0
  331. package/dist/node_modules/@tanstack/table-core/dist/core/rows/coreRowsFeature.types.d.ts +129 -0
  332. package/dist/node_modules/@tanstack/table-core/dist/core/table/coreTablesFeature.d.ts +6 -0
  333. package/dist/node_modules/@tanstack/table-core/dist/core/table/coreTablesFeature.types.d.ts +203 -0
  334. package/dist/node_modules/@tanstack/table-core/dist/features/cell-selection/cellSelectionFeature.d.ts +6 -0
  335. package/dist/node_modules/@tanstack/table-core/dist/features/cell-selection/cellSelectionFeature.types.d.ts +294 -0
  336. package/dist/node_modules/@tanstack/table-core/dist/features/cell-spanning/cellSpanningFeature.d.ts +11 -0
  337. package/dist/node_modules/@tanstack/table-core/dist/features/cell-spanning/cellSpanningFeature.types.d.ts +148 -0
  338. package/dist/node_modules/@tanstack/table-core/dist/features/column-faceting/columnFacetingFeature.d.ts +12 -0
  339. package/dist/node_modules/@tanstack/table-core/dist/features/column-faceting/columnFacetingFeature.types.d.ts +63 -0
  340. package/dist/node_modules/@tanstack/table-core/dist/features/column-filtering/columnFilteringFeature.d.ts +6 -0
  341. package/dist/node_modules/@tanstack/table-core/dist/features/column-filtering/columnFilteringFeature.types.d.ts +209 -0
  342. package/dist/node_modules/@tanstack/table-core/dist/features/column-filtering/filterFns.d.ts +35 -0
  343. package/dist/node_modules/@tanstack/table-core/dist/features/column-grouping/columnGroupingFeature.d.ts +6 -0
  344. package/dist/node_modules/@tanstack/table-core/dist/features/column-grouping/columnGroupingFeature.types.d.ts +128 -0
  345. package/dist/node_modules/@tanstack/table-core/dist/features/column-ordering/columnOrderingFeature.d.ts +6 -0
  346. package/dist/node_modules/@tanstack/table-core/dist/features/column-ordering/columnOrderingFeature.types.d.ts +82 -0
  347. package/dist/node_modules/@tanstack/table-core/dist/features/column-pinning/columnPinningFeature.d.ts +11 -0
  348. package/dist/node_modules/@tanstack/table-core/dist/features/column-pinning/columnPinningFeature.types.d.ts +195 -0
  349. package/dist/node_modules/@tanstack/table-core/dist/features/column-resizing/columnResizingFeature.d.ts +6 -0
  350. package/dist/node_modules/@tanstack/table-core/dist/features/column-resizing/columnResizingFeature.types.d.ts +73 -0
  351. package/dist/node_modules/@tanstack/table-core/dist/features/column-sizing/columnSizingFeature.d.ts +6 -0
  352. package/dist/node_modules/@tanstack/table-core/dist/features/column-sizing/columnSizingFeature.types.d.ts +134 -0
  353. package/dist/node_modules/@tanstack/table-core/dist/features/column-visibility/columnVisibilityFeature.d.ts +6 -0
  354. package/dist/node_modules/@tanstack/table-core/dist/features/column-visibility/columnVisibilityFeature.types.d.ts +92 -0
  355. package/dist/node_modules/@tanstack/table-core/dist/features/global-filtering/globalFilteringFeature.d.ts +6 -0
  356. package/dist/node_modules/@tanstack/table-core/dist/features/global-filtering/globalFilteringFeature.types.d.ts +67 -0
  357. package/dist/node_modules/@tanstack/table-core/dist/features/row-aggregation/aggregationFns.d.ts +23 -0
  358. package/dist/node_modules/@tanstack/table-core/dist/features/row-aggregation/rowAggregationFeature.d.ts +6 -0
  359. package/dist/node_modules/@tanstack/table-core/dist/features/row-aggregation/rowAggregationFeature.types.d.ts +183 -0
  360. package/dist/node_modules/@tanstack/table-core/dist/features/row-aggregation/rowAggregationFeature.utils.d.ts +18 -0
  361. package/dist/node_modules/@tanstack/table-core/dist/features/row-expanding/rowExpandingFeature.d.ts +6 -0
  362. package/dist/node_modules/@tanstack/table-core/dist/features/row-expanding/rowExpandingFeature.types.d.ts +125 -0
  363. package/dist/node_modules/@tanstack/table-core/dist/features/row-pagination/rowPaginationFeature.d.ts +6 -0
  364. package/dist/node_modules/@tanstack/table-core/dist/features/row-pagination/rowPaginationFeature.types.d.ts +135 -0
  365. package/dist/node_modules/@tanstack/table-core/dist/features/row-pinning/rowPinningFeature.d.ts +6 -0
  366. package/dist/node_modules/@tanstack/table-core/dist/features/row-pinning/rowPinningFeature.types.d.ts +76 -0
  367. package/dist/node_modules/@tanstack/table-core/dist/features/row-selection/rowSelectionFeature.d.ts +6 -0
  368. package/dist/node_modules/@tanstack/table-core/dist/features/row-selection/rowSelectionFeature.types.d.ts +187 -0
  369. package/dist/node_modules/@tanstack/table-core/dist/features/row-sorting/rowSortingFeature.d.ts +6 -0
  370. package/dist/node_modules/@tanstack/table-core/dist/features/row-sorting/rowSortingFeature.types.d.ts +236 -0
  371. package/dist/node_modules/@tanstack/table-core/dist/features/row-sorting/sortFns.d.ts +23 -0
  372. package/dist/node_modules/@tanstack/table-core/dist/features/stockFeatures.d.ts +37 -0
  373. package/dist/node_modules/@tanstack/table-core/dist/helpers/columnHelper.d.ts +47 -0
  374. package/dist/node_modules/@tanstack/table-core/dist/types/Cell.d.ts +16 -0
  375. package/dist/node_modules/@tanstack/table-core/dist/types/Column.d.ts +30 -0
  376. package/dist/node_modules/@tanstack/table-core/dist/types/ColumnDef.d.ts +123 -0
  377. package/dist/node_modules/@tanstack/table-core/dist/types/Header.d.ts +12 -0
  378. package/dist/node_modules/@tanstack/table-core/dist/types/HeaderGroup.d.ts +6 -0
  379. package/dist/node_modules/@tanstack/table-core/dist/types/Row.d.ts +24 -0
  380. package/dist/node_modules/@tanstack/table-core/dist/types/RowModel.d.ts +19 -0
  381. package/dist/node_modules/@tanstack/table-core/dist/types/RowModelFns.d.ts +11 -0
  382. package/dist/node_modules/@tanstack/table-core/dist/types/Table.d.ts +53 -0
  383. package/dist/node_modules/@tanstack/table-core/dist/types/TableFeatures.d.ts +416 -0
  384. package/dist/node_modules/@tanstack/table-core/dist/types/TableOptions.d.ts +78 -0
  385. package/dist/node_modules/@tanstack/table-core/dist/types/TableState.d.ts +46 -0
  386. package/dist/node_modules/@tanstack/table-core/dist/types/type-utils.d.ts +25 -0
  387. package/dist/shared.css +179 -0
  388. package/dist/styles.css +5467 -0
  389. package/dist/theme.css +314 -0
  390. package/dist/theme.map.json +278 -0
  391. package/dist/tokens/index.d.ts +2 -0
  392. package/dist/tokens/index.js +1 -0
  393. package/dist/tokens/tokens.generated.d.ts +2040 -0
  394. package/dist/tokens/tokens.generated.js +2053 -0
  395. package/dist/tokens.css +484 -0
  396. package/dist/tokens.flat.json +429 -0
  397. package/docs/Consuming.mdx +379 -0
  398. package/docs/Contributing.mdx +78 -0
  399. package/docs/ForAgents.mdx +53 -0
  400. package/docs/Introduction.mdx +54 -0
  401. package/llms.txt +556 -0
  402. package/package.json +357 -4
  403. package/src/components/action-row/ActionRow.mdx +686 -0
  404. package/src/components/action-row/ActionRow.stories.tsx +669 -0
  405. package/src/components/action-row/ActionRow.tsx +632 -0
  406. package/src/components/action-row/index.ts +9 -0
  407. package/src/components/alert/Alert.mdx +377 -0
  408. package/src/components/alert/Alert.stories.tsx +674 -0
  409. package/src/components/alert/Alert.tsx +579 -0
  410. package/src/components/alert/index.ts +13 -0
  411. package/src/components/anchored-panel/AnchoredPanel.mdx +381 -0
  412. package/src/components/anchored-panel/AnchoredPanel.stories.tsx +593 -0
  413. package/src/components/anchored-panel/AnchoredPanel.tsx +176 -0
  414. package/src/components/anchored-panel/index.ts +15 -0
  415. package/src/components/badge/Badge.mdx +487 -0
  416. package/src/components/badge/Badge.stories.tsx +375 -0
  417. package/src/components/badge/Badge.tsx +360 -0
  418. package/src/components/badge/index.ts +10 -0
  419. package/src/components/banner/Banner.mdx +704 -0
  420. package/src/components/banner/Banner.stories.tsx +448 -0
  421. package/src/components/banner/Banner.tsx +602 -0
  422. package/src/components/banner/index.ts +14 -0
  423. package/src/components/button/Button.mdx +286 -0
  424. package/src/components/button/Button.stories.tsx +381 -0
  425. package/src/components/button/Button.tsx +384 -0
  426. package/src/components/button/index.ts +1 -0
  427. package/src/components/button-group/ButtonGroup.mdx +512 -0
  428. package/src/components/button-group/ButtonGroup.stories.tsx +714 -0
  429. package/src/components/button-group/ButtonGroup.tsx +491 -0
  430. package/src/components/button-group/index.ts +10 -0
  431. package/src/components/card-select/CardSelect.mdx +662 -0
  432. package/src/components/card-select/CardSelect.stories.tsx +784 -0
  433. package/src/components/card-select/CardSelect.tsx +783 -0
  434. package/src/components/card-select/CardSelectGroup.tsx +169 -0
  435. package/src/components/card-select/index.ts +18 -0
  436. package/src/components/checkbox/Checkbox.mdx +269 -0
  437. package/src/components/checkbox/Checkbox.stories.tsx +306 -0
  438. package/src/components/checkbox/Checkbox.tsx +343 -0
  439. package/src/components/checkbox/index.ts +1 -0
  440. package/src/components/chip/Chip.mdx +683 -0
  441. package/src/components/chip/Chip.stories.tsx +734 -0
  442. package/src/components/chip/Chip.tsx +732 -0
  443. package/src/components/chip/index.ts +9 -0
  444. package/src/components/column-header/ColumnHeader.mdx +301 -0
  445. package/src/components/column-header/ColumnHeader.stories.tsx +319 -0
  446. package/src/components/column-header/ColumnHeader.tsx +287 -0
  447. package/src/components/column-header/index.ts +7 -0
  448. package/src/components/combobox-field/Combobox.tsx +693 -0
  449. package/src/components/combobox-field/ComboboxField.mdx +525 -0
  450. package/src/components/combobox-field/ComboboxField.stories.tsx +502 -0
  451. package/src/components/combobox-field/ComboboxField.tsx +259 -0
  452. package/src/components/combobox-field/index.ts +12 -0
  453. package/src/components/date-field/DateField.mdx +340 -0
  454. package/src/components/date-field/DateField.stories.tsx +221 -0
  455. package/src/components/date-field/DateField.tsx +176 -0
  456. package/src/components/date-field/index.ts +1 -0
  457. package/src/components/date-picker/DatePicker.mdx +436 -0
  458. package/src/components/date-picker/DatePicker.stories.tsx +458 -0
  459. package/src/components/date-picker/DatePicker.tsx +688 -0
  460. package/src/components/date-picker/index.ts +9 -0
  461. package/src/components/divider/Divider.mdx +256 -0
  462. package/src/components/divider/Divider.stories.tsx +177 -0
  463. package/src/components/divider/Divider.tsx +193 -0
  464. package/src/components/divider/index.ts +1 -0
  465. package/src/components/drawer/Drawer.mdx +518 -0
  466. package/src/components/drawer/Drawer.stories.tsx +392 -0
  467. package/src/components/drawer/Drawer.tsx +683 -0
  468. package/src/components/drawer/index.ts +1 -0
  469. package/src/components/dropdown-button/DropdownButton.mdx +285 -0
  470. package/src/components/dropdown-button/DropdownButton.stories.tsx +398 -0
  471. package/src/components/dropdown-button/DropdownButton.tsx +198 -0
  472. package/src/components/dropdown-button/index.ts +7 -0
  473. package/src/components/faq/FAQ.mdx +364 -0
  474. package/src/components/faq/FAQ.stories.tsx +343 -0
  475. package/src/components/faq/FAQ.tsx +337 -0
  476. package/src/components/faq/index.ts +1 -0
  477. package/src/components/field/Field.mdx +129 -0
  478. package/src/components/field/Field.stories.tsx +461 -0
  479. package/src/components/field/Field.tsx +765 -0
  480. package/src/components/field/index.ts +20 -0
  481. package/src/components/field-pair/FieldPair.mdx +308 -0
  482. package/src/components/field-pair/FieldPair.stories.tsx +530 -0
  483. package/src/components/field-pair/FieldPair.tsx +796 -0
  484. package/src/components/field-pair/index.ts +9 -0
  485. package/src/components/file-upload/FileUpload.mdx +345 -0
  486. package/src/components/file-upload/FileUpload.stories.tsx +698 -0
  487. package/src/components/file-upload/FileUpload.tsx +802 -0
  488. package/src/components/file-upload/index.ts +6 -0
  489. package/src/components/filter-chip/FilterChip.mdx +778 -0
  490. package/src/components/filter-chip/FilterChip.stories.tsx +827 -0
  491. package/src/components/filter-chip/FilterChip.tsx +881 -0
  492. package/src/components/filter-chip/index.ts +11 -0
  493. package/src/components/filter-facet/FilterFacet.mdx +536 -0
  494. package/src/components/filter-facet/FilterFacet.stories.tsx +506 -0
  495. package/src/components/filter-facet/FilterFacet.tsx +1160 -0
  496. package/src/components/filter-facet/index.ts +7 -0
  497. package/src/components/firm-avatar/FirmAvatar.mdx +280 -0
  498. package/src/components/firm-avatar/FirmAvatar.stories.tsx +147 -0
  499. package/src/components/firm-avatar/FirmAvatar.tsx +172 -0
  500. package/src/components/firm-avatar/index.ts +7 -0
  501. package/src/components/form-actions/FormActions.mdx +518 -0
  502. package/src/components/form-actions/FormActions.stories.tsx +621 -0
  503. package/src/components/form-actions/FormActions.tsx +273 -0
  504. package/src/components/form-actions/index.ts +6 -0
  505. package/src/components/form-block/FormBlock.mdx +728 -0
  506. package/src/components/form-block/FormBlock.stories.tsx +813 -0
  507. package/src/components/form-block/FormBlock.tsx +679 -0
  508. package/src/components/form-block/index.ts +13 -0
  509. package/src/components/form-section/FormSection.mdx +436 -0
  510. package/src/components/form-section/FormSection.stories.tsx +407 -0
  511. package/src/components/form-section/FormSection.tsx +290 -0
  512. package/src/components/form-section/index.ts +17 -0
  513. package/src/components/heading/Heading.mdx +206 -0
  514. package/src/components/heading/Heading.stories.tsx +169 -0
  515. package/src/components/heading/Heading.tsx +124 -0
  516. package/src/components/heading/index.ts +8 -0
  517. package/src/components/heading-group/HeadingGroup.mdx +521 -0
  518. package/src/components/heading-group/HeadingGroup.stories.tsx +353 -0
  519. package/src/components/heading-group/HeadingGroup.tsx +396 -0
  520. package/src/components/heading-group/index.ts +7 -0
  521. package/src/components/hero/Hero.mdx +742 -0
  522. package/src/components/hero/Hero.stories.tsx +527 -0
  523. package/src/components/hero/Hero.tsx +807 -0
  524. package/src/components/hero/index.ts +1 -0
  525. package/src/components/icon/Icon.mdx +329 -0
  526. package/src/components/icon/Icon.stories.tsx +398 -0
  527. package/src/components/icon/Icon.tsx +97 -0
  528. package/src/components/icon/index.ts +2 -0
  529. package/src/components/icon-button/IconButton.mdx +206 -0
  530. package/src/components/icon-button/IconButton.stories.tsx +341 -0
  531. package/src/components/icon-button/IconButton.tsx +273 -0
  532. package/src/components/icon-button/index.ts +1 -0
  533. package/src/components/item-row/ItemRow.mdx +533 -0
  534. package/src/components/item-row/ItemRow.stories.tsx +434 -0
  535. package/src/components/item-row/ItemRow.tsx +676 -0
  536. package/src/components/item-row/index.ts +9 -0
  537. package/src/components/list-row/ListRow.mdx +404 -0
  538. package/src/components/list-row/ListRow.stories.tsx +404 -0
  539. package/src/components/list-row/ListRow.tsx +424 -0
  540. package/src/components/list-row/index.ts +1 -0
  541. package/src/components/menu/Menu.mdx +268 -0
  542. package/src/components/menu/Menu.stories.tsx +455 -0
  543. package/src/components/menu/Menu.tsx +452 -0
  544. package/src/components/menu/index.ts +1 -0
  545. package/src/components/modal/Modal.mdx +854 -0
  546. package/src/components/modal/Modal.stories.tsx +881 -0
  547. package/src/components/modal/Modal.tsx +1434 -0
  548. package/src/components/modal/index.ts +1 -0
  549. package/src/components/nav-link/NavLink.mdx +196 -0
  550. package/src/components/nav-link/NavLink.stories.tsx +243 -0
  551. package/src/components/nav-link/NavLink.tsx +222 -0
  552. package/src/components/nav-link/index.ts +1 -0
  553. package/src/components/number-field/NumberField.mdx +223 -0
  554. package/src/components/number-field/NumberField.stories.tsx +291 -0
  555. package/src/components/number-field/NumberField.tsx +388 -0
  556. package/src/components/number-field/index.ts +6 -0
  557. package/src/components/pagination/Pagination.mdx +305 -0
  558. package/src/components/pagination/Pagination.stories.tsx +333 -0
  559. package/src/components/pagination/Pagination.tsx +343 -0
  560. package/src/components/pagination/index.ts +8 -0
  561. package/src/components/popover-surface/PopoverSurface.mdx +158 -0
  562. package/src/components/popover-surface/PopoverSurface.stories.tsx +421 -0
  563. package/src/components/popover-surface/index.ts +1 -0
  564. package/src/components/progress-bar/ProgressBar.mdx +802 -0
  565. package/src/components/progress-bar/ProgressBar.stories.tsx +533 -0
  566. package/src/components/progress-bar/ProgressBar.tsx +654 -0
  567. package/src/components/progress-bar/index.ts +9 -0
  568. package/src/components/promo-sticker/PromoSticker.mdx +436 -0
  569. package/src/components/promo-sticker/PromoSticker.stories.tsx +363 -0
  570. package/src/components/promo-sticker/PromoSticker.tsx +313 -0
  571. package/src/components/promo-sticker/index.ts +7 -0
  572. package/src/components/promo-surface/PromoSurface.mdx +399 -0
  573. package/src/components/promo-surface/PromoSurface.stories.tsx +270 -0
  574. package/src/components/promo-surface/PromoSurface.tsx +305 -0
  575. package/src/components/promo-surface/index.ts +7 -0
  576. package/src/components/radio/Radio.mdx +243 -0
  577. package/src/components/radio/Radio.stories.tsx +307 -0
  578. package/src/components/radio/Radio.tsx +288 -0
  579. package/src/components/radio/index.ts +1 -0
  580. package/src/components/radio-group/RadioGroup.mdx +119 -0
  581. package/src/components/radio-group/RadioGroup.stories.tsx +225 -0
  582. package/src/components/radio-group/RadioGroup.tsx +139 -0
  583. package/src/components/radio-group/index.ts +1 -0
  584. package/src/components/select/Select.mdx +241 -0
  585. package/src/components/select/Select.stories.tsx +404 -0
  586. package/src/components/select/Select.tsx +381 -0
  587. package/src/components/select/index.ts +1 -0
  588. package/src/components/select-field/SelectField.mdx +324 -0
  589. package/src/components/select-field/SelectField.stories.tsx +460 -0
  590. package/src/components/select-field/SelectField.tsx +138 -0
  591. package/src/components/select-field/index.ts +1 -0
  592. package/src/components/skeleton/Skeleton.mdx +194 -0
  593. package/src/components/skeleton/Skeleton.stories.tsx +260 -0
  594. package/src/components/skeleton/Skeleton.tsx +107 -0
  595. package/src/components/skeleton/index.ts +1 -0
  596. package/src/components/split-button/SplitButton.mdx +445 -0
  597. package/src/components/split-button/SplitButton.stories.tsx +465 -0
  598. package/src/components/split-button/SplitButton.tsx +361 -0
  599. package/src/components/split-button/index.ts +7 -0
  600. package/src/components/status-summary-bar/StatusSummaryBar.mdx +338 -0
  601. package/src/components/status-summary-bar/StatusSummaryBar.stories.tsx +408 -0
  602. package/src/components/status-summary-bar/StatusSummaryBar.tsx +428 -0
  603. package/src/components/status-summary-bar/index.ts +8 -0
  604. package/src/components/subject-lookup-field/SubjectLookupField.mdx +378 -0
  605. package/src/components/subject-lookup-field/SubjectLookupField.stories.tsx +393 -0
  606. package/src/components/subject-lookup-field/SubjectLookupField.tsx +1079 -0
  607. package/src/components/subject-lookup-field/index.ts +11 -0
  608. package/src/components/switch/Switch.mdx +376 -0
  609. package/src/components/switch/Switch.stories.tsx +296 -0
  610. package/src/components/switch/Switch.tsx +483 -0
  611. package/src/components/switch/index.ts +1 -0
  612. package/src/components/table/Table.mdx +575 -0
  613. package/src/components/table/Table.stories.tsx +1049 -0
  614. package/src/components/table/Table.tsx +745 -0
  615. package/src/components/table/TableConsumers.stories.tsx +195 -0
  616. package/src/components/table/_tableFixtures.ts +1189 -0
  617. package/src/components/table/index.ts +22 -0
  618. package/src/components/text-field/TextField.mdx +479 -0
  619. package/src/components/text-field/TextField.stories.tsx +366 -0
  620. package/src/components/text-field/TextField.tsx +391 -0
  621. package/src/components/text-field/index.ts +8 -0
  622. package/src/components/text-link/TextLink.mdx +353 -0
  623. package/src/components/text-link/TextLink.stories.tsx +458 -0
  624. package/src/components/text-link/TextLink.tsx +504 -0
  625. package/src/components/text-link/index.ts +10 -0
  626. package/src/components/textarea/Textarea.mdx +244 -0
  627. package/src/components/textarea/Textarea.stories.tsx +371 -0
  628. package/src/components/textarea/Textarea.tsx +489 -0
  629. package/src/components/textarea/index.ts +9 -0
  630. package/src/components/tooltip/Tooltip.mdx +462 -0
  631. package/src/components/tooltip/Tooltip.stories.tsx +500 -0
  632. package/src/components/tooltip/Tooltip.tsx +756 -0
  633. package/src/components/tooltip/index.ts +13 -0
  634. package/src/components/unit-field/UnitField.mdx +215 -0
  635. package/src/components/unit-field/UnitField.stories.tsx +291 -0
  636. package/src/components/unit-field/UnitField.tsx +255 -0
  637. package/src/components/unit-field/index.ts +7 -0
  638. package/src/icons/icon-registry.generated.ts +510 -0
  639. package/src/icons/icon-types.generated.ts +256 -0
  640. package/src/index.ts +71 -0
  641. package/src/internal/BottomSheet.tsx +714 -0
  642. package/src/internal/FodsProvider.tsx +36 -0
  643. package/src/internal/MotionCaret.tsx +53 -0
  644. package/src/internal/NumberFormatInput.tsx +276 -0
  645. package/src/internal/SummaryDonut.tsx +359 -0
  646. package/src/internal/buttonSegment.ts +241 -0
  647. package/src/internal/collapseRoom.ts +130 -0
  648. package/src/internal/comboboxKeys.ts +90 -0
  649. package/src/internal/contentPresence.ts +46 -0
  650. package/src/internal/dayCell.ts +274 -0
  651. package/src/internal/dialogPortal.ts +50 -0
  652. package/src/internal/donutSweeps.ts +77 -0
  653. package/src/internal/enterOnViewGeometry.ts +53 -0
  654. package/src/internal/faqItem.ts +104 -0
  655. package/src/internal/floatingLabelMotion.tsx +109 -0
  656. package/src/internal/formBlockContext.ts +27 -0
  657. package/src/internal/heightRoom.ts +135 -0
  658. package/src/internal/numberSeparators.ts +93 -0
  659. package/src/internal/overlayMotion.tsx +32 -0
  660. package/src/internal/paginationItem.ts +106 -0
  661. package/src/internal/popoverSurface.ts +78 -0
  662. package/src/internal/portalContainer.ts +11 -0
  663. package/src/internal/progressBarItem.ts +356 -0
  664. package/src/internal/selectionControlText.ts +42 -0
  665. package/src/internal/statusSummaryParts.tsx +475 -0
  666. package/src/internal/summaryMotion.ts +111 -0
  667. package/src/internal/table/ChildConnector.tsx +57 -0
  668. package/src/internal/table/ChildRowPrefix.tsx +21 -0
  669. package/src/internal/table/ColumnSettings.tsx +194 -0
  670. package/src/internal/table/ScrollRegion.tsx +176 -0
  671. package/src/internal/table/TableEmpty.tsx +99 -0
  672. package/src/internal/table/TableLayout.tsx +29 -0
  673. package/src/internal/table/TableLoadStatus.tsx +60 -0
  674. package/src/internal/table/TableMobile.tsx +582 -0
  675. package/src/internal/table/TruncatedCell.tsx +35 -0
  676. package/src/internal/table/emptyValue.ts +11 -0
  677. package/src/internal/table/features.ts +44 -0
  678. package/src/internal/table/recipes.ts +263 -0
  679. package/src/internal/table/rowClick.ts +8 -0
  680. package/src/internal/table/types.ts +342 -0
  681. package/src/internal/tailwind-variants.ts +65 -0
  682. package/src/internal/tooltipContext.ts +15 -0
  683. package/src/internal/tw-merge-config.generated.ts +275 -0
  684. package/src/internal/useAnchoredPanel.ts +340 -0
  685. package/src/internal/useCountUp.ts +65 -0
  686. package/src/internal/useDateFieldTrigger.tsx +357 -0
  687. package/src/internal/useEChart.ts +88 -0
  688. package/src/internal/useEnterOnView.ts +80 -0
  689. package/src/internal/useFloatingBar.ts +125 -0
  690. package/src/internal/useFormReset.ts +47 -0
  691. package/src/internal/useIsMobile.ts +64 -0
  692. package/src/internal/useNoImplicitSubmit.ts +41 -0
  693. package/src/internal/useOneRowOverflow.ts +103 -0
  694. package/src/internal/usePrefersReducedMotion.ts +27 -0
  695. package/src/internal/useReturnFocus.ts +34 -0
  696. package/src/internal/utils.ts +58 -0
  697. package/src/recipes/EmptyState.stories.tsx +105 -0
  698. package/src/recipes/Form.stories.tsx +355 -0
  699. package/src/recipes/ModalWithForm.stories.tsx +219 -0
  700. package/src/recipes/Recipes.mdx +61 -0
  701. package/src/recipes/TableWithFilters.stories.tsx +278 -0
  702. package/src/storybook/FodsFamily.tsx +39 -0
  703. package/src/storybook/Section.tsx +36 -0
  704. package/src/storybook/a11y.ts +24 -0
  705. package/src/storybook/assets/banner-character-bartender.webp +0 -0
  706. package/src/storybook/assets/banner-invoice-sheet-left.webp +0 -0
  707. package/src/storybook/assets/banner-invoice-sheet-right.webp +0 -0
  708. package/src/storybook/assets/invoice-hero.webp +0 -0
  709. package/src/storybook/assets/invoice.webp +0 -0
  710. package/src/storybook/assets/section-document-info.svg +21 -0
  711. package/src/storybook/assets/section-gear-checklist.svg +11 -0
  712. package/src/storybook/assets/section-person-arrow-in.svg +15 -0
  713. package/src/storybook/assets/section-person-arrow-out.svg +22 -0
  714. package/src/storybook/assets/section-receipt-dollar.svg +23 -0
  715. package/src/storybook/assets/table-empty-folder-empty.png +0 -0
  716. package/src/storybook/assets/table-empty-folder-magnifying-glass.png +0 -0
  717. package/src/storybook/assets/table-empty-funnel.png +0 -0
  718. package/src/storybook/assets/table-empty-load-failed.png +0 -0
  719. package/src/storybook/assets/wallet-spot.png +0 -0
  720. package/src/storybook/assets.d.ts +17 -0
  721. package/src/storybook/componentDoc.ts +41 -0
  722. package/src/storybook/fitFrame.tsx +70 -0
  723. package/src/storybook/forceStates.tsx +647 -0
  724. package/src/storybook/illustrations.tsx +66 -0
  725. package/src/storybook/viewportFrame.tsx +58 -0
  726. package/src/styles/assets/label-brush-1.svg +6 -0
  727. package/src/styles/assets/pattern-dark.svg +113 -0
  728. package/src/styles/base.css +106 -0
  729. package/src/styles/index.css +15 -0
  730. package/src/styles/motion.css +157 -0
  731. package/src/styles/promo-sticker.css +27 -0
  732. package/src/styles/promo-surface.css +49 -0
  733. package/src/styles/shared.css +11 -0
  734. package/src/styles/theme.generated.css +314 -0
  735. package/src/styles/theme.map.json +278 -0
  736. package/src/styles/tracking.generated.css +12 -0
  737. package/src/tokens/index.ts +4 -0
  738. package/src/tokens/tokens.generated.ts +542 -0
@@ -0,0 +1,521 @@
1
+ import { Meta, Canvas, Controls } from '@storybook/addon-docs/blocks';
2
+ import * as HeadingGroupStories from './HeadingGroup.stories';
3
+
4
+ <Meta of={HeadingGroupStories} tags={['autodocs']} />
5
+
6
+
7
+ # HeadingGroup
8
+
9
+ ## Metadata
10
+
11
+ - **Layer:** molecule
12
+ - **Kind:** structure
13
+ - **Status:** draft
14
+ - **Tokens used:** `--font-body`, `--font-decorative`, `--font-heading`, `--font-size-4xl`, `--font-size-base`, `--font-size-display-d1`, `--font-size-display-d2`, `--font-size-display-d3`, `--font-size-heading-h1`, `--font-size-heading-h2`, `--font-size-heading-h3`, `--font-size-heading-h4`, `--font-size-heading-h5`, `--font-size-lg`, `--font-size-md`, `--font-size-sm`, `--font-weight-bold`, `--font-weight-semibold`, `--leading-compact`, `--leading-loose`, `--leading-relaxed`, `--leading-tight`, `--secondary`, `--space-200`, `--space-400`, `--space-600`, `--space-700`, `--size-icon`, `--size-illustration-section`, `--size-illustration-spot`, `--text-primary`, `--text-secondary`, `--text-wrap-body`, `--text-wrap-heading`
15
+ - **Manifest version:** `1.11.0`
16
+ - **Composes:** [Heading](?path=/docs/design-system-atoms-heading--docs) (manifest `slots.heading.ref` → `heading`); an `Illustration / Spot` or `Illustration / Section` picture (manifest `slots.illustration.ref` → `illustrations`, an asset spec — the caller supplies the element); [Icon](?path=/docs/design-system-atoms-icon--docs) (manifest `slots.icon.ref` → `icon`)
17
+
18
+ ## Overview
19
+
20
+ **HeadingGroup** is a single block made of a heading, a description line underneath it, an
21
+ optional decorative kicker above it and an optional 48×48 illustration to the left. Use it wherever
22
+ a heading carries a supporting description — a page or section opener, an empty state, an FAQ item,
23
+ a marketing block — or a leading illustration: the page title of a list page (`h1`) or a form page
24
+ (`h2`) and the block heading inside a form tile (`h3`). A small section heading (`h4`, `h5`) can
25
+ instead carry a leading icon.
26
+
27
+ Do **not** use it for a bare heading with no description, illustration or icon — that is the
28
+ [Heading](?path=/docs/design-system-atoms-heading--docs) atom directly. The same goes for a heading
29
+ above a list (bullets, an article listing) and for an article byline (date · category · reading
30
+ time): those are metadata, not a description, and are composed from the Heading atom directly.
31
+
32
+ ## Rationale
33
+
34
+ The heading → description gap and the kicker → heading gap are both keyed by size (manifest
35
+ `sizes[].descriptionGap` / `sizes[].gap`), so they do not drift apart between occurrences the way
36
+ an eyeballed margin does. The molecule exists precisely to carry that pair — everything else (the
37
+ heading's type ramp, its colour) is inherited from the Heading atom and is not re-declared here.
38
+ The illustration sits inside the block's own row, so its gap and its centring on the whole text
39
+ stack are set once by the molecule instead of being measured on every page.
40
+
41
+ ## Anatomy
42
+
43
+ A row around a nested text stack, never one flat column — the two gaps differ on D1–H3 (manifest
44
+ `notes[3]`). Since 1.8.0 the text-group is a column of a `title-row` (optional icon + `title-group`)
45
+ and a `description-wrap`, so the description starts at the block's start edge, under the icon, not
46
+ under the heading text.
47
+
48
+ <table>
49
+ <thead>
50
+ <tr><th>Part</th><th>Element</th><th>Role</th><th>Tokens</th></tr>
51
+ </thead>
52
+ <tbody>
53
+ <tr>
54
+ <td><code>root</code></td><td><code>&lt;div&gt;</code></td>
55
+ <td>Row: optional <code>illustration</code>, then <code>text-group</code>; children centred vertically. Without an illustration it holds only the text-group, so the block reads as a plain column.</td>
56
+ <td>gap <code>--space-600</code> (manifest <code>chrome.illustration.gap</code>)</td>
57
+ </tr>
58
+ <tr>
59
+ <td><code>illustration</code></td><td><code>&lt;div aria-hidden&gt;</code></td>
60
+ <td>Optional box holding the caller's picture, left of the text. One size at every <code>size</code>; centred on the whole text-group, not on the heading line. The direct child is stretched to fill the box.</td>
61
+ <td>48×48 — <code>--size-illustration-spot</code> (manifest <code>chrome.illustration</code>), <code>size-illustration-spot</code>; with <code>picture={40}</code> 40×40 — <code>--size-illustration-section</code> (manifest <code>chrome.illustration-section</code>), <code>size-illustration-section</code></td>
62
+ </tr>
63
+ <tr>
64
+ <td><code>text-group</code></td><td><code>&lt;div&gt;</code></td>
65
+ <td>Column filling the remaining width (<code>flex-1 min-w-0</code>): <code>title-row</code>, then <code>description-wrap</code>. Gap = the size's <code>descriptionGap</code>. Hugs its height.</td>
66
+ <td>see Sizes</td>
67
+ </tr>
68
+ <tr>
69
+ <td><code>title-row</code></td><td><code>&lt;div&gt;</code></td>
70
+ <td>Row: optional <code>icon</code>, then <code>title-group</code>. Without the icon it holds only the title-group.</td>
71
+ <td>gap <code>--space-400</code> (manifest <code>chrome.icon.gap</code>)</td>
72
+ </tr>
73
+ <tr>
74
+ <td><code>icon</code></td><td><code>&lt;span aria-hidden&gt;</code></td>
75
+ <td>Optional icon slot at the start of the title row holding an Icon glyph. Top of the row, one heading line tall (<code>self-start h-[1lh]</code> on a box carrying the heading's type class), so the glyph centres on the heading's first line and stays there when the heading wraps.</td>
76
+ <td>colour <code>--secondary</code>; box 24 — <code>--size-icon</code> (manifest <code>chrome.icon.size</code>), the glyph's width and height</td>
77
+ </tr>
78
+ <tr>
79
+ <td><code>title-group</code></td><td><code>&lt;div&gt;</code></td>
80
+ <td>Inner column filling the width left of the icon (<code>flex-1 min-w-0</code>): optional <code>kicker</code>, then <code>heading</code>. Gap = the size's <code>gap</code>.</td>
81
+ <td>see Sizes</td>
82
+ </tr>
83
+ <tr>
84
+ <td><code>kicker</code></td><td><code>&lt;p&gt;</code></td>
85
+ <td>Optional decorative line above the heading. Single line, truncated (<code>truncate</code>); manifest <code>text.kicker</code>: max 32 characters.</td>
86
+ <td><code>--font-decorative</code> (Caveat), colour <code>--secondary</code>; style per size (see Sizes)</td>
87
+ </tr>
88
+ <tr>
89
+ <td><code>heading</code></td><td><code>&lt;h1&gt;</code>–<code>&lt;h6&gt;</code></td>
90
+ <td>The Heading atom at the same size; tag from <code>level</code>. Wraps, never truncates.</td>
91
+ <td><code>--font-heading</code>, colour <code>--text-primary</code>, <code>--text-wrap-heading</code>; weight and size from the Heading atom's ramp</td>
92
+ </tr>
93
+ <tr>
94
+ <td><code>description-wrap</code></td><td><code>&lt;div&gt;</code></td>
95
+ <td>Rendered with the description; holds it below the title row, starting at the block's start edge. On <code>h4</code> / <code>h5</code> with the icon it adds one <code>--space-200</code> on top (Figma's zero-height <code>icon-gap</code> spacer, built as <code>pt-200</code> like the spec's CSS).</td>
96
+ <td><code>--space-200</code> (icon + <code>h4</code> / <code>h5</code> only)</td>
97
+ </tr>
98
+ <tr>
99
+ <td><code>description</code></td><td><code>&lt;p&gt;</code></td>
100
+ <td>Optional supporting line below the heading. Wraps, never truncates; manifest <code>text.description</code>: max 140 characters.</td>
101
+ <td><code>--font-body</code>, colour <code>--text-secondary</code>, <code>--text-wrap-body</code>; style per size (see Sizes)</td>
102
+ </tr>
103
+ </tbody>
104
+ </table>
105
+
106
+ The root is a plain `<div>`, **not `<hgroup>`**. The `hgroup` content model only allows paragraphs
107
+ around a single `h1`–`h6`, so the mandatory nested `title-group` would be invalid inside it, and its
108
+ implicit `group` role would add an unnamed node for no benefit. The document outline is carried by
109
+ the heading itself.
110
+
111
+ The kicker and the description render only when the prop is filled (not `null`, `false` or an empty
112
+ string), the illustration only when `illustration` is an element, the icon only when `icon` names a
113
+ glyph — no empty element is ever produced.
114
+
115
+ ## Variants
116
+
117
+ Eight `size` values (mirroring the Heading atom's ramp: `d1`–`d3` · `h1`–`h5`) × two `align` values
118
+ (`left` · `center`) = 16 variants. The kicker, the description, the illustration and the icon are
119
+ toggles layered on top — boolean properties in Figma (Kicker, Description, Show illustration, Show
120
+ icon), prop presence in code — and do not multiply the matrix. Figma's Illustration instance swap is
121
+ the element the caller passes; its Icon instance swap is the glyph name passed as `icon`.
122
+
123
+ <Canvas of={HeadingGroupStories.Matrix} />
124
+
125
+ <table>
126
+ <thead>
127
+ <tr><th>Property</th><th>Values</th><th>When</th></tr>
128
+ </thead>
129
+ <tbody>
130
+ <tr>
131
+ <td><code>size</code></td>
132
+ <td><code>d1</code>, <code>d2</code>, <code>d3</code>, <code>h1</code>, <code>h2</code>, <code>h3</code>, <code>h4</code>, <code>h5</code></td>
133
+ <td>By the visual weight the spot needs — the same rule as for the Heading atom, not by the level in the document. The default is derived from <code>level</code> (see API).</td>
134
+ </tr>
135
+ <tr>
136
+ <td><code>align</code></td>
137
+ <td><code>left</code> (default), <code>center</code></td>
138
+ <td><code>center</code> only for a genuinely centred composition (e.g. a centred hero block). <code>center</code> adds <code>items-center text-center</code> to both <code>root</code> and <code>title-group</code>.</td>
139
+ </tr>
140
+ <tr>
141
+ <td><code>kicker</code></td>
142
+ <td>optional (Figma default: off)</td>
143
+ <td>Only as a decorative marketing flourish.</td>
144
+ </tr>
145
+ <tr>
146
+ <td><code>description</code></td>
147
+ <td>optional (Figma default: on)</td>
148
+ <td>Whenever the block carries a description — without one (and without an illustration), reach for the Heading atom.</td>
149
+ </tr>
150
+ <tr>
151
+ <td><code>illustration</code></td>
152
+ <td>optional element (Figma: Show illustration, default off; Illustration swap, default <code>wallet</code>)</td>
153
+ <td>Only at <code>h1</code> (list page title), <code>h2</code> (form page title) or <code>h3</code> (Form Block header), with <code>align="left"</code> and no kicker. A Form Block header takes its block's <code>Illustration / Section</code> picture.</td>
154
+ </tr>
155
+ <tr>
156
+ <td><code>picture</code></td>
157
+ <td><code>48</code> (default) · <code>40</code> (Figma: Picture)</td>
158
+ <td><code>40</code> only at <code>h3</code> with <code>align="left"</code> — the Form Block header at Breakpoint=Mobile, holding the <code>Illustration / Section</code> picture at Size=40. No effect without <code>illustration</code>.</td>
159
+ </tr>
160
+ <tr>
161
+ <td><code>icon</code></td>
162
+ <td>optional glyph name (Figma: Show icon, default off; Icon swap, default <code>gear</code>)</td>
163
+ <td>Only at <code>h4</code> or <code>h5</code>, with <code>align="left"</code> and no kicker. Never together with the illustration — the props type admits one or the other.</td>
164
+ </tr>
165
+ </tbody>
166
+ </table>
167
+
168
+ <Canvas of={HeadingGroupStories.Toggles} />
169
+
170
+ ### Illustration
171
+
172
+ <Canvas of={HeadingGroupStories.Illustration} />
173
+
174
+ The picture comes from the `Illustration / Spot` set (a proportional scale of its 100×100 master,
175
+ default `wallet`) or the `Illustration / Section` set (native 48×48: `receipt-dollar`,
176
+ `document-info`, `person-arrow-out`, `person-arrow-in`, `gear-checklist`) — see the upstream
177
+ `spec/03-atoms/illustrations.md`.
178
+ Those are image assets, not components, so the caller imports the file and passes the element. In
179
+ the `Illustration` and `Mobile` stories the h1 and h2 examples and the Playground's `wallet` option
180
+ use the Spot `wallet` asset (`src/storybook/assets/wallet-spot.png`, the 100×100 master
181
+ scaled to 48 — per § Spot, "a proportionally scaled instance for page-title icons"); the h3 Form Block header examples use the Section `receipt-dollar` picture, as a
182
+ form block's header takes its block's Section picture. Where the illustration may be switched on is a usage rule the
183
+ consumer applies — the component does not enforce it, just as the Figma component set does not.
184
+
185
+ **Below md.** On a form page title (`h2`) the consumer turns the illustration off under 768 px; the
186
+ list page title (`h1`) and the `h3` Form Block header keep it at every breakpoint (manifest 1.9.0).
187
+ The component carries no responsive logic of its own — hide the part from outside:
188
+ `className="max-md:[&_[data-fods-part=illustration]]:hidden"`.
189
+
190
+ **Picture=40.** `picture={40}` shrinks the box to 40×40 (`--size-illustration-section`, manifest
191
+ `chrome.illustration-section`), same `--space-600` gap. It exists only at `h3` with `align="left"`:
192
+ the Form Block header at Breakpoint=Mobile, whose Section picture comes at Size=40 — a proportional
193
+ scale of the 48 master, so the same asset file fills the smaller box. The consumer picks it by
194
+ viewport (e.g. `picture={isMobile ? 40 : 48}`).
195
+
196
+ ### Icon
197
+
198
+ <Canvas of={HeadingGroupStories.Icon} />
199
+
200
+ A leading [Icon](?path=/docs/design-system-atoms-icon--docs) glyph (default `gear`, picked for the topic of the
201
+ section) in a `--size-icon` (24px) box, `--space-400` from the heading, ink `--secondary`. The slot is at the top of
202
+ the title row and one heading line tall, so the glyph centres on the heading's first line, not on the
203
+ whole block, and stays on it when the heading wraps. The description is **not** indented under the
204
+ heading text: it sits in `description-wrap`, below the title row, and starts at the block's start
205
+ edge, under the icon. Where the icon may be switched on (`h4`, `h5`; left-aligned; no kicker) is a
206
+ usage rule the consumer applies; only the mutual exclusion with the illustration is enforced, by the
207
+ props type.
208
+
209
+ The `size` values are the lowercase steps of the type ramp, not the t-shirt vocabulary from the
210
+ conventions — approved deviation `size-vocabulary-type-ramp` (`COMPONENT-CODE-CONVENTIONS.md` §7),
211
+ shared with the Heading atom.
212
+
213
+ ## Sizes
214
+
215
+ There is no separate size scale — `size` mirrors the Heading atom's ramp. Each row of the manifest
216
+ `sizes[]` sets both gaps and the style of the description and the kicker:
217
+
218
+ <table>
219
+ <thead>
220
+ <tr>
221
+ <th>Size</th><th>Heading</th>
222
+ <th>Kicker → heading (<code>gap</code>)</th>
223
+ <th>Title-group → description (<code>descriptionGap</code>)</th>
224
+ <th>Description</th><th>Kicker</th>
225
+ </tr>
226
+ </thead>
227
+ <tbody>
228
+ <tr><td><code>d1</code></td><td>Display/D1</td><td><code>--space-400</code> (8)</td><td><code>--space-700</code> (20)</td><td>Body/XL Regular — <code>--font-size-lg</code></td><td>Decorative/Caveat/32 — <code>--font-size-4xl</code></td></tr>
229
+ <tr><td><code>d2</code></td><td>Display/D2</td><td><code>--space-400</code> (8)</td><td><code>--space-600</code> (16)</td><td>Body/L Regular — <code>--font-size-md</code></td><td>Decorative/Caveat/32 — <code>--font-size-4xl</code></td></tr>
230
+ <tr><td><code>d3</code></td><td>Display/D3</td><td><code>--space-400</code> (8)</td><td><code>--space-600</code> (16)</td><td>Body/L Regular — <code>--font-size-md</code></td><td>Decorative/Caveat/32 — <code>--font-size-4xl</code></td></tr>
231
+ <tr><td><code>h1</code></td><td>Heading/H1</td><td><code>--space-200</code> (4)</td><td><code>--space-400</code> (8)</td><td>Body/M Regular — <code>--font-size-base</code></td><td>Decorative/Caveat/20 — <code>--font-size-lg</code></td></tr>
232
+ <tr><td><code>h2</code></td><td>Heading/H2</td><td><code>--space-200</code> (4)</td><td><code>--space-400</code> (8)</td><td>Body/M Regular — <code>--font-size-base</code></td><td>Decorative/Caveat/20 — <code>--font-size-lg</code></td></tr>
233
+ <tr><td><code>h3</code></td><td>Heading/H3</td><td><code>--space-200</code> (4)</td><td><code>--space-400</code> (8)</td><td>Body/M Regular — <code>--font-size-base</code></td><td>Decorative/Caveat/20 — <code>--font-size-lg</code></td></tr>
234
+ <tr><td><code>h4</code></td><td>Heading/H4</td><td><code>--space-200</code> (4)</td><td><code>--space-200</code> (4)</td><td>Body/S Regular — <code>--font-size-sm</code></td><td>Decorative/Caveat/20 — <code>--font-size-lg</code></td></tr>
235
+ <tr><td><code>h5</code></td><td>Heading/H5</td><td><code>--space-200</code> (4)</td><td><code>--space-200</code> (4)</td><td>Body/S Regular — <code>--font-size-sm</code></td><td>Decorative/Caveat/20 — <code>--font-size-lg</code></td></tr>
236
+ </tbody>
237
+ </table>
238
+
239
+ - **D1–H3:** the gap to the kicker is roughly half the gap to the description, so the kicker reads
240
+ as a label of the heading, not as a third equal line.
241
+ - **H4 / H5:** both gaps are equal and the description steps down to Body/S — the heading is 18 px
242
+ on desktop / 16 on mobile (`h4`) and 16 px on desktop / 14 on mobile (`h5`), so a 16 px
243
+ description would sit at the same size. At `h5` on mobile the heading and its Body/S description
244
+ are both 14 px and are told apart by font family and weight alone — accepted upstream; the
245
+ description stays Body/S at every breakpoint (manifest `sizes[H5].note`).
246
+ - **Gaps are fixed on every viewport** (manifest `notes[1]`) — no breakpoint classes. On mobile only
247
+ the heading and description type shrinks, and it does so through the token layer.
248
+ - **The illustration has one size** — 48×48 (`--size-illustration-spot`) next to every `size` row, with the same `--space-600`
249
+ gap to the text (manifest `chrome.illustration`). The one exception is the Picture axis: `picture={40}`
250
+ at `h3` Left gives 40×40 (`--size-illustration-section`, `chrome.illustration-section`) for the Form
251
+ Block header at Mobile.
252
+ - **The icon has one size** — a `--size-icon` (24px) box (manifest `chrome.icon.size`), `--space-400` from the heading (manifest
253
+ `chrome.icon`). **Under an icon heading the heading → description gap is at least `--space-400`:**
254
+ on `h4` / `h5` the `descriptionGap` is `--space-200`, so the icon adds one more `--space-200` on
255
+ `description-wrap` (4 + 4). It exists only with a description, so an icon heading without one gets
256
+ no extra space below. On `h1`–`h3` the `descriptionGap` is already `--space-400` and nothing is
257
+ added.
258
+ - **The kicker has a px line-height** (40 px for Caveat/32, 26 px for Caveat/20). `text-styles.json`
259
+ has `lineHeight: null` on both Caveat styles — Caveat does not scale responsively, so a px value
260
+ cannot drift. The kicker style is fixed for each table row and does not step down on mobile.
261
+
262
+ <Canvas of={HeadingGroupStories.Mobile} />
263
+
264
+ ### Carve-out: a promo plaque takes Body/XL at every step
265
+
266
+ The description-style ladder above applies **to section headers, not to a promo plaque**. Components
267
+ that build a promo plaque on [PromoSurface](?path=/docs/design-system-atoms-promosurface--docs) —
268
+ today [Hero](?path=/docs/design-system-organisms-hero--docs) and
269
+ [Banner](?path=/docs/design-system-organisms-banner--docs) — borrow the **gap** ladder from this block,
270
+ but not the description ladder: their body is **Body/XL Regular at every step and every
271
+ breakpoint**, including the D2 step (where the ladder gives Body/L) and mobile. The plaque body is a
272
+ lead paragraph, not a supporting section line.
273
+
274
+ Neither organism composes this molecule, so this is a rule about the ladder's **scope**, not an
275
+ exception inside HeadingGroup. A HeadingGroup placed on a plaque still follows the ladder.
276
+
277
+ ## States
278
+
279
+ HeadingGroup is static — the kicker, the heading and the description are plain text, the
280
+ illustration is a picture and the icon a decorative glyph; nothing in the block is interactive. It has no hover, focus, pressed, disabled or loading state (manifest
281
+ `intent.states`: "n/a"), and therefore no `States` story either.
282
+
283
+ **Motion: none.** The block does not move — the manifest declares it static (`motion.none`:
284
+ "static text group"; motion system, `spec/01-foundations/motion-system.md`).
285
+ It carries no transition or animation of its own and inherits none, so there is nothing to play
286
+ in a motion story and nothing for `prefers-reduced-motion` to switch off.
287
+
288
+ ## API
289
+
290
+ <Controls />
291
+
292
+ - **`heading`** (`ReactNode`, required) — the heading text, rendered by the Heading atom at `size`.
293
+ - **`level`** (`1`–`6`, default `2`) — the semantic level and tag of the heading, independent of `size`.
294
+ The default `2` = a section opener under the page's single `h1`.
295
+ - **`size`** — the default is derived from `level` the same way as for the Heading atom (1→`h1` … 5→`h5`,
296
+ 6→`h5`); with the default `level` it is `h2`.
297
+ - **`align`** (`'left' | 'center'`, default `'left'`).
298
+ - **`description`** (`ReactNode`, optional) — the supporting line below the heading.
299
+ - **`kicker`** (`ReactNode`, optional) — the decorative Caveat line above the heading.
300
+ - **`kickerAriaHidden`** (`boolean`, default `true`) — see Accessibility.
301
+ - **`illustration`** (`ReactElement | null`, optional) — the 48×48 picture left of the text (Figma
302
+ Show illustration + Illustration). Pass the asset element, e.g. `<img src={wallet} alt="" />`;
303
+ the box stretches it and is `aria-hidden`.
304
+ - **`picture`** (`48 | 40`, default `48`) — the illustration box (Figma Picture): `48` =
305
+ `--size-illustration-spot`, `40` = `--size-illustration-section`. `40` only at `h3` +
306
+ `align="left"`, the Form Block header at Mobile.
307
+ - **`icon`** (`IconName | null`, optional) — the leading glyph in the title row (Figma Show icon +
308
+ Icon, default `gear`), e.g. `icon="gear"`; canonical FODS names resolve through the Icon alias
309
+ table. `aria-hidden`. Mutually exclusive with `illustration` at the type level.
310
+ - **`headingId`** (`string`, optional) — `id` on the heading element, for an outer `aria-labelledby` (generate it with `useId`).
311
+ - **`descriptionId`** (`string`, optional) — `id` on the description `<p>`, for an outer `aria-describedby` (generate it with `useId`).
312
+ - Every other HTML attribute of a `<div>` (including `className`) goes to `root`; the `ref` points to
313
+ the root `<div>` (`forwardRef`).
314
+
315
+ ### Kicker on a tinted surface
316
+
317
+ The kicker is bound to `--secondary`. On a `--secondary-subtle` / `--secondary-soft` surface it is
318
+ **rebound by the consumer** to `--secondary-tint-foreground` (manifest `notes[2]`) — the component
319
+ does not detect its surface, so there is no prop for it. Target it from outside via the part:
320
+
321
+ ```tsx
322
+ <HeadingGroup
323
+ className="[&_[data-fods-part=kicker]]:text-secondary-tint-foreground"
324
+ kicker="Fakturační program"
325
+ heading="Všechno, co potřebujete k fakturaci"
326
+ description="Vystavuj, odesílej a sleduj faktury na jednom místě."
327
+ />
328
+ ```
329
+
330
+ ## Do / Don't
331
+
332
+ - ✅ Use it whenever a heading carries a supporting description.
333
+ - ✅ Use the kicker only as a decorative marketing element.
334
+ - ✅ Use `align="center"` only for a genuinely centred hero block.
335
+ - ✅ Leave both gaps to the component (two nested columns).
336
+ - ✅ Give a promo plaque body (Hero, Banner) Body/XL at every step.
337
+ - ✅ Keep the description to one or two sentences (max 140 characters) and the kicker to a short phrase (max 32 characters).
338
+ - ✅ Switch the illustration on at `h1` (list page title), `h2` (form page title) or `h3` (Form Block header).
339
+ - ✅ Keep `align="left"` and no kicker whenever the illustration is on.
340
+ - ✅ Pick the picture for the topic of the page or block (an expenses page → `wallet`).
341
+ - ✅ Turn the form-page-title (`h2`) illustration off below md; keep the list-page-title (`h1`) and `h3` block pictures at every breakpoint.
342
+ - ✅ Use `picture={40}` only for the `h3` Form Block header at Mobile.
343
+ - ✅ Switch the icon on at `h4` or `h5`, with `align="left"` and no kicker.
344
+ - ✅ Use either the icon or the illustration.
345
+ - ✅ Let the description start at the block's edge, under the icon.
346
+ - ✅ Pick the glyph for the topic of the section it heads.
347
+ - ❌ Don't use it for a bare heading — reach for the Heading atom.
348
+ - ❌ Don't repurpose the kicker as an eyebrow label for a product section.
349
+ - ❌ Don't centre a regular in-app section heading.
350
+ - ❌ Don't flatten the block into a single column with one gap, and don't add eyeballed gaps.
351
+ - ❌ Don't apply the D2 → Body/L ladder to a Hero or Banner body.
352
+ - ❌ Don't switch it on at `d1`–`d3`, `h4`, `h5`, or on an `h2` that is not a page title.
353
+ - ❌ Don't combine the illustration with `align="center"` or a kicker.
354
+ - ❌ Don't use the picture to signal a status or a warning — screen-reader users never receive it; say it in the heading, the description or an Alert.
355
+ - ❌ Don't scale the picture with `size` or give it alt text of its own.
356
+ - ❌ Don't drop the list-page-title (`h1`) picture on a phone, or use `picture={40}` at any size other than `h3` Left.
357
+ - ❌ Don't switch it on at `h1`–`h3` — those take the illustration — or combine it with `align="center"` or a kicker.
358
+ - ❌ Don't show the icon and the illustration on one block.
359
+ - ❌ Don't indent the description under the heading text.
360
+ - ❌ Don't use the icon to signal a status or a warning — it is hidden from assistive technology.
361
+ - ❌ Don't put a back button or any other control inside HeadingGroup — on a form page it sits beside the block (upstream Form layout → H1 zone).
362
+
363
+ ## Accessibility
364
+
365
+ - **Keyboard** — nothing in the block is focusable; the component adds no tab stops.
366
+ - **ARIA** — the heading is a real `<h1>`–`<h6>` from `level`, independent of the visual `size`;
367
+ keep `level` in line with the page outline and do not skip levels for the sake of size. The root
368
+ is a `<div>` with no role (not `<hgroup>`, see Anatomy).
369
+ - **Kicker** — the rule from the spec: when the kicker's words are **redundant** with content
370
+ elsewhere in the block or on the page, it is hidden (`aria-hidden="true"`); when it names something
371
+ not said elsewhere, it **must not** be hidden. Redundancy is the case it is designed for, which is
372
+ why `kickerAriaHidden` defaults to `true`. Pass `kickerAriaHidden={false}` when the kicker carries
373
+ its own information — the attribute is then not rendered at all and the kicker stays in the
374
+ accessibility tree. In that case, though, truncation must not be relied on: silent `truncate` is
375
+ safe only for a redundant kicker, so an informative kicker must be short enough not to be cut off.
376
+ The `Kicker · in the a11y tree` story shows this case.
377
+ - **Illustration** — decorative. The component puts `aria-hidden="true"` on the `illustration` box,
378
+ so the picture never enters the accessibility tree whatever element is passed; still give an
379
+ `<img>` an empty `alt=""`. The heading carries the block's accessible name, so the picture never
380
+ signals anything on its own.
381
+ - **Icon** — decorative. The `icon` slot carries `aria-hidden="true"` and never enters the
382
+ accessibility tree; a status the glyph might suggest is said in the heading or the description.
383
+ - **Screen reader** — by default a screen reader reads the heading with its level and then the
384
+ description as a paragraph; it skips the kicker, the illustration and the icon. With `kickerAriaHidden={false}` it reads the
385
+ kicker as a paragraph before the heading.
386
+ - **Contrast & motion** — heading `--text-primary`, description `--text-secondary`, kicker and icon `--secondary`
387
+ (on a tinted surface rebind to `--secondary-tint-foreground`, see API). The component has no
388
+ animation (manifest `motion.none`, see States), so reduced motion needs no handling.
389
+
390
+ Accessibility floor for every FODS component: `spec/01-foundations/accessibility.md`.
391
+
392
+ ## Copy
393
+
394
+ Voice: the product tone, impersonal and in-app. This is display copy, not field copy: the rules
395
+ below are self-contained and share only the voice principles with the field-copy canon of Text Field.
396
+
397
+ - **Kicker** (`kicker`) — a short phrase, never a sentence, naming the theme the heading belongs
398
+ to. Single line, truncated when it overflows, max 32 characters.
399
+ - **Heading** (`heading`) — sentence case, no trailing period. Wraps, never truncates
400
+ (`text-wrap: balance`, as in the Heading atom).
401
+ - **Description** (`description`) — one to two sentences with a terminal period, stating the point
402
+ plainly. Wraps, never truncates; max 140 characters.
403
+
404
+ <table>
405
+ <thead>
406
+ <tr><th>Run</th><th>✅ Write</th><th>❌ Not</th></tr>
407
+ </thead>
408
+ <tbody>
409
+ <tr><td>Kicker</td><td><code>Fakturační program</code></td><td><code>Toto je náš fakturační program.</code></td></tr>
410
+ <tr><td>Heading</td><td><code>Všechno, co potřebujete k fakturaci</code></td><td><code>Všechno, Co Potřebujete K Fakturaci.</code></td></tr>
411
+ <tr><td>Description</td><td><code>Vystavuj, odesílej a sleduj faktury na jednom místě.</code></td><td><code>Fakturace nikdy nebyla jednodušší!!!</code></td></tr>
412
+ </tbody>
413
+ </table>
414
+
415
+ ## Usage
416
+
417
+ ```tsx
418
+ import { HeadingGroup } from '@invoiceonline/ui-react';
419
+
420
+ // Good — a section opener: h2 with a description
421
+ <HeadingGroup
422
+ heading="Všechno, co potřebujete k fakturaci"
423
+ description="Vystavuj, odesílej a sleduj faktury na jednom místě."
424
+ />
425
+
426
+ // Good — a marketing block: centred, with a kicker, visually d2, semantically h2
427
+ <HeadingGroup
428
+ size="d2"
429
+ align="center"
430
+ kicker="Fakturační program"
431
+ heading="Všechno, co potřebujete k fakturaci"
432
+ description="Vystavuj, odesílej a sleduj faktury na jednom místě."
433
+ />
434
+
435
+ // Good — the kicker carries information not said elsewhere: it stays available to screen readers
436
+ <HeadingGroup
437
+ kicker="Novinka pro plátce DPH"
438
+ kickerAriaHidden={false}
439
+ heading="Kontrolní hlášení na pár kliknutí"
440
+ description="Podklady se připraví z vystavených faktur."
441
+ />
442
+
443
+ // Good — a list page title with its illustration, on at every breakpoint
444
+ <HeadingGroup level={1} size="h1" heading="Výdaje" illustration={<img src={walletSpot} alt="" />} />
445
+
446
+ // Good — a form page title: its illustration hidden below md
447
+ <HeadingGroup
448
+ level={1}
449
+ size="h2"
450
+ heading="Nový výdaj"
451
+ illustration={<img src={walletSpot} alt="" />}
452
+ className="max-md:[&_[data-fods-part=illustration]]:hidden"
453
+ />
454
+
455
+ // Good — a Form Block header: its block's Section picture, on at every breakpoint
456
+ <HeadingGroup size="h3" heading="Položky faktury" illustration={<img src={receiptDollar} alt="" />} />
457
+
458
+ // Good — the same header at Mobile: the 40×40 box
459
+ <HeadingGroup size="h3" picture={40} heading="Položky faktury" illustration={<img src={receiptDollar} alt="" />} />
460
+
461
+ // Good — a small section heading with a leading icon; the description starts under the icon
462
+ <HeadingGroup level={3} size="h4" icon="gear" heading="Nastavení faktury" description="Výchozí splatnost a číselná řada." />
463
+
464
+ // Don't — an icon and an illustration on one block (rejected by the props type)
465
+ <HeadingGroup size="h3" icon="gear" illustration={<img src={walletSpot} alt="" />} heading="Výdaje" />
466
+
467
+ // Don't — a bare heading without a description: use the Heading atom
468
+ <HeadingGroup heading="Nejpopulárnější články" />
469
+
470
+ // Don't — heading + description assembled by hand with an eyeballed gap
471
+ <div className="flex flex-col gap-300">
472
+ <Heading level={2}>Všechno, co potřebujete k fakturaci</Heading>
473
+ <p className="text-text-secondary">Vystavuj, odesílej a sleduj faktury na jednom místě.</p>
474
+ </div>
475
+ ```
476
+
477
+ ## Related
478
+
479
+ - [Heading](?path=/docs/design-system-atoms-heading--docs) — the atom whose type ramp the molecule
480
+ composes 1:1; a change to the ramp shows up in both.
481
+ - [Hero](?path=/docs/design-system-organisms-hero--docs) and
482
+ [Banner](?path=/docs/design-system-organisms-banner--docs) — promo plaques that borrow the gap
483
+ ladder but do not compose the molecule (see the carve-out in Sizes).
484
+ - [Modal](?path=/docs/design-system-organisms-modal--docs) — has its own hand-assembled
485
+ `sectionHeader` slot (see Migration notes).
486
+ - Spec: `spec/04-molecules/heading-group.md`
487
+
488
+ ## Migration notes
489
+
490
+ - **1.10.1 / 1.10.2 (2026-11-03) — documentation only.** 1.10.1 corrects the H4 / H5 heading sizes
491
+ in the prose (H4 18 / 16 px, H5 16 / 14 px desktop / mobile; see Sizes); 1.10.2 records the
492
+ motion audit — the block is static (`motion.none`). No token, structure or code change.
493
+ - **1.10.0 (2026-11-02) — Picture axis.** New `picture` prop (`48 | 40`, default `48`): `40` is
494
+ the 40×40 box (`--size-illustration-section`) for the `h3` Form Block header at Mobile. Default
495
+ rendering is unchanged. The token ships in `@invoiceonline/ui-system` 0.15.0.
496
+ - **1.9.0 (2026-10-23) — list page title keeps its picture.** Only the form page title (`h2`)
497
+ drops the illustration below md; the list page title (`h1`) keeps it at every breakpoint. No code
498
+ change in the component — the rule is the consumer's (the stories no longer hide it on `h1`).
499
+
500
+ - **1.8.0 (2026-10-09) — icon + restructured text-group.** New `icon` prop (Show icon + Icon).
501
+ The text-group no longer holds `title-group` and `description` directly: it holds `title-row`
502
+ (icon + `title-group`) and `description-wrap` (the description). Without an icon nothing moves
503
+ visually — same gaps, same order — but a consumer selecting `title-group` or `description` as a
504
+ direct child of `text-group` must go through the new wrappers. The illustration box's manifest
505
+ binding moved from a spacing token to `--size-illustration-spot` (same 48px; code
506
+ `size-1100` → `size-illustration-spot` since ui-system 0.14.0), and the icon box binds `--size-icon`.
507
+
508
+ - **Renamed from `SectionHeader` (manifest 1.6.0, 2026-10-08).** Upstream renamed Section Header →
509
+ Heading Group because "Header" was taken (Web/Layout/Header, Column Header, the `header` regions in
510
+ manifests). Nothing structural changed — same variant matrix, same bindings. In
511
+ code: `SectionHeader` → `HeadingGroup`, `sectionHeaderVariants` → `headingGroupVariants`,
512
+ `data-fods-component="heading-group"`, story id `design-system-molecules-headinggroup`. No alias is
513
+ kept; the only consumer was renamed with it.
514
+ - **Ad-hoc heading + lede pairs** migrate to this molecule. The upstream spec specifically names the
515
+ `Compositions` story of the deprecated Storybook Heading, which
516
+ assembled hero blocks (heading + lede) by hand. According to the spec, its spacing utilities
517
+ (`space-y-*`) generated no CSS in that build, so the gaps there were accidental line-box leftovers,
518
+ not an intentional scale — the manifest ladder (`gap` / `descriptionGap`) replaces them entirely.
519
+ Migrated pairs also tighten by 2–3 px because of the Heading atom's line-height change (1.6 → 1.4,
520
+ 1.5 for H5) — see the Heading atom's Migration notes.
521
+ - **Migrated:** the former hand-built news section heading. **Remaining candidate:** the hand-assembled `sectionHeader` slot in Modal.