@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,436 @@
1
+ import { Meta, Canvas, Controls } from '@storybook/addon-docs/blocks';
2
+ import * as DatePickerStories from './DatePicker.stories';
3
+
4
+ <Meta of={DatePickerStories} tags={['autodocs']} />
5
+
6
+ # DatePicker
7
+
8
+ ## Metadata
9
+
10
+ - **Layer:** molecule
11
+ - **Status:** stable
12
+ - **Manifest version:** `1.2.1`
13
+ - **Sub-component — Day Cell:** `spec/03-atoms/date-picker-day-cell.md`, manifest `0.7.2`, Figma node 6417:30774. Day Cell keeps its own repo pair (spec + manifest) but has **no Figma page of its own** — it lives on the Date Picker page, per the Divider / List Row sub-component precedent. In this package it is the internal `dayCellVariants` recipe (`src/internal/dayCell.ts`, not exported), not a `<DayCell>` component, because `DatePicker` is its only call site.
14
+ - **Tokens used:** `--bg-hover`, `--bg-primary`, `--bg-secondary`, `--border-width-200`, `--disabled-foreground`, `--font-size-sm`, `--font-size-xxs`, `--font-weight-normal`, `--font-weight-semibold`, `--leading-loose`, `--leading-relaxed`, `--outline-focus`, `--radius-full`, `--secondary`, `--secondary-foreground`, `--secondary-solid`, `--space-100`, `--space-1000`, `--space-1100`, `--space-200`, `--space-300`, `--space-400`, `--space-450`, `--space-500`, `--space-600`, `--space-900`, `--text-primary`, `--text-secondary`, `--z-index-base`
15
+
16
+ ## Overview
17
+
18
+ `DatePicker` is the **calendar content a date field opens** — for an invoice issue / due date, an expense date or a report period. It has two layout modes: **Single month** picks **one day** (the everyday form case) and **Dual month** picks a **range** across two months. This component is the **content only — it paints no surface** (no fill, border, radius or shadow, manifest 1.0.0). The **host** owns the surface: an anchored date field wraps it in the [Popover surface recipe](?path=/docs/design-system-patterns-popover-surface--docs), a filter drawer or bottom sheet is the surface itself. [`DateField`](?path=/docs/design-system-molecules-datefield--docs) is the trigger that anchors it and owns the `role="dialog"` semantics. Every story on this page renders it inside that Popover surface host.
19
+
20
+ Reach for it whenever a field needs a calendar. Do **not** use it as an always-visible inline calendar (a different, unbuilt pattern), as a month/year jump picker, or as a scheduling grid — it is the popover a trigger opens and dismisses.
21
+
22
+ <Canvas of={DatePickerStories.Playground} />
23
+
24
+ ## Rationale
25
+
26
+ The two modes exist because the two jobs differ. A **form** picks **one day** — a single month is calmer and smaller, and a fast **year jump** (the `« »` double-chevrons) matters more than a month boundary. A **filter / period** picks a **range**, and a single-month calendar forces paging across the month boundary mid-selection — so range mode shows **two months at once**. Same atoms, same chrome; only the layout and the header nav differ.
27
+
28
+ The panel is documented as a **structure** — chrome plus layout rules, not a colour matrix. All the interactive variety lives in the parts it composes: the **Day Cell** states carry selection / range / today / adjacent-month, and [`IconButton`](?path=/docs/design-system-atoms-iconbutton--docs) chevrons page the months. Documenting by **reference** (never re-typing the child tokens) means a Day-Cell or Icon-Button change touches only that child.
29
+
30
+ ## Anatomy
31
+
32
+ <table>
33
+ <thead>
34
+ <tr><th>Part</th><th>Geometry</th><th>Tokens</th></tr>
35
+ </thead>
36
+ <tbody>
37
+ <tr>
38
+ <td><strong>No surface</strong> — the root paints nothing; the <strong>host</strong> provides fill, border, radius and shadow (anchored panel → Popover surface recipe, padless; drawer / sheet → the drawer itself, no wrapper).</td>
39
+ <td><code>inline-flex</code>, width follows the grid</td>
40
+ <td>none of its own — see <a href="#migration-notes">Migration notes</a> for where the former surface values went</td>
41
+ </tr>
42
+ <tr>
43
+ <td><strong>Month column</strong> (×1 or ×2)</td>
44
+ <td>vertical stack</td>
45
+ <td>padding top <code>--space-500</code>, sides + bottom <code>--space-600</code></td>
46
+ </tr>
47
+ <tr>
48
+ <td><strong>Header</strong> — chevron group(s) + the <code>{'{Month} {Year}'}</code> caption (two Body/S/Semibold runs).</td>
49
+ <td>space-between</td>
50
+ <td>paddingTop <code>--space-600</code>, paddingBottom <code>--space-400</code>, caption gap <code>--space-300</code>, nav group gap <code>--space-100</code>, caption <code>--text-primary</code></td>
51
+ </tr>
52
+ <tr>
53
+ <td><strong>Weekday row</strong> — seven caption cells, locale abbreviations.</td>
54
+ <td>48×40 per cell</td>
55
+ <td>Body/XXS Regular, <code>--text-secondary</code></td>
56
+ </tr>
57
+ <tr>
58
+ <td><strong>Dates grid</strong> — a real <code>&lt;table role="grid"&gt;</code>; each row is seven Day Cells.</td>
59
+ <td>row 348×36, paddingTop <code>--space-500</code></td>
60
+ <td>rowGap / cellGap <code>--space-100</code></td>
61
+ </tr>
62
+ <tr>
63
+ <td><strong>Day Cell</strong> — the grid unit: a 48×36 tile whose <code>&lt;button&gt;</code> fills it, with the 36px indicator disc as a <strong>non-interactive child</strong>. The hit area is the cell, never the disc.</td>
64
+ <td>48×36 cell = 48×36 button, 36×36 disc (<code>--radius-full</code>)</td>
65
+ <td>see the Day Cell matrix in <a href="#states">States</a></td>
66
+ </tr>
67
+ <tr>
68
+ <td><strong>Range band</strong> — the continuous multi-day highlight, painted behind the discs.</td>
69
+ <td>full row height, radius 0, end-caps at the start / end cell midpoints</td>
70
+ <td><code>--bg-secondary</code></td>
71
+ </tr>
72
+ </tbody>
73
+ </table>
74
+
75
+ ## Variants
76
+
77
+ <Canvas of={DatePickerStories.Variants} />
78
+
79
+ The single axis is **Layout Mode** (`variant`). It couples the layout to the **kind of selection**, because the upstream spec couples them: single month means single-date, dual month means range.
80
+
81
+ <table>
82
+ <thead>
83
+ <tr><th>Variant</th><th>Layout &amp; selection</th><th>Header nav</th><th>When</th></tr>
84
+ </thead>
85
+ <tbody>
86
+ <tr>
87
+ <td><code>single-month</code> (default)</td>
88
+ <td>one month; picks <strong>one day</strong> (<code>value: Date</code>)</td>
89
+ <td><code>« ‹ {'{Měsíc} {Rok}'} › »</code> — outer year double-chevrons + inner month single-chevrons</td>
90
+ <td>a date in a <strong>form</strong> — expense date, invoice issue / due date</td>
91
+ </tr>
92
+ <tr>
93
+ <td><code>dual-month</code></td>
94
+ <td>two month columns side by side, <strong>no separator</strong> (the month padding is the only gap); picks a <strong>range</strong> (<code>value: DateRange</code>)</td>
95
+ <td><code>‹</code> on the left month, <code>›</code> on the right — month chevrons only, <strong>no year jump</strong></td>
96
+ <td>a <strong>range</strong> — filters, accounting period, report window</td>
97
+ </tr>
98
+ </tbody>
99
+ </table>
100
+
101
+ **Which one:** one day in a form → Single month (calmer, smaller, fast year jump). A range → Dual month (both endpoints visible across a month boundary). Never show a dual-month range panel for a single form date, and never add year double-chevrons to dual month — its two-month span already covers the boundary case.
102
+
103
+ The axis grid, mirroring the Figma labelled grid. Rows are the axis values and there are no columns —
104
+ there is no size axis to cross them with, and the panel container has no states of its own (those are
105
+ the Day Cell's, below). Each row renders with the selection kind its mode owns.
106
+
107
+ <Canvas of={DatePickerStories.Matrix} />
108
+
109
+ ## Sizes
110
+
111
+ **n/a — no size axis.** Both modes tile the same **48×36 Day Cell** on a 7×N grid, so the panel width follows from the grid plus the month padding: Single ≈ 380px, Dual ≈ 760px (two 380px columns — no separator since 1.2.0). There is nothing to scale, and the cell must not be scaled up or down.
112
+
113
+ ## Mobile
114
+
115
+ Closed upstream 2026-08-05 (manifest 0.5.0 § `chrome.mobile`). The two modes are treated differently, and that asymmetry is the point:
116
+
117
+ - **Dual month has no mobile treatment at all.** Its ~760px minimum does not fit any phone viewport, and the grid cannot shrink (the 48×36 Day Cell is fixed). On mobile a range field therefore **swaps to two independent [`FieldPair`](?path=/docs/design-system-molecules-fieldpair--docs) cells** (`showUnit={false}`), each opening its own Single month picker — no shared calendar, no cross-field `minDate`/`maxDate`.
118
+ - **Single month steps its side padding down** below `md` (768px): `--space-600` (16) → `--space-400` (8). That is the **only** chrome value that moves — top/bottom padding, the grid and the Day Cell are unchanged. It brings the minimum content width from 380px to 364px, which fits a 390px viewport.
119
+ - **Positioning** is permitted to flip/shift past the page's own 16px container gutter toward the viewport edge; the panel is not confined to the padded content column. A positioning refinement per `overlay-behavior.md` § Positioning, not a new pattern.
120
+
121
+ Typography was evaluated upstream and ruled out: this panel's captions are Body-tier, which is explicitly non-responsive, and would not have changed the grid-driven width anyway.
122
+
123
+ A **date range** on mobile is not this component at all: it is a [`FieldPair`](?path=/docs/design-system-molecules-fieldpair--docs) in `format="date"`, two cells each opening the single-month panel.
124
+
125
+ ### Who does the swap
126
+
127
+ **Nothing here switches automatically, by design.** The spec puts the swap in the *consuming form*, not in this component: *"a breakpoint-level change in the consuming form, not a Date Picker variant"*. There is no `useIsMobile` anywhere in `DatePicker` / `DateField` / `FieldPair` — the only responsive thing in the whole family is the `md:` padding class above.
128
+
129
+ That is not an omission. The two forms do not hold the same data: the dual panel owns **one** `DateRange` (`{ from, to }`) with one `onValueChange`, while a FieldPair owns **two independent** dates with two callbacks and its own reactive range error. Swapping is a change of form state, not of appearance, so the form has to own it:
130
+
131
+ ```tsx
132
+ // The consuming form picks the shape. Keep ONE source of truth (from / to) and
133
+ // derive the panel's DateRange from it, so switching viewport never loses input.
134
+ const isMobile = useIsMobile('md'); // the consumer's matchMedia hook
135
+
136
+ return isMobile ? (
137
+ <FieldPair
138
+ format="date"
139
+ showUnit={false}
140
+ panelLabel={t('datePicker.panel')}
141
+ navLabels={navLabels}
142
+ aria-label={t('filter.period')}
143
+ from={{ label: t('from'), value: from, onValueChange: setFrom, error: invalid }}
144
+ to={{ label: t('to'), value: to, onValueChange: setTo, error: invalid }}
145
+ error={invalid ? t('filter.rangeInverted') : undefined}
146
+ />
147
+ ) : (
148
+ <DatePicker
149
+ variant="dual-month"
150
+ navLabels={navLabels}
151
+ value={{ from, to }}
152
+ onValueChange={(range) => { setFrom(range?.from); setTo(range?.to); }}
153
+ />
154
+ );
155
+ ```
156
+
157
+ Two things to know before wiring it:
158
+
159
+ - **`useIsMobile` is backed by `matchMedia`, not by a `resize` listener** — it answers correctly on the very first render (no desktop flash, no hydration mismatch) and the browser notifies it only when the breakpoint is actually crossed. Its query is the exact complement of the Tailwind prefix (`md:` → `min-width: 768px`, so mobile is `max-width: 767.98px`), which is what keeps this swap from ever disagreeing with the panel's own `md:` padding rule.
160
+ - **It measures the VIEWPORT, which is the axis this contract is written in.** Do not reach for a User-Agent *device* class here — a narrowed desktop window would stay "desktop" and land you back on the overflowing dual panel above.
161
+ - **The mobile form drops the cross-field constraint on purpose** — no `minDate`/`maxDate` between the two cells. An inverted range is caught by the pair's error model, so keep that validation in the form; it is not inherited from the dual panel.
162
+
163
+ ## States
164
+
165
+ <Canvas of={DatePickerStories.DayCellStates} />
166
+
167
+ The **panel itself is static chrome** — there is no hover / pressed / selected on the container. Interaction lives in its parts: the **Day Cell** carries Default / Hover / Selected / In-Range / Today / Outside / Selected + Today / In-Range + Today, and the chevrons carry their own [`IconButton`](?path=/docs/design-system-atoms-iconbutton--docs) states.
168
+
169
+ ### Day Cell matrix
170
+
171
+ <table>
172
+ <thead>
173
+ <tr><th>State</th><th>Indicator</th><th>Numeral</th><th>Tokens</th></tr>
174
+ </thead>
175
+ <tbody>
176
+ <tr><td>Default</td><td>none (transparent)</td><td>Regular</td><td><code>--text-primary</code></td></tr>
177
+ <tr><td>Hover</td><td>disc</td><td>Regular</td><td>disc <code>--bg-hover</code>, numeral <code>--text-primary</code></td></tr>
178
+ <tr><td>Selected</td><td>disc</td><td><strong>Semibold</strong></td><td>disc <code>--secondary-solid</code>, numeral <code>--secondary-foreground</code></td></tr>
179
+ <tr><td>In-Range</td><td>full-bleed band (radius 0)</td><td>Regular</td><td>band <code>--bg-secondary</code>, numeral <code>--text-primary</code></td></tr>
180
+ <tr><td>Today</td><td>disc + <strong>4px dot</strong></td><td><strong>Semibold</strong></td><td>disc <code>--bg-primary</code>, dot <code>--secondary</code> centred under the numeral (4px above the disc edge), numeral <code>--text-primary</code></td></tr>
181
+ <tr><td><strong>Selected + Today</strong></td><td>disc + dot</td><td><strong>Semibold</strong></td><td>disc <code>--secondary-solid</code>, numeral <strong>and</strong> dot <code>--secondary-foreground</code></td></tr>
182
+ <tr><td><strong>In-Range + Today</strong></td><td>full-bleed band + dot</td><td>Regular</td><td>band <code>--bg-secondary</code>, numeral <code>--text-primary</code>, dot <code>--secondary</code> (the band is a soft tint, so the dot does not invert)</td></tr>
183
+ <tr><td>Outside / disabled</td><td>none</td><td>Regular</td><td><code>--disabled-foreground</code></td></tr>
184
+ </tbody>
185
+ </table>
186
+
187
+ Two rules the matrix deliberately does **not** contain and must not grow:
188
+
189
+ - **Today is a dot, not a ring — rings mean focus and nothing else.** The old Today ring wanted the same outermost 2px of the disc as the focus ring, in a blue only 1.33:1 away from it, and `outline` paints above `box-shadow` — so the focused Today cell, the one a panel focuses first, hid its own focus indicator. The dot (the Carbon / Apple pattern) removes the collision instead of ruling around it. It sits under the numeral, clear of the ring bands. On the plain Today cell "today" is additionally carried by the Semibold numeral; on **In-Range + Today** the numeral stays Regular on purpose (the band already owns the weight story), so there the non-colour carriers are the dot itself plus `aria-current="date"`.
190
+ - **Focus is not a cell state.** A calendar grid exposes **one** tabstop; the grid owns a single roving `:focus-visible` ring on the focused cell, drawn as an **inset double band** inside the disc (`--outline-focus` + a `--bg-primary` gap, concentric on `--radius-full`). Never an offset ring — the discs clear each other by 14px horizontally but only 2px vertically, and inside a range those neighbours carry a full-cell-height band, so an offset ring would land on paint rather than whitespace. The gap band is not optional either: the Selected disc is `--secondary-solid`, the **same hex** as `--outline-focus`, so a lone band would vanish on the one state where selection matters most. A per-cell resting border is not a DS state at all. The ring is **driven by the button and painted on the disc**: the `<button>` is what holds `:focus-visible`, while the manifest fixes the ring's geometry at *"the 36px circular layer centred in the cell … independent of the state's own indicator shape"* — so even on In-Range, where the indicator is a 48×36 rectangle, the ring stays a 36px circle.
191
+ - **Disabled reuses Outside.** `minDate` / `maxDate` are **caller constraints**, not a variant of their own — an out-of-range day renders with the Outside dim, and it is not marked as today either: there is no indicator for the dot to ride, and an unselectable date must not advertise itself.
192
+
193
+ Selected and Today **compose** — that is what the dot bought. A selected today keeps the solid disc and
194
+ flips the dot to `--secondary-foreground`, so it no longer stops reading as today. Under the ring
195
+ encoding the two were mutually exclusive and selection simply won.
196
+
197
+ **In-Range + Today was ours before it was the spec's.** The upstream axis had `Selected + Today` but
198
+ nothing for a today *inside* a range, while § Rationale already said the dot *"rides any indicator"*. We
199
+ took that literally and let it ride the band at the resting `--secondary`, rather than let a today inside
200
+ a range stop reading as today. Raised upstream
201
+ and adopted verbatim in day-cell **0.6.0** — the eighth value of the State axis, dot measured at
202
+ **5.59:1** on the `--bg-secondary` band.
203
+
204
+ ### Hover × selection — a Default-only treatment
205
+
206
+ **Hover is a Default-only treatment.** A `Selected` disc and an `In-Range` band **keep their own fill
207
+ under the pointer**; cursor and focus ring are the only pointer feedback those states get.
208
+
209
+ <table>
210
+ <thead>
211
+ <tr><th>State</th><th>Hover fill</th><th>Why</th></tr>
212
+ </thead>
213
+ <tbody>
214
+ <tr><td>Default</td><td><code>--bg-hover</code></td><td>the neutral wash, as specified — the indicator is transparent, so the wash is the whole affordance</td></tr>
215
+ <tr><td><strong>Today</strong></td><td><code>--bg-hover</code>, <strong>dot kept</strong></td><td>its disc is the plain <code>--bg-primary</code> surface, so the wash reads exactly as on Default; the dot is a separate element on top, so it survives</td></tr>
216
+ <tr><td><strong>Selected</strong> · <strong>Selected + Today</strong></td><td><strong>none</strong> — the solid disc stands</td><td>a ~3% wash over <code>--secondary-solid</code> is invisible, so it would be a class that does nothing</td></tr>
217
+ <tr><td><strong>In-Range</strong> · <strong>In-Range + Today</strong></td><td><strong>none</strong> — the band stands</td><td>a wash over <code>--bg-secondary</code> would <em>dull</em> the range rather than highlight the day</td></tr>
218
+ <tr><td>Outside / disabled</td><td>none</td><td>must not suggest it can be picked</td></tr>
219
+ </tbody>
220
+ </table>
221
+
222
+ This **replaces** what this build used to ship. The Day Cell spec names Checkbox and Radio as *"one
223
+ selection-control family"*, and those two model hover × selection as **two independent axes** with
224
+ *"checked fill → `--secondary-hover`"*; we followed the family, darkened a hovered Selected day one
225
+ ladder step, and asked upstream to split `axes.state` into `Selection × State`. Day Cell **0.6.3**
226
+ answered and **rejected the split**: Figma paints no Selected-Hover or In-Range-Hover variant, so a
227
+ matrix axis would have forced fabricated values. The rule went into prose instead, and
228
+ `hover:bg-secondary-hover` was **deleted, not moved** — which is why `--secondary-hover` no longer
229
+ appears in this page's token list.
230
+
231
+ ### Bounds
232
+
233
+ <Canvas of={DatePickerStories.Bounds} />
234
+
235
+ **Bounds disable, they do not clamp.** At the `minDate` month the `‹` (and `«` in single month) go **disabled** rather than paging into an all-out-of-range view; at the `maxDate` month the `›` (and `»`) do. Out-of-range days that remain visible inside a still-reachable month keep the Outside / disabled treatment.
236
+
237
+ ### Range selection
238
+
239
+ Dual month only. What a click does depends on how much of the range already exists:
240
+
241
+ <table>
242
+ <thead>
243
+ <tr><th>Current value</th><th>Click</th><th>Result</th></tr>
244
+ </thead>
245
+ <tbody>
246
+ <tr><td>empty</td><td>any day</td><td><code>{'{ from: day }'}</code> — the range is open, waiting for its end</td></tr>
247
+ <tr><td>open (<code>from</code> only)</td><td>a day after <code>from</code></td><td><code>{'{ from, to: day }'}</code> — the range closes</td></tr>
248
+ <tr><td>open (<code>from</code> only)</td><td>a day before <code>from</code></td><td><code>{'{ from: day, to: from }'}</code> — the ends swap, so a range is never inverted</td></tr>
249
+ <tr><td><strong>complete</strong></td><td><strong>any day, inside or outside</strong></td><td><strong><code>{'{ from: day }'}</code> — the old range is dropped and a new one starts</strong></td></tr>
250
+ </tbody>
251
+ </table>
252
+
253
+ **A click on a complete range restarts it, it never moves one endpoint.** Restarting is the one behaviour that is the same wherever the user clicks, so the panel never has to guess whether a click inside the band means "shorten" or "start over" — and every range is still reachable in two clicks. To widen a range by a day, reselect both ends; there is no drag-an-edge affordance. This case is **not covered by the spec** — the upstream manifest describes the range band's geometry but never says what a re-click does — so it is decided here rather than inherited from react-day-picker, whose default moves an endpoint.
254
+
255
+ ### Navigation behaviour
256
+
257
+ <table>
258
+ <thead>
259
+ <tr><th>Button</th><th>Glyph</th><th>Action</th><th>Modes</th><th><code>aria-label</code></th></tr>
260
+ </thead>
261
+ <tbody>
262
+ <tr><td>Previous month</td><td><code>‹</code></td><td>view back one month</td><td>both — in dual month the <strong>pair</strong> shifts by one month</td><td><code>Předchozí měsíc</code></td></tr>
263
+ <tr><td>Next month</td><td><code>›</code></td><td>view forward one month</td><td>both — dual month shifts the pair</td><td><code>Další měsíc</code></td></tr>
264
+ <tr><td>Previous year</td><td><code>«</code></td><td>view back one year</td><td><strong>single month only</strong></td><td><code>Předchozí rok</code></td></tr>
265
+ <tr><td>Next year</td><td><code>»</code></td><td>view forward one year</td><td><strong>single month only</strong></td><td><code>Další rok</code></td></tr>
266
+ </tbody>
267
+ </table>
268
+
269
+ **Dual-month paging is paired** — both columns always move together, never independently, so the two-month window stays contiguous. All four buttons are `IconButton` instances (`variant="secondary"`, `size="sm"` → 32×32), never bespoke buttons. Their accessible names come from the required `navLabels` prop.
270
+
271
+ ## Copy
272
+
273
+ <Canvas of={DatePickerStories.Localisation} />
274
+
275
+ All chrome text is **locale-driven**, machine-generated from the active locale — never hand-authored per screen. The voice rule is simply "match the locale, don't hard-code Czech."
276
+
277
+ - **Week start is a locale setting, not a constant.** CZ / SK render **Monday-first**; US English renders **Sunday-first**. The weekday caption row *and* the grid column order both follow it — **never hard-code Monday**. (`weekStartsOn` exists as an escape hatch and is rarely needed.)
278
+ - **Weekday abbreviations** — two letters, capitalised, locale-formatted: `Po · Út · St · Čt · Pá · So · Ne`. **Diacritics are part of the string** (`Út`, `Čt`, `Pá`) — do not strip them.
279
+ - **Month caption** — `{Month} {Year}`: the full month name in the **nominative** + a 4-digit year, e.g. `Duben 2023`. Not the genitive (`dubna`) — that form belongs to the field's formatted value, not the panel caption.
280
+ - **Day numerals** — `1`–`31`, no leading zero.
281
+ - **Accessible date name** — the full date in the **genitive** (`15. dubna 2023`) is the day's accessible name, not the bare numeral.
282
+
283
+ ## API
284
+
285
+ <Controls />
286
+
287
+ `navLabels` is **required**: the four chevrons are icon-only, and the design system is
288
+ locale-agnostic, so the consumer supplies and translates
289
+ `{ previousMonth, nextMonth, previousYear, nextYear }`. There is no built-in default — an
290
+ accessible name that only a screen reader ever hears is the one that ships untranslated.
291
+
292
+ `DatePickerProps` is a **discriminated union** on `variant`: `single-month` takes `value?: Date` and `onValueChange?: (value: Date | undefined) => void`; `dual-month` takes `value?: DateRange` / `onValueChange?: (value: DateRange | undefined) => void`. The Controls table flattens the union, so pair `variant` with the matching `value` type in real code.
293
+
294
+ ## Do / Don't
295
+
296
+ - ✅ Open it from a date field as an **anchored overlay** (`DateField` owns the trigger and the dialog role)
297
+ - ✅ Put it inside a **host surface** — the Popover surface recipe for an anchored panel, the drawer or sheet itself on mobile
298
+ - ✅ Pick the variant by task: one day → `single-month`, a range → `dual-month`
299
+ - ✅ Let the **locale** decide the first weekday and the abbreviations
300
+ - ✅ Draw a range as **one continuous band behind the discs**, with the Selected end-caps on top
301
+ - ✅ Let a click on a **complete** range **restart** it from the clicked day
302
+ - ✅ Use `IconButton` chevrons for paging; keep the year double-chevrons to single month
303
+ - ✅ Use `minDate` / `maxDate` to bound the window — out-of-range days reuse Outside
304
+ - ❌ Use it as an always-visible **inline calendar**, a **month/year jump picker** or a **scheduling grid**
305
+ - ❌ Give it its own border, shadow or radius, or nest it as a card inside another surface
306
+ - ❌ Draw a hairline between the two Dual month columns — the month padding is the only seam
307
+ - ❌ Show a dual-month range panel for a single form date, or drop to one month when a range spans the boundary
308
+ - ❌ Hard-code Monday-first, or strip the diacritics from `Út · Čt · Pá`
309
+ - ❌ Move a single endpoint when a complete range is re-clicked, or make the outcome depend on where inside the band the click landed
310
+ - ❌ Fake a range with per-cell In-Range fills that read as detached pills
311
+ - ❌ Shrink the day's `<button>` down to the 36px disc — the hit area is the cell; or wash a Selected disc / In-Range band on hover
312
+ - ❌ Build bespoke chevron buttons, or add year double-chevrons to dual month
313
+ - ❌ Mark today with a ring — that is the focus language; or invent an eighth "disabled" Day Cell state
314
+
315
+ ## Accessibility
316
+
317
+ - **Semantics** — the **host** is the `role="dialog"` (anchored Popover surface, sheet or drawer), named by `aria-labelledby` / `aria-label`; the Date Picker itself renders no dialog. For a date field the dialog role, anchoring and dismissal are set by **`DateField`** (`useDateFieldTrigger`) on the floating wrapper it renders *around* this component, which is also where the Popover surface is drawn. Each month is a `role="grid"` with `role="row"` rows and `role="gridcell"` cells. The selectable content of a cell is a `<button>` **that fills the whole 48×36 cell**; the 36px indicator disc is a non-interactive `<span>` inside it.
318
+ - **Keyboard** — each grid holds **one** roving `tabindex`, and it is literally one tab stop: exactly one day button carries `tabindex="0"` — the **selected date, else today, else the first day** — and every other day carries `tabindex="-1"`. Arrow keys move the focused day; `Home` / `End` jump to the start / end of the week; `PageUp` / `PageDown` page by **month**; `Shift+PageUp` / `Shift+PageDown` page by **year** (single month); `Enter` / `Space` selects; `Esc` closes the overlay and returns focus to the trigger. The chevrons sit in the tab order as a pointer shortcut for the same paging.
319
+ - **Focus** — a single roving `:focus-visible` ring owned by the grid, drawn as an inset double band inside the disc, never a per-cell resting border and never an offset ring (see [States](#states)). `:focus-visible`, `Enter` / `Space` and the ring all belong to the **button**, never to the disc — the disc is only where the ring is *painted*. The chevrons carry their own `IconButton` focus rings. `autoFocus` moves focus into the grid on mount, landing on the selected day (or today) — an overlay consumer should set it so the keyboard lands on a date, not on the first chevron.
320
+ - **ARIA state** — `aria-selected="true"` on the chosen date; out-of-range days carry **both** the native `disabled` attribute and `aria-disabled="true"`. Each grid is named by its own caption through `aria-labelledby` (`Duben 2023`), so the name can never drift from the text on screen.
321
+ - **Screen reader** — a day announces its **full date** (`15. dubna 2023`), so selection / today / disabled are conveyed by name + ARIA, never by the highlight colour alone. Today additionally carries `aria-current="date"` (the WAI-ARIA APG calendar convention), which composes with the `aria-selected` on a Selected + Today cell — the accessible name here is the bare date, so the dot is not the only signal. The weekday `<thead>` is `aria-hidden` (see Implementation notes).
322
+ - **Target size** — each Day Cell is a 48×36 hit area (larger than the 36px disc) because the `<button>` *is* the cell, not the disc. The chevrons are 32×32 `IconButton`s with the standard padded hit area.
323
+ - **Contrast & motion** — colours come from semantic tokens (`--secondary-solid` / `--secondary-foreground` for the selection, `--disabled-foreground` for Outside). The panel itself is static (manifest 1.2.1 `motion.none`: „surfaceless panel — the day cells and the month arrows carry the motion“; `inherits: [date-picker-day-cell, icon-button]`); the month arrows are IconButtons with their own hover / press colour transitions (`--duration-hover` / `--duration-press`). The only animation in the grid is a colour transition on the indicator disc (day-cell 0.7.2 `motion.states`): `background-color` / `color` on `--easing-standard`, `--duration-hover` (150ms) for the hover wash and `--duration-toggle` (100ms) for a day becoming Selected. CSS takes the duration from the state a transition lands in, so a day being **de**selected clears on `--duration-hover`. The In-Range band is mounted and unmounted with the range, so its fill flips at once — a mount transition would also replay on every month page. The focus ring (inset shadow) is not in the property list and is never eased. Colour only, so no reduced-motion override.
324
+
325
+ Accessibility floor for every FODS component: `spec/01-foundations/accessibility.md`.
326
+
327
+ ## Usage
328
+
329
+ ```tsx
330
+ // Good — single day in a form, opened from a DateField
331
+ const [issuedOn, setIssuedOn] = React.useState<Date | undefined>();
332
+
333
+ // DateField renders this for you — shown here to make the host visible.
334
+ <div role="dialog" aria-label="Datum vystavení" className={popoverSurfaceVariants({ className: 'gap-0 py-0' })}>
335
+ <DatePicker
336
+ variant="single-month"
337
+ navLabels={navLabels}
338
+ value={issuedOn}
339
+ onValueChange={setIssuedOn}
340
+ minDate={new Date(2023, 0, 1)}
341
+ autoFocus
342
+ />
343
+ </div>;
344
+ ```
345
+
346
+ ```tsx
347
+ // Good — a range for a filter / accounting period
348
+ const [period, setPeriod] = React.useState<DateRange | undefined>({
349
+ from: new Date(2023, 3, 11),
350
+ to: new Date(2023, 4, 3),
351
+ });
352
+
353
+ <Popover.Content className={popoverSurfaceVariants({ className: 'gap-0 py-0 outline-none' })}>
354
+ <DatePicker variant="dual-month" navLabels={navLabels} value={period} onValueChange={setPeriod} />
355
+ </Popover.Content>;
356
+ ```
357
+
358
+ ```tsx
359
+ // Don't — a surface on the picker itself (it has none since 1.0.0; the host draws it)
360
+ <DatePicker className="rounded-500 border shadow-overlay" />;
361
+
362
+ // Don't — dual month for a single form date (a range panel for a one-day pick)
363
+ <DatePicker variant="dual-month" value={issuedOn} />;
364
+
365
+ // Don't — hard-coding Monday instead of letting the locale decide
366
+ <DatePicker weekStartsOn={1} locale={enUS} />;
367
+
368
+ // Don't — a permanently mounted inline calendar; it is an anchored overlay
369
+ <div className="sidebar">
370
+ <DatePicker />
371
+ </div>;
372
+ ```
373
+
374
+ ## Related
375
+
376
+ - [`DateField`](?path=/docs/design-system-molecules-datefield--docs) — the trigger that opens and anchors this panel, and owns the dialog semantics
377
+ - [`TextField`](?path=/docs/design-system-atoms-textfield--docs) — the input shell `DateField` reuses
378
+ - [`Field`](?path=/docs/design-system-atoms-field--docs) — floating label / helper / error chrome around the field
379
+ - [`IconButton`](?path=/docs/design-system-atoms-iconbutton--docs) — the four header chevrons (`variant="secondary"`, `size="sm"`)
380
+ - [`Popover Surface`](?path=/docs/design-system-patterns-popover-surface--docs) — the **host** of an anchored picker since 1.0.0: `popoverSurfaceVariants`, padless (`gap-0 py-0`), draws the fill, border, radius and `--shadow-overlay` the picker no longer has
381
+ - Spec: `spec/04-molecules/date-picker.md` · `spec/03-atoms/date-picker-day-cell.md`
382
+ - [react-day-picker v10 docs](https://daypicker.dev/) — the underlying calendar primitive
383
+
384
+ ## Implementation notes
385
+
386
+ Where the React build deviates from a literal reading of the spec, and why.
387
+
388
+ 1. **Built on `react-day-picker` v10 — its stylesheet is never imported.** The spec's own `delivery.react` contract asks for a `role="grid"` month with one roving tabindex, arrow-key day movement, `PageUp`/`PageDown` month paging and `Shift+PageUp`/`Shift+PageDown` year paging — which is exactly react-day-picker's keyboard model, down to the modifier keys. What is *not* taken is any of its styling: every visual comes from a `classNames` map bound token-for-token to the manifest.
389
+ 2. **The range band is drawn per cell** with a gap-bridging overhang. This used to be listed here as a deviation; as of the 2026-08-13 per-cell rebuild it **is the spec** — upstream rewrote `chrome.rangeBand` to per-cell segments (`edge: full | start | end`) after we reported that the row-level rectangle it previously mandated is not an element anyone can place: a `<tr>` may only contain `<td>` / `<th>`, so a non-`<td>` child is invalid HTML, the parser **foster-parents** it out of the table on any server-rendered pass, and it muddies the table semantics assistive tech reads off the grid. The Don't now targets *detached pills* — per-cell fills **with gaps** — rather than per-cell as a technique. The band overhangs the 2px cell gap only towards a neighbour that is itself in the span **and** in the same row (overhanging at a row edge would bleed a sliver into the month padding), which is what makes the geometry — end-caps at the midpoints of the start / end cells included — identical to one continuous rectangle.
390
+ 3. **The caption labels its grid via `aria-labelledby`**, per spec — which takes a small workaround, because react-day-picker renders caption and `<table>` as siblings and gives the table no month identity of its own (its own wiring copies the caption *string* onto the table as an `aria-label`). `components.Month` is the only place that sees both plus the `displayIndex`, so it hands a generated caption id down through a React context: `MonthCaption` puts it on the caption element, `MonthGrid` points `aria-labelledby` at it and drops the `aria-label`.
391
+ 4. **Out-of-range days carry both native `disabled` and `aria-disabled`**, where the spec names only the latter.
392
+ 5. **The weekday `<thead>` is `aria-hidden`** — react-day-picker's decision, deliberately left standing: every day already announces its full date, so seven weekday headers on top of that is noise, not information. The spec's a11y section does not ask for column headers.
393
+ 6. **The year double-chevrons are ordinary icon glyphs.** They used to be call-site inline SVG (the Figma vectors, lifted from the component set) because the icon set had no double caret; it now ships `caret-double-left-small` / `caret-double-right-small`, so the header renders `<Icon name="caret-double-left-small" />` like every other chevron and takes its colour and size from the `IconButton`.
394
+ The calibration that used to live at the call site now lives in the SVG source. The inline version had to render at **10px** rather than the 20px `IconButton` Size-S icon tier, because the Figma vector fills its 10×10 viewBox edge to edge while the neighbouring **small** single chevron draws its caret well inside its own box — at the tier number the double caret came out visibly bigger and heavier. The two new glyphs are drawn into a 24×24 box at exactly the drawn height of `caret-left-small` / `caret-right-small` (9.4736, centred on 12,12), so the carets match at whatever size the tier hands them. Re-check that drawn height, not the call site, if the single chevrons are ever redrawn.
395
+ 7. **`Home` / `End` come from react-day-picker**, whose keymap covers them alongside the arrows and `PageUp`/`PageDown` and stops propagation while a day has focus. `DatePicker.test.tsx` asserts them anyway, so an rdp upgrade that drops them cannot go unnoticed.
396
+ 8. **The dual-month caption is centred by an inert spacer.** The header is `space-between` per the manifest, which centres the caption in single month for free — `« ‹` and `› »` are equally wide. Dual month has a chevron on one side only, so `space-between` alone would shove each caption against the other month. The empty side therefore renders an `aria-hidden` box one chevron wide (`size-900` — the same 32×32 `IconButton` Size-S token the real buttons resolve to). A `visibility: hidden` *copy* of the nav group would size itself automatically, but it also puts a second set of chevron buttons in the DOM, and jsdom has no stylesheet to hide them with — the accessible-name queries in the tests would then match two buttons instead of one.
397
+ 9. **A click on a complete range restarts it** — `onSelect` is intercepted rather than passed straight through, because react-day-picker's `addToRange` moves an endpoint instead (a click inside shrinks `to`; a click before `from` extends left), which makes restarting a selection by clicking impossible. See [Range selection](#range-selection); the open and empty cases still fall through to the library.
398
+ 10. **The dual-month panel deliberately has no mobile behaviour — closed upstream 2026-08-05.** It is a fixed ≈760px wide and overflows below roughly 800px, and both obvious escapes are explicitly ruled out: [Sizes](#sizes) says the 48×36 Day Cell must not be scaled, and [Do / Don't](#do--dont) forbids dropping to one month when a range spans the boundary. Manifest 0.5.0 answers it by **moving the problem out of this component**: on mobile a range field is not a Date Picker at all, it is two independent [`FieldPair`](?path=/docs/design-system-molecules-fieldpair--docs) cells, each opening its own single-month panel (see [Mobile](#mobile)). Nothing responsive is therefore implemented for dual month, and that is now the spec, not a gap.
399
+ 11. **Swapping `DayButton` means re-implementing the focus effect.** This is the trap to know about before touching `components.DayButton`: react-day-picker moves the roving cursor by flipping a `focused` modifier and relies on **its own** `DayButton` to pull DOM focus in a `useEffect`. Replace that component without carrying the effect over and the arrow keys go silently dead — the modifier still flips, but nothing ever calls `.focus()`. The effect is kept in our custom button, and `DatePicker.test.tsx` covers it.
400
+ 12. **One day = two elements, and rdp's props all belong to the outer one.** `components.DayButton` renders a `<button>` that fills the cell and a `<span>` disc inside it (day-cell 0.6.2). Everything the library hands down — `tabIndex`, `onClick`, `disabled`, `aria-label`, `aria-selected` — stays on the `<button>`, together with our own `aria-current`, `aria-disabled` and the `data-day-state` marker a runtime check narrows by. The span only draws. The **roving priority order is the library's**, not ours: `calculateFocusTarget` ranks focused-modifier → last-focused → **selected → today → first focusable day**, which is exactly the order day-cell 0.6.3 spells out, so nothing is re-implemented here — it is asserted in `DatePicker.test.tsx` so an rdp upgrade cannot change it silently.
401
+
402
+ ## Migration notes
403
+
404
+ ### 1.2.0 → 1.2.1 — motion block (2026-11-03)
405
+
406
+ The panel is declared static (`motion.none`) and lists the children whose motion applies: the Day Cell (below) and the month-arrow IconButtons. Documentation only for the panel itself.
407
+
408
+ ### Day Cell 0.7.1 → 0.7.2 — motion block (2026-11-03)
409
+
410
+ The day-cell manifest gains `motion.states.hover` / `motion.states.toggle`. The indicator's raw `transition-colors duration-150` became `transition-[background-color,color] duration-hover ease-standard`, with `duration-toggle` on the Selected states — see [Accessibility](#accessibility) → Contrast & motion.
411
+
412
+ ### 0.8.3 → 1.2.0 — the surface moves to the host (breaking)
413
+
414
+ Built from the manifest.
415
+
416
+ - **1.0.0 — no surface.** The root lost `bg-background-primary border-100 border-outline-default rounded-500 shadow-overlay` and is now `data-fods-part="root"` with `inline-flex` only (the former `surface` part is gone). The values did not change — they moved to the host, kept upstream as `chrome.host.legacy-surface`: `--bg-primary`, 1px `--outline-default` (`--border-width-100`), `--radius-500`, `--shadow-overlay`. That is exactly the Popover surface recipe, so every host uses `popoverSurfaceVariants` **padless** (`gap-0 py-0`) — the month columns pad themselves and the host adds nothing around a bare picker (migration step 4).
417
+
418
+ **Where the surface went:** an anchored single-month date field draws the Popover surface inside its floating panel (the transition styles moved with it); an anchored dual-month filter period draws it on its popover content; a mobile filter drawer is the surface itself, so the calendar sits flush on it (a deliberate visual change, spec § chrome.host).
419
+
420
+ - **1.0.1 / 1.0.2 — prose only.** Selection mode is the caller's, not the layout's: Single month may host a **range** in the narrow / mobile Date range composition. This build still couples the two (`single-month` ⇒ `Date`, `dual-month` ⇒ `DateRange`), so the mobile filter period keeps the dual panel in a horizontally scrolling group. Decoupling the selection mode and building the Date range composition (Od → Do fields, footer actions) is an open follow-up, not part of this update.
421
+ - **1.1.0 → 1.2.0 — no month separator.** The 1.1.0 token swap (`--outline-strong` → `--outline-default`) was superseded the same day: the hairline (`border-l-100 border-outline-strong first:border-l-0`) is deleted, the columns sit side by side and Dual month is 760px wide instead of 761. `--outline-strong`, `--outline-default`, `--border-width-100`, `--radius-500` and `--shadow-overlay` left this page's token list.
422
+
423
+ ### Earlier notes
424
+
425
+ New molecule — **no prior component to replace**; there was no React calendar in the design system before it. Notes carried over:
426
+
427
+ - **Single-month mode** was an open item upstream and landed 2026-07-08: both modes tile the same 48×36 Day Cell, so no smaller cell size was needed — the single-month panel is one month column in the same chrome.
428
+ - **Year double-chevrons are a scope decision, single month only.** Do not add them to the dual-month range panel.
429
+ - **Today stopped being a ring** (day-cell 0.5.0 → 0.5.2, QA 2026-08-13): minus one outline, plus a 4px `--secondary` dot, plus the new `Selected + Today` state. The `--secondary` binding is inherited from the ring it replaced — a 2026-07-08 rebind off `--outline-focus`, so that a resting "today" decoration is never conflated with keyboard focus. The Selected disc rebind `--secondary` → `--secondary-solid` (same hex) still stands, matching the Checkbox / Radio selection language.
430
+ - **Today also composes with the range band** (day-cell **0.6.0**, 2026-08-14): the `In-Range + Today` state closes for the range case what `Selected + Today` closed for the selection case. Renders as plain In-Range — band `--bg-secondary`, numeral Regular (the dot carries "today", never a weight bump) — plus the dot at its resting `--secondary`, 5.59:1 on the band. We had shipped it locally before the axis had a value for it; upstream adopted our version unchanged.
431
+ - **The hit area moved from the disc to the cell** (day-cell **0.6.2**). The `<button>` used to *be* the 36px disc, so the tap target was 36×36 while both specs promised 48×36. That was not a defect we could fix on our own: the same `delivery.react` also called the cell *"NOT a real focusable control"*, so the contradiction was undecidable and waited on upstream. 0.6.2 decided it — *"the hit area is the cell, never the disc"* — and the button grew to the tile with the disc as a `<span>` inside it. **Nothing about the paint changed**: same 36px `--radius-full` disc, same full-bleed range band. What changed is which element is clickable, focusable and hoverable, which is why the hover wash and the focus ring are now driven from the button (`group-hover:` / `group-focus-visible:`) and still painted on the disc.
432
+ - **Hover stopped applying to Selected and In-Range** (day-cell **0.6.3**) — see [States](#states). We shipped the Checkbox / Radio family's two-axis answer and asked for the axis to be split; upstream rejected the split and made hover a Default-only treatment in prose. `--secondary-hover` left this component's token list with it.
433
+ - **The cell focus ring moved from `offset` to `inset-double`** in the same pass. Our first implementation used the pattern's default offset ring; it was rejected on geometry, not taste — the discs clear each other by only 2px vertically, and inside a range those neighbours are filled. There was never a rule about migrating Today to `::before` on `:focus-visible`: it was raised and deleted inside one upstream branch and never reached `main`.
434
+ - **The 48×36 became a number a tool can read** (day-cell **0.7.0**, 2026-09-17). The hit area the 0.6.2 pass decided was stated in prose five times and published as a value nowhere: `sizes[0]` carried `height: 36` and `box: 36` — the painted disc — so the one property that decision is about was the one property no consumer could bind. 0.7.0 adds `sizes[0].hitArea` (`{width: 48, height: 36}`), on the Number Field 1.7.0 precedent. **No visual change**: the cell already emitted `w-1100 h-[36px]`. What changed is that a runtime check can now assert it (part `day-cell`), so a future narrowing of the tile is a finding instead of a silent regression.
435
+ - **Two prose fixes rode along in 0.7.0.** `delivery.react` still opened with *"NOT a real focusable control per cell"* — contradicted four sentences later by *"exactly ONE day button carries `tabindex=0`"* — and carried a truncated fragment; `focus.note` still called the disc *"the target"*, against `delivery.react` and both `.md` files. Both were fields 0.6.2 had rewritten and left half-migrated.
436
+ - **`react-day-picker` moved from v9.14 to v10** (2026-11-18). v10 removes the APIs v9 had deprecated and publishes the same API under the new name `@daypicker/react`; the old package name stays. The `classNames` keys and every component this panel overrides are unchanged, so the code needed no change and `DatePicker`'s API did not move. The import still names `react-day-picker`.