@invoiceonline/ui-react 0.0.0 → 0.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (731) hide show
  1. package/AGENTS.md +100 -0
  2. package/CHANGELOG.md +149 -0
  3. package/LICENSE +9 -0
  4. package/README.md +77 -1
  5. package/dist/assets/label-brush-1.svg +6 -0
  6. package/dist/assets/pattern-dark.svg +113 -0
  7. package/dist/components/action-row/ActionRow.d.ts +178 -0
  8. package/dist/components/action-row/ActionRow.js +340 -0
  9. package/dist/components/action-row/index.d.ts +2 -0
  10. package/dist/components/action-row/index.js +1 -0
  11. package/dist/components/alert/Alert.d.ts +314 -0
  12. package/dist/components/alert/Alert.js +446 -0
  13. package/dist/components/alert/index.d.ts +2 -0
  14. package/dist/components/alert/index.js +1 -0
  15. package/dist/components/anchored-panel/AnchoredPanel.d.ts +41 -0
  16. package/dist/components/anchored-panel/AnchoredPanel.js +72 -0
  17. package/dist/components/anchored-panel/index.d.ts +3 -0
  18. package/dist/components/anchored-panel/index.js +3 -0
  19. package/dist/components/badge/Badge.d.ts +146 -0
  20. package/dist/components/badge/Badge.js +258 -0
  21. package/dist/components/badge/index.d.ts +2 -0
  22. package/dist/components/badge/index.js +1 -0
  23. package/dist/components/banner/Banner.d.ts +209 -0
  24. package/dist/components/banner/Banner.js +339 -0
  25. package/dist/components/banner/index.d.ts +2 -0
  26. package/dist/components/banner/index.js +1 -0
  27. package/dist/components/button/Button.d.ts +54 -0
  28. package/dist/components/button/Button.js +312 -0
  29. package/dist/components/button/index.d.ts +2 -0
  30. package/dist/components/button/index.js +1 -0
  31. package/dist/components/button-group/ButtonGroup.d.ts +187 -0
  32. package/dist/components/button-group/ButtonGroup.js +217 -0
  33. package/dist/components/button-group/index.d.ts +2 -0
  34. package/dist/components/button-group/index.js +1 -0
  35. package/dist/components/card-select/CardSelect.d.ts +274 -0
  36. package/dist/components/card-select/CardSelect.js +561 -0
  37. package/dist/components/card-select/CardSelectGroup.d.ts +92 -0
  38. package/dist/components/card-select/CardSelectGroup.js +72 -0
  39. package/dist/components/card-select/index.d.ts +3 -0
  40. package/dist/components/card-select/index.js +3 -0
  41. package/dist/components/checkbox/Checkbox.d.ts +104 -0
  42. package/dist/components/checkbox/Checkbox.js +194 -0
  43. package/dist/components/checkbox/index.d.ts +2 -0
  44. package/dist/components/checkbox/index.js +1 -0
  45. package/dist/components/chip/Chip.d.ts +250 -0
  46. package/dist/components/chip/Chip.js +441 -0
  47. package/dist/components/chip/index.d.ts +2 -0
  48. package/dist/components/chip/index.js +1 -0
  49. package/dist/components/column-header/ColumnHeader.d.ts +144 -0
  50. package/dist/components/column-header/ColumnHeader.js +209 -0
  51. package/dist/components/column-header/index.d.ts +2 -0
  52. package/dist/components/column-header/index.js +1 -0
  53. package/dist/components/combobox-field/Combobox.d.ts +104 -0
  54. package/dist/components/combobox-field/Combobox.js +355 -0
  55. package/dist/components/combobox-field/ComboboxField.d.ts +76 -0
  56. package/dist/components/combobox-field/ComboboxField.js +98 -0
  57. package/dist/components/combobox-field/index.d.ts +3 -0
  58. package/dist/components/combobox-field/index.js +3 -0
  59. package/dist/components/date-picker/DatePicker.d.ts +53 -0
  60. package/dist/components/date-picker/DatePicker.js +329 -0
  61. package/dist/components/date-picker/index.d.ts +2 -0
  62. package/dist/components/date-picker/index.js +1 -0
  63. package/dist/components/divider/Divider.d.ts +81 -0
  64. package/dist/components/divider/Divider.js +93 -0
  65. package/dist/components/divider/index.d.ts +2 -0
  66. package/dist/components/divider/index.js +1 -0
  67. package/dist/components/drawer/Drawer.d.ts +128 -0
  68. package/dist/components/drawer/Drawer.js +367 -0
  69. package/dist/components/drawer/index.d.ts +2 -0
  70. package/dist/components/drawer/index.js +1 -0
  71. package/dist/components/dropdown-button/DropdownButton.d.ts +72 -0
  72. package/dist/components/dropdown-button/DropdownButton.js +122 -0
  73. package/dist/components/dropdown-button/index.d.ts +2 -0
  74. package/dist/components/dropdown-button/index.js +1 -0
  75. package/dist/components/faq/FAQ.d.ts +135 -0
  76. package/dist/components/faq/FAQ.js +258 -0
  77. package/dist/components/faq/index.d.ts +2 -0
  78. package/dist/components/faq/index.js +1 -0
  79. package/dist/components/field/Field.d.ts +119 -0
  80. package/dist/components/field/Field.js +332 -0
  81. package/dist/components/field/index.d.ts +2 -0
  82. package/dist/components/field/index.js +1 -0
  83. package/dist/components/field-pair/FieldPair.d.ts +210 -0
  84. package/dist/components/field-pair/FieldPair.js +335 -0
  85. package/dist/components/field-pair/index.d.ts +2 -0
  86. package/dist/components/field-pair/index.js +1 -0
  87. package/dist/components/file-upload/FileUpload.d.ts +137 -0
  88. package/dist/components/file-upload/FileUpload.js +434 -0
  89. package/dist/components/file-upload/index.d.ts +2 -0
  90. package/dist/components/file-upload/index.js +1 -0
  91. package/dist/components/filter-chip/FilterChip.d.ts +373 -0
  92. package/dist/components/filter-chip/FilterChip.js +517 -0
  93. package/dist/components/filter-chip/index.d.ts +2 -0
  94. package/dist/components/filter-chip/index.js +1 -0
  95. package/dist/components/filter-facet/FilterFacet.d.ts +116 -0
  96. package/dist/components/filter-facet/FilterFacet.js +632 -0
  97. package/dist/components/filter-facet/index.d.ts +2 -0
  98. package/dist/components/filter-facet/index.js +1 -0
  99. package/dist/components/firm-avatar/FirmAvatar.d.ts +75 -0
  100. package/dist/components/firm-avatar/FirmAvatar.js +119 -0
  101. package/dist/components/firm-avatar/index.d.ts +2 -0
  102. package/dist/components/firm-avatar/index.js +1 -0
  103. package/dist/components/form-actions/FormActions.d.ts +123 -0
  104. package/dist/components/form-actions/FormActions.js +195 -0
  105. package/dist/components/form-actions/index.d.ts +2 -0
  106. package/dist/components/form-actions/index.js +1 -0
  107. package/dist/components/form-block/FormBlock.d.ts +252 -0
  108. package/dist/components/form-block/FormBlock.js +420 -0
  109. package/dist/components/form-block/index.d.ts +3 -0
  110. package/dist/components/form-block/index.js +3 -0
  111. package/dist/components/form-section/FormSection.d.ts +130 -0
  112. package/dist/components/form-section/FormSection.js +206 -0
  113. package/dist/components/form-section/index.d.ts +2 -0
  114. package/dist/components/form-section/index.js +1 -0
  115. package/dist/components/heading/Heading.d.ts +69 -0
  116. package/dist/components/heading/Heading.js +79 -0
  117. package/dist/components/heading/index.d.ts +2 -0
  118. package/dist/components/heading/index.js +1 -0
  119. package/dist/components/heading-group/HeadingGroup.d.ts +258 -0
  120. package/dist/components/heading-group/HeadingGroup.js +255 -0
  121. package/dist/components/heading-group/index.d.ts +2 -0
  122. package/dist/components/heading-group/index.js +1 -0
  123. package/dist/components/hero/Hero.d.ts +268 -0
  124. package/dist/components/hero/Hero.js +316 -0
  125. package/dist/components/hero/index.d.ts +2 -0
  126. package/dist/components/hero/index.js +1 -0
  127. package/dist/components/icon/Icon.d.ts +27 -0
  128. package/dist/components/icon/Icon.js +30 -0
  129. package/dist/components/icon/index.d.ts +3 -0
  130. package/dist/components/icon/index.js +3 -0
  131. package/dist/components/icon-button/IconButton.d.ts +75 -0
  132. package/dist/components/icon-button/IconButton.js +151 -0
  133. package/dist/components/icon-button/index.d.ts +2 -0
  134. package/dist/components/icon-button/index.js +1 -0
  135. package/dist/components/item-row/ItemRow.d.ts +253 -0
  136. package/dist/components/item-row/ItemRow.js +496 -0
  137. package/dist/components/item-row/index.d.ts +2 -0
  138. package/dist/components/item-row/index.js +1 -0
  139. package/dist/components/list-row/ListRow.d.ts +165 -0
  140. package/dist/components/list-row/ListRow.js +233 -0
  141. package/dist/components/list-row/index.d.ts +2 -0
  142. package/dist/components/list-row/index.js +1 -0
  143. package/dist/components/menu/Menu.d.ts +64 -0
  144. package/dist/components/menu/Menu.js +186 -0
  145. package/dist/components/menu/index.d.ts +2 -0
  146. package/dist/components/menu/index.js +1 -0
  147. package/dist/components/modal/Modal.d.ts +272 -0
  148. package/dist/components/modal/Modal.js +788 -0
  149. package/dist/components/modal/index.d.ts +2 -0
  150. package/dist/components/modal/index.js +1 -0
  151. package/dist/components/nav-link/NavLink.d.ts +123 -0
  152. package/dist/components/nav-link/NavLink.js +157 -0
  153. package/dist/components/nav-link/index.d.ts +2 -0
  154. package/dist/components/nav-link/index.js +1 -0
  155. package/dist/components/number-field/NumberField.d.ts +62 -0
  156. package/dist/components/number-field/NumberField.js +210 -0
  157. package/dist/components/number-field/index.d.ts +2 -0
  158. package/dist/components/number-field/index.js +1 -0
  159. package/dist/components/pagination/Pagination.d.ts +133 -0
  160. package/dist/components/pagination/Pagination.js +217 -0
  161. package/dist/components/pagination/index.d.ts +3 -0
  162. package/dist/components/pagination/index.js +3 -0
  163. package/dist/components/popover-surface/index.d.ts +2 -0
  164. package/dist/components/popover-surface/index.js +1 -0
  165. package/dist/components/progress-bar/ProgressBar.d.ts +260 -0
  166. package/dist/components/progress-bar/ProgressBar.js +470 -0
  167. package/dist/components/progress-bar/index.d.ts +2 -0
  168. package/dist/components/progress-bar/index.js +1 -0
  169. package/dist/components/promo-sticker/PromoSticker.d.ts +204 -0
  170. package/dist/components/promo-sticker/PromoSticker.js +177 -0
  171. package/dist/components/promo-sticker/index.d.ts +2 -0
  172. package/dist/components/promo-sticker/index.js +1 -0
  173. package/dist/components/promo-surface/PromoSurface.d.ts +94 -0
  174. package/dist/components/promo-surface/PromoSurface.js +119 -0
  175. package/dist/components/promo-surface/index.d.ts +2 -0
  176. package/dist/components/promo-surface/index.js +1 -0
  177. package/dist/components/radio/Radio.d.ts +92 -0
  178. package/dist/components/radio/Radio.js +171 -0
  179. package/dist/components/radio/index.d.ts +2 -0
  180. package/dist/components/radio/index.js +1 -0
  181. package/dist/components/radio-group/RadioGroup.d.ts +61 -0
  182. package/dist/components/radio-group/RadioGroup.js +51 -0
  183. package/dist/components/radio-group/index.d.ts +2 -0
  184. package/dist/components/radio-group/index.js +1 -0
  185. package/dist/components/select/Select.d.ts +65 -0
  186. package/dist/components/select/Select.js +176 -0
  187. package/dist/components/select/index.d.ts +2 -0
  188. package/dist/components/select/index.js +1 -0
  189. package/dist/components/select-field/SelectField.d.ts +16 -0
  190. package/dist/components/select-field/SelectField.js +55 -0
  191. package/dist/components/select-field/index.d.ts +2 -0
  192. package/dist/components/select-field/index.js +1 -0
  193. package/dist/components/skeleton/Skeleton.d.ts +64 -0
  194. package/dist/components/skeleton/Skeleton.js +65 -0
  195. package/dist/components/skeleton/index.d.ts +2 -0
  196. package/dist/components/skeleton/index.js +1 -0
  197. package/dist/components/split-button/SplitButton.d.ts +80 -0
  198. package/dist/components/split-button/SplitButton.js +182 -0
  199. package/dist/components/split-button/index.d.ts +2 -0
  200. package/dist/components/split-button/index.js +1 -0
  201. package/dist/components/status-summary-bar/StatusSummaryBar.d.ts +118 -0
  202. package/dist/components/status-summary-bar/StatusSummaryBar.js +278 -0
  203. package/dist/components/status-summary-bar/index.d.ts +2 -0
  204. package/dist/components/status-summary-bar/index.js +1 -0
  205. package/dist/components/subject-lookup-field/SubjectLookupField.d.ts +157 -0
  206. package/dist/components/subject-lookup-field/SubjectLookupField.js +663 -0
  207. package/dist/components/subject-lookup-field/index.d.ts +2 -0
  208. package/dist/components/subject-lookup-field/index.js +1 -0
  209. package/dist/components/switch/Switch.d.ts +152 -0
  210. package/dist/components/switch/Switch.js +307 -0
  211. package/dist/components/switch/index.d.ts +2 -0
  212. package/dist/components/switch/index.js +1 -0
  213. package/dist/components/table/Table.d.ts +5 -0
  214. package/dist/components/table/Table.js +601 -0
  215. package/dist/components/table/index.d.ts +6 -0
  216. package/dist/components/table/index.js +6 -0
  217. package/dist/components/text-field/TextField.d.ts +160 -0
  218. package/dist/components/text-field/TextField.js +244 -0
  219. package/dist/components/text-field/index.d.ts +2 -0
  220. package/dist/components/text-field/index.js +1 -0
  221. package/dist/components/text-link/TextLink.d.ts +260 -0
  222. package/dist/components/text-link/TextLink.js +303 -0
  223. package/dist/components/text-link/index.d.ts +2 -0
  224. package/dist/components/text-link/index.js +1 -0
  225. package/dist/components/textarea/Textarea.d.ts +93 -0
  226. package/dist/components/textarea/Textarea.js +256 -0
  227. package/dist/components/textarea/index.d.ts +2 -0
  228. package/dist/components/textarea/index.js +1 -0
  229. package/dist/components/tooltip/Tooltip.d.ts +129 -0
  230. package/dist/components/tooltip/Tooltip.js +457 -0
  231. package/dist/components/tooltip/index.d.ts +2 -0
  232. package/dist/components/tooltip/index.js +1 -0
  233. package/dist/components/unit-field/UnitField.d.ts +46 -0
  234. package/dist/components/unit-field/UnitField.js +133 -0
  235. package/dist/components/unit-field/index.d.ts +2 -0
  236. package/dist/components/unit-field/index.js +1 -0
  237. package/dist/icons/icon-registry.generated.js +500 -0
  238. package/dist/icons/icon-types.generated.d.ts +2 -0
  239. package/dist/icons/icon-types.generated.js +126 -0
  240. package/dist/index.d.ts +130 -0
  241. package/dist/index.js +74 -0
  242. package/dist/internal/BottomSheet.js +496 -0
  243. package/dist/internal/FodsProvider.d.ts +25 -0
  244. package/dist/internal/FodsProvider.js +32 -0
  245. package/dist/internal/MotionCaret.js +35 -0
  246. package/dist/internal/NumberFormatInput.d.ts +21 -0
  247. package/dist/internal/NumberFormatInput.js +126 -0
  248. package/dist/internal/SummaryDonut.d.ts +3 -0
  249. package/dist/internal/SummaryDonut.js +300 -0
  250. package/dist/internal/buttonSegment.d.ts +44 -0
  251. package/dist/internal/buttonSegment.js +126 -0
  252. package/dist/internal/collapseRoom.js +128 -0
  253. package/dist/internal/comboboxKeys.js +44 -0
  254. package/dist/internal/contentPresence.js +46 -0
  255. package/dist/internal/dayCell.js +95 -0
  256. package/dist/internal/dialogPortal.d.ts +2 -0
  257. package/dist/internal/dialogPortal.js +21 -0
  258. package/dist/internal/donutSweeps.js +65 -0
  259. package/dist/internal/enterOnViewGeometry.js +46 -0
  260. package/dist/internal/faqItem.js +80 -0
  261. package/dist/internal/floatingLabelMotion.js +68 -0
  262. package/dist/internal/formBlockContext.d.ts +22 -0
  263. package/dist/internal/formBlockContext.js +20 -0
  264. package/dist/internal/heightRoom.js +87 -0
  265. package/dist/internal/numberSeparators.js +62 -0
  266. package/dist/internal/overlayMotion.js +48 -0
  267. package/dist/internal/paginationItem.d.ts +8 -0
  268. package/dist/internal/paginationItem.js +22 -0
  269. package/dist/internal/popoverSurface.d.ts +8 -0
  270. package/dist/internal/popoverSurface.js +23 -0
  271. package/dist/internal/portalContainer.d.ts +1 -0
  272. package/dist/internal/portalContainer.js +6 -0
  273. package/dist/internal/progressBarItem.d.ts +207 -0
  274. package/dist/internal/progressBarItem.js +264 -0
  275. package/dist/internal/selectionControlText.js +12 -0
  276. package/dist/internal/statusSummaryParts.js +371 -0
  277. package/dist/internal/summaryMotion.js +75 -0
  278. package/dist/internal/table/ChildConnector.js +62 -0
  279. package/dist/internal/table/ChildRowPrefix.d.ts +9 -0
  280. package/dist/internal/table/ChildRowPrefix.js +27 -0
  281. package/dist/internal/table/ColumnSettings.js +135 -0
  282. package/dist/internal/table/ScrollRegion.js +114 -0
  283. package/dist/internal/table/TableEmpty.js +93 -0
  284. package/dist/internal/table/TableLayout.d.ts +17 -0
  285. package/dist/internal/table/TableLayout.js +29 -0
  286. package/dist/internal/table/TableLoadStatus.js +56 -0
  287. package/dist/internal/table/TableMobile.js +488 -0
  288. package/dist/internal/table/TruncatedCell.js +33 -0
  289. package/dist/internal/table/emptyValue.js +10 -0
  290. package/dist/internal/table/features.d.ts +41 -0
  291. package/dist/internal/table/features.js +31 -0
  292. package/dist/internal/table/recipes.js +227 -0
  293. package/dist/internal/table/rowClick.js +9 -0
  294. package/dist/internal/table/types.d.ts +325 -0
  295. package/dist/internal/table/types.js +13 -0
  296. package/dist/internal/tailwind-variants.d.ts +3 -0
  297. package/dist/internal/tailwind-variants.js +37 -0
  298. package/dist/internal/tooltipContext.js +5 -0
  299. package/dist/internal/tw-merge-config.generated.js +314 -0
  300. package/dist/internal/useAnchoredPanel.d.ts +87 -0
  301. package/dist/internal/useAnchoredPanel.js +108 -0
  302. package/dist/internal/useCountUp.js +53 -0
  303. package/dist/internal/useDateFieldTrigger.d.ts +60 -0
  304. package/dist/internal/useDateFieldTrigger.js +235 -0
  305. package/dist/internal/useEChart.js +59 -0
  306. package/dist/internal/useEnterOnView.js +42 -0
  307. package/dist/internal/useFloatingBar.js +100 -0
  308. package/dist/internal/useFormReset.js +44 -0
  309. package/dist/internal/useIsMobile.js +44 -0
  310. package/dist/internal/useOneRowOverflow.js +88 -0
  311. package/dist/internal/usePrefersReducedMotion.js +25 -0
  312. package/dist/internal/useReturnFocus.js +26 -0
  313. package/dist/internal/utils.d.ts +7 -0
  314. package/dist/internal/utils.js +58 -0
  315. package/dist/node_modules/@tanstack/store/dist/store.d.ts +29 -0
  316. package/dist/node_modules/@tanstack/store/dist/types.d.ts +38 -0
  317. package/dist/node_modules/@tanstack/table-core/dist/core/cells/coreCellsFeature.d.ts +6 -0
  318. package/dist/node_modules/@tanstack/table-core/dist/core/cells/coreCellsFeature.types.d.ts +53 -0
  319. package/dist/node_modules/@tanstack/table-core/dist/core/columns/coreColumnsFeature.d.ts +6 -0
  320. package/dist/node_modules/@tanstack/table-core/dist/core/columns/coreColumnsFeature.types.d.ts +90 -0
  321. package/dist/node_modules/@tanstack/table-core/dist/core/coreFeatures.d.ts +17 -0
  322. package/dist/node_modules/@tanstack/table-core/dist/core/headers/coreHeadersFeature.d.ts +6 -0
  323. package/dist/node_modules/@tanstack/table-core/dist/core/headers/coreHeadersFeature.types.d.ts +114 -0
  324. package/dist/node_modules/@tanstack/table-core/dist/core/reactivity/coreReactivityFeature.types.d.ts +51 -0
  325. package/dist/node_modules/@tanstack/table-core/dist/core/row-models/coreRowModelsFeature.d.ts +6 -0
  326. package/dist/node_modules/@tanstack/table-core/dist/core/row-models/coreRowModelsFeature.types.d.ts +29 -0
  327. package/dist/node_modules/@tanstack/table-core/dist/core/rows/coreRowsFeature.d.ts +6 -0
  328. package/dist/node_modules/@tanstack/table-core/dist/core/rows/coreRowsFeature.types.d.ts +129 -0
  329. package/dist/node_modules/@tanstack/table-core/dist/core/table/coreTablesFeature.d.ts +6 -0
  330. package/dist/node_modules/@tanstack/table-core/dist/core/table/coreTablesFeature.types.d.ts +203 -0
  331. package/dist/node_modules/@tanstack/table-core/dist/features/cell-selection/cellSelectionFeature.d.ts +6 -0
  332. package/dist/node_modules/@tanstack/table-core/dist/features/cell-selection/cellSelectionFeature.types.d.ts +294 -0
  333. package/dist/node_modules/@tanstack/table-core/dist/features/cell-spanning/cellSpanningFeature.d.ts +11 -0
  334. package/dist/node_modules/@tanstack/table-core/dist/features/cell-spanning/cellSpanningFeature.types.d.ts +148 -0
  335. package/dist/node_modules/@tanstack/table-core/dist/features/column-faceting/columnFacetingFeature.d.ts +12 -0
  336. package/dist/node_modules/@tanstack/table-core/dist/features/column-faceting/columnFacetingFeature.types.d.ts +63 -0
  337. package/dist/node_modules/@tanstack/table-core/dist/features/column-filtering/columnFilteringFeature.d.ts +6 -0
  338. package/dist/node_modules/@tanstack/table-core/dist/features/column-filtering/columnFilteringFeature.types.d.ts +209 -0
  339. package/dist/node_modules/@tanstack/table-core/dist/features/column-filtering/filterFns.d.ts +35 -0
  340. package/dist/node_modules/@tanstack/table-core/dist/features/column-grouping/columnGroupingFeature.d.ts +6 -0
  341. package/dist/node_modules/@tanstack/table-core/dist/features/column-grouping/columnGroupingFeature.types.d.ts +128 -0
  342. package/dist/node_modules/@tanstack/table-core/dist/features/column-ordering/columnOrderingFeature.d.ts +6 -0
  343. package/dist/node_modules/@tanstack/table-core/dist/features/column-ordering/columnOrderingFeature.types.d.ts +82 -0
  344. package/dist/node_modules/@tanstack/table-core/dist/features/column-pinning/columnPinningFeature.d.ts +11 -0
  345. package/dist/node_modules/@tanstack/table-core/dist/features/column-pinning/columnPinningFeature.types.d.ts +195 -0
  346. package/dist/node_modules/@tanstack/table-core/dist/features/column-resizing/columnResizingFeature.d.ts +6 -0
  347. package/dist/node_modules/@tanstack/table-core/dist/features/column-resizing/columnResizingFeature.types.d.ts +73 -0
  348. package/dist/node_modules/@tanstack/table-core/dist/features/column-sizing/columnSizingFeature.d.ts +6 -0
  349. package/dist/node_modules/@tanstack/table-core/dist/features/column-sizing/columnSizingFeature.types.d.ts +134 -0
  350. package/dist/node_modules/@tanstack/table-core/dist/features/column-visibility/columnVisibilityFeature.d.ts +6 -0
  351. package/dist/node_modules/@tanstack/table-core/dist/features/column-visibility/columnVisibilityFeature.types.d.ts +92 -0
  352. package/dist/node_modules/@tanstack/table-core/dist/features/global-filtering/globalFilteringFeature.d.ts +6 -0
  353. package/dist/node_modules/@tanstack/table-core/dist/features/global-filtering/globalFilteringFeature.types.d.ts +67 -0
  354. package/dist/node_modules/@tanstack/table-core/dist/features/row-aggregation/aggregationFns.d.ts +23 -0
  355. package/dist/node_modules/@tanstack/table-core/dist/features/row-aggregation/rowAggregationFeature.d.ts +6 -0
  356. package/dist/node_modules/@tanstack/table-core/dist/features/row-aggregation/rowAggregationFeature.types.d.ts +183 -0
  357. package/dist/node_modules/@tanstack/table-core/dist/features/row-aggregation/rowAggregationFeature.utils.d.ts +18 -0
  358. package/dist/node_modules/@tanstack/table-core/dist/features/row-expanding/rowExpandingFeature.d.ts +6 -0
  359. package/dist/node_modules/@tanstack/table-core/dist/features/row-expanding/rowExpandingFeature.types.d.ts +125 -0
  360. package/dist/node_modules/@tanstack/table-core/dist/features/row-pagination/rowPaginationFeature.d.ts +6 -0
  361. package/dist/node_modules/@tanstack/table-core/dist/features/row-pagination/rowPaginationFeature.types.d.ts +135 -0
  362. package/dist/node_modules/@tanstack/table-core/dist/features/row-pinning/rowPinningFeature.d.ts +6 -0
  363. package/dist/node_modules/@tanstack/table-core/dist/features/row-pinning/rowPinningFeature.types.d.ts +76 -0
  364. package/dist/node_modules/@tanstack/table-core/dist/features/row-selection/rowSelectionFeature.d.ts +6 -0
  365. package/dist/node_modules/@tanstack/table-core/dist/features/row-selection/rowSelectionFeature.types.d.ts +187 -0
  366. package/dist/node_modules/@tanstack/table-core/dist/features/row-sorting/rowSortingFeature.d.ts +6 -0
  367. package/dist/node_modules/@tanstack/table-core/dist/features/row-sorting/rowSortingFeature.types.d.ts +236 -0
  368. package/dist/node_modules/@tanstack/table-core/dist/features/row-sorting/sortFns.d.ts +23 -0
  369. package/dist/node_modules/@tanstack/table-core/dist/features/stockFeatures.d.ts +37 -0
  370. package/dist/node_modules/@tanstack/table-core/dist/helpers/columnHelper.d.ts +47 -0
  371. package/dist/node_modules/@tanstack/table-core/dist/types/Cell.d.ts +16 -0
  372. package/dist/node_modules/@tanstack/table-core/dist/types/Column.d.ts +30 -0
  373. package/dist/node_modules/@tanstack/table-core/dist/types/ColumnDef.d.ts +123 -0
  374. package/dist/node_modules/@tanstack/table-core/dist/types/Header.d.ts +12 -0
  375. package/dist/node_modules/@tanstack/table-core/dist/types/HeaderGroup.d.ts +6 -0
  376. package/dist/node_modules/@tanstack/table-core/dist/types/Row.d.ts +24 -0
  377. package/dist/node_modules/@tanstack/table-core/dist/types/RowModel.d.ts +19 -0
  378. package/dist/node_modules/@tanstack/table-core/dist/types/RowModelFns.d.ts +11 -0
  379. package/dist/node_modules/@tanstack/table-core/dist/types/Table.d.ts +53 -0
  380. package/dist/node_modules/@tanstack/table-core/dist/types/TableFeatures.d.ts +416 -0
  381. package/dist/node_modules/@tanstack/table-core/dist/types/TableOptions.d.ts +78 -0
  382. package/dist/node_modules/@tanstack/table-core/dist/types/TableState.d.ts +46 -0
  383. package/dist/node_modules/@tanstack/table-core/dist/types/type-utils.d.ts +25 -0
  384. package/dist/shared.css +179 -0
  385. package/dist/styles.css +5467 -0
  386. package/dist/theme.css +314 -0
  387. package/dist/theme.map.json +278 -0
  388. package/dist/tokens/index.d.ts +2 -0
  389. package/dist/tokens/index.js +1 -0
  390. package/dist/tokens/tokens.generated.d.ts +2040 -0
  391. package/dist/tokens/tokens.generated.js +2053 -0
  392. package/dist/tokens.css +484 -0
  393. package/dist/tokens.flat.json +429 -0
  394. package/docs/Consuming.mdx +396 -0
  395. package/docs/Contributing.mdx +78 -0
  396. package/docs/ForAgents.mdx +53 -0
  397. package/docs/Introduction.mdx +54 -0
  398. package/llms.txt +550 -0
  399. package/package.json +347 -3
  400. package/src/components/action-row/ActionRow.mdx +686 -0
  401. package/src/components/action-row/ActionRow.stories.tsx +669 -0
  402. package/src/components/action-row/ActionRow.tsx +632 -0
  403. package/src/components/action-row/index.ts +9 -0
  404. package/src/components/alert/Alert.mdx +377 -0
  405. package/src/components/alert/Alert.stories.tsx +674 -0
  406. package/src/components/alert/Alert.tsx +579 -0
  407. package/src/components/alert/index.ts +13 -0
  408. package/src/components/anchored-panel/AnchoredPanel.mdx +381 -0
  409. package/src/components/anchored-panel/AnchoredPanel.stories.tsx +593 -0
  410. package/src/components/anchored-panel/AnchoredPanel.tsx +176 -0
  411. package/src/components/anchored-panel/index.ts +15 -0
  412. package/src/components/badge/Badge.mdx +487 -0
  413. package/src/components/badge/Badge.stories.tsx +375 -0
  414. package/src/components/badge/Badge.tsx +360 -0
  415. package/src/components/badge/index.ts +10 -0
  416. package/src/components/banner/Banner.mdx +704 -0
  417. package/src/components/banner/Banner.stories.tsx +448 -0
  418. package/src/components/banner/Banner.tsx +602 -0
  419. package/src/components/banner/index.ts +14 -0
  420. package/src/components/button/Button.mdx +286 -0
  421. package/src/components/button/Button.stories.tsx +381 -0
  422. package/src/components/button/Button.tsx +384 -0
  423. package/src/components/button/index.ts +1 -0
  424. package/src/components/button-group/ButtonGroup.mdx +512 -0
  425. package/src/components/button-group/ButtonGroup.stories.tsx +714 -0
  426. package/src/components/button-group/ButtonGroup.tsx +491 -0
  427. package/src/components/button-group/index.ts +10 -0
  428. package/src/components/card-select/CardSelect.mdx +662 -0
  429. package/src/components/card-select/CardSelect.stories.tsx +784 -0
  430. package/src/components/card-select/CardSelect.tsx +783 -0
  431. package/src/components/card-select/CardSelectGroup.tsx +169 -0
  432. package/src/components/card-select/index.ts +18 -0
  433. package/src/components/checkbox/Checkbox.mdx +269 -0
  434. package/src/components/checkbox/Checkbox.stories.tsx +306 -0
  435. package/src/components/checkbox/Checkbox.tsx +343 -0
  436. package/src/components/checkbox/index.ts +1 -0
  437. package/src/components/chip/Chip.mdx +683 -0
  438. package/src/components/chip/Chip.stories.tsx +734 -0
  439. package/src/components/chip/Chip.tsx +732 -0
  440. package/src/components/chip/index.ts +9 -0
  441. package/src/components/column-header/ColumnHeader.mdx +301 -0
  442. package/src/components/column-header/ColumnHeader.stories.tsx +319 -0
  443. package/src/components/column-header/ColumnHeader.tsx +287 -0
  444. package/src/components/column-header/index.ts +7 -0
  445. package/src/components/combobox-field/Combobox.tsx +693 -0
  446. package/src/components/combobox-field/ComboboxField.mdx +525 -0
  447. package/src/components/combobox-field/ComboboxField.stories.tsx +502 -0
  448. package/src/components/combobox-field/ComboboxField.tsx +259 -0
  449. package/src/components/combobox-field/index.ts +12 -0
  450. package/src/components/date-picker/DatePicker.mdx +440 -0
  451. package/src/components/date-picker/DatePicker.stories.tsx +458 -0
  452. package/src/components/date-picker/DatePicker.tsx +688 -0
  453. package/src/components/date-picker/index.ts +9 -0
  454. package/src/components/divider/Divider.mdx +256 -0
  455. package/src/components/divider/Divider.stories.tsx +177 -0
  456. package/src/components/divider/Divider.tsx +193 -0
  457. package/src/components/divider/index.ts +1 -0
  458. package/src/components/drawer/Drawer.mdx +518 -0
  459. package/src/components/drawer/Drawer.stories.tsx +392 -0
  460. package/src/components/drawer/Drawer.tsx +683 -0
  461. package/src/components/drawer/index.ts +1 -0
  462. package/src/components/dropdown-button/DropdownButton.mdx +285 -0
  463. package/src/components/dropdown-button/DropdownButton.stories.tsx +398 -0
  464. package/src/components/dropdown-button/DropdownButton.tsx +198 -0
  465. package/src/components/dropdown-button/index.ts +7 -0
  466. package/src/components/faq/FAQ.mdx +364 -0
  467. package/src/components/faq/FAQ.stories.tsx +343 -0
  468. package/src/components/faq/FAQ.tsx +337 -0
  469. package/src/components/faq/index.ts +1 -0
  470. package/src/components/field/Field.mdx +129 -0
  471. package/src/components/field/Field.stories.tsx +461 -0
  472. package/src/components/field/Field.tsx +787 -0
  473. package/src/components/field/index.ts +20 -0
  474. package/src/components/field-pair/FieldPair.mdx +312 -0
  475. package/src/components/field-pair/FieldPair.stories.tsx +539 -0
  476. package/src/components/field-pair/FieldPair.tsx +845 -0
  477. package/src/components/field-pair/index.ts +9 -0
  478. package/src/components/file-upload/FileUpload.mdx +345 -0
  479. package/src/components/file-upload/FileUpload.stories.tsx +698 -0
  480. package/src/components/file-upload/FileUpload.tsx +802 -0
  481. package/src/components/file-upload/index.ts +6 -0
  482. package/src/components/filter-chip/FilterChip.mdx +778 -0
  483. package/src/components/filter-chip/FilterChip.stories.tsx +827 -0
  484. package/src/components/filter-chip/FilterChip.tsx +881 -0
  485. package/src/components/filter-chip/index.ts +11 -0
  486. package/src/components/filter-facet/FilterFacet.mdx +536 -0
  487. package/src/components/filter-facet/FilterFacet.stories.tsx +506 -0
  488. package/src/components/filter-facet/FilterFacet.tsx +1160 -0
  489. package/src/components/filter-facet/index.ts +7 -0
  490. package/src/components/firm-avatar/FirmAvatar.mdx +280 -0
  491. package/src/components/firm-avatar/FirmAvatar.stories.tsx +147 -0
  492. package/src/components/firm-avatar/FirmAvatar.tsx +172 -0
  493. package/src/components/firm-avatar/index.ts +7 -0
  494. package/src/components/form-actions/FormActions.mdx +518 -0
  495. package/src/components/form-actions/FormActions.stories.tsx +621 -0
  496. package/src/components/form-actions/FormActions.tsx +273 -0
  497. package/src/components/form-actions/index.ts +6 -0
  498. package/src/components/form-block/FormBlock.mdx +728 -0
  499. package/src/components/form-block/FormBlock.stories.tsx +813 -0
  500. package/src/components/form-block/FormBlock.tsx +679 -0
  501. package/src/components/form-block/index.ts +13 -0
  502. package/src/components/form-section/FormSection.mdx +436 -0
  503. package/src/components/form-section/FormSection.stories.tsx +407 -0
  504. package/src/components/form-section/FormSection.tsx +290 -0
  505. package/src/components/form-section/index.ts +17 -0
  506. package/src/components/heading/Heading.mdx +206 -0
  507. package/src/components/heading/Heading.stories.tsx +169 -0
  508. package/src/components/heading/Heading.tsx +124 -0
  509. package/src/components/heading/index.ts +8 -0
  510. package/src/components/heading-group/HeadingGroup.mdx +521 -0
  511. package/src/components/heading-group/HeadingGroup.stories.tsx +353 -0
  512. package/src/components/heading-group/HeadingGroup.tsx +396 -0
  513. package/src/components/heading-group/index.ts +7 -0
  514. package/src/components/hero/Hero.mdx +742 -0
  515. package/src/components/hero/Hero.stories.tsx +527 -0
  516. package/src/components/hero/Hero.tsx +807 -0
  517. package/src/components/hero/index.ts +1 -0
  518. package/src/components/icon/Icon.mdx +329 -0
  519. package/src/components/icon/Icon.stories.tsx +398 -0
  520. package/src/components/icon/Icon.tsx +97 -0
  521. package/src/components/icon/index.ts +2 -0
  522. package/src/components/icon-button/IconButton.mdx +206 -0
  523. package/src/components/icon-button/IconButton.stories.tsx +341 -0
  524. package/src/components/icon-button/IconButton.tsx +273 -0
  525. package/src/components/icon-button/index.ts +1 -0
  526. package/src/components/item-row/ItemRow.mdx +533 -0
  527. package/src/components/item-row/ItemRow.stories.tsx +434 -0
  528. package/src/components/item-row/ItemRow.tsx +676 -0
  529. package/src/components/item-row/index.ts +9 -0
  530. package/src/components/list-row/ListRow.mdx +404 -0
  531. package/src/components/list-row/ListRow.stories.tsx +404 -0
  532. package/src/components/list-row/ListRow.tsx +424 -0
  533. package/src/components/list-row/index.ts +1 -0
  534. package/src/components/menu/Menu.mdx +268 -0
  535. package/src/components/menu/Menu.stories.tsx +455 -0
  536. package/src/components/menu/Menu.tsx +452 -0
  537. package/src/components/menu/index.ts +1 -0
  538. package/src/components/modal/Modal.mdx +854 -0
  539. package/src/components/modal/Modal.stories.tsx +881 -0
  540. package/src/components/modal/Modal.tsx +1434 -0
  541. package/src/components/modal/index.ts +1 -0
  542. package/src/components/nav-link/NavLink.mdx +196 -0
  543. package/src/components/nav-link/NavLink.stories.tsx +243 -0
  544. package/src/components/nav-link/NavLink.tsx +222 -0
  545. package/src/components/nav-link/index.ts +1 -0
  546. package/src/components/number-field/NumberField.mdx +223 -0
  547. package/src/components/number-field/NumberField.stories.tsx +291 -0
  548. package/src/components/number-field/NumberField.tsx +388 -0
  549. package/src/components/number-field/index.ts +6 -0
  550. package/src/components/pagination/Pagination.mdx +305 -0
  551. package/src/components/pagination/Pagination.stories.tsx +333 -0
  552. package/src/components/pagination/Pagination.tsx +343 -0
  553. package/src/components/pagination/index.ts +8 -0
  554. package/src/components/popover-surface/PopoverSurface.mdx +158 -0
  555. package/src/components/popover-surface/PopoverSurface.stories.tsx +421 -0
  556. package/src/components/popover-surface/index.ts +1 -0
  557. package/src/components/progress-bar/ProgressBar.mdx +802 -0
  558. package/src/components/progress-bar/ProgressBar.stories.tsx +533 -0
  559. package/src/components/progress-bar/ProgressBar.tsx +654 -0
  560. package/src/components/progress-bar/index.ts +9 -0
  561. package/src/components/promo-sticker/PromoSticker.mdx +436 -0
  562. package/src/components/promo-sticker/PromoSticker.stories.tsx +363 -0
  563. package/src/components/promo-sticker/PromoSticker.tsx +313 -0
  564. package/src/components/promo-sticker/index.ts +7 -0
  565. package/src/components/promo-surface/PromoSurface.mdx +399 -0
  566. package/src/components/promo-surface/PromoSurface.stories.tsx +270 -0
  567. package/src/components/promo-surface/PromoSurface.tsx +305 -0
  568. package/src/components/promo-surface/index.ts +7 -0
  569. package/src/components/radio/Radio.mdx +243 -0
  570. package/src/components/radio/Radio.stories.tsx +307 -0
  571. package/src/components/radio/Radio.tsx +288 -0
  572. package/src/components/radio/index.ts +1 -0
  573. package/src/components/radio-group/RadioGroup.mdx +119 -0
  574. package/src/components/radio-group/RadioGroup.stories.tsx +225 -0
  575. package/src/components/radio-group/RadioGroup.tsx +139 -0
  576. package/src/components/radio-group/index.ts +1 -0
  577. package/src/components/select/Select.mdx +241 -0
  578. package/src/components/select/Select.stories.tsx +404 -0
  579. package/src/components/select/Select.tsx +381 -0
  580. package/src/components/select/index.ts +1 -0
  581. package/src/components/select-field/SelectField.mdx +324 -0
  582. package/src/components/select-field/SelectField.stories.tsx +460 -0
  583. package/src/components/select-field/SelectField.tsx +138 -0
  584. package/src/components/select-field/index.ts +1 -0
  585. package/src/components/skeleton/Skeleton.mdx +194 -0
  586. package/src/components/skeleton/Skeleton.stories.tsx +260 -0
  587. package/src/components/skeleton/Skeleton.tsx +107 -0
  588. package/src/components/skeleton/index.ts +1 -0
  589. package/src/components/split-button/SplitButton.mdx +445 -0
  590. package/src/components/split-button/SplitButton.stories.tsx +465 -0
  591. package/src/components/split-button/SplitButton.tsx +361 -0
  592. package/src/components/split-button/index.ts +7 -0
  593. package/src/components/status-summary-bar/StatusSummaryBar.mdx +338 -0
  594. package/src/components/status-summary-bar/StatusSummaryBar.stories.tsx +408 -0
  595. package/src/components/status-summary-bar/StatusSummaryBar.tsx +428 -0
  596. package/src/components/status-summary-bar/index.ts +8 -0
  597. package/src/components/subject-lookup-field/SubjectLookupField.mdx +378 -0
  598. package/src/components/subject-lookup-field/SubjectLookupField.stories.tsx +393 -0
  599. package/src/components/subject-lookup-field/SubjectLookupField.tsx +1079 -0
  600. package/src/components/subject-lookup-field/index.ts +11 -0
  601. package/src/components/switch/Switch.mdx +376 -0
  602. package/src/components/switch/Switch.stories.tsx +296 -0
  603. package/src/components/switch/Switch.tsx +483 -0
  604. package/src/components/switch/index.ts +1 -0
  605. package/src/components/table/Table.mdx +575 -0
  606. package/src/components/table/Table.stories.tsx +1049 -0
  607. package/src/components/table/Table.tsx +745 -0
  608. package/src/components/table/TableConsumers.stories.tsx +195 -0
  609. package/src/components/table/_tableFixtures.ts +1189 -0
  610. package/src/components/table/index.ts +22 -0
  611. package/src/components/text-field/TextField.mdx +699 -0
  612. package/src/components/text-field/TextField.stories.tsx +674 -0
  613. package/src/components/text-field/TextField.tsx +645 -0
  614. package/src/components/text-field/index.ts +11 -0
  615. package/src/components/text-link/TextLink.mdx +353 -0
  616. package/src/components/text-link/TextLink.stories.tsx +458 -0
  617. package/src/components/text-link/TextLink.tsx +504 -0
  618. package/src/components/text-link/index.ts +10 -0
  619. package/src/components/textarea/Textarea.mdx +244 -0
  620. package/src/components/textarea/Textarea.stories.tsx +371 -0
  621. package/src/components/textarea/Textarea.tsx +489 -0
  622. package/src/components/textarea/index.ts +9 -0
  623. package/src/components/tooltip/Tooltip.mdx +462 -0
  624. package/src/components/tooltip/Tooltip.stories.tsx +500 -0
  625. package/src/components/tooltip/Tooltip.tsx +756 -0
  626. package/src/components/tooltip/index.ts +13 -0
  627. package/src/components/unit-field/UnitField.mdx +215 -0
  628. package/src/components/unit-field/UnitField.stories.tsx +291 -0
  629. package/src/components/unit-field/UnitField.tsx +255 -0
  630. package/src/components/unit-field/index.ts +7 -0
  631. package/src/icons/icon-registry.generated.ts +510 -0
  632. package/src/icons/icon-types.generated.ts +256 -0
  633. package/src/index.ts +70 -0
  634. package/src/internal/BottomSheet.tsx +714 -0
  635. package/src/internal/FodsProvider.tsx +36 -0
  636. package/src/internal/MotionCaret.tsx +53 -0
  637. package/src/internal/NumberFormatInput.tsx +276 -0
  638. package/src/internal/SummaryDonut.tsx +359 -0
  639. package/src/internal/buttonSegment.ts +241 -0
  640. package/src/internal/collapseRoom.ts +130 -0
  641. package/src/internal/comboboxKeys.ts +90 -0
  642. package/src/internal/contentPresence.ts +46 -0
  643. package/src/internal/dayCell.ts +274 -0
  644. package/src/internal/dialogPortal.ts +50 -0
  645. package/src/internal/donutSweeps.ts +77 -0
  646. package/src/internal/enterOnViewGeometry.ts +53 -0
  647. package/src/internal/faqItem.ts +104 -0
  648. package/src/internal/floatingLabelMotion.tsx +109 -0
  649. package/src/internal/formBlockContext.ts +27 -0
  650. package/src/internal/heightRoom.ts +135 -0
  651. package/src/internal/numberSeparators.ts +93 -0
  652. package/src/internal/overlayMotion.tsx +32 -0
  653. package/src/internal/paginationItem.ts +106 -0
  654. package/src/internal/popoverSurface.ts +78 -0
  655. package/src/internal/portalContainer.ts +11 -0
  656. package/src/internal/progressBarItem.ts +356 -0
  657. package/src/internal/selectionControlText.ts +42 -0
  658. package/src/internal/statusSummaryParts.tsx +475 -0
  659. package/src/internal/summaryMotion.ts +111 -0
  660. package/src/internal/table/ChildConnector.tsx +57 -0
  661. package/src/internal/table/ChildRowPrefix.tsx +21 -0
  662. package/src/internal/table/ColumnSettings.tsx +194 -0
  663. package/src/internal/table/ScrollRegion.tsx +176 -0
  664. package/src/internal/table/TableEmpty.tsx +99 -0
  665. package/src/internal/table/TableLayout.tsx +29 -0
  666. package/src/internal/table/TableLoadStatus.tsx +60 -0
  667. package/src/internal/table/TableMobile.tsx +582 -0
  668. package/src/internal/table/TruncatedCell.tsx +35 -0
  669. package/src/internal/table/emptyValue.ts +11 -0
  670. package/src/internal/table/features.ts +44 -0
  671. package/src/internal/table/recipes.ts +263 -0
  672. package/src/internal/table/rowClick.ts +8 -0
  673. package/src/internal/table/types.ts +342 -0
  674. package/src/internal/tailwind-variants.ts +65 -0
  675. package/src/internal/tooltipContext.ts +15 -0
  676. package/src/internal/tw-merge-config.generated.ts +275 -0
  677. package/src/internal/useAnchoredPanel.ts +340 -0
  678. package/src/internal/useCountUp.ts +65 -0
  679. package/src/internal/useDateFieldTrigger.tsx +497 -0
  680. package/src/internal/useEChart.ts +88 -0
  681. package/src/internal/useEnterOnView.ts +80 -0
  682. package/src/internal/useFloatingBar.ts +125 -0
  683. package/src/internal/useFormReset.ts +57 -0
  684. package/src/internal/useIsMobile.ts +64 -0
  685. package/src/internal/useNoImplicitSubmit.ts +41 -0
  686. package/src/internal/useOneRowOverflow.ts +103 -0
  687. package/src/internal/usePrefersReducedMotion.ts +27 -0
  688. package/src/internal/useReturnFocus.ts +34 -0
  689. package/src/internal/utils.ts +58 -0
  690. package/src/recipes/EmptyState.stories.tsx +105 -0
  691. package/src/recipes/Form.stories.tsx +360 -0
  692. package/src/recipes/ModalWithForm.stories.tsx +219 -0
  693. package/src/recipes/Recipes.mdx +61 -0
  694. package/src/recipes/TableWithFilters.stories.tsx +278 -0
  695. package/src/storybook/FodsFamily.tsx +39 -0
  696. package/src/storybook/Section.tsx +36 -0
  697. package/src/storybook/a11y.ts +24 -0
  698. package/src/storybook/assets/banner-character-bartender.webp +0 -0
  699. package/src/storybook/assets/banner-invoice-sheet-left.webp +0 -0
  700. package/src/storybook/assets/banner-invoice-sheet-right.webp +0 -0
  701. package/src/storybook/assets/invoice-hero.webp +0 -0
  702. package/src/storybook/assets/invoice.webp +0 -0
  703. package/src/storybook/assets/section-document-info.svg +21 -0
  704. package/src/storybook/assets/section-gear-checklist.svg +11 -0
  705. package/src/storybook/assets/section-person-arrow-in.svg +15 -0
  706. package/src/storybook/assets/section-person-arrow-out.svg +22 -0
  707. package/src/storybook/assets/section-receipt-dollar.svg +23 -0
  708. package/src/storybook/assets/table-empty-folder-empty.png +0 -0
  709. package/src/storybook/assets/table-empty-folder-magnifying-glass.png +0 -0
  710. package/src/storybook/assets/table-empty-funnel.png +0 -0
  711. package/src/storybook/assets/table-empty-load-failed.png +0 -0
  712. package/src/storybook/assets/wallet-spot.png +0 -0
  713. package/src/storybook/assets.d.ts +17 -0
  714. package/src/storybook/componentDoc.ts +41 -0
  715. package/src/storybook/fitFrame.tsx +70 -0
  716. package/src/storybook/forceStates.tsx +647 -0
  717. package/src/storybook/illustrations.tsx +66 -0
  718. package/src/storybook/viewportFrame.tsx +58 -0
  719. package/src/styles/assets/label-brush-1.svg +6 -0
  720. package/src/styles/assets/pattern-dark.svg +113 -0
  721. package/src/styles/base.css +106 -0
  722. package/src/styles/index.css +15 -0
  723. package/src/styles/motion.css +157 -0
  724. package/src/styles/promo-sticker.css +27 -0
  725. package/src/styles/promo-surface.css +49 -0
  726. package/src/styles/shared.css +11 -0
  727. package/src/styles/theme.generated.css +314 -0
  728. package/src/styles/theme.map.json +278 -0
  729. package/src/styles/tracking.generated.css +12 -0
  730. package/src/tokens/index.ts +4 -0
  731. package/src/tokens/tokens.generated.ts +542 -0
@@ -0,0 +1,845 @@
1
+ "use client";
2
+ import * as React from 'react';
3
+ import { tv } from '../../internal/tailwind-variants';
4
+ import { type NumberFormatValues } from 'react-number-format';
5
+ import type { Locale } from 'date-fns';
6
+ import { Icon, type IconSize } from '../icon/Icon';
7
+ import { cn } from '../../internal/utils';
8
+ import {
9
+ FLOATING_LABEL_ENTER,
10
+ FloatingLabelGhost,
11
+ useFloatingLabelMotion,
12
+ } from '../../internal/floatingLabelMotion';
13
+ import { floatingLabelVariants, helperTextVariants } from '../field/Field';
14
+ import { textFieldValueVariants } from '../text-field/TextField';
15
+ import { NumberFormatInput, type NumberFormatInputProps } from '../../internal/NumberFormatInput';
16
+ import { type DatePickerNavLabels } from '../date-picker/DatePicker';
17
+ import { useFormReset } from '../../internal/useFormReset';
18
+ import { useDateFieldTrigger, type UseDateFieldTriggerOptions } from '../../internal/useDateFieldTrigger';
19
+ import { enUS } from 'date-fns/locale/en-US';
20
+
21
+ // =============================================================================
22
+ // FieldPair — two fused fields that read as one bounded range (od–do), spec
23
+ // molecule `field-pair` (manifest 1.13.3).
24
+ //
25
+ // The Button Group scheme applied to inputs: one container owns the outline +
26
+ // radius and a fill of --outline-default; two borderless Field Segment cells
27
+ // (fill --bg-primary) sit inside with a 1px gap, so the container fill shows
28
+ // through the gap as the divider. Each cell is a real <input> with its own
29
+ // value / focus / error; the SINGLE shared helper is referenced by both cells
30
+ // via aria-describedby.
31
+ //
32
+ // Reuse, not reinvention: the cell floating label reuses `floatingLabelVariants`
33
+ // (colour overridden to --text-secondary per the field-pair spec), the value
34
+ // reuses `textFieldValueVariants`, and the shared line reuses `helperTextVariants`
35
+ // — a Text Field / Field change reaches the pair.
36
+ //
37
+ // Deferred per spec: cell-level Disabled / Read-only / Success are NOT built yet.
38
+ // A `disabled` / `readOnly` attribute passed on a cell still reaches its native
39
+ // <input> (via `...inputProps`) so the control is inert, but there is no disabled
40
+ // visual treatment (muted fill, muted label) — the cell looks active. Do not
41
+ // rely on it for a visually-disabled range until the states land.
42
+ // =============================================================================
43
+
44
+ export type FieldPairSize = 'md' | 'sm';
45
+
46
+ // Container — owns the outline + radius; fill is --outline-default so the 1px gap
47
+ // between the two cells reads as the divider (Button Group pattern). Does not clip
48
+ // (floated labels render above the top border). Error reds border + divider.
49
+ const fieldPairContainerVariants = tv({
50
+ // `gap-px` = 1px hairline: the container fill shows through the gap between the
51
+ // two cells as the divider (Button Group pattern). `border-100` = the
52
+ // --border-width-100 token for the container outline.
53
+ //
54
+ // A REAL border, and deliberately no padding with it. Field Pair is the one
55
+ // grouped molecule that escapes the inset-outline rule (edge-outline.md § When
56
+ // it does NOT fire): an inset outline is painted over by the opaque edge-to-edge
57
+ // cells, and this container cannot clip them back because the floated labels
58
+ // overflow its top edge. Upstream's own note spells out the either/or — CODE
59
+ // takes the border and NO padding (CSS already lays children inside the border
60
+ // box, so the cells come out 46/38 by themselves), FIGMA takes 1px of padding and
61
+ // lets the fill be the edge. Doing both renders 2px. The declared 48/40 is the
62
+ // OUTER height either way, which is what keeps the pair level with a Text Field.
63
+ base: 'relative flex w-full gap-px rounded-400 border-100',
64
+ variants: {
65
+ size: {
66
+ md: 'h-1100',
67
+ sm: 'h-1000',
68
+ },
69
+ state: {
70
+ default: 'border-outline-default bg-outline-default',
71
+ error: 'border-status-danger bg-status-danger',
72
+ },
73
+ },
74
+ defaultVariants: {
75
+ size: 'md',
76
+ state: 'default',
77
+ },
78
+ });
79
+
80
+ // Field Segment — the borderless field cell (the internals of a Text Field with
81
+ // no border and no own radius). Equal halves; outer corners rounded by position
82
+ // (start rounds the left, end rounds the right). Surface is always --bg-primary.
83
+ //
84
+ // Focus is a runtime per-cell :focus-visible ring that sits OUTSIDE the cell,
85
+ // reading (from the value out) as: interior → grey container border → 1px gap →
86
+ // --outline-focus ring (--border-width-200). Per the field-pair spec the ring is a
87
+ // ::before pseudo-element, NOT a CSS `outline`: an outline is painted above the
88
+ // element's children, so it would cover the floating label; a ::before is painted
89
+ // under later children, so the label masks the ring's top edge by source order (the
90
+ // label's own opaque --bg-primary chip is the mask — see the label backing below).
91
+ // The ring is a transparent-interior border inset by --space-200 (the offset gap +
92
+ // the ring width), so the container's grey border and the 1px page-background gap
93
+ // stay visible through it. Its radius follows the cell: outer corners stay rounded
94
+ // (--radius-500), inner (divider) corners round to --radius-200 so it is not square
95
+ // on the divider side. On the divider side the ring extends over the neighbour, so
96
+ // the focused cell raises z-index (base + 1) to paint above it.
97
+ const fieldSegmentVariants = tv({
98
+ base: [
99
+ 'relative flex h-full min-w-0 flex-1 items-center gap-400 px-500',
100
+ 'bg-background-primary',
101
+ // Focused cell lifts its whole subtree (ring + label together) above the 1px
102
+ // divider + the sibling cell — semantic z-index token (base + 1) per the spec.
103
+ 'has-[:focus-visible]:z-[calc(var(--z-index-base)+1)]',
104
+ // Focus ring = ::before pseudo-element (NOT `outline`, which would paint over
105
+ // the label). -inset-200 (--space-200 = offset gap + ring width);
106
+ // border-200 = --border-width-200; colour --outline-focus.
107
+ "has-[:focus-visible]:before:content-[''] has-[:focus-visible]:before:absolute",
108
+ 'has-[:focus-visible]:before:-inset-200 has-[:focus-visible]:before:border-200',
109
+ 'has-[:focus-visible]:before:border-outline-focus has-[:focus-visible]:before:pointer-events-none',
110
+ // On focus the ring sits above the cell's top edge — i.e. in the transparent
111
+ // top half of the label's shared chip (opaque only up to `calc(50% + 0.5px)`),
112
+ // so the ring would show through the label. Widen the chip's opaque stop to
113
+ // `--space-200` above centre (= the ring's outer edge, same token as the
114
+ // `-inset-200` offset, so both move together): opaque now covers the ring,
115
+ // transparent resumes just above it. Written as a `has-` variant on the CELL
116
+ // targeting the child label — NOT `group-has-` on the label itself, which
117
+ // proved unreliable to generate (QA builds shipped the class in the markup
118
+ // with no matching selector in the CSS, while every `has-` rule on the cell
119
+ // was present). `!important`: the base floating chip is an equal-specificity
120
+ // `[background:...]` utility on the label and later in source order, so `!`
121
+ // is what lets the widened focus notch win.
122
+ 'has-[:focus-visible]:[&>label]:![background:linear-gradient(to_top,theme(colors.background.primary)_0%,theme(colors.background.primary)_calc(50%+var(--space-200)),transparent_calc(50%+var(--space-200)))]',
123
+ // The same notch for the group label, which the start cell renders as a <span>.
124
+ 'has-[:focus-visible]:[&>[data-fods-part=group-label]]:![background:linear-gradient(to_top,theme(colors.background.primary)_0%,theme(colors.background.primary)_calc(50%+var(--space-200)),transparent_calc(50%+var(--space-200)))]',
125
+ ],
126
+ variants: {
127
+ // Outer corners rounded by position. The cell sits inside the container's 1px
128
+ // border, whose inner edge curves at --radius-400 minus the border width; a cell
129
+ // rounded at the full --radius-400 would leave a sliver of the container fill in
130
+ // each corner, reading as a second arc next to the border (visible in Error).
131
+ // The focus ring's radius lives on the ::before: outer corners --radius-500 (one
132
+ // step up, clearing the offset), inner (divider) corners --radius-200 so the ring
133
+ // is not square there.
134
+ position: {
135
+ start:
136
+ 'rounded-l-[calc(var(--radius-400)-var(--border-width-100))] has-[:focus-visible]:before:rounded-l-500 has-[:focus-visible]:before:rounded-r-200',
137
+ end: 'rounded-r-[calc(var(--radius-400)-var(--border-width-100))] has-[:focus-visible]:before:rounded-r-500 has-[:focus-visible]:before:rounded-l-200',
138
+ },
139
+ },
140
+ });
141
+
142
+ // Group label chip width cap (field-pair `text.group-label`): it stays inside the
143
+ // start cell. Amount mode: the Text Field label cap (cell − 24). Date mode: the
144
+ // chip starts past the calendar glyph, so the cap is what is left up to the
145
+ // cell's end padding — start offset (--space-500 + icon + gap − the chip's own
146
+ // --space-200 padding) plus --space-500.
147
+ const GROUP_LABEL_AMOUNT_CAP = 'max-w-[calc(100%-24px)]';
148
+ const GROUP_LABEL_DATE_CAP: Record<FieldPairSize, string> = {
149
+ md: 'max-w-[calc(100%-var(--space-500)*2-var(--space-800)-var(--space-400)+var(--space-200))]',
150
+ sm: 'max-w-[calc(100%-var(--space-500)*2-var(--space-700)-var(--space-400)+var(--space-200))]',
151
+ };
152
+
153
+ // Unit suffix (e.g. "Kč") — one tier below the value (--text-placeholder), the
154
+ // same rule + WCAG exception as Unit Field. Meaning carried by aria-describedby.
155
+ const fieldSegmentUnitVariants = tv({
156
+ base: 'shrink-0 font-inter font-normal text-body-base text-text-placeholder',
157
+ });
158
+
159
+ // The date-mode leading glyph (`_field-segment` 1.6.0 `slots.leading-icon`).
160
+ // A recipe of its own rather than an inline className so the ink is one bound
161
+ // token the verifier can read, the same shape the unit suffix uses.
162
+ const fieldSegmentLeadingIconVariants = tv({
163
+ base: 'shrink-0 text-text-secondary',
164
+ });
165
+
166
+ export interface FieldPairCell
167
+ extends Omit<
168
+ React.InputHTMLAttributes<HTMLInputElement>,
169
+ 'size' | 'prefix' | 'children' | 'value'
170
+ > {
171
+ /** The cell's bound word — floating label, resting inside while calm (e.g. "Od", "Min"; "od" with a group label). */
172
+ label?: string;
173
+ /**
174
+ * Per-cell error — reds this cell (label --status-danger + trailing status
175
+ * icon) and, together with the sibling, the container border + divider.
176
+ */
177
+ error?: boolean;
178
+ /** Cell value. A number in `format="number"` (raw, unformatted); a string otherwise. */
179
+ value?: string | number;
180
+ /**
181
+ * Value change in `format="number"` mode — parent stores `values.floatValue`
182
+ * (raw number). In `format="text"` mode use the standard DOM `onChange` instead.
183
+ */
184
+ onValueChange?: (values: NumberFormatValues) => void;
185
+ }
186
+
187
+ /**
188
+ * A cell in `format="date"` — the value is the `Date` itself, not the text the
189
+ * input shows. The cell formats and parses it exactly like a standalone
190
+ * `TextField type="date"` does.
191
+ */
192
+ export interface FieldPairDateCell
193
+ extends Omit<FieldPairCell, 'value' | 'defaultValue' | 'onChange' | 'onValueChange'> {
194
+ value?: Date;
195
+ onValueChange?: (value: Date | undefined) => void;
196
+ /**
197
+ * A typed draft in this cell was rejected on commit (blur or Enter) — `'unparseable'` or
198
+ * `'out-of-range'` (outside this cell's `minDate` / `maxDate`). Same contract
199
+ * as `TextField type="date"`: the typed text stays and the cell's value
200
+ * becomes `undefined`.
201
+ */
202
+ onInvalidInput?: UseDateFieldTriggerOptions['onInvalidInput'];
203
+ /**
204
+ * Per-cell selectable window. Deliberately NOT cross-wired to the sibling —
205
+ * spec field-pair.md § Field Segment: "no cross-field minDate/maxDate
206
+ * constraint between them". An invalid range (Do before Od) is caught by the
207
+ * pair's own reactive error model, not prevented at the picker level.
208
+ */
209
+ minDate?: Date;
210
+ maxDate?: Date;
211
+ }
212
+
213
+ export interface FieldPairBaseProps {
214
+ /** Height — Medium (48, forms) · Small (40, filters). Applied to both cells. */
215
+ size?: FieldPairSize;
216
+ /** Shared helper text below the pair. */
217
+ helperText?: string;
218
+ /**
219
+ * Shared error message below the pair (danger tone). Replaces the helper; a
220
+ * range error states the relationship ("„Od" musí být před „Do"").
221
+ */
222
+ error?: string;
223
+ /** Base id — used to associate the shared message with both cells. */
224
+ id?: string;
225
+ /** Additional className for the container. */
226
+ className?: string;
227
+ }
228
+
229
+ /**
230
+ * The `role="group"` wrapper must carry an accessible name (WCAG 4.1.2) — and it
231
+ * does NOT inherit one from the per-cell `<label>`s (those name the individual
232
+ * inputs, not the group). The spec ("one labelled group with a group name")
233
+ * requires it, so the contract forces exactly one of `aria-label` /
234
+ * `aria-labelledby`.
235
+ */
236
+ type FieldPairA11yName =
237
+ | { 'aria-label': string; 'aria-labelledby'?: never; label?: never }
238
+ | { 'aria-labelledby': string; 'aria-label'?: never; label?: never }
239
+ | {
240
+ /**
241
+ * Visible group label (manifest `Show label`) — names the quantity only
242
+ * (`Cena`, not `Cena od / do`) and is the group's accessible name. Floats on
243
+ * the top border over the start cell. The cells keep their own floating
244
+ * labels (write them lowercase, `od` / `do`): the start cell's floats INTO
245
+ * this chip (`Cena od`), the end cell's floats on its own, and each input is
246
+ * named by both (`aria-labelledby` → „Cena od", „Cena do").
247
+ */
248
+ label: string;
249
+ 'aria-label'?: never;
250
+ 'aria-labelledby'?: never;
251
+ /**
252
+ * With a group label the cell `label` is the bound word that completes each
253
+ * input's name („Cena od") — required here.
254
+ */
255
+ from: { label: string };
256
+ to: { label: string };
257
+ };
258
+
259
+ /**
260
+ * The unit affix cannot be switched on without wording for it. The design system
261
+ * is locale-agnostic, so the string is the consumer's to supply and to translate;
262
+ * a built-in `'Kč'` would silently ship a Czech currency into every other market.
263
+ * Same shape as `Textarea`'s counter contract.
264
+ */
265
+ type FieldPairUnit =
266
+ | {
267
+ /** Show the unit affix in both cells (amount range) — the manifest default. */
268
+ showUnit?: true;
269
+ /** Unit affix rendered in both cells (e.g. `t('units.currency')`). */
270
+ unit: string;
271
+ }
272
+ | {
273
+ /** Off = date range (Od / Do); the cells carry no affix. */
274
+ showUnit: false;
275
+ unit?: never;
276
+ };
277
+
278
+ /** Plain text or number cells — no calendar anywhere. */
279
+ type FieldPairValueMode = {
280
+ /**
281
+ * Input flavour applied to BOTH cells. `text` (default) = plain input for
282
+ * free text. `number` = a locale-aware `NumberFormatInput` (thousand
283
+ * separators, decimals) — cells then take a numeric `value` + `onValueChange`.
284
+ */
285
+ format?: 'text' | 'number';
286
+ /** Range start cell (the "Od" bound) — own value, focus and error. */
287
+ from: FieldPairCell;
288
+ /** Range end cell (the "Do" bound) — own value, focus and error. */
289
+ to: FieldPairCell;
290
+ /** `format="number"` only — locale driving the separators (default `cs`). */
291
+ locale?: string;
292
+ /** `format="number"` only — max decimal places (default 0 = integers with grouping). */
293
+ precision?: number;
294
+ /** `format="number"` only — always render `precision` decimals. */
295
+ fixedDecimals?: boolean;
296
+ dateFormat?: never;
297
+ dateLocale?: never;
298
+ panelLabel?: never;
299
+ navLabels?: never;
300
+ } & FieldPairUnit;
301
+
302
+ /**
303
+ * Date range — each cell is its own date trigger opening its OWN Single month
304
+ * Date Picker (spec field-pair.md § Field Segment, resolved 2026-08-05). This
305
+ * pair IS the mobile substitute for Date Picker's dual-month range mode, which
306
+ * has no mobile treatment at all.
307
+ *
308
+ * Opt-in is EXPLICIT and not implied by `showUnit={false}`, even though the spec
309
+ * phrases the condition that way. Figma has no cell-type axis, so `Show unit` is
310
+ * the only signal a variant set can carry; code has `format`, and the spec's own
311
+ * condition is two-part ("Show unit=False AND the pair represents a date
312
+ * range"). Two things ride on the distinction: `showUnit={false}` already
313
+ * carries plain text and plain number ranges, which must not silently grow a
314
+ * calendar — and `dateFormat` / `dateLocale` / `navLabels` can only be made
315
+ * REQUIRED when the mode is in the type. The spec's date ⇒ no-unit coupling is still enforced,
316
+ * one-directionally, by requiring `showUnit: false` here.
317
+ */
318
+ type FieldPairDateMode = {
319
+ format: 'date';
320
+ showUnit: false;
321
+ unit?: never;
322
+ from: FieldPairDateCell;
323
+ to: FieldPairDateCell;
324
+ /**
325
+ * Display + parse pattern (date-fns), applied to BOTH cells — the MARKET's
326
+ * (e.g. `dd. MM. yyyy` CZ, `MM/dd/yyyy` US). Required, no default, the same
327
+ * contract as `TextField type="date"` (text-field manifest 2.15.0).
328
+ */
329
+ dateFormat: string;
330
+ /**
331
+ * The market's date-fns Locale for both cells (parse, week start, weekday and
332
+ * month names). Required, no default. Named `dateLocale` because `locale` on
333
+ * this component is already the NUMBER formatter's locale string —
334
+ * harmonising the two names would collapse the union to `string | Locale`.
335
+ */
336
+ dateLocale: Locale;
337
+ /**
338
+ * Fallback accessible name for each cell's calendar dialog. A cell with a
339
+ * visible `label` names its dialog with that label instead (`aria-labelledby`,
340
+ * the same ids that name its input — „Cena od"); this string is used only for
341
+ * a cell without one, before that cell's own `aria-label`. Optional — a
342
+ * labelled cell never reads it — and never defaulted; a dialog left without
343
+ * any name warns in development.
344
+ */
345
+ panelLabel?: string;
346
+ /** Accessible names for the panels' navigation chevrons. */
347
+ navLabels: DatePickerNavLabels;
348
+ locale?: never;
349
+ precision?: never;
350
+ fixedDecimals?: never;
351
+ };
352
+
353
+ export type FieldPairProps = FieldPairBaseProps &
354
+ FieldPairA11yName &
355
+ (FieldPairValueMode | FieldPairDateMode);
356
+
357
+ // -----------------------------------------------------------------------------
358
+ // Field Segment cell — a real borderless input with its own floating label and
359
+ // (on error) a trailing status icon. Tracks focus + value locally to float the
360
+ // label, exactly like Field does for a standalone Text Field.
361
+ // -----------------------------------------------------------------------------
362
+
363
+ /** Everything a date-mode cell hands to its own trigger. */
364
+ type FieldSegmentDateConfig = Omit<UseDateFieldTriggerOptions, 'enabled' | 'disabled' | 'readOnly' | 'inputRef' | 'panelLabelledBy'>;
365
+
366
+ /**
367
+ * A cell that is not in date mode still has to CALL the trigger hook (rules of
368
+ * hooks), so it passes this inert config: nothing binds, the panel never opens.
369
+ * Module-level so the identity is stable across renders.
370
+ */
371
+ const INERT_DATE_TRIGGER: UseDateFieldTriggerOptions = {
372
+ enabled: false,
373
+ // Placeholders for the required fields: an inert hook formats nothing (no
374
+ // value) and never mounts the panel, so neither is read. `enUS` is date-fns's
375
+ // own built-in locale — no market is implied.
376
+ dateFormat: '',
377
+ locale: enUS,
378
+ navLabels: { previousMonth: '', nextMonth: '', previousYear: '', nextYear: '' },
379
+ };
380
+
381
+ interface FieldSegmentProps extends FieldPairCell {
382
+ size: FieldPairSize;
383
+ position: 'start' | 'end';
384
+ inputId: string;
385
+ describedBy?: string;
386
+ /** Unit suffix injected by FieldPair (undefined = hidden). */
387
+ unit?: string;
388
+ /** Input flavour (from FieldPair). */
389
+ format: 'text' | 'number' | 'date';
390
+ /** Number-format config (from FieldPair; used only when format="number"). */
391
+ locale?: string;
392
+ precision?: number;
393
+ fixedDecimals?: boolean;
394
+ /** Present only in `format="date"` — turns the cell into its own date trigger. */
395
+ date?: FieldSegmentDateConfig;
396
+ /**
397
+ * The pair shows a group label (its legend id): the input is then named
398
+ * `aria-labelledby="{group label} {own label}"` (field-pair 1.11.0).
399
+ */
400
+ groupLabelId?: string;
401
+ /**
402
+ * Rendered by the START cell rather than as a container child: the group may
403
+ * hold only the two cells (see the panel note below), and inside the cell the
404
+ * label shares the cell's focus lift + ring mask. The start cell's own label
405
+ * floats INTO this chip (`Cena od`).
406
+ */
407
+ groupLabel?: { id: string; text: string; error: boolean };
408
+ }
409
+
410
+ function FieldSegment({
411
+ size,
412
+ position,
413
+ inputId,
414
+ describedBy,
415
+ unit,
416
+ format,
417
+ locale,
418
+ precision,
419
+ fixedDecimals,
420
+ date,
421
+ groupLabelId,
422
+ groupLabel,
423
+ label,
424
+ error = false,
425
+ value,
426
+ defaultValue,
427
+ placeholder,
428
+ onFocus,
429
+ onBlur,
430
+ onChange,
431
+ onValueChange,
432
+ className,
433
+ id: cellId,
434
+ ...inputProps
435
+ }: FieldSegmentProps) {
436
+ // A consumer-supplied cell id wins; otherwise the pair-managed id keeps the
437
+ // <label htmlFor> association intact.
438
+ const resolvedId = cellId ?? inputId;
439
+ // Called unconditionally — inert unless this cell is in date mode. Cell-level
440
+ // disabled / read-only are deferred at the visual level (see the file header),
441
+ // but the native attributes still reach the input, so the trigger honours them.
442
+ const labelId = `${resolvedId}-label`;
443
+ // With a group label the bound word completes the input's name („Cena od").
444
+ const cellLabelledBy = groupLabelId && label ? `${groupLabelId} ${labelId}` : undefined;
445
+ // A native form reset drops a typed or rejected draft, as in a standalone
446
+ // date TextField; the cell then shows its `value` again. Inert outside date
447
+ // mode, where the ref stays empty.
448
+ const dateInputRef = React.useRef<HTMLInputElement | null>(null);
449
+ useFormReset(dateInputRef, () => trigger.clearDraft(), inputProps.form);
450
+ const trigger = useDateFieldTrigger(
451
+ date
452
+ ? {
453
+ ...date,
454
+ inputRef: dateInputRef,
455
+ // The calendar dialog carries the name of what visibly names the cell
456
+ // (overlay-behavior.md § Naming) — the same ids as the input; the
457
+ // config's `panelLabel` is the fallback for a cell with no label.
458
+ panelLabelledBy: cellLabelledBy ?? (label ? labelId : undefined),
459
+ panelLabel: date.panelLabel ?? inputProps['aria-label'],
460
+ disabled: Boolean(inputProps.disabled),
461
+ readOnly: Boolean(inputProps.readOnly),
462
+ }
463
+ : INERT_DATE_TRIGGER,
464
+ );
465
+ // In date mode the input's text comes from the trigger (the formatted Date, or
466
+ // the raw draft mid-typing) — never from `value`, which is a Date object whose
467
+ // stringification is both long and always truthy. Float the label off THAT
468
+ // string, so an empty date cell still rests its label inside like any other.
469
+ const boundValue = date ? trigger.displayValue : value;
470
+ const [isFocused, setIsFocused] = React.useState(false);
471
+ const [hasValue, setHasValue] = React.useState(
472
+ Boolean(boundValue ?? defaultValue) && String(boundValue ?? defaultValue).length > 0,
473
+ );
474
+
475
+ React.useEffect(() => {
476
+ if (boundValue !== undefined) {
477
+ setHasValue(Boolean(boundValue) && String(boundValue).length > 0);
478
+ }
479
+ }, [boundValue]);
480
+
481
+ // The unit is read with the value, ahead of the shared message (field-pair
482
+ // 1.12.0, the Unit Field suffix rule): "{unit-id} {helper-id}".
483
+ const unitId = unit ? `${resolvedId}-unit` : undefined;
484
+ const cellDescribedBy = [unitId, describedBy].filter(Boolean).join(' ') || undefined;
485
+ const hasPlaceholder = Boolean(placeholder) && String(placeholder).length > 0;
486
+ // Error floats the label even when empty (shared float rule) so it stays
487
+ // visible beside the reddened cell.
488
+ const floating = isFocused || hasValue || hasPlaceholder || error;
489
+ const iconSize: IconSize = size === 'sm' ? 'small' : 'default';
490
+ const labelStatus = error ? 'error' : 'default';
491
+ // The float is Text Field's cross-fade, inherited (_field-segment 1.9.1 motion).
492
+ const labelMotion = useFloatingLabelMotion(floating);
493
+ // The cell label recipe for a pose — shared by the label and the ghost of the
494
+ // pose it just left.
495
+ const cellLabelClass = (pose: boolean) => cn(
496
+ // `hasLeadingIcon` moves the label's inline start to where the value
497
+ // starts (--space-500 + icon + gap) in BOTH positions, so the glyph
498
+ // never sits under the resting label and floating stays a purely
499
+ // vertical move (_field-segment 1.6.0 slots.leading-icon).
500
+ floatingLabelVariants({ floating: pose, size, status: labelStatus, hasLeadingIcon: Boolean(date) }),
501
+ // field-pair label is --text-secondary (Text Field label is
502
+ // --text-primary); error keeps the danger colour from the variant.
503
+ // At rest this is the bound word (parts.bound-word, 1.13.0): the
504
+ // cell's only visible label, so never --text-placeholder.
505
+ labelStatus === 'default' && 'text-text-secondary',
506
+ // The outer border sits on the container, so a cell is inset 1px
507
+ // below it. Nudge the floated label up 1px so its opaque chip notch
508
+ // lands on the container border (parity with Text Field, where the
509
+ // label and border share the y=0 origin) — otherwise the top border
510
+ // shows through the label.
511
+ pose && '-mt-px',
512
+ );
513
+
514
+ // The status icon and the other end-glyph always sit on OPPOSITE ends — the
515
+ // Unit Field law (`unit-field.md` § Rationale 3), inherited by `_field-segment`
516
+ // 1.5.0. AMOUNT mode: the trailing end is permanently the Kč unit, so the
517
+ // status icon goes LEADING. DATE mode: the leading end holds the calendar, so
518
+ // it goes TRAILING (the Text Field position). No end ever carries two glyphs.
519
+ const statusIconLeading = Boolean(unit);
520
+ const statusIconEl = error ? (
521
+ <Icon name="warning-circle" size={iconSize} className="shrink-0 text-status-danger" />
522
+ ) : null;
523
+
524
+ const handleFocus = (e: React.FocusEvent<HTMLInputElement>) => {
525
+ setIsFocused(true);
526
+ onFocus?.(e);
527
+ };
528
+ const handleBlur = (e: React.FocusEvent<HTMLInputElement>) => {
529
+ setIsFocused(false);
530
+ setHasValue(Boolean(e.target.value));
531
+ onBlur?.(e);
532
+ };
533
+
534
+ const valueClassName = textFieldValueVariants({ state: 'default' });
535
+
536
+ const inputEl =
537
+ format === 'date' ? (
538
+ <input
539
+ id={resolvedId}
540
+ placeholder={placeholder}
541
+ aria-labelledby={cellLabelledBy}
542
+ aria-invalid={error || undefined}
543
+ aria-describedby={cellDescribedBy}
544
+ className={valueClassName}
545
+ ref={trigger.setInputRef}
546
+ // The trigger supplies value / onChange / onKeyDown / onBlur and the
547
+ // combobox ARIA, merging the cell's own handlers behind its own.
548
+ {...trigger.getInputProps({ onFocus: handleFocus, onBlur: handleBlur, ...inputProps })}
549
+ />
550
+ ) : format === 'number' ? (
551
+ <NumberFormatInput
552
+ id={resolvedId}
553
+ value={value}
554
+ defaultValue={defaultValue as string | number | undefined}
555
+ onValueChange={onValueChange}
556
+ locale={locale}
557
+ precision={precision}
558
+ fixedDecimals={fixedDecimals}
559
+ placeholder={placeholder}
560
+ aria-labelledby={cellLabelledBy}
561
+ aria-invalid={error || undefined}
562
+ aria-describedby={cellDescribedBy}
563
+ className={valueClassName}
564
+ onFocus={handleFocus}
565
+ onBlur={handleBlur}
566
+ // Remaining consumer DOM attrs (name, disabled, data-*, inputMode…) pass
567
+ // straight through; react-number-format narrows a few input attrs (`type`,
568
+ // `checked`), so cast the generic InputHTMLAttributes rest to its props.
569
+ {...(inputProps as NumberFormatInputProps)}
570
+ />
571
+ ) : (
572
+ <input
573
+ id={resolvedId}
574
+ value={value}
575
+ defaultValue={defaultValue}
576
+ placeholder={placeholder}
577
+ aria-labelledby={cellLabelledBy}
578
+ aria-invalid={error || undefined}
579
+ aria-describedby={cellDescribedBy}
580
+ className={valueClassName}
581
+ onFocus={handleFocus}
582
+ onBlur={handleBlur}
583
+ onChange={onChange}
584
+ {...inputProps}
585
+ />
586
+ );
587
+
588
+ return (
589
+ <>
590
+ {/* data-fods-part marks the parts the FODS verifier measures in the browser
591
+ (the field-pair parts map). Not inert in this package: `styles/base.css`
592
+ scopes its reset to these attributes.
593
+ In date mode the WHOLE CELL is the trigger — the cell padding is part of
594
+ it, not dead area — so the anchor ref and the open handler sit here, on
595
+ the same element, exactly as TextField type="date" puts them on its
596
+ field wrapper.
597
+ The leading calendar glyph is what SAYS so: `_field-segment` 1.6.0 gained
598
+ `slots.leading-icon`, and Field Pair turns it on in both cells in date
599
+ mode — without it the cell opens a Date Picker while looking inert. */}
600
+ <div
601
+ data-fods-part="segment"
602
+ {...(date ? trigger.triggerProps : {})}
603
+ className={cn(fieldSegmentVariants({ position }), className)}
604
+ >
605
+ {/* Decorative: the cell itself is the trigger, and the field's own label
606
+ is the accessible name — the same reasoning TextField type="date"
607
+ applies to its leading slot. */}
608
+ {date && (
609
+ <Icon
610
+ data-fods-part="leading-icon"
611
+ name="calendar-dots"
612
+ size={iconSize}
613
+ className={fieldSegmentLeadingIconVariants()}
614
+ />
615
+ )}
616
+ {statusIconLeading && statusIconEl}
617
+ {groupLabel && (
618
+ // The chip is the group legend followed, once the start cell floats, by
619
+ // that cell's own <label> (field-pair 1.11.0: `Cena od`). The legend
620
+ // truncates; the bound word never does. Capped inside the start cell:
621
+ // the end cell's bound word floats over the right half.
622
+ <span
623
+ data-fods-part="group-label"
624
+ className={cn(
625
+ floatingLabelVariants({
626
+ floating: true,
627
+ size,
628
+ status: groupLabel.error ? 'error' : 'default',
629
+ hasLeadingIcon: Boolean(date),
630
+ }),
631
+ !groupLabel.error && 'text-text-secondary',
632
+ '-mt-px flex',
633
+ date ? GROUP_LABEL_DATE_CAP[size] : GROUP_LABEL_AMOUNT_CAP,
634
+ )}
635
+ >
636
+ <span id={groupLabel.id} className="min-w-0 truncate">{groupLabel.text}</span>
637
+ {floating && label && (
638
+ // `whitespace-pre` keeps the word space a flex item would drop.
639
+ // The chip itself never moves, so the bound word only fades in — no
640
+ // settle. On the way back it leaves at once (no ghost inside the
641
+ // chip) while the resting label fades in.
642
+ <label
643
+ id={labelId}
644
+ htmlFor={resolvedId}
645
+ data-fods-part="label"
646
+ className={cn('shrink-0 whitespace-pre', labelMotion.swap && FLOATING_LABEL_ENTER.fade)}
647
+ onAnimationEnd={labelMotion.endEnter}
648
+ >
649
+ {' '}{label}
650
+ </label>
651
+ )}
652
+ </span>
653
+ )}
654
+ {/* The pose the cell label just left, fading out (Text Field cross-fade).
655
+ Only a resting pose in group mode: the floated bound word lives inside
656
+ the chip and simply leaves. */}
657
+ {label && labelMotion.swap?.ghost && !(groupLabel && labelMotion.swap.from) && (
658
+ <FloatingLabelGhost
659
+ key={labelMotion.swap.key}
660
+ text={label}
661
+ className={cellLabelClass(labelMotion.swap.from)}
662
+ onDone={labelMotion.endGhost}
663
+ />
664
+ )}
665
+ {label && !(groupLabel && floating) && (
666
+ <label
667
+ id={labelId}
668
+ htmlFor={resolvedId}
669
+ data-fods-part="label"
670
+ className={cn(
671
+ cellLabelClass(floating),
672
+ // The focus-widened chip notch (masking the ring) lives on the CELL as a
673
+ // `has-[:focus-visible]:[&>label]:...` rule — see fieldSegmentVariants.
674
+ // After a pose change the label plays Text Field's enter fade.
675
+ labelMotion.enterClass,
676
+ )}
677
+ onAnimationEnd={labelMotion.endEnter}
678
+ >
679
+ {label}
680
+ </label>
681
+ )}
682
+
683
+ {inputEl}
684
+
685
+ {unit && <span id={unitId} data-fods-part="suffix" className={fieldSegmentUnitVariants()}>{unit}</span>}
686
+ {!statusIconLeading && statusIconEl}
687
+ </div>
688
+ {/* A FloatingPortal — it renders outside the group (to <body>, or into an
689
+ enclosing dialog), so the group keeps exactly two element children.
690
+ Nothing may be added as a DOM sibling of the two cells: the Focus docs
691
+ story forces the ring through
692
+ `[role="group"] > div:last-child::before` (src/storybook/forceStates). */}
693
+ {date && trigger.panel}
694
+ </>
695
+ );
696
+ }
697
+
698
+ // -----------------------------------------------------------------------------
699
+
700
+ /**
701
+ * Split a cell into the props the segment renders and the config its trigger
702
+ * owns. In date mode `value` / `onValueChange` / `onInvalidInput` / `minDate` / `maxDate` MUST
703
+ * leave the segment props: a stray `value` (a Date object) would reach the
704
+ * native <input> and fight the trigger's own display string, freezing the field
705
+ * with no warning.
706
+ */
707
+ function splitDateCell(
708
+ cell: FieldPairCell | FieldPairDateCell,
709
+ common: Omit<FieldSegmentDateConfig, 'value' | 'onValueChange' | 'onInvalidInput' | 'minDate' | 'maxDate'> | undefined,
710
+ ): { cell: FieldPairCell; date?: FieldSegmentDateConfig } {
711
+ if (!common) return { cell: cell as FieldPairCell };
712
+ const { value, onValueChange, onInvalidInput, minDate, maxDate, ...rest } = cell as FieldPairDateCell;
713
+ return { cell: rest, date: { ...common, value, onValueChange, onInvalidInput, minDate, maxDate } };
714
+ }
715
+
716
+ export function FieldPair({
717
+ size = 'md',
718
+ from,
719
+ to,
720
+ showUnit = true,
721
+ unit,
722
+ format = 'text',
723
+ locale = 'cs',
724
+ precision = 0,
725
+ fixedDecimals = false,
726
+ dateFormat,
727
+ dateLocale,
728
+ panelLabel,
729
+ navLabels,
730
+ helperText,
731
+ error,
732
+ 'aria-label': ariaLabel,
733
+ 'aria-labelledby': ariaLabelledby,
734
+ label,
735
+ id,
736
+ className,
737
+ }: FieldPairProps) {
738
+ const generatedId = React.useId();
739
+ const baseId = id ?? generatedId;
740
+ const fromId = `${baseId}-from`;
741
+ const toId = `${baseId}-to`;
742
+ // A blank `label` passes the type union but names nothing: treat it as absent, so
743
+ // the group neither points aria-labelledby at an empty chip nor renders one.
744
+ const hasLabel = typeof label === 'string' ? label.trim() !== '' : Boolean(label);
745
+ const labelId = hasLabel ? `${baseId}-label` : undefined;
746
+
747
+ // The types forbid omitting every name source, but not an EMPTY one
748
+ // (`label=""`, `aria-label=""`) — a nameless group is a defect. Checked in an
749
+ // effect, so it warns once per change of the name sources, not on every render.
750
+ React.useEffect(() => {
751
+ if (process.env.NODE_ENV === 'production') return;
752
+ const named = [label, ariaLabel, ariaLabelledby].some(
753
+ source => typeof source === 'string' && source.trim() !== '',
754
+ );
755
+ if (!named) {
756
+ console.warn('FieldPair: no accessible name — pass a non-empty `label`, `aria-label` or `aria-labelledby`.');
757
+ }
758
+ }, [label, ariaLabel, ariaLabelledby]);
759
+
760
+ // Trimmed, not nullish-checked: a form binding `error={errors.range}` hands over
761
+ // an EMPTY STRING when there is no error, which `??` treats as a real message.
762
+ // That silently suppressed the helper text and left aria-describedby undefined
763
+ // on both cells for as long as the field was valid.
764
+ const activeError = error?.trim() ? error : undefined;
765
+ const displayMessage = activeError ?? helperText;
766
+ const helperId = displayMessage ? `${baseId}-helper` : undefined;
767
+ const helperState = activeError ? 'error' : 'default';
768
+
769
+ const hasError = Boolean(from.error || to.error);
770
+ const cellUnit = showUnit ? unit : undefined;
771
+ // Number-format config shared by both cells (used only when format="number").
772
+ const numberProps = { format, locale, precision, fixedDecimals };
773
+ // Panel config shared by both cells — the two PANELS stay independent, only
774
+ // their accessible names are shared (never both open at once).
775
+ // Date mode is decided by `format` alone; its required config is checked, not
776
+ // silently treated as "not a date pair" (a JS consumer or an empty string
777
+ // would otherwise get a plain text pair with no word of why).
778
+ const dateConfigComplete = Boolean(dateFormat && dateLocale && navLabels);
779
+ React.useEffect(() => {
780
+ if (process.env.NODE_ENV === 'production' || format !== 'date' || dateConfigComplete) return;
781
+ // eslint-disable-next-line no-console
782
+ console.error(
783
+ 'FieldPair format="date": `dateFormat`, `dateLocale` and `navLabels` are required — '
784
+ + 'the cells render as plain text inputs until all three are set.',
785
+ );
786
+ }, [format, dateConfigComplete]);
787
+ const dateCommon =
788
+ format === 'date' && dateFormat && dateLocale && navLabels
789
+ ? { dateFormat, locale: dateLocale, panelLabel, navLabels }
790
+ : undefined;
791
+ const fromCell = splitDateCell(from, dateCommon);
792
+ const toCell = splitDateCell(to, dateCommon);
793
+
794
+ return (
795
+ <div className={cn('relative flex w-full flex-col', className)}>
796
+ <div
797
+ role="group"
798
+ aria-label={ariaLabel}
799
+ aria-labelledby={labelId ?? ariaLabelledby}
800
+ data-fods-component="field-pair"
801
+ data-fods-part="container"
802
+ className={fieldPairContainerVariants({ size, state: hasError ? 'error' : 'default' })}
803
+ >
804
+ <FieldSegment
805
+ {...fromCell.cell}
806
+ {...numberProps}
807
+ date={fromCell.date}
808
+ groupLabelId={labelId}
809
+ groupLabel={label && labelId ? { id: labelId, text: label, error: hasError } : undefined}
810
+ unit={cellUnit}
811
+ size={size}
812
+ position="start"
813
+ inputId={fromId}
814
+ describedBy={helperId}
815
+ />
816
+ <FieldSegment
817
+ {...toCell.cell}
818
+ {...numberProps}
819
+ date={toCell.date}
820
+ groupLabelId={labelId}
821
+ unit={cellUnit}
822
+ size={size}
823
+ position="end"
824
+ inputId={toId}
825
+ describedBy={helperId}
826
+ />
827
+ </div>
828
+
829
+ {/* Always mounted as a polite live region (text-field 2.9.1 § Announcement,
830
+ shared by the field family): a region inserted together with its text is
831
+ not announced. Empty when there is no message; `empty:mt-0` in the recipe
832
+ drops the gap. Never role="alert" — assertive interrupts typing. */}
833
+ <div
834
+ id={`${baseId}-helper`}
835
+ aria-live="polite"
836
+ className={helperTextVariants({ state: helperState, size })}
837
+ >
838
+ {displayMessage}
839
+ </div>
840
+ </div>
841
+ );
842
+ }
843
+ FieldPair.displayName = 'FieldPair';
844
+
845
+ export { fieldPairContainerVariants, fieldSegmentVariants };