@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,20 @@
1
+ export {
2
+ FieldGroup,
3
+ FieldSet,
4
+ FieldLegend,
5
+ FieldSeparator,
6
+ Field,
7
+ fieldGroupVariants,
8
+ fieldSetVariants,
9
+ fieldLegendVariants,
10
+ fieldSeparatorVariants,
11
+ floatingLabelVariants,
12
+ optionalLabelVariants,
13
+ helperTextVariants,
14
+ type FieldGroupProps,
15
+ type FieldSetProps,
16
+ type FieldLegendProps,
17
+ type FieldSeparatorProps,
18
+ type FieldProps,
19
+ type FieldSize,
20
+ } from './Field';
@@ -0,0 +1,312 @@
1
+ import { Meta, Canvas, Controls } from '@storybook/addon-docs/blocks';
2
+ import * as FieldPairStories from './FieldPair.stories';
3
+
4
+ <Meta of={FieldPairStories} tags={['autodocs']} />
5
+
6
+ # FieldPair
7
+
8
+ ## Metadata
9
+
10
+ - **Layer:** molecule
11
+ - **Status:** stable
12
+ - **Tokens used:** `--bg-primary`, `--border-width-100`, `--border-width-200`, `--disabled-foreground`, `--font-body`, `--font-size-base`, `--font-size-heading-h5`, `--font-size-sm`, `--font-size-xs`, `--font-size-xxs`, `--font-weight-bold`, `--font-weight-normal`, `--leading-loose`, `--leading-relaxed`, `--outline-default`, `--outline-focus`, `--outline-strong`, `--radius-200`, `--radius-400`, `--radius-500`, `--space-1000`, `--space-1100`, `--space-200`, `--space-300`, `--space-400`, `--space-500`, `--space-700`, `--space-800`, `--status-danger`, `--status-success-tint-foreground`, `--text-placeholder`, `--text-primary`, `--text-secondary`, `--text-wrap-body`, `--z-index-base`
13
+ - **Manifest version:** `1.13.3`
14
+
15
+ ## Overview
16
+
17
+ A **FieldPair** is two fused fields that read as **one bounded range** (od–do). Use it for a single logical range: a date range (the invoice-list **Od / Do** filter) or a min–max amount / number range. The two values belong together, so the pair reads and validates as one control.
18
+
19
+ Do **not** use it for two *unrelated* fields (use two Text Fields), for 3+ inputs (that is a form), or for two cells of different types (date + text).
20
+
21
+ <Canvas of={FieldPairStories.Playground} />
22
+
23
+ ## Rationale
24
+
25
+ FieldPair promotes the from–to relationship rather than reinventing the field:
26
+
27
+ 1. **One control, not two.** The two inputs are fused — one shared border, one 1px divider — exactly the **Button Group** scheme, so the pair reads as a single range instead of two coincidental fields.
28
+ 2. **Shared message, per-cell state.** Validation is a pair concern: one shared helper line carries the message, the offending cell reds (so the user sees *which* bound is wrong), and a cross-field error (Od after Do) reds both.
29
+ 3. **Reuse, not reinvention.** The cells reuse the Text Field internals + tokens (floating label, value text, helper line). A Text Field / Field change reaches the pair — composition by reference.
30
+
31
+ ## Anatomy
32
+
33
+ - **Container** — owns the outline (<code>--border-width-100</code>, <code>--outline-default</code>), radius <code>--radius-400</code>, and a fill of <code>--outline-default</code> so the 1px gap between the cells reads as the **divider** (Button Group pattern). Does not clip — floated labels render above the top border. Fixed height (Medium 48 / Small 40). On error the container border + divider go <code>--status-danger</code>.
34
+ - **Field Segment cell (`Od` / `Do`)** — each is a borderless field cell: equal halves, fill <code>--bg-primary</code>, outer corners rounded by position (start rounds the left, end the right) at the container's **inner** radius, <code>--radius-400</code> − <code>--border-width-100</code> = 7 (manifest `parts.cell.geometry`) — a cell at the full 8 would leave a sliver of the container fill in each corner. Each carries a floating label (<code>--text-secondary</code>, floats on value/focus/error) + value text (Body/M/Regular) + a status icon on error — **leading** in amount mode (the trailing end holds the unit), **trailing** in date mode (the leading end holds the calendar). Padding <code>--space-500</code>.
35
+ - **Divider** — the 1px gap between the cells; no node, just the container fill showing through.
36
+ - **Group label** *(optional, `label` — manifest `Show label`, off by default)* — one floated label on the container's top border over the start cell, same chip as the cell labels (<code>--text-secondary</code>, <code>--status-danger</code> when either cell errors). The cells keep floating their own (lowercase) bound words; the start cell's floats **into** this chip (`Cena od`). See [Group label](#group-label--the-filter-bar).
37
+ - **Shared helper / error** — one message below the pair (Body/XS/Regular, wraps, never truncated), gap <code>--space-400</code>; <code>--status-danger</code> on error.
38
+
39
+ ## Variants
40
+
41
+ <Canvas of={FieldPairStories.Variants} />
42
+
43
+ <table>
44
+ <thead>
45
+ <tr><th>Variant</th><th>When</th><th>Tokens</th></tr>
46
+ </thead>
47
+ <tbody>
48
+ <tr>
49
+ <td><code>showUnit</code> (default, True) + a <strong>required</strong> <code>unit</code></td>
50
+ <td>Min–max amount range (e.g. 100–5000 Kč) — the unit is a variant axis, not a boolean adornment. The two are paired in the type: switching the affix on without wording for it does not compile, and there is no built-in <code>Kč</code> (the design system is locale-agnostic)</td>
51
+ <td>unit suffix <code>--text-placeholder</code> (one tier below the value, same rule as Unit Field)</td>
52
+ </tr>
53
+ <tr>
54
+ <td><code>showUnit=&#123;false&#125;</code></td>
55
+ <td>Date range (Od / Do) — pass explicitly to drop the unit</td>
56
+ <td>value <code>--text-primary</code>, label <code>--text-secondary</code></td>
57
+ </tr>
58
+ <tr>
59
+ <td><code>format="number"</code></td>
60
+ <td>Amount / number range — swaps both cells for a locale-aware number input (thousand separators, decimals). Default <code>format="text"</code> for dates / text.</td>
61
+ <td>value <code>--text-primary</code>; formatting via <code>NumberFormatInput</code></td>
62
+ </tr>
63
+ <tr>
64
+ <td><code>format="date"</code> (+ required <code>dateFormat</code> / <code>dateLocale</code> / <code>navLabels</code>, none defaulted; optional <code>panelLabel</code>)</td>
65
+ <td>Date range — each cell becomes its own trigger opening its own single-month Date Picker. The type pairs it with <code>showUnit=&#123;false&#125;</code>. The market's <code>dateFormat</code> (date-fns pattern) and <code>dateLocale</code> (date-fns <code>Locale</code>) apply to both cells; there is no Czech default. See <a href="#date-mode--one-picker-per-cell">Date mode</a>.</td>
66
+ <td>value <code>--text-primary</code>; panel per <code>DatePicker</code></td>
67
+ </tr>
68
+ <tr>
69
+ <td><code>label</code> (manifest <code>Show label</code>)</td>
70
+ <td>Filter bar — one group label (<code>Cena</code>) on the top border over the start cell; the cells keep their lowercase bound words <code>od</code> / <code>do</code> as real labels on the shared float rule. Replaces <code>aria-label</code> / <code>aria-labelledby</code> as the group name. See <a href="#group-label--the-filter-bar">Group label</a>.</td>
71
+ <td>label <code>--text-secondary</code>, error <code>--status-danger</code>; resting bound word <code>--text-secondary</code></td>
72
+ </tr>
73
+ <tr>
74
+ <td>Shared <code>helperText</code> / <code>error</code></td>
75
+ <td>One message line under the pair; <code>error</code> replaces the helper</td>
76
+ <td>default <code>--text-secondary</code>, error <code>--status-danger</code></td>
77
+ </tr>
78
+ </tbody>
79
+ </table>
80
+
81
+ The full Size × Show unit grid (mirrors the Figma labelled matrix):
82
+
83
+ <Canvas of={FieldPairStories.Matrix} />
84
+
85
+ ### Group label — the filter bar
86
+
87
+ `label` (manifest `Show label`) puts **one** floated label on the container's top border over the start cell — as in a filter bar: `Cena` on the border, `od` / `do` in the cells, `Kč` still visible. The label names the **quantity only** — `Cena`, `Období`, never `Cena od / do`; the bound words stay with the cells. A filled pair reads `Cena od 10 000 Kč · do 120 000 Kč`.
88
+
89
+ - **The cells keep the shared float rule** (1.11.0). An empty, calm cell rests its bound word inside — a real `<label>` in <code>--text-secondary</code>, never a placeholder (manifest `parts.bound-word`, 1.13.0). Once the cell has a value, focus or an error the word floats: the **start** cell's word floats **into** the group chip (`Cena od` — the legend followed by that cell's own `<label>` element), the **end** cell's floats on its own (`do`). Write the bound words **lowercase** in this mode — they continue the group label.
90
+ - **Names.** The group points at the legend with `aria-labelledby`, so it is named „Cena“ and the type rejects `aria-label` / `aria-labelledby` next to `label`. Each input is named `aria-labelledby="{group label} {own label}"` — „Cena od“, „Cena do“ — so the accessible name contains the visible chip text (WCAG 2.5.3). Both cell labels are required whenever `label` is set.
91
+ - **One line, inside the start cell.** The chip never runs past the start cell's end padding (amount mode: the Text Field cap, cell − 24; date mode: from past the calendar glyph to the cell's end padding), because the end cell's word floats over the right half. A long market string truncates with an ellipsis; the start cell's bound word, once it joins the chip, always stays visible (`Fakturovaná čá… od`).
92
+ - **Same chip, same mask.** It is rendered by the start cell with the cell labels' `floatingLabelVariants` recipe (incl. the date-mode offset past the calendar glyph, so it starts at the same x as a cell label), and it paints above the focused cell, so the start cell's ring is masked under the whole chip, `Cena` included. It reds with the container when either cell errors; a floated `od` inside it takes the same ink.
93
+
94
+ <Canvas of={FieldPairStories.GroupLabel} />
95
+
96
+ ### Date mode — one picker per cell
97
+
98
+ `format="date"` makes each cell behave like a **standalone date Text Field**: tapping it opens its **own Single month** [`DatePicker`](?path=/docs/design-system-molecules-datepicker--docs). There is no shared calendar between the two cells and no cross-field `minDate` / `maxDate` — the range is two independent dates that happen to sit in one control. Per-cell `minDate` / `maxDate` are still available; they bound **that cell's** panel only. An invalid range (Do before Od) is reported, not prevented: flag both cells and put the message in the shared `error`, exactly as [States](#states) shows.
99
+
100
+ That is deliberate, not a simplification: this pair **is** the mobile substitute for DatePicker's Dual month range mode, which has no mobile treatment at all (its ~760px minimum does not fit a phone viewport). A shared dual calendar is exactly what cannot be rendered there.
101
+
102
+ **The swap is not automatic** — nothing in this component or in `DatePicker` reads the viewport. The spec puts it in the consuming form (*"a breakpoint-level change in the consuming form, not a Date Picker variant"*), because the two forms hold different data: one `DateRange` there, two independent dates here. The recipe, with the first-paint caveat, is in [DatePicker → Who does the swap](?path=/docs/design-system-molecules-datepicker--docs#who-does-the-swap).
103
+
104
+ <Canvas of={FieldPairStories.DateRange} />
105
+
106
+ A few things about the opt-in, the contract and the anatomy are easy to get wrong:
107
+
108
+ - **It is `format="date"`, not `showUnit={false}`.** The spec phrases the condition as *"Show unit=False **and the pair represents a date range**"* — two conditions, and Figma can only carry the first (it has no cell-type axis). `showUnit={false}` already covers a plain text range and a plain number range, neither of which may silently grow a calendar. The type still enforces the spec's coupling one-directionally: `format="date"` requires `showUnit={false}`.
109
+ - **`dateFormat`, `dateLocale` and `navLabels` are required and never defaulted**, the same contract a standalone [`TextField type="date"`](?path=/story/design-system-atoms-textfield--date-mode) carries — the design system is locale-agnostic. `dateFormat` (the market's date-fns pattern, e.g. `dd. MM. yyyy` or `MM/dd/yyyy`) and `dateLocale` (the market's date-fns `Locale`: parsing, week start, month and weekday names) apply to both cells; the market comes from the consumer, never a Czech default ([another market](?path=/story/design-system-atoms-textfield--date-other-market)). It is `dateLocale`, not `locale`, because `locale` here is already the number formatter's locale string. Each cell's calendar dialog is named by `aria-labelledby` with the same ids that name its input: the cell's own label („Od“), or, under a group label, the group label followed by the cell's label („Období do“). `panelLabel` is optional: it names the dialog only for a cell with no visible label, before that cell's own `aria-label`. A dialog left with no name at all warns in development, and a date pair missing `dateFormat`, `dateLocale` or `navLabels` logs an error and renders plain text cells. `navLabels` are shared by both panels, and only one panel is ever open.
110
+ - **Per-cell `onInvalidInput(raw, reason)`.** A date cell (`from` / `to`) takes its own `onInvalidInput`, the same contract as `TextField type="date"`: when a typed draft is rejected on commit (blur or Enter) it receives the raw text and `'unparseable'` (the draft does not parse with `dateFormat`) or `'out-of-range'` (outside that cell's `minDate` / `maxDate`). The typed text stays in the cell and the cell's value becomes `undefined`: `onValueChange(undefined)` comes first, unless the value already was `undefined`. Enter commits the draft before a form submits, and a native form reset drops it; setting the cell's `value` to `undefined` does not, because it already is `undefined` (reset the form or remount with a new `key`).
111
+ - **A leading calendar glyph, like the standalone `TextField type="date"`.** `_field-segment` 1.6.0 gained `slots.leading-icon`, and Field Pair turns it on in **both** cells in date mode — the cell opens a Date Picker, so it has to say so; before the slot existed it looked completely inert. The glyph shifts the **content**, not the shell: `paddingX` stays `--space-500` and the label *and* the value both start at `--space-500 + icon + gap`, so the label never sits under the glyph and floating stays a purely vertical move. The whole cell is still the trigger: click anywhere in it, or `ArrowDown` from the keyboard.
112
+ - **In date mode the status icon moves to the trailing end.** The status glyph and the other end-glyph always sit on opposite ends (the Unit Field law, inherited by `_field-segment`): in **amount** mode the trailing end is permanently the `Kč` unit, so the error icon goes **leading**; in **date** mode the leading end holds the calendar, so it goes **trailing** — Text Field's position. No end ever carries two glyphs.
113
+
114
+ ### Number formatting
115
+
116
+ `format="number"` (opt-in) renders both cells with `NumberFormatInput` (the same locale-aware core as UnitField): the cell value is a raw number, formatted on render (cs: space thousand separator, comma decimals) and read back via `from.onValueChange` / `to.onValueChange` (`values.floatValue`). Shared config `locale` / `precision` / `fixedDecimals` applies to both cells; default `precision={0}` = integers with grouping (`5 000`), pass `precision={2}` `fixedDecimals` for money. Dates / free text keep the default `format="text"` plain input.
117
+
118
+ <Canvas of={FieldPairStories.NumberFormat} />
119
+
120
+ ## Sizes
121
+
122
+ <Canvas of={FieldPairStories.Sizes} />
123
+
124
+ <table>
125
+ <thead>
126
+ <tr><th>Size</th><th style={{ textAlign: 'right' }}>Height</th><th>Padding (X)</th><th style={{ textAlign: 'right' }}>Icon</th><th>Radius</th><th>When</th></tr>
127
+ </thead>
128
+ <tbody>
129
+ <tr>
130
+ <td><code>md</code> (default)</td>
131
+ <td style={{ textAlign: 'right' }}>48</td>
132
+ <td><code>--space-500</code></td>
133
+ <td style={{ textAlign: 'right' }}>24</td>
134
+ <td><code>--radius-400</code></td>
135
+ <td>Forms</td>
136
+ </tr>
137
+ <tr>
138
+ <td><code>sm</code></td>
139
+ <td style={{ textAlign: 'right' }}>40</td>
140
+ <td><code>--space-500</code></td>
141
+ <td style={{ textAlign: 'right' }}>20</td>
142
+ <td><code>--radius-400</code></td>
143
+ <td>Filters / toolbars (the invoice-list filter bar)</td>
144
+ </tr>
145
+ </tbody>
146
+ </table>
147
+
148
+ Width is layout — the pair fills its column; each cell is an equal half. Inside the 1px edge the cells are 46 (`md`) / 38 (`sm`) tall, so **on touch use `md`** — `sm` is the desktop filter-bar density.
149
+
150
+ ## States
151
+
152
+ <Canvas of={FieldPairStories.States} />
153
+
154
+ States are **per-cell**, not a molecule-level matrix. Each Field Segment carries Default / Error; the container reddening is owned by the pair.
155
+
156
+ - **Default** — <code>--outline-default</code> container border + divider; empty cell rests its bound word inside (<code>--text-secondary</code> — the cell's only visible label, so never the <code>--text-placeholder</code> exception; manifest `parts.bound-word`), filled cell floats the label.
157
+ - **Focused** — a runtime per-cell <code>:focus-visible</code> **offset** ring (2px <code>--outline-focus</code>, 2px outside), rendered as a <code>::before</code> pseudo-element (not <code>outline</code>, which would paint over the label) following the cell radius: rounded outer corners, ~radius-200 at the divider. The focused cell raises <code>z-index</code> (base + 1) so the ring paints above the divider / neighbour, and the floating label's opaque <code>--bg-primary</code> chip masks the ring at the top edge (source order). Code-only — **not** a Figma variant. Container / divider are unchanged.
158
+ - **Error · per-cell** — the offending cell reds (label <code>--status-danger</code> + the <code>warning-circle</code> icon — leading in amount mode, trailing in date mode), the container border + divider red, and the shared helper shows the message. The label floats even when the cell is empty (shared float rule).
159
+ - **Error + focus** — the documented **exception** to the Text Field rule. The cell's offset <code>--outline-focus</code> ring is additive and simply sits 2px outside the red container border, which keeps <code>--status-danger</code> at <code>--border-width-100</code> — no thickening. The Text Field rule (keep <code>--status-danger</code>, thicken to <code>--border-width-200</code>) is for border-swap shells; a ring-style control composes instead.
160
+ - **Error · range** (Od after Do) — **both** cells red + a range message in the shared helper.
161
+ - **Disabled / Success** — deferred at the cell level (the range needs only Default + Error today).
162
+
163
+ The ring is a runtime `:focus-visible` state, so the States canvas above cannot show it —
164
+ this one forces it statically on the „Do“ cell instead:
165
+
166
+ <Canvas of={FieldPairStories.Focus} />
167
+
168
+ **Motion.** The pair adds none of its own (manifest 1.13.2 `motion.none`: „the pair adds no animation around its
169
+ segments") and inherits `_field-segment`, which inherits Text Field's floating-label motion: a cell's label cross-fades
170
+ between its resting and floated pose (resting copy out on `--duration-fast` + `--easing-exit`, the new pose in on
171
+ `--duration-normal` + `--easing-enter`, the floated one settling `--space-200`) through the shared
172
+ `internal/floatingLabelMotion.tsx`, and swaps at once under `prefers-reduced-motion`. The focus ring, the container
173
+ border and the divider are not transitioned. Details: [Text Field → States → Motion](?path=/docs/design-system-atoms-textfield--docs).
174
+
175
+ ## API
176
+
177
+ <Controls />
178
+
179
+ ## Do / Don't
180
+
181
+ - ✅ Use for a single bounded range (od–do dates, min–max amount).
182
+ - ✅ Keep both cells the same **type and size**.
183
+ - ✅ Put the range error in the shared `error` message; flag the offending cell via `from.error` / `to.error` (a range error reds both).
184
+ - ✅ Always name the group — `aria-label`, `aria-labelledby` pointing at a heading, or a visible group `label`. Per-cell labels name the inputs, not the group; the contract requires one of the three.
185
+ - ✅ Name the quantity in the group label (`Cena`); keep the bound words in the cells, lowercase (`od` / `do`) so the border reads `Cena od … do …`.
186
+ - ✅ Pass a message in `error` whenever a cell is in error — the message is the error's only text.
187
+ - ❌ Don't write `Cena od / do` in the group label.
188
+ - ❌ Don't cram 3+ inputs into one fused control — that's a form.
189
+ - ❌ Don't mix types (date + text) across the two cells.
190
+ - ❌ Don't show two separate helper lines.
191
+ - ❌ Don't use it where two *unrelated* fields belong — use two Text Fields.
192
+
193
+ ## Accessibility
194
+
195
+ - **Semantics** — the container is `role="group"` with a **required** accessible name (`aria-label`, `aria-labelledby`, or the visible group `label`, which the group references via `aria-labelledby`; a `role="group"` does not inherit a name from the per-cell `<label>`s); the divider is decorative. Each cell's input is named by its own `<label>` („Od“ / „Do“). With a group label each input is named `aria-labelledby="{group label} {own label}"` („Cena od“, „Cena do“), so the name contains the visible chip text (WCAG 2.5.3); the legend id is `<id>-label`, a cell label's `<id>-from-label` / `<id>-to-label` (derived from `id` or `useId`). The start cell's word is drawn inside the group chip but stays its own element.
196
+ - **Keyboard** — Tab moves Od → Do → next; each cell is independently focusable (the focused cell raises `z-index` so its ring paints above the neighbour).
197
+ - **Focus** — a per-cell `:focus-visible` offset ring (2px <code>--outline-focus</code>, 2px outside) rendered as a <code>::before</code> pseudo-element; the floating label's opaque backing masks the ring at the top edge so it never crosses the label.
198
+ - **State & ARIA** — each cell is a real `<input>` with its own `aria-invalid`; the SINGLE shared message is referenced by BOTH cells via `aria-describedby`. In amount mode the cell's unit comes first, `aria-describedby="{unit-id} {helper-id}"`, so `Kč` is read with the value and never sits in the input's `value` (the [Unit Field](?path=/docs/design-system-atoms-unitfield--docs) suffix rule). The message line is always mounted as a polite live region (Text Field's message line) and fills when a message arrives. Error is signalled by colour AND the `warning-circle` status icon (WCAG 1.4.1 — not colour alone) AND the message: a cell in error always needs `error` text.
199
+ - **1px cell gap** — the divider is the fused-segments exception shared with Button Group and Split Button: the cells read as one control, and each cell's focus ring is drawn outside the pair.
200
+ - **Date mode** — each cell's input is `role="combobox" aria-haspopup="dialog"` (APG Date Picker Combobox) with its **own** `aria-expanded` / `aria-controls`; the two panels are fully independent and only one is ever open. Each dialog is named by `aria-labelledby` pointing at what names its cell („Od“, or „Období do“ under a group label); `panelLabel` is the `aria-label` fallback for a cell with no visible label. `ArrowDown` opens the panel and moves focus onto a day (the grid keeps a single tabstop); a click opens it but leaves the caret in the input, so the cell stays typeable. `Escape` and an outside click dismiss and return focus to the cell. A cell that receives `readOnly` is a plain textbox (no combobox role, no popup), since its panel never opens; a `disabled` cell keeps the combobox role. If a cell becomes `disabled` or `readOnly` while its panel is open, the panel closes on that render. The shared `aria-describedby` still reaches both cells.
201
+ - **Contrast** — a bound word is never placeholder-only. Floated or resting, it is <code>--text-secondary</code> (claudy/600, 6.45:1): at rest it is the cell's only visible label, so the <code>--text-placeholder</code> exception (2.71:1, which rests on a floating label duplicating the placeholder) does not apply (manifest `parts.bound-word`). The `Kč` suffix keeps the Unit Field exception. The old <code>--text-tertiary</code> was sub-AA (deprecated 2026-07-08).
202
+
203
+ Accessibility floor for every FODS component: `spec/01-foundations/accessibility.md`.
204
+
205
+ ## Copy
206
+
207
+ Voice: the field copy rules of [TextField](?path=/docs/design-system-atoms-textfield--docs) — impersonal, Czech first, with the label / placeholder / helper / error patterns of a single field. Only the pair-specific rules follow.
208
+
209
+ - **Cell label** (`from.label` / `to.label`) — the bound word: short, parallel nouns for the two bounds, kept symmetrical — `Od` / `Do` for a date range, `Min` / `Max` for an amount range. With a group label, write them lowercase (`od` / `do`): they continue the group label (`Cena od … do …`). One line, max 12 characters, truncates.
210
+ - **Group label** (`label`) — names the quantity only (`Cena`, `Období`), not the bounds; the bound words stay with the cells. A filled pair reads `Cena od 10 000 Kč · do 120 000 Kč`, and the `Kč` unit stays visible in both cells. One line that stays inside the left cell (in amount mode never wider than the left cell minus 24px); a long string truncates with an ellipsis, and the left cell's bound word always stays visible once it joins the chip (`Fakturovaná čá… od`).
211
+ - **Helper** (`helperText`) — one shared message below the pair, per-cell or for the range. Wraps, max 120 characters.
212
+ - **Error** (`error`) — replaces the helper; impersonal. A per-cell error names the bad bound; a range error states the relationship between the bounds. One shared message — never two. Wraps and stays fully visible (WCAG 3.3.1), max 140 characters.
213
+
214
+ <table>
215
+ <thead>
216
+ <tr><th>Run</th><th>Canonical text</th><th>When</th></tr>
217
+ </thead>
218
+ <tbody>
219
+ <tr><td>Cell label</td><td><code>Od</code> / <code>Do</code></td><td>Date range</td></tr>
220
+ <tr><td>Cell label</td><td><code>Min</code> / <code>Max</code></td><td>Amount range</td></tr>
221
+ <tr><td>Cell label</td><td><code>od</code> / <code>do</code></td><td>With a group label</td></tr>
222
+ <tr><td>Group label</td><td><code>Cena</code>, <code>Období</code></td><td>Filter bar</td></tr>
223
+ <tr><td>Error</td><td>Neplatné datum „Od“</td><td>Per-cell error</td></tr>
224
+ <tr><td>Error</td><td>„Od“ musí být před „Do“</td><td>Range error</td></tr>
225
+ </tbody>
226
+ </table>
227
+
228
+ ## Usage
229
+
230
+ ```tsx
231
+ // Good — a date range: each cell opens its OWN single-month picker. The cell
232
+ // value is a Date; dateFormat/dateLocale (the market's, no default) and
233
+ // navLabels are required (locale-agnostic component); the labelled cells
234
+ // name their calendars, so panelLabel is not needed
235
+ <FieldPair
236
+ format="date"
237
+ showUnit={false}
238
+ dateFormat="dd. MM. yyyy"
239
+ dateLocale={cs} // import { cs } from 'date-fns/locale/cs'
240
+ navLabels={navLabels}
241
+ aria-label="Datum vystavení"
242
+ from={{ label: 'Od', value: from, onValueChange: setFrom }}
243
+ to={{ label: 'Do', value: to, onValueChange: setTo }}
244
+ />
245
+
246
+ // Good — a plain text range; showUnit={false} alone never mounts a calendar
247
+ <FieldPair
248
+ showUnit={false}
249
+ aria-label="Rozsah"
250
+ from={{ label: 'Od', value: from, onChange: (e) => setFrom(e.target.value) }}
251
+ to={{ label: 'Do', value: to, onChange: (e) => setTo(e.target.value) }}
252
+ />
253
+
254
+ // Good — a min–max amount range: format="number" + unit suffix; value is a raw
255
+ // number, read back via onValueChange (values.floatValue)
256
+ <FieldPair
257
+ showUnit
258
+ unit="Kč"
259
+ format="number"
260
+ aria-label="Částka"
261
+ from={{ label: 'Od', value: min, onValueChange: (v) => setMin(v.floatValue) }}
262
+ to={{ label: 'Do', value: max, onValueChange: (v) => setMax(v.floatValue) }}
263
+ />
264
+
265
+ // Good — a filter bar: one group label names the quantity; the lowercase bound
266
+ // words float on their own (`od` into the chip → „Cena od"), so both are required
267
+ <FieldPair
268
+ size="sm"
269
+ showUnit
270
+ unit="Kč"
271
+ format="number"
272
+ label="Cena"
273
+ from={{ label: 'od', value: min, onValueChange: (v) => setMin(v.floatValue) }}
274
+ to={{ label: 'do', value: max, onValueChange: (v) => setMax(v.floatValue) }}
275
+ />
276
+
277
+ // Good — a range error reds both cells and carries one shared message
278
+ <FieldPair
279
+ showUnit={false}
280
+ aria-label="Rozsah"
281
+ from={{ label: 'Od', value: from, error: true }}
282
+ to={{ label: 'Do', value: to, error: true }}
283
+ error='„Od" musí být před „Do".'
284
+ />
285
+
286
+ // Don't — two unrelated fields are not a range; use two Text Fields
287
+ <FieldPair
288
+ from={{ label: 'IČO' }}
289
+ to={{ label: 'E-mail' }}
290
+ />
291
+ ```
292
+
293
+ ## Related
294
+
295
+ - **[TextField](?path=/docs/design-system-atoms-textfield--docs)** — the standalone bordered field; FieldPair reuses its internals.
296
+ - **[UnitField](?path=/docs/design-system-atoms-unitfield--docs)** — same `--text-placeholder` rule for the unit suffix.
297
+ - **[Field](?path=/docs/design-system-atoms-field--docs)** — the floating-label / helper primitive the cells compose.
298
+ - **[TextField `type="date"`](?path=/story/design-system-atoms-textfield--date-mode)** — the standalone date field; a date-mode cell is the same behaviour in a borderless shell (same leading glyph, but an offset `::before` ring instead of the border swap).
299
+ - **[DatePicker](?path=/docs/design-system-molecules-datepicker--docs)** — the panel each date cell opens; its Dual month mode is what this pair replaces on mobile.
300
+ - Spec: `spec/04-molecules/field-pair.md`
301
+
302
+ ## Migration notes
303
+
304
+ - **«Cena od» chip contract (manifest 1.13.3, 2026-11-09) — documentation only.** The manifest is the contract for the group chip: the chip is the legend followed by the start cell's own `<label>` (see Variants → group label). No code change.
305
+ - **Motion (manifest 1.13.2, 2026-11-03).** The pair is declared static and delegates its floating-label motion to
306
+ `_field-segment` → Text Field; the cells already cross-fade through the shared floating-label motion (the old
307
+ `SEGMENT_LABEL_TRANSITION` is gone, see Text Field 2.14.0). No further code change.
308
+ - **Supersedes** the loose `Od` / `Do` pair in the invoice-list filter — render it as one FieldPair (`size="sm"`) so the two bounds are one control.
309
+ - **`--text-tertiary` deprecated 2026-07-08** — the floating / resting cell label moved to <code>--text-secondary</code> (claudy/600, AA); the old claudy/400 was sub-AA. A consumer `placeholder` stays <code>--text-placeholder</code>.
310
+ - **Group-label mode (1.11.0 / 1.13.0)** — the cells no longer turn their labels into placeholders + `aria-label`s: the bound words stay real labels on the shared float rule (`od` into the chip, `do` on its own), the inputs are named „Cena od“ / „Cena do“ via `aria-labelledby`, and the resting word is <code>--text-secondary</code>. Pass the bound words lowercase.
311
+ - **Amount mode (1.12.0)** — each input's `aria-describedby` now lists its `Kč` first (`<id>-from-unit` / `<id>-to-unit`), then the shared message.
312
+ - **Composition** — built in the Button Group scheme (container + divider + two borderless Field Segment cells), not two whole bordered Text Fields; a shared Field / Text Field change reaches both cells.