@invoiceonline/ui-react 0.0.0-stage → 0.1.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 (738) hide show
  1. package/AGENTS.md +99 -0
  2. package/CHANGELOG.md +131 -0
  3. package/LICENSE +9 -0
  4. package/README.md +78 -2
  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-field/DateField.d.ts +52 -0
  60. package/dist/components/date-field/DateField.js +45 -0
  61. package/dist/components/date-field/index.d.ts +2 -0
  62. package/dist/components/date-field/index.js +1 -0
  63. package/dist/components/date-picker/DatePicker.d.ts +53 -0
  64. package/dist/components/date-picker/DatePicker.js +329 -0
  65. package/dist/components/date-picker/index.d.ts +2 -0
  66. package/dist/components/date-picker/index.js +1 -0
  67. package/dist/components/divider/Divider.d.ts +81 -0
  68. package/dist/components/divider/Divider.js +93 -0
  69. package/dist/components/divider/index.d.ts +2 -0
  70. package/dist/components/divider/index.js +1 -0
  71. package/dist/components/drawer/Drawer.d.ts +128 -0
  72. package/dist/components/drawer/Drawer.js +367 -0
  73. package/dist/components/drawer/index.d.ts +2 -0
  74. package/dist/components/drawer/index.js +1 -0
  75. package/dist/components/dropdown-button/DropdownButton.d.ts +72 -0
  76. package/dist/components/dropdown-button/DropdownButton.js +122 -0
  77. package/dist/components/dropdown-button/index.d.ts +2 -0
  78. package/dist/components/dropdown-button/index.js +1 -0
  79. package/dist/components/faq/FAQ.d.ts +135 -0
  80. package/dist/components/faq/FAQ.js +258 -0
  81. package/dist/components/faq/index.d.ts +2 -0
  82. package/dist/components/faq/index.js +1 -0
  83. package/dist/components/field/Field.d.ts +118 -0
  84. package/dist/components/field/Field.js +327 -0
  85. package/dist/components/field/index.d.ts +2 -0
  86. package/dist/components/field/index.js +1 -0
  87. package/dist/components/field-pair/FieldPair.d.ts +194 -0
  88. package/dist/components/field-pair/FieldPair.js +321 -0
  89. package/dist/components/field-pair/index.d.ts +2 -0
  90. package/dist/components/field-pair/index.js +1 -0
  91. package/dist/components/file-upload/FileUpload.d.ts +137 -0
  92. package/dist/components/file-upload/FileUpload.js +434 -0
  93. package/dist/components/file-upload/index.d.ts +2 -0
  94. package/dist/components/file-upload/index.js +1 -0
  95. package/dist/components/filter-chip/FilterChip.d.ts +373 -0
  96. package/dist/components/filter-chip/FilterChip.js +517 -0
  97. package/dist/components/filter-chip/index.d.ts +2 -0
  98. package/dist/components/filter-chip/index.js +1 -0
  99. package/dist/components/filter-facet/FilterFacet.d.ts +116 -0
  100. package/dist/components/filter-facet/FilterFacet.js +632 -0
  101. package/dist/components/filter-facet/index.d.ts +2 -0
  102. package/dist/components/filter-facet/index.js +1 -0
  103. package/dist/components/firm-avatar/FirmAvatar.d.ts +75 -0
  104. package/dist/components/firm-avatar/FirmAvatar.js +119 -0
  105. package/dist/components/firm-avatar/index.d.ts +2 -0
  106. package/dist/components/firm-avatar/index.js +1 -0
  107. package/dist/components/form-actions/FormActions.d.ts +123 -0
  108. package/dist/components/form-actions/FormActions.js +195 -0
  109. package/dist/components/form-actions/index.d.ts +2 -0
  110. package/dist/components/form-actions/index.js +1 -0
  111. package/dist/components/form-block/FormBlock.d.ts +252 -0
  112. package/dist/components/form-block/FormBlock.js +420 -0
  113. package/dist/components/form-block/index.d.ts +3 -0
  114. package/dist/components/form-block/index.js +3 -0
  115. package/dist/components/form-section/FormSection.d.ts +130 -0
  116. package/dist/components/form-section/FormSection.js +206 -0
  117. package/dist/components/form-section/index.d.ts +2 -0
  118. package/dist/components/form-section/index.js +1 -0
  119. package/dist/components/heading/Heading.d.ts +69 -0
  120. package/dist/components/heading/Heading.js +79 -0
  121. package/dist/components/heading/index.d.ts +2 -0
  122. package/dist/components/heading/index.js +1 -0
  123. package/dist/components/heading-group/HeadingGroup.d.ts +258 -0
  124. package/dist/components/heading-group/HeadingGroup.js +255 -0
  125. package/dist/components/heading-group/index.d.ts +2 -0
  126. package/dist/components/heading-group/index.js +1 -0
  127. package/dist/components/hero/Hero.d.ts +268 -0
  128. package/dist/components/hero/Hero.js +316 -0
  129. package/dist/components/hero/index.d.ts +2 -0
  130. package/dist/components/hero/index.js +1 -0
  131. package/dist/components/icon/Icon.d.ts +27 -0
  132. package/dist/components/icon/Icon.js +30 -0
  133. package/dist/components/icon/index.d.ts +3 -0
  134. package/dist/components/icon/index.js +3 -0
  135. package/dist/components/icon-button/IconButton.d.ts +75 -0
  136. package/dist/components/icon-button/IconButton.js +151 -0
  137. package/dist/components/icon-button/index.d.ts +2 -0
  138. package/dist/components/icon-button/index.js +1 -0
  139. package/dist/components/item-row/ItemRow.d.ts +253 -0
  140. package/dist/components/item-row/ItemRow.js +496 -0
  141. package/dist/components/item-row/index.d.ts +2 -0
  142. package/dist/components/item-row/index.js +1 -0
  143. package/dist/components/list-row/ListRow.d.ts +165 -0
  144. package/dist/components/list-row/ListRow.js +233 -0
  145. package/dist/components/list-row/index.d.ts +2 -0
  146. package/dist/components/list-row/index.js +1 -0
  147. package/dist/components/menu/Menu.d.ts +64 -0
  148. package/dist/components/menu/Menu.js +186 -0
  149. package/dist/components/menu/index.d.ts +2 -0
  150. package/dist/components/menu/index.js +1 -0
  151. package/dist/components/modal/Modal.d.ts +272 -0
  152. package/dist/components/modal/Modal.js +788 -0
  153. package/dist/components/modal/index.d.ts +2 -0
  154. package/dist/components/modal/index.js +1 -0
  155. package/dist/components/nav-link/NavLink.d.ts +123 -0
  156. package/dist/components/nav-link/NavLink.js +157 -0
  157. package/dist/components/nav-link/index.d.ts +2 -0
  158. package/dist/components/nav-link/index.js +1 -0
  159. package/dist/components/number-field/NumberField.d.ts +62 -0
  160. package/dist/components/number-field/NumberField.js +210 -0
  161. package/dist/components/number-field/index.d.ts +2 -0
  162. package/dist/components/number-field/index.js +1 -0
  163. package/dist/components/pagination/Pagination.d.ts +133 -0
  164. package/dist/components/pagination/Pagination.js +217 -0
  165. package/dist/components/pagination/index.d.ts +3 -0
  166. package/dist/components/pagination/index.js +3 -0
  167. package/dist/components/popover-surface/index.d.ts +2 -0
  168. package/dist/components/popover-surface/index.js +1 -0
  169. package/dist/components/progress-bar/ProgressBar.d.ts +260 -0
  170. package/dist/components/progress-bar/ProgressBar.js +470 -0
  171. package/dist/components/progress-bar/index.d.ts +2 -0
  172. package/dist/components/progress-bar/index.js +1 -0
  173. package/dist/components/promo-sticker/PromoSticker.d.ts +204 -0
  174. package/dist/components/promo-sticker/PromoSticker.js +177 -0
  175. package/dist/components/promo-sticker/index.d.ts +2 -0
  176. package/dist/components/promo-sticker/index.js +1 -0
  177. package/dist/components/promo-surface/PromoSurface.d.ts +94 -0
  178. package/dist/components/promo-surface/PromoSurface.js +119 -0
  179. package/dist/components/promo-surface/index.d.ts +2 -0
  180. package/dist/components/promo-surface/index.js +1 -0
  181. package/dist/components/radio/Radio.d.ts +92 -0
  182. package/dist/components/radio/Radio.js +171 -0
  183. package/dist/components/radio/index.d.ts +2 -0
  184. package/dist/components/radio/index.js +1 -0
  185. package/dist/components/radio-group/RadioGroup.d.ts +61 -0
  186. package/dist/components/radio-group/RadioGroup.js +51 -0
  187. package/dist/components/radio-group/index.d.ts +2 -0
  188. package/dist/components/radio-group/index.js +1 -0
  189. package/dist/components/select/Select.d.ts +65 -0
  190. package/dist/components/select/Select.js +176 -0
  191. package/dist/components/select/index.d.ts +2 -0
  192. package/dist/components/select/index.js +1 -0
  193. package/dist/components/select-field/SelectField.d.ts +16 -0
  194. package/dist/components/select-field/SelectField.js +55 -0
  195. package/dist/components/select-field/index.d.ts +2 -0
  196. package/dist/components/select-field/index.js +1 -0
  197. package/dist/components/skeleton/Skeleton.d.ts +64 -0
  198. package/dist/components/skeleton/Skeleton.js +65 -0
  199. package/dist/components/skeleton/index.d.ts +2 -0
  200. package/dist/components/skeleton/index.js +1 -0
  201. package/dist/components/split-button/SplitButton.d.ts +80 -0
  202. package/dist/components/split-button/SplitButton.js +182 -0
  203. package/dist/components/split-button/index.d.ts +2 -0
  204. package/dist/components/split-button/index.js +1 -0
  205. package/dist/components/status-summary-bar/StatusSummaryBar.d.ts +118 -0
  206. package/dist/components/status-summary-bar/StatusSummaryBar.js +278 -0
  207. package/dist/components/status-summary-bar/index.d.ts +2 -0
  208. package/dist/components/status-summary-bar/index.js +1 -0
  209. package/dist/components/subject-lookup-field/SubjectLookupField.d.ts +157 -0
  210. package/dist/components/subject-lookup-field/SubjectLookupField.js +663 -0
  211. package/dist/components/subject-lookup-field/index.d.ts +2 -0
  212. package/dist/components/subject-lookup-field/index.js +1 -0
  213. package/dist/components/switch/Switch.d.ts +152 -0
  214. package/dist/components/switch/Switch.js +307 -0
  215. package/dist/components/switch/index.d.ts +2 -0
  216. package/dist/components/switch/index.js +1 -0
  217. package/dist/components/table/Table.d.ts +5 -0
  218. package/dist/components/table/Table.js +601 -0
  219. package/dist/components/table/index.d.ts +6 -0
  220. package/dist/components/table/index.js +6 -0
  221. package/dist/components/text-field/TextField.d.ts +65 -0
  222. package/dist/components/text-field/TextField.js +173 -0
  223. package/dist/components/text-field/index.d.ts +2 -0
  224. package/dist/components/text-field/index.js +1 -0
  225. package/dist/components/text-link/TextLink.d.ts +260 -0
  226. package/dist/components/text-link/TextLink.js +303 -0
  227. package/dist/components/text-link/index.d.ts +2 -0
  228. package/dist/components/text-link/index.js +1 -0
  229. package/dist/components/textarea/Textarea.d.ts +93 -0
  230. package/dist/components/textarea/Textarea.js +256 -0
  231. package/dist/components/textarea/index.d.ts +2 -0
  232. package/dist/components/textarea/index.js +1 -0
  233. package/dist/components/tooltip/Tooltip.d.ts +129 -0
  234. package/dist/components/tooltip/Tooltip.js +457 -0
  235. package/dist/components/tooltip/index.d.ts +2 -0
  236. package/dist/components/tooltip/index.js +1 -0
  237. package/dist/components/unit-field/UnitField.d.ts +46 -0
  238. package/dist/components/unit-field/UnitField.js +133 -0
  239. package/dist/components/unit-field/index.d.ts +2 -0
  240. package/dist/components/unit-field/index.js +1 -0
  241. package/dist/icons/icon-registry.generated.js +500 -0
  242. package/dist/icons/icon-types.generated.d.ts +2 -0
  243. package/dist/icons/icon-types.generated.js +126 -0
  244. package/dist/index.d.ts +132 -0
  245. package/dist/index.js +75 -0
  246. package/dist/internal/BottomSheet.js +496 -0
  247. package/dist/internal/FodsProvider.d.ts +25 -0
  248. package/dist/internal/FodsProvider.js +32 -0
  249. package/dist/internal/MotionCaret.js +35 -0
  250. package/dist/internal/NumberFormatInput.d.ts +21 -0
  251. package/dist/internal/NumberFormatInput.js +126 -0
  252. package/dist/internal/SummaryDonut.d.ts +3 -0
  253. package/dist/internal/SummaryDonut.js +300 -0
  254. package/dist/internal/buttonSegment.d.ts +44 -0
  255. package/dist/internal/buttonSegment.js +126 -0
  256. package/dist/internal/collapseRoom.js +128 -0
  257. package/dist/internal/comboboxKeys.js +44 -0
  258. package/dist/internal/contentPresence.js +46 -0
  259. package/dist/internal/dayCell.js +95 -0
  260. package/dist/internal/dialogPortal.d.ts +2 -0
  261. package/dist/internal/dialogPortal.js +21 -0
  262. package/dist/internal/donutSweeps.js +65 -0
  263. package/dist/internal/enterOnViewGeometry.js +46 -0
  264. package/dist/internal/faqItem.js +80 -0
  265. package/dist/internal/floatingLabelMotion.js +68 -0
  266. package/dist/internal/formBlockContext.d.ts +22 -0
  267. package/dist/internal/formBlockContext.js +20 -0
  268. package/dist/internal/heightRoom.js +87 -0
  269. package/dist/internal/numberSeparators.js +62 -0
  270. package/dist/internal/overlayMotion.js +48 -0
  271. package/dist/internal/paginationItem.d.ts +8 -0
  272. package/dist/internal/paginationItem.js +22 -0
  273. package/dist/internal/popoverSurface.d.ts +8 -0
  274. package/dist/internal/popoverSurface.js +23 -0
  275. package/dist/internal/portalContainer.d.ts +1 -0
  276. package/dist/internal/portalContainer.js +6 -0
  277. package/dist/internal/progressBarItem.d.ts +207 -0
  278. package/dist/internal/progressBarItem.js +264 -0
  279. package/dist/internal/selectionControlText.js +12 -0
  280. package/dist/internal/statusSummaryParts.js +371 -0
  281. package/dist/internal/summaryMotion.js +75 -0
  282. package/dist/internal/table/ChildConnector.js +62 -0
  283. package/dist/internal/table/ChildRowPrefix.d.ts +9 -0
  284. package/dist/internal/table/ChildRowPrefix.js +27 -0
  285. package/dist/internal/table/ColumnSettings.js +135 -0
  286. package/dist/internal/table/ScrollRegion.js +114 -0
  287. package/dist/internal/table/TableEmpty.js +93 -0
  288. package/dist/internal/table/TableLayout.d.ts +17 -0
  289. package/dist/internal/table/TableLayout.js +29 -0
  290. package/dist/internal/table/TableLoadStatus.js +56 -0
  291. package/dist/internal/table/TableMobile.js +488 -0
  292. package/dist/internal/table/TruncatedCell.js +33 -0
  293. package/dist/internal/table/emptyValue.js +10 -0
  294. package/dist/internal/table/features.d.ts +41 -0
  295. package/dist/internal/table/features.js +31 -0
  296. package/dist/internal/table/recipes.js +227 -0
  297. package/dist/internal/table/rowClick.js +9 -0
  298. package/dist/internal/table/types.d.ts +325 -0
  299. package/dist/internal/table/types.js +13 -0
  300. package/dist/internal/tailwind-variants.d.ts +3 -0
  301. package/dist/internal/tailwind-variants.js +37 -0
  302. package/dist/internal/tooltipContext.js +5 -0
  303. package/dist/internal/tw-merge-config.generated.js +314 -0
  304. package/dist/internal/useAnchoredPanel.d.ts +87 -0
  305. package/dist/internal/useAnchoredPanel.js +108 -0
  306. package/dist/internal/useCountUp.js +53 -0
  307. package/dist/internal/useDateFieldTrigger.js +183 -0
  308. package/dist/internal/useEChart.js +59 -0
  309. package/dist/internal/useEnterOnView.js +42 -0
  310. package/dist/internal/useFloatingBar.js +100 -0
  311. package/dist/internal/useFormReset.js +37 -0
  312. package/dist/internal/useIsMobile.js +44 -0
  313. package/dist/internal/useOneRowOverflow.js +88 -0
  314. package/dist/internal/usePrefersReducedMotion.js +25 -0
  315. package/dist/internal/useReturnFocus.js +26 -0
  316. package/dist/internal/utils.d.ts +7 -0
  317. package/dist/internal/utils.js +58 -0
  318. package/dist/node_modules/@tanstack/store/dist/store.d.ts +29 -0
  319. package/dist/node_modules/@tanstack/store/dist/types.d.ts +38 -0
  320. package/dist/node_modules/@tanstack/table-core/dist/core/cells/coreCellsFeature.d.ts +6 -0
  321. package/dist/node_modules/@tanstack/table-core/dist/core/cells/coreCellsFeature.types.d.ts +53 -0
  322. package/dist/node_modules/@tanstack/table-core/dist/core/columns/coreColumnsFeature.d.ts +6 -0
  323. package/dist/node_modules/@tanstack/table-core/dist/core/columns/coreColumnsFeature.types.d.ts +90 -0
  324. package/dist/node_modules/@tanstack/table-core/dist/core/coreFeatures.d.ts +17 -0
  325. package/dist/node_modules/@tanstack/table-core/dist/core/headers/coreHeadersFeature.d.ts +6 -0
  326. package/dist/node_modules/@tanstack/table-core/dist/core/headers/coreHeadersFeature.types.d.ts +114 -0
  327. package/dist/node_modules/@tanstack/table-core/dist/core/reactivity/coreReactivityFeature.types.d.ts +51 -0
  328. package/dist/node_modules/@tanstack/table-core/dist/core/row-models/coreRowModelsFeature.d.ts +6 -0
  329. package/dist/node_modules/@tanstack/table-core/dist/core/row-models/coreRowModelsFeature.types.d.ts +29 -0
  330. package/dist/node_modules/@tanstack/table-core/dist/core/rows/coreRowsFeature.d.ts +6 -0
  331. package/dist/node_modules/@tanstack/table-core/dist/core/rows/coreRowsFeature.types.d.ts +129 -0
  332. package/dist/node_modules/@tanstack/table-core/dist/core/table/coreTablesFeature.d.ts +6 -0
  333. package/dist/node_modules/@tanstack/table-core/dist/core/table/coreTablesFeature.types.d.ts +203 -0
  334. package/dist/node_modules/@tanstack/table-core/dist/features/cell-selection/cellSelectionFeature.d.ts +6 -0
  335. package/dist/node_modules/@tanstack/table-core/dist/features/cell-selection/cellSelectionFeature.types.d.ts +294 -0
  336. package/dist/node_modules/@tanstack/table-core/dist/features/cell-spanning/cellSpanningFeature.d.ts +11 -0
  337. package/dist/node_modules/@tanstack/table-core/dist/features/cell-spanning/cellSpanningFeature.types.d.ts +148 -0
  338. package/dist/node_modules/@tanstack/table-core/dist/features/column-faceting/columnFacetingFeature.d.ts +12 -0
  339. package/dist/node_modules/@tanstack/table-core/dist/features/column-faceting/columnFacetingFeature.types.d.ts +63 -0
  340. package/dist/node_modules/@tanstack/table-core/dist/features/column-filtering/columnFilteringFeature.d.ts +6 -0
  341. package/dist/node_modules/@tanstack/table-core/dist/features/column-filtering/columnFilteringFeature.types.d.ts +209 -0
  342. package/dist/node_modules/@tanstack/table-core/dist/features/column-filtering/filterFns.d.ts +35 -0
  343. package/dist/node_modules/@tanstack/table-core/dist/features/column-grouping/columnGroupingFeature.d.ts +6 -0
  344. package/dist/node_modules/@tanstack/table-core/dist/features/column-grouping/columnGroupingFeature.types.d.ts +128 -0
  345. package/dist/node_modules/@tanstack/table-core/dist/features/column-ordering/columnOrderingFeature.d.ts +6 -0
  346. package/dist/node_modules/@tanstack/table-core/dist/features/column-ordering/columnOrderingFeature.types.d.ts +82 -0
  347. package/dist/node_modules/@tanstack/table-core/dist/features/column-pinning/columnPinningFeature.d.ts +11 -0
  348. package/dist/node_modules/@tanstack/table-core/dist/features/column-pinning/columnPinningFeature.types.d.ts +195 -0
  349. package/dist/node_modules/@tanstack/table-core/dist/features/column-resizing/columnResizingFeature.d.ts +6 -0
  350. package/dist/node_modules/@tanstack/table-core/dist/features/column-resizing/columnResizingFeature.types.d.ts +73 -0
  351. package/dist/node_modules/@tanstack/table-core/dist/features/column-sizing/columnSizingFeature.d.ts +6 -0
  352. package/dist/node_modules/@tanstack/table-core/dist/features/column-sizing/columnSizingFeature.types.d.ts +134 -0
  353. package/dist/node_modules/@tanstack/table-core/dist/features/column-visibility/columnVisibilityFeature.d.ts +6 -0
  354. package/dist/node_modules/@tanstack/table-core/dist/features/column-visibility/columnVisibilityFeature.types.d.ts +92 -0
  355. package/dist/node_modules/@tanstack/table-core/dist/features/global-filtering/globalFilteringFeature.d.ts +6 -0
  356. package/dist/node_modules/@tanstack/table-core/dist/features/global-filtering/globalFilteringFeature.types.d.ts +67 -0
  357. package/dist/node_modules/@tanstack/table-core/dist/features/row-aggregation/aggregationFns.d.ts +23 -0
  358. package/dist/node_modules/@tanstack/table-core/dist/features/row-aggregation/rowAggregationFeature.d.ts +6 -0
  359. package/dist/node_modules/@tanstack/table-core/dist/features/row-aggregation/rowAggregationFeature.types.d.ts +183 -0
  360. package/dist/node_modules/@tanstack/table-core/dist/features/row-aggregation/rowAggregationFeature.utils.d.ts +18 -0
  361. package/dist/node_modules/@tanstack/table-core/dist/features/row-expanding/rowExpandingFeature.d.ts +6 -0
  362. package/dist/node_modules/@tanstack/table-core/dist/features/row-expanding/rowExpandingFeature.types.d.ts +125 -0
  363. package/dist/node_modules/@tanstack/table-core/dist/features/row-pagination/rowPaginationFeature.d.ts +6 -0
  364. package/dist/node_modules/@tanstack/table-core/dist/features/row-pagination/rowPaginationFeature.types.d.ts +135 -0
  365. package/dist/node_modules/@tanstack/table-core/dist/features/row-pinning/rowPinningFeature.d.ts +6 -0
  366. package/dist/node_modules/@tanstack/table-core/dist/features/row-pinning/rowPinningFeature.types.d.ts +76 -0
  367. package/dist/node_modules/@tanstack/table-core/dist/features/row-selection/rowSelectionFeature.d.ts +6 -0
  368. package/dist/node_modules/@tanstack/table-core/dist/features/row-selection/rowSelectionFeature.types.d.ts +187 -0
  369. package/dist/node_modules/@tanstack/table-core/dist/features/row-sorting/rowSortingFeature.d.ts +6 -0
  370. package/dist/node_modules/@tanstack/table-core/dist/features/row-sorting/rowSortingFeature.types.d.ts +236 -0
  371. package/dist/node_modules/@tanstack/table-core/dist/features/row-sorting/sortFns.d.ts +23 -0
  372. package/dist/node_modules/@tanstack/table-core/dist/features/stockFeatures.d.ts +37 -0
  373. package/dist/node_modules/@tanstack/table-core/dist/helpers/columnHelper.d.ts +47 -0
  374. package/dist/node_modules/@tanstack/table-core/dist/types/Cell.d.ts +16 -0
  375. package/dist/node_modules/@tanstack/table-core/dist/types/Column.d.ts +30 -0
  376. package/dist/node_modules/@tanstack/table-core/dist/types/ColumnDef.d.ts +123 -0
  377. package/dist/node_modules/@tanstack/table-core/dist/types/Header.d.ts +12 -0
  378. package/dist/node_modules/@tanstack/table-core/dist/types/HeaderGroup.d.ts +6 -0
  379. package/dist/node_modules/@tanstack/table-core/dist/types/Row.d.ts +24 -0
  380. package/dist/node_modules/@tanstack/table-core/dist/types/RowModel.d.ts +19 -0
  381. package/dist/node_modules/@tanstack/table-core/dist/types/RowModelFns.d.ts +11 -0
  382. package/dist/node_modules/@tanstack/table-core/dist/types/Table.d.ts +53 -0
  383. package/dist/node_modules/@tanstack/table-core/dist/types/TableFeatures.d.ts +416 -0
  384. package/dist/node_modules/@tanstack/table-core/dist/types/TableOptions.d.ts +78 -0
  385. package/dist/node_modules/@tanstack/table-core/dist/types/TableState.d.ts +46 -0
  386. package/dist/node_modules/@tanstack/table-core/dist/types/type-utils.d.ts +25 -0
  387. package/dist/shared.css +179 -0
  388. package/dist/styles.css +5467 -0
  389. package/dist/theme.css +314 -0
  390. package/dist/theme.map.json +278 -0
  391. package/dist/tokens/index.d.ts +2 -0
  392. package/dist/tokens/index.js +1 -0
  393. package/dist/tokens/tokens.generated.d.ts +2040 -0
  394. package/dist/tokens/tokens.generated.js +2053 -0
  395. package/dist/tokens.css +484 -0
  396. package/dist/tokens.flat.json +429 -0
  397. package/docs/Consuming.mdx +379 -0
  398. package/docs/Contributing.mdx +78 -0
  399. package/docs/ForAgents.mdx +53 -0
  400. package/docs/Introduction.mdx +54 -0
  401. package/llms.txt +556 -0
  402. package/package.json +357 -4
  403. package/src/components/action-row/ActionRow.mdx +686 -0
  404. package/src/components/action-row/ActionRow.stories.tsx +669 -0
  405. package/src/components/action-row/ActionRow.tsx +632 -0
  406. package/src/components/action-row/index.ts +9 -0
  407. package/src/components/alert/Alert.mdx +377 -0
  408. package/src/components/alert/Alert.stories.tsx +674 -0
  409. package/src/components/alert/Alert.tsx +579 -0
  410. package/src/components/alert/index.ts +13 -0
  411. package/src/components/anchored-panel/AnchoredPanel.mdx +381 -0
  412. package/src/components/anchored-panel/AnchoredPanel.stories.tsx +593 -0
  413. package/src/components/anchored-panel/AnchoredPanel.tsx +176 -0
  414. package/src/components/anchored-panel/index.ts +15 -0
  415. package/src/components/badge/Badge.mdx +487 -0
  416. package/src/components/badge/Badge.stories.tsx +375 -0
  417. package/src/components/badge/Badge.tsx +360 -0
  418. package/src/components/badge/index.ts +10 -0
  419. package/src/components/banner/Banner.mdx +704 -0
  420. package/src/components/banner/Banner.stories.tsx +448 -0
  421. package/src/components/banner/Banner.tsx +602 -0
  422. package/src/components/banner/index.ts +14 -0
  423. package/src/components/button/Button.mdx +286 -0
  424. package/src/components/button/Button.stories.tsx +381 -0
  425. package/src/components/button/Button.tsx +384 -0
  426. package/src/components/button/index.ts +1 -0
  427. package/src/components/button-group/ButtonGroup.mdx +512 -0
  428. package/src/components/button-group/ButtonGroup.stories.tsx +714 -0
  429. package/src/components/button-group/ButtonGroup.tsx +491 -0
  430. package/src/components/button-group/index.ts +10 -0
  431. package/src/components/card-select/CardSelect.mdx +662 -0
  432. package/src/components/card-select/CardSelect.stories.tsx +784 -0
  433. package/src/components/card-select/CardSelect.tsx +783 -0
  434. package/src/components/card-select/CardSelectGroup.tsx +169 -0
  435. package/src/components/card-select/index.ts +18 -0
  436. package/src/components/checkbox/Checkbox.mdx +269 -0
  437. package/src/components/checkbox/Checkbox.stories.tsx +306 -0
  438. package/src/components/checkbox/Checkbox.tsx +343 -0
  439. package/src/components/checkbox/index.ts +1 -0
  440. package/src/components/chip/Chip.mdx +683 -0
  441. package/src/components/chip/Chip.stories.tsx +734 -0
  442. package/src/components/chip/Chip.tsx +732 -0
  443. package/src/components/chip/index.ts +9 -0
  444. package/src/components/column-header/ColumnHeader.mdx +301 -0
  445. package/src/components/column-header/ColumnHeader.stories.tsx +319 -0
  446. package/src/components/column-header/ColumnHeader.tsx +287 -0
  447. package/src/components/column-header/index.ts +7 -0
  448. package/src/components/combobox-field/Combobox.tsx +693 -0
  449. package/src/components/combobox-field/ComboboxField.mdx +525 -0
  450. package/src/components/combobox-field/ComboboxField.stories.tsx +502 -0
  451. package/src/components/combobox-field/ComboboxField.tsx +259 -0
  452. package/src/components/combobox-field/index.ts +12 -0
  453. package/src/components/date-field/DateField.mdx +340 -0
  454. package/src/components/date-field/DateField.stories.tsx +221 -0
  455. package/src/components/date-field/DateField.tsx +176 -0
  456. package/src/components/date-field/index.ts +1 -0
  457. package/src/components/date-picker/DatePicker.mdx +436 -0
  458. package/src/components/date-picker/DatePicker.stories.tsx +458 -0
  459. package/src/components/date-picker/DatePicker.tsx +688 -0
  460. package/src/components/date-picker/index.ts +9 -0
  461. package/src/components/divider/Divider.mdx +256 -0
  462. package/src/components/divider/Divider.stories.tsx +177 -0
  463. package/src/components/divider/Divider.tsx +193 -0
  464. package/src/components/divider/index.ts +1 -0
  465. package/src/components/drawer/Drawer.mdx +518 -0
  466. package/src/components/drawer/Drawer.stories.tsx +392 -0
  467. package/src/components/drawer/Drawer.tsx +683 -0
  468. package/src/components/drawer/index.ts +1 -0
  469. package/src/components/dropdown-button/DropdownButton.mdx +285 -0
  470. package/src/components/dropdown-button/DropdownButton.stories.tsx +398 -0
  471. package/src/components/dropdown-button/DropdownButton.tsx +198 -0
  472. package/src/components/dropdown-button/index.ts +7 -0
  473. package/src/components/faq/FAQ.mdx +364 -0
  474. package/src/components/faq/FAQ.stories.tsx +343 -0
  475. package/src/components/faq/FAQ.tsx +337 -0
  476. package/src/components/faq/index.ts +1 -0
  477. package/src/components/field/Field.mdx +129 -0
  478. package/src/components/field/Field.stories.tsx +461 -0
  479. package/src/components/field/Field.tsx +765 -0
  480. package/src/components/field/index.ts +20 -0
  481. package/src/components/field-pair/FieldPair.mdx +308 -0
  482. package/src/components/field-pair/FieldPair.stories.tsx +530 -0
  483. package/src/components/field-pair/FieldPair.tsx +796 -0
  484. package/src/components/field-pair/index.ts +9 -0
  485. package/src/components/file-upload/FileUpload.mdx +345 -0
  486. package/src/components/file-upload/FileUpload.stories.tsx +698 -0
  487. package/src/components/file-upload/FileUpload.tsx +802 -0
  488. package/src/components/file-upload/index.ts +6 -0
  489. package/src/components/filter-chip/FilterChip.mdx +778 -0
  490. package/src/components/filter-chip/FilterChip.stories.tsx +827 -0
  491. package/src/components/filter-chip/FilterChip.tsx +881 -0
  492. package/src/components/filter-chip/index.ts +11 -0
  493. package/src/components/filter-facet/FilterFacet.mdx +536 -0
  494. package/src/components/filter-facet/FilterFacet.stories.tsx +506 -0
  495. package/src/components/filter-facet/FilterFacet.tsx +1160 -0
  496. package/src/components/filter-facet/index.ts +7 -0
  497. package/src/components/firm-avatar/FirmAvatar.mdx +280 -0
  498. package/src/components/firm-avatar/FirmAvatar.stories.tsx +147 -0
  499. package/src/components/firm-avatar/FirmAvatar.tsx +172 -0
  500. package/src/components/firm-avatar/index.ts +7 -0
  501. package/src/components/form-actions/FormActions.mdx +518 -0
  502. package/src/components/form-actions/FormActions.stories.tsx +621 -0
  503. package/src/components/form-actions/FormActions.tsx +273 -0
  504. package/src/components/form-actions/index.ts +6 -0
  505. package/src/components/form-block/FormBlock.mdx +728 -0
  506. package/src/components/form-block/FormBlock.stories.tsx +813 -0
  507. package/src/components/form-block/FormBlock.tsx +679 -0
  508. package/src/components/form-block/index.ts +13 -0
  509. package/src/components/form-section/FormSection.mdx +436 -0
  510. package/src/components/form-section/FormSection.stories.tsx +407 -0
  511. package/src/components/form-section/FormSection.tsx +290 -0
  512. package/src/components/form-section/index.ts +17 -0
  513. package/src/components/heading/Heading.mdx +206 -0
  514. package/src/components/heading/Heading.stories.tsx +169 -0
  515. package/src/components/heading/Heading.tsx +124 -0
  516. package/src/components/heading/index.ts +8 -0
  517. package/src/components/heading-group/HeadingGroup.mdx +521 -0
  518. package/src/components/heading-group/HeadingGroup.stories.tsx +353 -0
  519. package/src/components/heading-group/HeadingGroup.tsx +396 -0
  520. package/src/components/heading-group/index.ts +7 -0
  521. package/src/components/hero/Hero.mdx +742 -0
  522. package/src/components/hero/Hero.stories.tsx +527 -0
  523. package/src/components/hero/Hero.tsx +807 -0
  524. package/src/components/hero/index.ts +1 -0
  525. package/src/components/icon/Icon.mdx +329 -0
  526. package/src/components/icon/Icon.stories.tsx +398 -0
  527. package/src/components/icon/Icon.tsx +97 -0
  528. package/src/components/icon/index.ts +2 -0
  529. package/src/components/icon-button/IconButton.mdx +206 -0
  530. package/src/components/icon-button/IconButton.stories.tsx +341 -0
  531. package/src/components/icon-button/IconButton.tsx +273 -0
  532. package/src/components/icon-button/index.ts +1 -0
  533. package/src/components/item-row/ItemRow.mdx +533 -0
  534. package/src/components/item-row/ItemRow.stories.tsx +434 -0
  535. package/src/components/item-row/ItemRow.tsx +676 -0
  536. package/src/components/item-row/index.ts +9 -0
  537. package/src/components/list-row/ListRow.mdx +404 -0
  538. package/src/components/list-row/ListRow.stories.tsx +404 -0
  539. package/src/components/list-row/ListRow.tsx +424 -0
  540. package/src/components/list-row/index.ts +1 -0
  541. package/src/components/menu/Menu.mdx +268 -0
  542. package/src/components/menu/Menu.stories.tsx +455 -0
  543. package/src/components/menu/Menu.tsx +452 -0
  544. package/src/components/menu/index.ts +1 -0
  545. package/src/components/modal/Modal.mdx +854 -0
  546. package/src/components/modal/Modal.stories.tsx +881 -0
  547. package/src/components/modal/Modal.tsx +1434 -0
  548. package/src/components/modal/index.ts +1 -0
  549. package/src/components/nav-link/NavLink.mdx +196 -0
  550. package/src/components/nav-link/NavLink.stories.tsx +243 -0
  551. package/src/components/nav-link/NavLink.tsx +222 -0
  552. package/src/components/nav-link/index.ts +1 -0
  553. package/src/components/number-field/NumberField.mdx +223 -0
  554. package/src/components/number-field/NumberField.stories.tsx +291 -0
  555. package/src/components/number-field/NumberField.tsx +388 -0
  556. package/src/components/number-field/index.ts +6 -0
  557. package/src/components/pagination/Pagination.mdx +305 -0
  558. package/src/components/pagination/Pagination.stories.tsx +333 -0
  559. package/src/components/pagination/Pagination.tsx +343 -0
  560. package/src/components/pagination/index.ts +8 -0
  561. package/src/components/popover-surface/PopoverSurface.mdx +158 -0
  562. package/src/components/popover-surface/PopoverSurface.stories.tsx +421 -0
  563. package/src/components/popover-surface/index.ts +1 -0
  564. package/src/components/progress-bar/ProgressBar.mdx +802 -0
  565. package/src/components/progress-bar/ProgressBar.stories.tsx +533 -0
  566. package/src/components/progress-bar/ProgressBar.tsx +654 -0
  567. package/src/components/progress-bar/index.ts +9 -0
  568. package/src/components/promo-sticker/PromoSticker.mdx +436 -0
  569. package/src/components/promo-sticker/PromoSticker.stories.tsx +363 -0
  570. package/src/components/promo-sticker/PromoSticker.tsx +313 -0
  571. package/src/components/promo-sticker/index.ts +7 -0
  572. package/src/components/promo-surface/PromoSurface.mdx +399 -0
  573. package/src/components/promo-surface/PromoSurface.stories.tsx +270 -0
  574. package/src/components/promo-surface/PromoSurface.tsx +305 -0
  575. package/src/components/promo-surface/index.ts +7 -0
  576. package/src/components/radio/Radio.mdx +243 -0
  577. package/src/components/radio/Radio.stories.tsx +307 -0
  578. package/src/components/radio/Radio.tsx +288 -0
  579. package/src/components/radio/index.ts +1 -0
  580. package/src/components/radio-group/RadioGroup.mdx +119 -0
  581. package/src/components/radio-group/RadioGroup.stories.tsx +225 -0
  582. package/src/components/radio-group/RadioGroup.tsx +139 -0
  583. package/src/components/radio-group/index.ts +1 -0
  584. package/src/components/select/Select.mdx +241 -0
  585. package/src/components/select/Select.stories.tsx +404 -0
  586. package/src/components/select/Select.tsx +381 -0
  587. package/src/components/select/index.ts +1 -0
  588. package/src/components/select-field/SelectField.mdx +324 -0
  589. package/src/components/select-field/SelectField.stories.tsx +460 -0
  590. package/src/components/select-field/SelectField.tsx +138 -0
  591. package/src/components/select-field/index.ts +1 -0
  592. package/src/components/skeleton/Skeleton.mdx +194 -0
  593. package/src/components/skeleton/Skeleton.stories.tsx +260 -0
  594. package/src/components/skeleton/Skeleton.tsx +107 -0
  595. package/src/components/skeleton/index.ts +1 -0
  596. package/src/components/split-button/SplitButton.mdx +445 -0
  597. package/src/components/split-button/SplitButton.stories.tsx +465 -0
  598. package/src/components/split-button/SplitButton.tsx +361 -0
  599. package/src/components/split-button/index.ts +7 -0
  600. package/src/components/status-summary-bar/StatusSummaryBar.mdx +338 -0
  601. package/src/components/status-summary-bar/StatusSummaryBar.stories.tsx +408 -0
  602. package/src/components/status-summary-bar/StatusSummaryBar.tsx +428 -0
  603. package/src/components/status-summary-bar/index.ts +8 -0
  604. package/src/components/subject-lookup-field/SubjectLookupField.mdx +378 -0
  605. package/src/components/subject-lookup-field/SubjectLookupField.stories.tsx +393 -0
  606. package/src/components/subject-lookup-field/SubjectLookupField.tsx +1079 -0
  607. package/src/components/subject-lookup-field/index.ts +11 -0
  608. package/src/components/switch/Switch.mdx +376 -0
  609. package/src/components/switch/Switch.stories.tsx +296 -0
  610. package/src/components/switch/Switch.tsx +483 -0
  611. package/src/components/switch/index.ts +1 -0
  612. package/src/components/table/Table.mdx +575 -0
  613. package/src/components/table/Table.stories.tsx +1049 -0
  614. package/src/components/table/Table.tsx +745 -0
  615. package/src/components/table/TableConsumers.stories.tsx +195 -0
  616. package/src/components/table/_tableFixtures.ts +1189 -0
  617. package/src/components/table/index.ts +22 -0
  618. package/src/components/text-field/TextField.mdx +479 -0
  619. package/src/components/text-field/TextField.stories.tsx +366 -0
  620. package/src/components/text-field/TextField.tsx +391 -0
  621. package/src/components/text-field/index.ts +8 -0
  622. package/src/components/text-link/TextLink.mdx +353 -0
  623. package/src/components/text-link/TextLink.stories.tsx +458 -0
  624. package/src/components/text-link/TextLink.tsx +504 -0
  625. package/src/components/text-link/index.ts +10 -0
  626. package/src/components/textarea/Textarea.mdx +244 -0
  627. package/src/components/textarea/Textarea.stories.tsx +371 -0
  628. package/src/components/textarea/Textarea.tsx +489 -0
  629. package/src/components/textarea/index.ts +9 -0
  630. package/src/components/tooltip/Tooltip.mdx +462 -0
  631. package/src/components/tooltip/Tooltip.stories.tsx +500 -0
  632. package/src/components/tooltip/Tooltip.tsx +756 -0
  633. package/src/components/tooltip/index.ts +13 -0
  634. package/src/components/unit-field/UnitField.mdx +215 -0
  635. package/src/components/unit-field/UnitField.stories.tsx +291 -0
  636. package/src/components/unit-field/UnitField.tsx +255 -0
  637. package/src/components/unit-field/index.ts +7 -0
  638. package/src/icons/icon-registry.generated.ts +510 -0
  639. package/src/icons/icon-types.generated.ts +256 -0
  640. package/src/index.ts +71 -0
  641. package/src/internal/BottomSheet.tsx +714 -0
  642. package/src/internal/FodsProvider.tsx +36 -0
  643. package/src/internal/MotionCaret.tsx +53 -0
  644. package/src/internal/NumberFormatInput.tsx +276 -0
  645. package/src/internal/SummaryDonut.tsx +359 -0
  646. package/src/internal/buttonSegment.ts +241 -0
  647. package/src/internal/collapseRoom.ts +130 -0
  648. package/src/internal/comboboxKeys.ts +90 -0
  649. package/src/internal/contentPresence.ts +46 -0
  650. package/src/internal/dayCell.ts +274 -0
  651. package/src/internal/dialogPortal.ts +50 -0
  652. package/src/internal/donutSweeps.ts +77 -0
  653. package/src/internal/enterOnViewGeometry.ts +53 -0
  654. package/src/internal/faqItem.ts +104 -0
  655. package/src/internal/floatingLabelMotion.tsx +109 -0
  656. package/src/internal/formBlockContext.ts +27 -0
  657. package/src/internal/heightRoom.ts +135 -0
  658. package/src/internal/numberSeparators.ts +93 -0
  659. package/src/internal/overlayMotion.tsx +32 -0
  660. package/src/internal/paginationItem.ts +106 -0
  661. package/src/internal/popoverSurface.ts +78 -0
  662. package/src/internal/portalContainer.ts +11 -0
  663. package/src/internal/progressBarItem.ts +356 -0
  664. package/src/internal/selectionControlText.ts +42 -0
  665. package/src/internal/statusSummaryParts.tsx +475 -0
  666. package/src/internal/summaryMotion.ts +111 -0
  667. package/src/internal/table/ChildConnector.tsx +57 -0
  668. package/src/internal/table/ChildRowPrefix.tsx +21 -0
  669. package/src/internal/table/ColumnSettings.tsx +194 -0
  670. package/src/internal/table/ScrollRegion.tsx +176 -0
  671. package/src/internal/table/TableEmpty.tsx +99 -0
  672. package/src/internal/table/TableLayout.tsx +29 -0
  673. package/src/internal/table/TableLoadStatus.tsx +60 -0
  674. package/src/internal/table/TableMobile.tsx +582 -0
  675. package/src/internal/table/TruncatedCell.tsx +35 -0
  676. package/src/internal/table/emptyValue.ts +11 -0
  677. package/src/internal/table/features.ts +44 -0
  678. package/src/internal/table/recipes.ts +263 -0
  679. package/src/internal/table/rowClick.ts +8 -0
  680. package/src/internal/table/types.ts +342 -0
  681. package/src/internal/tailwind-variants.ts +65 -0
  682. package/src/internal/tooltipContext.ts +15 -0
  683. package/src/internal/tw-merge-config.generated.ts +275 -0
  684. package/src/internal/useAnchoredPanel.ts +340 -0
  685. package/src/internal/useCountUp.ts +65 -0
  686. package/src/internal/useDateFieldTrigger.tsx +357 -0
  687. package/src/internal/useEChart.ts +88 -0
  688. package/src/internal/useEnterOnView.ts +80 -0
  689. package/src/internal/useFloatingBar.ts +125 -0
  690. package/src/internal/useFormReset.ts +47 -0
  691. package/src/internal/useIsMobile.ts +64 -0
  692. package/src/internal/useNoImplicitSubmit.ts +41 -0
  693. package/src/internal/useOneRowOverflow.ts +103 -0
  694. package/src/internal/usePrefersReducedMotion.ts +27 -0
  695. package/src/internal/useReturnFocus.ts +34 -0
  696. package/src/internal/utils.ts +58 -0
  697. package/src/recipes/EmptyState.stories.tsx +105 -0
  698. package/src/recipes/Form.stories.tsx +355 -0
  699. package/src/recipes/ModalWithForm.stories.tsx +219 -0
  700. package/src/recipes/Recipes.mdx +61 -0
  701. package/src/recipes/TableWithFilters.stories.tsx +278 -0
  702. package/src/storybook/FodsFamily.tsx +39 -0
  703. package/src/storybook/Section.tsx +36 -0
  704. package/src/storybook/a11y.ts +24 -0
  705. package/src/storybook/assets/banner-character-bartender.webp +0 -0
  706. package/src/storybook/assets/banner-invoice-sheet-left.webp +0 -0
  707. package/src/storybook/assets/banner-invoice-sheet-right.webp +0 -0
  708. package/src/storybook/assets/invoice-hero.webp +0 -0
  709. package/src/storybook/assets/invoice.webp +0 -0
  710. package/src/storybook/assets/section-document-info.svg +21 -0
  711. package/src/storybook/assets/section-gear-checklist.svg +11 -0
  712. package/src/storybook/assets/section-person-arrow-in.svg +15 -0
  713. package/src/storybook/assets/section-person-arrow-out.svg +22 -0
  714. package/src/storybook/assets/section-receipt-dollar.svg +23 -0
  715. package/src/storybook/assets/table-empty-folder-empty.png +0 -0
  716. package/src/storybook/assets/table-empty-folder-magnifying-glass.png +0 -0
  717. package/src/storybook/assets/table-empty-funnel.png +0 -0
  718. package/src/storybook/assets/table-empty-load-failed.png +0 -0
  719. package/src/storybook/assets/wallet-spot.png +0 -0
  720. package/src/storybook/assets.d.ts +17 -0
  721. package/src/storybook/componentDoc.ts +41 -0
  722. package/src/storybook/fitFrame.tsx +70 -0
  723. package/src/storybook/forceStates.tsx +647 -0
  724. package/src/storybook/illustrations.tsx +66 -0
  725. package/src/storybook/viewportFrame.tsx +58 -0
  726. package/src/styles/assets/label-brush-1.svg +6 -0
  727. package/src/styles/assets/pattern-dark.svg +113 -0
  728. package/src/styles/base.css +106 -0
  729. package/src/styles/index.css +15 -0
  730. package/src/styles/motion.css +157 -0
  731. package/src/styles/promo-sticker.css +27 -0
  732. package/src/styles/promo-surface.css +49 -0
  733. package/src/styles/shared.css +11 -0
  734. package/src/styles/theme.generated.css +314 -0
  735. package/src/styles/theme.map.json +278 -0
  736. package/src/styles/tracking.generated.css +12 -0
  737. package/src/tokens/index.ts +4 -0
  738. package/src/tokens/tokens.generated.ts +542 -0
@@ -0,0 +1,802 @@
1
+ "use client";
2
+ import * as React from 'react';
3
+ import { AnimatePresence, LayoutGroup, motion, useIsPresent, type MotionProps } from 'motion/react';
4
+ import { tv } from '../../internal/tailwind-variants';
5
+ import { Icon, type IconSize } from '../icon/Icon';
6
+ import { floatingLabelVariants, helperTextVariants } from '../field/Field';
7
+ import { IconButton } from '../icon-button/IconButton';
8
+ import { TextLink } from '../text-link/TextLink';
9
+ import { REFLOW_TRANSITION, fadeTransitions, useContentFade } from '../../internal/contentPresence';
10
+ import { useHeightRoom, type HeightRoom } from '../../internal/heightRoom';
11
+ import { cn } from '../../internal/utils';
12
+
13
+ // =============================================================================
14
+ // FileUpload — drop-zone field for attaching a file or image inside a form
15
+ // (spec/03-atoms/file-upload.manifest.json, built against version 1.11.0, Figma
16
+ // node 6417-87039).
17
+ //
18
+ // The chrome is the Text Field shell (--bg-primary fill, --outline-default 1px
19
+ // border, --radius-400, padX --space-500, floating label, helper line) with an
20
+ // 88-tall drop-zone Container inside it. The shell HUGS; only the Container
21
+ // carries the height, which deliberately stands OFF the 48/40 field grid so the
22
+ // drop target is comfortably large (manifest `intent.sizing`). 88 is a FLOOR:
23
+ // Uploaded Image grows to 112 (manifest sizes[0].heightExceptions).
24
+ //
25
+ // The manifest's single axis is `state`, and `axes.state` is never a prop: every
26
+ // one of the six states is derived from content.
27
+ //
28
+ // Default — no files, not `loading` → prompt row
29
+ // Uploading — `loading` → spinner + progress bar
30
+ // Uploaded Image — single `kind: 'image'` → thumbnail + view + remove
31
+ // Uploaded File — single `kind: 'file'` → filename + remove
32
+ // Uploaded Multi Files — `multiple` + files → prompt row + row stack
33
+ // Error — non-empty `error` → danger border + message
34
+ //
35
+ // Uploaded Image / Uploaded File REPLACE the drop-zone content (the field holds one
36
+ // file, so the prompt has nothing left to do). Uploaded Multi Files KEEPS the
37
+ // drop-zone (more files can be added) and appends the row stack BELOW the helper
38
+ // line, the order of the Figma component set.
39
+ //
40
+ // Semantics (manifest `delivery.react`, file-upload.md § Accessibility): the
41
+ // floating label is the real `<label htmlFor>` of a visually hidden
42
+ // `<input type="file">` that is out of the tab order. The drop-zone is a plain
43
+ // element that is the pointer click target and carries the drag handlers, never a
44
+ // `<label>`: a label may not contain interactive content (the trigger and the row
45
+ // Icon Buttons sit inside the zone) and it forwards its click to the input, so
46
+ // every row action would also open the picker. The trigger opens the picker
47
+ // programmatically and is the keyboard path; the zone takes no focus.
48
+ //
49
+ // What this component does not have, because the manifest does not have it:
50
+ // - no `disabled` prop (no Disabled state, no --disabled-* bindings). Inside a
51
+ // disabled `<fieldset>` the native controls are switched off by the browser and
52
+ // a drop is ignored (see `isInputDisabled`). The row Icon Buttons then dim
53
+ // through their own `:disabled` styles; the TextLink trigger keeps its link ink,
54
+ // because its disabled look follows its `disabled` prop. That mixed look stays
55
+ // until the manifest defines Disabled.
56
+ // - no Drag-over affordance (manifest `backlog`: planned, not built). The drag
57
+ // handlers are wired so a drop works; there is no highlight to render.
58
+ // - no indeterminate progress animation. The manifest's Uploading state is the
59
+ // spinner (motion `loop`) plus a fill that grows to the reported progress (motion
60
+ // `states.value`). Without a `progress` value the spinner alone carries the
61
+ // activity and no fill is drawn.
62
+ // =============================================================================
63
+
64
+ /** Icon slot boxes from the manifest: `sizes[0].icon` (--size-icon) and `slots.status-icon` (16). */
65
+ const ICON_SIZE: IconSize = 'default';
66
+ const STATUS_ICON_SIZE: IconSize = 'xsmall';
67
+
68
+ const fileUploadVariants = tv({
69
+ slots: {
70
+ // Outer stack: shell, then the helper / error line, then (multi) the rows.
71
+ wrapper: 'relative flex w-full flex-col',
72
+ // The Text Field shell: border / fill / radius / padX. `relative` anchors the
73
+ // visually hidden input. No minWidth and no maxWidth (manifest notes → WIDTH):
74
+ // the drop-zone fills its column down to the 358 Mobile form column, and the
75
+ // prompt sentence wraps instead of clipping.
76
+ shell: ['relative flex w-full flex-col', 'rounded-400 border-100 bg-background-primary px-500'],
77
+ // The drop zone itself: 88 as a FLOOR, not a fixed height. min-h, not h: the
78
+ // padding per state (the `content` variant) lands the zone on 88, while Uploaded
79
+ // Image's 16 + the 80x80 thumbnail + 16 comes to 112 and the zone is meant to
80
+ // grow there (sizes[0].heightExceptions). Never squeeze the thumbnail to 88.
81
+ container: [
82
+ 'flex w-full items-center gap-400',
83
+ // fods-lint-disable-next-line off-grid 88px drop-zone floor (manifest sizes[0].height, a raw value); deliberately off the field height grid and the --space scale
84
+ 'min-h-[88px]',
85
+ ],
86
+ // Icon + sentence, TOP-aligned so the glyph stays on the first line when the
87
+ // sentence wraps: the 24 icon box and the Body/M line (16 × --leading-relaxed)
88
+ // are both 24 tall, so their tops coincide. A row of its own because the
89
+ // Container still centres it vertically inside the 88 floor.
90
+ promptRow: 'flex min-w-0 flex-1 items-start gap-400',
91
+ // One sentence, Body/M/Regular in --text-primary, the inline trigger link
92
+ // included, wrapping as one text flow (manifest text.prompt: overflow wrap).
93
+ prompt:
94
+ 'min-w-0 flex-1 font-inter text-body-base font-normal text-text-primary [text-wrap:var(--text-wrap-body)]',
95
+ // `upload-simple`, --secondary in EVERY state (slots.prompt-icon binds it
96
+ // unconditionally; the family's Error `icon` is spent on statusIcon below).
97
+ promptIcon: 'shrink-0 text-secondary',
98
+ // Replaces promptIcon while Uploading; --secondary too (slots.spinner). It
99
+ // keeps turning under reduced motion (motion.loop.reducedMotion).
100
+ spinner: 'shrink-0 animate-spin text-secondary',
101
+ // 80×80 preview placeholder (a raw 80, see below): --bg-secondary fill,
102
+ // --outline-default border, --radius-200 (manifest notes[3]).
103
+ thumbnail: [
104
+ 'flex shrink-0 items-center justify-center overflow-hidden',
105
+ 'rounded-200 border-100 border-outline-default bg-background-secondary',
106
+ // fods-lint-disable-next-line off-grid 80px thumbnail (manifest notes[3] and sizes[0].note, a raw value); no semantic size token carries it, and the --ds-size-80 primitive is Layer 1, which components never reference
107
+ 'size-[80px]',
108
+ ],
109
+ // The placeholder glyph is --text-secondary, a DIFFERENT token from
110
+ // promptIcon's --secondary (slots.thumbnail-icon).
111
+ thumbnailIcon: 'text-text-secondary',
112
+ // The uploaded image itself: decorative, fills the thumbnail box.
113
+ thumbnailImage: 'size-full object-cover',
114
+ // warning-circle before the error message (family error.icon).
115
+ statusIcon: 'shrink-0 text-status-danger',
116
+ // Body/M/Semibold, FILL width, single line; the row actions stay put (manifest
117
+ // text.filename: overflow truncate, lines 1). Truncation KEEPS the extension
118
+ // (text.filename.note, spec § Copy): only the base name shrinks to an
119
+ // ellipsis, the extension never does, so «velmi-dlouhy-na….pdf».
120
+ filename: 'flex min-w-0 flex-1 whitespace-nowrap font-inter text-body-base font-semibold text-text-primary',
121
+ filenameBase: 'min-w-0 truncate',
122
+ filenameExtension: 'shrink-0',
123
+ // The progress bar has NO track: neither Figma nor the manifest draws one,
124
+ // only the fill (slots.spinner: "--secondary-solid, 3px, radius 2").
125
+ progress: 'relative min-w-0 flex-1 overflow-hidden',
126
+ // motion.states.value: the fill spans the bar and grows from the start edge by
127
+ // scaleX (it only grows, never slides) on --duration-normal + --easing-standard;
128
+ // under reduced motion it keeps tracking on --duration-instant.
129
+ progressFill: [
130
+ 'w-full origin-left rounded-100 bg-secondary-solid',
131
+ 'transition-[transform] duration-normal ease-standard motion-reduce:duration-instant',
132
+ // fods-lint-disable-next-line 3px progress-bar height (manifest slots.spinner, a raw value); the border-width scale has 2 and 4, no 3
133
+ 'h-[3px]',
134
+ ],
135
+ // The stack of Uploaded Multi Files rows.
136
+ fileStack: 'flex w-full flex-col',
137
+ // Legacy 56-tall row, pad 8 / 16, gap 8; NOT the List Row recipe (manifest
138
+ // notes[4] and `backlog`: a deliberate open item, do not migrate).
139
+ fileRow: [
140
+ 'flex w-full items-center gap-400 px-600 py-400',
141
+ // fods-lint-disable-next-line off-grid 56px legacy file-row height (manifest sizes[0].note, a raw value); not on the --space grid
142
+ 'min-h-[56px]',
143
+ ],
144
+ },
145
+ variants: {
146
+ // The shell's border colour is the only thing the error state changes about the
147
+ // chrome (families[File Upload].states.error: fill and text stay put).
148
+ state: {
149
+ default: { shell: 'border-outline-default' },
150
+ error: { shell: 'border-status-danger' },
151
+ },
152
+ // Container padding-block per state (sizes[0].note): 32 in Default / Uploading /
153
+ // Multi / Error, 20 below SM (so a wrapped prompt does not make the zone tall on a
154
+ // phone), 24 in Uploaded File, 16 in Uploaded Image where the thumbnail sets the
155
+ // height.
156
+ content: {
157
+ prompt: { container: 'py-700 sm:py-900' },
158
+ uploading: { container: 'py-700 sm:py-900' },
159
+ 'uploaded-file': { container: 'py-800' },
160
+ 'uploaded-image': { container: 'py-600' },
161
+ },
162
+ // The 1px --outline-default rule BETWEEN stacked rows: the Figma Multi Files
163
+ // render has no leading or trailing rule, so the first row carries none.
164
+ divided: {
165
+ true: { fileRow: 'border-t-100 border-outline-default' },
166
+ false: {},
167
+ },
168
+ // The zone is a pointer click target except while Uploading. A disabled
169
+ // `<fieldset>` switches the hidden input off without a prop, so the pointer
170
+ // cue is withdrawn by CSS from the input's own :disabled state.
171
+ clickable: {
172
+ true: { shell: 'cursor-pointer has-[input:disabled]:cursor-default' },
173
+ false: {},
174
+ },
175
+ },
176
+ defaultVariants: {
177
+ state: 'default',
178
+ content: 'prompt',
179
+ divided: false,
180
+ clickable: true,
181
+ },
182
+ });
183
+
184
+ export interface FileUploadFile {
185
+ id: string;
186
+ /** The file's own name, shown verbatim (manifest text.filename). */
187
+ name: string;
188
+ /** `image` renders the 80×80 thumbnail + view action; `file` renders filename + remove only. */
189
+ kind?: 'image' | 'file';
190
+ /** URL of the real preview (e.g. an object URL); replaces the placeholder glyph. */
191
+ previewUrl?: string;
192
+ }
193
+
194
+ export interface FileUploadProps {
195
+ /**
196
+ * Field name in the floating notch (Body/XXS, --text-secondary; --status-danger on
197
+ * Error). It is the `<label>` of the file input, so it is required. Always floating:
198
+ * the 88-tall zone is never empty, so the label has no resting position.
199
+ */
200
+ label: string;
201
+ /** Accepted-format hint below the shell, e.g. «Logo musí být ve formátu jpg, jpeg, gif nebo png.». Wraps, never truncates. */
202
+ helperText?: string;
203
+ /**
204
+ * A non-empty message is the Error state: --status-danger border and label, a
205
+ * `warning-circle` and the message in --status-danger. The message REPLACES the
206
+ * helper (manifest `parts.helper`). An empty string is "no error".
207
+ */
208
+ error?: string;
209
+ /**
210
+ * Attached files. One file (not `multiple`) replaces the drop-zone; `multiple` renders
211
+ * the row stack below the helper.
212
+ *
213
+ * Controlled only, with no `defaultFiles`: a deliberate exception to the
214
+ * controlled/uncontrolled pair of COMPONENT-CODE-CONVENTIONS §2. The list is the
215
+ * consumer's upload state (what the server accepted, under which id, with which
216
+ * preview URL), which the component renders and never owns: `onFilesSelect` and
217
+ * `onRemove` only report intents, so an internal copy would show files that were
218
+ * never uploaded or are already gone.
219
+ */
220
+ files?: FileUploadFile[];
221
+ /**
222
+ * Upload in flight, the manifest's Uploading state: spinner + progress bar,
223
+ * `aria-busy="true"` on the input, and the drop-zone stops opening the picker and ignores a drop.
224
+ */
225
+ loading?: boolean;
226
+ /** 0–100. While `loading` without a value no fill is drawn and the bar claims no value. */
227
+ progress?: number;
228
+ /** Stack mode: the drop-zone stays (more files can be added) and each file gets a row. */
229
+ multiple?: boolean;
230
+ /** Native `accept` filter of the picker, e.g. "image/png,image/jpeg". A drop is not filtered by it. */
231
+ accept?: string;
232
+ /**
233
+ * Everything the user picked or dropped, verbatim. Nothing is truncated in single
234
+ * mode and nothing is filtered by `accept`: files dropped silently cannot be
235
+ * explained to the user. Enforcing the count and the type, and saying so, is the
236
+ * consumer's job.
237
+ */
238
+ onFilesSelect?: (files: File[]) => void;
239
+ /** The remove action of a file row. */
240
+ onRemove?: (id: string) => void;
241
+ /**
242
+ * The view action of an uploaded image. The component reports the intent; the
243
+ * consumer opens the full image in a Modal (manifest slots.action-view).
244
+ */
245
+ onView?: (id: string) => void;
246
+ /** Trigger link copy. Defaults to «Nahrajte svůj soubor» (Czech); an app with more language versions passes it from its translations. */
247
+ triggerLabel?: string;
248
+ /**
249
+ * Plain copy after the trigger, with its leading space (manifest text.prompt).
250
+ * Defaults to « nebo jej sem přetáhněte» (Czech); an app with more language versions passes it from its translations.
251
+ */
252
+ dropHintText?: string;
253
+ /** Accessible-name prefix of the view action, composed with the filename. Defaults to «Zobrazit» (Czech). */
254
+ viewLabel?: string;
255
+ /** Accessible-name prefix of the remove action, composed with the filename. Defaults to «Odebrat» (Czech). */
256
+ removeLabel?: string;
257
+ /**
258
+ * Accessible name of the progress bar, also announced in the helper row when an
259
+ * upload starts. Defaults to «Nahrávání souboru» (Czech).
260
+ */
261
+ uploadingLabel?: string;
262
+ className?: string;
263
+ }
264
+
265
+ /** True when the native input is switched off, e.g. by a disabled `<fieldset>` around the field. */
266
+ const isInputDisabled = (input: HTMLInputElement | null) => input != null && input.matches(':disabled');
267
+
268
+ /**
269
+ * Splits «faktura.2026.pdf» into «faktura.2026» and «.pdf», so truncation can spare
270
+ * the extension. A name with no dot, a leading dot only («.env») or a trailing dot
271
+ * has no extension to keep.
272
+ */
273
+ const splitExtension = (name: string): [base: string, extension: string] => {
274
+ const dot = name.lastIndexOf('.');
275
+ if (dot <= 0 || dot === name.length - 1) return [name, ''];
276
+ return [name.slice(0, dot), name.slice(dot)];
277
+ };
278
+
279
+ /**
280
+ * True when the element that held focus is gone: focus fell back to the body, its
281
+ * element left the document, or it sits inside `doomed` (a row that is leaving).
282
+ * Focus is moved only then, never away from something the user chose.
283
+ */
284
+ const isFocusLost = (doomed?: Element | null) => {
285
+ const active = document.activeElement;
286
+ return (
287
+ active == null || active === document.body || !active.isConnected || (doomed != null && doomed.contains(active))
288
+ );
289
+ };
290
+
291
+ const FileUpload = React.forwardRef<HTMLInputElement, FileUploadProps>(
292
+ (
293
+ {
294
+ label,
295
+ helperText,
296
+ error,
297
+ files = [],
298
+ loading = false,
299
+ progress,
300
+ multiple = false,
301
+ accept,
302
+ onFilesSelect,
303
+ onRemove,
304
+ onView,
305
+ triggerLabel = 'Nahrajte svůj soubor',
306
+ dropHintText = ' nebo jej sem přetáhněte',
307
+ viewLabel = 'Zobrazit',
308
+ removeLabel = 'Odebrat',
309
+ uploadingLabel = 'Nahrávání souboru',
310
+ className,
311
+ },
312
+ ref,
313
+ ) => {
314
+ const inputRef = React.useRef<HTMLInputElement>(null);
315
+ React.useImperativeHandle(ref, () => inputRef.current as HTMLInputElement);
316
+
317
+ const uid = React.useId();
318
+ const inputId = `${uid}-input`;
319
+ const labelId = `${uid}-label`;
320
+ const triggerId = `${uid}-trigger`;
321
+ const messageId = `${uid}-message`;
322
+
323
+ const hasError = Boolean(error);
324
+ // In single mode one file REPLACES the drop-zone; in multi mode the zone stays
325
+ // and the files live in the stack below the helper.
326
+ const singleFile = !multiple && files.length > 0 ? files[0] : undefined;
327
+ const contentMode = loading
328
+ ? 'uploading'
329
+ : singleFile
330
+ ? singleFile.kind === 'image'
331
+ ? 'uploaded-image'
332
+ : 'uploaded-file'
333
+ : 'prompt';
334
+
335
+ // Reduced motion: rows and previews appear and vanish at once (motion.reducedMotion).
336
+ const fade = useContentFade({ reducedFade: 'none' });
337
+ const zoneRoom = useHeightRoom();
338
+ const styles = fileUploadVariants({
339
+ state: hasError ? 'error' : 'default',
340
+ content: contentMode,
341
+ clickable: !loading,
342
+ });
343
+
344
+ // `hasError ? … : …`, not `error ?? helperText`: an empty-string `error` (what a
345
+ // form library hands over for "no error yet") must keep the helper visible.
346
+ const message = hasError ? error : helperText;
347
+ // A determinate bar needs a number; `loading` without one must NOT claim a
348
+ // value (aria-valuenow would lie).
349
+ const hasProgressValue = typeof progress === 'number' && Number.isFinite(progress);
350
+ const progressValue = hasProgressValue ? Math.min(100, Math.max(0, progress)) : undefined;
351
+
352
+ const openPicker = () => inputRef.current?.click();
353
+
354
+ const handleChange = (event: React.ChangeEvent<HTMLInputElement>) => {
355
+ const selected = Array.from(event.target.files ?? []);
356
+ if (selected.length > 0) onFilesSelect?.(selected);
357
+ // Clear the native value so picking the SAME file again still fires change.
358
+ event.target.value = '';
359
+ };
360
+
361
+ // preventDefault on enter / over is what makes the element a drop target, and on
362
+ // drop it keeps the browser from opening the file in place of the page. That
363
+ // stays true while loading or while the input is disabled; only the drop effect
364
+ // says "no", and the drop is then ignored, as a click on the zone is.
365
+ const allowDrop = (event: React.DragEvent<HTMLDivElement>) => {
366
+ event.preventDefault();
367
+ if ((loading || isInputDisabled(inputRef.current)) && event.dataTransfer) event.dataTransfer.dropEffect = 'none';
368
+ };
369
+
370
+ const handleDrop = (event: React.DragEvent<HTMLDivElement>) => {
371
+ event.preventDefault();
372
+ if (loading || isInputDisabled(inputRef.current)) return;
373
+ const dropped = Array.from(event.dataTransfer?.files ?? []);
374
+ if (dropped.length === 0) return;
375
+ // Handed over WHOLE, even in single mode: the browser never filters
376
+ // `dataTransfer.files` against `multiple`, and cutting the drop to its first
377
+ // file would leave the rest ignored with nothing on screen to say why.
378
+ onFilesSelect?.(dropped);
379
+ };
380
+
381
+ // The drop-zone is the pointer click target (manifest delivery.react, spec
382
+ // § Accessibility → Semantics). Pointer only: the zone takes no focus, the
383
+ // keyboard path is the trigger (spec § Keyboard). A click that starts in an
384
+ // interactive descendant is that control's own: the trigger already opens the
385
+ // picker (no double open), the row Icon Buttons view / remove, and the hidden
386
+ // input's own click bubbles here when `openPicker` fires it.
387
+ const handleZoneClick = (event: React.MouseEvent<HTMLDivElement>) => {
388
+ if (loading || isInputDisabled(inputRef.current)) return;
389
+ const target = event.target as Element;
390
+ const control = target.closest('button, a, input, [role="button"]');
391
+ if (control && event.currentTarget.contains(control)) return;
392
+ openPicker();
393
+ };
394
+
395
+ // ── Focus management (FilterChip precedent, `filter-chip/FilterChip.tsx`) ──
396
+ // A remove or a finished upload unmounts the control that held focus, and focus
397
+ // would fall to <body>. It cannot be moved inside the click handler: the new
398
+ // control does not exist until the consumer's next commit (and, in the zone, until
399
+ // the outgoing content has faded). So the handlers leave a flag, and the move
400
+ // happens once the new content is there, only if focus was really lost.
401
+ const triggerRef = React.useRef<React.ComponentRef<typeof TextLink>>(null);
402
+ const removeButtons = React.useRef(new Map<string, HTMLButtonElement>());
403
+ // The zone's content swaps (single remove, finished upload): focus the trigger,
404
+ // or the first action of the new content when it has no trigger.
405
+ const refocusZone = React.useRef(false);
406
+ // A stack row leaves: focus the next row's remove, or the trigger after the last row.
407
+ const refocusStack = React.useRef<{ removedId: string; nextId: string | null } | null>(null);
408
+
409
+ const handleRemove = (file: FileUploadFile) => {
410
+ if (multiple) {
411
+ const index = files.findIndex(entry => entry.id === file.id);
412
+ refocusStack.current = { removedId: file.id, nextId: files[index + 1]?.id ?? null };
413
+ } else {
414
+ refocusZone.current = true;
415
+ }
416
+ onRemove?.(file.id);
417
+ };
418
+
419
+ // The trigger leaves with the prompt when an upload starts, so the content that
420
+ // follows the upload (prompt again, or the uploaded file) takes focus back.
421
+ React.useLayoutEffect(() => {
422
+ if (loading) refocusZone.current = true;
423
+ }, [loading]);
424
+
425
+ // Stack: runs in the commit that drops the row, while the leaving row is still
426
+ // mounted (and inert), so its remove button can be recognised as the lost focus.
427
+ React.useLayoutEffect(() => {
428
+ const pending = refocusStack.current;
429
+ if (!pending || files.some(file => file.id === pending.removedId)) return;
430
+ refocusStack.current = null;
431
+ if (!isFocusLost(removeButtons.current.get(pending.removedId))) return;
432
+ const next = (pending.nextId != null ? removeButtons.current.get(pending.nextId) : undefined) ?? triggerRef.current;
433
+ next?.focus();
434
+ }, [files]);
435
+
436
+ // Zone: called by ZoneContent once the new content is mounted and its fade-in
437
+ // starts. Only refs are read, so the callback is stable.
438
+ const handleZoneReady = React.useCallback((mode: string, node: HTMLElement) => {
439
+ if (mode === 'uploading' || !refocusZone.current) return;
440
+ refocusZone.current = false;
441
+ if (!isFocusLost()) return;
442
+ const target = triggerRef.current ?? node.querySelector<HTMLElement>('button:not(:disabled)');
443
+ target?.focus();
444
+ }, []);
445
+
446
+ // While a message is shown, every control of the field is described by it: the
447
+ // input itself is never focused, so the controls are where focus lands.
448
+ const describedBy = message ? messageId : undefined;
449
+
450
+ const removeAction = (file: FileUploadFile) => (
451
+ <IconButton
452
+ ref={node => {
453
+ if (node) removeButtons.current.set(file.id, node);
454
+ else removeButtons.current.delete(file.id);
455
+ }}
456
+ variant="tertiary"
457
+ size="md"
458
+ icon={<Icon name="trash" />}
459
+ // Composed with the filename so a stack does not announce identical buttons.
460
+ aria-label={`${removeLabel} ${file.name}`}
461
+ aria-describedby={describedBy}
462
+ onClick={() => handleRemove(file)}
463
+ />
464
+ );
465
+
466
+ // The name truncates from the base only; the extension stays in view. The two
467
+ // spans read as one word, so the accessible text is the full name, and `title`
468
+ // shows the full name to a pointer user.
469
+ const renderFilename = (name: string) => {
470
+ const [base, extension] = splitExtension(name);
471
+ return (
472
+ <span data-fods-part="filename" title={name} className={styles.filename()}>
473
+ <span className={styles.filenameBase()}>{base}</span>
474
+ {extension && <span className={styles.filenameExtension()}>{extension}</span>}
475
+ </span>
476
+ );
477
+ };
478
+
479
+ let containerContent: React.ReactNode;
480
+
481
+ if (contentMode === 'uploading') {
482
+ containerContent = (
483
+ <>
484
+ <Icon name="spinner" size={ICON_SIZE} data-fods-part="spinner" className={styles.spinner()} />
485
+ <div
486
+ role="progressbar"
487
+ aria-label={uploadingLabel}
488
+ aria-valuemin={hasProgressValue ? 0 : undefined}
489
+ aria-valuemax={hasProgressValue ? 100 : undefined}
490
+ aria-valuenow={progressValue}
491
+ className={styles.progress()}
492
+ >
493
+ {hasProgressValue && (
494
+ // The part marks the FILL: the wrapper is a bare positioning box with
495
+ // no track, so --secondary-solid and --radius-100 are painted here.
496
+ <div
497
+ data-fods-part="progress"
498
+ className={styles.progressFill()}
499
+ style={{ transform: `scaleX(${(progressValue ?? 0) / 100})` }}
500
+ />
501
+ )}
502
+ </div>
503
+ </>
504
+ );
505
+ } else if (contentMode === 'uploaded-image' && singleFile) {
506
+ containerContent = (
507
+ <>
508
+ <div data-fods-part="thumbnail" className={styles.thumbnail()}>
509
+ {singleFile.previewUrl ? (
510
+ // Decorative: the filename beside it already names the file.
511
+ <img src={singleFile.previewUrl} alt="" className={styles.thumbnailImage()} />
512
+ ) : (
513
+ <Icon
514
+ name="image"
515
+ size={ICON_SIZE}
516
+ data-fods-part="thumbnail-icon"
517
+ className={styles.thumbnailIcon()}
518
+ />
519
+ )}
520
+ </div>
521
+ {renderFilename(singleFile.name)}
522
+ <IconButton
523
+ variant="tertiary"
524
+ size="md"
525
+ icon={<Icon name="eye" />}
526
+ aria-label={`${viewLabel} ${singleFile.name}`}
527
+ aria-describedby={describedBy}
528
+ onClick={() => onView?.(singleFile.id)}
529
+ />
530
+ {removeAction(singleFile)}
531
+ </>
532
+ );
533
+ } else if (contentMode === 'uploaded-file' && singleFile) {
534
+ containerContent = (
535
+ <>
536
+ {renderFilename(singleFile.name)}
537
+ {removeAction(singleFile)}
538
+ </>
539
+ );
540
+ } else {
541
+ containerContent = (
542
+ // The glyph is --secondary in EVERY state, Error included: the family's
543
+ // `states.error.icon` addresses slots.status-icon only (manifest notes[5]).
544
+ <div className={styles.promptRow()}>
545
+ <Icon name="upload-simple" size={ICON_SIZE} data-fods-part="prompt-icon" className={styles.promptIcon()} />
546
+ <p data-fods-part="prompt" className={styles.prompt()}>
547
+ {/* No `href` → TextLink renders a `<button type="button">`, which opens
548
+ the picker. Strong / md (slots.trigger-link); its own icon slots
549
+ stay unused, the visible glyph is prompt-icon. Its name is the
550
+ link words plus the field label («Nahrajte svůj soubor Logo»), so
551
+ two upload fields on one form do not offer the same button. */}
552
+ <TextLink
553
+ ref={triggerRef}
554
+ id={triggerId}
555
+ variant="strong"
556
+ size="md"
557
+ aria-labelledby={`${triggerId} ${labelId}`}
558
+ aria-describedby={describedBy}
559
+ onClick={openPicker}
560
+ >
561
+ {triggerLabel}
562
+ </TextLink>
563
+ {dropHintText}
564
+ </p>
565
+ </div>
566
+ );
567
+ }
568
+
569
+ return (
570
+ // `data-fods-component` sits on the outer wrapper, not on the shell: the label,
571
+ // the helper row and the file stack are siblings of the shell, and a part's
572
+ // owner is resolved with `closest('[data-fods-component]')`.
573
+ <div data-fods-component="file-upload" className={cn(styles.wrapper(), className)}>
574
+ <div className="relative">
575
+ <label
576
+ id={labelId}
577
+ htmlFor={inputId}
578
+ data-fods-part="label"
579
+ // Always floating. Reuses the Text Field label recipe (parts.label:
580
+ // --text-secondary ink on a --bg-primary mask); Error reds the ink only
581
+ // (parts.label.states.error = --status-danger).
582
+ className={floatingLabelVariants({ floating: true, status: hasError ? 'error' : 'default' })}
583
+ >
584
+ {label}
585
+ </label>
586
+
587
+ <motion.div
588
+ ref={zoneRoom.setNode}
589
+ data-fods-part="root"
590
+ className={styles.shell()}
591
+ style={zoneRoom.style}
592
+ onClick={handleZoneClick}
593
+ onDragEnter={allowDrop}
594
+ onDragOver={allowDrop}
595
+ onDrop={handleDrop}
596
+ >
597
+ <input
598
+ ref={inputRef}
599
+ id={inputId}
600
+ type="file"
601
+ accept={accept}
602
+ multiple={multiple}
603
+ onChange={handleChange}
604
+ // Out of the tab order on purpose: the trigger and the row Icon
605
+ // Buttons are the keyboard path (spec § Keyboard); a focusable
606
+ // sr-only input would be a second, invisible tab stop for the same
607
+ // action. It stays a real, labelled `<input type="file">`.
608
+ tabIndex={-1}
609
+ className="sr-only"
610
+ aria-busy={loading || undefined}
611
+ aria-invalid={hasError || undefined}
612
+ aria-describedby={describedBy}
613
+ />
614
+
615
+ {/* State swap (prompt ↔ uploading ↔ uploaded): the content that gives
616
+ way fades out, then the shell's height moves to the new content's
617
+ while the new content fades in. Keyed by the content mode, so a progress
618
+ update inside one state never re-runs the fade. */}
619
+ <AnimatePresence mode="wait" initial={false}>
620
+ <ZoneContent
621
+ key={contentMode}
622
+ mode={contentMode}
623
+ room={zoneRoom}
624
+ className={styles.container()}
625
+ onReady={handleZoneReady}
626
+ >
627
+ {containerContent}
628
+ </ZoneContent>
629
+ </AnimatePresence>
630
+ </motion.div>
631
+ </div>
632
+
633
+ {/* The helper / error row is the field's polite live region (spec
634
+ § Accessibility → Announcement): the input is never focused, so text
635
+ reachable only through aria-describedby would be read to nobody. It is
636
+ always mounted, because a region inserted together with its text is not
637
+ announced. The gap is --space-400 (sizes[0].gap), not the shared
638
+ recipe's --space-200, and only while a message is visible. */}
639
+ <div
640
+ id={messageId}
641
+ data-fods-part="helper"
642
+ role="status"
643
+ aria-live="polite"
644
+ className={cn(
645
+ helperTextVariants({ state: hasError ? 'error' : 'default' }),
646
+ message ? 'mt-400' : 'mt-0',
647
+ 'flex items-start gap-400',
648
+ )}
649
+ >
650
+ {hasError && (
651
+ // Error is carried by text AND icon, never colour alone (WCAG 1.4.1).
652
+ <Icon
653
+ name="warning-circle"
654
+ size={STATUS_ICON_SIZE}
655
+ data-fods-part="status-icon"
656
+ className={styles.statusIcon()}
657
+ />
658
+ )}
659
+ {/* Wraps, never truncates: the message must be fully visible (WCAG 3.3.1). */}
660
+ {message && <span className="min-w-0 flex-1">{message}</span>}
661
+ {/* The Uploading announcement: said once when an upload starts. */}
662
+ {loading && <span className="sr-only">{uploadingLabel}</span>}
663
+ </div>
664
+
665
+ {/* Uploaded Multi Files: the stack sits BELOW the helper line. An added row
666
+ fades in, a removed row fades out first and only then do the rows below
667
+ close up on --spring-gentle. Rows on the first render do not animate. */}
668
+ <LayoutGroup>
669
+ <AnimatePresence initial={false}>
670
+ {multiple && files.length > 0 && (
671
+ <FileStack key="stack" labelledBy={labelId} className={styles.fileStack()} fade={fade}>
672
+ <AnimatePresence initial={false}>
673
+ {files.map((file, index) => (
674
+ <FileRow key={file.id} className={styles.fileRow({ divided: index > 0 })} fade={fade}>
675
+ {renderFilename(file.name)}
676
+ {/* Remove only: slots.action-view is Uploaded Image only. */}
677
+ {removeAction(file)}
678
+ </FileRow>
679
+ ))}
680
+ </AnimatePresence>
681
+ </FileStack>
682
+ )}
683
+ </AnimatePresence>
684
+ </LayoutGroup>
685
+ </div>
686
+ );
687
+ },
688
+ );
689
+ FileUpload.displayName = 'FileUpload';
690
+
691
+ /**
692
+ * One state of the drop zone (manifest `motion.layout`). The outgoing state holds the
693
+ * shell's height as it starts to fade out; once it has left, the incoming state moves the
694
+ * shell to its own height (88 ↔ 112 for Uploaded Image) on `springs.gentle` while it
695
+ * fades in. A swap arriving mid-resize retargets the spring from where it is. Reduced
696
+ * motion: the height switches at once and the content appears and vanishes at once.
697
+ */
698
+ function ZoneContent({
699
+ mode,
700
+ room,
701
+ className,
702
+ onReady,
703
+ children,
704
+ }: {
705
+ mode: string;
706
+ room: HeightRoom;
707
+ className: string;
708
+ /** Called once this state is mounted, present and starting to fade in (focus management). */
709
+ onReady: (mode: string, node: HTMLElement) => void;
710
+ children: React.ReactNode;
711
+ }) {
712
+ const isPresent = useIsPresent();
713
+ const [ready, setReady] = React.useState(() => !room.pending());
714
+ const nodeRef = React.useRef<HTMLDivElement>(null);
715
+
716
+ React.useEffect(() => {
717
+ if (ready && isPresent && nodeRef.current) onReady(mode, nodeRef.current);
718
+ }, [ready, isPresent, mode, onReady]);
719
+
720
+ // Adding happens together (motion-system.md § Calm motion rule 2; manifest
721
+ // `motion.enter`): the room starts moving and the content starts fading in in the same
722
+ // commit, never one after the other. A state that comes back while it is still leaving
723
+ // (AnimatePresence keeps the same instance) resumes the held shell the same way.
724
+ React.useLayoutEffect(() => {
725
+ if (!isPresent) {
726
+ room.hold();
727
+ return;
728
+ }
729
+ if (!room.pending()) return;
730
+ room.resize();
731
+ setReady(true);
732
+ }, [isPresent, room]);
733
+
734
+ const fade = fadeTransitions(room.reduce, 'none');
735
+ return (
736
+ <motion.div
737
+ ref={nodeRef}
738
+ data-fods-part="container"
739
+ className={className}
740
+ inert={!isPresent || undefined}
741
+ initial={{ opacity: 0 }}
742
+ animate={ready ? { opacity: 1, transition: fade.in } : { opacity: 0 }}
743
+ exit={{ opacity: 0, transition: fade.out }}
744
+ >
745
+ {children}
746
+ </motion.div>
747
+ );
748
+ }
749
+
750
+ type Fade = Pick<MotionProps, 'initial' | 'animate' | 'exit'>;
751
+
752
+ /**
753
+ * The Uploaded Multi Files stack, named by the field label. While it fades out (the
754
+ * last row was removed) it is `inert`, so nothing in it can be activated a second time.
755
+ */
756
+ function FileStack({
757
+ labelledBy,
758
+ className,
759
+ fade,
760
+ children,
761
+ }: {
762
+ labelledBy: string;
763
+ className: string;
764
+ fade: Fade;
765
+ children: React.ReactNode;
766
+ }) {
767
+ const isPresent = useIsPresent();
768
+ return (
769
+ <motion.ul
770
+ data-fods-part="file-stack"
771
+ aria-labelledby={labelledBy}
772
+ className={className}
773
+ inert={!isPresent || undefined}
774
+ {...fade}
775
+ >
776
+ {children}
777
+ </motion.ul>
778
+ );
779
+ }
780
+
781
+ /**
782
+ * One stack row. A removed row stays mounted while it fades out; `inert` takes it out
783
+ * of focus and of the pointer for that time, so its remove action cannot report the
784
+ * same id twice.
785
+ */
786
+ function FileRow({ className, fade, children }: { className: string; fade: Fade; children: React.ReactNode }) {
787
+ const isPresent = useIsPresent();
788
+ return (
789
+ <motion.li
790
+ data-fods-part="file-row"
791
+ className={className}
792
+ inert={!isPresent || undefined}
793
+ layout="position"
794
+ transition={REFLOW_TRANSITION}
795
+ {...fade}
796
+ >
797
+ {children}
798
+ </motion.li>
799
+ );
800
+ }
801
+
802
+ export { FileUpload, fileUploadVariants };