@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,698 @@
1
+ import React, { useEffect, useRef, useState, type ReactNode } from 'react';
2
+ import type { Meta, StoryObj } from '@storybook/react-vite';
3
+ import { expect, userEvent, waitFor, within } from 'storybook/test';
4
+ import { FileUpload, type FileUploadFile, type FileUploadProps } from './FileUpload';
5
+ import { Button } from '../button/Button';
6
+ import { Modal } from '../modal/Modal';
7
+ import { Section, Showcase } from '../../storybook/Section';
8
+ import { FORCE_FOCUS } from '../../storybook/forceStates';
9
+ import { componentDoc } from '../../storybook/componentDoc';
10
+
11
+ /**
12
+ * Built against `file-upload.manifest.json` version **1.11.0** (Figma node 6417-87039).
13
+ * A manifest bump reopens the component per COMPONENT-CODE-CONVENTIONS § DoD (e).
14
+ * DoD (d): accepted 2026-11-13 by the package maintainer in place of the designer, who may
15
+ * still fine-tune it; the open spec questions stay with the design owner.
16
+ *
17
+ * `axes.state` is the component's ONLY axis. It is not a prop (`axes.state` never is),
18
+ * so each entry carries the props that render it. Order mirrors the Figma component set.
19
+ */
20
+ const STATES = [
21
+ 'default',
22
+ 'uploading',
23
+ 'uploaded image',
24
+ 'uploaded file',
25
+ 'uploaded multi files',
26
+ 'error',
27
+ ] as const;
28
+
29
+ // There is deliberately no SIZES table: the manifest has one size (`sizes[0]` "Default",
30
+ // no `axes.size`), so there is no size dimension to cross.
31
+
32
+ const HELPER = 'Logo musí být ve formátu jpg, jpeg, gif nebo png.';
33
+ const ERROR = 'Soubor se nepodařilo nahrát.';
34
+
35
+ /** The props that render each manifest state, so the Matrix and the single-state stories cannot drift. */
36
+ const STATE_ARGS: Record<(typeof STATES)[number], Partial<FileUploadProps>> = {
37
+ default: {},
38
+ uploading: { loading: true, progress: 60 },
39
+ 'uploaded image': { files: [{ id: '1', name: 'logo-firmy.png', kind: 'image' }] },
40
+ 'uploaded file': {
41
+ label: 'Příloha',
42
+ helperText: 'Příloha musí být ve formátu pdf, jpg nebo png',
43
+ files: [{ id: '1', name: 'muj-soubor.pdf', kind: 'file' }],
44
+ },
45
+ 'uploaded multi files': {
46
+ label: 'Přílohy',
47
+ helperText: 'Přílohy musí být ve formátu pdf, jpg nebo png',
48
+ multiple: true,
49
+ files: [
50
+ { id: '1', name: 'faktura-2026-001.pdf', kind: 'file' },
51
+ { id: '2', name: 'dodaci-list.pdf', kind: 'file' },
52
+ { id: '3', name: 'uctenka.png', kind: 'file' },
53
+ ],
54
+ },
55
+ error: { error: ERROR },
56
+ };
57
+
58
+ /**
59
+ * No minWidth and no maxWidth: the drop-zone FILLS its column. The stories give it a
60
+ * realistic form column (8 × --space-1200) rather than centring a shrink-wrapped box.
61
+ */
62
+ const Frame = ({ children }: { children: ReactNode }) => (
63
+ <div className="w-full max-w-[calc(var(--space-1200)*8)]">{children}</div>
64
+ );
65
+
66
+ const meta = {
67
+ title: 'Design System/Atoms/FileUpload',
68
+ component: FileUpload,
69
+ parameters: {
70
+ layout: 'padded',
71
+ docs: {
72
+ description: {
73
+ component: componentDoc({
74
+ summary:
75
+ 'Drop-zone field for attaching a file or image inside a form. Reuses the Text Field shell (border, radius, floating label, helper line) with an 88-tall drop target and a preview row per attached file. All six manifest states are derived from content: `loading`, `files` + `kind`, `multiple`, `error`.',
76
+ useCases: [
77
+ 'Company logo in settings: a single image, `kind: "image"` for the 80×80 thumbnail + view action',
78
+ 'Invoice attachments: `multiple` renders the drop-zone above a stack of file rows',
79
+ 'A scanned document: `kind: "file"` shows the filename with a remove action, no preview',
80
+ '`loading` + `progress`: spinner and a fill that grows to the reported value',
81
+ '`error`: danger border and label, plus a `warning-circle` and the message below the shell',
82
+ ],
83
+ bestPractices: [
84
+ 'Reach for it only when the value IS a file: a fixed set of options is a Select, free text is a Text Field',
85
+ 'Always write the accepted formats into `helperText`; without it the user finds out by failing',
86
+ 'Validate what `onFilesSelect` hands over (count, type, size) and say what was rejected: the component passes every picked or dropped file through, verbatim',
87
+ 'Open the full image in a Modal from `onView`; the component only reports the intent',
88
+ "Keep it on a `--bg-primary` surface: the shell's fill and contrast are built for primary only",
89
+ 'Write errors impersonally and problem-first («Soubor se nepodařilo nahrát.»), never a bare «Chyba»',
90
+ 'The copy props default to Czech; an app with more language versions passes every one of them from its translations',
91
+ ],
92
+ knownIssues: [
93
+ 'The progress bar has no track (neither Figma nor the manifest draws one), so 0 % is not visually readable.',
94
+ 'Without a `progress` value the bar draws no fill and the spinner alone carries the activity: the manifest defines no indeterminate bar.',
95
+ 'No Drag-over state: drops work, but the manifest records the highlight as planned, not built.',
96
+ 'No `disabled` prop: the manifest has no Disabled state. Inside a disabled `<fieldset>` the trigger, the row actions and the input are switched off by the browser and a drop is ignored. The manifest defines no disabled look: the row actions dim through their own disabled styles, the trigger keeps its link ink.',
97
+ ],
98
+ docsLink: { label: 'spec/03-atoms/file-upload.md' },
99
+ }),
100
+ },
101
+ },
102
+ },
103
+ args: {
104
+ label: 'Logo',
105
+ helperText: HELPER,
106
+ // Explicit falsy defaults for every state-carrying prop, so a runtime sweep that sets
107
+ // one of them for a state has something to reset to before the next state.
108
+ loading: false,
109
+ error: '',
110
+ multiple: false,
111
+ files: [],
112
+ },
113
+ argTypes: {
114
+ progress: { control: { type: 'range', min: 0, max: 100, step: 1 } },
115
+ files: { control: 'object' },
116
+ accept: { control: 'text' },
117
+ onFilesSelect: { action: 'filesSelect' },
118
+ onRemove: { action: 'remove' },
119
+ onView: { action: 'view' },
120
+ },
121
+ } satisfies Meta<FileUploadProps>;
122
+
123
+ export default meta;
124
+ type Story = StoryObj<typeof meta>;
125
+
126
+ export const Playground: Story = {
127
+ parameters: {
128
+ docs: {
129
+ description: {
130
+ story:
131
+ 'Every prop under controls. There is no `state` control on purpose: the six manifest states are derived from content (`loading`, `files` + `kind`, `multiple`, `error`), so drive them from those props.',
132
+ },
133
+ },
134
+ },
135
+ render: args => (
136
+ <Frame>
137
+ <FileUpload {...args} />
138
+ </Frame>
139
+ ),
140
+ };
141
+
142
+ /**
143
+ * DoD (a): matrix coverage. One axis (`state`) and one size, so the matrix is a labelled
144
+ * column of all six states in Figma order.
145
+ */
146
+ export const Matrix: Story = {
147
+ parameters: {
148
+ docs: {
149
+ description: {
150
+ story: 'All six manifest states (`axes.state`), labelled, in the order of the Figma set. Single size.',
151
+ },
152
+ },
153
+ },
154
+ render: args => (
155
+ <Showcase>
156
+ {STATES.map(state => (
157
+ <Section key={state} title={state} layout="column">
158
+ <Frame>
159
+ <FileUpload {...args} {...STATE_ARGS[state]} />
160
+ </Frame>
161
+ </Section>
162
+ ))}
163
+ </Showcase>
164
+ ),
165
+ };
166
+
167
+ /**
168
+ * DoD (b). File Upload has no Hover, Active or Disabled state: the manifest says so ("No
169
+ * Hover state (parity with Text Field)"; `axes.state` has no Disabled), and Drag-over is
170
+ * planned, not built. Focus belongs to the trigger and the row Icon Buttons, never to the
171
+ * shell (`focus.note`). The first section forces the real `:focus-visible` with the
172
+ * pseudo-states addon; the second is for pressing Tab.
173
+ */
174
+ export const Focus: Story = {
175
+ parameters: {
176
+ docs: {
177
+ description: {
178
+ story:
179
+ 'The ring belongs to the trigger Text Link and to each row Icon Button, each with its own offset `:focus-visible` ring; the drop-zone frame does not recolour on focus (manifest `focus.note`). The first section forces the pseudo-state, the second one is live: press Tab.',
180
+ },
181
+ },
182
+ },
183
+ render: args => (
184
+ <Showcase>
185
+ <Section title="Forced :focus-visible: trigger and row actions" layout="column">
186
+ <div className={FORCE_FOCUS}>
187
+ <Frame>
188
+ <FileUpload {...args} />
189
+ </Frame>
190
+ </div>
191
+ <div className={FORCE_FOCUS}>
192
+ <Frame>
193
+ <FileUpload {...args} {...STATE_ARGS['uploaded image']} />
194
+ </Frame>
195
+ </div>
196
+ </Section>
197
+ <Section
198
+ title="Live: press Tab"
199
+ description="The native input is out of the tab order, so the trigger is the only tab stop that opens the file dialog; each row action is its own tab stop, named with the filename."
200
+ layout="column"
201
+ >
202
+ <Frame>
203
+ <FileUpload {...args} {...STATE_ARGS['uploaded image']} />
204
+ </Frame>
205
+ <Frame>
206
+ <FileUpload {...args} />
207
+ </Frame>
208
+ </Section>
209
+ </Showcase>
210
+ ),
211
+ play: async ({ canvasElement }) => {
212
+ const canvas = within(canvasElement);
213
+ const live = canvasElement.querySelectorAll('section')[1];
214
+ // The trigger is a real button and the file input is not a tab stop.
215
+ const triggers = within(live).getAllByRole('button', { name: 'Nahrajte svůj soubor Logo' });
216
+ await expect(triggers).toHaveLength(1);
217
+ for (const input of canvasElement.querySelectorAll('input[type="file"]')) {
218
+ await expect(input).toHaveAttribute('tabindex', '-1');
219
+ }
220
+ await expect(canvas.getAllByRole('button', { name: 'Zobrazit logo-firmy.png' }).length).toBeGreaterThan(0);
221
+ },
222
+ };
223
+
224
+ /**
225
+ * The content-driven states each get their OWN single-instance story: `files` is an array
226
+ * of objects, which a runtime sweep cannot push through scalar args, and one instance per
227
+ * story leaves a probe a single element per `data-fods-part`.
228
+ */
229
+ export const UploadedImage: Story = {
230
+ parameters: {
231
+ docs: {
232
+ description: {
233
+ story:
234
+ 'A single image replaces the drop-zone with a preview row: 80×80 thumbnail, filename, view and remove. The zone grows past its 88 floor to 112 (16 + 80 + 16). The placeholder is the `image` icon (`slots.thumbnail-icon`), swapped for the real preview once `previewUrl` is set.',
235
+ },
236
+ },
237
+ },
238
+ render: args => (
239
+ <Frame>
240
+ <FileUpload {...args} {...STATE_ARGS['uploaded image']} />
241
+ </Frame>
242
+ ),
243
+ };
244
+
245
+ export const UploadedFile: Story = {
246
+ parameters: {
247
+ docs: {
248
+ description: {
249
+ story:
250
+ 'A document gets the filename and remove only: no thumbnail and no view action, because there is nothing to preview.',
251
+ },
252
+ },
253
+ },
254
+ render: args => (
255
+ <Frame>
256
+ <FileUpload {...args} {...STATE_ARGS['uploaded file']} />
257
+ </Frame>
258
+ ),
259
+ };
260
+
261
+ export const UploadedMultiFiles: Story = {
262
+ parameters: {
263
+ docs: {
264
+ description: {
265
+ story:
266
+ '`multiple` keeps the drop-zone so more files can be added, and appends a stack of 56-tall rows BELOW the helper line, separated by 1px `--outline-default` rules between rows. Each row carries remove only (`slots.action-view` is Uploaded Image only). The rows are deliberately the legacy row, not List Row (manifest `backlog`).',
267
+ },
268
+ },
269
+ },
270
+ render: args => (
271
+ <Frame>
272
+ <FileUpload {...args} {...STATE_ARGS['uploaded multi files']} />
273
+ </Frame>
274
+ ),
275
+ };
276
+
277
+ export const Uploading: Story = {
278
+ parameters: {
279
+ docs: {
280
+ description: {
281
+ story:
282
+ 'With a `progress` number the fill grows to it from the start edge. Without one the bar draws no fill and claims no value; the spinner carries the activity. The upload start is announced once in the helper row.',
283
+ },
284
+ },
285
+ },
286
+ render: args => (
287
+ <Showcase>
288
+ <Section title="With a value: progress={60}" layout="column">
289
+ <Frame>
290
+ <FileUpload {...args} loading progress={60} />
291
+ </Frame>
292
+ </Section>
293
+ <Section
294
+ title="Without a value"
295
+ description="No aria-valuenow: claiming a value the component does not have would lie to assistive tech."
296
+ layout="column"
297
+ >
298
+ <Frame>
299
+ <FileUpload {...args} loading />
300
+ </Frame>
301
+ </Section>
302
+ </Showcase>
303
+ ),
304
+ };
305
+
306
+ export const Overflow: Story = {
307
+ parameters: {
308
+ docs: {
309
+ description: {
310
+ story:
311
+ 'The filename truncates on one line so the row actions stay put (`text.filename`: overflow truncate, lines 1), and only its base shrinks: the extension stays in view («… radek.pdf» reads as `….pdf`). The helper and the error message WRAP instead: a validation message must be fully visible (WCAG 3.3.1).',
312
+ },
313
+ },
314
+ },
315
+ render: args => (
316
+ <Showcase>
317
+ <Section title="Filename truncates" layout="column">
318
+ <Frame>
319
+ <FileUpload
320
+ {...args}
321
+ files={[
322
+ {
323
+ id: '1',
324
+ name: 'velmi-dlouhy-nazev-nahraneho-souboru-ktery-se-nevejde-na-jeden-radek.pdf',
325
+ kind: 'image',
326
+ },
327
+ ]}
328
+ />
329
+ </Frame>
330
+ </Section>
331
+ <Section title="Error message wraps" layout="column">
332
+ <Frame>
333
+ <FileUpload
334
+ {...args}
335
+ error={'Soubor je příliš velký — nahrát lze soubor o velikosti nejvýše 5\u00a0MB'}
336
+ />
337
+ </Frame>
338
+ </Section>
339
+ </Showcase>
340
+ ),
341
+ play: async ({ canvasElement }) => {
342
+ // Measured against the real CSS: the base is cut with an ellipsis, the extension is not.
343
+ const filename = canvasElement.querySelector<HTMLElement>('[data-fods-part="filename"]')!;
344
+ const [base, extension] = Array.from(filename.children) as HTMLElement[];
345
+ await expect(filename.textContent).toBe('velmi-dlouhy-nazev-nahraneho-souboru-ktery-se-nevejde-na-jeden-radek.pdf');
346
+ await expect(base.scrollWidth).toBeGreaterThan(base.clientWidth);
347
+ await expect(getComputedStyle(base).textOverflow).toBe('ellipsis');
348
+ await expect(extension.textContent).toBe('.pdf');
349
+ await expect(extension.scrollWidth).toBe(extension.clientWidth);
350
+ // The extension ends inside the filename box, right after the cut base.
351
+ await expect(extension.getBoundingClientRect().right).toBeLessThanOrEqual(filename.getBoundingClientRect().right);
352
+ await expect(extension.getBoundingClientRect().left).toBeGreaterThanOrEqual(base.getBoundingClientRect().right - 1);
353
+ },
354
+ };
355
+
356
+ /**
357
+ * There is no `disabled` prop (the manifest has no Disabled state). A disabled
358
+ * `<fieldset>` around the field switches its controls off natively; the component adds
359
+ * the parts the browser does not cover: a drop and a click on the drop-zone are ignored.
360
+ */
361
+ export const DisabledFieldset: Story = {
362
+ parameters: {
363
+ docs: {
364
+ description: {
365
+ story:
366
+ 'Inside `<fieldset disabled>` the trigger, the view and remove actions and the file input are disabled by the browser; a drop and a click on the drop-zone are ignored, and the pointer cursor falls back to the default. The manifest defines no disabled look, so what shows is mixed: the view and remove actions dim through their own disabled styles, while the trigger keeps its link ink.',
367
+ },
368
+ },
369
+ },
370
+ render: args => (
371
+ <fieldset disabled className="contents">
372
+ <Showcase>
373
+ <Section title="Default" layout="column">
374
+ <Frame>
375
+ <FileUpload {...args} />
376
+ </Frame>
377
+ </Section>
378
+ <Section title="Uploaded Image" layout="column">
379
+ <Frame>
380
+ <FileUpload {...args} {...STATE_ARGS['uploaded image']} />
381
+ </Frame>
382
+ </Section>
383
+ </Showcase>
384
+ </fieldset>
385
+ ),
386
+ play: async ({ canvasElement }) => {
387
+ const canvas = within(canvasElement);
388
+ await expect(canvas.getByRole('button', { name: 'Nahrajte svůj soubor Logo' })).toBeDisabled();
389
+ await expect(canvas.getByRole('button', { name: 'Zobrazit logo-firmy.png' })).toBeDisabled();
390
+ await expect(canvas.getByRole('button', { name: 'Odebrat logo-firmy.png' })).toBeDisabled();
391
+ for (const input of canvasElement.querySelectorAll('input[type="file"]')) {
392
+ await expect(input).toBeDisabled();
393
+ }
394
+ },
395
+ };
396
+
397
+ export const Width: Story = {
398
+ parameters: {
399
+ docs: {
400
+ description: {
401
+ story:
402
+ 'No minWidth and no maxWidth: the drop-zone FILLS its column, down to the 358 Mobile form column. Where the prompt does not fit on one line it wraps as one sentence, link words included; the icon stays on the first line and the zone grows past its 88 floor.',
403
+ },
404
+ },
405
+ },
406
+ render: args => (
407
+ <Showcase>
408
+ <Section title="Mobile form column (358): the prompt wraps" layout="column">
409
+ {/* 358 = 5 × 64 + 32 + 6, written in tokens so the demo stays on the scale. */}
410
+ <div className="w-[calc(var(--space-1200)*5+var(--space-900)+var(--space-300))]">
411
+ <FileUpload {...args} />
412
+ </div>
413
+ </Section>
414
+ <Section title="Filling a wide column: no maxWidth" layout="column">
415
+ <div className="w-full">
416
+ <FileUpload {...args} />
417
+ </div>
418
+ </Section>
419
+ </Showcase>
420
+ ),
421
+ };
422
+
423
+ /**
424
+ * Below SM the padding-block of the prompt and uploading zones drops from --space-900 to
425
+ * --space-700. It is a media query, so it only shows at a real phone viewport.
426
+ */
427
+ export const Mobile: Story = {
428
+ globals: { viewport: { value: 'mobile' } },
429
+ parameters: {
430
+ docs: {
431
+ description: {
432
+ story:
433
+ 'Below SM (640) the Default, Uploaded Multi Files, Error and Uploading zones pad 20 (`--space-700`) instead of 32, so the wrapped prompt does not make the zone tall on a phone.',
434
+ },
435
+ },
436
+ },
437
+ render: args => (
438
+ <Showcase>
439
+ <Section title="Default: the prompt wraps" layout="column">
440
+ <FileUpload {...args} />
441
+ </Section>
442
+ <Section title="Uploading" layout="column">
443
+ <FileUpload {...args} loading progress={60} />
444
+ </Section>
445
+ </Showcase>
446
+ ),
447
+ };
448
+
449
+ /**
450
+ * DoD (c), measured in Chromium against the real CSS: the zone floor and its one
451
+ * exception, the thumbnail, the progress fill and the legacy file row, each from the
452
+ * manifest (`sizes[0]`, `slots.spinner`). Not a docs example.
453
+ */
454
+ export const Geometry: Story = {
455
+ tags: ['!autodocs'],
456
+ render: args => (
457
+ <Showcase>
458
+ {(['default', 'uploading', 'uploaded image', 'uploaded file', 'uploaded multi files'] as const).map(state => (
459
+ <div key={state} data-testid={state}>
460
+ <Frame>
461
+ <FileUpload {...args} {...STATE_ARGS[state]} />
462
+ </Frame>
463
+ </div>
464
+ ))}
465
+ </Showcase>
466
+ ),
467
+ play: async ({ canvasElement }) => {
468
+ const box = (state: string, part: string) =>
469
+ canvasElement.querySelector(`[data-testid="${state}"] [data-fods-part="${part}"]`)!.getBoundingClientRect();
470
+
471
+ // 88 is a floor (a wrapped prompt grows past it); Uploaded File lands on it exactly.
472
+ await expect(box('default', 'container').height).toBeGreaterThanOrEqual(88);
473
+ await expect(box('uploaded file', 'container').height).toBe(88);
474
+ // Uploaded Image: 16 + the 80×80 thumbnail + 16.
475
+ await expect(box('uploaded image', 'container').height).toBe(112);
476
+ await expect(box('uploaded image', 'thumbnail').width).toBe(80);
477
+ await expect(box('uploaded image', 'thumbnail').height).toBe(80);
478
+ await expect(box('uploading', 'progress').height).toBe(3);
479
+ await expect(box('uploaded multi files', 'file-row').height).toBe(56);
480
+ // The placeholder glyph is the --size-icon box.
481
+ await expect(box('uploaded image', 'thumbnail-icon').width).toBe(24);
482
+ },
483
+ };
484
+
485
+ /** Ticks of the simulated transfer; harness pacing only, not a design value. */
486
+ const TICKS = [20, 45, 70, 90, 100];
487
+
488
+ /** The story's own stand-in for a consumer: validates, uploads (simulated) and previews. */
489
+ function InteractiveDemo({ shouldFail = false, multiple = false, ...args }: InteractiveArgs) {
490
+ const [files, setFiles] = useState<FileUploadFile[]>([]);
491
+ const [progress, setProgress] = useState<number | null>(null);
492
+ const [error, setError] = useState('');
493
+ const [viewed, setViewed] = useState<FileUploadFile | null>(null);
494
+ const timers = useRef<number[]>([]);
495
+ const nextId = useRef(1);
496
+
497
+ useEffect(
498
+ () => () => {
499
+ timers.current.forEach(window.clearTimeout);
500
+ },
501
+ [],
502
+ );
503
+
504
+ const upload = (picked: File[]) => {
505
+ timers.current.forEach(window.clearTimeout);
506
+ timers.current = [];
507
+ // The component hands over every file; counting them is the consumer's job.
508
+ if (!multiple && picked.length > 1) {
509
+ setError('Vybráno více souborů — nahrát lze jen jeden');
510
+ return;
511
+ }
512
+ setError('');
513
+ setProgress(0);
514
+ TICKS.forEach((percent, step) => {
515
+ timers.current.push(
516
+ window.setTimeout(() => {
517
+ setProgress(percent);
518
+ if (percent < 100) return;
519
+ setProgress(null);
520
+ if (shouldFail) {
521
+ setError(ERROR);
522
+ return;
523
+ }
524
+ const added = picked.map(file => {
525
+ const isImage = file.type.startsWith('image/');
526
+ return {
527
+ id: String(nextId.current++),
528
+ name: file.name,
529
+ kind: isImage ? 'image' : 'file',
530
+ previewUrl: isImage ? URL.createObjectURL(file) : undefined,
531
+ } satisfies FileUploadFile;
532
+ });
533
+ setFiles(current => (multiple ? [...current, ...added] : added));
534
+ }, 250 * (step + 1)),
535
+ );
536
+ });
537
+ };
538
+
539
+ const remove = (id: string) =>
540
+ setFiles(current => {
541
+ const gone = current.find(file => file.id === id);
542
+ if (gone?.previewUrl) URL.revokeObjectURL(gone.previewUrl);
543
+ return current.filter(file => file.id !== id);
544
+ });
545
+
546
+ return (
547
+ <Frame>
548
+ <FileUpload
549
+ {...args}
550
+ multiple={multiple}
551
+ files={files}
552
+ loading={progress !== null}
553
+ progress={progress ?? undefined}
554
+ error={error}
555
+ onFilesSelect={upload}
556
+ onRemove={remove}
557
+ onView={id => setViewed(files.find(file => file.id === id) ?? null)}
558
+ />
559
+ {/* The carrier of the view action (slots.action-view): a Compact Modal holding only
560
+ the image, contained, never cropped. */}
561
+ <Modal open={viewed != null} onClose={() => setViewed(null)} type="compact" size="md" title={viewed?.name}>
562
+ {viewed?.previewUrl && (
563
+ <img
564
+ src={viewed.previewUrl}
565
+ alt=""
566
+ // Contained, never cropped, and capped (slots.action-view): the card's width and a
567
+ // min(640px, 70vh) ceiling, so a tall image never pushes the Modal off screen.
568
+ // fods-lint-disable-next-line raw 640px / 70vh preview ceiling quoted from manifest slots.action-view; no token carries it
569
+ className="max-h-[min(640px,70vh)] w-full object-contain"
570
+ />
571
+ )}
572
+ </Modal>
573
+ </Frame>
574
+ );
575
+ }
576
+
577
+ /** The component's props plus the story-only switch for the failure path. */
578
+ type InteractiveArgs = FileUploadProps & { shouldFail?: boolean };
579
+
580
+ export const Interactive: StoryObj<Meta<InteractiveArgs>> = {
581
+ parameters: {
582
+ docs: {
583
+ description: {
584
+ story:
585
+ 'Driven by a simulated transfer kept in the story: pick or drop a file and the progress, the thumbnail (for an image), view and remove all work. Drop two files in single mode, or switch `shouldFail` on, to see the error copy. State transitions come from the demo, not from the controls.',
586
+ },
587
+ },
588
+ },
589
+ args: {
590
+ label: 'Logo',
591
+ helperText: HELPER,
592
+ accept: 'image/png,image/jpeg,image/gif',
593
+ shouldFail: false,
594
+ multiple: false,
595
+ },
596
+ argTypes: {
597
+ shouldFail: { control: 'boolean', name: 'shouldFail (simulate a failed upload)' },
598
+ // The demo owns every state-carrying prop; a live control would fight it.
599
+ files: { table: { disable: true } },
600
+ loading: { table: { disable: true } },
601
+ progress: { table: { disable: true } },
602
+ error: { table: { disable: true } },
603
+ },
604
+ render: args => <InteractiveDemo {...args} />,
605
+ play: async ({ canvasElement }) => {
606
+ const canvas = within(canvasElement);
607
+ const input = canvasElement.querySelector<HTMLInputElement>('input[type="file"]')!;
608
+
609
+ await userEvent.upload(input, new File(['x'], 'logo.png', { type: 'image/png' }));
610
+ await expect(await canvas.findByRole('progressbar', { name: 'Nahrávání souboru' })).toBeInTheDocument();
611
+ await waitFor(() => expect(canvas.getByRole('button', { name: 'Odebrat logo.png' })).toBeInTheDocument(), {
612
+ timeout: 4000,
613
+ });
614
+
615
+ await userEvent.click(canvas.getByRole('button', { name: 'Odebrat logo.png' }));
616
+ // The remove took its own button away: focus comes back to the trigger of the prompt.
617
+ await waitFor(() => expect(canvas.getByRole('button', { name: 'Nahrajte svůj soubor Logo' })).toHaveFocus());
618
+ },
619
+ };
620
+
621
+ /**
622
+ * Manifest `motion` harness. A fake transfer drives the swaps: prompt → uploading
623
+ * (spinner + a fill growing by scaleX) → uploaded. In stack mode every finished transfer
624
+ * appends a row; removing one fades it out before the rows close up.
625
+ */
626
+ function MotionDemo({ multiple, ...args }: FileUploadProps) {
627
+ const [files, setFiles] = useState<FileUploadFile[]>([]);
628
+ const [progress, setProgress] = useState<number | null>(null);
629
+ const nextId = useRef(1);
630
+
631
+ useEffect(() => {
632
+ if (progress === null) return undefined;
633
+ if (progress >= 100) {
634
+ const id = String(nextId.current++);
635
+ setFiles(current => [
636
+ ...(multiple ? current : []),
637
+ multiple
638
+ ? { id, name: `priloha-${id}.pdf`, kind: 'file' }
639
+ : { id, name: `logo-${id}.png`, kind: 'image' },
640
+ ]);
641
+ setProgress(null);
642
+ return undefined;
643
+ }
644
+ // Harness pacing only: a fake transfer, not a design value.
645
+ const timer = window.setTimeout(() => setProgress(value => (value ?? 0) + 25), 400);
646
+ return () => window.clearTimeout(timer);
647
+ }, [progress, multiple]);
648
+
649
+ return (
650
+ <div className="flex flex-col gap-400">
651
+ <div className="flex gap-400">
652
+ <Button type="button" variant="secondary" disabled={progress !== null} onClick={() => setProgress(0)}>
653
+ Nahrát ukázkový soubor
654
+ </Button>
655
+ <Button type="button" variant="tertiary" onClick={() => setFiles([])}>
656
+ Odebrat vše
657
+ </Button>
658
+ </div>
659
+ <Frame>
660
+ <FileUpload
661
+ {...args}
662
+ multiple={multiple}
663
+ files={files}
664
+ loading={progress !== null}
665
+ progress={progress ?? undefined}
666
+ onFilesSelect={() => setProgress(0)}
667
+ onRemove={id => setFiles(current => current.filter(file => file.id !== id))}
668
+ />
669
+ </Frame>
670
+ </div>
671
+ );
672
+ }
673
+
674
+ export const Motion: Story = {
675
+ parameters: {
676
+ docs: {
677
+ description: {
678
+ story:
679
+ 'Add / remove and state-swap motion (manifest `motion`). Press «Nahrát ukázkový soubor» a few times, then remove a row. The content that gives way fades out over `--duration-fast` + `--easing-exit`, then the zone height moves to the new content (88 → 112 for Uploaded Image) on `--spring-gentle` while the new content fades in over `--duration-slow` + `--easing-enter`; the bar fill grows by `scaleX` on `--duration-normal` + `--easing-standard`. In the stack a new row fades in while the rows settle on `--spring-gentle`; a removed row fades out first, then the rows below close up. Under `prefers-reduced-motion: reduce` rows and previews appear and vanish at once, the fill keeps tracking on `--duration-instant`, and the spinner keeps turning.',
680
+ },
681
+ },
682
+ },
683
+ render: args => (
684
+ <Showcase>
685
+ <Section title="Multi files: rows enter and leave" layout="column">
686
+ <MotionDemo
687
+ {...args}
688
+ label="Přílohy"
689
+ helperText="Přílohy musí být ve formátu pdf, jpg nebo png"
690
+ multiple
691
+ />
692
+ </Section>
693
+ <Section title="Single image: prompt → uploading → uploaded" layout="column">
694
+ <MotionDemo {...args} multiple={false} />
695
+ </Section>
696
+ </Showcase>
697
+ ),
698
+ };