@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,407 @@
1
+ import * as React from 'react';
2
+ import type { Decorator, Meta, StoryObj } from '@storybook/react-vite';
3
+ import { Field } from '../field/Field';
4
+ import {
5
+ FormSection,
6
+ type FormSectionHeader,
7
+ type FormSectionHeadingLevel,
8
+ } from './FormSection';
9
+ import { TextField } from '../text-field/TextField';
10
+ import { componentDoc } from '../../storybook/componentDoc';
11
+ import {
12
+ SECTION_ILLUSTRATION_NAMES,
13
+ sectionIllustration,
14
+ type SectionIllustrationName,
15
+ } from '../../storybook/illustrations';
16
+
17
+ /** `axes.variant` — the Header axis, passed as the dedicated `header` prop. */
18
+ const HEADERS = ['none', 'h4', 'h3'] as const;
19
+
20
+ /**
21
+ * The five `Illustration / Section` pictures. The arg is the picture's name; the render
22
+ * passes the app-side element (`<img src={…} alt="" />`) — the package ships no picture.
23
+ */
24
+ const ILLUSTRATIONS = SECTION_ILLUSTRATION_NAMES;
25
+
26
+ const HEADING_LEVELS = [2, 3, 4, 5, 6] as const;
27
+
28
+ /**
29
+ * `axes.breakpoint` — NOT a prop (`properties[Breakpoint].maps`): reproduced by the
30
+ * viewport. Each viewport is the band minimum (1280 / 1024 / 768 / 640), Mobile the 390
31
+ * reference canvas, so Tailwind lands on the right prefix.
32
+ */
33
+ const BREAKPOINTS = ['XL', 'LG', 'MD', 'SM', 'Mobile'] as const;
34
+
35
+ const BREAKPOINT_WIDTH: Record<(typeof BREAKPOINTS)[number], number> = {
36
+ XL: 1280,
37
+ LG: 1024,
38
+ MD: 768,
39
+ SM: 640,
40
+ Mobile: 390,
41
+ };
42
+
43
+ const FORM_SECTION_VIEWPORTS = Object.fromEntries(
44
+ BREAKPOINTS.map(bp => [
45
+ bp,
46
+ {
47
+ name: `${bp} · ${BREAKPOINT_WIDTH[bp]}`,
48
+ // fods-lint-disable-next-line Storybook viewport sizes (band minimums), not design values
49
+ styles: { width: `${BREAKPOINT_WIDTH[bp]}px`, height: '900px' },
50
+ },
51
+ ]),
52
+ );
53
+
54
+ /** The section never paints a surface; the Form Block does. Modelled as a plain page pad. */
55
+ const pagePad: Decorator = Story => (
56
+ <div className="w-full bg-background-primary p-600 md:p-900">
57
+ <Story />
58
+ </div>
59
+ );
60
+
61
+ interface DemoFieldProps {
62
+ label: string;
63
+ value?: string;
64
+ placeholder?: string;
65
+ hideLabel?: boolean;
66
+ error?: string;
67
+ }
68
+
69
+ /** A Size md Text Field with its floating label — the default slot content. */
70
+ function DemoField({ label, value, placeholder, hideLabel, error }: DemoFieldProps) {
71
+ const id = React.useId();
72
+ return (
73
+ <Field label={label} hideLabel={hideLabel} size="md" error={error}>
74
+ <TextField id={id} size="md" defaultValue={value} placeholder={placeholder} />
75
+ </Field>
76
+ );
77
+ }
78
+
79
+ /** Default slot content per Header (`slots.fields.note`). */
80
+ function NoneFields() {
81
+ return (
82
+ <>
83
+ <DemoField label="Číslo" value="V2026090001" />
84
+ <DemoField label="Číslo dokladu" />
85
+ <DemoField label="Datum vystavení" value="02. 09. 2026" />
86
+ <DemoField label="Datum zdanitelného plnění" />
87
+ </>
88
+ );
89
+ }
90
+
91
+ function H4Fields() {
92
+ return (
93
+ // A Text Field stands in for the Subject Lookup Field. A half at
94
+ // LG/XL, the full width at MD (width marker).
95
+ <FormSection.Cell span={{ md: 'full', lg: 1 }}>
96
+ <DemoField label="Prodejce" hideLabel placeholder="Vyhledejte název firmy nebo IČO" />
97
+ </FormSection.Cell>
98
+ );
99
+ }
100
+
101
+ function H3Fields() {
102
+ return (
103
+ <>
104
+ <DemoField label="IČO" />
105
+ <DemoField label="Jméno" />
106
+ <DemoField label="DIČ" />
107
+ <DemoField label="Ulice" />
108
+ </>
109
+ );
110
+ }
111
+
112
+ const COPY = {
113
+ h4: { title: 'Prodejce na dokladu', description: '… neboli Dodavatel' },
114
+ h3: { title: 'Informace o vás', description: '… neboli Dodavatel' },
115
+ } as const;
116
+
117
+ /** Flat story args; the render turns them into the right arm of the header union. */
118
+ interface FormSectionStoryArgs {
119
+ header: FormSectionHeader;
120
+ title: string;
121
+ description?: string;
122
+ illustration: SectionIllustrationName;
123
+ span: 1 | 'full';
124
+ headingLevel?: FormSectionHeadingLevel;
125
+ children?: React.ReactNode;
126
+ }
127
+
128
+ function defaultFields(header: FormSectionHeader) {
129
+ if (header === 'h4') return <H4Fields />;
130
+ if (header === 'h3') return <H3Fields />;
131
+ return <NoneFields />;
132
+ }
133
+
134
+ function renderSection({ header, title, description, illustration, span, headingLevel, children }: FormSectionStoryArgs) {
135
+ const fields = children ?? defaultFields(header);
136
+ if (header === 'h4') {
137
+ return (
138
+ <FormSection header="h4" title={title} description={description} span={span} headingLevel={headingLevel}>
139
+ {fields}
140
+ </FormSection>
141
+ );
142
+ }
143
+ if (header === 'h3') {
144
+ return (
145
+ <FormSection
146
+ header="h3"
147
+ title={title}
148
+ description={description}
149
+ illustration={sectionIllustration(illustration)}
150
+ span={span}
151
+ headingLevel={headingLevel}
152
+ >
153
+ {fields}
154
+ </FormSection>
155
+ );
156
+ }
157
+ return (
158
+ <FormSection span={span} headingLevel={headingLevel}>
159
+ {fields}
160
+ </FormSection>
161
+ );
162
+ }
163
+
164
+ const meta: Meta<FormSectionStoryArgs> = {
165
+ title: 'Design System/Organisms/Form Section',
166
+ // Storybook 10 types `component` against the story args; the flat args do not match
167
+ // the header union of FormSectionProps, so cast through unknown.
168
+ component: FormSection as unknown as React.ComponentType<FormSectionStoryArgs>,
169
+ // No autodocs tag — FormSection.mdx provides the dedicated Docs page.
170
+ decorators: [pagePad],
171
+ globals: { viewport: { value: 'XL' } },
172
+ parameters: {
173
+ layout: 'fullscreen',
174
+ viewport: { options: FORM_SECTION_VIEWPORTS },
175
+ docs: {
176
+ description: {
177
+ component: componentDoc({
178
+ summary:
179
+ 'One group of fields inside a Form Block — an optional H4 heading over a responsive grid of halves, pairs and trio rows. Paints nothing; only lays out. Built against form-section.manifest.json 2.0.0.',
180
+ useCases: [
181
+ '`header="none"` (default) for a block\'s only group — the block header names it; the section element is the grid itself.',
182
+ '`header="h4"` for one of two or more sub-groups under a block header; never with a picture.',
183
+ '`header="h3"` is deprecated — the legacy parties tile only, with a required `illustration`.',
184
+ 'The breakpoint is not a prop: tracks and gaps follow the viewport. Use the toolbar viewports or the Breakpoint stories.',
185
+ ],
186
+ bestPractices: [
187
+ 'Write children in mobile reading order; a bare child is a half, `<FormSection.Cell span="full">` the full width.',
188
+ 'Three short related fields in a row go into `<FormSection.Trio>`; two short fields in one half into `<FormSection.Pair>`.',
189
+ 'An input stays at or under ~768 px: a per-breakpoint Cell span such as `{ md: "full", lg: 1 }` keeps it a half at LG/XL.',
190
+ '`span={1}` when the section takes one track of the block grid — its fields then run on one track at LG/XL.',
191
+ ],
192
+ knownIssues: [
193
+ 'The H4 default content uses a Text Field in place of the Subject Lookup Field.',
194
+ ],
195
+ docsLink: {
196
+ label: 'spec/05-organisms/form-section.md',
197
+ },
198
+ }),
199
+ },
200
+ },
201
+ },
202
+ argTypes: {
203
+ header: { control: 'inline-radio', options: HEADERS },
204
+ title: { control: 'text', if: { arg: 'header', neq: 'none' } },
205
+ description: { control: 'text', if: { arg: 'header', neq: 'none' } },
206
+ illustration: {
207
+ control: 'select',
208
+ options: ILLUSTRATIONS,
209
+ table: { type: { summary: 'React.ReactElement' } },
210
+ description:
211
+ 'A React element (the app passes `<img src={…} alt="" />` of its own copy). The story maps the picked name to an `<img alt="">` of that Illustration / Section picture.',
212
+ if: { arg: 'header', eq: 'h3' },
213
+ },
214
+ span: { control: 'inline-radio', options: [1, 'full'] },
215
+ headingLevel: { control: 'select', options: HEADING_LEVELS, if: { arg: 'header', neq: 'none' } },
216
+ children: { table: { disable: true } },
217
+ },
218
+ args: {
219
+ header: 'none',
220
+ title: COPY.h4.title,
221
+ description: COPY.h4.description,
222
+ illustration: 'person-arrow-out',
223
+ span: 'full',
224
+ },
225
+ render: renderSection,
226
+ };
227
+
228
+ export default meta;
229
+ type Story = StoryObj<FormSectionStoryArgs>;
230
+
231
+ /** The interactive section — switch the viewport in the toolbar to walk the Breakpoint ladder. */
232
+ export const Playground: Story = {};
233
+
234
+ function Labelled({ label, children }: { label: string; children: React.ReactNode }) {
235
+ return (
236
+ <div className="flex flex-col gap-300">
237
+ <p className="text-body-xs text-text-secondary">{label}</p>
238
+ {children}
239
+ </div>
240
+ );
241
+ }
242
+
243
+ /**
244
+ * Header (rows) at the current viewport — the component has no size axis, the Breakpoint
245
+ * axis is the viewport. The second block compares `span={1}` with `'full'`.
246
+ */
247
+ export const Matrix: Story = {
248
+ parameters: { controls: { disable: true } },
249
+ render: () => (
250
+ <div className="flex flex-col gap-1200">
251
+ {HEADERS.map(header => (
252
+ <Labelled key={header} label={`header = ${header}`}>
253
+ {renderSection({
254
+ header,
255
+ title: header === 'h3' ? COPY.h3.title : COPY.h4.title,
256
+ description: header === 'h3' ? COPY.h3.description : COPY.h4.description,
257
+ illustration: 'person-arrow-out',
258
+ span: 'full',
259
+ })}
260
+ </Labelled>
261
+ ))}
262
+ <div className="grid grid-cols-1 gap-1000 lg:grid-cols-2">
263
+ <Labelled label="span = 1 (one block-grid track — fields on 1 track at LG/XL)">
264
+ <FormSection span={1}>
265
+ <NoneFields />
266
+ </FormSection>
267
+ </Labelled>
268
+ <Labelled label="span = full">
269
+ <FormSection span="full">
270
+ <NoneFields />
271
+ </FormSection>
272
+ </Labelled>
273
+ </div>
274
+ </div>
275
+ ),
276
+ };
277
+
278
+ function TrioFields() {
279
+ return (
280
+ <FormSection.Trio>
281
+ <DemoField label="Jméno nebo název" />
282
+ <DemoField label="IČO" />
283
+ <DemoField label="DIČ" />
284
+ </FormSection.Trio>
285
+ );
286
+ }
287
+
288
+ /** A trio row: 3 tracks at LG/XL, 2 at MD (DIČ wraps under the first), 1 below. */
289
+ export const WithTrio: Story = {
290
+ args: { header: 'h4', title: 'Odběratel', description: undefined, children: <TrioFields /> },
291
+ };
292
+
293
+ /** A pair: PSČ + Město share one half; Ulice takes the other. */
294
+ export const WithPair: Story = {
295
+ args: {
296
+ header: 'h4',
297
+ title: 'Adresa',
298
+ description: undefined,
299
+ children: (
300
+ <>
301
+ <DemoField label="Ulice" />
302
+ <FormSection.Pair>
303
+ <DemoField label="PSČ" />
304
+ <DemoField label="Město" />
305
+ </FormSection.Pair>
306
+ </>
307
+ ),
308
+ },
309
+ };
310
+
311
+ /** The five `Illustration / Section` pictures at the deprecated `h3` header. */
312
+ export const Illustrations: Story = {
313
+ parameters: { controls: { disable: true } },
314
+ render: () => (
315
+ <div className="flex flex-col gap-1200">
316
+ {ILLUSTRATIONS.map(illustration => (
317
+ <Labelled key={illustration} label={`illustration = ${illustration}`}>
318
+ {renderSection({
319
+ header: 'h3',
320
+ title: COPY.h3.title,
321
+ description: COPY.h3.description,
322
+ illustration,
323
+ span: 'full',
324
+ })}
325
+ </Labelled>
326
+ ))}
327
+ </div>
328
+ ),
329
+ };
330
+
331
+ /**
332
+ * An error message under one field of a row: cells align to the top, so the neighbour stays put
333
+ * and only the rows below move down (the section owns this layout consequence).
334
+ */
335
+ export const ErrorInRow: Story = {
336
+ args: {
337
+ header: 'h4',
338
+ title: 'Odběratel',
339
+ description: undefined,
340
+ children: (
341
+ <>
342
+ <DemoField label="Číslo" value="V20260" error="Číslo dokladu musí mít 11 znaků" />
343
+ <DemoField label="Číslo dokladu" />
344
+ <DemoField label="Datum vystavení" value="02. 09. 2026" />
345
+ <DemoField label="Datum zdanitelného plnění" />
346
+ </>
347
+ ),
348
+ },
349
+ };
350
+
351
+ /** H4 section with halves, a pair and a trio — every track change of the ladder at once. */
352
+ function BreakpointContent() {
353
+ return (
354
+ <>
355
+ <DemoField label="Číslo" value="V2026090001" />
356
+ <DemoField label="Číslo dokladu" />
357
+ <DemoField label="Ulice" />
358
+ <FormSection.Pair>
359
+ <DemoField label="PSČ" />
360
+ <DemoField label="Město" />
361
+ </FormSection.Pair>
362
+ <TrioFields />
363
+ </>
364
+ );
365
+ }
366
+
367
+ const breakpointArgs: Partial<FormSectionStoryArgs> = {
368
+ header: 'h4',
369
+ title: COPY.h4.title,
370
+ description: COPY.h4.description,
371
+ children: <BreakpointContent />,
372
+ };
373
+
374
+ /** XL — 1280: 2 tracks, column gap --space-1000, trio on 3 tracks. */
375
+ export const BreakpointXL: Story = {
376
+ name: 'Breakpoint · XL',
377
+ args: breakpointArgs,
378
+ globals: { viewport: { value: 'XL' } },
379
+ };
380
+
381
+ /** LG — 1024: same tracks and gaps as XL. */
382
+ export const BreakpointLG: Story = {
383
+ name: 'Breakpoint · LG',
384
+ args: breakpointArgs,
385
+ globals: { viewport: { value: 'LG' } },
386
+ };
387
+
388
+ /** MD — 768: 2 tracks, column gap --space-900, the trio wraps 2 + 1. */
389
+ export const BreakpointMD: Story = {
390
+ name: 'Breakpoint · MD',
391
+ args: breakpointArgs,
392
+ globals: { viewport: { value: 'MD' } },
393
+ };
394
+
395
+ /** SM — 640: 1 track, row gap --space-700; the pair keeps 2 tracks at column gap --space-600. */
396
+ export const BreakpointSM: Story = {
397
+ name: 'Breakpoint · SM',
398
+ args: breakpointArgs,
399
+ globals: { viewport: { value: 'SM' } },
400
+ };
401
+
402
+ /** Mobile — 390: everything on 1 track in child order, the pair included. */
403
+ export const BreakpointMobile: Story = {
404
+ name: 'Breakpoint · Mobile',
405
+ args: breakpointArgs,
406
+ globals: { viewport: { value: 'Mobile' } },
407
+ };
@@ -0,0 +1,290 @@
1
+ "use client";
2
+
3
+ import * as React from 'react';
4
+ import { tv } from '../../internal/tailwind-variants';
5
+ import { cn } from '../../internal/utils';
6
+ import { HeadingGroup } from '../heading-group/HeadingGroup';
7
+
8
+ /**
9
+ * FormSection — one group of fields inside a Form Block (`form-section.manifest.json`,
10
+ * organism, v2.0.0, `kind: "region"`).
11
+ *
12
+ * The section paints nothing (`container.note`); it only lays out: an optional Heading
13
+ * Group, then the field grid (`chrome.field-grid`), separated by `chrome.header-gap`.
14
+ *
15
+ * ## Breakpoint is not a prop
16
+ *
17
+ * `properties[Breakpoint].maps`: the section reads the viewport media queries, exactly
18
+ * like its Form Block. Mobile = unprefixed, SM = `sm:`, MD = `md:`, LG = `lg:`, XL = `xl:`.
19
+ * Every XL value equals its LG value, so `lg:` covers both.
20
+ *
21
+ * ## The fields container IS the grid
22
+ *
23
+ * `notes[0]` / `delivery.react`: at `header="none"` the section element itself is the
24
+ * grid; at `h4` / `h3` the `role="group"` element holds the header and exactly one grid,
25
+ * with no wrapper between that grid and the fields. Tracks are Tailwind's
26
+ * `grid-cols-N` = `repeat(N, minmax(0, 1fr))`, every child gets `min-w-0`, the grid
27
+ * auto-flows by row (never dense) and cells align to the top.
28
+ *
29
+ * ## Illustration (`h3` only)
30
+ *
31
+ * The package ships no picture (`delivery.react`, 1.3.0): at `header="h3"` the app passes
32
+ * the `Illustration / Section` picture as a React element (`<img src={…} alt="" />` or an
33
+ * inline SVG). The Heading Group draws it in its 48 px picture box, which is `aria-hidden`.
34
+ *
35
+ * ## No states
36
+ *
37
+ * No `axes.state`: focus, error, disabled and read-only live on the fields. Nothing in
38
+ * the section is interactive, so there is no disabled propagation to do.
39
+ */
40
+ const formSectionVariants = tv({
41
+ slots: {
42
+ root: 'flex flex-col',
43
+ self: '',
44
+ // chrome.field-grid: 1 track below MD (row gap --space-700); 2 tracks from MD with
45
+ // column gap --space-900 (MD) / --space-1000 (LG/XL) and row gap --space-900.
46
+ fieldGrid: [
47
+ 'grid grid-flow-row grid-cols-1 items-start gap-y-700 *:min-w-0',
48
+ 'md:grid-cols-2 md:gap-x-900 md:gap-y-900',
49
+ 'lg:gap-x-1000',
50
+ ],
51
+ cell: 'min-w-0',
52
+ // chrome.trio: one full-width child of the field grid; 1 track below MD (row gap
53
+ // --space-700), 2 at MD (column --space-800, row --space-900), 3 at LG/XL.
54
+ trio: [
55
+ 'col-span-full grid min-w-0 grid-flow-row grid-cols-1 items-start gap-y-700 *:min-w-0',
56
+ 'md:grid-cols-2 md:gap-x-800 md:gap-y-900',
57
+ 'lg:grid-cols-3',
58
+ ],
59
+ // chrome.nested-pair: one half; 1 track at Mobile (row gap --space-700), 2 tracks
60
+ // from SM with column gap --space-600 (SM) / --space-800 (MD and up).
61
+ pair: [
62
+ 'grid min-w-0 grid-flow-row grid-cols-1 items-start gap-y-700 *:min-w-0',
63
+ 'sm:grid-cols-2 sm:gap-x-600',
64
+ 'md:gap-x-800',
65
+ ],
66
+ },
67
+ variants: {
68
+ // chrome.header-gap — no gap at none (the root is the grid itself).
69
+ header: {
70
+ none: {},
71
+ h4: { root: 'gap-600 md:gap-800' },
72
+ h3: { root: 'gap-800 md:gap-900' },
73
+ },
74
+ // delivery.react: span is the section's own width in the Form Block content grid
75
+ // (`self`, on whichever element is the root). A section on one track of the 2-track
76
+ // LG/XL block grid also runs its fields on 1 track. Below LG every section is full width.
77
+ span: {
78
+ 1: { self: 'col-span-full lg:col-span-1', fieldGrid: 'lg:grid-cols-1' },
79
+ full: { self: 'col-span-full' },
80
+ },
81
+ },
82
+ defaultVariants: {
83
+ header: 'none',
84
+ span: 'full',
85
+ },
86
+ });
87
+
88
+ export type FormSectionHeader = 'none' | 'h4' | 'h3';
89
+ export type FormSectionHeadingLevel = 2 | 3 | 4 | 5 | 6;
90
+
91
+ interface FormSectionBaseProps extends Omit<React.HTMLAttributes<HTMLDivElement>, 'title' | 'children'> {
92
+ /**
93
+ * The section's own width in the Form Block grid: one block-grid track or the full
94
+ * width. `1` runs the fields on a single track at LG/XL. Default `'full'`.
95
+ */
96
+ span?: 1 | 'full';
97
+ /** Heading element level (2–6). Defaults to 3 at `h4`, 2 at `h3`. */
98
+ headingLevel?: FormSectionHeadingLevel;
99
+ /** The fields, in mobile reading order. */
100
+ children?: React.ReactNode;
101
+ }
102
+
103
+ export type FormSectionProps = FormSectionBaseProps &
104
+ (
105
+ | { header?: 'none'; title?: never; description?: never; illustration?: never }
106
+ | { header: 'h4'; title: string; description?: string; illustration?: never }
107
+ | {
108
+ /** @deprecated `h3` exists only for the legacy parties tile — new screens use one Form Block per party. */
109
+ header: 'h3';
110
+ title: string;
111
+ description?: string;
112
+ /**
113
+ * The `Illustration / Section` picture, supplied by the app (e.g.
114
+ * `<img src={personArrowOut} alt="" />` or an inline SVG): the package ships no
115
+ * picture. Drawn in the Heading Group's 48 px picture box, which is `aria-hidden`.
116
+ */
117
+ illustration: React.ReactElement;
118
+ }
119
+ );
120
+
121
+ const FormSectionRoot = React.forwardRef<HTMLDivElement, FormSectionProps>(
122
+ (
123
+ { header = 'none', title, description, illustration, span = 'full', headingLevel, className, children, ...props },
124
+ ref,
125
+ ) => {
126
+ const headingId = React.useId();
127
+ const descriptionId = React.useId();
128
+ const slots = formSectionVariants({ header, span });
129
+
130
+ if (header === 'none') {
131
+ return (
132
+ <div
133
+ ref={ref}
134
+ className={cn(slots.fieldGrid(), slots.self(), className)}
135
+ data-fods-component="form-section"
136
+ data-fods-part="field-grid"
137
+ {...props}
138
+ >
139
+ {children}
140
+ </div>
141
+ );
142
+ }
143
+
144
+ const hasDescription = description != null && description !== '';
145
+
146
+ return (
147
+ <div
148
+ ref={ref}
149
+ role="group"
150
+ aria-labelledby={headingId}
151
+ aria-describedby={hasDescription ? descriptionId : undefined}
152
+ className={cn(slots.root(), slots.self(), className)}
153
+ data-fods-component="form-section"
154
+ data-fods-part="root"
155
+ {...props}
156
+ >
157
+ <HeadingGroup
158
+ data-fods-part="header"
159
+ size={header}
160
+ level={headingLevel ?? (header === 'h3' ? 2 : 3)}
161
+ heading={title}
162
+ description={description}
163
+ headingId={headingId}
164
+ descriptionId={descriptionId}
165
+ illustration={header === 'h3' ? illustration : undefined}
166
+ />
167
+ <div data-fods-part="field-grid" className={slots.fieldGrid()}>
168
+ {children}
169
+ </div>
170
+ </div>
171
+ );
172
+ },
173
+ );
174
+ FormSectionRoot.displayName = 'FormSection';
175
+
176
+ export type FormSectionBreakpoint = 'mobile' | 'sm' | 'md' | 'lg' | 'xl';
177
+ export type FormSectionCellSpanValue = 1 | 'full';
178
+ export type FormSectionCellSpan =
179
+ | FormSectionCellSpanValue
180
+ | Partial<Record<FormSectionBreakpoint, FormSectionCellSpanValue>>;
181
+
182
+ // Literal class strings so Tailwind's source scan generates every one of them.
183
+ const CELL_SPAN_CLASS: Record<FormSectionBreakpoint, Record<'1' | 'full', string>> = {
184
+ mobile: { 1: 'col-span-1', full: 'col-span-full' },
185
+ sm: { 1: 'sm:col-span-1', full: 'sm:col-span-full' },
186
+ md: { 1: 'md:col-span-1', full: 'md:col-span-full' },
187
+ lg: { 1: 'lg:col-span-1', full: 'lg:col-span-full' },
188
+ xl: { 1: 'xl:col-span-1', full: 'xl:col-span-full' },
189
+ };
190
+
191
+ const BREAKPOINTS_DESC: readonly FormSectionBreakpoint[] = ['xl', 'lg', 'md', 'sm', 'mobile'];
192
+
193
+ /**
194
+ * Resolves a Cell span to classes. An unlisted breakpoint inherits the next larger one
195
+ * (`delivery.react`), XL falls back to a half; a class is emitted only where the
196
+ * resolved value changes going up from Mobile.
197
+ */
198
+ export function resolveCellSpanClasses(span: FormSectionCellSpan): string {
199
+ if (typeof span !== 'object') return span === 'full' ? CELL_SPAN_CLASS.mobile.full : '';
200
+
201
+ const resolved = {} as Record<FormSectionBreakpoint, FormSectionCellSpanValue>;
202
+ let inherited: FormSectionCellSpanValue = 1;
203
+ BREAKPOINTS_DESC.forEach((bp) => {
204
+ inherited = span[bp] ?? inherited;
205
+ resolved[bp] = inherited;
206
+ });
207
+
208
+ const classes: string[] = [];
209
+ let previous: FormSectionCellSpanValue = 1;
210
+ [...BREAKPOINTS_DESC].reverse().forEach((bp) => {
211
+ const value = resolved[bp];
212
+ if (bp === 'mobile' ? value === 'full' : value !== previous) {
213
+ classes.push(CELL_SPAN_CLASS[bp][value === 'full' ? 'full' : '1']);
214
+ }
215
+ previous = value;
216
+ });
217
+ return classes.join(' ');
218
+ }
219
+
220
+ export interface FormSectionCellProps extends React.HTMLAttributes<HTMLDivElement> {
221
+ /**
222
+ * Field-grid tracks the child takes: `1` (a half, default), `'full'`, or a
223
+ * per-breakpoint object such as `{ xl: 1, lg: 1, md: 'full' }`.
224
+ */
225
+ span?: FormSectionCellSpan;
226
+ }
227
+
228
+ const FormSectionCell = React.forwardRef<HTMLDivElement, FormSectionCellProps>(
229
+ ({ span = 1, className, ...props }, ref) => (
230
+ <div
231
+ ref={ref}
232
+ data-fods-part="cell"
233
+ className={cn(formSectionVariants().cell(), resolveCellSpanClasses(span), className)}
234
+ {...props}
235
+ />
236
+ ),
237
+ );
238
+ FormSectionCell.displayName = 'FormSection.Cell';
239
+
240
+ export interface FormSectionTrioProps extends Omit<React.HTMLAttributes<HTMLDivElement>, 'children'> {
241
+ /** Exactly three short related fields, in reading order. */
242
+ children: [React.ReactNode, React.ReactNode, React.ReactNode];
243
+ }
244
+
245
+ const FormSectionTrio = React.forwardRef<HTMLDivElement, FormSectionTrioProps>(
246
+ ({ className, children, ...props }, ref) => {
247
+ if (process.env.NODE_ENV !== 'production' && React.Children.count(children) !== 3) {
248
+ console.error('FormSection.Trio takes exactly three fields; four or more are halves (chrome.trio).');
249
+ }
250
+ return (
251
+ <div ref={ref} data-fods-part="trio" className={cn(formSectionVariants().trio(), className)} {...props}>
252
+ {children}
253
+ </div>
254
+ );
255
+ },
256
+ );
257
+ FormSectionTrio.displayName = 'FormSection.Trio';
258
+
259
+ export interface FormSectionPairProps extends Omit<React.HTMLAttributes<HTMLDivElement>, 'children'> {
260
+ /** Exactly two short related fields whose labels fit one line. */
261
+ children: [React.ReactNode, React.ReactNode];
262
+ }
263
+
264
+ const FormSectionPair = React.forwardRef<HTMLDivElement, FormSectionPairProps>(
265
+ ({ className, children, ...props }, ref) => {
266
+ if (process.env.NODE_ENV !== 'production' && React.Children.count(children) !== 2) {
267
+ console.error('FormSection.Pair takes exactly two fields; three in a row are a Trio (chrome.nested-pair).');
268
+ }
269
+ return (
270
+ <div ref={ref} data-fods-part="pair" className={cn(formSectionVariants().pair(), className)} {...props}>
271
+ {children}
272
+ </div>
273
+ );
274
+ },
275
+ );
276
+ FormSectionPair.displayName = 'FormSection.Pair';
277
+
278
+ type FormSectionComponent = typeof FormSectionRoot & {
279
+ Cell: typeof FormSectionCell;
280
+ Trio: typeof FormSectionTrio;
281
+ Pair: typeof FormSectionPair;
282
+ };
283
+
284
+ const FormSection = Object.assign(FormSectionRoot, {
285
+ Cell: FormSectionCell,
286
+ Trio: FormSectionTrio,
287
+ Pair: FormSectionPair,
288
+ }) as FormSectionComponent;
289
+
290
+ export { FormSection, FormSectionCell, FormSectionTrio, FormSectionPair, formSectionVariants };