@invoiceonline/ui-react 0.0.0 → 0.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (731) hide show
  1. package/AGENTS.md +100 -0
  2. package/CHANGELOG.md +149 -0
  3. package/LICENSE +9 -0
  4. package/README.md +77 -1
  5. package/dist/assets/label-brush-1.svg +6 -0
  6. package/dist/assets/pattern-dark.svg +113 -0
  7. package/dist/components/action-row/ActionRow.d.ts +178 -0
  8. package/dist/components/action-row/ActionRow.js +340 -0
  9. package/dist/components/action-row/index.d.ts +2 -0
  10. package/dist/components/action-row/index.js +1 -0
  11. package/dist/components/alert/Alert.d.ts +314 -0
  12. package/dist/components/alert/Alert.js +446 -0
  13. package/dist/components/alert/index.d.ts +2 -0
  14. package/dist/components/alert/index.js +1 -0
  15. package/dist/components/anchored-panel/AnchoredPanel.d.ts +41 -0
  16. package/dist/components/anchored-panel/AnchoredPanel.js +72 -0
  17. package/dist/components/anchored-panel/index.d.ts +3 -0
  18. package/dist/components/anchored-panel/index.js +3 -0
  19. package/dist/components/badge/Badge.d.ts +146 -0
  20. package/dist/components/badge/Badge.js +258 -0
  21. package/dist/components/badge/index.d.ts +2 -0
  22. package/dist/components/badge/index.js +1 -0
  23. package/dist/components/banner/Banner.d.ts +209 -0
  24. package/dist/components/banner/Banner.js +339 -0
  25. package/dist/components/banner/index.d.ts +2 -0
  26. package/dist/components/banner/index.js +1 -0
  27. package/dist/components/button/Button.d.ts +54 -0
  28. package/dist/components/button/Button.js +312 -0
  29. package/dist/components/button/index.d.ts +2 -0
  30. package/dist/components/button/index.js +1 -0
  31. package/dist/components/button-group/ButtonGroup.d.ts +187 -0
  32. package/dist/components/button-group/ButtonGroup.js +217 -0
  33. package/dist/components/button-group/index.d.ts +2 -0
  34. package/dist/components/button-group/index.js +1 -0
  35. package/dist/components/card-select/CardSelect.d.ts +274 -0
  36. package/dist/components/card-select/CardSelect.js +561 -0
  37. package/dist/components/card-select/CardSelectGroup.d.ts +92 -0
  38. package/dist/components/card-select/CardSelectGroup.js +72 -0
  39. package/dist/components/card-select/index.d.ts +3 -0
  40. package/dist/components/card-select/index.js +3 -0
  41. package/dist/components/checkbox/Checkbox.d.ts +104 -0
  42. package/dist/components/checkbox/Checkbox.js +194 -0
  43. package/dist/components/checkbox/index.d.ts +2 -0
  44. package/dist/components/checkbox/index.js +1 -0
  45. package/dist/components/chip/Chip.d.ts +250 -0
  46. package/dist/components/chip/Chip.js +441 -0
  47. package/dist/components/chip/index.d.ts +2 -0
  48. package/dist/components/chip/index.js +1 -0
  49. package/dist/components/column-header/ColumnHeader.d.ts +144 -0
  50. package/dist/components/column-header/ColumnHeader.js +209 -0
  51. package/dist/components/column-header/index.d.ts +2 -0
  52. package/dist/components/column-header/index.js +1 -0
  53. package/dist/components/combobox-field/Combobox.d.ts +104 -0
  54. package/dist/components/combobox-field/Combobox.js +355 -0
  55. package/dist/components/combobox-field/ComboboxField.d.ts +76 -0
  56. package/dist/components/combobox-field/ComboboxField.js +98 -0
  57. package/dist/components/combobox-field/index.d.ts +3 -0
  58. package/dist/components/combobox-field/index.js +3 -0
  59. package/dist/components/date-picker/DatePicker.d.ts +53 -0
  60. package/dist/components/date-picker/DatePicker.js +329 -0
  61. package/dist/components/date-picker/index.d.ts +2 -0
  62. package/dist/components/date-picker/index.js +1 -0
  63. package/dist/components/divider/Divider.d.ts +81 -0
  64. package/dist/components/divider/Divider.js +93 -0
  65. package/dist/components/divider/index.d.ts +2 -0
  66. package/dist/components/divider/index.js +1 -0
  67. package/dist/components/drawer/Drawer.d.ts +128 -0
  68. package/dist/components/drawer/Drawer.js +367 -0
  69. package/dist/components/drawer/index.d.ts +2 -0
  70. package/dist/components/drawer/index.js +1 -0
  71. package/dist/components/dropdown-button/DropdownButton.d.ts +72 -0
  72. package/dist/components/dropdown-button/DropdownButton.js +122 -0
  73. package/dist/components/dropdown-button/index.d.ts +2 -0
  74. package/dist/components/dropdown-button/index.js +1 -0
  75. package/dist/components/faq/FAQ.d.ts +135 -0
  76. package/dist/components/faq/FAQ.js +258 -0
  77. package/dist/components/faq/index.d.ts +2 -0
  78. package/dist/components/faq/index.js +1 -0
  79. package/dist/components/field/Field.d.ts +119 -0
  80. package/dist/components/field/Field.js +332 -0
  81. package/dist/components/field/index.d.ts +2 -0
  82. package/dist/components/field/index.js +1 -0
  83. package/dist/components/field-pair/FieldPair.d.ts +210 -0
  84. package/dist/components/field-pair/FieldPair.js +335 -0
  85. package/dist/components/field-pair/index.d.ts +2 -0
  86. package/dist/components/field-pair/index.js +1 -0
  87. package/dist/components/file-upload/FileUpload.d.ts +137 -0
  88. package/dist/components/file-upload/FileUpload.js +434 -0
  89. package/dist/components/file-upload/index.d.ts +2 -0
  90. package/dist/components/file-upload/index.js +1 -0
  91. package/dist/components/filter-chip/FilterChip.d.ts +373 -0
  92. package/dist/components/filter-chip/FilterChip.js +517 -0
  93. package/dist/components/filter-chip/index.d.ts +2 -0
  94. package/dist/components/filter-chip/index.js +1 -0
  95. package/dist/components/filter-facet/FilterFacet.d.ts +116 -0
  96. package/dist/components/filter-facet/FilterFacet.js +632 -0
  97. package/dist/components/filter-facet/index.d.ts +2 -0
  98. package/dist/components/filter-facet/index.js +1 -0
  99. package/dist/components/firm-avatar/FirmAvatar.d.ts +75 -0
  100. package/dist/components/firm-avatar/FirmAvatar.js +119 -0
  101. package/dist/components/firm-avatar/index.d.ts +2 -0
  102. package/dist/components/firm-avatar/index.js +1 -0
  103. package/dist/components/form-actions/FormActions.d.ts +123 -0
  104. package/dist/components/form-actions/FormActions.js +195 -0
  105. package/dist/components/form-actions/index.d.ts +2 -0
  106. package/dist/components/form-actions/index.js +1 -0
  107. package/dist/components/form-block/FormBlock.d.ts +252 -0
  108. package/dist/components/form-block/FormBlock.js +420 -0
  109. package/dist/components/form-block/index.d.ts +3 -0
  110. package/dist/components/form-block/index.js +3 -0
  111. package/dist/components/form-section/FormSection.d.ts +130 -0
  112. package/dist/components/form-section/FormSection.js +206 -0
  113. package/dist/components/form-section/index.d.ts +2 -0
  114. package/dist/components/form-section/index.js +1 -0
  115. package/dist/components/heading/Heading.d.ts +69 -0
  116. package/dist/components/heading/Heading.js +79 -0
  117. package/dist/components/heading/index.d.ts +2 -0
  118. package/dist/components/heading/index.js +1 -0
  119. package/dist/components/heading-group/HeadingGroup.d.ts +258 -0
  120. package/dist/components/heading-group/HeadingGroup.js +255 -0
  121. package/dist/components/heading-group/index.d.ts +2 -0
  122. package/dist/components/heading-group/index.js +1 -0
  123. package/dist/components/hero/Hero.d.ts +268 -0
  124. package/dist/components/hero/Hero.js +316 -0
  125. package/dist/components/hero/index.d.ts +2 -0
  126. package/dist/components/hero/index.js +1 -0
  127. package/dist/components/icon/Icon.d.ts +27 -0
  128. package/dist/components/icon/Icon.js +30 -0
  129. package/dist/components/icon/index.d.ts +3 -0
  130. package/dist/components/icon/index.js +3 -0
  131. package/dist/components/icon-button/IconButton.d.ts +75 -0
  132. package/dist/components/icon-button/IconButton.js +151 -0
  133. package/dist/components/icon-button/index.d.ts +2 -0
  134. package/dist/components/icon-button/index.js +1 -0
  135. package/dist/components/item-row/ItemRow.d.ts +253 -0
  136. package/dist/components/item-row/ItemRow.js +496 -0
  137. package/dist/components/item-row/index.d.ts +2 -0
  138. package/dist/components/item-row/index.js +1 -0
  139. package/dist/components/list-row/ListRow.d.ts +165 -0
  140. package/dist/components/list-row/ListRow.js +233 -0
  141. package/dist/components/list-row/index.d.ts +2 -0
  142. package/dist/components/list-row/index.js +1 -0
  143. package/dist/components/menu/Menu.d.ts +64 -0
  144. package/dist/components/menu/Menu.js +186 -0
  145. package/dist/components/menu/index.d.ts +2 -0
  146. package/dist/components/menu/index.js +1 -0
  147. package/dist/components/modal/Modal.d.ts +272 -0
  148. package/dist/components/modal/Modal.js +788 -0
  149. package/dist/components/modal/index.d.ts +2 -0
  150. package/dist/components/modal/index.js +1 -0
  151. package/dist/components/nav-link/NavLink.d.ts +123 -0
  152. package/dist/components/nav-link/NavLink.js +157 -0
  153. package/dist/components/nav-link/index.d.ts +2 -0
  154. package/dist/components/nav-link/index.js +1 -0
  155. package/dist/components/number-field/NumberField.d.ts +62 -0
  156. package/dist/components/number-field/NumberField.js +210 -0
  157. package/dist/components/number-field/index.d.ts +2 -0
  158. package/dist/components/number-field/index.js +1 -0
  159. package/dist/components/pagination/Pagination.d.ts +133 -0
  160. package/dist/components/pagination/Pagination.js +217 -0
  161. package/dist/components/pagination/index.d.ts +3 -0
  162. package/dist/components/pagination/index.js +3 -0
  163. package/dist/components/popover-surface/index.d.ts +2 -0
  164. package/dist/components/popover-surface/index.js +1 -0
  165. package/dist/components/progress-bar/ProgressBar.d.ts +260 -0
  166. package/dist/components/progress-bar/ProgressBar.js +470 -0
  167. package/dist/components/progress-bar/index.d.ts +2 -0
  168. package/dist/components/progress-bar/index.js +1 -0
  169. package/dist/components/promo-sticker/PromoSticker.d.ts +204 -0
  170. package/dist/components/promo-sticker/PromoSticker.js +177 -0
  171. package/dist/components/promo-sticker/index.d.ts +2 -0
  172. package/dist/components/promo-sticker/index.js +1 -0
  173. package/dist/components/promo-surface/PromoSurface.d.ts +94 -0
  174. package/dist/components/promo-surface/PromoSurface.js +119 -0
  175. package/dist/components/promo-surface/index.d.ts +2 -0
  176. package/dist/components/promo-surface/index.js +1 -0
  177. package/dist/components/radio/Radio.d.ts +92 -0
  178. package/dist/components/radio/Radio.js +171 -0
  179. package/dist/components/radio/index.d.ts +2 -0
  180. package/dist/components/radio/index.js +1 -0
  181. package/dist/components/radio-group/RadioGroup.d.ts +61 -0
  182. package/dist/components/radio-group/RadioGroup.js +51 -0
  183. package/dist/components/radio-group/index.d.ts +2 -0
  184. package/dist/components/radio-group/index.js +1 -0
  185. package/dist/components/select/Select.d.ts +65 -0
  186. package/dist/components/select/Select.js +176 -0
  187. package/dist/components/select/index.d.ts +2 -0
  188. package/dist/components/select/index.js +1 -0
  189. package/dist/components/select-field/SelectField.d.ts +16 -0
  190. package/dist/components/select-field/SelectField.js +55 -0
  191. package/dist/components/select-field/index.d.ts +2 -0
  192. package/dist/components/select-field/index.js +1 -0
  193. package/dist/components/skeleton/Skeleton.d.ts +64 -0
  194. package/dist/components/skeleton/Skeleton.js +65 -0
  195. package/dist/components/skeleton/index.d.ts +2 -0
  196. package/dist/components/skeleton/index.js +1 -0
  197. package/dist/components/split-button/SplitButton.d.ts +80 -0
  198. package/dist/components/split-button/SplitButton.js +182 -0
  199. package/dist/components/split-button/index.d.ts +2 -0
  200. package/dist/components/split-button/index.js +1 -0
  201. package/dist/components/status-summary-bar/StatusSummaryBar.d.ts +118 -0
  202. package/dist/components/status-summary-bar/StatusSummaryBar.js +278 -0
  203. package/dist/components/status-summary-bar/index.d.ts +2 -0
  204. package/dist/components/status-summary-bar/index.js +1 -0
  205. package/dist/components/subject-lookup-field/SubjectLookupField.d.ts +157 -0
  206. package/dist/components/subject-lookup-field/SubjectLookupField.js +663 -0
  207. package/dist/components/subject-lookup-field/index.d.ts +2 -0
  208. package/dist/components/subject-lookup-field/index.js +1 -0
  209. package/dist/components/switch/Switch.d.ts +152 -0
  210. package/dist/components/switch/Switch.js +307 -0
  211. package/dist/components/switch/index.d.ts +2 -0
  212. package/dist/components/switch/index.js +1 -0
  213. package/dist/components/table/Table.d.ts +5 -0
  214. package/dist/components/table/Table.js +601 -0
  215. package/dist/components/table/index.d.ts +6 -0
  216. package/dist/components/table/index.js +6 -0
  217. package/dist/components/text-field/TextField.d.ts +160 -0
  218. package/dist/components/text-field/TextField.js +244 -0
  219. package/dist/components/text-field/index.d.ts +2 -0
  220. package/dist/components/text-field/index.js +1 -0
  221. package/dist/components/text-link/TextLink.d.ts +260 -0
  222. package/dist/components/text-link/TextLink.js +303 -0
  223. package/dist/components/text-link/index.d.ts +2 -0
  224. package/dist/components/text-link/index.js +1 -0
  225. package/dist/components/textarea/Textarea.d.ts +93 -0
  226. package/dist/components/textarea/Textarea.js +256 -0
  227. package/dist/components/textarea/index.d.ts +2 -0
  228. package/dist/components/textarea/index.js +1 -0
  229. package/dist/components/tooltip/Tooltip.d.ts +129 -0
  230. package/dist/components/tooltip/Tooltip.js +457 -0
  231. package/dist/components/tooltip/index.d.ts +2 -0
  232. package/dist/components/tooltip/index.js +1 -0
  233. package/dist/components/unit-field/UnitField.d.ts +46 -0
  234. package/dist/components/unit-field/UnitField.js +133 -0
  235. package/dist/components/unit-field/index.d.ts +2 -0
  236. package/dist/components/unit-field/index.js +1 -0
  237. package/dist/icons/icon-registry.generated.js +500 -0
  238. package/dist/icons/icon-types.generated.d.ts +2 -0
  239. package/dist/icons/icon-types.generated.js +126 -0
  240. package/dist/index.d.ts +130 -0
  241. package/dist/index.js +74 -0
  242. package/dist/internal/BottomSheet.js +496 -0
  243. package/dist/internal/FodsProvider.d.ts +25 -0
  244. package/dist/internal/FodsProvider.js +32 -0
  245. package/dist/internal/MotionCaret.js +35 -0
  246. package/dist/internal/NumberFormatInput.d.ts +21 -0
  247. package/dist/internal/NumberFormatInput.js +126 -0
  248. package/dist/internal/SummaryDonut.d.ts +3 -0
  249. package/dist/internal/SummaryDonut.js +300 -0
  250. package/dist/internal/buttonSegment.d.ts +44 -0
  251. package/dist/internal/buttonSegment.js +126 -0
  252. package/dist/internal/collapseRoom.js +128 -0
  253. package/dist/internal/comboboxKeys.js +44 -0
  254. package/dist/internal/contentPresence.js +46 -0
  255. package/dist/internal/dayCell.js +95 -0
  256. package/dist/internal/dialogPortal.d.ts +2 -0
  257. package/dist/internal/dialogPortal.js +21 -0
  258. package/dist/internal/donutSweeps.js +65 -0
  259. package/dist/internal/enterOnViewGeometry.js +46 -0
  260. package/dist/internal/faqItem.js +80 -0
  261. package/dist/internal/floatingLabelMotion.js +68 -0
  262. package/dist/internal/formBlockContext.d.ts +22 -0
  263. package/dist/internal/formBlockContext.js +20 -0
  264. package/dist/internal/heightRoom.js +87 -0
  265. package/dist/internal/numberSeparators.js +62 -0
  266. package/dist/internal/overlayMotion.js +48 -0
  267. package/dist/internal/paginationItem.d.ts +8 -0
  268. package/dist/internal/paginationItem.js +22 -0
  269. package/dist/internal/popoverSurface.d.ts +8 -0
  270. package/dist/internal/popoverSurface.js +23 -0
  271. package/dist/internal/portalContainer.d.ts +1 -0
  272. package/dist/internal/portalContainer.js +6 -0
  273. package/dist/internal/progressBarItem.d.ts +207 -0
  274. package/dist/internal/progressBarItem.js +264 -0
  275. package/dist/internal/selectionControlText.js +12 -0
  276. package/dist/internal/statusSummaryParts.js +371 -0
  277. package/dist/internal/summaryMotion.js +75 -0
  278. package/dist/internal/table/ChildConnector.js +62 -0
  279. package/dist/internal/table/ChildRowPrefix.d.ts +9 -0
  280. package/dist/internal/table/ChildRowPrefix.js +27 -0
  281. package/dist/internal/table/ColumnSettings.js +135 -0
  282. package/dist/internal/table/ScrollRegion.js +114 -0
  283. package/dist/internal/table/TableEmpty.js +93 -0
  284. package/dist/internal/table/TableLayout.d.ts +17 -0
  285. package/dist/internal/table/TableLayout.js +29 -0
  286. package/dist/internal/table/TableLoadStatus.js +56 -0
  287. package/dist/internal/table/TableMobile.js +488 -0
  288. package/dist/internal/table/TruncatedCell.js +33 -0
  289. package/dist/internal/table/emptyValue.js +10 -0
  290. package/dist/internal/table/features.d.ts +41 -0
  291. package/dist/internal/table/features.js +31 -0
  292. package/dist/internal/table/recipes.js +227 -0
  293. package/dist/internal/table/rowClick.js +9 -0
  294. package/dist/internal/table/types.d.ts +325 -0
  295. package/dist/internal/table/types.js +13 -0
  296. package/dist/internal/tailwind-variants.d.ts +3 -0
  297. package/dist/internal/tailwind-variants.js +37 -0
  298. package/dist/internal/tooltipContext.js +5 -0
  299. package/dist/internal/tw-merge-config.generated.js +314 -0
  300. package/dist/internal/useAnchoredPanel.d.ts +87 -0
  301. package/dist/internal/useAnchoredPanel.js +108 -0
  302. package/dist/internal/useCountUp.js +53 -0
  303. package/dist/internal/useDateFieldTrigger.d.ts +60 -0
  304. package/dist/internal/useDateFieldTrigger.js +235 -0
  305. package/dist/internal/useEChart.js +59 -0
  306. package/dist/internal/useEnterOnView.js +42 -0
  307. package/dist/internal/useFloatingBar.js +100 -0
  308. package/dist/internal/useFormReset.js +44 -0
  309. package/dist/internal/useIsMobile.js +44 -0
  310. package/dist/internal/useOneRowOverflow.js +88 -0
  311. package/dist/internal/usePrefersReducedMotion.js +25 -0
  312. package/dist/internal/useReturnFocus.js +26 -0
  313. package/dist/internal/utils.d.ts +7 -0
  314. package/dist/internal/utils.js +58 -0
  315. package/dist/node_modules/@tanstack/store/dist/store.d.ts +29 -0
  316. package/dist/node_modules/@tanstack/store/dist/types.d.ts +38 -0
  317. package/dist/node_modules/@tanstack/table-core/dist/core/cells/coreCellsFeature.d.ts +6 -0
  318. package/dist/node_modules/@tanstack/table-core/dist/core/cells/coreCellsFeature.types.d.ts +53 -0
  319. package/dist/node_modules/@tanstack/table-core/dist/core/columns/coreColumnsFeature.d.ts +6 -0
  320. package/dist/node_modules/@tanstack/table-core/dist/core/columns/coreColumnsFeature.types.d.ts +90 -0
  321. package/dist/node_modules/@tanstack/table-core/dist/core/coreFeatures.d.ts +17 -0
  322. package/dist/node_modules/@tanstack/table-core/dist/core/headers/coreHeadersFeature.d.ts +6 -0
  323. package/dist/node_modules/@tanstack/table-core/dist/core/headers/coreHeadersFeature.types.d.ts +114 -0
  324. package/dist/node_modules/@tanstack/table-core/dist/core/reactivity/coreReactivityFeature.types.d.ts +51 -0
  325. package/dist/node_modules/@tanstack/table-core/dist/core/row-models/coreRowModelsFeature.d.ts +6 -0
  326. package/dist/node_modules/@tanstack/table-core/dist/core/row-models/coreRowModelsFeature.types.d.ts +29 -0
  327. package/dist/node_modules/@tanstack/table-core/dist/core/rows/coreRowsFeature.d.ts +6 -0
  328. package/dist/node_modules/@tanstack/table-core/dist/core/rows/coreRowsFeature.types.d.ts +129 -0
  329. package/dist/node_modules/@tanstack/table-core/dist/core/table/coreTablesFeature.d.ts +6 -0
  330. package/dist/node_modules/@tanstack/table-core/dist/core/table/coreTablesFeature.types.d.ts +203 -0
  331. package/dist/node_modules/@tanstack/table-core/dist/features/cell-selection/cellSelectionFeature.d.ts +6 -0
  332. package/dist/node_modules/@tanstack/table-core/dist/features/cell-selection/cellSelectionFeature.types.d.ts +294 -0
  333. package/dist/node_modules/@tanstack/table-core/dist/features/cell-spanning/cellSpanningFeature.d.ts +11 -0
  334. package/dist/node_modules/@tanstack/table-core/dist/features/cell-spanning/cellSpanningFeature.types.d.ts +148 -0
  335. package/dist/node_modules/@tanstack/table-core/dist/features/column-faceting/columnFacetingFeature.d.ts +12 -0
  336. package/dist/node_modules/@tanstack/table-core/dist/features/column-faceting/columnFacetingFeature.types.d.ts +63 -0
  337. package/dist/node_modules/@tanstack/table-core/dist/features/column-filtering/columnFilteringFeature.d.ts +6 -0
  338. package/dist/node_modules/@tanstack/table-core/dist/features/column-filtering/columnFilteringFeature.types.d.ts +209 -0
  339. package/dist/node_modules/@tanstack/table-core/dist/features/column-filtering/filterFns.d.ts +35 -0
  340. package/dist/node_modules/@tanstack/table-core/dist/features/column-grouping/columnGroupingFeature.d.ts +6 -0
  341. package/dist/node_modules/@tanstack/table-core/dist/features/column-grouping/columnGroupingFeature.types.d.ts +128 -0
  342. package/dist/node_modules/@tanstack/table-core/dist/features/column-ordering/columnOrderingFeature.d.ts +6 -0
  343. package/dist/node_modules/@tanstack/table-core/dist/features/column-ordering/columnOrderingFeature.types.d.ts +82 -0
  344. package/dist/node_modules/@tanstack/table-core/dist/features/column-pinning/columnPinningFeature.d.ts +11 -0
  345. package/dist/node_modules/@tanstack/table-core/dist/features/column-pinning/columnPinningFeature.types.d.ts +195 -0
  346. package/dist/node_modules/@tanstack/table-core/dist/features/column-resizing/columnResizingFeature.d.ts +6 -0
  347. package/dist/node_modules/@tanstack/table-core/dist/features/column-resizing/columnResizingFeature.types.d.ts +73 -0
  348. package/dist/node_modules/@tanstack/table-core/dist/features/column-sizing/columnSizingFeature.d.ts +6 -0
  349. package/dist/node_modules/@tanstack/table-core/dist/features/column-sizing/columnSizingFeature.types.d.ts +134 -0
  350. package/dist/node_modules/@tanstack/table-core/dist/features/column-visibility/columnVisibilityFeature.d.ts +6 -0
  351. package/dist/node_modules/@tanstack/table-core/dist/features/column-visibility/columnVisibilityFeature.types.d.ts +92 -0
  352. package/dist/node_modules/@tanstack/table-core/dist/features/global-filtering/globalFilteringFeature.d.ts +6 -0
  353. package/dist/node_modules/@tanstack/table-core/dist/features/global-filtering/globalFilteringFeature.types.d.ts +67 -0
  354. package/dist/node_modules/@tanstack/table-core/dist/features/row-aggregation/aggregationFns.d.ts +23 -0
  355. package/dist/node_modules/@tanstack/table-core/dist/features/row-aggregation/rowAggregationFeature.d.ts +6 -0
  356. package/dist/node_modules/@tanstack/table-core/dist/features/row-aggregation/rowAggregationFeature.types.d.ts +183 -0
  357. package/dist/node_modules/@tanstack/table-core/dist/features/row-aggregation/rowAggregationFeature.utils.d.ts +18 -0
  358. package/dist/node_modules/@tanstack/table-core/dist/features/row-expanding/rowExpandingFeature.d.ts +6 -0
  359. package/dist/node_modules/@tanstack/table-core/dist/features/row-expanding/rowExpandingFeature.types.d.ts +125 -0
  360. package/dist/node_modules/@tanstack/table-core/dist/features/row-pagination/rowPaginationFeature.d.ts +6 -0
  361. package/dist/node_modules/@tanstack/table-core/dist/features/row-pagination/rowPaginationFeature.types.d.ts +135 -0
  362. package/dist/node_modules/@tanstack/table-core/dist/features/row-pinning/rowPinningFeature.d.ts +6 -0
  363. package/dist/node_modules/@tanstack/table-core/dist/features/row-pinning/rowPinningFeature.types.d.ts +76 -0
  364. package/dist/node_modules/@tanstack/table-core/dist/features/row-selection/rowSelectionFeature.d.ts +6 -0
  365. package/dist/node_modules/@tanstack/table-core/dist/features/row-selection/rowSelectionFeature.types.d.ts +187 -0
  366. package/dist/node_modules/@tanstack/table-core/dist/features/row-sorting/rowSortingFeature.d.ts +6 -0
  367. package/dist/node_modules/@tanstack/table-core/dist/features/row-sorting/rowSortingFeature.types.d.ts +236 -0
  368. package/dist/node_modules/@tanstack/table-core/dist/features/row-sorting/sortFns.d.ts +23 -0
  369. package/dist/node_modules/@tanstack/table-core/dist/features/stockFeatures.d.ts +37 -0
  370. package/dist/node_modules/@tanstack/table-core/dist/helpers/columnHelper.d.ts +47 -0
  371. package/dist/node_modules/@tanstack/table-core/dist/types/Cell.d.ts +16 -0
  372. package/dist/node_modules/@tanstack/table-core/dist/types/Column.d.ts +30 -0
  373. package/dist/node_modules/@tanstack/table-core/dist/types/ColumnDef.d.ts +123 -0
  374. package/dist/node_modules/@tanstack/table-core/dist/types/Header.d.ts +12 -0
  375. package/dist/node_modules/@tanstack/table-core/dist/types/HeaderGroup.d.ts +6 -0
  376. package/dist/node_modules/@tanstack/table-core/dist/types/Row.d.ts +24 -0
  377. package/dist/node_modules/@tanstack/table-core/dist/types/RowModel.d.ts +19 -0
  378. package/dist/node_modules/@tanstack/table-core/dist/types/RowModelFns.d.ts +11 -0
  379. package/dist/node_modules/@tanstack/table-core/dist/types/Table.d.ts +53 -0
  380. package/dist/node_modules/@tanstack/table-core/dist/types/TableFeatures.d.ts +416 -0
  381. package/dist/node_modules/@tanstack/table-core/dist/types/TableOptions.d.ts +78 -0
  382. package/dist/node_modules/@tanstack/table-core/dist/types/TableState.d.ts +46 -0
  383. package/dist/node_modules/@tanstack/table-core/dist/types/type-utils.d.ts +25 -0
  384. package/dist/shared.css +179 -0
  385. package/dist/styles.css +5467 -0
  386. package/dist/theme.css +314 -0
  387. package/dist/theme.map.json +278 -0
  388. package/dist/tokens/index.d.ts +2 -0
  389. package/dist/tokens/index.js +1 -0
  390. package/dist/tokens/tokens.generated.d.ts +2040 -0
  391. package/dist/tokens/tokens.generated.js +2053 -0
  392. package/dist/tokens.css +484 -0
  393. package/dist/tokens.flat.json +429 -0
  394. package/docs/Consuming.mdx +396 -0
  395. package/docs/Contributing.mdx +78 -0
  396. package/docs/ForAgents.mdx +53 -0
  397. package/docs/Introduction.mdx +54 -0
  398. package/llms.txt +550 -0
  399. package/package.json +347 -3
  400. package/src/components/action-row/ActionRow.mdx +686 -0
  401. package/src/components/action-row/ActionRow.stories.tsx +669 -0
  402. package/src/components/action-row/ActionRow.tsx +632 -0
  403. package/src/components/action-row/index.ts +9 -0
  404. package/src/components/alert/Alert.mdx +377 -0
  405. package/src/components/alert/Alert.stories.tsx +674 -0
  406. package/src/components/alert/Alert.tsx +579 -0
  407. package/src/components/alert/index.ts +13 -0
  408. package/src/components/anchored-panel/AnchoredPanel.mdx +381 -0
  409. package/src/components/anchored-panel/AnchoredPanel.stories.tsx +593 -0
  410. package/src/components/anchored-panel/AnchoredPanel.tsx +176 -0
  411. package/src/components/anchored-panel/index.ts +15 -0
  412. package/src/components/badge/Badge.mdx +487 -0
  413. package/src/components/badge/Badge.stories.tsx +375 -0
  414. package/src/components/badge/Badge.tsx +360 -0
  415. package/src/components/badge/index.ts +10 -0
  416. package/src/components/banner/Banner.mdx +704 -0
  417. package/src/components/banner/Banner.stories.tsx +448 -0
  418. package/src/components/banner/Banner.tsx +602 -0
  419. package/src/components/banner/index.ts +14 -0
  420. package/src/components/button/Button.mdx +286 -0
  421. package/src/components/button/Button.stories.tsx +381 -0
  422. package/src/components/button/Button.tsx +384 -0
  423. package/src/components/button/index.ts +1 -0
  424. package/src/components/button-group/ButtonGroup.mdx +512 -0
  425. package/src/components/button-group/ButtonGroup.stories.tsx +714 -0
  426. package/src/components/button-group/ButtonGroup.tsx +491 -0
  427. package/src/components/button-group/index.ts +10 -0
  428. package/src/components/card-select/CardSelect.mdx +662 -0
  429. package/src/components/card-select/CardSelect.stories.tsx +784 -0
  430. package/src/components/card-select/CardSelect.tsx +783 -0
  431. package/src/components/card-select/CardSelectGroup.tsx +169 -0
  432. package/src/components/card-select/index.ts +18 -0
  433. package/src/components/checkbox/Checkbox.mdx +269 -0
  434. package/src/components/checkbox/Checkbox.stories.tsx +306 -0
  435. package/src/components/checkbox/Checkbox.tsx +343 -0
  436. package/src/components/checkbox/index.ts +1 -0
  437. package/src/components/chip/Chip.mdx +683 -0
  438. package/src/components/chip/Chip.stories.tsx +734 -0
  439. package/src/components/chip/Chip.tsx +732 -0
  440. package/src/components/chip/index.ts +9 -0
  441. package/src/components/column-header/ColumnHeader.mdx +301 -0
  442. package/src/components/column-header/ColumnHeader.stories.tsx +319 -0
  443. package/src/components/column-header/ColumnHeader.tsx +287 -0
  444. package/src/components/column-header/index.ts +7 -0
  445. package/src/components/combobox-field/Combobox.tsx +693 -0
  446. package/src/components/combobox-field/ComboboxField.mdx +525 -0
  447. package/src/components/combobox-field/ComboboxField.stories.tsx +502 -0
  448. package/src/components/combobox-field/ComboboxField.tsx +259 -0
  449. package/src/components/combobox-field/index.ts +12 -0
  450. package/src/components/date-picker/DatePicker.mdx +440 -0
  451. package/src/components/date-picker/DatePicker.stories.tsx +458 -0
  452. package/src/components/date-picker/DatePicker.tsx +688 -0
  453. package/src/components/date-picker/index.ts +9 -0
  454. package/src/components/divider/Divider.mdx +256 -0
  455. package/src/components/divider/Divider.stories.tsx +177 -0
  456. package/src/components/divider/Divider.tsx +193 -0
  457. package/src/components/divider/index.ts +1 -0
  458. package/src/components/drawer/Drawer.mdx +518 -0
  459. package/src/components/drawer/Drawer.stories.tsx +392 -0
  460. package/src/components/drawer/Drawer.tsx +683 -0
  461. package/src/components/drawer/index.ts +1 -0
  462. package/src/components/dropdown-button/DropdownButton.mdx +285 -0
  463. package/src/components/dropdown-button/DropdownButton.stories.tsx +398 -0
  464. package/src/components/dropdown-button/DropdownButton.tsx +198 -0
  465. package/src/components/dropdown-button/index.ts +7 -0
  466. package/src/components/faq/FAQ.mdx +364 -0
  467. package/src/components/faq/FAQ.stories.tsx +343 -0
  468. package/src/components/faq/FAQ.tsx +337 -0
  469. package/src/components/faq/index.ts +1 -0
  470. package/src/components/field/Field.mdx +129 -0
  471. package/src/components/field/Field.stories.tsx +461 -0
  472. package/src/components/field/Field.tsx +787 -0
  473. package/src/components/field/index.ts +20 -0
  474. package/src/components/field-pair/FieldPair.mdx +312 -0
  475. package/src/components/field-pair/FieldPair.stories.tsx +539 -0
  476. package/src/components/field-pair/FieldPair.tsx +845 -0
  477. package/src/components/field-pair/index.ts +9 -0
  478. package/src/components/file-upload/FileUpload.mdx +345 -0
  479. package/src/components/file-upload/FileUpload.stories.tsx +698 -0
  480. package/src/components/file-upload/FileUpload.tsx +802 -0
  481. package/src/components/file-upload/index.ts +6 -0
  482. package/src/components/filter-chip/FilterChip.mdx +778 -0
  483. package/src/components/filter-chip/FilterChip.stories.tsx +827 -0
  484. package/src/components/filter-chip/FilterChip.tsx +881 -0
  485. package/src/components/filter-chip/index.ts +11 -0
  486. package/src/components/filter-facet/FilterFacet.mdx +536 -0
  487. package/src/components/filter-facet/FilterFacet.stories.tsx +506 -0
  488. package/src/components/filter-facet/FilterFacet.tsx +1160 -0
  489. package/src/components/filter-facet/index.ts +7 -0
  490. package/src/components/firm-avatar/FirmAvatar.mdx +280 -0
  491. package/src/components/firm-avatar/FirmAvatar.stories.tsx +147 -0
  492. package/src/components/firm-avatar/FirmAvatar.tsx +172 -0
  493. package/src/components/firm-avatar/index.ts +7 -0
  494. package/src/components/form-actions/FormActions.mdx +518 -0
  495. package/src/components/form-actions/FormActions.stories.tsx +621 -0
  496. package/src/components/form-actions/FormActions.tsx +273 -0
  497. package/src/components/form-actions/index.ts +6 -0
  498. package/src/components/form-block/FormBlock.mdx +728 -0
  499. package/src/components/form-block/FormBlock.stories.tsx +813 -0
  500. package/src/components/form-block/FormBlock.tsx +679 -0
  501. package/src/components/form-block/index.ts +13 -0
  502. package/src/components/form-section/FormSection.mdx +436 -0
  503. package/src/components/form-section/FormSection.stories.tsx +407 -0
  504. package/src/components/form-section/FormSection.tsx +290 -0
  505. package/src/components/form-section/index.ts +17 -0
  506. package/src/components/heading/Heading.mdx +206 -0
  507. package/src/components/heading/Heading.stories.tsx +169 -0
  508. package/src/components/heading/Heading.tsx +124 -0
  509. package/src/components/heading/index.ts +8 -0
  510. package/src/components/heading-group/HeadingGroup.mdx +521 -0
  511. package/src/components/heading-group/HeadingGroup.stories.tsx +353 -0
  512. package/src/components/heading-group/HeadingGroup.tsx +396 -0
  513. package/src/components/heading-group/index.ts +7 -0
  514. package/src/components/hero/Hero.mdx +742 -0
  515. package/src/components/hero/Hero.stories.tsx +527 -0
  516. package/src/components/hero/Hero.tsx +807 -0
  517. package/src/components/hero/index.ts +1 -0
  518. package/src/components/icon/Icon.mdx +329 -0
  519. package/src/components/icon/Icon.stories.tsx +398 -0
  520. package/src/components/icon/Icon.tsx +97 -0
  521. package/src/components/icon/index.ts +2 -0
  522. package/src/components/icon-button/IconButton.mdx +206 -0
  523. package/src/components/icon-button/IconButton.stories.tsx +341 -0
  524. package/src/components/icon-button/IconButton.tsx +273 -0
  525. package/src/components/icon-button/index.ts +1 -0
  526. package/src/components/item-row/ItemRow.mdx +533 -0
  527. package/src/components/item-row/ItemRow.stories.tsx +434 -0
  528. package/src/components/item-row/ItemRow.tsx +676 -0
  529. package/src/components/item-row/index.ts +9 -0
  530. package/src/components/list-row/ListRow.mdx +404 -0
  531. package/src/components/list-row/ListRow.stories.tsx +404 -0
  532. package/src/components/list-row/ListRow.tsx +424 -0
  533. package/src/components/list-row/index.ts +1 -0
  534. package/src/components/menu/Menu.mdx +268 -0
  535. package/src/components/menu/Menu.stories.tsx +455 -0
  536. package/src/components/menu/Menu.tsx +452 -0
  537. package/src/components/menu/index.ts +1 -0
  538. package/src/components/modal/Modal.mdx +854 -0
  539. package/src/components/modal/Modal.stories.tsx +881 -0
  540. package/src/components/modal/Modal.tsx +1434 -0
  541. package/src/components/modal/index.ts +1 -0
  542. package/src/components/nav-link/NavLink.mdx +196 -0
  543. package/src/components/nav-link/NavLink.stories.tsx +243 -0
  544. package/src/components/nav-link/NavLink.tsx +222 -0
  545. package/src/components/nav-link/index.ts +1 -0
  546. package/src/components/number-field/NumberField.mdx +223 -0
  547. package/src/components/number-field/NumberField.stories.tsx +291 -0
  548. package/src/components/number-field/NumberField.tsx +388 -0
  549. package/src/components/number-field/index.ts +6 -0
  550. package/src/components/pagination/Pagination.mdx +305 -0
  551. package/src/components/pagination/Pagination.stories.tsx +333 -0
  552. package/src/components/pagination/Pagination.tsx +343 -0
  553. package/src/components/pagination/index.ts +8 -0
  554. package/src/components/popover-surface/PopoverSurface.mdx +158 -0
  555. package/src/components/popover-surface/PopoverSurface.stories.tsx +421 -0
  556. package/src/components/popover-surface/index.ts +1 -0
  557. package/src/components/progress-bar/ProgressBar.mdx +802 -0
  558. package/src/components/progress-bar/ProgressBar.stories.tsx +533 -0
  559. package/src/components/progress-bar/ProgressBar.tsx +654 -0
  560. package/src/components/progress-bar/index.ts +9 -0
  561. package/src/components/promo-sticker/PromoSticker.mdx +436 -0
  562. package/src/components/promo-sticker/PromoSticker.stories.tsx +363 -0
  563. package/src/components/promo-sticker/PromoSticker.tsx +313 -0
  564. package/src/components/promo-sticker/index.ts +7 -0
  565. package/src/components/promo-surface/PromoSurface.mdx +399 -0
  566. package/src/components/promo-surface/PromoSurface.stories.tsx +270 -0
  567. package/src/components/promo-surface/PromoSurface.tsx +305 -0
  568. package/src/components/promo-surface/index.ts +7 -0
  569. package/src/components/radio/Radio.mdx +243 -0
  570. package/src/components/radio/Radio.stories.tsx +307 -0
  571. package/src/components/radio/Radio.tsx +288 -0
  572. package/src/components/radio/index.ts +1 -0
  573. package/src/components/radio-group/RadioGroup.mdx +119 -0
  574. package/src/components/radio-group/RadioGroup.stories.tsx +225 -0
  575. package/src/components/radio-group/RadioGroup.tsx +139 -0
  576. package/src/components/radio-group/index.ts +1 -0
  577. package/src/components/select/Select.mdx +241 -0
  578. package/src/components/select/Select.stories.tsx +404 -0
  579. package/src/components/select/Select.tsx +381 -0
  580. package/src/components/select/index.ts +1 -0
  581. package/src/components/select-field/SelectField.mdx +324 -0
  582. package/src/components/select-field/SelectField.stories.tsx +460 -0
  583. package/src/components/select-field/SelectField.tsx +138 -0
  584. package/src/components/select-field/index.ts +1 -0
  585. package/src/components/skeleton/Skeleton.mdx +194 -0
  586. package/src/components/skeleton/Skeleton.stories.tsx +260 -0
  587. package/src/components/skeleton/Skeleton.tsx +107 -0
  588. package/src/components/skeleton/index.ts +1 -0
  589. package/src/components/split-button/SplitButton.mdx +445 -0
  590. package/src/components/split-button/SplitButton.stories.tsx +465 -0
  591. package/src/components/split-button/SplitButton.tsx +361 -0
  592. package/src/components/split-button/index.ts +7 -0
  593. package/src/components/status-summary-bar/StatusSummaryBar.mdx +338 -0
  594. package/src/components/status-summary-bar/StatusSummaryBar.stories.tsx +408 -0
  595. package/src/components/status-summary-bar/StatusSummaryBar.tsx +428 -0
  596. package/src/components/status-summary-bar/index.ts +8 -0
  597. package/src/components/subject-lookup-field/SubjectLookupField.mdx +378 -0
  598. package/src/components/subject-lookup-field/SubjectLookupField.stories.tsx +393 -0
  599. package/src/components/subject-lookup-field/SubjectLookupField.tsx +1079 -0
  600. package/src/components/subject-lookup-field/index.ts +11 -0
  601. package/src/components/switch/Switch.mdx +376 -0
  602. package/src/components/switch/Switch.stories.tsx +296 -0
  603. package/src/components/switch/Switch.tsx +483 -0
  604. package/src/components/switch/index.ts +1 -0
  605. package/src/components/table/Table.mdx +575 -0
  606. package/src/components/table/Table.stories.tsx +1049 -0
  607. package/src/components/table/Table.tsx +745 -0
  608. package/src/components/table/TableConsumers.stories.tsx +195 -0
  609. package/src/components/table/_tableFixtures.ts +1189 -0
  610. package/src/components/table/index.ts +22 -0
  611. package/src/components/text-field/TextField.mdx +699 -0
  612. package/src/components/text-field/TextField.stories.tsx +674 -0
  613. package/src/components/text-field/TextField.tsx +645 -0
  614. package/src/components/text-field/index.ts +11 -0
  615. package/src/components/text-link/TextLink.mdx +353 -0
  616. package/src/components/text-link/TextLink.stories.tsx +458 -0
  617. package/src/components/text-link/TextLink.tsx +504 -0
  618. package/src/components/text-link/index.ts +10 -0
  619. package/src/components/textarea/Textarea.mdx +244 -0
  620. package/src/components/textarea/Textarea.stories.tsx +371 -0
  621. package/src/components/textarea/Textarea.tsx +489 -0
  622. package/src/components/textarea/index.ts +9 -0
  623. package/src/components/tooltip/Tooltip.mdx +462 -0
  624. package/src/components/tooltip/Tooltip.stories.tsx +500 -0
  625. package/src/components/tooltip/Tooltip.tsx +756 -0
  626. package/src/components/tooltip/index.ts +13 -0
  627. package/src/components/unit-field/UnitField.mdx +215 -0
  628. package/src/components/unit-field/UnitField.stories.tsx +291 -0
  629. package/src/components/unit-field/UnitField.tsx +255 -0
  630. package/src/components/unit-field/index.ts +7 -0
  631. package/src/icons/icon-registry.generated.ts +510 -0
  632. package/src/icons/icon-types.generated.ts +256 -0
  633. package/src/index.ts +70 -0
  634. package/src/internal/BottomSheet.tsx +714 -0
  635. package/src/internal/FodsProvider.tsx +36 -0
  636. package/src/internal/MotionCaret.tsx +53 -0
  637. package/src/internal/NumberFormatInput.tsx +276 -0
  638. package/src/internal/SummaryDonut.tsx +359 -0
  639. package/src/internal/buttonSegment.ts +241 -0
  640. package/src/internal/collapseRoom.ts +130 -0
  641. package/src/internal/comboboxKeys.ts +90 -0
  642. package/src/internal/contentPresence.ts +46 -0
  643. package/src/internal/dayCell.ts +274 -0
  644. package/src/internal/dialogPortal.ts +50 -0
  645. package/src/internal/donutSweeps.ts +77 -0
  646. package/src/internal/enterOnViewGeometry.ts +53 -0
  647. package/src/internal/faqItem.ts +104 -0
  648. package/src/internal/floatingLabelMotion.tsx +109 -0
  649. package/src/internal/formBlockContext.ts +27 -0
  650. package/src/internal/heightRoom.ts +135 -0
  651. package/src/internal/numberSeparators.ts +93 -0
  652. package/src/internal/overlayMotion.tsx +32 -0
  653. package/src/internal/paginationItem.ts +106 -0
  654. package/src/internal/popoverSurface.ts +78 -0
  655. package/src/internal/portalContainer.ts +11 -0
  656. package/src/internal/progressBarItem.ts +356 -0
  657. package/src/internal/selectionControlText.ts +42 -0
  658. package/src/internal/statusSummaryParts.tsx +475 -0
  659. package/src/internal/summaryMotion.ts +111 -0
  660. package/src/internal/table/ChildConnector.tsx +57 -0
  661. package/src/internal/table/ChildRowPrefix.tsx +21 -0
  662. package/src/internal/table/ColumnSettings.tsx +194 -0
  663. package/src/internal/table/ScrollRegion.tsx +176 -0
  664. package/src/internal/table/TableEmpty.tsx +99 -0
  665. package/src/internal/table/TableLayout.tsx +29 -0
  666. package/src/internal/table/TableLoadStatus.tsx +60 -0
  667. package/src/internal/table/TableMobile.tsx +582 -0
  668. package/src/internal/table/TruncatedCell.tsx +35 -0
  669. package/src/internal/table/emptyValue.ts +11 -0
  670. package/src/internal/table/features.ts +44 -0
  671. package/src/internal/table/recipes.ts +263 -0
  672. package/src/internal/table/rowClick.ts +8 -0
  673. package/src/internal/table/types.ts +342 -0
  674. package/src/internal/tailwind-variants.ts +65 -0
  675. package/src/internal/tooltipContext.ts +15 -0
  676. package/src/internal/tw-merge-config.generated.ts +275 -0
  677. package/src/internal/useAnchoredPanel.ts +340 -0
  678. package/src/internal/useCountUp.ts +65 -0
  679. package/src/internal/useDateFieldTrigger.tsx +497 -0
  680. package/src/internal/useEChart.ts +88 -0
  681. package/src/internal/useEnterOnView.ts +80 -0
  682. package/src/internal/useFloatingBar.ts +125 -0
  683. package/src/internal/useFormReset.ts +57 -0
  684. package/src/internal/useIsMobile.ts +64 -0
  685. package/src/internal/useNoImplicitSubmit.ts +41 -0
  686. package/src/internal/useOneRowOverflow.ts +103 -0
  687. package/src/internal/usePrefersReducedMotion.ts +27 -0
  688. package/src/internal/useReturnFocus.ts +34 -0
  689. package/src/internal/utils.ts +58 -0
  690. package/src/recipes/EmptyState.stories.tsx +105 -0
  691. package/src/recipes/Form.stories.tsx +360 -0
  692. package/src/recipes/ModalWithForm.stories.tsx +219 -0
  693. package/src/recipes/Recipes.mdx +61 -0
  694. package/src/recipes/TableWithFilters.stories.tsx +278 -0
  695. package/src/storybook/FodsFamily.tsx +39 -0
  696. package/src/storybook/Section.tsx +36 -0
  697. package/src/storybook/a11y.ts +24 -0
  698. package/src/storybook/assets/banner-character-bartender.webp +0 -0
  699. package/src/storybook/assets/banner-invoice-sheet-left.webp +0 -0
  700. package/src/storybook/assets/banner-invoice-sheet-right.webp +0 -0
  701. package/src/storybook/assets/invoice-hero.webp +0 -0
  702. package/src/storybook/assets/invoice.webp +0 -0
  703. package/src/storybook/assets/section-document-info.svg +21 -0
  704. package/src/storybook/assets/section-gear-checklist.svg +11 -0
  705. package/src/storybook/assets/section-person-arrow-in.svg +15 -0
  706. package/src/storybook/assets/section-person-arrow-out.svg +22 -0
  707. package/src/storybook/assets/section-receipt-dollar.svg +23 -0
  708. package/src/storybook/assets/table-empty-folder-empty.png +0 -0
  709. package/src/storybook/assets/table-empty-folder-magnifying-glass.png +0 -0
  710. package/src/storybook/assets/table-empty-funnel.png +0 -0
  711. package/src/storybook/assets/table-empty-load-failed.png +0 -0
  712. package/src/storybook/assets/wallet-spot.png +0 -0
  713. package/src/storybook/assets.d.ts +17 -0
  714. package/src/storybook/componentDoc.ts +41 -0
  715. package/src/storybook/fitFrame.tsx +70 -0
  716. package/src/storybook/forceStates.tsx +647 -0
  717. package/src/storybook/illustrations.tsx +66 -0
  718. package/src/storybook/viewportFrame.tsx +58 -0
  719. package/src/styles/assets/label-brush-1.svg +6 -0
  720. package/src/styles/assets/pattern-dark.svg +113 -0
  721. package/src/styles/base.css +106 -0
  722. package/src/styles/index.css +15 -0
  723. package/src/styles/motion.css +157 -0
  724. package/src/styles/promo-sticker.css +27 -0
  725. package/src/styles/promo-surface.css +49 -0
  726. package/src/styles/shared.css +11 -0
  727. package/src/styles/theme.generated.css +314 -0
  728. package/src/styles/theme.map.json +278 -0
  729. package/src/styles/tracking.generated.css +12 -0
  730. package/src/tokens/index.ts +4 -0
  731. package/src/tokens/tokens.generated.ts +542 -0
@@ -0,0 +1,679 @@
1
+ "use client";
2
+ import * as React from 'react';
3
+ import { motion, useReducedMotion } from 'motion/react';
4
+ import { tv } from '../../internal/tailwind-variants';
5
+ import { useIsMobile } from '../../internal/useIsMobile';
6
+ import { cn } from '../../internal/utils';
7
+ import { ROOM_BOTTOM_CLIP, roomCloseMs, roomVariants, useRoomPresence } from '../../internal/collapseRoom';
8
+ import { MotionCaret } from '../../internal/MotionCaret';
9
+ import { FormBlockContext } from '../../internal/formBlockContext';
10
+ import { HeadingGroup } from '../heading-group/HeadingGroup';
11
+ import { IconButton } from '../icon-button/IconButton';
12
+ import { TextLink, textLinkVariants, type TextLinkElement } from '../text-link/TextLink';
13
+ import { Icon } from '../icon/Icon';
14
+
15
+ /** Public: the app names its own group of item rows by the block's title id. */
16
+ export { useFormBlock, type FormBlockContextValue } from '../../internal/formBlockContext';
17
+
18
+ /**
19
+ * FormBlock — the white tile of a form page (`form-block.manifest.json`, organism,
20
+ * v2.0.0, `kind: "region"`): a pictured H3 Heading Group with one trailing control, over
21
+ * a grid of Form Sections or a one-column stack. The illustration is a React element the app
22
+ * supplies (`delivery.react`, 1.8.0 / 2.0.0 major); the component ships no picture and owns
23
+ * only its box.
24
+ *
25
+ * ## Breakpoint is not a prop
26
+ *
27
+ * `properties[Breakpoint].maps`: padding, header gap and content grid follow the viewport
28
+ * media queries. Mobile = unprefixed, SM = `sm:`, MD = `md:`, LG = `lg:`; every XL value
29
+ * equals its LG value, except the deprecated headless grid (`xl:grid-cols-3`).
30
+ *
31
+ * ## Header row
32
+ *
33
+ * `regions[header].align`: from SM one row that never wraps — the Heading Group fills it
34
+ * (`flex-1 min-w-0`, title and description wrap inside), trailing hugs at the row end. At
35
+ * Breakpoint=Mobile (below `sm`; 1.7.0) the header stacks: the Heading Group fills the width,
36
+ * the trailing slot sits under it at the row start, full width, `--space-600` apart, and the
37
+ * toggle keeps its full label (no toggle fit). The Heading Group runs Picture=40 there
38
+ * (`useIsMobile('sm')`). The header gap above the content is `--space-900` at every
39
+ * breakpoint (`chrome.header-gap`, 1.7.0).
40
+ *
41
+ * ## Inline moves the trailing slot in the DOM
42
+ *
43
+ * `regions[header].align`: DOM order follows the visual order, so at Inline MD+ the
44
+ * trailing slot is rendered after the content (end of the body row), and in the header
45
+ * row everywhere else. CSS `order` would split reading/tab order from the visual order,
46
+ * so the switch is made in markup through `useIsMobile('md')` — a synchronous
47
+ * `matchMedia` read whose query mirrors the `md:` prefix exactly.
48
+ *
49
+ * ## Trailing is an open slot
50
+ *
51
+ * `slots.trailing`: the header's one control — the toggle the block renders, «Upravit
52
+ * údaje», the line-items price-mode group, or any other single control the page
53
+ * composes. Beside the heading element, never inside it; every link, button and label in
54
+ * it gets a 44 px hit zone.
55
+ *
56
+ * ## The content element IS the grid, or the stack
57
+ *
58
+ * `notes[0]` / `delivery.react`: no wrapper between it and its children. It carries the
59
+ * id the toggle controls and the `hidden` attribute while closed; because it is also
60
+ * `display: grid` / `flex`, `[&[hidden]]:hidden` re-asserts `display: none` (`notes[3]`).
61
+ * `content="stack"` (`chrome.content-stack`) is one column of free children, each full
62
+ * width, `--space-900` apart at every breakpoint. The line items are its documented
63
+ * composition (`chrome.line-items`: rows, actions, totals, optional footer); the rows
64
+ * zone, not the stack, is the `role="group"` named by the block title — it reads the
65
+ * title id from `FormBlockContext`.
66
+ *
67
+ * ## Open/close motion (`motion`, 1.6.0)
68
+ *
69
+ * Calm motion through Motion, on the content element itself — no wrapper, so it stays the
70
+ * grid: opening un-hides it, its height opens on `springs.gentle` while it fades in over
71
+ * `--duration-slow` + `--easing-enter`; closing makes it `inert`, fades it out over
72
+ * `--duration-fast` + `--easing-exit`, then folds the height, and only then gives it
73
+ * `hidden`. A re-toggle reverses from where it is. Reduced motion: at once, no fade
74
+ * (`motion.reducedMotion`). The caret is one `caret-down-small` turning 180° on
75
+ * `springs.standard` — the shared `internal/MotionCaret`, passed into the toggle's
76
+ * `trailingIcon` (TextLink) or `icon` (IconButton) as an element. See the approved deviation `form-block-collapse-motion`.
77
+ *
78
+ * ## Toggle fit
79
+ *
80
+ * `slots.trailing` (a) / `delivery.react`: the toggle is Text Link Strong sm, Underline
81
+ * off, and from SM steps down as the header row runs short — Full (the label) → Short (the verb
82
+ * alone, the noun `sr-only`) → Icon (Icon Button Tertiary lg, caret only). `useToggleFit`
83
+ * measures the row against the Heading Group's unwrapped width; the yardstick is the
84
+ * `show` label (the longer string, spec § Copy), so flipping Open never changes the step.
85
+ * No `aria-expanded`: the label carries the state, and the full label stays the first part
86
+ * of the accessible name at every step. While closed, a click anywhere on the tile opens
87
+ * the block (no extra tab stop or role).
88
+ *
89
+ * ## Hidden header (`chrome.modal-host`, 1.5.0)
90
+ *
91
+ * `showHeader={false}` mirrors the Figma boolean Show header off outside the deprecated
92
+ * parties tile (the first block in a Modal body, introduced by the modal title): the same
93
+ * `<section>` and content element, no header row. The title stays required and names the section through
94
+ * `aria-label`; `collapsible` and `trailing` are rejected by the prop types and Inline is
95
+ * typed out (no header column to fill the first track).
96
+ *
97
+ * ## No states
98
+ *
99
+ * No `axes.state`. The block owns no disabled state; the trailing controls carry their
100
+ * own.
101
+ */
102
+
103
+ const formBlockVariants = tv({
104
+ slots: {
105
+ // container: no clipping, width capped at --ds-content-wide. The tile paint is the
106
+ // `surface` variant.
107
+ root: 'w-full max-w-content-wide',
108
+ // regions[header].align, gap --space-600. Mobile (1.7.0): a column — the Heading Group
109
+ // fills the width, the trailing slot sits under it at the row start, full width (both
110
+ // stretch). From SM: one row that never wraps, both centred; the Heading Group fills it
111
+ // and trailing hugs at the row end. `min-w-0` lets a title longer than the row shrink
112
+ // the Heading Group so the title wraps instead of overflowing.
113
+ header: 'flex flex-col gap-600 sm:flex-row sm:items-center',
114
+ heading: 'min-w-0 sm:flex-1',
115
+ // Code-only 44 px hit zone (`slots.trailing`, spec § Accessibility → Target) for every
116
+ // control inside the slot — a link, a button, or a Radio's <label> root: a centred
117
+ // `::before` the click lands on, so the label, its type and its focus ring stay untouched.
118
+ // 44 = --space-1000 + 2 × --space-100 (Modal's decline link uses the same sum).
119
+ trailing: [
120
+ 'shrink-0',
121
+ '[&_:is(a,button,label)]:relative',
122
+ "[&_:is(a,button,label)]:before:absolute [&_:is(a,button,label)]:before:left-1/2 [&_:is(a,button,label)]:before:top-1/2 [&_:is(a,button,label)]:before:content-['']",
123
+ '[&_:is(a,button,label)]:before:-translate-x-1/2 [&_:is(a,button,label)]:before:-translate-y-1/2 [&_:is(a,button,label)]:before:size-full',
124
+ '[&_:is(a,button,label)]:before:min-h-[calc(var(--space-1000)_+_var(--space-100)*2)] [&_:is(a,button,label)]:before:min-w-[calc(var(--space-1000)_+_var(--space-100)*2)]',
125
+ ],
126
+ // chrome.inline body row (Inline MD+): content filling, trailing hugging the row end
127
+ // (also when a collapsed content grid is display:none), top-aligned. Rendered at every
128
+ // width so the content keeps one parent — React would remount the children (losing
129
+ // input values and local state) if the content moved when the viewport crosses MD.
130
+ // Below MD it is display:contents, so the content stays a flex item of the root.
131
+ body: 'contents md:flex md:items-start md:gap-800 [&>[data-fods-part=trailing]]:ml-auto',
132
+ // chrome.content-grid row gaps: --space-900 below MD, --space-1000 from MD.
133
+ contentGrid: 'grid grid-flow-row grid-cols-1 items-start gap-y-900 *:min-w-0 md:gap-y-1000 [&[hidden]]:hidden',
134
+ // chrome.content-stack: one full-width column, --space-900 at every breakpoint.
135
+ contentStack: 'flex flex-col gap-900 *:min-w-0 [&[hidden]]:hidden',
136
+ toggle: '',
137
+ },
138
+ variants: {
139
+ surface: {
140
+ // container: --bg-primary, --radius-700 on all four corners. notes[4]: a
141
+ // --border-width-100 transparent border that forced colors paints. chrome.padding:
142
+ // Mobile --space-800 / --space-600, SM --space-800, MD+ --space-1000.
143
+ tile: {
144
+ root: [
145
+ 'rounded-700 bg-background-primary',
146
+ 'border-100 border-solid border-transparent',
147
+ 'px-600 py-800 sm:px-800 md:p-1000',
148
+ ],
149
+ },
150
+ // `chrome.modal-host` (1.5.0): no tile paint, no padding — the Modal body's padding is
151
+ // the only inset, and the Modal card carries the forced-colors edge itself.
152
+ none: {},
153
+ },
154
+ layout: {
155
+ // chrome.header-gap: --space-900 at every breakpoint (1.7.0).
156
+ // chrome.content-grid: 2 tracks at LG/XL, column gap --space-1000.
157
+ stacked: {
158
+ root: 'flex flex-col gap-900',
159
+ contentGrid: 'lg:grid-cols-2 lg:gap-x-1000',
160
+ },
161
+ // Below MD Inline renders like Stacked. chrome.inline from MD: the tile is a grid
162
+ // of equal tracks — 2 at MD (gap --space-900), 3 at LG/XL (gap --space-1000); the
163
+ // body takes 1 track at MD and 2 at LG/XL. The content grid stays 1 track.
164
+ inline: {
165
+ root: 'flex flex-col gap-900 md:grid md:grid-cols-2 md:items-start md:gap-x-900 lg:grid-cols-3 lg:gap-x-1000',
166
+ body: 'lg:col-span-2',
167
+ contentGrid: 'min-w-0 md:flex-1',
168
+ contentStack: 'min-w-0 md:flex-1',
169
+ },
170
+ },
171
+ // Deprecated parties tile: 3 tracks at XL, 2 at LG, 1 below.
172
+ headless: {
173
+ true: { contentGrid: 'xl:grid-cols-3' },
174
+ false: {},
175
+ },
176
+ },
177
+ defaultVariants: {
178
+ surface: 'tile',
179
+ layout: 'stacked',
180
+ headless: false,
181
+ },
182
+ });
183
+
184
+ export type FormBlockLayout = 'stacked' | 'inline';
185
+ export type FormBlockContent = 'grid' | 'stack';
186
+ export type FormBlockHeadingLevel = 2 | 3 | 4 | 5 | 6;
187
+ export type FormBlockSurface = 'tile' | 'none';
188
+
189
+ /** The toggle's two strings — the same noun after both verbs (spec § Copy). */
190
+ export interface FormBlockToggleLabel {
191
+ /** «Zobrazit …» — shown while the block is closed. */
192
+ show: string;
193
+ /** «Skrýt …» — shown while the block is open. */
194
+ hide: string;
195
+ }
196
+
197
+ interface FormBlockBaseProps extends Omit<React.HTMLAttributes<HTMLElement>, 'title' | 'children'> {
198
+ /** The Layout axis. `inline` puts the header in its own grid track from MD. Default `'stacked'`. */
199
+ layout?: FormBlockLayout;
200
+ /** The content, in reading order: Form Sections in grid mode, free children in stack mode. */
201
+ children?: React.ReactNode;
202
+ /**
203
+ * Code-only, no Figma counterpart. `'tile'` (default) — the white tile of a form page.
204
+ * `'none'` — no fill, radius, forced-colors border or padding, for a block that sits on
205
+ * a surface which already is the tile (the body of a Modal, the Mini Form card); header,
206
+ * gaps and content grid stay. `properties[Surface]` / `chrome.modal-host` (1.5.0); the host sets the
207
+ * `--space-1000` gap between consecutive blocks.
208
+ */
209
+ surface?: FormBlockSurface;
210
+ }
211
+
212
+ interface FormBlockHeaderProps {
213
+ headless?: false;
214
+ /**
215
+ * The Heading Group title — the block's accessible name (through `aria-labelledby`, or
216
+ * `aria-label` when `showHeader` is `false`).
217
+ */
218
+ title: string;
219
+ /**
220
+ * `'grid'` (default) — the Form Section grid. `'stack'` — one column, every child full
221
+ * width, `--space-900` apart at every breakpoint (the line items: rows, actions, totals,
222
+ * optional footer).
223
+ */
224
+ content?: FormBlockContent;
225
+ }
226
+
227
+ interface FormBlockShownHeaderProps {
228
+ /** Figma Show header. Default `true`. */
229
+ showHeader?: true;
230
+ /** A sibling `<p>` of the heading, never inside it. */
231
+ description?: string;
232
+ /**
233
+ * The `Illustration / Section` picture, supplied by the app (e.g.
234
+ * `<img src={documentInfo} alt="" />` or an inline SVG): the package ships no picture.
235
+ * Drawn at every breakpoint in the Heading Group's picture box (48 px, 40 px below sm),
236
+ * which is `aria-hidden` — the title names the block.
237
+ */
238
+ illustration: React.ReactElement;
239
+ /** Heading element level (2–6). Default 2; the visual size stays H3. */
240
+ headingLevel?: FormBlockHeadingLevel;
241
+ }
242
+
243
+ interface FormBlockHiddenHeaderProps {
244
+ /**
245
+ * Code-only mirror of Figma Show header off outside the parties tile: the `<section>`
246
+ * and its content element without the header row; `title` names the section through
247
+ * `aria-label`. Stacked only, no trailing control and no toggle. Manifest 1.5.0
248
+ * (`properties[Show header].maps`, `chrome.modal-host`).
249
+ */
250
+ showHeader: false;
251
+ layout?: 'stacked';
252
+ description?: never;
253
+ illustration?: never;
254
+ headingLevel?: never;
255
+ collapsible?: false;
256
+ toggleLabel?: never;
257
+ open?: never;
258
+ defaultOpen?: never;
259
+ onOpenChange?: never;
260
+ trailing?: never;
261
+ }
262
+
263
+ interface FormBlockCollapsibleProps {
264
+ /** The block renders the disclosure toggle into the trailing area itself. */
265
+ collapsible: true;
266
+ /** Required — the toggle's label is the first part of its accessible name. */
267
+ toggleLabel: FormBlockToggleLabel;
268
+ /** Controlled open state. */
269
+ open?: boolean;
270
+ /** Uncontrolled initial state. Default `true`. */
271
+ defaultOpen?: boolean;
272
+ onOpenChange?: (open: boolean) => void;
273
+ trailing?: never;
274
+ }
275
+
276
+ interface FormBlockStaticProps {
277
+ collapsible?: false;
278
+ toggleLabel?: never;
279
+ open?: never;
280
+ defaultOpen?: never;
281
+ onOpenChange?: never;
282
+ /**
283
+ * The header's one control: «Upravit údaje», the line-items price-mode group (caption
284
+ * + RadioGroup), or any other single control. Every link, button and Radio label inside
285
+ * gets the 44 px hit zone.
286
+ */
287
+ trailing?: React.ReactNode;
288
+ }
289
+
290
+ interface FormBlockHeadlessProps {
291
+ /**
292
+ * @deprecated Only for the legacy parties tile — renders a plain `<div>` with no
293
+ * header, each party Form Section (`header="h3"`) names itself. New screens give each
294
+ * party its own `layout="inline"` block.
295
+ */
296
+ headless: true;
297
+ showHeader?: never;
298
+ title?: never;
299
+ description?: never;
300
+ illustration?: never;
301
+ headingLevel?: never;
302
+ content?: never;
303
+ collapsible?: never;
304
+ toggleLabel?: never;
305
+ open?: never;
306
+ defaultOpen?: never;
307
+ onOpenChange?: never;
308
+ trailing?: never;
309
+ }
310
+
311
+ /**
312
+ * `collapsible` and `trailing` are mutually exclusive (`delivery.react`); a hidden header
313
+ * takes neither.
314
+ */
315
+ export type FormBlockProps = FormBlockBaseProps &
316
+ (
317
+ | (FormBlockHeaderProps &
318
+ ((FormBlockShownHeaderProps & (FormBlockCollapsibleProps | FormBlockStaticProps)) | FormBlockHiddenHeaderProps))
319
+ | FormBlockHeadlessProps
320
+ );
321
+
322
+ function useControllableOpen(controlled: boolean | undefined, initial: boolean, onChange?: (open: boolean) => void) {
323
+ const [uncontrolled, setUncontrolled] = React.useState(initial);
324
+ const value = controlled !== undefined ? controlled : uncontrolled;
325
+ const setValue = React.useCallback(
326
+ (next: boolean) => {
327
+ if (controlled === undefined) setUncontrolled(next);
328
+ onChange?.(next);
329
+ },
330
+ [controlled, onChange],
331
+ );
332
+ return [value, setValue] as const;
333
+ }
334
+
335
+ /** `motion.reducedMotion`: «the content appears or disappears at once, no fade». */
336
+ const FORM_BLOCK_REDUCED_FADE = 'none';
337
+
338
+ /**
339
+ * How long a collapsible FormBlock takes to close, in milliseconds — the fade-out, then the
340
+ * room folding (`internal/collapseRoom.ts`); 0 under reduced motion, where it closes at
341
+ * once. For a consumer that keeps the closing content mounted until the close ends.
342
+ */
343
+ export function useFormBlockCloseMs(): number {
344
+ return roomCloseMs(useReducedMotion() === true, FORM_BLOCK_REDUCED_FADE);
345
+ }
346
+
347
+ type ToggleFit = 'full' | 'short' | 'icon';
348
+
349
+ /** Rounding of fractional layout widths, not a real overflow. */
350
+ const FIT_TOLERANCE = 0.5;
351
+
352
+ /** The shortened label is the verb alone (spec § Copy): the first word, the rest is the noun. */
353
+ function splitToggleLabel(label: string) {
354
+ const match = /^(\S+)\s+(.+)$/.exec(label.trim());
355
+ return match ? { verb: match[1], noun: match[2] } : { verb: label, noun: '' };
356
+ }
357
+
358
+ /**
359
+ * The toggle step that fits beside the Heading Group (`slots.trailing`, toggle fit). The
360
+ * probe holds the Full label at Text Link Strong sm; Short is the probe minus its noun.
361
+ * The Heading Group is measured at its unwrapped width (inline styles set and removed in
362
+ * the same task, never painted). Without layout (jsdom, a hidden block) it stays Full.
363
+ */
364
+ function useToggleFit(
365
+ enabled: boolean,
366
+ headerRef: React.RefObject<HTMLDivElement | null>,
367
+ headingRef: React.RefObject<HTMLDivElement | null>,
368
+ probeRef: React.RefObject<HTMLSpanElement | null>,
369
+ toggleRef: React.RefObject<HTMLButtonElement | null>,
370
+ remeasureKey: string,
371
+ ): ToggleFit {
372
+ const [fit, setFit] = React.useState<ToggleFit>('full');
373
+ const refocus = React.useRef(false);
374
+
375
+ React.useLayoutEffect(() => {
376
+ // Full <-> Icon swaps the element; keep the focus on the toggle across it — also when
377
+ // the check is switched off (below SM), which drops an Icon toggle back to Full.
378
+ const step = (next: ToggleFit) =>
379
+ setFit((current) => {
380
+ if (current !== next && toggleRef.current != null && document.activeElement === toggleRef.current) refocus.current = true;
381
+ return next;
382
+ });
383
+ const header = headerRef.current;
384
+ const heading = headingRef.current;
385
+ const probe = probeRef.current;
386
+ if (!enabled || !header || !heading || !probe) {
387
+ step('full');
388
+ return undefined;
389
+ }
390
+ let active = true;
391
+ const measure = () => {
392
+ if (!active) return;
393
+ const row = header.clientWidth;
394
+ if (row === 0) return;
395
+ const { flex, width } = heading.style;
396
+ heading.style.flex = 'none';
397
+ heading.style.width = 'max-content';
398
+ const headingWidth = heading.getBoundingClientRect().width;
399
+ heading.style.flex = flex;
400
+ heading.style.width = width;
401
+ const room = row - headingWidth - (Number.parseFloat(getComputedStyle(header).columnGap) || 0);
402
+ const full = probe.getBoundingClientRect().width;
403
+ const noun = probe.querySelector('[data-noun]')?.getBoundingClientRect().width ?? 0;
404
+ const next: ToggleFit = full <= room + FIT_TOLERANCE ? 'full' : full - noun <= room + FIT_TOLERANCE ? 'short' : 'icon';
405
+ step(next);
406
+ };
407
+ measure();
408
+
409
+ const resizeObserver = typeof ResizeObserver === 'undefined' ? null : new ResizeObserver(measure);
410
+ resizeObserver?.observe(header);
411
+ resizeObserver?.observe(probe);
412
+ if (typeof document !== 'undefined') document.fonts?.ready.then(measure).catch(() => {});
413
+
414
+ return () => {
415
+ active = false;
416
+ resizeObserver?.disconnect();
417
+ };
418
+ }, [enabled, headerRef, headingRef, probeRef, toggleRef, remeasureKey]);
419
+
420
+ React.useLayoutEffect(() => {
421
+ if (!refocus.current) return;
422
+ refocus.current = false;
423
+ toggleRef.current?.focus();
424
+ }, [fit, toggleRef]);
425
+
426
+ // The state, not `enabled ? fit : 'full'`: the swap waits for the layout effect above
427
+ // (still before paint), which sees the focused toggle before it is replaced.
428
+ return fit;
429
+ }
430
+
431
+ const FormBlock = React.forwardRef<HTMLElement, FormBlockProps>(
432
+ (
433
+ {
434
+ surface = 'tile',
435
+ layout = 'stacked',
436
+ headless = false,
437
+ showHeader = true,
438
+ title,
439
+ description,
440
+ illustration,
441
+ headingLevel,
442
+ content: contentMode = 'grid',
443
+ collapsible = false,
444
+ toggleLabel,
445
+ open: openProp,
446
+ defaultOpen = true,
447
+ onOpenChange,
448
+ trailing,
449
+ className,
450
+ children,
451
+ onClick,
452
+ ...props
453
+ },
454
+ ref,
455
+ ) => {
456
+ const titleId = React.useId();
457
+ const toggleId = React.useId();
458
+ const contentId = React.useId();
459
+ const contentRef = React.useRef<HTMLDivElement>(null);
460
+ const headerRef = React.useRef<HTMLDivElement>(null);
461
+ const headingRef = React.useRef<HTMLDivElement>(null);
462
+ const probeRef = React.useRef<HTMLSpanElement>(null);
463
+ const toggleRef = React.useRef<HTMLButtonElement>(null);
464
+ const isBelowMd = useIsMobile('md');
465
+ const isBelowSm = useIsMobile('sm');
466
+ const [openState, setOpen] = useControllableOpen(openProp, defaultOpen, onOpenChange);
467
+ // No heading in the DOM to point at under a hidden header.
468
+ const contextValue = React.useMemo(() => (showHeader ? { titleId } : null), [showHeader, titleId]);
469
+
470
+ const open = collapsible && showHeader ? openState : true;
471
+ const room = useRoomPresence(open);
472
+ const effectiveLayout = headless || !showHeader ? 'stacked' : layout;
473
+ const slots = formBlockVariants({ surface, layout: effectiveLayout, headless });
474
+ const split = effectiveLayout === 'inline' && !isBelowMd;
475
+ const hasToggle = collapsible && showHeader && !headless && toggleLabel != null;
476
+ // The toggle steps down only in the header row from SM: at Inline MD+ it sits in the body
477
+ // row, and at Mobile the stacked header gives it the whole row (regions[header].align).
478
+ const fitEnabled = hasToggle && !split && !isBelowSm;
479
+ const fit = useToggleFit(
480
+ fitEnabled,
481
+ headerRef,
482
+ headingRef,
483
+ probeRef,
484
+ toggleRef,
485
+ `${title ?? ''}\u0000${description ?? ''}\u0000${toggleLabel?.show ?? ''}`,
486
+ );
487
+
488
+ if (headless) {
489
+ return (
490
+ <div
491
+ ref={ref as React.Ref<HTMLDivElement>}
492
+ className={cn(slots.root(), className)}
493
+ data-fods-component="form-block"
494
+ data-fods-part="root"
495
+ onClick={onClick}
496
+ {...props}
497
+ >
498
+ <div data-fods-part="content-grid" className={slots.contentGrid()}>
499
+ {children}
500
+ </div>
501
+ </div>
502
+ );
503
+ }
504
+
505
+ const label = open ? toggleLabel?.hide ?? '' : toggleLabel?.show ?? '';
506
+ const { verb, noun } = splitToggleLabel(label);
507
+ const probeLabel = splitToggleLabel(toggleLabel?.show ?? '');
508
+ const toggleProps = {
509
+ id: toggleId,
510
+ className: slots.toggle(),
511
+ 'aria-controls': contentId,
512
+ 'aria-labelledby': `${toggleId} ${titleId}`,
513
+ onClick: () => setOpen(!open),
514
+ 'data-fit': fit,
515
+ };
516
+ // One glyph that turns 180° (motion-system.md § State changes); `initial={false}` gives
517
+ // the first paint (and SSR) the current pose. It carries `data-caret` itself.
518
+ const caret = (
519
+ <MotionCaret open={open}>
520
+ <Icon name="caret-down-small" />
521
+ </MotionCaret>
522
+ );
523
+ const probeSlots = textLinkVariants({ variant: 'strong', size: 'sm', underline: 'off', hasIcon: true });
524
+ const trailingContent = hasToggle ? (
525
+ <>
526
+ {fit === 'icon' ? (
527
+ <IconButton
528
+ ref={toggleRef}
529
+ variant="tertiary"
530
+ size="lg"
531
+ icon={caret}
532
+ // Self-reference in aria-labelledby resolves to aria-label: the full label stays first.
533
+ aria-label={label}
534
+ {...toggleProps}
535
+ data-fods-part="toggle"
536
+ />
537
+ ) : (
538
+ <TextLink
539
+ ref={toggleRef as React.Ref<TextLinkElement>}
540
+ variant="strong"
541
+ size="sm"
542
+ underline="off"
543
+ trailingIcon={caret}
544
+ {...toggleProps}
545
+ data-fods-part="toggle"
546
+ >
547
+ {fit === 'short' && noun ? (
548
+ <>
549
+ {verb}
550
+ <span className="sr-only"> {noun}</span>
551
+ </>
552
+ ) : (
553
+ label
554
+ )}
555
+ </TextLink>
556
+ )}
557
+ {fitEnabled && (
558
+ // The Full step's yardstick: the `show` label at Text Link Strong sm. Its text lives in
559
+ // `content: attr()`, so it adds no text node and nothing to the accessibility tree.
560
+ <span aria-hidden className="sr-only">
561
+ <span ref={probeRef} className={cn(probeSlots.root(), 'w-max whitespace-nowrap')}>
562
+ <span className={probeSlots.label()}>
563
+ <span data-text={probeLabel.verb} className="before:content-[attr(data-text)]" />
564
+ {probeLabel.noun && (
565
+ <span data-noun data-text={` ${probeLabel.noun}`} className="whitespace-pre before:content-[attr(data-text)]" />
566
+ )}
567
+ </span>
568
+ <Icon name="caret-down-small" />
569
+ </span>
570
+ </span>
571
+ )}
572
+ </>
573
+ ) : (
574
+ trailing
575
+ );
576
+ const hasTrailing = trailingContent != null && trailingContent !== false;
577
+ const trailingNode = hasTrailing ? (
578
+ <div data-fods-part="trailing" className={slots.trailing()}>
579
+ {trailingContent}
580
+ </div>
581
+ ) : null;
582
+
583
+ const contentProps = {
584
+ ref: contentRef,
585
+ id: contentId,
586
+ hidden: room.gone,
587
+ inert: room.leaving,
588
+ initial: false,
589
+ animate: open ? 'open' : 'closed',
590
+ // The root's gap above the content folds with the room (`gapAbove`).
591
+ variants: roomVariants(room.reduce, FORM_BLOCK_REDUCED_FADE, { gapAbove: true }),
592
+ custom: contentRef,
593
+ // Clip the bottom edge only, and only while the room moves: `overflow: hidden` would
594
+ // also cut what the fields paint above and beside the element — the floating labels
595
+ // of the first row, focus rings.
596
+ onAnimationStart: () => {
597
+ if (contentRef.current) contentRef.current.style.clipPath = ROOM_BOTTOM_CLIP;
598
+ },
599
+ onAnimationComplete: (definition: unknown) => {
600
+ if (contentRef.current) contentRef.current.style.clipPath = '';
601
+ room.onAnimationComplete(definition);
602
+ },
603
+ children,
604
+ } satisfies React.ComponentProps<typeof motion.div>;
605
+ // Two literal branches so each part marker stays statically readable.
606
+ const content =
607
+ contentMode === 'stack' ? (
608
+ <motion.div data-fods-part="content-stack" className={slots.contentStack()} {...contentProps} />
609
+ ) : (
610
+ <motion.div data-fods-part="content-grid" className={slots.contentGrid()} {...contentProps} />
611
+ );
612
+
613
+ // Inline MD+: the trailing slot moves to the end of the body row (chrome.inline).
614
+ if (!showHeader) {
615
+ return (
616
+ <FormBlockContext.Provider value={contextValue}>
617
+ <section
618
+ ref={ref}
619
+ className={cn(slots.root(), className)}
620
+ data-fods-component="form-block"
621
+ data-fods-part="root"
622
+ onClick={onClick}
623
+ {...props}
624
+ aria-label={title}
625
+ >
626
+ {content}
627
+ </section>
628
+ </FormBlockContext.Provider>
629
+ );
630
+ }
631
+
632
+ return (
633
+ <FormBlockContext.Provider value={contextValue}>
634
+ <section
635
+ ref={ref}
636
+ className={cn(slots.root(), className)}
637
+ data-fods-component="form-block"
638
+ data-fods-part="root"
639
+ {...props}
640
+ aria-labelledby={titleId}
641
+ onClick={(event) => {
642
+ onClick?.(event);
643
+ // spec § States: a closed block opens on a click anywhere on the tile; the toggle
644
+ // stays the only tab stop and the only control in the accessibility tree.
645
+ if (hasToggle && !open && !event.defaultPrevented && !toggleRef.current?.contains(event.target as Node)) {
646
+ setOpen(true);
647
+ }
648
+ }}
649
+ >
650
+ <div ref={headerRef} data-fods-part="header" className={slots.header()}>
651
+ <HeadingGroup
652
+ ref={headingRef}
653
+ className={slots.heading()}
654
+ size="h3"
655
+ level={headingLevel ?? 2}
656
+ heading={title}
657
+ description={description}
658
+ headingId={titleId}
659
+ illustration={illustration}
660
+ picture={isBelowSm ? 40 : 48}
661
+ />
662
+ {!split && trailingNode}
663
+ </div>
664
+ {effectiveLayout === 'inline' ? (
665
+ <div className={slots.body()}>
666
+ {content}
667
+ {split && trailingNode}
668
+ </div>
669
+ ) : (
670
+ content
671
+ )}
672
+ </section>
673
+ </FormBlockContext.Provider>
674
+ );
675
+ },
676
+ );
677
+ FormBlock.displayName = 'FormBlock';
678
+
679
+ export { FormBlock, formBlockVariants };
@@ -0,0 +1,13 @@
1
+ export {
2
+ FormBlock,
3
+ useFormBlockCloseMs,
4
+ useFormBlock,
5
+ type FormBlockContextValue,
6
+ formBlockVariants,
7
+ type FormBlockProps,
8
+ type FormBlockContent,
9
+ type FormBlockLayout,
10
+ type FormBlockHeadingLevel,
11
+ type FormBlockSurface,
12
+ type FormBlockToggleLabel,
13
+ } from './FormBlock';