@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,518 @@
1
+ import { Meta, Canvas, Controls } from '@storybook/addon-docs/blocks';
2
+ import * as FormActionsStories from './FormActions.stories';
3
+
4
+ <Meta of={FormActionsStories} tags={['autodocs']} />
5
+
6
+ # FormActions
7
+
8
+ ## Metadata
9
+
10
+ - **Layer:** organism
11
+ - **Kind:** region
12
+ - **Status:** draft
13
+ - **Tokens used:** `--bg-edge-shadow`, `--bg-primary`, `--border-width-100`, `--radius-700`, `--space-1000`, `--space-500`, `--space-600`, `--space-800`, `--z-index-dropdown`
14
+ - **Manifest version:** `2.1.2`
15
+ - **Composes:** nothing of its own — the slot holds the form's [Button](?path=/docs/design-system-atoms-button--docs), [IconButton](?path=/docs/design-system-atoms-iconbutton--docs) and [TextLink](?path=/docs/design-system-atoms-textlink--docs) actions; the manifest's Fade Overlay is realised as an edge band of the bar's own (see Anatomy)
16
+
17
+ The token list above covers the bar's own classes; the
18
+ actions in the slot bring their own atoms' tokens.
19
+
20
+ ## Overview
21
+
22
+ **FormActions** is the sticky actions bar that closes a form page: one slot the form fills with its
23
+ own actions, laid out in one row or two rows per breakpoint, the Brand primary last.
24
+
25
+ The bar owns sticking and floating, the padding and gaps, and the one-row / two-row layout. The form
26
+ owns everything about each action: which actions exist, element types, labels, icons, handlers,
27
+ loading and disabled state, the commit lock and any per-breakpoint restyling.
28
+
29
+ Render it **once per form page**, as the last element after the last Form Block, inside the page
30
+ `<form>`. Do **not** use it as a Sticky Context Bar, as a generic toolbar, or inside a Form Block.
31
+
32
+ ## Rationale
33
+
34
+ Every form page ends with commit actions, and one element in flow after the last block keeps them
35
+ reachable by sticking to the viewport bottom while the form continues below. The bar owns only
36
+ position and layout, so each form keeps its own action set while every form page lays it out the same
37
+ way. The row switch follows the page breakpoint the form names with `stackBelow`, so the layout at a
38
+ given viewport is known before render. A form whose actions may not fit one row above that breakpoint
39
+ turns on `stackOnOverflow`: the bar then also stacks when its one-row content does not fit, so a narrow
40
+ column or a longer locale never wraps at a random action (`chrome.layout.stack-on-overflow`, see
41
+ Variants → Overflow).
42
+
43
+ ## Anatomy
44
+
45
+ The component renders two siblings: the **root** (the sticky box) and, directly after it, the
46
+ **sentinel**. Inside the root sit the edge band and the painted bar, in that order; the bar holds the
47
+ children exactly as given.
48
+
49
+ <table>
50
+ <thead>
51
+ <tr><th>Part</th><th>Element</th><th>Role</th><th>Tokens</th></tr>
52
+ </thead>
53
+ <tbody>
54
+ <tr>
55
+ <td><code>root</code></td><td><code>&lt;div&gt;</code></td>
56
+ <td>An <strong>unpainted</strong> positioning box: <code>position: sticky; bottom: 0</code>, <code>w-full</code> capped at <code>--ds-content-wide</code> (<code>max-w-content-wide</code>). No landmark role. Carries <code>data-fods-component="form-actions"</code> and, while floating, <code>data-floating</code>. On a viewport <code>max-height: 480px</code> it is <code>position: static</code>. Receives <code>className</code>, every other HTML attribute and the <code>ref</code>.</td>
57
+ <td>stacking one step below <code>--z-index-dropdown</code> (deviation, see States); floating footprint <code>--space-800</code>, <code>--space-600</code></td>
58
+ </tr>
59
+ <tr>
60
+ <td><code>edge-shadow</code></td><td><code>&lt;div aria-hidden&gt;</code></td>
61
+ <td>The edge band above the floating bar: absolutely positioned, full width, <code>pointer-events: none</code>, <code>display: none</code> unless the root carries <code>data-floating</code>. Its height is <code>--space-1000 + --radius-700</code> and its bottom edge sits <code>--radius-700</code> below the root's top, so the band runs on under the bar's top corners. A vertical gradient from <code>--bg-edge-shadow</code> at zero alpha to the full token at the bar.</td>
62
+ <td><code>--bg-edge-shadow</code>; <code>--space-1000</code>, <code>--radius-700</code></td>
63
+ </tr>
64
+ <tr>
65
+ <td><code>bar</code></td><td><code>&lt;div&gt;</code></td>
66
+ <td>The painted surface and the <code>actions</code> slot: the children, rendered as given. A sibling of the band after it in tree order, so it paints over the band's tucked end (a sticky root opens a stacking context, so the surface cannot be the root). A transparent <code>--border-width-100</code> border on all sides. A wrapping flex row — layout under Variants. With <code>stackOnOverflow</code>, carries <code>data-stacked</code> while its one-row content does not fit (Variants → Overflow).</td>
67
+ <td>fill <code>--bg-primary</code>; radius <code>--radius-700</code>; gap <code>--space-500</code>; padding → Sizes; floating → States</td>
68
+ </tr>
69
+ <tr>
70
+ <td><code>spacer</code></td><td><code>&lt;span aria-hidden="true"&gt;</code></td>
71
+ <td><code>FormActions.Spacer</code> — optional, at most one per bar. Empty, <code>flex: 1 1 0</code>: in one row it takes the free space, so the children before it sit at the start and the children after it at the end. <code>display: none</code> in two rows.</td>
72
+ <td>—</td>
73
+ </tr>
74
+ <tr>
75
+ <td><code>sentinel</code></td><td><code>&lt;div aria-hidden&gt;</code></td>
76
+ <td>Zero height, rendered directly after the root (outside it). The floating detection watches it. Decorative.</td>
77
+ <td>—</td>
78
+ </tr>
79
+ </tbody>
80
+ </table>
81
+
82
+ The actions themselves are not parts of the bar. They keep their own atoms' markers
83
+ (`data-fods-component="button"` and so on).
84
+
85
+ ## Variants
86
+
87
+ No variant prop. The manifest's two axes are both resolved without one: **Breakpoint** is the viewport
88
+ (see Sizes) and **Layout** (One row · Two rows) follows from `stackBelow` and the viewport. XL and LG
89
+ are One row only, MD and SM both, Mobile Two rows only — 7 variants. The Matrix frames each one at its
90
+ real viewport width, with the recipe that uses that layout there; SM One row is the back-link recipe with
91
+ `stackBelow="sm"`.
92
+
93
+ <Canvas of={FormActionsStories.Matrix} />
94
+
95
+ <table>
96
+ <thead>
97
+ <tr><th>Layout</th><th>How the children sit</th><th>Classes on the bar</th></tr>
98
+ </thead>
99
+ <tbody>
100
+ <tr>
101
+ <td>One row</td>
102
+ <td>All children on one row, end-aligned; each action hugs its label. The spacer takes the free space, so the children before it sit at the start; without a spacer every action sits at the end.</td>
103
+ <td><code>flex flex-wrap items-center justify-end gap-500</code></td>
104
+ </tr>
105
+ <tr>
106
+ <td>Two rows</td>
107
+ <td>The last child (the primary) alone on the second row at full width. The spacer is hidden. Every other action on the first row, and the last action before the primary fills the remaining width — the spacer never counts, so in back, spacer, primary the back action fills.</td>
108
+ <td>below the <code>stackBelow</code> breakpoint (<code>max-lg:</code> / <code>max-md:</code> / <code>max-sm:</code>) and, above it, while the bar carries <code>data-stacked</code> (<code>stackOnOverflow</code> only) (<code>data-stacked:not-data-measuring:</code>): <code>[&amp;&gt;:last-child]:basis-full</code>, <code>[&amp;&gt;[data-fods-part=spacer]]:hidden</code>, <code>flex-1 min-w-0</code> on <code>:nth-last-child(2)</code> unless it is the spacer, else on <code>:nth-last-child(3)</code> when the spacer follows it</td>
109
+ </tr>
110
+ </tbody>
111
+ </table>
112
+
113
+ <table>
114
+ <thead>
115
+ <tr><th><code>stackBelow</code></th><th>Two rows at</th><th>Use when</th></tr>
116
+ </thead>
117
+ <tbody>
118
+ <tr><td><code>'lg'</code></td><td>MD, SM, Mobile</td><td>the one-row set does not fit at MD (the two-commits recipe)</td></tr>
119
+ <tr><td><code>'md'</code> (default)</td><td>SM, Mobile</td><td>the one-row set fits down to MD (the back-link recipe)</td></tr>
120
+ <tr><td><code>'sm'</code></td><td>Mobile</td><td>the one-row set fits down to SM</td></tr>
121
+ </tbody>
122
+ </table>
123
+
124
+ - **One DOM tree, never re-ordered.** The bar renders the children as given at every breakpoint and
125
+ uses no CSS `order`: DOM order = visual order = Tab order, the primary last.
126
+ - **The breakpoint is the floor, overflow stacks above it.** Below the `stackBelow` breakpoint the
127
+ switch is the viewport media query alone, nothing is measured; Mobile is two rows for every value.
128
+ From the breakpoint up the bar is one row; with `stackOnOverflow` it is two rows whenever the
129
+ children do not fit one row — see Overflow below.
130
+
131
+ ### Overflow
132
+
133
+ <Canvas of={FormActionsStories.Overflow} />
134
+
135
+ **`stackOnOverflow`** (`chrome.layout.stack-on-overflow`, manifest 2.1.0; the re-measure triggers
136
+ named in 2.1.1). The page Breakpoint itself is never an overflow measurement — only the Layout axis
137
+ (rows) follows one, and only with this prop. With the breakpoint alone, a one-row set that does not fit the bar — a column narrower than the viewport, the
138
+ docs canvas, longer labels in another locale, a width just above the breakpoint — wraps the flex row
139
+ wherever the last item overflows, typically the primary alone at the end of a second row. With the
140
+ opt-in boolean `stackOnOverflow` the bar keeps `stackBelow` as the floor and, above it, lays out the same
141
+ Two rows when one row does not fit. It is off by default: the measurement keeps two observers on the bar
142
+ for its whole life, which a bar whose one row always fits (the back-link recipe: a back link and one button) does not
143
+ need. The two-commits stories turn it on, the back-link stories do not; the third bar of the Overflow story
144
+ shows long labels without it.
145
+
146
+ Mechanism (`internal/useOneRowOverflow.ts`; with `stackOnOverflow` off it attaches no observer, no
147
+ fonts listener and no media query subscription, and `data-stacked` is never set):
148
+
149
+ 1. The bar gets `data-measuring` for one synchronous measurement: the one-row probe layout
150
+ (`flex-nowrap`, `justify-start`, every child `shrink-0`) with the `data-stacked` rules switched off.
151
+ One row does not fit when its last child ends past the bar's content box (not `scrollWidth`: Chrome
152
+ leaves the inline-end padding out of it, so a row running only into the padding read as fitting). The attribute is removed
153
+ in the same task, so the probe layout is never painted, and the answer does not depend on the layout
154
+ currently shown, so it cannot oscillate.
155
+ 2. The result sets `data-stacked` on the bar, which applies the Two rows rules under
156
+ `data-stacked:not-data-measuring:` — the same six rules as under the breakpoint prefix.
157
+ 3. It re-measures on a size change of the bar (`ResizeObserver` — a narrower column, a 200 % zoom),
158
+ on any change inside it — children, text, attributes of the actions such as a new label, a locale
159
+ switch or Loading (`MutationObserver`; the bar's own `data-measuring` and `data-stacked` are
160
+ ignored) — and once web fonts are ready (`document.fonts.ready`), never only at mount. Two rows
161
+ reached this way at XL and LG use the MD Two-rows geometry (no separate Figma variant).
162
+ 4. Nothing is measured while the `stackBelow` media query matches. Without JavaScript, and on the
163
+ server, only the breakpoint switch applies.
164
+
165
+ ### Recipes
166
+
167
+ The two recipes of the manifest (`chrome.recipes`) are compositions of the slot, not variants. Each
168
+ restyles **one element per action** with CSS — the stories build them that way.
169
+
170
+ <Canvas of={FormActionsStories.RecipeTwoCommits} />
171
+
172
+ **Preview and two commits** (`chrome.recipes.faktura`) — `stackBelow="lg"`, `stackOnOverflow`: preview · spacer · «Uložit návrh» · «Vystavit a odeslat»
173
+ (`value="send"`) · «Vystavit a stáhnout» (Brand, `value="download"`). Preview is the Secondary Button
174
+ with a transparent border from LG — the Tertiary look, since Button's Tertiary differs from Secondary by
175
+ that border alone — and reads «Náhled» at SM through a second `aria-hidden` span. At Mobile preview
176
+ and save take Icon Button lg geometry (width 44, no inline padding, no gap) with the label
177
+ visually hidden and the full label as `aria-label`; the secondary reads «Odeslat» through a second
178
+ `aria-hidden` span while its full label stays as visually hidden text.
179
+
180
+ <Canvas of={FormActionsStories.RecipeBackLink} />
181
+
182
+ **Back link and one commit** (`chrome.recipes.vydaj`) — `stackBelow="md"`: back link · spacer · «Uložit výdaj» (Brand, `value="save"`). The back
183
+ action is one `<a href>`: the Button Secondary lg recipe below MD (where the bar fills it across row 1),
184
+ the Text Link Strong md look, Underline=Off, from MD, with a centred `::before` hit zone of at least
185
+ `--space-1000 + 2 × --space-100` each way and a 3 px focus offset.
186
+
187
+ ## Sizes
188
+
189
+ **There is no size axis.** Breakpoint is the size dimension and it is **not a prop**: padding follows
190
+ the viewport media queries (Mobile unprefixed, SM and up `sm:`), and the rows follow `stackBelow`. The
191
+ Breakpoint stories pin the viewport to each band minimum (1280 / 1024 / 768 / 640) and the 390 Mobile
192
+ canvas — see the Matrix above, or open e.g. `Breakpoint · Mobile` and use the toolbar viewports.
193
+
194
+ <table>
195
+ <thead>
196
+ <tr>
197
+ <th>Breakpoint</th>
198
+ <th>Viewport</th>
199
+ <th>Docked padding (block / inline)</th>
200
+ <th>Layout</th>
201
+ </tr>
202
+ </thead>
203
+ <tbody>
204
+ <tr><td>XL</td><td>≥ 1280</td><td><code>--space-800</code> / <code>--space-800</code></td><td>One row</td></tr>
205
+ <tr><td>LG</td><td>1024–1279</td><td><code>--space-800</code> / <code>--space-800</code></td><td>One row</td></tr>
206
+ <tr><td>MD</td><td>768–1023</td><td><code>--space-800</code> / <code>--space-800</code></td><td>One row · Two rows (<code>stackBelow="lg"</code>)</td></tr>
207
+ <tr><td>SM</td><td>640–767</td><td><code>--space-800</code> / <code>--space-800</code></td><td>One row (<code>stackBelow="sm"</code>) · Two rows</td></tr>
208
+ <tr><td>Mobile</td><td>below 640</td><td><code>--space-800</code> / <code>--space-600</code></td><td>Two rows</td></tr>
209
+ </tbody>
210
+ </table>
211
+
212
+ - Row gap and action gap are one step, `--space-500`, in both directions.
213
+ - Below MD the bar runs full-bleed and its inline padding stands in for the page side gutter. The
214
+ stories model the page (`--bg-secondary`, the gutter from MD) with a decorator; the gutter belongs to
215
+ the page, not the bar.
216
+ - The bar sets no height. The manifest's `chrome.measurements` give the resulting bar heights with
217
+ Size lg (44) actions — docked 92 (one row) / 148 (two rows), floating 76 / 132 — as outcomes of
218
+ padding, rows and gaps. The rendered bar is **2 px taller** than each of them because of the
219
+ transparent `--border-width-100` border on all sides that forced colors paint (Accessibility →
220
+ Contrast); the manifest's arithmetic leaves the border out. They are not measured on this page.
221
+
222
+ ## States
223
+
224
+ FormActions has **no state axis** (manifest `intent.states`). Hover, focus, pressed, disabled and
225
+ loading are the composed actions' own, set by the form. The bar adds one behaviour: docked / floating.
226
+
227
+ ### Pending (set by the form)
228
+
229
+ <Canvas of={FormActionsStories.Pending} />
230
+
231
+ While one commit runs, the form renders it as Button `loading` (spinner, `aria-busy`, clicks
232
+ suppressed) and sets `aria-disabled="true"` on the other commit until it clears; the stories' form also
233
+ ignores a submit whose submitter is `aria-disabled`. The bar has no prop for any of it. In the recipe
234
+ stories a click on a commit runs it for a moment.
235
+
236
+ ### Docked / floating
237
+
238
+ <Canvas of={FormActionsStories.FloatingStatic} />
239
+
240
+ `Floating (static)` pins `data-floating` on the second bar of each pair so the floating look renders
241
+ without scrolling. The live behaviour is in the
242
+ [Floating demo](?path=/story/design-system-organisms-form-actions--floating-demo) story: four Form
243
+ Blocks, then the bar — scroll the canvas.
244
+
245
+ <table>
246
+ <thead>
247
+ <tr><th></th><th>Docked</th><th>Floating (<code>data-floating</code>)</th></tr>
248
+ </thead>
249
+ <tbody>
250
+ <tr><td>Corners</td><td><code>--radius-700</code> on all four</td><td>top <code>--radius-700</code>, bottom 0</td></tr>
251
+ <tr><td>Padding-block</td><td><code>--space-800</code></td><td><code>--space-600</code></td></tr>
252
+ <tr><td>Padding-inline, actions, layout</td><td>per Sizes</td><td>unchanged</td></tr>
253
+ <tr><td>Border (<code>--border-width-100</code>)</td><td>transparent</td><td><code>--outline-default</code></td></tr>
254
+ <tr><td>Edge band above the bar</td><td><code>display: none</code></td><td>shown</td></tr>
255
+ </tbody>
256
+ </table>
257
+
258
+ **Mechanism** (`useFloatingBar`):
259
+
260
+ 1. An `IntersectionObserver` with `rootMargin` `0px 0px 16px 0px` watches the sentinel. The bar is
261
+ floating while the sentinel is outside the viewport and docked while it intersects; scrolling back
262
+ up floats it again.
263
+ 2. **Deviation from `delivery.react`:** the contract says the 16 px `rootMargin` alone keeps the switch
264
+ from oscillating. It cannot. The bar is in flow, so when it floats and loses
265
+ 2 × (`--space-800` − `--space-600`) of padding-block, the sentinel after it moves up by the same
266
+ amount, and for any rootMargin there is a scroll band where the docked layout says "float" and the
267
+ floating layout says "dock" — `data-floating` would flip every frame. While floating, the root
268
+ therefore carries a compensating `margin-bottom` of exactly that difference: the in-flow footprint
269
+ never changes and the sentinel never moves. Sticky `bottom: 0` places the border box, so the margin
270
+ does not lift the painted bar off the viewport bottom.
271
+ 3. While floating, the page scroller (`document.documentElement`) gets `scroll-padding-bottom` equal to
272
+ the bar's current height, kept in sync by a `ResizeObserver`. Several bars share one registry: the
273
+ tallest floating bar wins, and the previous inline value is restored only when the last of them
274
+ docks or unmounts.
275
+ 4. On a viewport `max-height: 480px` no observer is attached, `data-floating` is never set and the root
276
+ is `position: static`.
277
+
278
+ The switch between docked and floating has no transition of its own — and that is the contract, not an omission:
279
+ manifest 2.1.2 `motion.none` makes it „instant by design — border, corners, padding-block and the Edge shadow swap with
280
+ no transition, so the bar never moves under the pointer". The actions carry their own motion (`inherits: [button,
281
+ icon-button, text-link]` — hover over `--duration-hover`, press over `--duration-press`).
282
+
283
+ **Stacking.** The root sits one step below `--z-index-dropdown`, not at `--z-index-sticky` (which is
284
+ above it): a Select, Combobox or Date Picker panel opened from a field near the viewport bottom must
285
+ paint over the floating bar, not under it.
286
+
287
+ **Known limitation — the sentinel is a sibling.** The zero-height sentinel renders after the root, not
288
+ inside it. In a flex or grid parent with a `gap` (or under `space-y-*`) it is an item of its own: it
289
+ adds one extra gap below the bar, and it sits that gap further from the bar than the switch assumes.
290
+ For the last gap's worth of scroll before the bar docks, the bar is already back in its in-flow place
291
+ — up to one gap above the viewport bottom — but still wears the floating look (square bottom corners,
292
+ border, edge band). The Floating demo shows it: its form is a flex column with `gap-800`. Render the bar
293
+ as the last child of a parent without a gap to avoid it.
294
+
295
+ ## API
296
+
297
+ <Controls of={FormActionsStories.Playground} />
298
+
299
+ The Controls table drives the Playground; `content` is a story-only arg that picks the slot content
300
+ (a neutral sample, one of the recipes, or the sample with long labels).
301
+
302
+ - **`children`** (`ReactNode`, required) — the form's action elements in reading order, the Brand
303
+ primary last, optionally one `<FormActions.Spacer />`. Rendered as given, never re-ordered.
304
+ - **`stackBelow`** (`'lg' | 'md' | 'sm'`, default `'md'`) — two rows below this breakpoint, one row
305
+ from it up. Type `FormActionsStackBelow`.
306
+ - **`stackOnOverflow`** (`boolean`, default `false`) — two rows also above `stackBelow` when the one
307
+ row does not fit the bar (`data-stacked`; Variants → Overflow). Turn it on for bars with many or
308
+ long-labelled actions.
309
+ - Every other `<div>` attribute (including `className`) goes to the root; `ref` points to the root
310
+ (`forwardRef`). `data-floating` (root) and `data-stacked` (bar) are owned by the component.
311
+ - **`FormActions.Spacer`** — no props; an empty `aria-hidden` `<span>` with `flex: 1 1 0`. At most one
312
+ per bar.
313
+
314
+ Also exported: `formActionsVariants` (the `tv` recipe) and the types `FormActionsProps`,
315
+ `FormActionsStackBelow`.
316
+
317
+ **What the form sets on the children** (the bar has no props for any of it):
318
+
319
+ - **Element types.** Commit actions are `type="submit"` with `name="intent"` and a value the page reads
320
+ from `SubmitEvent.submitter` (`send` · `download` in the two-commits recipe, `save` in the back-link recipe); preview and save are
321
+ `type="button"`; back is an `<a href>`.
322
+ - **Commit lock.** The running commit is Button `loading`; the other commits carry `aria-disabled`
323
+ until it clears.
324
+ - **Per-breakpoint restyling.** One element per action: Icon Button geometry with the full label as
325
+ `aria-label`, a short label in a second `aria-hidden` span, Text Link ↔ Button — never a different
326
+ element per breakpoint.
327
+ - **No implicit submission.** The form cancels it, so Enter in a text field never commits. The stories'
328
+ form calls `useNoImplicitSubmit` (`internal/useNoImplicitSubmit.ts`) with a
329
+ ref to the `<form>`: it listens for `keydown` on the form's document (bubble phase, filtered to
330
+ targets inside that form) and cancels the default of Enter on a text-like `<input>` — `text`,
331
+ `search`, `url`, `tel`, `email`, `password`, `number`. Every other input type, textareas, buttons,
332
+ IME composition and an Enter a field has already prevented are left alone.
333
+
334
+ ## Do / Don't
335
+
336
+ - ✅ Render the bar once, in flow after the last Form Block, inside the page `<form>`.
337
+ - ✅ Pass the actions as children in reading order, the Brand primary last.
338
+ - ✅ Keep exactly one Brand primary.
339
+ - ✅ Name the row switch with `stackBelow`.
340
+ - ✅ Turn on `stackOnOverflow` for a bar whose actions may not fit one row above `stackBelow` — many actions, long labels, other locales, a narrow column.
341
+ - ✅ Use at most one `<FormActions.Spacer />`, between the quiet actions and the commit cluster.
342
+ - ✅ Restyle one element per action across breakpoints; an icon-only action keeps the full label as `aria-label`.
343
+ - ✅ Lock the other commits with `aria-disabled` while one runs.
344
+ - ✅ Let the page own the gap above the bar.
345
+ - ❌ Don't render a fixed bar plus a static copy at the end of the form.
346
+ - ❌ Don't re-order children with CSS so Tab order and visual order part.
347
+ - ❌ Don't add a second Brand or filled button, or put the primary anywhere but last.
348
+ - ❌ Don't add a Breakpoint prop.
349
+ - ❌ Don't turn on `stackOnOverflow` for a bar whose one row always fits — it keeps two observers running for nothing.
350
+ - ❌ Don't add a second spacer or a third row.
351
+ - ❌ Don't render a different element per breakpoint, fold actions into a «…» menu, or use `title` as the accessible name.
352
+ - ❌ Don't add a top margin, a cast shadow or `overflow: hidden` to the bar.
353
+
354
+ ## Accessibility
355
+
356
+ - **Semantics** — the root is a `<div>` with no landmark role and no `aria-label`; the bar adds no role
357
+ around the children, so the actions are read as ordinary controls of the form. The edge band, the
358
+ spacer and the sentinel are `aria-hidden`. The actions' semantics are the form's: in the recipes,
359
+ commits are native `<button type="submit">`, preview and save `<button type="button">`, the back
360
+ action an `<a href>` at every breakpoint.
361
+ - **Keyboard** — DOM order = visual order = Tab order in both layouts: the bar never re-orders its
362
+ children, so the primary, as the last child, is reached last. Docked and floating do not change the
363
+ order. Enter in a text field does not commit once the form cancels implicit submission (see API).
364
+ - **ARIA / names** — set by the form. In the two-commits recipe preview and save carry `aria-label` with the
365
+ full label («Náhled dokladu», «Uložit návrh») at every breakpoint, so at Mobile the icon-only button
366
+ is named by it and at SM the name contains the visible short «Náhled». The secondary has no
367
+ `aria-label`: its full label stays as visually hidden text at Mobile while the visible «Odeslat» is
368
+ `aria-hidden`. Loading is `aria-busy`; the locked commit carries `aria-disabled="true"`.
369
+ - **Focus** — the actions draw their own `:focus-visible` rings. The bar does not clip, so rings paint in
370
+ full. While floating, the page scroller's `scroll-padding-bottom` reserves the bar's height so a
371
+ focused field is not scrolled in under it.
372
+ - **Target** — the recipes use Button size `lg` (min height 44; the Mobile icon-only ones also width 44);
373
+ the back link from MD gets a centred hit zone of at least `--space-1000 + 2 × --space-100` each
374
+ way.
375
+ - **Contrast & motion** — the bar has no visible border while docked; it is separated by surface
376
+ (`--bg-primary` on `--bg-secondary`). Under forced colors the surface change vanishes, so the bar
377
+ carries a transparent `--border-width-100` border that forced colors paint. The bar adds no motion of
378
+ its own (manifest `motion.none`; the docked ↔ floating switch is instant by design, see States).
379
+
380
+ Accessibility floor for every FODS component: `spec/01-foundations/accessibility.md`.
381
+
382
+ ## Copy
383
+
384
+ Voice: action wording follows the [Button](?path=/docs/design-system-atoms-button--docs) copy rules
385
+ — verb-first infinitive, sentence case, consistent terminology; a back link follows the
386
+ [TextLink](?path=/docs/design-system-atoms-textlink--docs) copy rules. The bar sets no text of its own:
387
+ every label is set by the form on its child actions. Examples are Czech; the rules hold for every
388
+ language.
389
+
390
+ - **Action label** (`action-label`) — the visible label of a Button in the bar, passed as the action's
391
+ children. One line; it truncates only if a localized label outgrows a full-width Button. Max 24
392
+ characters — guidance, not an enforced limit, because label length varies by language. The form
393
+ picks labels that fit its layout at each breakpoint; a label shortens only where the recipe says
394
+ so, and the short form keeps the verb.
395
+ - **Accessible name** (`accessible-name`) — not rendered: the `aria-label` of an action shown as an
396
+ Icon Button at a narrow breakpoint. It is the full label the action shows at the wider breakpoints,
397
+ never a shortened form: ✅ `aria-label="Náhled dokladu"` ❌ `aria-label="Náhled"`.
398
+ - **Back link** — a destination, verb-first («Zpět na …»), sentence case, no terminal period:
399
+ ✅ «Zpět na seznam výdajů» ❌ «Zpět» · «Klikněte zde».
400
+
401
+ The recipes' labels:
402
+
403
+ <table>
404
+ <thead>
405
+ <tr><th>Recipe</th><th>Action</th><th>Label</th><th>Icon</th></tr>
406
+ </thead>
407
+ <tbody>
408
+ <tr><td>Two commits</td><td>preview</td><td>«Náhled dokladu» («Náhled» at SM)</td><td><code>eye</code></td></tr>
409
+ <tr><td>Two commits</td><td>save</td><td>«Uložit návrh»</td><td><code>floppy-disk</code></td></tr>
410
+ <tr><td>Two commits</td><td>secondary</td><td>«Vystavit a odeslat» («Odeslat» at Mobile)</td><td><code>paper-plane-tilt</code></td></tr>
411
+ <tr><td>Two commits</td><td>primary</td><td>«Vystavit a stáhnout»</td><td><code>download-simple</code></td></tr>
412
+ <tr><td>Back link</td><td>back</td><td>«Zpět na seznam výdajů»</td><td><code>arrow-left</code></td></tr>
413
+ <tr><td>Back link</td><td>primary</td><td>«Uložit výdaj»</td><td><code>floppy-disk</code></td></tr>
414
+ </tbody>
415
+ </table>
416
+
417
+ - **The two invoice commits are a deliberate exception** to the Button rule of one action per button.
418
+ «Vystavit a odeslat» and «Vystavit a stáhnout» are each a single commit of the invoice, and the
419
+ second verb names its delivery: sent by e-mail or downloaded. Keep both labels as written:
420
+ ✅ «Vystavit a odeslat» ❌ «Odeslat» at XL.
421
+ - **Two abbreviations only.** «Náhled» at SM and «Odeslat» at Mobile, both in the two-commits recipe,
422
+ are the only per-breakpoint label changes; no other recipe label shortens at any breakpoint:
423
+ ✅ «Odeslat» at Mobile ❌ «Uložit» for «Uložit návrh» at SM.
424
+
425
+ ## Usage
426
+
427
+ ```tsx
428
+ import { Button, FormActions, Icon } from '@invoiceonline/ui-react';
429
+
430
+ // The two-commits recipe — stackBelow="lg"
431
+ <form ref={formRef} onSubmit={handleSubmit}>
432
+ …
433
+ <FormActions stackBelow="lg" stackOnOverflow>
434
+ <Button type="button" variant="secondary" size="lg" leadingIcon={<Icon name="eye" />} aria-label="Náhled dokladu" onClick={openPreview}>
435
+ Náhled dokladu
436
+ </Button>
437
+ <FormActions.Spacer />
438
+ <Button type="button" variant="secondary" size="lg" leadingIcon={<Icon name="floppy-disk" />} aria-label="Uložit návrh" onClick={saveDraft}>
439
+ Uložit návrh
440
+ </Button>
441
+ <Button type="submit" name="intent" value="send" variant="secondary" size="lg" loading={pending === 'send'} aria-disabled={pending === 'download' || undefined}>
442
+ Vystavit a odeslat
443
+ </Button>
444
+ <Button type="submit" name="intent" value="download" variant="brand" size="lg" loading={pending === 'download'} aria-disabled={pending === 'send' || undefined}>
445
+ Vystavit a stáhnout
446
+ </Button>
447
+ </FormActions>
448
+ </form>
449
+
450
+ // The back-link recipe — stackBelow defaults to "md"
451
+ <FormActions>
452
+ <a href="#">Zpět na seznam výdajů</a>
453
+ <FormActions.Spacer />
454
+ <Button type="submit" name="intent" value="save" variant="brand" size="lg">Uložit výdaj</Button>
455
+ </FormActions>
456
+ ```
457
+
458
+ The per-breakpoint restyling of the recipes (icon-only at Mobile, the short labels, the back link's
459
+ Text Link ↔ Button classes) is in `FormActions.stories.tsx` (`TwoCommitsActions`, `BackLinkActions`).
460
+
461
+ Don't:
462
+
463
+ ```tsx
464
+ // Outside the page form: the commits submit nothing.
465
+ <form>…</form>
466
+ <FormActions>…</FormActions>
467
+
468
+ // A different element per breakpoint instead of one element restyled.
469
+ <FormActions>
470
+ {isMobile ? <IconButton aria-label="Náhled dokladu" … /> : <Button …>Náhled dokladu</Button>}
471
+ …
472
+ </FormActions>
473
+ ```
474
+
475
+ ## Related
476
+
477
+ - [Button](?path=/docs/design-system-atoms-button--docs) — every Button action in the recipes; the
478
+ back link is built on its recipe.
479
+ - [IconButton](?path=/docs/design-system-atoms-iconbutton--docs) — the manifest's Mobile preview /
480
+ save; the recipe reproduces it as Button geometry so it stays one `<button>`.
481
+ - [TextLink](?path=/docs/design-system-atoms-textlink--docs) — the back link's look from MD.
482
+ - [FormBlock](?path=/docs/design-system-organisms-form-block--docs) — the tiles above the bar; same
483
+ surface and corner radius.
484
+ - [FormSection](?path=/docs/design-system-organisms-form-section--docs) — the groups of fields inside
485
+ the blocks.
486
+ - Spec: `spec/05-organisms/form-actions.md`
487
+ (patterns: `form-layout.md` § Form Actions placement, `scrollbar.md` § The edge band, `focus-ring.md`).
488
+
489
+ ## Migration notes
490
+
491
+ **Motion (manifest 2.1.2, 2026-11-03) — documentation only.** The motion audit declares the bar static and the docked ↔
492
+ floating switch instant by design, which is what the bar already did. No code change.
493
+
494
+ From the upstream spec's Migration notes: Form Actions 2.0.0 replaces the fixed per-Document action
495
+ sets of 1.x with one slot the form fills.
496
+
497
+ <table>
498
+ <thead>
499
+ <tr><th></th><th>1.x</th><th>2.0.0</th></tr>
500
+ </thead>
501
+ <tbody>
502
+ <tr><td>Figma axes</td><td>Breakpoint × Document (Faktura · Výdaj), 10 variants</td><td>Breakpoint × Layout (One row · Two rows), 7 variants</td></tr>
503
+ <tr><td>Figma content</td><td>regions <code>quiet</code> and <code>submit</code> with fixed action slots</td><td>one slot <code>Actions</code>; the action sets are default content supplied by the manifest recipes (<code>chrome.recipes</code>)</td></tr>
504
+ <tr><td>Choosing the action set</td><td><code>document</code> prop (<code>'faktura'</code> · <code>'vydaj'</code>)</td><td><code>children</code>, plus <code>stackBelow</code> for the row switch and <code>&lt;FormActions.Spacer /&gt;</code> for the one-row split</td></tr>
505
+ <tr><td>Handlers</td><td><code>onPreview</code>, <code>onSaveDraft</code>, <code>onSend</code>, <code>onDownload</code>, <code>onSave</code></td><td>set on the child elements by the form</td></tr>
506
+ <tr><td>Back link</td><td><code>backHref</code></td><td>an <code>&lt;a href&gt;</code> child set by the form</td></tr>
507
+ <tr><td>Loading and disabled</td><td><code>pendingAction</code>, <code>disabledActions</code></td><td>set on the child elements by the form</td></tr>
508
+ <tr><td>Labels and icons</td><td>fixed by the bar per Document</td><td>set by the form; the sample labels live in the recipes</td></tr>
509
+ </tbody>
510
+ </table>
511
+
512
+ The 1.x component also read its eight labels from its own translation keys with a `labels`
513
+ override; 2.0.0 drops both, the label-key map and the per-Document prop, action-key and label types.
514
+ The bar also no longer cancels implicit submission itself — the form does (see API).
515
+
516
+ **2.1.0 / 2.1.1:** the opt-in `stackOnOverflow` prop (Variants → Overflow) — Two rows also above the
517
+ `stackBelow` breakpoint when one row does not fit — is part of the spec (`chrome.layout.stack-on-overflow`,
518
+ on in the `faktura` recipe, off in `vydaj`).