@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,728 @@
1
+ import { Meta, Canvas, Controls } from '@storybook/addon-docs/blocks';
2
+ import * as FormBlockStories from './FormBlock.stories';
3
+ import { ViewportFrame } from '../../storybook/viewportFrame';
4
+
5
+ <Meta of={FormBlockStories} tags={['autodocs']} />
6
+
7
+ # FormBlock
8
+
9
+ ## Metadata
10
+
11
+ - **Layer:** organism
12
+ - **Kind:** region
13
+ - **Status:** draft
14
+ - **Tokens used:** `--bg-primary`, `--border-width-100`, `--border-width-200`, `--disabled-foreground`, `--font-body`, `--font-size-base`, `--font-size-sm`, `--font-size-xxs`, `--font-weight-normal`, `--font-weight-semibold`, `--leading-loose`, `--leading-relaxed`, `--outline-focus`, `--outline-focus-inverse`, `--radius-300`, `--radius-700`, `--space-100`, `--space-1000`, `--space-200`, `--space-600`, `--space-700`, `--space-800`, `--space-900`, `--text-inverted`, `--text-inverted-secondary`, `--text-link`, `--text-link-hover`, `--text-secondary`
15
+ - **Manifest version:** `2.0.0`
16
+ - **Composes:** [HeadingGroup](?path=/docs/design-system-molecules-headinggroup--docs) (manifest `slots.header.ref` → `heading-group`), [TextLink](?path=/docs/design-system-atoms-textlink--docs) and [IconButton](?path=/docs/design-system-atoms-iconbutton--docs) (the disclosure toggle and its Icon step), [RadioGroup](?path=/docs/design-system-atoms-radiogroup--docs) + [Radio](?path=/docs/design-system-atoms-radio--docs) only through the caller's `trailing` (the block gives their labels the hit zone); the content is the caller's children (manifest `slots.content`: no accepted-component restriction — Form Sections recommended in grid mode, free children in stack mode)
17
+
18
+ The token list above is generated from the component and everything it renders; it is not a complete
19
+ inventory of the nested atoms — HeadingGroup's heading type and spacing tokens are listed on its own
20
+ page. The block's own values
21
+ are the tile fill `--bg-primary` and radius `--radius-700`, the forced-colors border
22
+ `--border-width-100`, the padding and gaps of `chrome.padding`, `chrome.header-gap`, `chrome.inline`
23
+ `chrome.content-grid` and `chrome.content-stack` (`--space-600` … `--space-1000`) and the hit-zone calc over `--space-1000` and `--space-100`.
24
+
25
+ ## Overview
26
+
27
+ **FormBlock** is the white tile of a form page: a pictured H3 Heading Group with one trailing
28
+ control, over a grid of Form Sections or a one-column stack. Use one block per part of a form
29
+ (invoice, expense, contact) on the `--bg-secondary` page.
30
+
31
+ Pick the Layout by what the part holds:
32
+
33
+ - **`stacked`** (default) — a part with several fields or the line items. The header row sits above
34
+ the content.
35
+ - **`inline`** — a part that is one lookup or a short summary with a short title (Informace o vás,
36
+ Váš zákazník). From MD the header takes its own track of the tile grid and the content fills the
37
+ rest; below MD it renders like Stacked.
38
+
39
+ Do **not** use it for cards or panels outside a form, or for the sticky actions bar (Form Actions).
40
+ A group of fields that needs its own sub-heading inside a block is a Form Section `header="h4"`, not
41
+ a second block. Loose fields always sit inside a Form Section, never directly in the block.
42
+
43
+ ## Rationale
44
+
45
+ A form page is a stack of tiles that repeat the same chrome: a surface, a named header with one
46
+ control, and a content grid whose track count follows the page breakpoint. FormBlock owns that chrome
47
+ once, so padding, header gap and track count follow the one breakpoint the viewport reports. From the
48
+ upstream spec, four structural rules are fixed:
49
+
50
+ - **The tile never clips** — a focus ring paints outside its control, and a clipped tile would cut it.
51
+ - **No wrapper between the content element and its children** — the content element is the grid,
52
+ or the stack, itself and carries both the id the toggle controls and the `hidden` attribute.
53
+ - **No dense packing** — DOM order is the reading order and the tab order.
54
+ - **The picture is on at every breakpoint** — it is the block's identity.
55
+
56
+ ## Anatomy
57
+
58
+ The root is a `<section aria-labelledby>` pointing at the heading (a plain `<div>` under the
59
+ deprecated `headless`). It holds the header, then the content element — the grid (`content-grid`) or,
60
+ at `content="stack"`, the stack (`content-stack`); at `layout="inline"` from MD the content element
61
+ and the trailing slot move into a body row.
62
+
63
+ <table>
64
+ <thead>
65
+ <tr><th>Part</th><th>Element</th><th>Role</th><th>Tokens</th></tr>
66
+ </thead>
67
+ <tbody>
68
+ <tr>
69
+ <td><code>root</code></td><td><code>&lt;section&gt;</code> (<code>&lt;div&gt;</code> when <code>headless</code>)</td>
70
+ <td>The tile. <code>w-full</code>, capped at <code>--ds-content-wide</code> (<code>max-w-content-wide</code>). Carries <code>data-fods-component="form-block"</code> and, when headed, <code>aria-labelledby</code> = the heading id. No <code>overflow</code> rule, so it does not clip.</td>
71
+ <td>fill <code>--bg-primary</code>; radius <code>--radius-700</code>; a <code>--border-width-100</code> transparent border; padding and header gap → Sizes</td>
72
+ </tr>
73
+ <tr>
74
+ <td><code>header</code></td><td><code>&lt;div&gt;</code></td>
75
+ <td>The nested HeadingGroup (<code>size="h3"</code>) and, except at Inline MD+, the trailing slot (manifest <code>regions[header].align</code>). From SM one row that never wraps (<code>sm:flex-row sm:items-center</code>): the Heading Group fills it (<code>sm:flex-1 min-w-0</code>), so its title and description wrap inside it — never truncated — and the trailing hugs at the row end. A disclosure toggle steps down instead of wrapping (Toggle fit). At Mobile the header stacks (<code>flex-col</code>): the Heading Group fills the width and the trailing slot sits under it, full width, at the row start. At Mobile the Heading Group runs <code>picture={40}</code> (<code>--size-illustration-section</code>), 48 from SM. Absent under <code>headless</code>.</td>
76
+ <td>gap <code>--space-600</code></td>
77
+ </tr>
78
+ <tr>
79
+ <td><code>trailing</code></td><td><code>&lt;div&gt;</code></td>
80
+ <td>Wrapper of the header's one control, <code>shrink-0</code>. Rendered only when the block is <code>collapsible</code> or <code>trailing</code> is set. Every <code>&lt;a&gt;</code>, <code>&lt;button&gt;</code> and <code>&lt;label&gt;</code> inside gets a centred <code>::before</code> hit zone.</td>
81
+ <td>hit zone min <code>calc(--space-1000 + 2 × --space-100)</code> each way</td>
82
+ </tr>
83
+ <tr>
84
+ <td><code>toggle</code></td><td>TextLink or IconButton <code>&lt;button type="button"&gt;</code></td>
85
+ <td>Only on a <code>collapsible</code> block: the disclosure toggle the block renders into the trailing slot — TextLink <code>variant="strong"</code>, <code>size="sm"</code>, <code>underline="off"</code>, trailing caret; at the Icon step an IconButton <code>variant="tertiary"</code> <code>size="lg"</code>. The atom's root renamed to this part; <code>data-fit</code> = <code>full</code> · <code>short</code> · <code>icon</code>.</td>
86
+ <td>TextLink's / IconButton's own</td>
87
+ </tr>
88
+ <tr>
89
+ <td><code>content-grid</code></td><td><code>&lt;div&gt;</code></td>
90
+ <td>The content element <strong>is</strong> the grid: <code>grid-flow-row</code> (never dense), <code>items-start</code>, every child <code>min-w-0</code>. Carries the content id and <code>hidden</code> while closed; <code>[&amp;[hidden]]:hidden</code> re-asserts <code>display: none</code> over <code>display: grid</code>.</td>
91
+ <td>tracks and gaps → Sizes</td>
92
+ </tr>
93
+ <tr>
94
+ <td><code>content-stack</code></td><td><code>&lt;div&gt;</code></td>
95
+ <td>At <code>content="stack"</code>, rendered instead of <code>content-grid</code>: the content element <strong>is</strong> one column (<code>flex flex-col</code>), every child full width and <code>min-w-0</code>. A plain column with no role. Same content id, <code>hidden</code> and <code>[&amp;[hidden]]:hidden</code> guard as the grid.</td>
96
+ <td>gap <code>--space-900</code> at every breakpoint</td>
97
+ </tr>
98
+ </tbody>
99
+ </table>
100
+
101
+ The body row is an unmarked `<div>` at Inline: `flex items-start` from MD, gap `--space-800`, spanning
102
+ two tracks at LG/XL (`lg:col-span-2`). It holds the content element (`md:flex-1`) and then the
103
+ trailing slot. Below MD it stays in the DOM as `display: contents` (only the trailing slot moves back
104
+ to the header), so crossing MD never remounts the content — typed values and child state survive.
105
+
106
+ ## Variants
107
+
108
+ One axis in code — `layout` (manifest `axes.variant`: Stacked · Inline), a dedicated prop rather
109
+ than `variant`. The manifest's second axis, Breakpoint, is not a prop (see Sizes). The Matrix frames
110
+ every Breakpoint story at its real viewport width for both Layouts.
111
+
112
+ <Canvas of={FormBlockStories.Matrix} />
113
+
114
+ <table>
115
+ <thead>
116
+ <tr><th><code>layout</code></th><th>Structure</th><th>Content grid</th><th>Trailing position</th><th>When</th></tr>
117
+ </thead>
118
+ <tbody>
119
+ <tr>
120
+ <td><code>stacked</code> (default)</td>
121
+ <td>Header row above the content; the root is a flex column.</td>
122
+ <td>1 track below LG, 2 tracks at LG/XL (column gap <code>--space-1000</code>)</td>
123
+ <td>In the header: at the row end from SM, under the Heading Group at Mobile</td>
124
+ <td>A part with several fields, or the line items</td>
125
+ </tr>
126
+ <tr>
127
+ <td><code>inline</code></td>
128
+ <td>From MD the root is a grid: 2 tracks at MD (gap <code>--space-900</code>), 3 at LG/XL (gap <code>--space-1000</code>); header in the first track, the body row in the rest. Below MD the same column as Stacked.</td>
129
+ <td>Always 1 track</td>
130
+ <td>MD+: at the end of the body row, after the content. SM: at the header row end. Mobile: under the Heading Group.</td>
131
+ <td>One lookup or a short summary with a short title</td>
132
+ </tr>
133
+ </tbody>
134
+ </table>
135
+
136
+ The Inline trailing position is switched **in markup**, not with CSS `order`: the block reads
137
+ `useIsMobile('md')` (a `matchMedia` query mirroring the `md:` prefix) and renders the trailing slot
138
+ after the content at MD+, inside the header everywhere else, so DOM order equals visual order.
139
+
140
+ ### What the trailing slot holds
141
+
142
+ `trailing` is an open slot for the header's **one control**: beside the heading element, never inside
143
+ it, with a 44 px hit area at every breakpoint (manifest `slots.trailing`). The three below are the
144
+ recommended contents, not the only ones; the block knows no specific content and only gives every
145
+ link, button and Radio label inside the hit zone. The collapsible toggle is shown under States, the
146
+ price-mode group under [Line items](#line-items); the filled Inline party:
147
+
148
+ <Canvas of={FormBlockStories.InlineFilled} />
149
+
150
+ <table>
151
+ <thead>
152
+ <tr><th>Block</th><th>Trailing content</th><th>In code</th></tr>
153
+ </thead>
154
+ <tbody>
155
+ <tr>
156
+ <td>Collapsible</td>
157
+ <td>The disclosure toggle: TextLink Strong sm, Underline off, <code>toggleLabel.hide</code> while open, <code>toggleLabel.show</code> while closed; one <code>caret-down-small</code> turned 180° while open (reads as <code>caret-up-small</code>), turning on <code>--spring-standard</code>. From SM it steps down as the header row runs short (Toggle fit, below)</td>
158
+ <td><code>collapsible</code> + <code>toggleLabel</code>; the block renders it</td>
159
+ </tr>
160
+ <tr>
161
+ <td>Filled Inline party</td>
162
+ <td>«Upravit údaje» — TextLink Strong md, no icon, Underline on (the story's choice; the manifest requires the underline because without an icon it is the only non-colour cue)</td>
163
+ <td><code>trailing=</code> a <code>TextLink</code></td>
164
+ </tr>
165
+ <tr>
166
+ <td>Line items</td>
167
+ <td>«Zadávání cen» caption (Body/XXS, <code>--text-secondary</code>, one line) + two Radio md, «S DPH» / «Bez DPH», one <code>role="radiogroup"</code> named by the caption, <code>--space-500</code> apart — composed by the page; its value is page form state the rows read</td>
168
+ <td><code>trailing=</code> a caption + <code>RadioGroup</code></td>
169
+ </tr>
170
+ </tbody>
171
+ </table>
172
+
173
+ `collapsible` and `trailing` are mutually exclusive — enforced by the prop types (a discriminated
174
+ union), not at runtime.
175
+
176
+ ### Toggle fit
177
+
178
+ From SM the header row never wraps, so the toggle steps down instead (manifest `slots.trailing` (a)).
179
+ The block measures the header row against the Heading Group's unwrapped width (title and description
180
+ on one line) at the `--space-600` gap and takes the first step that fits. The step follows the room,
181
+ not the Breakpoint; the yardstick is the `show` label (the longer string), so flipping open never
182
+ changes the step. Two places do not step: at Inline MD+ the toggle sits in the body row, and at
183
+ Mobile the stacked header gives it the whole row under the heading, so it keeps the Full label
184
+ (always `data-fit="full"`, no width probe).
185
+
186
+ <Canvas of={FormBlockStories.ToggleFit} />
187
+
188
+ <table>
189
+ <thead>
190
+ <tr><th>Step</th><th>Toggle</th><th>Accessible name</th></tr>
191
+ </thead>
192
+ <tbody>
193
+ <tr><td>Full</td><td>TextLink Strong sm + caret, the label («Zobrazit nastavení»)</td><td>label + block title</td></tr>
194
+ <tr><td>Short</td><td>TextLink Strong sm + caret, the verb alone («Zobrazit»); the noun is <code>sr-only</code></td><td>full label + block title</td></tr>
195
+ <tr><td>Icon</td><td>IconButton Tertiary lg (44 × 44), caret alone; the label is its <code>aria-label</code></td><td>full label + block title</td></tr>
196
+ </tbody>
197
+ </table>
198
+
199
+ The verb is the first word of the label, the rest is the noun. «Upravit údaje» and the price-mode
200
+ group do not step down.
201
+
202
+ ### Content
203
+
204
+ <Canvas of={FormBlockStories.TwoSections} />
205
+
206
+ The children are the content grid's direct children, in reading order. A Form Section sets its own
207
+ width in the block grid through its `span` prop (`col-span-full`, plus `lg:col-span-1` at `span={1}`);
208
+ the block adds no class to its children. In `TwoSections` two Form Sections `header="h4"`
209
+ `span={1}` take one track each at LG/XL and the full width below LG.
210
+
211
+ ### Stack content
212
+
213
+ `content="stack"` (manifest `chrome.content-stack`) replaces the content grid with one column: every
214
+ child takes the whole width and children sit `--space-900` apart at every breakpoint
215
+ (`flex flex-col gap-900`). The children are free — any FODS component or page content — and DOM
216
+ order is the reading order. The stack itself is a plain column with no role.
217
+
218
+ ### Line items
219
+
220
+ <Canvas of={FormBlockStories.LineItems} />
221
+
222
+ The editable line items of a document (invoice, quote, proforma, credit note) are not a component:
223
+ they are a Form Block at `content="stack"` (manifest `chrome.line-items`). The block header names
224
+ them (`title="Položky"`, the `receipt-dollar` picture as `illustration`) and `trailing` holds the price-mode group.
225
+ Four zones, in render order, each a direct child of the stack and full width:
226
+
227
+ <table>
228
+ <thead>
229
+ <tr><th>Zone</th><th>Holds</th><th>In the story</th></tr>
230
+ </thead>
231
+ <tbody>
232
+ <tr>
233
+ <td>rows (required)</td>
234
+ <td>One <code>Item Row</code> per document line — a list of line fieldsets, never a <code>&lt;table&gt;</code>. The zone is the <code>role="group"</code> named by the block's heading through <code>aria-labelledby</code> (manifest <code>delivery.react</code>).</td>
235
+ <td>A <code>role="group"</code> whose <code>aria-labelledby</code> is the block title id, read from the block's internal context; two <a href="?path=/docs/design-system-organisms-item-row--docs">Item Row</a> instances (<code>columnSet="dph"</code>, <code>lineCount=2</code>, <code>isFirstRow</code> on the first only).</td>
236
+ </tr>
237
+ <tr>
238
+ <td>actions</td>
239
+ <td>The action bar («Přidat položku», «Vybrat z uložených», «Sleva na celý doklad»), the note toggle («Přidat poznámku») and the note (Text Area «Poznámka», hidden until toggled), <code>--space-900</code> apart.</td>
240
+ <td><code>Button</code>s with the variant and size of <code>chrome.line-items.control-ladder</code> (Secondary / Tertiary; sm at XL–MD, md at SM, add-item lg at Mobile), the order of <code>action-order</code> and the width modes of <code>control-sizing</code>. The note toggle is a <code>&lt;button aria-expanded aria-controls&gt;</code>.</td>
241
+ </tr>
242
+ <tr>
243
+ <td>totals</td>
244
+ <td>Page content, not a component: a box (<code>--bg-secondary</code>, <code>--radius-500</code>, <code>--space-800</code> padding, no border) holding one 2×2 caption + amount grid, right-aligned, column gap <code>--space-600</code>, row gap <code>--space-400</code> at Mobile and <code>--space-200</code> from SM (<code>totals.gap.row-mobile</code>). Net row Body/S <code>--text-secondary</code>; payable row Heading/H3 <code>--text-primary</code>.</td>
245
+ <td>A <code>&lt;dl&gt;</code> grid, 365 px wide at the right edge of the box above Mobile (amount column 130 px), filling the box at Mobile (amount column hugs). The box carries <code>aria-live="polite"</code>, since the consumer updates the amounts in place.</td>
246
+ </tr>
247
+ <tr>
248
+ <td>footer (optional)</td>
249
+ <td>The recurring-document Switch md with support text and info icon. Its eleven-state product contract lives outside the design system.</td>
250
+ <td><code>Switch</code> «Pravidelně fakturovat», reference state S1 (enabled, off).</td>
251
+ </tr>
252
+ </tbody>
253
+ </table>
254
+
255
+ - **Breakpoint from the container.** All four zones take one line-items Breakpoint, read from the
256
+ width of the stack (a container query), not from the viewport: each row resolves it against the
257
+ `item-row` floors and the actions, totals and footer take the value the rows resolve to. In the
258
+ story the zones other than the rows follow the page breakpoint.
259
+ - **Nothing painted, nothing clipped.** The composition paints nothing of its own except the totals
260
+ box and never clips, so a revealed note or a grown description is not cut off.
261
+ - **Not in the story.** The 44 px hit zone the manifest asks around the sm and md action Buttons, the
262
+ open-note geometry (a manifest `gaps` entry — the story reveals a plain md Text Area) and the live
263
+ region announcing added and removed lines.
264
+
265
+ ### Deprecated: headless
266
+
267
+ <Canvas of={FormBlockStories.Headless} />
268
+
269
+ `headless` renders a plain `<div>` with no header and no trailing area — only the content grid, which
270
+ runs 1 track below LG, 2 at LG and 3 at XL (`xl:grid-cols-3`). It exists for the deprecated parties tile,
271
+ where each party Form Section `header="h3"` names itself. A new screen gives each party its own
272
+ `layout="inline"` block.
273
+
274
+ ## Sizes
275
+
276
+ **There is no size axis.** Breakpoint is the size dimension and it is **not a prop**: padding,
277
+ header gap and grid tracks follow the viewport media queries — Mobile unprefixed, SM `sm:`, MD `md:`,
278
+ LG `lg:`. Every XL value equals its LG value, except the deprecated headless grid. The Breakpoint
279
+ stories pin the viewport to each band minimum (1280 / 1024 / 768 / 640) and the 390 Mobile canvas;
280
+ they render Stacked with the disclosure toggle over four fields, and Inline as the empty party block
281
+ (the lookup, no trailing).
282
+
283
+ <ViewportFrame storyId="design-system-organisms-form-block--breakpoint-xl" width={1280} label="Breakpoint · XL — viewport 1280" />
284
+ <ViewportFrame storyId="design-system-organisms-form-block--breakpoint-lg" width={1024} label="Breakpoint · LG — viewport 1024" />
285
+ <ViewportFrame storyId="design-system-organisms-form-block--breakpoint-md" width={768} label="Breakpoint · MD — viewport 768" />
286
+ <ViewportFrame storyId="design-system-organisms-form-block--breakpoint-sm" width={640} label="Breakpoint · SM — viewport 640" />
287
+ <ViewportFrame storyId="design-system-organisms-form-block--breakpoint-mobile" width={390} label="Breakpoint · Mobile — viewport 390" />
288
+
289
+ <table>
290
+ <thead>
291
+ <tr>
292
+ <th>Breakpoint</th>
293
+ <th>Tile padding (block / inline)</th>
294
+ <th>Header gap</th>
295
+ <th>Content grid (Stacked)</th>
296
+ <th>Inline tile grid</th>
297
+ </tr>
298
+ </thead>
299
+ <tbody>
300
+ <tr>
301
+ <td>XL, LG</td>
302
+ <td><code>--space-1000</code> / <code>--space-1000</code></td>
303
+ <td><code>--space-900</code></td>
304
+ <td>2 tracks; column <code>--space-1000</code>, row <code>--space-1000</code></td>
305
+ <td>3 tracks (header 1, body 2); gap <code>--space-1000</code>; body row gap <code>--space-800</code></td>
306
+ </tr>
307
+ <tr>
308
+ <td>MD</td>
309
+ <td><code>--space-1000</code> / <code>--space-1000</code></td>
310
+ <td><code>--space-900</code></td>
311
+ <td>1 track; row <code>--space-1000</code></td>
312
+ <td>2 tracks (header 1, body 1); gap <code>--space-900</code>; body row gap <code>--space-800</code></td>
313
+ </tr>
314
+ <tr>
315
+ <td>SM</td>
316
+ <td><code>--space-800</code> / <code>--space-800</code></td>
317
+ <td><code>--space-900</code></td>
318
+ <td>1 track; row <code>--space-900</code></td>
319
+ <td>— renders like Stacked</td>
320
+ </tr>
321
+ <tr>
322
+ <td>Mobile</td>
323
+ <td><code>--space-800</code> / <code>--space-600</code></td>
324
+ <td><code>--space-900</code></td>
325
+ <td>1 track; row <code>--space-900</code></td>
326
+ <td>— renders like Stacked</td>
327
+ </tr>
328
+ </tbody>
329
+ </table>
330
+
331
+ - The Inline content grid always runs 1 track; its row gap follows the same ladder as Stacked
332
+ (`--space-900` below MD, `--space-1000` from MD) — the manifest's `chrome.content-grid` row gaps,
333
+ which `chrome.inline` does not restate.
334
+ - Below MD the block runs full-bleed and its inline padding stands in for the page side gutter. The
335
+ stories model the page (`--bg-secondary`, the gutter from MD) with a decorator; the gutter belongs
336
+ to the page, not the block.
337
+ - The header gap (header → content, `chrome.header-gap`) is `--space-900` at every breakpoint
338
+ (`flex flex-col gap-900` on the root). The header itself is a row from SM and a column at Mobile,
339
+ its two items `--space-600` apart either way (Anatomy).
340
+ - Reference widths the manifest draws the variants at (`sizes[]`): XL 1190, LG 944, MD 704, SM 640,
341
+ Mobile 390. Tile heights with the default content (`chrome.measurements`): Stacked 288 at XL/LG/MD,
342
+ 380 at SM, 372 at Mobile; Inline 157 at XL/LG/MD, 210 at SM and Mobile. Both are outcomes, not
343
+ bindings, and are only checked at runtime.
344
+
345
+ ## States
346
+
347
+ FormBlock has **no state axis** (manifest `intent.states`): no hover, focus, loading, empty or error
348
+ state of its own. The one boolean that changes what renders is **open**, on a collapsible block; a
349
+ non-collapsible block is always open. `Collapsible` renders both values statically (controlled):
350
+
351
+ <Canvas of={FormBlockStories.Collapsible} />
352
+
353
+ Collapsible Inline: from MD the toggle stays at the end of the body row, open or closed.
354
+
355
+ <Canvas of={FormBlockStories.InlineCollapsible} />
356
+
357
+ <table>
358
+ <thead>
359
+ <tr><th>open</th><th>Toggle</th><th>Content element</th></tr>
360
+ </thead>
361
+ <tbody>
362
+ <tr>
363
+ <td><code>true</code></td>
364
+ <td>caret turned up (<code>caret-down-small</code> rotated 180°), <code>toggleLabel.hide</code></td>
365
+ <td>rendered</td>
366
+ </tr>
367
+ <tr>
368
+ <td><code>false</code></td>
369
+ <td><code>caret-down-small</code>, <code>toggleLabel.show</code>; a click anywhere on the tile opens the block</td>
370
+ <td><code>hidden</code> attribute — out of the accessibility tree and the tab order</td>
371
+ </tr>
372
+ </tbody>
373
+ </table>
374
+
375
+ - **Motion** (manifest 1.6.0 `motion`, run by Motion on the content element itself — it stays the
376
+ grid, no wrapper). Opening: the content element leaves `hidden`, its height opens on
377
+ `--spring-gentle` while it fades in over `--duration-slow` + `--easing-enter`, together, and the
378
+ blocks below follow. Closing: it turns `inert` at the click, fades out over `--duration-fast` +
379
+ `--easing-exit` first, then its height folds on `--spring-gentle`, and only then takes `hidden`.
380
+ The root's gap above the content folds with the height (a negative `margin-top` on the same
381
+ spring), so nothing jumps when the content finally leaves the layout.
382
+ The caret is one `caret-down-small` turning 180° on `--spring-standard` from the moment of the
383
+ click — the shared `internal/MotionCaret.tsx`, passed to the toggle as an element (TextLink
384
+ `trailingIcon`, IconButton `icon`); the label swaps at once. A re-toggle mid-way turns the caret around and reverses the room
385
+ from where it is. Under `prefers-reduced-motion` the caret shows its end pose and the content
386
+ appears or disappears at once — no fade, no room animation. The `inert` → `hidden` timing is the
387
+ approved deviation `form-block-collapse-motion`.
388
+
389
+ <Canvas of={FormBlockStories.Motion} />
390
+ - **Validation** belongs to the page form, not the block: on a failed submit the form calls
391
+ `onOpenChange(true)` for every block holding an invalid field, then moves focus to the first invalid
392
+ field (manifest `delivery.react`). The block itself does not open on its own.
393
+ - **Closed tile** — while closed, a pointer click anywhere on the tile calls `onOpenChange(true)`
394
+ (a consumer `onClick` runs first and can `preventDefault()` it). No tab stop and no role are
395
+ added: the toggle stays the keyboard path and the only control in the accessibility tree.
396
+ - **Disabled** — the block owns none; whatever is passed as `trailing` carries its own.
397
+
398
+ ## API
399
+
400
+ <Controls of={FormBlockStories.Playground} />
401
+
402
+ The Controls table drives the story's flat args; the story's render turns them into the right arm of
403
+ the props union (`toggleShow` / `toggleHide` become `toggleLabel`, `trailing` picks a demo control).
404
+
405
+ **`FormBlock`**
406
+
407
+ - **`layout`** (`'stacked' | 'inline'`, default `'stacked'`) — the Layout axis.
408
+ - **`title`** (`string`, required unless `headless`) — the HeadingGroup title; the block's
409
+ accessible name (`aria-labelledby`, or `aria-label` under `showHeader={false}`).
410
+ - **`description`** (`string`, optional) — a `<p>` beside the heading, never inside it; an empty
411
+ string renders none.
412
+ - **`illustration`** (`React.ReactElement`, required unless `headless`) — the `Illustration / Section`
413
+ picture the app supplies (`<img src={…} alt="" />` or an inline SVG); the package ships no picture
414
+ (manifest 1.8.0 `delivery.react`). HeadingGroup draws it at every breakpoint in its picture box,
415
+ 48 px and 40 px below SM (`picture={isBelowSm ? 40 : 48}`). Which picture goes with which heading
416
+ is in the upstream `spec/03-atoms/illustrations.md` (Variants); how an app supplies pictures:
417
+ [Consuming → Assets](?path=/docs/getting-started-consuming--docs#assets).
418
+ - **`headingLevel`** (`2`–`6`, default `2`) — the heading element; the visual size stays H3.
419
+ - **`collapsible`** (`true`) — the block renders the disclosure toggle. Requires **`toggleLabel`**
420
+ (`show` / `hide` strings). With it: **`open`** (controlled), **`defaultOpen`** (uncontrolled,
421
+ default `true`), **`onOpenChange`** (`(open: boolean) => void`).
422
+ - **`trailing`** (`ReactNode`) — the header's one control when the block is not collapsible
423
+ («Upravit údaje», the price-mode caption + RadioGroup, or any other single control).
424
+ - **`content`** (`'grid' | 'stack'`, default `'grid'`) — `'stack'` runs the children full width
425
+ under each other, `--space-900` apart at every breakpoint, as a plain column. Typed `never` under
426
+ `headless`.
427
+ - **`surface`** (`'tile' | 'none'`, default `'tile'`) — code-only, no Figma counterpart
428
+ (`properties[Surface]`, manifest 1.5.0). `'none'` drops the tile's fill, radius, forced-colors
429
+ border and padding for a block inside a Modal body or the Mini Form card (manifest 1.7.0), whose
430
+ padding is then the only inset; header, gaps and content grid stay. Consecutive blocks in a Modal
431
+ body sit `--space-1000` apart at every breakpoint (`chrome.modal-host`) — the host sets that gap.
432
+ - **`showHeader`** (`boolean`, default `true`) — code-only mirror of the Figma boolean Show
433
+ header. `false` keeps the `<section>` and its content element (grid or stack) and drops the
434
+ header row: no heading, no picture, no trailing area. `title` stays required and names the
435
+ section through `aria-label`, and the line-items context carries no heading id. `description`,
436
+ `illustration`, `headingLevel`, `collapsible`, `trailing`, the open props and `layout="inline"`
437
+ are rejected by the prop types. Used in a Modal body where the Modal title already heads the
438
+ first block — manifest 1.5.0 (`properties[Show header].maps`,
439
+ `chrome.modal-host`); not the deprecated `headless` tile (plain `<div>`, 3 tracks at XL).
440
+ - **`headless`** (`true`, `@deprecated`) — no header; `title`, `description`, `illustration`,
441
+ `headingLevel`, `content`, `collapsible`, `trailing` and the open props are typed `never`.
442
+ - **`children`** — the content, in reading order: Form Sections in grid mode, free children in stack
443
+ mode.
444
+ - Every other HTML attribute (including `className`) goes to the root; `ref` points to the root
445
+ (`forwardRef`).
446
+
447
+ `formBlockVariants` (the `tv` recipe) is exported too. The block also provides a context carrying
448
+ the heading id. `useFormBlock()` (with its type `FormBlockContextValue`, both from
449
+ `@invoiceonline/ui-react/form-block`) returns `{ titleId }` inside a FormBlock and `null` outside
450
+ one, so a group of item rows names itself after the block title:
451
+ `<div role="group" aria-labelledby={block?.titleId}>`.
452
+
453
+ ## Do / Don't
454
+
455
+ - ✅ Give every block a header: a title and its Section picture, at every breakpoint.
456
+ - ✅ Use `collapsible` + `toggleLabel` and let the block render the toggle.
457
+ - ✅ Use the same noun in both toggle strings («Skrýt nastavení» / «Zobrazit nastavení»).
458
+ - ✅ Keep the description to one short line, so the toggle keeps its label.
459
+ - ✅ On a failed submit, open every block that holds an invalid field (`onOpenChange(true)`), then focus the first invalid field.
460
+ - ✅ Set «Upravit údaje» as TextLink Strong, no icon, `underline="on"`.
461
+ - ✅ In grid mode, put loose fields inside a Form Section; for a sequence of full-width pieces use `content="stack"`.
462
+ - ✅ Name the line items with the block header and pass the price-mode group as `trailing`.
463
+ - ✅ Make the rows zone of the line items the named `role="group"`; keep the stack itself a plain column.
464
+ - ✅ Use `layout="inline"` for one lookup or a short summary with a short title.
465
+ - ✅ Keep a short block title, a plain noun phrase («Základní údaje»).
466
+ - ❌ Don't use `headless` on a new screen — the deprecated parties tile is the one exception.
467
+ - ❌ Don't pass `collapsible` and `trailing` together, or build your own toggle as a link or inside the heading.
468
+ - ❌ Don't change the noun between the two strings («Skrýt nastavení» / «Zobrazit detail»).
469
+ - ❌ From SM, don't wrap the toggle under the heading or move it to the row start — it steps down instead (at Mobile the header stacks and the toggle sits under the heading by spec).
470
+ - ❌ Don't rely on native validation to focus a field inside a closed block.
471
+ - ❌ Don't switch its underline off — with no icon it has no other non-colour cue.
472
+ - ❌ Don't wrap the sections, or place a field directly in the block.
473
+ - ❌ Don't add a heading or a price-mode choice above the rows inside the block — it names the same content twice.
474
+ - ❌ Don't render the line items as a `<table>`.
475
+ - ❌ Don't use Inline for a part with several fields or a long title.
476
+ - ❌ Don't phrase it as an instruction («Zadejte základní údaje»).
477
+ - ❌ Don't add a Breakpoint prop, a visible border, a shadow or `overflow: hidden` to the tile.
478
+
479
+ ## Accessibility
480
+
481
+ - **Semantics** — the root is a `<section>` whose `aria-labelledby` points at the heading (id from
482
+ `useId`, passed to HeadingGroup as `headingId`). The heading renders as an `h2` by default
483
+ (`headingLevel` 2–6) at visual size H3. The description `<p>` is a sibling of the heading, so the
484
+ block's name is the title alone. The picture is the app's element inside HeadingGroup's
485
+ `aria-hidden="true"` illustration box, so an `<img>` takes `alt=""`. Under `headless` the root is a plain `<div>` with no name.
486
+ - **Keyboard** — tab order is DOM order. Stacked, and Inline below MD: header, trailing control,
487
+ content. Inline from MD: header, content, trailing control — the markup moves the trailing slot
488
+ (`useIsMobile('md')`), so DOM order follows the visual order. The heading is not a tab stop. The
489
+ toggle is a native `<button type="button">` (Enter and Space). While
490
+ closed, the content element is `hidden`, so its fields take no focus; a pointer click on the
491
+ closed tile opens it, which adds no tab stop. When the toggle changes step under focus (a resize
492
+ across the Icon step swaps the element), focus moves to the new toggle.
493
+ - **ARIA** — the toggle has **no `aria-expanded`**: its label carries the state («Skrýt …» /
494
+ «Zobrazit …»), so the state is not announced twice (manifest `delivery.react` 1.4.0).
495
+ `aria-controls` points at the content element's id; its name is `aria-labelledby` = toggle id +
496
+ title id, so the full label comes first and the block title disambiguates repeated toggles — at
497
+ every step (the Short step keeps the noun `sr-only`, the Icon step carries the label as its
498
+ `aria-label`, which the self-reference resolves to). The caret is an `Icon`, which renders
499
+ `aria-hidden="true"`. A RadioGroup passed as `trailing` must be named — RadioGroup's types force
500
+ `aria-label` or `aria-labelledby` (e.g. on the caption). In the line items the rows zone, not the
501
+ stack, is a `role="group"` named by the block heading (`aria-labelledby` = the title id from the
502
+ block context).
503
+ - **Target** — every `<a>`, `<button>` and `<label>` inside the trailing slot (the toggle, «Upravit
504
+ údaje», each Radio of a passed RadioGroup) gets a centred `::before` hit zone of at least `--space-1000 + 2 × --space-100`
505
+ each way — the manifest's 44 px minimum; the rendered size is confirmed only by the runtime pass.
506
+ The zone is a `::before` pseudo-element, so it never moves a focus ring: the toggle's ring stays
507
+ on the link, and each radio's ring stays on its box (Radio's own focus treatment).
508
+ - **Screen reader** — the block is announced with its heading text as its name. The toggle reads
509
+ e.g. «Skrýt nastavení Obecné nastavení»; the verb flips with open, so the state is never carried
510
+ by the caret alone.
511
+ - **Contrast & motion** — the tile has no visible border; it is separated by surface (`--bg-primary`
512
+ on `--bg-secondary`). Under forced colors the surface change vanishes, so the tile carries a
513
+ `--border-width-100` transparent border that forced colors paint. Ink and focus rings are the nested
514
+ atoms' own. The only motion of the block is the open / close (the caret turn, the content fade and
515
+ its room — see States), which `prefers-reduced-motion` reduces to an instant switch; the nested
516
+ TextLink and Radio keep their own colour transitions.
517
+
518
+ Accessibility floor: `spec/01-foundations/accessibility.md`.
519
+
520
+ ## Copy
521
+
522
+ Voice: the field voice of Text Field — impersonal and neutral, clear over clever, concise, specific
523
+ and helpful, consistent terminology. Action labels are verb-first; link text is verb-first, sentence
524
+ case, no terminal period, never «klikněte zde». Examples are Czech; the rules hold for every language,
525
+ and because text length varies by language the max-chars below are guidance, not enforced limits.
526
+
527
+ - **Block title** — a plain noun phrase naming what the block holds, never a sentence and never an
528
+ instruction; in Layout=Inline it wraps when long, so keep it to a few words. ✅ «Základní údaje»
529
+ ❌ «Zadejte základní údaje».
530
+ - **Toggle** (`toggle`, the `toggleLabel` prop) — two strings: `show`, «Zobrazit …», while closed,
531
+ and `hide`, «Skrýt …», while open, with the same noun after the verb in both. The label is the first
532
+ part of the button's accessible name, followed by the block title, so it has to read ahead of the
533
+ title. The shortened step is the verb alone. Wraps; max 28 characters, counted on the longer
534
+ `show` string. ✅ «Zobrazit nastavení» / «Skrýt nastavení» ❌ «Zobrazit detail» / «Skrýt nastavení».
535
+ - **Edit link** — «Upravit údaje» on a filled Inline block, passed as `trailing`: verb-first, Text
536
+ Link Strong, no icon.
537
+ - **Manual-entry helper** (`manual-entry`) — «Nebo můžete vyplnit údaje ručně», one sentence whose
538
+ closing phrase «údaje ručně» is the inline link; the verb stays outside the link, and the link never
539
+ reads «zde». Wraps; max 40 characters, link included.
540
+ - **Price-mode caption** (`price-mode-label`) — «Zadávání cen» with the options «S DPH» / «Bez DPH»,
541
+ passed as `trailing`. The caption labels the choice and does not explain it; it is the group's
542
+ accessible name. One line, truncates; max 20 characters.
543
+ - **Totals** (`total-excl-vat`, `total-incl-vat`) — caption and amount are separate cells; the
544
+ amount uses a decimal comma, a space thousands separator and a trailing currency code. A VAT
545
+ payer's document shows «Celkem bez DPH» and «Celkem s DPH»; a non-VAT payer's shows one row,
546
+ «Celkem». Never abbreviate the caption: it truncates. One line; max 32 characters.
547
+ - **Action labels** (`add-item-label`, `select-saved-label`, `discount-all-label`,
548
+ `note-toggle-label`) — short imperative verb phrases, sentence case, no terminal period, the same
549
+ at every breakpoint. One line, truncates; max 24 characters each. The note toggle ships only the
550
+ add-a-note string; a consumer that changes the label while the note is open owns that second string.
551
+ - **Recurring switch label** (`recurring-switch-label`) — «Pravidelně fakturovat», the switch's
552
+ accessible name: it names the capability and carries no on/off word. Wraps, never truncates; max
553
+ 60 characters.
554
+ - **Recurring switch support text** (`recurring-switch-support-text`) — says what turning the
555
+ setting on does, not what the label already says. Wraps to two lines at most; max 90 characters.
556
+ - **Note label** (`note-label`) — «Poznámka», the note Text Area's label and accessible name. Name it
557
+ after the document when the field has a narrower job («Důvod vystavení» on a credit note,
558
+ «Akceptace nabídky» on a quote), always as the label, never as the value or a placeholder. One
559
+ line, truncates; max 24 characters.
560
+ - **Column labels** — one noun, no article, no unit; they truncate rather than widen the column.
561
+ The unit column is «Jednotka». Popis ships with no placeholder.
562
+ - **Accessible names for icon-only row controls** — the consumer's to write: name the action and the
563
+ line it acts on, e.g. «Smazat položku 2», never the action alone.
564
+
565
+ Canonical texts:
566
+
567
+ <table>
568
+ <thead>
569
+ <tr><th>Run</th><th>Text</th><th>What the words carry</th></tr>
570
+ </thead>
571
+ <tbody>
572
+ <tr><td><code>manual-entry</code></td><td>Nebo můžete vyplnit údaje ručně</td><td>Link on «údaje ručně»</td></tr>
573
+ <tr><td><code>price-mode-label</code></td><td>Zadávání cen</td><td>Options «S DPH» / «Bez DPH»</td></tr>
574
+ <tr><td><code>total-excl-vat</code></td><td>Celkem bez DPH</td><td>The net row (VAT payer)</td></tr>
575
+ <tr><td><code>total-incl-vat</code></td><td>Celkem s DPH</td><td>The payable row; «Celkem» on a non-VAT payer's document</td></tr>
576
+ <tr><td><code>add-item-label</code></td><td>Přidat položku</td><td>The verb plus what one press produces: one more empty line</td></tr>
577
+ <tr><td><code>select-saved-label</code></td><td>Vybrat z uložených</td><td>The source; the <code>heart</code> glyph reads as a favourite, so the words carry it</td></tr>
578
+ <tr><td><code>discount-all-label</code></td><td>Sleva na celý doklad</td><td>The scope: the row has a per-item discount behind the same <code>percent</code> glyph</td></tr>
579
+ <tr><td><code>note-toggle-label</code></td><td>Přidat poznámku</td><td>The add-a-note wording</td></tr>
580
+ <tr><td><code>recurring-switch-label</code></td><td>Pravidelně fakturovat</td><td>The capability, no on/off word</td></tr>
581
+ <tr><td><code>recurring-switch-support-text</code></td><td>Pravidelná fakturace vystaví další faktury sama podle nastavení.</td><td>The consequence of turning it on</td></tr>
582
+ <tr><td><code>note-label</code></td><td>Poznámka</td><td>The note's label and accessible name</td></tr>
583
+ </tbody>
584
+ </table>
585
+
586
+ ## Usage
587
+
588
+ ```tsx
589
+ import { Field, FormBlock, FormSection, Radio, RadioGroup, TextField, TextLink } from '@invoiceonline/ui-react';
590
+ // The app's own copies of the Illustration / Section pictures.
591
+ import gearChecklist from './assets/section-gear-checklist.svg';
592
+ import personArrowOut from './assets/section-person-arrow-out.svg';
593
+ import receiptDollar from './assets/section-receipt-dollar.svg';
594
+
595
+ <FormBlock
596
+ title="Obecné nastavení"
597
+ illustration={<img src={gearChecklist} alt="" />}
598
+ collapsible
599
+ toggleLabel={{ show: 'Zobrazit nastavení', hide: 'Skrýt nastavení' }}
600
+ >
601
+ <FormSection>
602
+ <Field label="Číslo" size="md"><TextField id="doc-number" size="md" /></Field>
603
+ <Field label="Datum vystavení" size="md"><TextField id="issue-date" size="md" /></Field>
604
+ </FormSection>
605
+ </FormBlock>
606
+
607
+ <FormBlock
608
+ layout="inline"
609
+ title="Informace o vás"
610
+ description="… neboli Dodavatel"
611
+ illustration={<img src={personArrowOut} alt="" />}
612
+ trailing={<TextLink variant="strong" size="md" underline="on" onClick={startEditing}>Upravit údaje</TextLink>}
613
+ >
614
+ <FormSection>
615
+ <FormSection.Cell span="full">
616
+ <p>Acme s.r.o. · IČO 12345678 · Praha</p>
617
+ </FormSection.Cell>
618
+ </FormSection>
619
+ </FormBlock>
620
+
621
+ <FormBlock
622
+ title="Položky"
623
+ illustration={<img src={receiptDollar} alt="" />}
624
+ content="stack"
625
+ trailing={
626
+ <div className="flex items-center gap-500">
627
+ <span id="price-mode-caption" className="text-body-xxs text-text-secondary">Zadávání cen</span>
628
+ <RadioGroup aria-labelledby="price-mode-caption" orientation="horizontal" size="md" value={priceMode} onValueChange={setPriceMode}>
629
+ <Radio value="with-vat" label="S DPH" />
630
+ <Radio value="without-vat" label="Bez DPH" />
631
+ </RadioGroup>
632
+ </div>
633
+ }
634
+ >
635
+ {rows} {/* role="group" named by the block heading: a list of line fieldsets */}
636
+ {actions} {/* the action bar, the note toggle, the note */}
637
+ {totals} {/* the totals box — page content */}
638
+ {footer} {/* optional: the recurring-document Switch */}
639
+ </FormBlock>
640
+ ```
641
+
642
+ Don't:
643
+
644
+ ```tsx
645
+ <FormBlock title="Obecné nastavení" illustration={picture} collapsible toggleLabel={labels} trailing={editLink} />
646
+
647
+ <FormBlock title="Základní údaje" illustration={picture}>
648
+ <div className="grid grid-cols-2">{fields}</div>
649
+ </FormBlock>
650
+
651
+ // Don't: a picture name — the package ships no picture, so the prop takes an element.
652
+ <FormBlock title="Základní údaje" illustration="document-info">{sections}</FormBlock>
653
+ ```
654
+
655
+ ## Related
656
+
657
+ - [FormSection](?path=/docs/design-system-organisms-form-section--docs) — the group of fields in the
658
+ content grid; its `span` sets its width in the block grid.
659
+ - [HeadingGroup](?path=/docs/design-system-molecules-headinggroup--docs) — the nested header
660
+ (`headingId` names the section).
661
+ - [TextLink](?path=/docs/design-system-atoms-textlink--docs) — the toggle and «Upravit údaje».
662
+ - [RadioGroup](?path=/docs/design-system-atoms-radiogroup--docs) /
663
+ [Radio](?path=/docs/design-system-atoms-radio--docs) — the price-mode choice a page passes as `trailing`.
664
+ - Spec: `spec/05-organisms/form-block.md`
665
+ (hosted children: `form-section.md`; the line items and `item-row` 3.0.0 are documented in the
666
+ same spec).
667
+ - [Item Row](?path=/docs/design-system-organisms-item-row--docs) — one document line in the rows zone.
668
+ - [Button](?path=/docs/design-system-atoms-button--docs),
669
+ [Switch](?path=/docs/design-system-atoms-switch--docs),
670
+ [Textarea](?path=/docs/design-system-atoms-textarea--docs) — the line-items actions, footer and note.
671
+
672
+ ## Migration notes
673
+
674
+ The spec's before → after table is not reproduced here: what the block renders (the header row,
675
+ the trailing slot, the toggle `<button>` with `aria-controls` and a state-carrying label, the
676
+ heading as an `h2` with the description beside it, the picture outside the heading element) is in
677
+ Anatomy and Accessibility above. A tile that holds more than one party is deprecated and kept for
678
+ existing screens; a new screen gives each party its own Layout=Inline block.
679
+
680
+
681
+ **Known deviations in the stories:** the Inline default content uses a TextField with a hand-set
682
+ helper line in place of the Subject Lookup Field. In the `LineItems` story
683
+ («Položky faktury») the rows are [Item Row](?path=/docs/design-system-organisms-item-row--docs)
684
+ instances that resolve their Breakpoint from their own container, while the other zones follow the
685
+ page breakpoint instead of the container width the rows resolve.
686
+
687
+ **1.5.0 → 1.6.0 (motion):** the WAAPI height / opacity animation on `--duration-slow` is replaced by
688
+ the manifest's Calm motion in Motion — opening runs the room (`--spring-gentle`) and the fade
689
+ (`--duration-slow` + `--easing-enter`) together, closing fades (`--duration-fast` + `--easing-exit`)
690
+ before the room folds; the caret turns on `--spring-standard` instead of a `--duration-slow` CSS
691
+ transition, and reduced motion now drops the fade and the room as the manifest's `reducedMotion`
692
+ says. The `inert` / `hidden` contract is unchanged. The room is the element's height (as
693
+ `motion.layout.note` describes), not a transform, so the blocks below follow it.
694
+
695
+ **2026-11-10 (caret):** the toggle caret is the shared `<MotionCaret>` passed as an element into
696
+ TextLink `trailingIcon` / IconButton `icon` (TextLink's icon slots accept an element since this
697
+ date); the imperative turn on the nested `.icon` and the SSR open-pose class on the toggle are gone —
698
+ `MotionCaret`'s `initial={false}` gives the first paint its pose. `data-caret` now sits on the caret
699
+ wrapper inside the toggle, no longer on the toggle itself. No visible change.
700
+
701
+ **2026-11-10 (gap):** closing left the root's gap (`--space-800` / `--space-900`) under the folded
702
+ content until the spring fully settled, when `hidden` removed it in one jump; opening added it at
703
+ once. The gap now folds and opens with the room (`roomVariants(…, { gapAbove: true })` in
704
+ `internal/collapseRoom.ts`).
705
+
706
+ **1.6.0 → 1.6.1:** no code change. The Item Row references follow its 3.0.0 Document axis; the
707
+ `LineItems` story keeps `columnSet="dph"`, which is Document=Faktura DPH.
708
+
709
+ **1.6.1 → 1.7.0 (Mobile header):** at Mobile the header stacks (`flex flex-col gap-600`, a row
710
+ `sm:flex-row sm:items-center` from SM): the Heading Group fills the width and the trailing slot sits
711
+ under it at the row start, full width. The toggle no longer steps down at Mobile — it keeps its full
712
+ label in the whole row (`fitEnabled` is off below SM). The header gap above the content is
713
+ `--space-900` at every breakpoint (was `--space-800` at SM and Mobile). `surface="none"` also covers
714
+ the Mini Form card.
715
+
716
+ **1.7.0 → 1.8.0 → 2.0.0 (the app supplies the picture):** `delivery.react`: the illustration is a
717
+ React element the consumer supplies; the component ships no picture and owns only its box. 2.0.0
718
+ records the same change as a major, with the steps in `delivery.migration`; the code already takes the
719
+ element. In code `illustration` changes from a `FormSectionIllustration` name to a
720
+ `React.ReactElement`. Replace `illustration="gear-checklist"` with
721
+ `illustration={<img src={gearChecklist} alt="" />}`, `gearChecklist` being the app's own copy of that
722
+ picture.
723
+
724
+ **Approved deviations:** `form-block-collapse-motion` (the `inert` → `hidden` timing of the close, see States). The former
725
+ `form-block-stack-content`, `form-block-trailing-generic` and `form-block-header-wrap` are specified
726
+ upstream since manifest 1.1.0 / 1.2.0; `form-block-toggle-link-sm-underline` ended with 1.4.0, which
727
+ wrote the toggle as Text Link Strong sm, Underline off; `surface="none"` and `showHeader={false}`
728
+ are specified since 1.5.0 (`properties[Surface]`, `chrome.modal-host`).