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