@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,533 @@
1
+ import { Meta, Canvas, Controls } from '@storybook/addon-docs/blocks';
2
+ import * as ItemRowStories from './ItemRow.stories';
3
+
4
+ <Meta of={ItemRowStories} tags={['autodocs']} />
5
+
6
+ # ItemRow
7
+
8
+ ## Metadata
9
+
10
+ - **Layer:** organism
11
+ - **Kind:** structure
12
+ - **Status:** draft
13
+ - **Tokens used:** `--space-100`, `--space-1000`, `--space-1100`, `--space-1300`, `--space-400`, `--space-500`
14
+ - **Manifest version:** `3.0.0`
15
+ - **Composes:** [Field](?path=/docs/design-system-atoms-field--docs),
16
+ [NumberField](?path=/docs/design-system-atoms-numberfield--docs),
17
+ [Select](?path=/docs/design-system-organisms-select--docs),
18
+ [Textarea](?path=/docs/design-system-atoms-textarea--docs),
19
+ [TextField](?path=/docs/design-system-atoms-textfield--docs),
20
+ [IconButton](?path=/docs/design-system-atoms-iconbutton--docs)
21
+
22
+ The token list above holds the tokens of the row's own classes. Every colour, border and radius on
23
+ screen belongs to the composed atoms — the row's surface paints nothing (`chrome.surface`: fill
24
+ `null`, border `null`, radius `0`).
25
+
26
+ ## Overview
27
+
28
+ **ItemRow** is one editable document line — Počet, Jednotka, (Typ), Popis, DPH, Cena, Celkem and
29
+ the row actions — reflowing from a single flat line to a stacked card. Use it only in the rows zone
30
+ of the line items (a Form Block at `content="stack"`), one instance per document line.
31
+
32
+ Do **not** use it as a table row (there is no cell grid and no column header to align to) or as a
33
+ generic form row: every column is a live input the user edits in place (manifest
34
+ `intent.whenToUse`). A read-only list of records is a Table; a rendered invoice is output, not input.
35
+
36
+ ## Rationale
37
+
38
+ The line items of an invoice, quote, proforma or credit note repeat one unit — a line — and every
39
+ copy must reflow the same way wherever the form is placed. The row therefore reads its Breakpoint
40
+ from **its own container width**, never from the viewport or a parent prop (manifest 2.0.0): a
41
+ document form inside a narrow panel on a wide screen renders the matching narrow rows instead of
42
+ overflowing the panel. Which shape a width gets is explained under Sizes → Shape selection.
43
+
44
+ Two decisions from the spec shape the component:
45
+
46
+ - **The money columns are Text Field, not Unit Field.** The document picks its currency once, so a
47
+ line amount carries no unit suffix. Cena and Celkem are the same atom one state apart — Celkem is
48
+ read-only — so switching the state on the wrong one would silently make a computed total editable.
49
+ - **The per-item discount is a button that opens a modal**, never an inline field. The modal is the
50
+ consumer's (`onDiscount`).
51
+
52
+ ## Anatomy
53
+
54
+ The DOM is the finest grouping (the stack's sub-rows inside the split shape's two rows); a coarser
55
+ shape folds the frames it does not use with `display: contents`. DOM order is therefore the same in
56
+ every shape.
57
+
58
+ <table>
59
+ <thead>
60
+ <tr><th>Part</th><th>Element</th><th>Role</th><th>Tokens / size</th></tr>
61
+ </thead>
62
+ <tbody>
63
+ <tr>
64
+ <td><code>root</code></td><td><code>&lt;fieldset&gt;</code></td>
65
+ <td>One per document line. Named size container <code>@container/item-row</code>; browser fieldset chrome reset (<code>m-0 border-0 p-0</code>). Carries <code>data-fods-component="item-row"</code> and <code>disabled</code>; named by its <code>&lt;legend&gt;</code> alone.</td>
66
+ <td>paints nothing</td>
67
+ </tr>
68
+ <tr>
69
+ <td><code>legend</code></td><td><code>&lt;legend class="sr-only"&gt;</code></td>
70
+ <td>The line's accessible name — the <code>label</code> prop (e.g. «Položka 2»).</td>
71
+ <td>—</td>
72
+ </tr>
73
+ <tr>
74
+ <td>layout</td><td><code>&lt;div&gt;</code></td>
75
+ <td>Column of the two rows; becomes one flat line from the <code>flat</code> floor up.</td>
76
+ <td>stacked gap <code>--space-500</code>; flat gap <code>--space-100</code></td>
77
+ </tr>
78
+ <tr>
79
+ <td>row-1 / row-2</td><td><code>&lt;div&gt;</code></td>
80
+ <td>The split shape's two lines: row-1 = handle, Počet, Jednotka, Typ, Popis; row-2 = DPH, Cena, Celkem, actions. Folded (<code>contents</code>) in the flat and stack shapes.</td>
81
+ <td>gap <code>--space-100</code>; row-2 indent at Count=Multiple with <code>showHandle</code> <code>calc(var(--space-1000) + var(--space-100))</code></td>
82
+ </tr>
83
+ <tr>
84
+ <td>sub-rows</td><td><code>&lt;div&gt;</code></td>
85
+ <td>The stack shape's sub-rows: Počet + Jednotka, Typ, Popis, DPH + Cena, Celkem + actions. Folded from the split threshold (624) up.</td>
86
+ <td>gap <code>--space-100</code></td>
87
+ </tr>
88
+ <tr>
89
+ <td><code>handle</code></td><td>IconButton <code>tertiary</code> <code>md</code>, <code>dots-six-vertical</code></td>
90
+ <td>Drag grip. Rendered only at Count=Multiple with <code>showHandle</code> on; hidden (<code>display: none</code>) below the split threshold (624).</td>
91
+ <td>40 × 40 (the atom's md)</td>
92
+ </tr>
93
+ <tr>
94
+ <td>Počet</td><td>NumberField in Field</td>
95
+ <td>Quantity with its two steppers; up to 4 decimals, typed with a comma or a dot and shown with the locale separator (<code>precision={4}</code>, e.g. 1,5 hod).</td>
96
+ <td>136 wide in split/flat (manifest 2.1.0); floor <code>--space-1300</code></td>
97
+ </tr>
98
+ <tr>
99
+ <td>Jednotka</td><td>Select in Field</td>
100
+ <td>Unit of measure.</td>
101
+ <td>96 wide in split/flat</td>
102
+ </tr>
103
+ <tr>
104
+ <td>Typ</td><td>Select in Field</td>
105
+ <td>Polish KSeF goods-vs-services column; rendered only at <code>columnSet="dph-typ"</code>.</td>
106
+ <td>120 wide in split/flat</td>
107
+ </tr>
108
+ <tr>
109
+ <td>Popis</td><td>Textarea in Field</td>
110
+ <td>Line description; no placeholder. The one column that grows in every shape. Auto-grows up to <code>maxRows=8</code>.</td>
111
+ <td>floor <code>--space-1300</code></td>
112
+ </tr>
113
+ <tr>
114
+ <td>DPH</td><td>Select in Field (TextField through <code>NumberFormatInput</code>, <code>inputMode="decimal"</code>, with <code>customVatRate</code>)</td>
115
+ <td>VAT rate; not rendered at <code>columnSet="basic"</code>. The rate input is the «Vlastní» custom-rate mode (<code>properties[customVatRate]</code>, manifest 2.2.0, see API).</td>
116
+ <td>100 wide in flat; floor <code>--space-1300</code></td>
117
+ </tr>
118
+ <tr>
119
+ <td>Cena</td><td>TextField in Field, <code>inputMode="decimal"</code>, through <code>NumberFormatInput</code></td>
120
+ <td>Unit price: locale separators, at most 2 decimals while typing, always 2 shown; the integer part never empties: deleting its last digit leaves <code>0,00</code> (reports 0) and a typed digit replaces that zero. No currency suffix.</td>
121
+ <td>100 / 120 / 150 wide in flat (see Sizes); floor <code>--space-1300</code></td>
122
+ </tr>
123
+ <tr>
124
+ <td>Celkem</td><td>TextField in Field, <code>readOnly</code></td>
125
+ <td>Computed line total, supplied by the consumer.</td>
126
+ <td>same widths as Cena; floor <code>--space-1300</code></td>
127
+ </tr>
128
+ <tr>
129
+ <td>actions</td><td><code>&lt;div&gt;</code> of IconButton <code>tertiary</code> <code>md</code></td>
130
+ <td>Discount (<code>percent</code>, when <code>showDiscount</code>), duplicate (<code>copy</code>), delete (<code>trash</code>, Count=Multiple only). Buttons stretch on the cross axis.</td>
131
+ <td>height <code>--space-1100</code> (48); gap <code>--space-400</code> stacked, <code>0</code> from the split threshold (624) up; each button 40 × 48</td>
132
+ </tr>
133
+ </tbody>
134
+ </table>
135
+
136
+ Every horizontal frame aligns its children to the top (`items-start`), so a field that grows — a
137
+ wrapping description, an error line — extends downward and never re-centres its neighbours.
138
+
139
+ ## Variants
140
+
141
+ The manifest has four axes plus two Figma booleans. Three of the axes map to a prop; of the Document
142
+ axis only its three Faktura values do.
143
+
144
+ <table>
145
+ <thead>
146
+ <tr><th>Figma property</th><th>Manifest key</th><th>Prop</th><th>Effect</th></tr>
147
+ </thead>
148
+ <tbody>
149
+ <tr>
150
+ <td>Document: Faktura DPH · Faktura Basic · Faktura DPH + Typ (its three Výdaje values are the expense row, not in this package)</td><td><code>axes.content</code></td>
151
+ <td><code>columnSet</code>: <code>'dph'</code> (default) · <code>'basic'</code> · <code>'dph-typ'</code></td>
152
+ <td><code>basic</code> drops the DPH column; <code>dph-typ</code> adds the Typ column. Switching the set re-measures every column (different floors and money widths).</td>
153
+ </tr>
154
+ <tr>
155
+ <td>Count: Multiple · Single</td><td><code>axes.type</code></td>
156
+ <td><code>lineCount</code> (the document's line count)</td>
157
+ <td><code>lineCount &gt; 1</code> renders the delete action and indents row-2, and renders the drag handle when <code>dragHandleProps</code> is passed too; <code>1</code> renders neither — absent from the tree, not hidden.</td>
158
+ </tr>
159
+ <tr>
160
+ <td>Position: First · Next</td><td><code>axes.placement</code></td>
161
+ <td><code>isFirstRow</code> (default <code>true</code>)</td>
162
+ <td><code>false</code> hides the column labels visually (<code>sr-only</code>) — only from the <code>flat</code> floor up, i.e. in table mode. In wrap mode every row shows its labels without any consumer logic.</td>
163
+ </tr>
164
+ <tr>
165
+ <td>Breakpoint: XL · LG · MD · SM · Mobile</td><td><code>axes.breakpoint</code></td>
166
+ <td>— (not a prop)</td>
167
+ <td>Read from the row's own container width — see Sizes.</td>
168
+ </tr>
169
+ <tr>
170
+ <td>Show discount</td><td><code>properties</code></td>
171
+ <td><code>showDiscount</code> (default <code>true</code>)</td>
172
+ <td>Renders the per-item discount action.</td>
173
+ </tr>
174
+ <tr>
175
+ <td>Show handle</td><td><code>properties</code></td>
176
+ <td><code>showHandle</code> (default <code>true</code>)</td>
177
+ <td>Off removes the drag handle and its handle-width row-2 indent at Count=Multiple (manifest 2.4.0) — for a host that does not reorder rows (e.g. a mini form). No effect at Count=Single, which never shows a handle.</td>
178
+ </tr>
179
+ </tbody>
180
+ </table>
181
+
182
+ <Canvas of={ItemRowStories.Matrix} />
183
+
184
+ ### Table and wrap mode
185
+
186
+ The row shape decides how the rows are labelled. **Table mode** is a row on one flat line (XL in
187
+ every column set, LG at DPH and Basic): only the first row passes `isFirstRow`, every later row
188
+ hides its labels visually and keeps each input named. **Wrap mode** is a stacked row (LG at
189
+ DPH + Typ, MD, SM, Mobile): the same `isFirstRow={false}` rows show their labels, because the
190
+ container query that hides them only applies from the table-mode floor up. Pass `isFirstRow` the
191
+ same way at every width.
192
+
193
+ <Canvas of={ItemRowStories.TableAndWrapMode} />
194
+
195
+ The gap between rows (`--space-200` in table mode, `--space-800` in wrap mode in the story) belongs
196
+ to the line items, not to ItemRow.
197
+
198
+ ## Sizes
199
+
200
+ **No Size axis** — every field stays Size md (48 tall) at every breakpoint; the row reflows, the
201
+ controls do not shrink. The Breakpoint is read from the row's **own container**: the root is
202
+ `@container/item-row`, and each layout switch is a container query against the container width.
203
+ The frame widths `chrome.breakpoint-widths` (XL 1110 · LG 864 · MD 624 · SM 544 · Mobile 342) are
204
+ the widths the Figma variants are drawn at.
205
+
206
+ Three shapes come out of the five breakpoints:
207
+
208
+ - **flat** — one line, columns `--space-100` apart (XL, and LG at DPH / Basic). Table mode.
209
+ - **split** — two lines: row-1 handle, Počet, Jednotka, Typ, Popis; row-2 DPH, Cena, Celkem,
210
+ actions (LG at DPH + Typ, MD — from a 624 px container up). Wrap mode.
211
+ - **stack** — five sub-rows `--space-500` apart, no handle (SM, Mobile — below 624 px, one layout).
212
+ At DPH and Basic the Typ sub-row is not rendered, so four render. Wrap mode.
213
+
214
+ ### Shape selection
215
+
216
+ - **LG → MD (flat → split)** follows the manifest's XL / LG floors (`chrome.min-container-width`,
217
+ manifest 2.1.0 — every floor holding Počet counts it at its fixed 136), raised by another 80 with
218
+ `wideDescription`.
219
+ - **MD → SM (split → stack)** sits at the MD frame: the split shape renders only from a **624 px**
220
+ container (`chrome.breakpoint-widths.MD`) up, for every Document × Count; below it the row stacks.
221
+ Manifest 2.1.0 sets every MD floor to the MD frame width, so no row renders a split layout below it
222
+ (`chrome.breakpoint-widths.note`); LG at DPH + Typ, whose computed split floor is lower, is bound
223
+ by the same 624.
224
+ - **Basic · Single flat floor is 684** — the manifest raises LG Basic Single to the Basic Multiple
225
+ floor (2.1.0), so the collapsed LG row never sits below the MD frame.
226
+ With `wideDescription` Basic flattens only at its XL floor + 80 (see `wideDescription` below).
227
+
228
+ Container thresholds in px (Multiple / Single; `wide` and `flat` are `chrome.min-container-width`, manifest 2.1.0):
229
+
230
+ <table>
231
+ <thead>
232
+ <tr>
233
+ <th>Document (Faktura)</th>
234
+ <th style={{ textAlign: 'right' }}>wide (money 150)</th>
235
+ <th style={{ textAlign: 'right' }}>flat</th>
236
+ <th style={{ textAlign: 'right' }}>split</th>
237
+ <th>Below 624</th>
238
+ </tr>
239
+ </thead>
240
+ <tbody>
241
+ <tr><td>DPH</td><td style={{ textAlign: 'right' }}>886 / 804</td><td style={{ textAlign: 'right' }}>786 / 704</td><td style={{ textAlign: 'right' }}>624</td><td>stack</td></tr>
242
+ <tr><td>Basic</td><td style={{ textAlign: 'right' }}>784 / 702</td><td style={{ textAlign: 'right' }}>684 / 684</td><td style={{ textAlign: 'right' }}>624</td><td>stack</td></tr>
243
+ <tr><td>DPH + Typ</td><td style={{ textAlign: 'right' }}>—</td><td style={{ textAlign: 'right' }}>948 / 866</td><td style={{ textAlign: 'right' }}>624</td><td>stack</td></tr>
244
+ </tbody>
245
+ </table>
246
+
247
+ - **flat** at DPH / Basic is the collapsed LG row: DPH, Cena and Celkem fixed at 100 each, Popis
248
+ takes the rest. From the **wide** (XL) floor up, Cena and Celkem widen to 150.
249
+ - **flat** at DPH + Typ is already XL (its LG row splits): DPH 100, Cena and Celkem 120.
250
+ - Fixed column widths in split / flat: Počet 136 (a Number Field md shows «1 000», manifest 2.1.0), Jednotka 96, Typ 120 (`chrome.columns[].width`).
251
+ The field columns floor at `--space-1300` (80).
252
+
253
+ Row heights from the manifest (`chrome.row-height`): flat 48; split 108; stack 228, or 288 with the
254
+ Typ sub-row. Resize the Playground canvas to watch the row step down:
255
+
256
+ <Canvas of={ItemRowStories.Playground} />
257
+
258
+ ## States
259
+
260
+ The row has **no state axis** of its own (manifest `intent.states`): interaction states live on the
261
+ composed atoms, and the row's frames carry no fill, stroke or hover treatment. The story renders the
262
+ states the row passes down, statically:
263
+
264
+ <Canvas of={ItemRowStories.States} />
265
+
266
+ - **Default** — every column editable; Celkem read-only.
267
+ - **Disabled** — `disabled` sets the native `disabled` on the `<fieldset>` and on every sub-control:
268
+ fields, steppers, selects, handle and actions (Celkem included).
269
+ - **Error** — `errors` takes a message per field (`ItemRowField` keys); the nested Field renders it
270
+ as its helper line and marks the input `aria-invalid`. The message grows the row downward.
271
+ - **Show discount off** — `showDiscount={false}` drops the discount action; the actions strip hugs
272
+ the remaining buttons.
273
+ - **Show handle off** — `showHandle={false}` drops the drag handle (and its empty slot) and, in the
274
+ split shape, the row-2 indent: row-2 starts flush with row-1. The container floors stay the
275
+ Count=Multiple ones.
276
+ - **Read-only (Celkem)** — a field state, not a disabled control: `readOnly`, still a tab stop.
277
+
278
+ ### Motion
279
+
280
+ The row itself animates nothing — manifest `motion` (2.3.0) belongs to the **list** that adds and
281
+ removes rows, so it lives in the consumer, which the story below mirrors. Every
282
+ row sits in `AnimatePresence` under a stable key. An added, duplicated or «Vybrat z uložených» row
283
+ fades in over `--duration-slow` / `--easing-enter` (opacity only, never a scale or slide) while its
284
+ room opens and the rows, the action bar and the totals below shift on `--spring-gentle`
285
+ (`layout="position"`). A deleted row fades out over `--duration-fast` / `--easing-exit` first and
286
+ becomes `inert`; only once the fade has ended do the rows below close up on `--spring-gentle`. Quick
287
+ successive changes turn around from where they are. Rows already present on load do not animate
288
+ (`initial={false}`). Under `prefers-reduced-motion` rows appear and vanish at once, with no shift.
289
+ Drag reorder (dnd-kit, so keyboard reordering and its announcements stay): the neighbours make way on
290
+ `--spring-gentle`, and the dropped row settles on `springs.gentle` carrying the pointer's release
291
+ velocity (a keyboard drop has none); the dragged row never scales. Under reduced motion both happen at once.
292
+
293
+ <Canvas of={ItemRowStories.Motion} />
294
+
295
+ ## API
296
+
297
+ <Controls of={ItemRowStories.Playground} />
298
+
299
+ - **`label`** (`string`, required) — the line's accessible name, rendered as the visually hidden
300
+ `<legend>`; it is also the suffix of every icon-only control's name.
301
+ - **`labels`** (`ItemRowLabels`, required) — every string the row renders or announces: the seven
302
+ column labels, the NumberField stepper names (`decrement`, `increment`) and the four icon-only
303
+ names (`handle`, `discount`, `duplicate`, `delete`). There are **no built-in defaults**, like
304
+ ActionRow and NumberField — a missing translation must not ship unnoticed.
305
+ - **`columnSet`** (`'dph' | 'basic' | 'dph-typ'`, default `'dph'`).
306
+ - **`lineCount`** (`number`, required) — the document's line count; `> 1` is Count=Multiple.
307
+ - **`isFirstRow`** (`boolean`, default `true`) — Position=First.
308
+ - **`showDiscount`** (`boolean`, default `true`).
309
+ - **`showHandle`** (`boolean`, default `true`) — `false` renders no drag handle and no row-2 indent
310
+ at Count=Multiple, whatever `dragHandleProps` says (manifest 2.4.0). For a host that does not
311
+ reorder rows. The container floors (`chrome.min-container-width`) stay the Count=Multiple ones: the
312
+ manifest authors no floor without the handle, so such a row goes flat no earlier than one with it.
313
+ - **`value`** (`ItemRowValue`, required) and **`onChange`** (`(patch) => void`, required) — a
314
+ controlled row. `onChange` fires with the changed field only (e.g. `{ price: 1200 }`).
315
+ `price` is the raw number — the Cena cell formats it per `locale` (2 decimals; a cleared field
316
+ reports `0`); `total` is a string computed by the consumer and rendered read-only.
317
+ `type` is read only at `dph-typ`, `vatRate` is not read at `basic`.
318
+ - **`unitOptions`** (required), **`vatRateOptions`**, **`typeOptions`** (`SelectOption[]`, the
319
+ latter two default `[]`).
320
+ - **`errors`** (`Partial<Record<ItemRowField, string>>`) — per-field error message.
321
+ - **`onDiscount`**, **`onDuplicate`**, **`onDelete`** — the row actions. The discount modal, the
322
+ duplicate and the delete logic are the consumer's.
323
+ - **`dragHandleProps`** / **`dragHandleRef`** — spread / ref onto the drag handle (e.g. dnd-kit's
324
+ `attributes` + `listeners` and `setActivatorNodeRef`). The handle renders only when the document
325
+ has more than one line, `showHandle` is on **and** `dragHandleProps` is passed — without them it would be a tab stop
326
+ that does nothing. The reorder logic stays with the consumer; the row only renders the grip.
327
+ - **`disabled`** (`boolean`, default `false`) — disables every control of the line.
328
+ - **`wideDescription`** (`boolean`, default `false`) — Popis keeps at least 160 px
329
+ (2 × `--space-1300`) on the flat line, so the row splits into two sub-rows 80 px earlier (the
330
+ manifest's flat and XL floors both rise by 80; no effect at `dph-typ`). At Basic the row skips the
331
+ 100 px money columns and flattens only at the raised XL floor, 864 / 782, with Cena and Celkem at
332
+ 150 straight away; at 100 the amounts truncated in a ~670 px host column. DPH
333
+ keeps both steps (866 / 784 flat, 966 / 884 wide). Not in the manifest; a mini form host may turn it on everywhere — see
334
+ Usage.
335
+ - **`locale`** (`string`, default `'cs'`) — the thousand / decimal separators of Cena and the custom
336
+ rate input (`'en'` reads `1,234.5`).
337
+ - **`customVatRate`** (`boolean`, default `false`) and **`onVatRateBlur`** (focus handler) — the DPH
338
+ cell renders a rate input (`TextField` through `NumberFormatInput`: locale separators, at most 2
339
+ decimals, `inputMode="decimal"`, no `%` suffix) instead of the Select, in the same Field (label, id,
340
+ error). It lets no letter, minus or rate above 100 in. `value.vatRate` is then the draft as a numeric
341
+ string (`'12.5'`) and `onChange` reports it per keystroke; the consumer commits on `onVatRateBlur`,
342
+ and decides when the input shows
343
+ (e.g. the „Vlastní“ option or a rate missing from the list). The «Vlastní» custom-rate
344
+ mode of manifest 2.2.0 (`properties[customVatRate]`, `slots.field-dph`): a 0–100 decimal rate,
345
+ the same label, id, error and width; a typed rate that matches an offered one returns the cell to
346
+ the Select on blur, and choosing «Vlastní» moves focus into the rate input — also after the mobile
347
+ bottom sheet closes (`focus.note`). Clamping, matching and focus are the consumer's job.
348
+ - Every other `<fieldset>` attribute (including `className`) goes to the root; `ref` points to the
349
+ `<fieldset>` (`forwardRef`).
350
+
351
+ ## Do / Don't
352
+
353
+ - ✅ Render one ItemRow per document line, in the rows zone of the line items (Form Block `content="stack"`).
354
+ - ✅ Pass the document's line count as `lineCount` to every row — it decides the delete action and, together with `dragHandleProps`, the handle.
355
+ - ✅ Turn `showHandle` off on every row of a host that does not reorder rows — no grip, no indent.
356
+ - ✅ Pass `isFirstRow` only to the first row, at every width; the container query decides whether later rows hide their labels.
357
+ - ✅ Give each row a distinct `label` (e.g. «Položka 2») — it names the line and its icon-only actions.
358
+ - ✅ Compute Celkem in the consumer and hand it in through `value.total`.
359
+ - ✅ Keep column labels to one short noun (≤ 12 characters, `text.column-label`); they truncate instead of widening the column.
360
+ - ✅ Let the row fill its container; size the container, not the row.
361
+ - ❌ Don't force a breakpoint from outside (a viewport media query or a wrapper class) — the row reads its own container width.
362
+ - ❌ Don't use ItemRow for a read-only record list or a rendered document — use Table, or plain output.
363
+ - ❌ Don't make Celkem editable or disabled; it is read-only.
364
+ - ❌ Don't add a currency suffix to Cena or Celkem — the document carries the currency.
365
+ - ❌ Don't turn `customVatRate` on as the default DPH cell — it is the «Vlastní» path for a rate missing from the list (manifest 2.2.0), the Select stays the norm.
366
+ - ❌ Don't add a placeholder to Popis.
367
+ - ❌ Don't add a gap between rows inside ItemRow — row spacing belongs to the line items.
368
+ - ❌ Don't hide the handle with CSS or drop `dragHandleProps` to get a handle-less row — the empty slot keeps the indent; use `showHandle={false}`.
369
+
370
+ ## Accessibility
371
+
372
+ - **Keyboard** — the row adds no key handling. Tab follows the DOM, which is the same in every
373
+ shape: handle → Počet (decrement, input, increment) → Jednotka → Typ (at `dph-typ`) → Popis →
374
+ DPH → Cena → Celkem (read-only, still a stop) → discount → duplicate → delete. The handle is in
375
+ the tree only at `lineCount > 1` with `showHandle` on and `dragHandleProps` passed; below the split threshold (624) it is
376
+ `display: none` and leaves the tab order.
377
+ - **Reorder.** ItemRow itself has no keyboard reorder — it adds no key handling to the handle. A
378
+ consumer that wires dnd-kit's `KeyboardSensor` through `dragHandleProps` (as a sortable items
379
+ form does) gets keyboard reorder at XL / LG / MD. At SM / Mobile the handle is absent, so there is no
380
+ reorder at all. A single-pointer alternative to dragging (WCAG 2.5.7) is missing at every width —
381
+ a known upstream gap (`form-block.md` → Known limitation), not a target; do not infer a move
382
+ control from this component.
383
+ - **Reorder localisation** — dnd-kit's `screenReaderInstructions`, `announcements` and
384
+ `roleDescription` are the consumer's to translate; ItemRow passes none of them.
385
+ - **ARIA** — the root `<fieldset>` is a group named by its visually hidden `<legend>` alone (no
386
+ `aria-labelledby` on the fieldset). Every field keeps its real `<label for>` in every row; on a table-mode Next
387
+ row the label is `sr-only`, so the input is still named. Icon-only controls are **line-scoped**:
388
+ `aria-labelledby` = the button's own `aria-label` + the legend, so a screen reader hears
389
+ «Smazat Položka 2», not a column of identical «Smazat».
390
+ - **Screen reader** — entering a line announces the group name («Položka 2»). An error is announced
391
+ through the field atom: `aria-invalid` plus the message as the input's description. ItemRow
392
+ renders no live region and moves no focus — announcing added / removed lines and placing focus
393
+ after a delete are the line items' job (`form-block.md` → Line-items accessibility).
394
+ - **Targets** — the three actions are the IconButton's own 40 wide, stretched to the strip's 48
395
+ height; at Count=Multiple they sit flush from the split threshold (624) up, a registered exception to the
396
+ adjacency minimum (manifest `chrome.hit-areas.adjacency`), and `--space-400` apart in the stack.
397
+ - **Contrast & motion** — the row paints nothing and animates nothing; colours, focus indicators and
398
+ the read-only treatment are the composed atoms'. The list's add / delete motion is opacity plus a
399
+ layout shift, and collapses to an instant change under `prefers-reduced-motion` (see
400
+ [States](#states) → Motion); a row on its way out is `inert`.
401
+
402
+ Accessibility floor for every FODS component: `spec/01-foundations/accessibility.md`.
403
+
404
+ ## Copy
405
+
406
+ Voice: the row writes no sentences. Its copy is short column nouns plus the values the user types
407
+ or picks (manifest `text`).
408
+
409
+ - **Column label** (`labels.quantity` … `labels.total`) — the column name above an input. One noun,
410
+ no article, no unit: the unit is its own column. Single line, max 12 characters; it truncates
411
+ rather than widening the column. The narrowest column is Jednotka at 96 px, so keep it short in
412
+ every language.
413
+ - **Description** (`value.description`) — the line description the user types. The field ships no
414
+ placeholder and reads as an empty field until the user types. If a placeholder is ever added, it
415
+ shows the shape of a good line (what was delivered plus its measure), never an instruction to
416
+ type, and fits one line at 158 px, the narrowest Popis width (LG, Faktura DPH, Count=Multiple).
417
+ There is no length cap on the typed value: it wraps, the field auto-grows from its single-line
418
+ height (48) and then scrolls internally; it is never truncated.
419
+ - **Amount** (Počet, Cena and the computed Celkem) — a typed numeric run. A grouped CZK amount with
420
+ two decimals (`1 234 567,00`) is 12 characters, the maximum; past that the value scrolls inside
421
+ the input rather than wrapping. Decimal comma and a space thousands separator, per the document's
422
+ locale (`locale`). The custom VAT rate (DPH = «Vlastní», `customVatRate`) is a run of the same
423
+ kind: a number from 0 to 100 with a decimal comma (`8,25`), no «%» suffix, since the column label
424
+ already says DPH.
425
+ - **Select value** (the option labels of `unitOptions`, `typeOptions`, `vatRateOptions`) — the
426
+ chosen option in Jednotka, Typ and DPH, picked from a list, never typed. Single line, max 10
427
+ characters; a longer option truncates instead of widening the column, so write option labels
428
+ short at the source. The DPH list ends with «Vlastní», the custom-rate option.
429
+
430
+ Canonical texts (manifest `text`):
431
+
432
+ <table>
433
+ <thead>
434
+ <tr><th>Run</th><th>Texts</th></tr>
435
+ </thead>
436
+ <tbody>
437
+ <tr><td>Column label</td><td>Počet, Jednotka, Typ, Popis, DPH, Cena, Celkem</td></tr>
438
+ <tr><td>Select value</td><td><code>ks</code>, <code>Zboží</code>, <code>0 %</code>, «Vlastní»</td></tr>
439
+ <tr><td>Amount</td><td><code>1 234 567,00</code>; custom VAT rate <code>8,25</code></td></tr>
440
+ </tbody>
441
+ </table>
442
+
443
+ ## Usage
444
+
445
+ ```tsx
446
+ import { ItemRow, type ItemRowLabels, type ItemRowValue } from '@invoiceonline/ui-react';
447
+
448
+ const labels: ItemRowLabels = {
449
+ quantity: 'Počet', unit: 'Jednotka', type: 'Typ', description: 'Popis',
450
+ vatRate: 'DPH', price: 'Cena', total: 'Celkem',
451
+ decrement: 'Snížit počet', increment: 'Zvýšit počet',
452
+ handle: 'Přesunout', discount: 'Sleva na položku', duplicate: 'Duplikovat', delete: 'Smazat',
453
+ };
454
+
455
+ // Good — one row per line; lineCount is the document's count, isFirstRow only on the first.
456
+ {lines.map((line, index) => (
457
+ <ItemRow
458
+ key={line.id}
459
+ label={`Položka ${index + 1}`}
460
+ labels={labels}
461
+ lineCount={lines.length}
462
+ isFirstRow={index === 0}
463
+ value={line.value}
464
+ onChange={patch => updateLine(line.id, patch)}
465
+ unitOptions={[{ value: 'ks', label: 'ks' }, { value: 'hod', label: 'hod' }]}
466
+ vatRateOptions={[{ value: '0', label: '0 %' }, { value: '21', label: '21 %' }]}
467
+ errors={line.errors}
468
+ onDiscount={() => openDiscount(line.id)}
469
+ onDuplicate={() => duplicateLine(line.id)}
470
+ onDelete={() => deleteLine(line.id)}
471
+ dragHandleProps={{ ...sortable.attributes, ...sortable.listeners }}
472
+ dragHandleRef={sortable.setActivatorNodeRef}
473
+ />
474
+ ))}
475
+ ```
476
+
477
+ ```tsx
478
+ // Don't — a per-row count, Next on every row, and a hard-coded breakpoint wrapper.
479
+ <div className="lg:w-[864px]">
480
+ <ItemRow label="Položka" lineCount={1} isFirstRow={false} … />
481
+ </div>
482
+ ```
483
+
484
+ ### Narrow hosts — `wideDescription`
485
+
486
+ The manifest's flat floors budget Popis at 80 px. A host whose items column sits just above a
487
+ flat floor (e.g. ~708 px at DPH · Single, manifest floor 704) then gets one flat line
488
+ with an 80 px description that never wraps. With `wideDescription` the row stays split until Popis
489
+ has 160 px on the flat line; a Basic row also waits for 150 px money columns. A mini form shared by several hosts can turn it on
490
+ everywhere, so every host keeps Popis usable. It
491
+ **deviates from the manifest floors on purpose**; `ItemRow` itself defaults to the manifest.
492
+
493
+ <Canvas of={ItemRowStories.WideDescription} />
494
+
495
+ ## Related
496
+
497
+ - [Form Block](?path=/docs/design-system-organisms-form-block--docs) — the line items are a Form
498
+ Block at `content="stack"`; ItemRow fills its rows zone. Row spacing, the action bar, totals,
499
+ live-region announcements and focus after add / delete belong there.
500
+ - Field atoms: [Field](?path=/docs/design-system-atoms-field--docs),
501
+ [TextField](?path=/docs/design-system-atoms-textfield--docs),
502
+ [NumberField](?path=/docs/design-system-atoms-numberfield--docs),
503
+ [Select](?path=/docs/design-system-organisms-select--docs),
504
+ [Textarea](?path=/docs/design-system-atoms-textarea--docs).
505
+ - [IconButton](?path=/docs/design-system-atoms-iconbutton--docs) — handle and row actions.
506
+ - Spec: `spec/05-organisms/form-block.md` → The row;
507
+ manifest `spec/05-organisms/item-row.manifest.json`.
508
+
509
+ ## Migration notes
510
+
511
+ Manifest 2.0.0 (2026-10-19): "MAJOR — the row reads its own Breakpoint from its container width (a
512
+ container query against chrome.min-container-width); there is no parent-set breakpoint prop."
513
+
514
+ Manifest 2.1.0 (2026-11-03): Počet is 136 where fixed (XL, LG, MD; was 104), every floor that holds
515
+ Počet rises by 32, every MD floor is 624 and LG Basic Single rises to 684. Manifest 2.2.0 (2026-11-03):
516
+ the DPH cell's «Vlastní» custom-rate mode (`customVatRate`) and the `focus` block. Both describe what
517
+ the code already rendered; nothing changed in the component.
518
+
519
+ Manifest 2.3.0 / 2.3.1 (2026-11-03): the `motion` block — opacity-only enter and exit, a
520
+ `--spring-gentle` layout shift and reorder settle, then `inherits` for the composed atoms. The row
521
+ component is unchanged; the motion belongs to the list that renders the rows (see
522
+ [States](#states) → Motion).
523
+
524
+ Manifest 2.4.0 (2026-11-09): the `Show handle` boolean — off removes the
525
+ handle and its indent at Count=Multiple. New `showHandle` prop (default `true`, so existing rows are
526
+ unchanged).
527
+
528
+ Manifest 2.4.1 (2026-11-10): `text.description` gives 158 as the narrowest Popis width (LG, DPH,
529
+ Count=Multiple; was 190), the value the geometry already produced. Manifest 3.0.0 (2026-11-10): the
530
+ manifest now also covers the expense row, and the `Columns` axis became `Document`. Its three Faktura
531
+ values are this component and map to `columnSet` as before; its three Výdaje values are a separate
532
+ code component that this package does not ship. The id became `item-row`, so the root carries
533
+ `data-fods-component="item-row"` (was `_item-row`). Nothing else changed in the component.