@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,13 @@
1
+ export {
2
+ Tooltip,
3
+ TooltipRoot,
4
+ TooltipTrigger,
5
+ TooltipContent,
6
+ TooltipPortal,
7
+ TooltipProvider,
8
+ TooltipArrow,
9
+ tooltipVariants,
10
+ type TooltipProps,
11
+ type TooltipContentProps,
12
+ type TooltipSize,
13
+ } from './Tooltip';
@@ -0,0 +1,215 @@
1
+ import { Meta, Canvas, Controls } from '@storybook/addon-docs/blocks';
2
+ import * as UnitFieldStories from './UnitField.stories';
3
+
4
+ <Meta of={UnitFieldStories} tags={['autodocs']} />
5
+
6
+ # UnitField
7
+
8
+ ## Metadata
9
+
10
+ - **Layer:** atom
11
+ - **Status:** stable
12
+ - **Tokens used:** `--bg-primary`, `--bg-readonly`, `--border-width-100`, `--border-width-200`, `--disabled-background`, `--disabled-foreground`, `--font-body`, `--font-size-base`, `--font-size-heading-h5`, `--font-size-sm`, `--font-size-xs`, `--font-size-xxs`, `--font-weight-bold`, `--font-weight-normal`, `--leading-loose`, `--leading-relaxed`, `--outline-default`, `--outline-focus`, `--outline-strong`, `--radius-400`, `--space-1000`, `--space-1100`, `--space-200`, `--space-300`, `--space-400`, `--space-500`, `--space-700`, `--space-800`, `--status-danger`, `--status-success-solid`, `--status-success-tint-foreground`, `--text-placeholder`, `--text-primary`, `--text-secondary`, `--text-wrap-body`
13
+ - **Manifest version:** `1.11.1`
14
+
15
+ ## Overview
16
+
17
+ A **UnitField** is a numeric field that always carries a unit: a currency amount (`Kč`), a percentage rate (`%`), or a piece count (`ks`). It is a [TextField](?path=/docs/design-system-atoms-textfield--docs) shell with a right-aligned **unit suffix** that renders in every state. Use it for editable amounts (Cena, Sazba DPH %) **and** for computed, read-only values the user can see but not edit (Výše DPH). The reference use-case is a document item row.
18
+
19
+ Do **not** use it for a unitless quantity (→ **NumberField**), a free string (→ **Input** / TextField), or choosing from a fixed set (→ **Select**).
20
+
21
+ <Canvas of={UnitFieldStories.Playground} />
22
+
23
+ ## Rationale
24
+
25
+ UnitField covers three things a plain TextField can't express: a persistent unit label glued to the value, a validation icon that doesn't collide with that label, and a way to show a **computed** number as informative rather than editable or off-limits.
26
+
27
+ 1. **The unit is part of the value's meaning, but sits one tier below it.** `1 000` and `1 000 Kč` are different facts, so the suffix renders in every state — including Disabled and Read-only. It renders in `--text-placeholder` (not `--text-secondary`) everywhere except Disabled, where the whole content mutes to `--disabled-foreground` (manifest 1.8.0): the value dominates the cell and the unit is a subordinate known glyph whose meaning is duplicated by the field's accessible name (`aria-describedby`) — a deliberate, documented WCAG exception.
28
+ 2. **Read-only is a state Disabled cannot express.** Disabled means "not applicable right now". A computed field like **Výše DPH** is the opposite: it's the most relevant number in the row, just not one you type into. UnitField's `Read-only` uses `--bg-readonly` (a dedicated fill, not `--disabled-background`), keeps the value in the tab order and copyable — because "informative" and "not applicable" are different UX promises. UnitField is the **first consumer** of `--bg-readonly`.
29
+ 3. **The status icon moved to leading because the trailing slot already belongs to the unit.** TextField/NumberField put the Error/Success icon trailing. UnitField's trailing side is permanently the unit, so the status icon moved to **leading** rather than being dropped.
30
+
31
+ ## Anatomy
32
+
33
+ - **Shell** — outlined TextField frame: `--bg-primary` fill (or `--bg-readonly` in Read-only), `--outline-default` border at `--border-width-100` (kept in Read-only and Disabled; Focused/Error/Success only swap its colour — except Error + focus, where the border keeps `--status-danger` and thickens to `--border-width-200` inside the shell), radius `--radius-400`, fixed height (Medium 48px, Small 40px).
34
+ - **Leading slot** — hidden by default; on **Error** shows a status icon (`--status-danger`), on **Success** a status icon (`--status-success-solid`). The reverse of TextField's trailing status icon (see Rationale §3).
35
+ - **Value** — `Body/M/Regular`, left-aligned, `--text-primary` when editable and in Read-only (full contrast — readable and copyable).
36
+ - **Unit suffix** — short text run, right-aligned, `--text-placeholder` in every state including Read-only (one tier quieter than the value, see Rationale §1); `--disabled-foreground` on Disabled. Never hidden. The one content prop (`unit`) — **required**, with no default: the design system is
37
+ locale-agnostic, and a baked-in `Kč` would be wrong in every market but one. Pass `''` for no
38
+ affix (a currency wrapper that hides its symbol does this).
39
+ - **Field wrapper** — floating label + helper/error text come from the surrounding [`Field`](?path=/docs/design-system-atoms-field--docs), not from UnitField itself.
40
+
41
+ ## Variants
42
+
43
+ <Canvas of={UnitFieldStories.Matrix} />
44
+
45
+ Three variant axes (State × Size × Unit side = 24), one content string (`unit`), one content boolean (`Show label` → `Field`'s `hideLabel`, inverted — see [Label](#label)). The Figma axis **Unit side** (`Right` default · `Left`) maps to the `unitPosition` prop (`suffix` / `prefix`).
46
+
47
+ <table>
48
+ <thead>
49
+ <tr><th>State</th><th>When</th><th>Tokens</th></tr>
50
+ </thead>
51
+ <tbody>
52
+ <tr><td><code>default</code></td><td>resting editable amount</td><td>border <code>--outline-default</code>, unit <code>--text-placeholder</code></td></tr>
53
+ <tr><td><code>focused</code></td><td>field has keyboard focus</td><td>border <code>--outline-focus</code> (no ring)</td></tr>
54
+ <tr><td><code>error</code></td><td>value fails validation (e.g. out of <code>min</code>/<code>max</code>)</td><td>border + leading icon <code>--status-danger</code>; on focus the border stays <code>--status-danger</code> and thickens to <code>--border-width-200</code> (never <code>--outline-focus</code>)</td></tr>
55
+ <tr><td><code>success</code></td><td>value confirmed valid</td><td>border + leading icon <code>--status-success-solid</code></td></tr>
56
+ <tr><td><code>disabled</code></td><td>field not applicable right now</td><td>fill <code>--disabled-background</code>, <code>--outline-default</code> border @ <code>--border-width-100</code>, value + unit <code>--disabled-foreground</code></td></tr>
57
+ <tr><td><code>readonly</code></td><td>computed value — informative, not editable (Výše DPH)</td><td>fill <code>--bg-readonly</code>, <code>--outline-default</code> border @ <code>--border-width-100</code>, value <code>--text-primary</code>, unit <code>--text-placeholder</code></td></tr>
58
+ </tbody>
59
+ </table>
60
+
61
+ **Format, not a variant:** values render in **cs-CZ** locale — space thousands-separator, comma decimal-separator (`1 000,00`). The `<input>` holds the raw unformatted number; grouping/decimals are applied on render and re-parsed on edit, never baked into the value (via the shared `NumberFormatInput` core). Decimal places follow the `unit`: **Kč → 2 fixed** (`1 000,00`), **% → up to 2 as needed** (`21`, `20,5`), **ks → 0** (`5`). Pass `precision` to override, `locale` for a non-`cs` separator scheme.
62
+
63
+ ### Unit side
64
+
65
+ <Canvas of={UnitFieldStories.UnitPosition} />
66
+
67
+ The manifest's third axis, `unit-side` (`Right` default · `Left`), maps onto the `unitPosition` prop. The grid above is that axis × state: rows = unit side, columns = states in `default · focused · error · success · disabled · readonly` order.
68
+
69
+ `unitPosition` chooses which side the unit sits on: `suffix` (Figma **Unit side=Right**, the default) → unit right, status icon left; `prefix` (Figma **Unit side=Left**) → unit left, status icon **automatically** on the right. The unit and the status icon always occupy opposite slots — a single prop drives both, so they can never collide. `prefix` exists for currencies with a leading symbol (`$100`, `€100`); the axis is part of the upstream spec since v1.3.0 (2026-07-19).
70
+
71
+ ## Sizes
72
+
73
+ <Canvas of={UnitFieldStories.Sizes} />
74
+
75
+ <table>
76
+ <thead>
77
+ <tr><th>Size</th><th style={{ textAlign: 'right' }}>Height</th><th>Padding (X)</th><th>Gap</th><th>Helper gap</th><th style={{ textAlign: 'right' }}>Icon</th><th>Radius</th><th>Width (min / max)</th></tr>
78
+ </thead>
79
+ <tbody>
80
+ <tr><td><code>md</code> (default)</td><td style={{ textAlign: 'right' }}>48px</td><td><code>--space-500</code></td><td><code>--space-400</code></td><td><code>--space-200</code></td><td style={{ textAlign: 'right' }}>24px</td><td><code>--radius-400</code></td><td>80 / 200</td></tr>
81
+ <tr><td><code>sm</code></td><td style={{ textAlign: 'right' }}>40px</td><td><code>--space-500</code></td><td><code>--space-400</code></td><td><code>--space-200</code></td><td style={{ textAlign: 'right' }}>20px</td><td><code>--radius-400</code></td><td>80 / 200</td></tr>
82
+ </tbody>
83
+ </table>
84
+
85
+ Identical geometry to TextField Medium/Small — the unit suffix and relocated status icon reuse the same slot padding. Pick the size by density, matching the row the field lives in.
86
+
87
+ **Helper gap** is the vertical step from the shell to the helper / message line that `Field` renders below it — `sizes[].helperGap`, `--space-200` (4) since manifest 1.11.0, the same ruling as TextField 2.13.0. It comes from the shared `Field` wrapper, so UnitField carries no gap of its own.
88
+
89
+ **One width floor, every state** — `minWidth` is a hard 80px on all 24 variants, and it is the shared field-family floor: Text Field and Number Field use the same number. Until 1.7.0 (2026-09-02) the floor was per *state* — 96px iconless, 128px on Error/Success, because the leading status icon eats into the value's room — and that model is retired. The spec names the trade it accepts: at 80px an Error/Success field carrying both the status icon and a four-digit amount will truncate the value, and the fix is the consumer's column width, not a wider component. `maxWidth` 200px is guidance only (a wider consumer column is fine, just not required).
90
+
91
+ ## States
92
+
93
+ <Canvas of={UnitFieldStories.States} />
94
+
95
+ - **Default** — `--outline-default` border; unit `--text-placeholder`.
96
+ - **Focused** — border turns `--outline-focus`; no ring (border-swap only). Success + focus is this same plain swap; Error + focus is not (below).
97
+ - **Error** — `--status-danger` border + a **leading** status icon + the helper line in `--status-danger`. Sets `aria-invalid`.
98
+ - **Error + focus** — a composition, not a seventh state value (TextField rule). The border **keeps** `--status-danger` and goes from `--border-width-100` to `--border-width-200` while the field has focus — colour carries the state, weight carries the focus; `--outline-focus` never shows on an invalid field (a blue border would say "fine" while label, icon and message say "wrong"). The added weight sits **inside** the shell — an inset `box-shadow` of `calc(var(--border-width-200) - var(--border-width-100))` on top of the 1px border — so the height (48 / 40) is unchanged and the content does not shift. The **leading** status icon, label and message stay exactly as in Error; the floating-label notch widens from `--border-width-100` to `--border-width-200`, so no red line shows under the label.
99
+ - **Success** — `--status-success-solid` border + a **leading** status icon.
100
+ - **Disabled** — `--outline-default` border at `--border-width-100`, `--disabled-background` fill, value, label **and unit** in `--disabled-foreground` — the whole content mutes together (the one state where the unit leaves `--text-placeholder`); not focusable.
101
+ - **Read-only** — `--bg-readonly` fill, the same `--outline-default` border as Disabled, value in `--text-primary`, unit `--text-placeholder`. Native `readonly` (+ `aria-readonly`), stays focusable/selectable/copyable — not Disabled (see Rationale §2).
102
+
103
+ **Motion: none.** Manifest 1.11.1 `motion.none`: „no motion of its own — focus swaps the border colour at once (focus is never animated), the field has no hover state, and the label is always floated (no Has value axis), so there is no floating-label move to inherit from Text Field“. **Shell swaps at once (2026-11-10).** The raw `transition-colors duration-200` the shell recipe inherited from the Text Field shell is gone (on the whole field family at once), so the focus, error and success border colours swap at once, as `motion.none` says.
104
+
105
+ ### Label
106
+
107
+ A UnitField **always floats** the label (it always carries a value/unit — there is no resting position),
108
+ so the empty cells show the label at the top with an empty interior. Disabled and Read-only keep the
109
+ border, so their label shows the same notch as every other state — a `--border-width-100` strip in the
110
+ surface colour under the field (default `--bg-primary`) on the border line, not a backplate.
111
+
112
+ **Hiding the label.** Figma's `Show label` property maps to [`Field`](?path=/docs/design-system-atoms-field--docs)'s
113
+ **`hideLabel`** boolean, with inverted polarity (`Show label = false` ⇔ `hideLabel = true`) — manifest
114
+ 1.7.3 names the prop. The `<label>` stays in the DOM and is hidden with `sr-only`, so the accessible
115
+ name survives without a separate `aria-label`; that is what makes repeated line-item rows legal,
116
+ where row 1's labels act as column captions. Never drop the `label` prop to hide it, and never reach
117
+ for a CSS override: hiding is visual-only, and it belongs to the shared wrapper, not to `UnitField`.
118
+
119
+ <Canvas of={UnitFieldStories.WithLabel} />
120
+
121
+ ## API
122
+
123
+ <Controls />
124
+
125
+ ## Do / Don't
126
+
127
+ - ✅ Use `state="readonly"` for a value the system computed (Výše DPH).
128
+ - ✅ Keep the unit suffix visible in every state, including Disabled/Read-only.
129
+ - ✅ Reach for **NumberField** the moment the value has no unit.
130
+ - ✅ Render `state="readonly"` (native `readonly`) for the read-only look.
131
+ - ✅ Set `min`/`max` for any bounded rate (Sazba DPH 0–100 %) and let `state="error"` carry the message.
132
+ - ❌ Don't use `state="disabled"` for a computed value — it tells the user the field is irrelevant, not just non-editable.
133
+ - ❌ Don't hide or fade the unit further than the value — it's part of the number's meaning.
134
+ - ❌ Don't render a bare quantity through UnitField with an empty `unit` string.
135
+ - ❌ Don't disable the input to fake read-only — it drops the value from the tab order and breaks copy/select.
136
+ - ❌ Don't invent a visual "at-bound" treatment — UnitField has no stepper, so Error is the only signal.
137
+
138
+ ## Accessibility
139
+
140
+ - **Keyboard** — standard numeric entry when editable; Read-only stays in the tab order, selectable and copyable, just not editable. Disabled drops from the tab order.
141
+ - **ARIA** — Error sets `aria-invalid="true"`; Read-only sets `aria-readonly="true"` alongside the native `readonly` attribute. The unit suffix is associated via `aria-describedby`, never concatenated into the input's `value`.
142
+ - **Screen reader** — the leading status icon reinforces Error/Success so colour is never the only cue (WCAG 1.4.1). On Read-only, add a helper line stating where the value comes from (e.g. `Vypočteno automaticky`) so a SR user isn't left guessing why the field won't accept input.
143
+ - **Contrast & motion** — focus is a `--outline-focus` border swap (no ring; the manifest wants it instant — see the open discrepancy under States), TextField parity — except on an invalid field, where the border keeps `--status-danger` and thickens to `--border-width-200` (Error + focus); Read-only shows the native text-selection highlight on focus.
144
+
145
+ Accessibility floor for every FODS component: `spec/01-foundations/accessibility.md`.
146
+
147
+ ## Copy
148
+
149
+ Voice: the field-copy rules of [TextField](?path=/docs/design-system-atoms-textfield--docs) apply to the label, helper and error: impersonal, clear, concise and specific; an error says what is wrong and how to fix it. UnitField adds one run of its own, the unit string.
150
+
151
+ - **Label** (`Field` `label`) — a noun phrase naming what the amount represents, never a command: `Cena`, `Sazba DPH`, `Výše DPH`, not `Zadejte cenu:`. Single line, truncates, max 24 characters; same mechanics as the TextField label.
152
+ - **Value** (`value` / `defaultValue`) — the number itself. Single line, scrolls inside the input. Displayed in the cs-CZ format (space thousands separator, comma decimal separator, `1 000,00`); the input holds the raw number, the grouping is applied on display and re-parsed on edit. Decimal places follow the unit: `Kč` 2, `%` 0–2 as needed, `ks` 0.
153
+ - **Unit** (`unit`) — the shortest correct symbol, with no space baked in (the component supplies the gap): `Kč`, `%`, `ks`, not `Kč ` (trailing space) or `korun` (spelled out). Single line, truncates, max 4 characters; truncation is a guard, not an expected case.
154
+ - **Helper** (`Field` `helperText`) — wraps, max 120 characters; same mechanics as the TextField helper. On Read-only, an optional one-line helper states that the value is derived and not editable.
155
+ - **Error** (`Field` `error`) — problem and fix, the same pattern as TextField. Wraps, max 140 characters, must be fully visible, and replaces the helper.
156
+
157
+ <table>
158
+ <thead>
159
+ <tr><th>Run</th><th>Write</th><th>Don't write</th></tr>
160
+ </thead>
161
+ <tbody>
162
+ <tr><td>Unit</td><td><code>Kč</code> · <code>%</code> · <code>ks</code></td><td><code>Kč </code> (trailing space) · <code>korun</code></td></tr>
163
+ <tr><td>Label</td><td><code>Cena</code> · <code>Sazba DPH</code> · <code>Výše DPH</code></td><td><code>Zadejte cenu:</code></td></tr>
164
+ <tr><td>Read-only helper</td><td><code>Vypočteno automaticky</code></td><td>no helper, which leaves the user asking why the field cannot be edited</td></tr>
165
+ <tr><td>Error</td><td><code>Sazba DPH musí být 0–100 %</code></td><td><code>Neplatná hodnota</code></td></tr>
166
+ </tbody>
167
+ </table>
168
+
169
+ ## Usage
170
+
171
+ ```tsx
172
+ import { Field, UnitField } from '@invoiceonline/ui-react';
173
+
174
+ // Editable amount
175
+ <Field label="Cena">
176
+ <UnitField id="cena" defaultValue="1 000" unit="Kč" />
177
+ </Field>
178
+
179
+ // Bounded rate with an error
180
+ <Field label="Sazba DPH" error={'Sazba DPH musí být 0–100\u00a0%'}>
181
+ <UnitField id="dph" state="error" defaultValue="150" unit="%" min={0} max={100} />
182
+ </Field>
183
+
184
+ // Computed, read-only value
185
+ <Field label="Výše DPH" helperText="Vypočteno automaticky">
186
+ <UnitField id="vyse-dph" state="readonly" defaultValue="210" unit="Kč" />
187
+ </Field>
188
+ ```
189
+
190
+ ```tsx
191
+ // Don't — disabling to fake a read-only look drops the value from the tab order
192
+ <UnitField state="disabled" defaultValue="210" unit="Kč" />
193
+
194
+ // Don't — an empty unit is a NumberField with extra steps
195
+ <UnitField unit="" defaultValue="5" />
196
+ ```
197
+
198
+ <Canvas of={UnitFieldStories.WithField} />
199
+
200
+ ## Related
201
+
202
+ - [`Field`](?path=/docs/design-system-atoms-field--docs) — the required wrapper for floating label + helper/error text
203
+ - [`TextField`](?path=/docs/design-system-atoms-textfield--docs) — the sibling free-text control
204
+ - [`NumberField`](?path=/docs/design-system-atoms-numberfield--docs) — for a unitless numeric quantity
205
+ - Spec: `spec/03-atoms/unit-field.md`
206
+
207
+ ## Migration notes
208
+
209
+ - **Motion (manifest 1.11.1, 2026-11-03) — documentation only.** The field is declared static (`motion.none`, no `inherits`). No code change; the shell's raw colour transition is an open discrepancy against it (see States).
210
+ - **`--bg-readonly` is new** — added specifically for this component's Read-only fill. UnitField is its first consumer; any future field adding a read-only state should reuse this token and the fill/text/border recipe (`--bg-readonly` fill, `--text-primary` value, the Default `--outline-default` border — manifest 1.8.0) rather than inventing a new one.
211
+ - **Status icon moved to leading** — a deliberate divergence from TextField/NumberField's trailing status icon, forced by the unit suffix owning the trailing slot (default `unitPosition="suffix"`).
212
+ - **`unitPosition="prefix"` is now in the upstream spec** — originally an FE-ahead-of-spec extension, the mirrored layout was adopted upstream as the **Unit side** axis (`Right` default · `Left`) in manifest v1.3.0 (2026-07-19), growing the variant matrix from 12 to 24.
213
+ - **Unit suffix retuned to `--text-placeholder`** (spec v1.3.0, 2026-07-19) — originally `--text-secondary`; the unit now sits one tier below the value in every state, including Read-only (see Rationale §1). Manifest 1.8.0 (2026-09-22) carved out Disabled: there the unit mutes to `--disabled-foreground` with the rest of the content.
214
+ - **⚠️ Known code ↔ spec mismatch, now only half of one:** the spec assumes `warning-circle` (Error) and `check-circle` (Success). Error renders `warning-circle` as specified. Success is the remaining mismatch: the icon set carries `check-circle`, but the code still renders the bare `check`. Switching it is a follow-up on the component, not on the icon set.
215
+ - **cs-CZ display formatting is implemented** — the spec's format rule (space thousands-separator, comma decimals — `1 000,00`, applied on display and re-parsed on edit, decimals derived from `unit`) is handled by the shared `NumberFormatInput` core. The `<input>` still holds the raw number; consumers read it via `onValueChange` and pass a numeric `value` / `defaultValue`.
@@ -0,0 +1,291 @@
1
+ import type { Meta, StoryObj } from '@storybook/react-vite';
2
+ import type { ReactNode } from 'react';
3
+ import { fn } from 'storybook/test';
4
+ import { UnitField } from './UnitField';
5
+ import { Field } from '../field/Field';
6
+ import { Section, Showcase } from '../../storybook/Section';
7
+ import { componentDoc } from '../../storybook/componentDoc';
8
+ import { FORCE_ERROR_FOCUS, FieldErrorFocusStyles } from '../../storybook/forceStates';
9
+
10
+ const SIZES = ['md', 'sm'] as const;
11
+ const STATES = ['default', 'focused', 'error', 'success', 'disabled', 'readonly'] as const;
12
+ // The bare atoms below stand outside a `Field`, so nothing labels them: each takes an
13
+ // `aria-label` instead (a label is always present — text-field.md § Copy).
14
+ const PRICE_LABEL = 'Cena';
15
+ const RATE_LABEL = 'Sazba DPH';
16
+ // Manifest `axes.unit-side` — which end the unit affix sits on. The code prop is
17
+ // `unitPosition`, so the axis values map onto it here. Covered by the UnitPosition
18
+ // story below.
19
+ const UNIT_SIDES = ['right', 'left'] as const;
20
+ const UNIT_POSITION_FOR: Record<(typeof UNIT_SIDES)[number], 'suffix' | 'prefix'> = {
21
+ right: 'suffix',
22
+ left: 'prefix',
23
+ };
24
+
25
+ // UnitField is w-full — pin a realistic field width for showcase stories.
26
+ const Frame = ({ children }: { children: ReactNode }) => (
27
+ <div className="w-[calc(var(--space-900)*7)]">{children}</div>
28
+ );
29
+
30
+ const meta = {
31
+ title: 'Design System/Atoms/UnitField',
32
+ component: UnitField,
33
+ parameters: {
34
+ layout: 'centered',
35
+ containerWidth: 260,
36
+ docs: {
37
+ description: {
38
+ component: componentDoc({
39
+ summary:
40
+ 'Numeric field with a right-aligned unit suffix (Kč, %, ks). Covers editable amounts and computed, read-only values. For a floating label, error or helper text, wrap it in `Field`.',
41
+ useCases: [
42
+ '`unit="Kč"` — currency amounts (Cena, Výše DPH)',
43
+ '`unit="%"` with `min={0}` / `max={100}` — bounded rates (Sazba DPH)',
44
+ '`state="readonly"` — computed values the user can see and copy but not edit (Výše DPH)',
45
+ '`size="sm"` — dense line-item rows and inline editors',
46
+ '`state="error"` / `"success"` — a leading status icon (the trailing slot is the unit)',
47
+ ],
48
+ bestPractices: [
49
+ 'For a floating label always wrap in `Field` — the label auto-floats (UnitField always carries a value)',
50
+ 'Use `state="readonly"` (native `readonly`) for computed values, never `disabled` — read-only stays copyable and in the tab order',
51
+ 'Keep the unit as the shortest correct symbol with no baked-in space (`Kč`, `%`, `ks`) — the component supplies the gap',
52
+ 'Pair `state="error"` with a matching `error` message on the `Field`',
53
+ ],
54
+ knownIssues: [
55
+ 'Error uses `warning-circle`, Success uses `check` (not the spec `check-circle`) as the leading status icons',
56
+ ],
57
+ docsLink: { label: 'spec/03-atoms/unit-field.md' },
58
+ }),
59
+ },
60
+ },
61
+ },
62
+ // `unit` is a required prop (the design system ships no currency default), so
63
+ // the showcase stories — which render their own markup and pass no args —
64
+ // inherit one here.
65
+ args: { unit: 'Kč' },
66
+ } satisfies Meta<typeof UnitField>;
67
+
68
+ export default meta;
69
+ type Story = StoryObj<typeof meta>;
70
+
71
+ export const Playground: Story = {
72
+ args: {
73
+ defaultValue: 1000,
74
+ unit: 'Kč',
75
+ unitPosition: 'suffix',
76
+ size: 'md',
77
+ state: 'default',
78
+ // An explicit spy: the field reports its value while it mounts, and an implicit action
79
+ // (the `on*` matcher of preview.tsx) called during a render throws in the docs page.
80
+ onValueChange: fn(),
81
+ },
82
+ argTypes: {
83
+ unit: { control: 'text' },
84
+ unitPosition: { control: 'inline-radio', options: ['suffix', 'prefix'] },
85
+ size: { control: 'select', options: SIZES },
86
+ state: { control: 'select', options: STATES },
87
+ },
88
+ /*
89
+ * Wrapped in `Field`, which is how the component actually ships: the floating
90
+ * label is the real <label> and is what gives the input its accessible name
91
+ * (WCAG 4.1.2), and the helper line is what `aria-describedby` resolves to, so
92
+ * the Error state announces its message (WCAG 3.3.1). The error message is tied
93
+ * to the `state` arg so the wiring appears exactly when `aria-invalid` does.
94
+ */
95
+ render: args => (
96
+ <Frame>
97
+ <Field
98
+ label="Cena bez DPH"
99
+ error={args.state === 'error' ? 'Cena bez DPH musí být větší než 0\u00a0Kč' : undefined}
100
+ success={args.state === 'success' ? 'Částka je v\u00a0pořádku' : undefined}
101
+ helperText={
102
+ args.state === 'error' || args.state === 'success' ? undefined : 'Za měrnou jednotku'
103
+ }
104
+ >
105
+ <UnitField id="playground-unit-field" {...args} />
106
+ </Field>
107
+ </Frame>
108
+ ),
109
+ };
110
+
111
+ export const Matrix: Story = {
112
+ parameters: {
113
+ docs: {
114
+ description: {
115
+ story:
116
+ 'Full state × size matrix — mirrors the Figma labelled grid. Rows = states, columns = sizes. Error/Success carry the leading status icon; Disabled and Read-only drop the border.',
117
+ },
118
+ },
119
+ },
120
+ render: () => (
121
+ <Showcase>
122
+ {STATES.map(state => (
123
+ <Section key={state} title={state} layout="row">
124
+ {SIZES.map(size => (
125
+ <div key={size} className="w-[calc(var(--space-600)*13)]">
126
+ <UnitField aria-label={PRICE_LABEL} state={state} size={size} defaultValue={1000} unit="Kč" />
127
+ </div>
128
+ ))}
129
+ </Section>
130
+ ))}
131
+ </Showcase>
132
+ ),
133
+ };
134
+
135
+ export const Sizes: Story = {
136
+ parameters: {
137
+ docs: { description: { story: 'Medium — standalone amount fields · Small — dense rows. Pick by density.' } },
138
+ },
139
+ render: () => (
140
+ <Showcase>
141
+ <Section title="Medium (default)" layout="column">
142
+ <Frame><UnitField aria-label={PRICE_LABEL} size="md" defaultValue={1000} unit="Kč" /></Frame>
143
+ <Frame><UnitField aria-label={RATE_LABEL} size="md" defaultValue={21} unit="%" /></Frame>
144
+ </Section>
145
+ <Section title="Small" layout="column">
146
+ <Frame><UnitField aria-label={PRICE_LABEL} size="sm" defaultValue={1000} unit="Kč" /></Frame>
147
+ <Frame><UnitField aria-label={RATE_LABEL} size="sm" defaultValue={21} unit="%" /></Frame>
148
+ </Section>
149
+ </Showcase>
150
+ ),
151
+ };
152
+
153
+ export const States: Story = {
154
+ parameters: {
155
+ docs: { description: { story: 'All six visual states. Read-only ≠ Disabled — read-only is informative (computed), disabled is not applicable. Error + focus keeps the `--status-danger` border and thickens it to `--border-width-200` inside the shell; `--outline-focus` never shows on an invalid field (forced statically below — focus is runtime-only).' } },
156
+ },
157
+ render: () => (
158
+ <Showcase>
159
+ <FieldErrorFocusStyles />
160
+ <Section title="Editable" layout="column">
161
+ <Frame><UnitField aria-label={PRICE_LABEL} state="default" defaultValue={1000} unit="Kč" /></Frame>
162
+ <Frame><UnitField aria-label={PRICE_LABEL} state="focused" defaultValue={1000} unit="Kč" /></Frame>
163
+ <Frame><UnitField aria-label={PRICE_LABEL} state="error" defaultValue={1000} unit="Kč" /></Frame>
164
+ <Frame><UnitField aria-label={PRICE_LABEL} state="success" defaultValue={1000} unit="Kč" /></Frame>
165
+ </Section>
166
+ <Section title="Error + focus" layout="column">
167
+ <Frame>
168
+ <div className={FORCE_ERROR_FOCUS}>
169
+ <UnitField aria-label={PRICE_LABEL} state="error" defaultValue={1000} unit="Kč" />
170
+ </div>
171
+ </Frame>
172
+ </Section>
173
+ <Section title="Non-editable" layout="column">
174
+ <Frame><UnitField aria-label={PRICE_LABEL} state="disabled" defaultValue={1000} unit="Kč" /></Frame>
175
+ <Frame><UnitField aria-label={PRICE_LABEL} state="readonly" defaultValue={1000} unit="Kč" /></Frame>
176
+ </Section>
177
+ </Showcase>
178
+ ),
179
+ };
180
+
181
+ export const UnitPosition: Story = {
182
+ parameters: {
183
+ docs: {
184
+ description: {
185
+ story:
186
+ 'Manifest `axes.unit-side` × state — the second half of the Figma labelled grid (State × Size × Unit side = 24 variants). Rows = unit side, columns = states in `default · focused · error · success · disabled · readonly` order. `right` (default, `unitPosition="suffix"`) puts the unit trailing and the Error/Success status icon leading; `left` (`unitPosition="prefix"`) mirrors both — unit leading, status icon trailing. A single prop drives both slots, so the unit and the icon can never collide. `left` exists for currencies with a leading symbol (`$100`, `€100`) and is part of the upstream spec since manifest v1.3.0.',
187
+ },
188
+ },
189
+ },
190
+ render: () => (
191
+ <Showcase>
192
+ {UNIT_SIDES.map(side => (
193
+ <Section key={side} title={`${side} (unitPosition="${UNIT_POSITION_FOR[side]}")`} layout="row">
194
+ {STATES.map(state => (
195
+ <div key={state} className="w-[calc(var(--space-600)*13)]">
196
+ <UnitField aria-label={PRICE_LABEL}
197
+ unitPosition={UNIT_POSITION_FOR[side]}
198
+ state={state}
199
+ defaultValue={1000}
200
+ unit="Kč"
201
+ />
202
+ </div>
203
+ ))}
204
+ </Section>
205
+ ))}
206
+ </Showcase>
207
+ ),
208
+ };
209
+
210
+ export const WithField: Story = {
211
+ parameters: {
212
+ docs: {
213
+ description: {
214
+ story:
215
+ 'Real usage — wrapped in `Field` for the floating label, helper and error/success messaging. The label auto-floats because UnitField always carries a value.',
216
+ },
217
+ },
218
+ },
219
+ render: () => (
220
+ <Showcase>
221
+ <Section title="Editable amount" layout="column">
222
+ <Frame>
223
+ <Field label="Cena">
224
+ <UnitField id="cena" defaultValue={1000} unit="Kč" />
225
+ </Field>
226
+ </Frame>
227
+ <Frame>
228
+ <Field label="Sazba DPH" error={'Sazba DPH musí být 0–100\u00a0%'}>
229
+ <UnitField id="dph" state="error" defaultValue={150} unit="%" />
230
+ </Field>
231
+ </Frame>
232
+ </Section>
233
+ <Section title="Computed (read-only)" layout="column">
234
+ <Frame>
235
+ <Field label="Výše DPH" helperText="Vypočteno automaticky">
236
+ <UnitField id="vyse-dph" state="readonly" defaultValue={210} unit="Kč" />
237
+ </Field>
238
+ </Frame>
239
+ </Section>
240
+ </Showcase>
241
+ ),
242
+ };
243
+
244
+ export const WithLabel: Story = {
245
+ parameters: {
246
+ docs: {
247
+ description: {
248
+ story:
249
+ 'The floating label across value × state. A UnitField **always floats** the label (it always carries a value/unit — no resting position), so the empty cells show the label at the top with an empty interior. Disabled and Read-only keep the border, so their label shows the same 1px surface-colour notch strip as every other state.',
250
+ },
251
+ },
252
+ },
253
+ render: () => (
254
+ <Showcase>
255
+ <Section title="Bez hodnoty" layout="column">
256
+ <Frame>
257
+ <Field label="Cena"><UnitField id="ul-empty" unit="Kč" /></Field>
258
+ </Frame>
259
+ <Frame>
260
+ <Field label="Cena"><UnitField id="ul-empty-dis" state="disabled" unit="Kč" /></Field>
261
+ </Frame>
262
+ <Frame>
263
+ <Field label="Cena"><UnitField id="ul-empty-ro" state="readonly" unit="Kč" /></Field>
264
+ </Frame>
265
+ </Section>
266
+ <Section title="S hodnotou" layout="column">
267
+ <Frame>
268
+ <Field label="Cena"><UnitField id="ul-val" defaultValue={1000} unit="Kč" /></Field>
269
+ </Frame>
270
+ <Frame>
271
+ <Field label="Cena"><UnitField id="ul-val-dis" state="disabled" defaultValue={1000} unit="Kč" /></Field>
272
+ </Frame>
273
+ <Frame>
274
+ <Field label="Cena"><UnitField id="ul-val-ro" state="readonly" defaultValue={1000} unit="Kč" /></Field>
275
+ </Frame>
276
+ </Section>
277
+ <Section title="Stavy (error / success)" layout="column">
278
+ <Frame>
279
+ <Field label="Sazba DPH" error={'Sazba DPH musí být 0–100\u00a0%'}>
280
+ <UnitField id="ul-err" state="error" defaultValue={150} unit="%" />
281
+ </Field>
282
+ </Frame>
283
+ <Frame>
284
+ <Field label="Sazba DPH" success="Sazba je platná">
285
+ <UnitField id="ul-ok" state="success" defaultValue={21} unit="%" />
286
+ </Field>
287
+ </Frame>
288
+ </Section>
289
+ </Showcase>
290
+ ),
291
+ };