@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,223 @@
1
+ import { Meta, Canvas, Controls } from '@storybook/addon-docs/blocks';
2
+ import * as NumberFieldStories from './NumberField.stories';
3
+
4
+
5
+ <Meta of={NumberFieldStories} tags={['autodocs']} />
6
+
7
+ # NumberField
8
+
9
+ ## Metadata
10
+
11
+ - **Layer:** atom
12
+ - **Status:** stable
13
+ - **Tokens used:** `--bg-primary`, `--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-300`, `--radius-400`, `--secondary`, `--size-icon-xsmall`, `--space-1000`, `--space-1100`, `--space-200`, `--space-300`, `--space-400`, `--space-500`, `--space-700`, `--space-800`, `--space-900`, `--status-danger`, `--status-success-solid`, `--status-success-tint-foreground`, `--text-primary`, `--text-secondary`, `--text-wrap-body`
14
+ - **Manifest version:** `1.12.1`
15
+
16
+ ## Overview
17
+
18
+ A **NumberField** is a [TextField](?path=/docs/design-system-atoms-textfield--docs) shell with a **stepper** (− / +) flanking a **centered** numeric value. Use it for small, boundable counts the user is as likely to nudge up/down with ± as to type — the reference case is the item-row **Počet** (quantity) of an expense, seat counts, or small repeatable-item tallies.
19
+
20
+ The stepper is the differentiator: **if incrementing/decrementing by one doesn't make sense for the value, it isn't a NumberField.** Do **not** use it for an amount with a unit (Kč, %) → [UnitField](?path=/docs/design-system-atoms-unitfield--docs); a free number with no natural step → [TextField](?path=/docs/design-system-atoms-textfield--docs) `type=numeric`; or choosing from a fixed set → [Select](?path=/docs/design-system-organisms-select--docs).
21
+
22
+ <Canvas of={NumberFieldStories.Playground} />
23
+
24
+ ## Rationale
25
+
26
+ NumberField gives a quantity a ± affordance and a cue that the value is a bounded count rather than free text.
27
+
28
+ 1. **One shell, not a new one.** NumberField is the TextField shell plus a stepper — border, fill, radius, floating label and helper/error text all behave exactly as TextField's. Fixing the shell once (in TextField) still fixes NumberField.
29
+ 2. **The stepper is fixed, not a slot.** Unlike TextField's optional leading/trailing icon, the two stepper buttons are permanently minus/plus — there's nothing to swap, so no builder can wire the wrong icon in.
30
+ 3. **Touch target is built in.** Each stepper sits inside an invisible 32×32 hit-area frame in both sizes — larger than the painted 16px glyph — so the component clears WCAG 2.5.8 (AA, 24×24) with margin without the consumer adding padding by default.
31
+ 4. **No "Has value" axis.** A quantity is never "empty" the way a name or email can be — it always renders a real number (defaulting to 1), so the floating label always floats. Dropping that axis keeps the matrix honest about what NumberField actually varies.
32
+
33
+ ## Anatomy
34
+
35
+ - **Shell** — the same outlined TextField frame: `--bg-primary` fill, `--outline-default` 1px border, radius `--radius-400`, fixed height (Medium 48px, Small 40px). The inner edge padding is tighter than TextField's `--space-500` because the steppers sit flush against the edges.
36
+ - **Stepper − decrement** — a fixed **minus** glyph (16px `--size-icon-xsmall`, both sizes) inside an invisible 32×32 hit-area frame, flush left. Ink `--secondary` (the secondary blue) when live, `--disabled-foreground` when Disabled or at `min`. Not a swap slot.
37
+ - **Value** — `Body/M/Regular`, **centered** (not left-aligned like TextField — a single stepped number reads better centered than scanned like a sentence). Always present; no placeholder state.
38
+ - **Stepper − increment** — mirrors decrement on the right edge; a fixed **plus** glyph.
39
+ - **Field wrapper** — floating label + helper/error text come from the surrounding [`Field`](?path=/docs/design-system-atoms-field--docs), not from NumberField itself.
40
+
41
+ There is **no** leading/trailing icon slot and **no** Error/Success status icon — both edge slots are permanently the stepper. Validation is carried by border colour plus the (required) helper/error text alone.
42
+
43
+ ## Variants
44
+
45
+ <Canvas of={NumberFieldStories.Matrix} />
46
+
47
+ Two variant axes (State × Size = 10). There is **no** "Has value" axis (see Rationale §4) and **no** leading/trailing icon boolean — the stepper occupies both edges permanently.
48
+
49
+ <table>
50
+ <thead>
51
+ <tr><th>State</th><th>When</th><th>Tokens</th></tr>
52
+ </thead>
53
+ <tbody>
54
+ <tr><td><code>default</code></td><td>resting editable count</td><td>border <code>--outline-default</code>, stepper ink <code>--secondary</code></td></tr>
55
+ <tr><td><code>focused</code></td><td>field has keyboard focus</td><td>border <code>--outline-focus</code> (no ring)</td></tr>
56
+ <tr><td><code>error</code></td><td>value fails validation (e.g. below <code>min</code>)</td><td>border <code>--status-danger</code>; no status icon; on focus the border stays <code>--status-danger</code> and thickens to <code>--border-width-200</code> (never <code>--outline-focus</code>)</td></tr>
57
+ <tr><td><code>success</code></td><td>value confirmed valid</td><td>border <code>--status-success-solid</code>; no status icon</td></tr>
58
+ <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>, content + both steppers <code>--disabled-foreground</code></td></tr>
59
+ </tbody>
60
+ </table>
61
+
62
+ ### Constraints (code props, not Figma variants)
63
+
64
+ <Canvas of={NumberFieldStories.Constraints} />
65
+
66
+ `min` / `max` / `step` are code-level constraints, not State variants. **At a bound only the relevant stepper greys out** (`--disabled-foreground`) and stops responding — the field, the other stepper and the input stay live. At-bound is independent of `State`: a field can be `state="focused"` and at its `max` at the same time.
67
+
68
+ <table>
69
+ <thead>
70
+ <tr><th>Prop</th><th style={{ textAlign: 'right' }}>Default</th><th>Behaviour</th></tr>
71
+ </thead>
72
+ <tbody>
73
+ <tr><td><code>min</code></td><td style={{ textAlign: 'right' }}>unset</td><td>at the floor the <strong>decrement</strong> stepper alone greys to <code>--disabled-foreground</code> and stops responding — not <code>State=Disabled</code></td></tr>
74
+ <tr><td><code>max</code></td><td style={{ textAlign: 'right' }}>unset</td><td>mirrors <code>min</code> on the <strong>increment</strong> stepper at the ceiling</td></tr>
75
+ <tr><td><code>step</code></td><td style={{ textAlign: 'right' }}>1</td><td>amount each stepper press adds/subtracts</td></tr>
76
+ <tr><td><code>precision</code></td><td style={{ textAlign: 'right' }}>decimals of <code>step</code></td><td>decimal places kept when a typed or stepped value is committed; the stepper still moves by <code>step</code>. Above 0 the input is a text input with <code>inputmode="decimal"</code> and <code>role="spinbutton"</code> that accepts a decimal comma or dot</td></tr>
77
+ <tr><td><code>locale</code></td><td style={{ textAlign: 'right' }}><code>cs</code></td><td>decimal separator of a decimal value (<code>cs</code> → comma); no grouping. Has no effect on the whole-number input</td></tr>
78
+ </tbody>
79
+ </table>
80
+
81
+ A typed value outside `[min, max]` clamps to the nearest bound **on blur/commit**, not on every keystroke — the user can type through a momentarily out-of-range digit.
82
+
83
+ <Canvas of={NumberFieldStories.DecimalQuantity} />
84
+
85
+ With `precision` the committed value keeps that many decimals and shows the locale's decimal separator — «1,5» in `cs`, never «1.5»; `aria-valuenow` stays a plain number. Without it a whole-number `step` keeps whole numbers, as before. A typed draft that is not a number is dropped on blur and the last committed value comes back.
86
+
87
+ ## Sizes
88
+
89
+ <Canvas of={NumberFieldStories.Sizes} />
90
+
91
+ <table>
92
+ <thead>
93
+ <tr><th>Size</th><th style={{ textAlign: 'right' }}>Height</th><th>Edge padding (X)</th><th>Gap</th><th>Helper gap</th><th style={{ textAlign: 'right' }}>Icon</th><th style={{ textAlign: 'right' }}>Hit area</th><th>Radius</th><th>Width (min / max)</th></tr>
94
+ </thead>
95
+ <tbody>
96
+ <tr><td><code>md</code> (default)</td><td style={{ textAlign: 'right' }}>48px</td><td><code>--space-200</code> (4)</td><td><code>--space-400</code></td><td><code>--space-200</code></td><td style={{ textAlign: 'right' }}>16px</td><td style={{ textAlign: 'right' }}>32×32</td><td><code>--radius-400</code></td><td>80 / 160</td></tr>
97
+ <tr><td><code>sm</code></td><td style={{ textAlign: 'right' }}>40px</td><td><code>--space-300</code> (6)</td><td><code>--space-400</code></td><td><code>--space-200</code></td><td style={{ textAlign: 'right' }}>16px</td><td style={{ textAlign: 'right' }}>32×32</td><td><code>--radius-400</code></td><td>80 / 160</td></tr>
98
+ </tbody>
99
+ </table>
100
+
101
+ Same fixed heights as TextField (48/40), but the shell edge padding is tighter than TextField's `--space-500` because the steppers sit flush against the edges. Pick the size by density, matching the row the field lives in.
102
+
103
+ **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 NumberField carries no gap of its own.
104
+
105
+ ## States
106
+
107
+ <Canvas of={NumberFieldStories.States} />
108
+
109
+ - **Default** — `--outline-default` border; stepper ink `--secondary`.
110
+ - **Focused** — border turns `--outline-focus`; no ring (border-swap only, TextField parity). Success + focus is this same plain swap; Error + focus is not (below).
111
+ - **Error** — `--status-danger` border; helper line turns `--status-danger`. **No status icon** (see Anatomy) — border colour + the error message are the only cues, so the error text is not optional here. Sets `aria-invalid`.
112
+ - **Error + focus** — a composition, not a sixth 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. This matters more here than on TextField: with no status icon (both slots hold the stepper), the border is the **only** in-shell error cue, and a blue swap would erase it for exactly as long as the user is fixing the value. 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. Label, message and steppers 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.
113
+ - **Success** — `--status-success-solid` border. No status icon, same reasoning as Error.
114
+ - **Disabled** — `--outline-default` border at `--border-width-100`, `--disabled-background` fill, content **and both steppers** in `--disabled-foreground`; steppers lose interactivity and drop from the tab order.
115
+
116
+ **Motion: none of its own.** Manifest 1.12.1 `motion.none`: „no motion of its own — focus swaps the border colour at once (focus is never animated) and the field has no hover state“. It lists `inherits: [text-field]`, but the Text Field motion is the floating-label cross-fade, and a NumberField label always floats (see Label), so it never plays here. **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. The steppers lost their raw `transition-colors duration-150` too, so the at-bound switch to `--disabled-foreground` is instant.
117
+
118
+ **At-bound (min/max) is independent of `State`.** Hitting `min`/`max` recolours only the relevant stepper to `--disabled-foreground` — it does not change the border, does not set `State=Disabled`, and does not disable the other stepper or the input.
119
+
120
+ ### Label
121
+
122
+ Value states only — a NumberField **always carries a value**, so the label always floats (there is no
123
+ empty / label-resting cell). Disabled keeps the shell border, so its label shows the same notch as every other state — a `--border-width-100` strip in the surface colour under the field (default `--bg-primary`) on the border line, not a backplate.
124
+
125
+ <Canvas of={NumberFieldStories.WithLabel} />
126
+
127
+ ## API
128
+
129
+ <Controls />
130
+
131
+ `decrementLabel` and `incrementLabel` are **required** — see Accessibility for why they carry no
132
+ default. Wire them to the app's translation layer: `decrementLabel={t('common.decrease')}`.
133
+
134
+ ## Do / Don't
135
+
136
+ - ✅ Use NumberField for a value the user might **increment by one** as often as type (Počet).
137
+ - ✅ Set `min`/`max` whenever a count has a real floor/ceiling (Počet ≥ 1) and let the at-bound stepper grey out on its own.
138
+ - ✅ Reach for [UnitField](?path=/docs/design-system-atoms-unitfield--docs) the moment the value needs a unit (Kč, %).
139
+ - ✅ Always pair `state="error"` with a matching `error` message on the wrapping `Field` — the border colour is the ONLY other cue.
140
+ - ✅ Keep the stepper hit-area at its built-in size (32×32, both sizes).
141
+ - ❌ Don't use it for a large free-typed amount — the stepper becomes noise past small counts.
142
+ - ❌ Don't leave `min`/`max` unset "to be safe" — an unbounded stepper lets the user step to a nonsense value (0 items, a negative count) with no warning until submit.
143
+ - ❌ Don't bolt a suffix onto NumberField — it has no trailing slot free for one.
144
+ - ❌ Don't ship Error without a message; colour alone fails WCAG 1.4.1 here more than on TextField.
145
+ - ❌ Don't shrink the hit-area to match the visible glyph — that reintroduces the touch-target problem the component exists to fix.
146
+
147
+ ## Accessibility
148
+
149
+ - **Semantics** — `<input type="number">` (with `precision` above 0 an `<input type="text" inputmode="decimal" role="spinbutton">` carrying `aria-valuenow` / `aria-valuemin` / `aria-valuemax`, because a native number input rejects a decimal comma) plus two real `<button type="button">` steppers, each with an explicit `aria-label` taken from the **required** `decrementLabel` / `incrementLabel` props — never icon-only with no name, and never a built-in Czech default: the design system is locale-agnostic and a name only a screen reader hears is the one that ships untranslated.
150
+ - **Keyboard** — standard numeric entry; `ArrowUp` / `ArrowDown` step the value by `step`, clamped to `min`/`max`, in both input modes — the decimal text input implements this itself and keeps `aria-valuenow` in sync; the steppers are independently tab-reachable and activate on `Enter`/`Space`, like any button. `disabled` drops the input AND both stepper buttons from the tab order.
151
+ - **Target** — each stepper's hit area is 32×32 in both sizes. That clears WCAG 2.5.8 (AA, 24×24) with margin without the consumer adding padding; it does **not** meet 2.5.5 (AAA, 44×44) — an accepted signature shared with Icon Button S and the Modal close.
152
+ - **ARIA** — Error sets `aria-invalid="true"` + `aria-describedby` at the helper/error id — the **only** non-colour cue (no status icon here, unlike TextField/UnitField), so the message text carries the full signal.
153
+ - **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), so the only in-shell error cue survives focus; each stepper button gets its own standard focus indicator when tabbed to directly.
154
+
155
+ Accessibility floor for every FODS component: `spec/01-foundations/accessibility.md`.
156
+
157
+ ## Copy
158
+
159
+ Voice: the same as [TextField](?path=/docs/design-system-atoms-textfield--docs) — impersonal and neutral, clear over clever, concise, specific (an error says what is wrong and how to fix it), one word per concept. NumberField adds no copy surface of its own beyond the two stepper names.
160
+
161
+ - **Label** (`label` on the wrapping `Field`) — a noun phrase naming the count, 1–3 words, e.g. *Počet*. Single line, truncates, max 24 characters.
162
+ - **Value** — the editable number itself, centered. Single line, scrolls; no component max length. With `precision` above 0 it may carry decimals: typing accepts a comma or a dot, and the committed value shows the locale's decimal separator (*1,5* in `cs`).
163
+ - **Helper** (`helperText` on the wrapping `Field`) — wraps, never truncated, max 120 characters.
164
+ - **Error** (`error` on the wrapping `Field`) — problem + fix, impersonal. Wraps and must be fully visible (WCAG 3.3.1); replaces the helper. Max 140 characters.
165
+ - **Stepper names** (`decrementLabel` / `incrementLabel`) — a verb with an implicit object, impersonal; never the bare glyph.
166
+
167
+ <table>
168
+ <thead>
169
+ <tr><th>Run</th><th>Write</th><th>✅</th><th>❌</th></tr>
170
+ </thead>
171
+ <tbody>
172
+ <tr><td>Label</td><td>noun phrase naming the count</td><td><code>Počet</code></td><td><code>Zadejte počet:</code></td></tr>
173
+ <tr><td>Stepper name</td><td>verb + implicit object, impersonal</td><td><code>Přidat</code> / <code>Odebrat</code></td><td><code>+</code> / <code>-</code> (icon-only, no name)</td></tr>
174
+ <tr><td>Error</td><td>problem + fix, same pattern as TextField</td><td><code>Počet musí být alespoň 1</code></td><td><code>Neplatná hodnota</code></td></tr>
175
+ </tbody>
176
+ </table>
177
+
178
+ ## Usage
179
+
180
+ ```tsx
181
+ import { Field, NumberField } from '@invoiceonline/ui-react';
182
+
183
+ // Bounded item-row quantity — the reference case
184
+ <Field label="Počet">
185
+ <NumberField id="pocet" defaultValue={1} min={1} max={99} />
186
+ </Field>
187
+
188
+ // Error state — the message is the only non-colour cue
189
+ <Field label="Počet" error="Počet musí být alespoň 1">
190
+ <NumberField id="pocet-err" state="error" defaultValue={0} min={1} />
191
+ </Field>
192
+
193
+ // Coarser count in a dense row
194
+ <Field label="Počet balení">
195
+ <NumberField id="baleni" size="sm" defaultValue={0} step={5} min={0} />
196
+ </Field>
197
+ ```
198
+
199
+ ```tsx
200
+ // Don't — no message on Error; border colour alone fails WCAG 1.4.1 here
201
+ <NumberField state="error" defaultValue={0} min={1} />
202
+
203
+ // Don't — a value with a unit belongs in UnitField, not NumberField
204
+ <NumberField defaultValue={1000} aria-label="Cena" /> // → UnitField unit="Kč"
205
+ ```
206
+
207
+ <Canvas of={NumberFieldStories.WithField} />
208
+
209
+ ## Related
210
+
211
+ - [`UnitField`](?path=/docs/design-system-atoms-unitfield--docs) — an amount with a unit (Kč, %)
212
+ - [`TextField`](?path=/docs/design-system-atoms-textfield--docs) — the sibling for free numeric/text entry
213
+ - [`Field`](?path=/docs/design-system-atoms-field--docs) — the wrapper for floating label + helper/error text
214
+ - [`Select`](?path=/docs/design-system-organisms-select--docs) — for choosing from a fixed set
215
+ - Spec: `spec/03-atoms/number-field.md`
216
+
217
+ ## Migration notes
218
+
219
+ - **Motion (manifest 1.12.1, 2026-11-03) — documentation only.** The field is declared static (`motion.none`). No code change; the shell's and the steppers' raw colour transitions are an open discrepancy against it (see States).
220
+ - **`precision` (manifest 1.12.0)** — formerly the package deviation `number-field-precision`, now a manifest prop. The committed value switched from a dot («1.5») to the locale decimal separator («1,5»); pass `locale` where the site is not Czech.
221
+ - **`min`/`max`/`step`** — the first explicit constraint model in FODS field components; code-level props, not new Figma variants (see Constraints).
222
+ - **Shell inherited from TextField** — any future TextField shell change (border, radius, focus treatment) should be verified against NumberField too, since both share the same underlying frame.
223
+ - **⚠️ Spec ↔ code note:** the upstream spec (v1.2.0) documents a `Show label` boolean variant axis; in the FODS code the label is composed externally via [`Field`](?path=/docs/design-system-atoms-field--docs) (same pattern as UnitField), so NumberField itself has no `Show label` prop — the visible/hidden-label decision lives on the wrapper, not the field. Flag for the designer to confirm the intent.
@@ -0,0 +1,291 @@
1
+ import type { Meta, StoryObj } from '@storybook/react-vite';
2
+ import type { ReactNode } from 'react';
3
+ import { useState } from 'react';
4
+ import { NumberField } from './NumberField';
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'] as const;
12
+
13
+ // The steppers are icon-only, so their accessible names are required props —
14
+ // the design system is locale-agnostic and the consumer supplies the wording.
15
+ const STEPPER = { decrementLabel: 'Snížit', incrementLabel: 'Zvýšit' } as const;
16
+
17
+ // NumberField is w-full — pin a realistic quantity width for showcase stories
18
+ // (spec maxWidth guidance is 160 px; the hard floor is 80 px, the shared field-family minimum).
19
+ const Frame = ({ children }: { children: ReactNode }) => (
20
+ <div className="w-[calc(var(--space-1000)*4)]">{children}</div>
21
+ );
22
+
23
+ const meta = {
24
+ title: 'Design System/Atoms/NumberField',
25
+ component: NumberField,
26
+ parameters: {
27
+ layout: 'centered',
28
+ containerWidth: 160,
29
+ docs: {
30
+ description: {
31
+ component: componentDoc({
32
+ summary:
33
+ 'A TextField shell with a − / + stepper flanking a centered numeric value, for small, boundable counts like item-row Počet. The stepper is the differentiator: if ± does not make sense for the value, it is not a NumberField. For a floating label, error or helper text, wrap it in `Field`.',
34
+ useCases: [
35
+ 'Item-row quantity (Počet) — the reference case',
36
+ '`min={1}` — a count with a real floor; the decrement stepper greys out at the bound',
37
+ '`size="sm"` — dense line-item rows and inline editors',
38
+ '`step={5}` — coarser whole-number counts',
39
+ '`precision={4}` — a decimal quantity (1,5 hod); the stepper still moves by `step`',
40
+ ],
41
+ bestPractices: [
42
+ 'Set `min` / `max` whenever a count has a real floor or ceiling — let the at-bound stepper grey out on its own',
43
+ 'For a value with a unit (Kč, %) reach for `UnitField`; for free numeric entry with no natural step use `TextField type=numeric`',
44
+ 'Always pair `state="error"` with a matching `error` message on the `Field` — the border colour is the ONLY other cue (no status icon)',
45
+ 'For a floating label wrap in `Field` — the label always floats (a NumberField always carries a value)',
46
+ ],
47
+ knownIssues: [
48
+ 'No leading/trailing icon slot and no Error/Success status icon — both edges are permanently the stepper, so validation rides on border colour + the required helper/error text',
49
+ ],
50
+ docsLink: { label: 'spec/03-atoms/number-field.md' },
51
+ }),
52
+ },
53
+ },
54
+ },
55
+ // The stepper names are required props, so the showcase stories — which render
56
+ // their own markup and pass no args — inherit them here.
57
+ args: STEPPER,
58
+ } satisfies Meta<typeof NumberField>;
59
+
60
+ export default meta;
61
+ type Story = StoryObj<typeof meta>;
62
+
63
+ export const Playground: Story = {
64
+ args: {
65
+ defaultValue: 1,
66
+ size: 'md',
67
+ state: 'default',
68
+ step: 1,
69
+ },
70
+ argTypes: {
71
+ size: { control: 'select', options: SIZES },
72
+ state: { control: 'select', options: STATES },
73
+ min: { control: 'number' },
74
+ max: { control: 'number' },
75
+ step: { control: 'number' },
76
+ precision: { control: 'number' },
77
+ },
78
+ /*
79
+ * Wrapped in `Field`, which is how the component actually ships. The bare
80
+ * `aria-label` already named the input, but the Error state set `aria-invalid`
81
+ * with nothing for `aria-describedby` to resolve to, so the message was never
82
+ * announced (WCAG 3.3.1). The helper line Field renders is that target, and the
83
+ * error text is tied to the `state` arg so it appears exactly when
84
+ * `aria-invalid` does.
85
+ */
86
+ render: args => (
87
+ <Frame>
88
+ <Field
89
+ label="Počet"
90
+ error={args.state === 'error' ? 'Zadejte alespoň jeden kus.' : undefined}
91
+ success={args.state === 'success' ? 'Počet je v pořádku.' : undefined}
92
+ helperText={
93
+ args.state === 'error' || args.state === 'success' ? undefined : 'Celé kusy.'
94
+ }
95
+ >
96
+ <NumberField id="playground-number-field" {...STEPPER} {...args} />
97
+ </Field>
98
+ </Frame>
99
+ ),
100
+ };
101
+
102
+ export const Matrix: Story = {
103
+ parameters: {
104
+ docs: {
105
+ description: {
106
+ story:
107
+ 'Full state × size matrix — mirrors the Figma labelled grid. Rows = states, columns = sizes. Error/Success are border-colour only (no status icon); Disabled drops the border and greys both steppers.',
108
+ },
109
+ },
110
+ },
111
+ render: () => (
112
+ <Showcase>
113
+ {STATES.map(state => (
114
+ <Section key={state} title={state} layout="row">
115
+ {SIZES.map(size => (
116
+ <div key={size} className="w-[calc(var(--space-1000)*4)]">
117
+ <NumberField {...STEPPER} state={state} size={size} defaultValue={1} aria-label="Počet" />
118
+ </div>
119
+ ))}
120
+ </Section>
121
+ ))}
122
+ </Showcase>
123
+ ),
124
+ };
125
+
126
+ export const Sizes: Story = {
127
+ parameters: {
128
+ docs: { description: { story: 'Medium — standalone quantity fields · Small — dense rows. Pick by density, matching the row height it lives in.' } },
129
+ },
130
+ render: () => (
131
+ <Showcase>
132
+ <Section title="Medium (default)" layout="column">
133
+ <Frame><NumberField {...STEPPER} size="md" defaultValue={1} aria-label="Počet" /></Frame>
134
+ </Section>
135
+ <Section title="Small" layout="column">
136
+ <Frame><NumberField {...STEPPER} size="sm" defaultValue={1} aria-label="Počet" /></Frame>
137
+ </Section>
138
+ </Showcase>
139
+ ),
140
+ };
141
+
142
+ export const States: Story = {
143
+ parameters: {
144
+ docs: { description: { story: 'All five visual states. Error / Success are communicated by border colour alone — always pair them with a message on the wrapping `Field`. 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).' } },
145
+ },
146
+ render: () => (
147
+ <Showcase>
148
+ <FieldErrorFocusStyles />
149
+ <Section title="Editable" layout="column">
150
+ <Frame><NumberField {...STEPPER} state="default" defaultValue={1} aria-label="Počet" /></Frame>
151
+ <Frame><NumberField {...STEPPER} state="focused" defaultValue={1} aria-label="Počet" /></Frame>
152
+ <Frame><NumberField {...STEPPER} state="error" defaultValue={1} aria-label="Počet" /></Frame>
153
+ <Frame><NumberField {...STEPPER} state="success" defaultValue={1} aria-label="Počet" /></Frame>
154
+ </Section>
155
+ <Section title="Error + focus" layout="column">
156
+ <Frame>
157
+ <div className={FORCE_ERROR_FOCUS}>
158
+ <NumberField {...STEPPER} state="error" defaultValue={1} aria-label="Počet" />
159
+ </div>
160
+ </Frame>
161
+ </Section>
162
+ <Section title="Non-editable" layout="column">
163
+ <Frame><NumberField {...STEPPER} state="disabled" defaultValue={1} aria-label="Počet" /></Frame>
164
+ </Section>
165
+ </Showcase>
166
+ ),
167
+ };
168
+
169
+ export const Constraints: Story = {
170
+ parameters: {
171
+ docs: {
172
+ description: {
173
+ story:
174
+ 'min / max / step are code-level constraints, not State variants. At a bound only the relevant stepper greys out (`--disabled-foreground`) and stops responding — the field, the other stepper, and the input stay live. A typed out-of-range value clamps on blur, not per keystroke.',
175
+ },
176
+ },
177
+ },
178
+ render: () => {
179
+ const AtMin = () => {
180
+ const [value, setValue] = useState(1);
181
+ return (
182
+ <Frame>
183
+ <NumberField {...STEPPER} value={value} min={1} max={99} onValueChange={setValue} aria-label="Počet" />
184
+ </Frame>
185
+ );
186
+ };
187
+ return (
188
+ <Showcase>
189
+ <Section title="min=1 (decrement greyed at the floor)" layout="column">
190
+ <AtMin />
191
+ </Section>
192
+ <Section title="step=5 (coarser count)" layout="column">
193
+ <Frame><NumberField {...STEPPER} defaultValue={0} step={5} min={0} aria-label="Počet" /></Frame>
194
+ </Section>
195
+ </Showcase>
196
+ );
197
+ },
198
+ };
199
+
200
+ export const DecimalQuantity: Story = {
201
+ name: 'Desetinný počet',
202
+ parameters: {
203
+ docs: {
204
+ description: {
205
+ story:
206
+ '`precision={4}` keeps up to four decimals on commit — an item quantity (1,5 hod). The input accepts a decimal comma or dot; the steppers still move by the whole `step`, so 1,5 + 1 = 2,5. The committed value shows the locale decimal separator (`cs` → 1,5, never 1.5).',
207
+ },
208
+ },
209
+ },
210
+ render: () => {
211
+ const Decimal = () => {
212
+ const [value, setValue] = useState(1.5);
213
+ return (
214
+ <Frame>
215
+ <Field label="Počet">
216
+ <NumberField {...STEPPER} id="pocet-decimal" value={value} min={1} step={1} precision={4} onValueChange={setValue} />
217
+ </Field>
218
+ </Frame>
219
+ );
220
+ };
221
+ return (
222
+ <Showcase>
223
+ <Section title="precision=4, step=1" layout="column">
224
+ <Decimal />
225
+ </Section>
226
+ </Showcase>
227
+ );
228
+ },
229
+ };
230
+
231
+ export const WithField: Story = {
232
+ parameters: {
233
+ docs: {
234
+ description: {
235
+ story:
236
+ 'Real usage — wrapped in `Field` for the floating label, helper and error messaging. The label always floats because a NumberField always carries a value.',
237
+ },
238
+ },
239
+ },
240
+ render: () => (
241
+ <Showcase>
242
+ <Section title="Standalone quantity" layout="column">
243
+ <Frame>
244
+ <Field label="Počet">
245
+ <NumberField {...STEPPER} id="pocet" defaultValue={1} min={1} />
246
+ </Field>
247
+ </Frame>
248
+ <Frame>
249
+ <Field label="Počet" error="Počet musí být alespoň 1">
250
+ <NumberField {...STEPPER} id="pocet-err" state="error" defaultValue={0} min={1} />
251
+ </Field>
252
+ </Frame>
253
+ </Section>
254
+ </Showcase>
255
+ ),
256
+ };
257
+
258
+ export const WithLabel: Story = {
259
+ parameters: {
260
+ docs: {
261
+ description: {
262
+ story:
263
+ 'The floating label — value states only. A NumberField **always carries a value**, so the label always floats (there is no empty / label-resting cell). Disabled keeps the border, so its label shows the same 1px surface-colour notch strip as every other state.',
264
+ },
265
+ },
266
+ },
267
+ render: () => (
268
+ <Showcase>
269
+ <Section title="S hodnotou (label nahoře)" layout="column">
270
+ <Frame>
271
+ <Field label="Počet"><NumberField {...STEPPER} id="nl-val" defaultValue={1} min={1} /></Field>
272
+ </Frame>
273
+ <Frame>
274
+ <Field label="Počet"><NumberField {...STEPPER} id="nl-val-dis" state="disabled" defaultValue={1} min={1} /></Field>
275
+ </Frame>
276
+ </Section>
277
+ <Section title="Stavy (error / success)" layout="column">
278
+ <Frame>
279
+ <Field label="Počet" error="Počet musí být alespoň 1">
280
+ <NumberField {...STEPPER} id="nl-err" state="error" defaultValue={0} min={1} />
281
+ </Field>
282
+ </Frame>
283
+ <Frame>
284
+ <Field label="Počet" success="Hodnota je v pořádku">
285
+ <NumberField {...STEPPER} id="nl-ok" state="success" defaultValue={3} min={1} />
286
+ </Field>
287
+ </Frame>
288
+ </Section>
289
+ </Showcase>
290
+ ),
291
+ };