@invoiceonline/ui-react 0.0.0 → 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 +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-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 +351 -3
  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,259 @@
1
+ "use client";
2
+
3
+ import * as React from 'react';
4
+ import { tv } from '../../internal/tailwind-variants';
5
+ import { Icon, type IconName, type IconSize } from '../icon/Icon';
6
+ import { MotionCaret } from '../../internal/MotionCaret';
7
+ import { cn } from '../../internal/utils';
8
+ import { textFieldShellVariants, textFieldValueVariants } from '../text-field/TextField';
9
+
10
+ /**
11
+ * ComboboxField — the GENERIC TRIGGER of a type-to-narrow picker over a set too
12
+ * large to scan, where picking commits one plain value. Explicitly NOT the ARES
13
+ * subject lookup: manifest 1.6.3 `intent.whenToUse` hands the customer
14
+ * (Odběratel) and supplier (Dodavatel) lookup surfaces to its own molecule, Subject Lookup Field, which
15
+ * queries saved contacts and the registry at once and autofills an identity block.
16
+ * It draws the Text Field shell around a
17
+ * native `<input role="combobox">`; the result list is NOT part of this component —
18
+ * that surface is composed separately from `popoverSurfaceVariants` + `ListRow`.
19
+ *
20
+ * `state` is a FLOW axis — the life-cycle of ONE search — not a matrix of independent
21
+ * skins: default → focused (empty) → typing → loading → open (results) → selected,
22
+ * with the clear × on `selected` resetting back toward `default`. Only three things
23
+ * move across the flow: the border, the value ink, and the trailing indicator.
24
+ *
25
+ * There is deliberately NO error / success / disabled / readonly axis: registry
26
+ * validation (invalid IČO, verifying, verified, retry) belongs on the manual-entry
27
+ * TextFields that the overlay's "Zadám vše o subjektu ručně" escape hatch opens.
28
+ *
29
+ * Focus is a BORDER SWAP to `--outline-focus`, no additive ring (Text Field parity).
30
+ *
31
+ * `Field` integration: ComboboxField intentionally has no entry in `Field`'s
32
+ * `FIELD_CHILD_TRAITS` — it behaves like TextField, so the label floats once the
33
+ * field is focused or filled. Note that `Field` also floats whenever a `placeholder` is
34
+ * set, which the spec's Default copy always is: wrapped in `Field`, the resting field
35
+ * therefore shows the floated label chip ABOVE the interior placeholder. Figma's Default
36
+ * variant instead hides the label entirely (the 2026-07-09 fix upstream). Ours is the
37
+ * deliberate deviation — the repo-wide `Field` float rule wins, and it keeps a visible
38
+ * label on a resting field instead of leaving the placeholder as the only name.
39
+ */
40
+
41
+ export type ComboboxFieldSize = 'md' | 'sm';
42
+ export type ComboboxFieldState =
43
+ | 'default'
44
+ | 'focused'
45
+ | 'typing'
46
+ | 'loading'
47
+ | 'open'
48
+ | 'selected';
49
+
50
+ export interface ComboboxFieldBaseProps
51
+ extends Omit<React.InputHTMLAttributes<HTMLInputElement>, 'size'> {
52
+ /** Field height — Medium (48) standard invoice forms, Small (40) dense filter bars */
53
+ size?: ComboboxFieldSize;
54
+ /**
55
+ * Optional leading search magnifier (`magnifying-glass`). Available on the shell but OFF by
56
+ * default — the shipped trigger leads with the label and shows only the trailing
57
+ * indicator. The ARES-specific chrome lives in the separate Subject Lookup pattern.
58
+ */
59
+ leadingIcon?: IconName;
60
+ /** Additional className for the shell */
61
+ className?: string;
62
+ }
63
+
64
+ /**
65
+ * The clear × is spec-mandatory on `selected` (overlay decision S6 — single-value clear
66
+ * lives on the trigger, never inside a result row), so the flow state and the clear
67
+ * affordance are ONE contract: `state="selected"` requires `onClear`, and `onClear`
68
+ * requires a `clearLabel` — the button is icon-only and can never ship nameless
69
+ * (WCAG 4.1.2). Every other state refuses both props: the trailing slot belongs to the
70
+ * state machine, not to the consumer.
71
+ */
72
+ type ComboboxFieldClearButton =
73
+ | {
74
+ state: 'selected';
75
+ onClear: () => void;
76
+ clearLabel: string;
77
+ /**
78
+ * Optional second line under the committed value — the picked entity's second
79
+ * fact (the IBAN under a bank-account name) or a two-word note that it is
80
+ * missing (`IBAN nevyplněn`). Not a helper: never a rule, hint or error.
81
+ * Selected only (manifest 1.8.0 parts.value-description), hence typed here.
82
+ */
83
+ valueDescription?: string;
84
+ }
85
+ | {
86
+ /** Flow state — the life-cycle of one search, not a set of independent looks. */
87
+ state?: Exclude<ComboboxFieldState, 'selected'>;
88
+ onClear?: undefined;
89
+ clearLabel?: undefined;
90
+ valueDescription?: undefined;
91
+ };
92
+
93
+ export type ComboboxFieldProps = ComboboxFieldBaseProps & ComboboxFieldClearButton;
94
+
95
+ // Value description run — Body/S, --text-secondary, one line with ellipsis
96
+ // (manifest 1.8.0 typography.runs / text.value-description).
97
+ const comboboxValueDescriptionVariants = tv({
98
+ base: 'truncate font-inter font-normal text-body-sm text-text-secondary',
99
+ });
100
+
101
+ /** States in which the popup is open, so `aria-expanded` derives to true. */
102
+ const EXPANDED_STATES: readonly ComboboxFieldState[] = ['typing', 'loading', 'open'];
103
+
104
+ /** States that paint the focus border (`--outline-focus`) instead of the resting one. */
105
+ const FOCUS_BORDER_STATES: readonly ComboboxFieldState[] = [
106
+ 'focused',
107
+ 'typing',
108
+ 'loading',
109
+ 'open',
110
+ ];
111
+
112
+ const ComboboxField = React.forwardRef<HTMLInputElement, ComboboxFieldProps>(
113
+ (
114
+ {
115
+ className,
116
+ size = 'md',
117
+ state = 'default',
118
+ leadingIcon,
119
+ onClear,
120
+ clearLabel,
121
+ disabled,
122
+ // The browser's autofill panel renders over the result listbox and competes with
123
+ // it for the same keystrokes, so a combobox input opts out by default (ARIA APG
124
+ // combobox pattern). Overridable — a consumer wiring a real address field may want it.
125
+ autoComplete = 'off',
126
+ 'aria-expanded': ariaExpanded,
127
+ 'aria-describedby': ariaDescribedBy,
128
+ valueDescription,
129
+ ...props
130
+ },
131
+ ref,
132
+ ) => {
133
+ const descriptionId = React.useId();
134
+ const showDescription = state === 'selected' && Boolean(valueDescription);
135
+ // The description is not part of the input's value: the <input> holds the first
136
+ // line only and points at the description (combobox-field.md § Accessibility).
137
+ const describedBy =
138
+ [ariaDescribedBy, showDescription ? descriptionId : null].filter(Boolean).join(' ') ||
139
+ undefined;
140
+
141
+ // The flow state maps onto the two Text Field shell states we need: `default`
142
+ // (which already carries `focus-within:border-outline-focus`) for the resting
143
+ // and committed ends of the flow, `focused` for the four mid-search states.
144
+ const shellState = FOCUS_BORDER_STATES.includes(state) ? 'focused' : 'default';
145
+
146
+ // Every glyph in the shell — leading magnifier, caret, spinner, clear × — uses the
147
+ // Text Field icon tier: the trailing slot inside the nested Text Field instance
148
+ // measures 24×24 on Medium and 20×20 on Small in Figma, same as TextField and
149
+ // SelectField. The manifest's 2026-07-15 change was about the GLYPH (caret-down →
150
+ // caret-down-small), which is what the caret below renders. The box is the
151
+ // glyph's size step: sizes[].icon = --size-icon (24) / --size-icon-small (20).
152
+ const iconSize: IconSize = size === 'sm' ? 'small' : 'default';
153
+
154
+ // `loading` is mid-search WITH the panel open (it announces "Vyhledávám…" through
155
+ // the popup's live region), so it derives to expanded like `typing` / `open`. An
156
+ // explicitly passed `aria-expanded` always wins — the organism owning the popup
157
+ // knows better. `aria-controls` / `aria-activedescendant` are never derived: they
158
+ // reference ids this field does not own, so they only pass through.
159
+ const isExpanded = ariaExpanded ?? EXPANDED_STATES.includes(state);
160
+
161
+ let trailingEl: React.ReactNode;
162
+ if (state === 'loading') {
163
+ trailingEl = (
164
+ <Icon
165
+ name="spinner"
166
+ size={iconSize}
167
+ className="shrink-0 animate-spin text-text-secondary"
168
+ />
169
+ );
170
+ // The × renders on `selected` regardless of a (type-guaranteed) `onClear`, so a
171
+ // plain-JS caller that drops the handler still gets the spec's indicator, not a
172
+ // caret that lies about the state.
173
+ } else if (state === 'selected') {
174
+ trailingEl = (
175
+ <button
176
+ type="button"
177
+ onClick={onClear}
178
+ // A `disabled` input has to neutralise the clear affordance too — otherwise
179
+ // the × stays focusable and clickable and can still change the value of a
180
+ // field the consumer has switched off (TextField parity).
181
+ disabled={disabled}
182
+ aria-label={clearLabel}
183
+ className="flex min-h-800 min-w-800 shrink-0 items-center justify-center rounded-200 text-text-secondary outline-none focus-visible:ring-200 focus-visible:ring-outline-focus cursor-pointer disabled:cursor-not-allowed"
184
+ >
185
+ <Icon name="x-small" size={iconSize} className="shrink-0" />
186
+ </button>
187
+ );
188
+ } else {
189
+ // One glyph that turns 180° while the list is open (typing / results).
190
+ trailingEl = (
191
+ <MotionCaret open={state === 'typing' || state === 'open'}>
192
+ <Icon name="caret-down-small" size={iconSize} className="shrink-0 text-icon-muted" />
193
+ </MotionCaret>
194
+ );
195
+ }
196
+
197
+ const inputEl = (
198
+ <input
199
+ ref={ref}
200
+ type="text"
201
+ role="combobox"
202
+ data-fods-part="value"
203
+ autoComplete={autoComplete}
204
+ aria-autocomplete="list"
205
+ aria-expanded={isExpanded}
206
+ aria-busy={state === 'loading' || undefined}
207
+ aria-describedby={describedBy}
208
+ disabled={disabled}
209
+ className={textFieldValueVariants({ state: 'default' })}
210
+ {...props}
211
+ />
212
+ );
213
+
214
+ return (
215
+ <div
216
+ // data-fods-* mark the parts the FODS verifier measures in the browser.
217
+ // Not inert in this package: `styles/base.css` scopes its reset to them.
218
+ // This component shares TextField's shell recipe but renders its own
219
+ // markup, so the attributes have to be repeated here.
220
+ data-fods-component="combobox-field"
221
+ data-fods-part="root"
222
+ className={cn(
223
+ textFieldShellVariants({ inputSize: size, state: shellState }),
224
+ // With a description the fixed height becomes the minimum: the shell hugs
225
+ // two text lines with --space-500 above and below (sizes[].note).
226
+ showDescription && ['h-auto py-500', size === 'sm' ? 'min-h-1000' : 'min-h-1100'],
227
+ className,
228
+ )}
229
+ >
230
+ {leadingIcon ? (
231
+ <Icon
232
+ name={leadingIcon}
233
+ size={iconSize}
234
+ className="shrink-0 text-icon-muted"
235
+ />
236
+ ) : null}
237
+
238
+ {/* Always wrapped: toggling the wrapper would remount the input (focus, typed text). */}
239
+ <div className="flex min-w-0 flex-1 flex-col">
240
+ {inputEl}
241
+ {showDescription ? (
242
+ <span
243
+ id={descriptionId}
244
+ data-fods-part="value-description"
245
+ className={comboboxValueDescriptionVariants()}
246
+ >
247
+ {valueDescription}
248
+ </span>
249
+ ) : null}
250
+ </div>
251
+
252
+ {trailingEl}
253
+ </div>
254
+ );
255
+ },
256
+ );
257
+ ComboboxField.displayName = 'ComboboxField';
258
+
259
+ export { ComboboxField };
@@ -0,0 +1,12 @@
1
+ export {
2
+ ComboboxField,
3
+ type ComboboxFieldProps,
4
+ type ComboboxFieldSize,
5
+ type ComboboxFieldState,
6
+ } from './ComboboxField';
7
+ export {
8
+ Combobox,
9
+ type ComboboxProps,
10
+ type ComboboxItem,
11
+ type ComboboxManualEntry,
12
+ } from './Combobox';
@@ -0,0 +1,340 @@
1
+ import { Meta, Canvas, Controls } from '@storybook/addon-docs/blocks';
2
+ import * as DateFieldStories from './DateField.stories';
3
+
4
+ <Meta of={DateFieldStories} tags={['autodocs']} />
5
+
6
+ # DateField
7
+
8
+ ## Metadata
9
+
10
+ - **Layer:** molecule
11
+ - **Status:** stable
12
+ - **Tokens used:** `--bg-primary`, `--bg-readonly`, `--border-width-100`, `--border-width-200`, `--disabled-background`, `--disabled-foreground`, `--font-body`, `--font-size-base`, `--font-weight-normal`, `--icon-muted`, `--leading-relaxed`, `--outline-default`, `--outline-focus`, `--radius-200`, `--radius-400`, `--space-1000`, `--space-1100`, `--space-400`, `--space-500`, `--status-danger`, `--status-success-solid`, `--text-placeholder`, `--text-primary`, `--text-secondary`
13
+ - **Manifest version:** `1.2.1` (`spec/04-molecules/date-picker.manifest.json` — the panel's manifest; DateField has no manifest of its own)
14
+
15
+ ## Overview
16
+
17
+ DateField is the field a Date Picker opens from — a Text Field shell with a calendar glyph in the
18
+ leading slot. Because it is a real editable `<input>`, a date can be **typed as well as picked**;
19
+ the typed draft is parsed against `dateFormat` on blur. Use it for any single date in a form: expense
20
+ date, invoice issue date, taxable date, due date. **Do not** use it for a date *range* — reach for the
21
+ dual-month [`DatePicker`](?path=/docs/design-system-molecules-datepicker--docs) directly, this field
22
+ holds one date. Do not use it for a free-form "period" or "month" selector either; the panel is a day
23
+ grid.
24
+
25
+ **Typing is bounded exactly like picking.** A draft that does not parse is discarded rather than
26
+ coerced — and so is one that parses but lands outside `minDate` / `maxDate`, since the panel disables
27
+ those days outright. In both cases `onValueChange` is not called at all and the field falls back to the
28
+ value it still holds, so a controlled value can never leave the bounds by the keyboard route.
29
+
30
+ **One user action reports one value.** Clicking a day over a half-typed draft does not commit the draft
31
+ first: the panel is a non-modal portal, so the click blurs the input before it selects, and that blur is
32
+ recognised as focus moving *into* the panel rather than the end of editing. Only the picked day reaches
33
+ `onValueChange`, so validation or autosave hung off it runs once — never on an intermediate the user
34
+ never meant to submit. The draft survives paging the calendar and returning to the input.
35
+
36
+ ## Rationale
37
+
38
+ Upstream is explicit that a date field is a **sibling of Text Field, not a Select**:
39
+
40
+ - `_text-field-inventory.md` lists *"Date — issue date, taxable date"* as a **Text Field row**, while
41
+ Selects sit in a separate section titled *"Adjacent — not a Text Field"*.
42
+ - `_text-field-planning.md`, decision 2: *"**Textarea** and **Date Picker** are **separate siblings**
43
+ that reuse `_inputShell`."*
44
+
45
+ That is why the `SelectField` pattern (a read-only `<button role="combobox">`) is **deliberately not
46
+ reused** here: it would take typing away. For a keyboard user filling a long invoice form, keying a
47
+ date is faster than paging through a calendar.
48
+
49
+ **The whole field is the trigger, and the glyph is decoration.** No spec file states which side the
50
+ glyph sits on: `text-field.md` describes the leading slot as a *"contextual glyph (search)"* and the
51
+ trailing slot as *"clear / password-reveal"*, and neither names a calendar — so the position follows the
52
+ design. `field-readonly.md:69` is the single place the glyph is mentioned at all, and it agrees with
53
+ this model: the icon is *"a quiet affordance, **not an active control**"* and it is *"**the trigger**"*
54
+ — i.e. the field — that opens the calendar. Hence `role="combobox"` on the input (the APG *Date Picker
55
+ Combobox* pattern) rather than `aria-haspopup` on a button, because there is no button.
56
+
57
+ > Superseded: an earlier build put the calendar in the trailing slot as an interactive icon button and
58
+ > justified it from the *"busy slot"* wording of the grill documents. That wording is about Select
59
+ > carets and password-reveals, not about a date field, and the grill documents are working notes rather
60
+ > than canonical spec.
61
+
62
+ ## Anatomy
63
+
64
+ - **Shell** — the Text Field shell: border, fill, `--radius-400`, height tier. Owns the floating-label
65
+ notch and the focus border swap.
66
+ - **Value input** — a native, editable `<input type="text">` showing either the value formatted with
67
+ `dateFormat`, or the placeholder pattern.
68
+ - **Leading calendar glyph** — the `calendar-dots` icon, **decorative** (`aria-hidden`): it marks what the
69
+ field holds and is not focusable. In read-only it steps down from `--text-secondary` to `--icon-muted`
70
+ (`field-readonly.md`).
71
+ - **The input carries the ARIA** — `role="combobox"`, `aria-haspopup="dialog"`, `aria-expanded` and
72
+ `aria-controls`.
73
+ - **The wrapper carries the click** — "the whole field is the trigger" is literal: the open handler
74
+ sits on the wrapper, not on the `<input>`, because the glyph and the shell padding are the input's
75
+ *siblings* and would otherwise be dead area. A press that did not land in the input is handled on
76
+ mouse-down so focus never leaves the input — a half-typed draft survives and the label does not
77
+ flicker — and the field stays typeable. It opens but does **not** toggle, so clicking into the text to
78
+ place the caret while the calendar is up keeps it up. `ArrowDown` opens it too — and, when it is
79
+ already open, moves focus into the day grid.
80
+ - **Panel** — the [`DatePicker`](?path=/docs/design-system-molecules-datepicker--docs) rendered in a
81
+ portal, anchored via `useAnchoredPanel` (`role: 'dialog'`, `focusModel: 'roving'`,
82
+ `navigation: 'none'` — the day grid owns the arrow keys, `widthPolicy: 'content'` — the calendar hugs
83
+ its own grid instead of the trigger width). Since date-picker 1.0.0 the calendar paints no surface,
84
+ so the panel wraps it in the Popover surface recipe (`popoverSurfaceVariants`, padless — the month
85
+ columns pad themselves): same `--bg-primary` fill, 1px `--outline-default` border, `--radius-500`
86
+ corners and `--shadow-overlay` as before, now owned by the host.
87
+ - **Label / helper / error line** — live in [`Field`](?path=/docs/design-system-atoms-field--docs), not
88
+ here. DateField is the shell + value only.
89
+
90
+ <Canvas of={DateFieldStories.WithField} />
91
+
92
+ ## Variants
93
+
94
+ **No variant axis.** DateField is one field with one job — pick or type a single date. Everything that
95
+ would otherwise be a variant is either a **size** (height tier) or a **state**. The display pattern is
96
+ data (`dateFormat`), not a variant. There is therefore no `Variants` story.
97
+
98
+ ## Matrix
99
+
100
+ <Canvas of={DateFieldStories.Matrix} />
101
+
102
+ The full state × size grid, mirroring the Figma labelled grid — rows are states, columns are sizes.
103
+
104
+ ## Sizes
105
+
106
+ <Canvas of={DateFieldStories.Sizes} />
107
+
108
+ <table>
109
+ <thead>
110
+ <tr>
111
+ <th>Size</th>
112
+ <th>Height</th>
113
+ <th>Icon</th>
114
+ <th>When</th>
115
+ </tr>
116
+ </thead>
117
+ <tbody>
118
+ <tr>
119
+ <td><code>md</code> (default)</td>
120
+ <td>48 px (<code>h-1100</code>)</td>
121
+ <td>24 px</td>
122
+ <td>Standalone field in a form</td>
123
+ </tr>
124
+ <tr>
125
+ <td><code>sm</code></td>
126
+ <td>40 px (<code>h-1000</code>)</td>
127
+ <td>20 px</td>
128
+ <td>Dense rows (invoice item rows, list filters)</td>
129
+ </tr>
130
+ </tbody>
131
+ </table>
132
+
133
+ Padding and font are the Text Field tiers: `px-500` / `gap-400`, value always Body/M/Regular.
134
+
135
+ ## States
136
+
137
+ <Canvas of={DateFieldStories.States} />
138
+
139
+ <table>
140
+ <thead>
141
+ <tr>
142
+ <th>State</th>
143
+ <th>Shell</th>
144
+ <th>Value / icon</th>
145
+ <th>Behaviour</th>
146
+ </tr>
147
+ </thead>
148
+ <tbody>
149
+ <tr>
150
+ <td><code>default</code></td>
151
+ <td>border <code>--outline-default</code>, on focus-within <code>--outline-focus</code></td>
152
+ <td>value <code>--text-primary</code>, placeholder <code>--text-placeholder</code>, icon <code>--text-secondary</code></td>
153
+ <td>Typing allowed; a click <em>anywhere in the field</em> (glyph and padding included) or <code>ArrowDown</code> opens the panel</td>
154
+ </tr>
155
+ <tr>
156
+ <td><code>success</code></td>
157
+ <td>border <code>--status-success-solid</code></td>
158
+ <td>calendar glyph <strong>stays</strong> leading; the <code>check</code> status icon takes the trailing slot</td>
159
+ <td>Unchanged; injected by <code>Field</code> when it is given a <code>success</code> message</td>
160
+ </tr>
161
+ <tr>
162
+ <td><code>error</code></td>
163
+ <td>border <code>--status-danger</code></td>
164
+ <td>calendar glyph <strong>stays</strong> in the leading slot; the intrinsic status icon takes the <em>trailing</em> slot, so the two never collide</td>
165
+ <td>Unchanged; sets <code>aria-invalid</code></td>
166
+ </tr>
167
+ <tr>
168
+ <td><code>disabled</code></td>
169
+ <td><code>--outline-default</code> border @ <code>--border-width-100</code>, <code>--disabled-background</code> fill</td>
170
+ <td>ink <code>--disabled-foreground</code></td>
171
+ <td>Input disabled and out of tab order; the panel cannot open</td>
172
+ </tr>
173
+ <tr>
174
+ <td><code>readonly</code></td>
175
+ <td><code>--outline-default</code> border @ <code>--border-width-100</code>, <code>--bg-readonly</code> fill</td>
176
+ <td>value <code>--text-primary</code>, icon <code>--icon-muted</code></td>
177
+ <td>Shows the value, is copyable and submits with the form, but the trigger <strong>does not open the calendar</strong> (<code>field-readonly.md:69</code>); carries <code>aria-readonly</code></td>
178
+ </tr>
179
+ </tbody>
180
+ </table>
181
+
182
+ Interactive states are CSS, not props: focus is a border-colour swap on the shell. The field has a
183
+ single focusable element — the input — so there is no second focus ring to reason about.
184
+
185
+ ## Mobile
186
+
187
+ A **single** date field needs nothing special on a phone. The two things that do move belong to the
188
+ panel it opens, and are worth knowing here because this is where the decision gets made
189
+ (manifest `date-picker` 1.2.1 § `chrome.mobile` — see [DatePicker → Mobile](?path=/docs/design-system-molecules-datepicker--docs#mobile)):
190
+
191
+ - The single-month picker steps its **side padding** down below `md` (768px), `--space-600` → `--space-400`, so its 364px minimum clears a 390px viewport.
192
+ - The popover may **flip/shift past the page's own 16px gutter** toward the viewport edge; it is not confined to the padded content column.
193
+
194
+ **A date range is the case that does not scale down.** Two DateFields side by side do not fit a
195
+ phone column, and the dual-month DatePicker — the desktop answer — fits no phone viewport at all
196
+ (~760px, and the 48×36 Day Cell is a touch target that must not shrink — its `<button>` fills the
197
+ whole cell, so 48×36 is the real hit area and not just the tile). On mobile a range is
198
+ therefore a [`FieldPair`](?path=/docs/design-system-molecules-fieldpair--docs) in `format="date"`:
199
+ two fused cells, each opening its **own** single-month panel, no shared calendar and no cross-field
200
+ `minDate`/`maxDate`.
201
+
202
+ ## API
203
+
204
+ <Controls of={DateFieldStories.Playground} />
205
+
206
+ <table>
207
+ <thead>
208
+ <tr>
209
+ <th>Prop</th>
210
+ <th>Type</th>
211
+ <th>Default</th>
212
+ <th>Notes</th>
213
+ </tr>
214
+ </thead>
215
+ <tbody>
216
+ <tr><td><code>value</code></td><td><code>Date</code></td><td>—</td><td>Controlled. The chosen date.</td></tr>
217
+ <tr><td><code>onValueChange</code></td><td><code>(value: Date | undefined) =&gt; void</code></td><td>—</td><td>Fires on day pick and on a committed draft; <code>undefined</code> means "unset".</td></tr>
218
+ <tr><td><code>size</code></td><td><code>'md' | 'sm'</code></td><td><code>'md'</code></td><td>Text Field height tier.</td></tr>
219
+ <tr><td><code>state</code></td><td><code>'default' | 'focused' | 'error' | 'success' | 'disabled' | 'readonly'</code></td><td><code>'default'</code></td><td>Visual state; usually driven by <code>Field</code>.</td></tr>
220
+ <tr><td><code>dateFormat</code></td><td><code>string</code></td><td><code>dd. MM. yyyy</code></td><td>Display <em>and</em> parse pattern, date-fns syntax.</td></tr>
221
+ <tr><td><code>locale</code></td><td><code>Locale</code> (date-fns)</td><td><code>cs</code></td><td>Drives week start, weekday names, month caption.</td></tr>
222
+ <tr><td><code>minDate</code> / <code>maxDate</code></td><td><code>Date</code></td><td>—</td><td>Bounds the window the panel offers (out-of-range days render disabled) <em>and</em> the typed draft — an out-of-range date is discarded on commit, day-granular.</td></tr>
223
+ <tr><td><code>placeholder</code></td><td><code>string</code></td><td>—</td><td>Show the expected pattern here, never the label.</td></tr>
224
+ <tr><td><code>id</code> / <code>name</code></td><td><code>string</code></td><td>—</td><td><code>id</code> is required for <code>Field</code> to wire label + helper text.</td></tr>
225
+ <tr><td><code>disabled</code> / <code>readOnly</code></td><td><code>boolean</code></td><td>—</td><td>Native attributes; win over <code>state</code> when set explicitly.</td></tr>
226
+ <tr><td><code>panelLabel</code> <strong>(required)</strong></td><td><code>string</code></td><td>—</td><td><code>aria-label</code> of the panel dialog. No default: the design system is locale-agnostic, and a name invisible to sighted review is exactly the kind that ships untranslated.</td></tr>
227
+ <tr><td><code>navLabels</code> <strong>(required)</strong></td><td><code>&#123; previousMonth, nextMonth, previousYear, nextYear &#125;</code></td><td>—</td><td>Accessible names for the panel's four chevrons, passed straight through to <code>DatePicker</code>.</td></tr>
228
+ <tr><td><code>onFocus</code> / <code>onBlur</code></td><td><code>FocusEventHandler&lt;HTMLInputElement&gt;</code></td><td>—</td><td>Forwarded to the input; the draft commit runs before <code>onBlur</code> — except when focus moves into the panel, where the day click is the commit instead.</td></tr>
229
+ <tr><td><code>aria-invalid</code> / <code>aria-describedby</code></td><td><code>boolean</code> / <code>string</code></td><td>—</td><td>Injected by <code>Field</code>; declared explicitly so the clone cannot drop them.</td></tr>
230
+ </tbody>
231
+ </table>
232
+
233
+ ## Do / Don't
234
+
235
+ - ✅ Wrap in `Field` for the floating label — the `<label>` is the accessible name.
236
+ - ✅ Use the placeholder to show the expected pattern (`dd. mm. rrrr`). DateField follows the Text
237
+ Field floating-label rule, so an empty, unfocused field with **no** placeholder rests its label
238
+ inside the shell; a placeholder both teaches the format and floats the label out of its way.
239
+ - ✅ Take `dateFormat` from the consumer's locale config, so a market change does not need a code change.
240
+ - ✅ Keep the field typeable — do not layer a read-only overlay over the input to "force" the picker.
241
+ - ❌ Never use the placeholder as the label.
242
+ - ❌ Don't hardcode `dateFormat` per call site.
243
+ - ❌ Don't use two DateFields glued together as a range picker — on desktop use the dual-month `DatePicker`, on mobile a `FieldPair` in `format="date"` (see [Mobile](#mobile)).
244
+ - ❌ Don't rely on the field to validate: an unparseable draft is discarded, no error state is raised.
245
+
246
+ ## Accessibility
247
+
248
+ - **Keyboard** — Tab reaches **one** element, the input; the calendar glyph is decoration and never
249
+ takes focus. `ArrowDown` opens the panel and moves focus onto a day — and when the panel is already
250
+ up (a click-open leaves focus in the input on purpose) it is the route *into* the grid, so a keyboard
251
+ user is never stuck having to Tab there. `Esc` closes it. Inside the panel
252
+ the day grid owns arrows / `PageUp` / `PageDown` / `Home` / `End` (`navigation: 'none'` on the
253
+ substrate) and is itself **one tab stop**: a single day carries `tabindex="0"` (the selected date,
254
+ else today, else the first day) and the rest are reached only by the arrow keys, so Tab never walks
255
+ 35 days. Picking a day closes the panel and returns focus to the input. The shell shows focus as an
256
+ `--outline-focus` border swap.
257
+ - **Focus follows how the panel was opened.** Opening by **click** leaves focus in the input, because
258
+ the field is typeable and pulling focus into the grid would cut a typist off mid-date. Opening by
259
+ **ArrowDown** is explicit intent to browse, so there focus lands on the selected day (or today).
260
+ - **ARIA** — the input is the trigger: `role="combobox"` + `aria-haspopup="dialog"` + `aria-expanded` +
261
+ `aria-controls` pointing at the panel while it is open (APG *Date Picker Combobox*). The panel is
262
+ `role="dialog"` with `aria-label={panelLabel}`. Read-only carries `aria-readonly`, error carries
263
+ `aria-invalid`. Helper text is associated via `aria-describedby`, injected by `Field`.
264
+ - **Screen reader** — the input announces as a combobox with the `<label>` text, the formatted value and
265
+ its expanded state. Opening the panel announces the dialog by its `panelLabel`, then the grid by its
266
+ month caption. (Wording derived from the ARIA wiring — not yet verified against a real screen reader.)
267
+ - **Colour is never the only cue** — `Field` renders the error *text* alongside the `--status-danger`
268
+ border, so the error state does not rely on colour alone (WCAG 1.4.1).
269
+ - **Motion** — the panel's enter/exit is a 150 ms opacity + translate transition from
270
+ `useAnchoredPanel`, which reads `prefers-reduced-motion` at runtime and drops both the slide and the
271
+ duration when it is set.
272
+
273
+ > **Not yet measured:** the ink/background contrast ratios come from the FODS semantic tokens and have
274
+ > not been verified for this component. Run the `storybook-a11y-auditor` (or an axe pass over the
275
+ > stories) before treating AA conformance as confirmed.
276
+
277
+ Accessibility floor for every FODS component: `spec/01-foundations/accessibility.md`.
278
+
279
+ ## Usage
280
+
281
+ ```tsx
282
+ // Good — Field owns the label / helper / error, DateField owns the value
283
+ const [issuedOn, setIssuedOn] = React.useState<Date | undefined>();
284
+
285
+ <Field label="Datum vystavení" helperText="Datum, kdy byla faktura vystavena">
286
+ <DateField
287
+ id="issued-on"
288
+ name="issued_on"
289
+ value={issuedOn}
290
+ onValueChange={setIssuedOn}
291
+ placeholder="dd. mm. rrrr"
292
+ dateFormat={locale.dateFormat} // 'dd. MM. yyyy' CZ, 'MM/dd/yyyy' US, 'dd/MM/yyyy' GB
293
+ minDate={new Date(2020, 0, 1)}
294
+ />
295
+ </Field>
296
+ ```
297
+
298
+ Typing behaviour worth knowing:
299
+
300
+ - The typed draft is parsed **on blur** against `dateFormat`. A draft that does not parse is
301
+ **discarded, not coerced** — the field falls back to the committed value and raises **no** error state
302
+ of its own. Known limitation: validation is the form's job.
303
+ - An emptied field is a legitimate "unset the date" and reports `undefined`.
304
+ - DateField is deliberately **not** marked `autoFloating` in `Field.tsx` → `FIELD_CHILD_TRAITS`: it is a Text Field
305
+ sibling and follows the one floating-label rule (`text-field.md` § States), so an empty, unfocused,
306
+ valid date field rests its label inside. In practice the label floats anyway on the recommended
307
+ usage, because the format hint is passed as a `placeholder` and a placeholder floats it. Forcing the
308
+ float would strand the label over an empty shell whenever no placeholder was given.
309
+
310
+ ```tsx
311
+ // Don't — the placeholder is not an accessible name
312
+ <DateField placeholder="Datum vystavení" value={issuedOn} onValueChange={setIssuedOn} />
313
+
314
+ // Don't — hardcoded per-market pattern in the call site
315
+ <DateField dateFormat="MM/dd/yyyy" value={issuedOn} onValueChange={setIssuedOn} />
316
+
317
+ // Don't — a range is not two DateFields; use the dual-month DatePicker
318
+ <DateField value={from} onValueChange={setFrom} />
319
+ <DateField value={to} onValueChange={setTo} />
320
+ ```
321
+
322
+ ## Related
323
+
324
+ - [`DatePicker`](?path=/docs/design-system-molecules-datepicker--docs) — the panel this field opens; use
325
+ it directly for a dual-month range (desktop only — it has no mobile treatment).
326
+ - [`FieldPair`](?path=/docs/design-system-molecules-fieldpair--docs) — `format="date"`: the range form
327
+ that works on a phone, two cells each opening their own single-month panel.
328
+ - [`TextField`](?path=/docs/design-system-atoms-textfield--docs) — the shell DateField reuses (border,
329
+ fill, height tiers, leading / trailing slot contract).
330
+ - [`Field`](?path=/docs/design-system-atoms-field--docs) — floating label, helper text, error line;
331
+ injects `aria-invalid` / `aria-describedby`.
332
+ - [`SelectField`](?path=/docs/design-system-molecules-selectfield--docs) — the sibling trigger that
333
+ **does not** allow typing: a read-only `<button role="combobox">`, because a Select's value must be one
334
+ of a closed list. A date is an open, keyable value, so DateField stays an `<input>`.
335
+ - Spec: `spec/03-atoms/text-field.md` ·
336
+ `spec/04-molecules/date-picker.md` · `spec/06-patterns/field-readonly.md`
337
+
338
+ ## Migration notes
339
+
340
+ Not applicable.