@invoiceonline/ui-react 0.0.0 → 0.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (731) hide show
  1. package/AGENTS.md +100 -0
  2. package/CHANGELOG.md +149 -0
  3. package/LICENSE +9 -0
  4. package/README.md +77 -1
  5. package/dist/assets/label-brush-1.svg +6 -0
  6. package/dist/assets/pattern-dark.svg +113 -0
  7. package/dist/components/action-row/ActionRow.d.ts +178 -0
  8. package/dist/components/action-row/ActionRow.js +340 -0
  9. package/dist/components/action-row/index.d.ts +2 -0
  10. package/dist/components/action-row/index.js +1 -0
  11. package/dist/components/alert/Alert.d.ts +314 -0
  12. package/dist/components/alert/Alert.js +446 -0
  13. package/dist/components/alert/index.d.ts +2 -0
  14. package/dist/components/alert/index.js +1 -0
  15. package/dist/components/anchored-panel/AnchoredPanel.d.ts +41 -0
  16. package/dist/components/anchored-panel/AnchoredPanel.js +72 -0
  17. package/dist/components/anchored-panel/index.d.ts +3 -0
  18. package/dist/components/anchored-panel/index.js +3 -0
  19. package/dist/components/badge/Badge.d.ts +146 -0
  20. package/dist/components/badge/Badge.js +258 -0
  21. package/dist/components/badge/index.d.ts +2 -0
  22. package/dist/components/badge/index.js +1 -0
  23. package/dist/components/banner/Banner.d.ts +209 -0
  24. package/dist/components/banner/Banner.js +339 -0
  25. package/dist/components/banner/index.d.ts +2 -0
  26. package/dist/components/banner/index.js +1 -0
  27. package/dist/components/button/Button.d.ts +54 -0
  28. package/dist/components/button/Button.js +312 -0
  29. package/dist/components/button/index.d.ts +2 -0
  30. package/dist/components/button/index.js +1 -0
  31. package/dist/components/button-group/ButtonGroup.d.ts +187 -0
  32. package/dist/components/button-group/ButtonGroup.js +217 -0
  33. package/dist/components/button-group/index.d.ts +2 -0
  34. package/dist/components/button-group/index.js +1 -0
  35. package/dist/components/card-select/CardSelect.d.ts +274 -0
  36. package/dist/components/card-select/CardSelect.js +561 -0
  37. package/dist/components/card-select/CardSelectGroup.d.ts +92 -0
  38. package/dist/components/card-select/CardSelectGroup.js +72 -0
  39. package/dist/components/card-select/index.d.ts +3 -0
  40. package/dist/components/card-select/index.js +3 -0
  41. package/dist/components/checkbox/Checkbox.d.ts +104 -0
  42. package/dist/components/checkbox/Checkbox.js +194 -0
  43. package/dist/components/checkbox/index.d.ts +2 -0
  44. package/dist/components/checkbox/index.js +1 -0
  45. package/dist/components/chip/Chip.d.ts +250 -0
  46. package/dist/components/chip/Chip.js +441 -0
  47. package/dist/components/chip/index.d.ts +2 -0
  48. package/dist/components/chip/index.js +1 -0
  49. package/dist/components/column-header/ColumnHeader.d.ts +144 -0
  50. package/dist/components/column-header/ColumnHeader.js +209 -0
  51. package/dist/components/column-header/index.d.ts +2 -0
  52. package/dist/components/column-header/index.js +1 -0
  53. package/dist/components/combobox-field/Combobox.d.ts +104 -0
  54. package/dist/components/combobox-field/Combobox.js +355 -0
  55. package/dist/components/combobox-field/ComboboxField.d.ts +76 -0
  56. package/dist/components/combobox-field/ComboboxField.js +98 -0
  57. package/dist/components/combobox-field/index.d.ts +3 -0
  58. package/dist/components/combobox-field/index.js +3 -0
  59. package/dist/components/date-picker/DatePicker.d.ts +53 -0
  60. package/dist/components/date-picker/DatePicker.js +329 -0
  61. package/dist/components/date-picker/index.d.ts +2 -0
  62. package/dist/components/date-picker/index.js +1 -0
  63. package/dist/components/divider/Divider.d.ts +81 -0
  64. package/dist/components/divider/Divider.js +93 -0
  65. package/dist/components/divider/index.d.ts +2 -0
  66. package/dist/components/divider/index.js +1 -0
  67. package/dist/components/drawer/Drawer.d.ts +128 -0
  68. package/dist/components/drawer/Drawer.js +367 -0
  69. package/dist/components/drawer/index.d.ts +2 -0
  70. package/dist/components/drawer/index.js +1 -0
  71. package/dist/components/dropdown-button/DropdownButton.d.ts +72 -0
  72. package/dist/components/dropdown-button/DropdownButton.js +122 -0
  73. package/dist/components/dropdown-button/index.d.ts +2 -0
  74. package/dist/components/dropdown-button/index.js +1 -0
  75. package/dist/components/faq/FAQ.d.ts +135 -0
  76. package/dist/components/faq/FAQ.js +258 -0
  77. package/dist/components/faq/index.d.ts +2 -0
  78. package/dist/components/faq/index.js +1 -0
  79. package/dist/components/field/Field.d.ts +119 -0
  80. package/dist/components/field/Field.js +332 -0
  81. package/dist/components/field/index.d.ts +2 -0
  82. package/dist/components/field/index.js +1 -0
  83. package/dist/components/field-pair/FieldPair.d.ts +210 -0
  84. package/dist/components/field-pair/FieldPair.js +335 -0
  85. package/dist/components/field-pair/index.d.ts +2 -0
  86. package/dist/components/field-pair/index.js +1 -0
  87. package/dist/components/file-upload/FileUpload.d.ts +137 -0
  88. package/dist/components/file-upload/FileUpload.js +434 -0
  89. package/dist/components/file-upload/index.d.ts +2 -0
  90. package/dist/components/file-upload/index.js +1 -0
  91. package/dist/components/filter-chip/FilterChip.d.ts +373 -0
  92. package/dist/components/filter-chip/FilterChip.js +517 -0
  93. package/dist/components/filter-chip/index.d.ts +2 -0
  94. package/dist/components/filter-chip/index.js +1 -0
  95. package/dist/components/filter-facet/FilterFacet.d.ts +116 -0
  96. package/dist/components/filter-facet/FilterFacet.js +632 -0
  97. package/dist/components/filter-facet/index.d.ts +2 -0
  98. package/dist/components/filter-facet/index.js +1 -0
  99. package/dist/components/firm-avatar/FirmAvatar.d.ts +75 -0
  100. package/dist/components/firm-avatar/FirmAvatar.js +119 -0
  101. package/dist/components/firm-avatar/index.d.ts +2 -0
  102. package/dist/components/firm-avatar/index.js +1 -0
  103. package/dist/components/form-actions/FormActions.d.ts +123 -0
  104. package/dist/components/form-actions/FormActions.js +195 -0
  105. package/dist/components/form-actions/index.d.ts +2 -0
  106. package/dist/components/form-actions/index.js +1 -0
  107. package/dist/components/form-block/FormBlock.d.ts +252 -0
  108. package/dist/components/form-block/FormBlock.js +420 -0
  109. package/dist/components/form-block/index.d.ts +3 -0
  110. package/dist/components/form-block/index.js +3 -0
  111. package/dist/components/form-section/FormSection.d.ts +130 -0
  112. package/dist/components/form-section/FormSection.js +206 -0
  113. package/dist/components/form-section/index.d.ts +2 -0
  114. package/dist/components/form-section/index.js +1 -0
  115. package/dist/components/heading/Heading.d.ts +69 -0
  116. package/dist/components/heading/Heading.js +79 -0
  117. package/dist/components/heading/index.d.ts +2 -0
  118. package/dist/components/heading/index.js +1 -0
  119. package/dist/components/heading-group/HeadingGroup.d.ts +258 -0
  120. package/dist/components/heading-group/HeadingGroup.js +255 -0
  121. package/dist/components/heading-group/index.d.ts +2 -0
  122. package/dist/components/heading-group/index.js +1 -0
  123. package/dist/components/hero/Hero.d.ts +268 -0
  124. package/dist/components/hero/Hero.js +316 -0
  125. package/dist/components/hero/index.d.ts +2 -0
  126. package/dist/components/hero/index.js +1 -0
  127. package/dist/components/icon/Icon.d.ts +27 -0
  128. package/dist/components/icon/Icon.js +30 -0
  129. package/dist/components/icon/index.d.ts +3 -0
  130. package/dist/components/icon/index.js +3 -0
  131. package/dist/components/icon-button/IconButton.d.ts +75 -0
  132. package/dist/components/icon-button/IconButton.js +151 -0
  133. package/dist/components/icon-button/index.d.ts +2 -0
  134. package/dist/components/icon-button/index.js +1 -0
  135. package/dist/components/item-row/ItemRow.d.ts +253 -0
  136. package/dist/components/item-row/ItemRow.js +496 -0
  137. package/dist/components/item-row/index.d.ts +2 -0
  138. package/dist/components/item-row/index.js +1 -0
  139. package/dist/components/list-row/ListRow.d.ts +165 -0
  140. package/dist/components/list-row/ListRow.js +233 -0
  141. package/dist/components/list-row/index.d.ts +2 -0
  142. package/dist/components/list-row/index.js +1 -0
  143. package/dist/components/menu/Menu.d.ts +64 -0
  144. package/dist/components/menu/Menu.js +186 -0
  145. package/dist/components/menu/index.d.ts +2 -0
  146. package/dist/components/menu/index.js +1 -0
  147. package/dist/components/modal/Modal.d.ts +272 -0
  148. package/dist/components/modal/Modal.js +788 -0
  149. package/dist/components/modal/index.d.ts +2 -0
  150. package/dist/components/modal/index.js +1 -0
  151. package/dist/components/nav-link/NavLink.d.ts +123 -0
  152. package/dist/components/nav-link/NavLink.js +157 -0
  153. package/dist/components/nav-link/index.d.ts +2 -0
  154. package/dist/components/nav-link/index.js +1 -0
  155. package/dist/components/number-field/NumberField.d.ts +62 -0
  156. package/dist/components/number-field/NumberField.js +210 -0
  157. package/dist/components/number-field/index.d.ts +2 -0
  158. package/dist/components/number-field/index.js +1 -0
  159. package/dist/components/pagination/Pagination.d.ts +133 -0
  160. package/dist/components/pagination/Pagination.js +217 -0
  161. package/dist/components/pagination/index.d.ts +3 -0
  162. package/dist/components/pagination/index.js +3 -0
  163. package/dist/components/popover-surface/index.d.ts +2 -0
  164. package/dist/components/popover-surface/index.js +1 -0
  165. package/dist/components/progress-bar/ProgressBar.d.ts +260 -0
  166. package/dist/components/progress-bar/ProgressBar.js +470 -0
  167. package/dist/components/progress-bar/index.d.ts +2 -0
  168. package/dist/components/progress-bar/index.js +1 -0
  169. package/dist/components/promo-sticker/PromoSticker.d.ts +204 -0
  170. package/dist/components/promo-sticker/PromoSticker.js +177 -0
  171. package/dist/components/promo-sticker/index.d.ts +2 -0
  172. package/dist/components/promo-sticker/index.js +1 -0
  173. package/dist/components/promo-surface/PromoSurface.d.ts +94 -0
  174. package/dist/components/promo-surface/PromoSurface.js +119 -0
  175. package/dist/components/promo-surface/index.d.ts +2 -0
  176. package/dist/components/promo-surface/index.js +1 -0
  177. package/dist/components/radio/Radio.d.ts +92 -0
  178. package/dist/components/radio/Radio.js +171 -0
  179. package/dist/components/radio/index.d.ts +2 -0
  180. package/dist/components/radio/index.js +1 -0
  181. package/dist/components/radio-group/RadioGroup.d.ts +61 -0
  182. package/dist/components/radio-group/RadioGroup.js +51 -0
  183. package/dist/components/radio-group/index.d.ts +2 -0
  184. package/dist/components/radio-group/index.js +1 -0
  185. package/dist/components/select/Select.d.ts +65 -0
  186. package/dist/components/select/Select.js +176 -0
  187. package/dist/components/select/index.d.ts +2 -0
  188. package/dist/components/select/index.js +1 -0
  189. package/dist/components/select-field/SelectField.d.ts +16 -0
  190. package/dist/components/select-field/SelectField.js +55 -0
  191. package/dist/components/select-field/index.d.ts +2 -0
  192. package/dist/components/select-field/index.js +1 -0
  193. package/dist/components/skeleton/Skeleton.d.ts +64 -0
  194. package/dist/components/skeleton/Skeleton.js +65 -0
  195. package/dist/components/skeleton/index.d.ts +2 -0
  196. package/dist/components/skeleton/index.js +1 -0
  197. package/dist/components/split-button/SplitButton.d.ts +80 -0
  198. package/dist/components/split-button/SplitButton.js +182 -0
  199. package/dist/components/split-button/index.d.ts +2 -0
  200. package/dist/components/split-button/index.js +1 -0
  201. package/dist/components/status-summary-bar/StatusSummaryBar.d.ts +118 -0
  202. package/dist/components/status-summary-bar/StatusSummaryBar.js +278 -0
  203. package/dist/components/status-summary-bar/index.d.ts +2 -0
  204. package/dist/components/status-summary-bar/index.js +1 -0
  205. package/dist/components/subject-lookup-field/SubjectLookupField.d.ts +157 -0
  206. package/dist/components/subject-lookup-field/SubjectLookupField.js +663 -0
  207. package/dist/components/subject-lookup-field/index.d.ts +2 -0
  208. package/dist/components/subject-lookup-field/index.js +1 -0
  209. package/dist/components/switch/Switch.d.ts +152 -0
  210. package/dist/components/switch/Switch.js +307 -0
  211. package/dist/components/switch/index.d.ts +2 -0
  212. package/dist/components/switch/index.js +1 -0
  213. package/dist/components/table/Table.d.ts +5 -0
  214. package/dist/components/table/Table.js +601 -0
  215. package/dist/components/table/index.d.ts +6 -0
  216. package/dist/components/table/index.js +6 -0
  217. package/dist/components/text-field/TextField.d.ts +160 -0
  218. package/dist/components/text-field/TextField.js +244 -0
  219. package/dist/components/text-field/index.d.ts +2 -0
  220. package/dist/components/text-field/index.js +1 -0
  221. package/dist/components/text-link/TextLink.d.ts +260 -0
  222. package/dist/components/text-link/TextLink.js +303 -0
  223. package/dist/components/text-link/index.d.ts +2 -0
  224. package/dist/components/text-link/index.js +1 -0
  225. package/dist/components/textarea/Textarea.d.ts +93 -0
  226. package/dist/components/textarea/Textarea.js +256 -0
  227. package/dist/components/textarea/index.d.ts +2 -0
  228. package/dist/components/textarea/index.js +1 -0
  229. package/dist/components/tooltip/Tooltip.d.ts +129 -0
  230. package/dist/components/tooltip/Tooltip.js +457 -0
  231. package/dist/components/tooltip/index.d.ts +2 -0
  232. package/dist/components/tooltip/index.js +1 -0
  233. package/dist/components/unit-field/UnitField.d.ts +46 -0
  234. package/dist/components/unit-field/UnitField.js +133 -0
  235. package/dist/components/unit-field/index.d.ts +2 -0
  236. package/dist/components/unit-field/index.js +1 -0
  237. package/dist/icons/icon-registry.generated.js +500 -0
  238. package/dist/icons/icon-types.generated.d.ts +2 -0
  239. package/dist/icons/icon-types.generated.js +126 -0
  240. package/dist/index.d.ts +130 -0
  241. package/dist/index.js +74 -0
  242. package/dist/internal/BottomSheet.js +496 -0
  243. package/dist/internal/FodsProvider.d.ts +25 -0
  244. package/dist/internal/FodsProvider.js +32 -0
  245. package/dist/internal/MotionCaret.js +35 -0
  246. package/dist/internal/NumberFormatInput.d.ts +21 -0
  247. package/dist/internal/NumberFormatInput.js +126 -0
  248. package/dist/internal/SummaryDonut.d.ts +3 -0
  249. package/dist/internal/SummaryDonut.js +300 -0
  250. package/dist/internal/buttonSegment.d.ts +44 -0
  251. package/dist/internal/buttonSegment.js +126 -0
  252. package/dist/internal/collapseRoom.js +128 -0
  253. package/dist/internal/comboboxKeys.js +44 -0
  254. package/dist/internal/contentPresence.js +46 -0
  255. package/dist/internal/dayCell.js +95 -0
  256. package/dist/internal/dialogPortal.d.ts +2 -0
  257. package/dist/internal/dialogPortal.js +21 -0
  258. package/dist/internal/donutSweeps.js +65 -0
  259. package/dist/internal/enterOnViewGeometry.js +46 -0
  260. package/dist/internal/faqItem.js +80 -0
  261. package/dist/internal/floatingLabelMotion.js +68 -0
  262. package/dist/internal/formBlockContext.d.ts +22 -0
  263. package/dist/internal/formBlockContext.js +20 -0
  264. package/dist/internal/heightRoom.js +87 -0
  265. package/dist/internal/numberSeparators.js +62 -0
  266. package/dist/internal/overlayMotion.js +48 -0
  267. package/dist/internal/paginationItem.d.ts +8 -0
  268. package/dist/internal/paginationItem.js +22 -0
  269. package/dist/internal/popoverSurface.d.ts +8 -0
  270. package/dist/internal/popoverSurface.js +23 -0
  271. package/dist/internal/portalContainer.d.ts +1 -0
  272. package/dist/internal/portalContainer.js +6 -0
  273. package/dist/internal/progressBarItem.d.ts +207 -0
  274. package/dist/internal/progressBarItem.js +264 -0
  275. package/dist/internal/selectionControlText.js +12 -0
  276. package/dist/internal/statusSummaryParts.js +371 -0
  277. package/dist/internal/summaryMotion.js +75 -0
  278. package/dist/internal/table/ChildConnector.js +62 -0
  279. package/dist/internal/table/ChildRowPrefix.d.ts +9 -0
  280. package/dist/internal/table/ChildRowPrefix.js +27 -0
  281. package/dist/internal/table/ColumnSettings.js +135 -0
  282. package/dist/internal/table/ScrollRegion.js +114 -0
  283. package/dist/internal/table/TableEmpty.js +93 -0
  284. package/dist/internal/table/TableLayout.d.ts +17 -0
  285. package/dist/internal/table/TableLayout.js +29 -0
  286. package/dist/internal/table/TableLoadStatus.js +56 -0
  287. package/dist/internal/table/TableMobile.js +488 -0
  288. package/dist/internal/table/TruncatedCell.js +33 -0
  289. package/dist/internal/table/emptyValue.js +10 -0
  290. package/dist/internal/table/features.d.ts +41 -0
  291. package/dist/internal/table/features.js +31 -0
  292. package/dist/internal/table/recipes.js +227 -0
  293. package/dist/internal/table/rowClick.js +9 -0
  294. package/dist/internal/table/types.d.ts +325 -0
  295. package/dist/internal/table/types.js +13 -0
  296. package/dist/internal/tailwind-variants.d.ts +3 -0
  297. package/dist/internal/tailwind-variants.js +37 -0
  298. package/dist/internal/tooltipContext.js +5 -0
  299. package/dist/internal/tw-merge-config.generated.js +314 -0
  300. package/dist/internal/useAnchoredPanel.d.ts +87 -0
  301. package/dist/internal/useAnchoredPanel.js +108 -0
  302. package/dist/internal/useCountUp.js +53 -0
  303. package/dist/internal/useDateFieldTrigger.d.ts +60 -0
  304. package/dist/internal/useDateFieldTrigger.js +235 -0
  305. package/dist/internal/useEChart.js +59 -0
  306. package/dist/internal/useEnterOnView.js +42 -0
  307. package/dist/internal/useFloatingBar.js +100 -0
  308. package/dist/internal/useFormReset.js +44 -0
  309. package/dist/internal/useIsMobile.js +44 -0
  310. package/dist/internal/useOneRowOverflow.js +88 -0
  311. package/dist/internal/usePrefersReducedMotion.js +25 -0
  312. package/dist/internal/useReturnFocus.js +26 -0
  313. package/dist/internal/utils.d.ts +7 -0
  314. package/dist/internal/utils.js +58 -0
  315. package/dist/node_modules/@tanstack/store/dist/store.d.ts +29 -0
  316. package/dist/node_modules/@tanstack/store/dist/types.d.ts +38 -0
  317. package/dist/node_modules/@tanstack/table-core/dist/core/cells/coreCellsFeature.d.ts +6 -0
  318. package/dist/node_modules/@tanstack/table-core/dist/core/cells/coreCellsFeature.types.d.ts +53 -0
  319. package/dist/node_modules/@tanstack/table-core/dist/core/columns/coreColumnsFeature.d.ts +6 -0
  320. package/dist/node_modules/@tanstack/table-core/dist/core/columns/coreColumnsFeature.types.d.ts +90 -0
  321. package/dist/node_modules/@tanstack/table-core/dist/core/coreFeatures.d.ts +17 -0
  322. package/dist/node_modules/@tanstack/table-core/dist/core/headers/coreHeadersFeature.d.ts +6 -0
  323. package/dist/node_modules/@tanstack/table-core/dist/core/headers/coreHeadersFeature.types.d.ts +114 -0
  324. package/dist/node_modules/@tanstack/table-core/dist/core/reactivity/coreReactivityFeature.types.d.ts +51 -0
  325. package/dist/node_modules/@tanstack/table-core/dist/core/row-models/coreRowModelsFeature.d.ts +6 -0
  326. package/dist/node_modules/@tanstack/table-core/dist/core/row-models/coreRowModelsFeature.types.d.ts +29 -0
  327. package/dist/node_modules/@tanstack/table-core/dist/core/rows/coreRowsFeature.d.ts +6 -0
  328. package/dist/node_modules/@tanstack/table-core/dist/core/rows/coreRowsFeature.types.d.ts +129 -0
  329. package/dist/node_modules/@tanstack/table-core/dist/core/table/coreTablesFeature.d.ts +6 -0
  330. package/dist/node_modules/@tanstack/table-core/dist/core/table/coreTablesFeature.types.d.ts +203 -0
  331. package/dist/node_modules/@tanstack/table-core/dist/features/cell-selection/cellSelectionFeature.d.ts +6 -0
  332. package/dist/node_modules/@tanstack/table-core/dist/features/cell-selection/cellSelectionFeature.types.d.ts +294 -0
  333. package/dist/node_modules/@tanstack/table-core/dist/features/cell-spanning/cellSpanningFeature.d.ts +11 -0
  334. package/dist/node_modules/@tanstack/table-core/dist/features/cell-spanning/cellSpanningFeature.types.d.ts +148 -0
  335. package/dist/node_modules/@tanstack/table-core/dist/features/column-faceting/columnFacetingFeature.d.ts +12 -0
  336. package/dist/node_modules/@tanstack/table-core/dist/features/column-faceting/columnFacetingFeature.types.d.ts +63 -0
  337. package/dist/node_modules/@tanstack/table-core/dist/features/column-filtering/columnFilteringFeature.d.ts +6 -0
  338. package/dist/node_modules/@tanstack/table-core/dist/features/column-filtering/columnFilteringFeature.types.d.ts +209 -0
  339. package/dist/node_modules/@tanstack/table-core/dist/features/column-filtering/filterFns.d.ts +35 -0
  340. package/dist/node_modules/@tanstack/table-core/dist/features/column-grouping/columnGroupingFeature.d.ts +6 -0
  341. package/dist/node_modules/@tanstack/table-core/dist/features/column-grouping/columnGroupingFeature.types.d.ts +128 -0
  342. package/dist/node_modules/@tanstack/table-core/dist/features/column-ordering/columnOrderingFeature.d.ts +6 -0
  343. package/dist/node_modules/@tanstack/table-core/dist/features/column-ordering/columnOrderingFeature.types.d.ts +82 -0
  344. package/dist/node_modules/@tanstack/table-core/dist/features/column-pinning/columnPinningFeature.d.ts +11 -0
  345. package/dist/node_modules/@tanstack/table-core/dist/features/column-pinning/columnPinningFeature.types.d.ts +195 -0
  346. package/dist/node_modules/@tanstack/table-core/dist/features/column-resizing/columnResizingFeature.d.ts +6 -0
  347. package/dist/node_modules/@tanstack/table-core/dist/features/column-resizing/columnResizingFeature.types.d.ts +73 -0
  348. package/dist/node_modules/@tanstack/table-core/dist/features/column-sizing/columnSizingFeature.d.ts +6 -0
  349. package/dist/node_modules/@tanstack/table-core/dist/features/column-sizing/columnSizingFeature.types.d.ts +134 -0
  350. package/dist/node_modules/@tanstack/table-core/dist/features/column-visibility/columnVisibilityFeature.d.ts +6 -0
  351. package/dist/node_modules/@tanstack/table-core/dist/features/column-visibility/columnVisibilityFeature.types.d.ts +92 -0
  352. package/dist/node_modules/@tanstack/table-core/dist/features/global-filtering/globalFilteringFeature.d.ts +6 -0
  353. package/dist/node_modules/@tanstack/table-core/dist/features/global-filtering/globalFilteringFeature.types.d.ts +67 -0
  354. package/dist/node_modules/@tanstack/table-core/dist/features/row-aggregation/aggregationFns.d.ts +23 -0
  355. package/dist/node_modules/@tanstack/table-core/dist/features/row-aggregation/rowAggregationFeature.d.ts +6 -0
  356. package/dist/node_modules/@tanstack/table-core/dist/features/row-aggregation/rowAggregationFeature.types.d.ts +183 -0
  357. package/dist/node_modules/@tanstack/table-core/dist/features/row-aggregation/rowAggregationFeature.utils.d.ts +18 -0
  358. package/dist/node_modules/@tanstack/table-core/dist/features/row-expanding/rowExpandingFeature.d.ts +6 -0
  359. package/dist/node_modules/@tanstack/table-core/dist/features/row-expanding/rowExpandingFeature.types.d.ts +125 -0
  360. package/dist/node_modules/@tanstack/table-core/dist/features/row-pagination/rowPaginationFeature.d.ts +6 -0
  361. package/dist/node_modules/@tanstack/table-core/dist/features/row-pagination/rowPaginationFeature.types.d.ts +135 -0
  362. package/dist/node_modules/@tanstack/table-core/dist/features/row-pinning/rowPinningFeature.d.ts +6 -0
  363. package/dist/node_modules/@tanstack/table-core/dist/features/row-pinning/rowPinningFeature.types.d.ts +76 -0
  364. package/dist/node_modules/@tanstack/table-core/dist/features/row-selection/rowSelectionFeature.d.ts +6 -0
  365. package/dist/node_modules/@tanstack/table-core/dist/features/row-selection/rowSelectionFeature.types.d.ts +187 -0
  366. package/dist/node_modules/@tanstack/table-core/dist/features/row-sorting/rowSortingFeature.d.ts +6 -0
  367. package/dist/node_modules/@tanstack/table-core/dist/features/row-sorting/rowSortingFeature.types.d.ts +236 -0
  368. package/dist/node_modules/@tanstack/table-core/dist/features/row-sorting/sortFns.d.ts +23 -0
  369. package/dist/node_modules/@tanstack/table-core/dist/features/stockFeatures.d.ts +37 -0
  370. package/dist/node_modules/@tanstack/table-core/dist/helpers/columnHelper.d.ts +47 -0
  371. package/dist/node_modules/@tanstack/table-core/dist/types/Cell.d.ts +16 -0
  372. package/dist/node_modules/@tanstack/table-core/dist/types/Column.d.ts +30 -0
  373. package/dist/node_modules/@tanstack/table-core/dist/types/ColumnDef.d.ts +123 -0
  374. package/dist/node_modules/@tanstack/table-core/dist/types/Header.d.ts +12 -0
  375. package/dist/node_modules/@tanstack/table-core/dist/types/HeaderGroup.d.ts +6 -0
  376. package/dist/node_modules/@tanstack/table-core/dist/types/Row.d.ts +24 -0
  377. package/dist/node_modules/@tanstack/table-core/dist/types/RowModel.d.ts +19 -0
  378. package/dist/node_modules/@tanstack/table-core/dist/types/RowModelFns.d.ts +11 -0
  379. package/dist/node_modules/@tanstack/table-core/dist/types/Table.d.ts +53 -0
  380. package/dist/node_modules/@tanstack/table-core/dist/types/TableFeatures.d.ts +416 -0
  381. package/dist/node_modules/@tanstack/table-core/dist/types/TableOptions.d.ts +78 -0
  382. package/dist/node_modules/@tanstack/table-core/dist/types/TableState.d.ts +46 -0
  383. package/dist/node_modules/@tanstack/table-core/dist/types/type-utils.d.ts +25 -0
  384. package/dist/shared.css +179 -0
  385. package/dist/styles.css +5467 -0
  386. package/dist/theme.css +314 -0
  387. package/dist/theme.map.json +278 -0
  388. package/dist/tokens/index.d.ts +2 -0
  389. package/dist/tokens/index.js +1 -0
  390. package/dist/tokens/tokens.generated.d.ts +2040 -0
  391. package/dist/tokens/tokens.generated.js +2053 -0
  392. package/dist/tokens.css +484 -0
  393. package/dist/tokens.flat.json +429 -0
  394. package/docs/Consuming.mdx +396 -0
  395. package/docs/Contributing.mdx +78 -0
  396. package/docs/ForAgents.mdx +53 -0
  397. package/docs/Introduction.mdx +54 -0
  398. package/llms.txt +550 -0
  399. package/package.json +347 -3
  400. package/src/components/action-row/ActionRow.mdx +686 -0
  401. package/src/components/action-row/ActionRow.stories.tsx +669 -0
  402. package/src/components/action-row/ActionRow.tsx +632 -0
  403. package/src/components/action-row/index.ts +9 -0
  404. package/src/components/alert/Alert.mdx +377 -0
  405. package/src/components/alert/Alert.stories.tsx +674 -0
  406. package/src/components/alert/Alert.tsx +579 -0
  407. package/src/components/alert/index.ts +13 -0
  408. package/src/components/anchored-panel/AnchoredPanel.mdx +381 -0
  409. package/src/components/anchored-panel/AnchoredPanel.stories.tsx +593 -0
  410. package/src/components/anchored-panel/AnchoredPanel.tsx +176 -0
  411. package/src/components/anchored-panel/index.ts +15 -0
  412. package/src/components/badge/Badge.mdx +487 -0
  413. package/src/components/badge/Badge.stories.tsx +375 -0
  414. package/src/components/badge/Badge.tsx +360 -0
  415. package/src/components/badge/index.ts +10 -0
  416. package/src/components/banner/Banner.mdx +704 -0
  417. package/src/components/banner/Banner.stories.tsx +448 -0
  418. package/src/components/banner/Banner.tsx +602 -0
  419. package/src/components/banner/index.ts +14 -0
  420. package/src/components/button/Button.mdx +286 -0
  421. package/src/components/button/Button.stories.tsx +381 -0
  422. package/src/components/button/Button.tsx +384 -0
  423. package/src/components/button/index.ts +1 -0
  424. package/src/components/button-group/ButtonGroup.mdx +512 -0
  425. package/src/components/button-group/ButtonGroup.stories.tsx +714 -0
  426. package/src/components/button-group/ButtonGroup.tsx +491 -0
  427. package/src/components/button-group/index.ts +10 -0
  428. package/src/components/card-select/CardSelect.mdx +662 -0
  429. package/src/components/card-select/CardSelect.stories.tsx +784 -0
  430. package/src/components/card-select/CardSelect.tsx +783 -0
  431. package/src/components/card-select/CardSelectGroup.tsx +169 -0
  432. package/src/components/card-select/index.ts +18 -0
  433. package/src/components/checkbox/Checkbox.mdx +269 -0
  434. package/src/components/checkbox/Checkbox.stories.tsx +306 -0
  435. package/src/components/checkbox/Checkbox.tsx +343 -0
  436. package/src/components/checkbox/index.ts +1 -0
  437. package/src/components/chip/Chip.mdx +683 -0
  438. package/src/components/chip/Chip.stories.tsx +734 -0
  439. package/src/components/chip/Chip.tsx +732 -0
  440. package/src/components/chip/index.ts +9 -0
  441. package/src/components/column-header/ColumnHeader.mdx +301 -0
  442. package/src/components/column-header/ColumnHeader.stories.tsx +319 -0
  443. package/src/components/column-header/ColumnHeader.tsx +287 -0
  444. package/src/components/column-header/index.ts +7 -0
  445. package/src/components/combobox-field/Combobox.tsx +693 -0
  446. package/src/components/combobox-field/ComboboxField.mdx +525 -0
  447. package/src/components/combobox-field/ComboboxField.stories.tsx +502 -0
  448. package/src/components/combobox-field/ComboboxField.tsx +259 -0
  449. package/src/components/combobox-field/index.ts +12 -0
  450. package/src/components/date-picker/DatePicker.mdx +440 -0
  451. package/src/components/date-picker/DatePicker.stories.tsx +458 -0
  452. package/src/components/date-picker/DatePicker.tsx +688 -0
  453. package/src/components/date-picker/index.ts +9 -0
  454. package/src/components/divider/Divider.mdx +256 -0
  455. package/src/components/divider/Divider.stories.tsx +177 -0
  456. package/src/components/divider/Divider.tsx +193 -0
  457. package/src/components/divider/index.ts +1 -0
  458. package/src/components/drawer/Drawer.mdx +518 -0
  459. package/src/components/drawer/Drawer.stories.tsx +392 -0
  460. package/src/components/drawer/Drawer.tsx +683 -0
  461. package/src/components/drawer/index.ts +1 -0
  462. package/src/components/dropdown-button/DropdownButton.mdx +285 -0
  463. package/src/components/dropdown-button/DropdownButton.stories.tsx +398 -0
  464. package/src/components/dropdown-button/DropdownButton.tsx +198 -0
  465. package/src/components/dropdown-button/index.ts +7 -0
  466. package/src/components/faq/FAQ.mdx +364 -0
  467. package/src/components/faq/FAQ.stories.tsx +343 -0
  468. package/src/components/faq/FAQ.tsx +337 -0
  469. package/src/components/faq/index.ts +1 -0
  470. package/src/components/field/Field.mdx +129 -0
  471. package/src/components/field/Field.stories.tsx +461 -0
  472. package/src/components/field/Field.tsx +787 -0
  473. package/src/components/field/index.ts +20 -0
  474. package/src/components/field-pair/FieldPair.mdx +312 -0
  475. package/src/components/field-pair/FieldPair.stories.tsx +539 -0
  476. package/src/components/field-pair/FieldPair.tsx +845 -0
  477. package/src/components/field-pair/index.ts +9 -0
  478. package/src/components/file-upload/FileUpload.mdx +345 -0
  479. package/src/components/file-upload/FileUpload.stories.tsx +698 -0
  480. package/src/components/file-upload/FileUpload.tsx +802 -0
  481. package/src/components/file-upload/index.ts +6 -0
  482. package/src/components/filter-chip/FilterChip.mdx +778 -0
  483. package/src/components/filter-chip/FilterChip.stories.tsx +827 -0
  484. package/src/components/filter-chip/FilterChip.tsx +881 -0
  485. package/src/components/filter-chip/index.ts +11 -0
  486. package/src/components/filter-facet/FilterFacet.mdx +536 -0
  487. package/src/components/filter-facet/FilterFacet.stories.tsx +506 -0
  488. package/src/components/filter-facet/FilterFacet.tsx +1160 -0
  489. package/src/components/filter-facet/index.ts +7 -0
  490. package/src/components/firm-avatar/FirmAvatar.mdx +280 -0
  491. package/src/components/firm-avatar/FirmAvatar.stories.tsx +147 -0
  492. package/src/components/firm-avatar/FirmAvatar.tsx +172 -0
  493. package/src/components/firm-avatar/index.ts +7 -0
  494. package/src/components/form-actions/FormActions.mdx +518 -0
  495. package/src/components/form-actions/FormActions.stories.tsx +621 -0
  496. package/src/components/form-actions/FormActions.tsx +273 -0
  497. package/src/components/form-actions/index.ts +6 -0
  498. package/src/components/form-block/FormBlock.mdx +728 -0
  499. package/src/components/form-block/FormBlock.stories.tsx +813 -0
  500. package/src/components/form-block/FormBlock.tsx +679 -0
  501. package/src/components/form-block/index.ts +13 -0
  502. package/src/components/form-section/FormSection.mdx +436 -0
  503. package/src/components/form-section/FormSection.stories.tsx +407 -0
  504. package/src/components/form-section/FormSection.tsx +290 -0
  505. package/src/components/form-section/index.ts +17 -0
  506. package/src/components/heading/Heading.mdx +206 -0
  507. package/src/components/heading/Heading.stories.tsx +169 -0
  508. package/src/components/heading/Heading.tsx +124 -0
  509. package/src/components/heading/index.ts +8 -0
  510. package/src/components/heading-group/HeadingGroup.mdx +521 -0
  511. package/src/components/heading-group/HeadingGroup.stories.tsx +353 -0
  512. package/src/components/heading-group/HeadingGroup.tsx +396 -0
  513. package/src/components/heading-group/index.ts +7 -0
  514. package/src/components/hero/Hero.mdx +742 -0
  515. package/src/components/hero/Hero.stories.tsx +527 -0
  516. package/src/components/hero/Hero.tsx +807 -0
  517. package/src/components/hero/index.ts +1 -0
  518. package/src/components/icon/Icon.mdx +329 -0
  519. package/src/components/icon/Icon.stories.tsx +398 -0
  520. package/src/components/icon/Icon.tsx +97 -0
  521. package/src/components/icon/index.ts +2 -0
  522. package/src/components/icon-button/IconButton.mdx +206 -0
  523. package/src/components/icon-button/IconButton.stories.tsx +341 -0
  524. package/src/components/icon-button/IconButton.tsx +273 -0
  525. package/src/components/icon-button/index.ts +1 -0
  526. package/src/components/item-row/ItemRow.mdx +533 -0
  527. package/src/components/item-row/ItemRow.stories.tsx +434 -0
  528. package/src/components/item-row/ItemRow.tsx +676 -0
  529. package/src/components/item-row/index.ts +9 -0
  530. package/src/components/list-row/ListRow.mdx +404 -0
  531. package/src/components/list-row/ListRow.stories.tsx +404 -0
  532. package/src/components/list-row/ListRow.tsx +424 -0
  533. package/src/components/list-row/index.ts +1 -0
  534. package/src/components/menu/Menu.mdx +268 -0
  535. package/src/components/menu/Menu.stories.tsx +455 -0
  536. package/src/components/menu/Menu.tsx +452 -0
  537. package/src/components/menu/index.ts +1 -0
  538. package/src/components/modal/Modal.mdx +854 -0
  539. package/src/components/modal/Modal.stories.tsx +881 -0
  540. package/src/components/modal/Modal.tsx +1434 -0
  541. package/src/components/modal/index.ts +1 -0
  542. package/src/components/nav-link/NavLink.mdx +196 -0
  543. package/src/components/nav-link/NavLink.stories.tsx +243 -0
  544. package/src/components/nav-link/NavLink.tsx +222 -0
  545. package/src/components/nav-link/index.ts +1 -0
  546. package/src/components/number-field/NumberField.mdx +223 -0
  547. package/src/components/number-field/NumberField.stories.tsx +291 -0
  548. package/src/components/number-field/NumberField.tsx +388 -0
  549. package/src/components/number-field/index.ts +6 -0
  550. package/src/components/pagination/Pagination.mdx +305 -0
  551. package/src/components/pagination/Pagination.stories.tsx +333 -0
  552. package/src/components/pagination/Pagination.tsx +343 -0
  553. package/src/components/pagination/index.ts +8 -0
  554. package/src/components/popover-surface/PopoverSurface.mdx +158 -0
  555. package/src/components/popover-surface/PopoverSurface.stories.tsx +421 -0
  556. package/src/components/popover-surface/index.ts +1 -0
  557. package/src/components/progress-bar/ProgressBar.mdx +802 -0
  558. package/src/components/progress-bar/ProgressBar.stories.tsx +533 -0
  559. package/src/components/progress-bar/ProgressBar.tsx +654 -0
  560. package/src/components/progress-bar/index.ts +9 -0
  561. package/src/components/promo-sticker/PromoSticker.mdx +436 -0
  562. package/src/components/promo-sticker/PromoSticker.stories.tsx +363 -0
  563. package/src/components/promo-sticker/PromoSticker.tsx +313 -0
  564. package/src/components/promo-sticker/index.ts +7 -0
  565. package/src/components/promo-surface/PromoSurface.mdx +399 -0
  566. package/src/components/promo-surface/PromoSurface.stories.tsx +270 -0
  567. package/src/components/promo-surface/PromoSurface.tsx +305 -0
  568. package/src/components/promo-surface/index.ts +7 -0
  569. package/src/components/radio/Radio.mdx +243 -0
  570. package/src/components/radio/Radio.stories.tsx +307 -0
  571. package/src/components/radio/Radio.tsx +288 -0
  572. package/src/components/radio/index.ts +1 -0
  573. package/src/components/radio-group/RadioGroup.mdx +119 -0
  574. package/src/components/radio-group/RadioGroup.stories.tsx +225 -0
  575. package/src/components/radio-group/RadioGroup.tsx +139 -0
  576. package/src/components/radio-group/index.ts +1 -0
  577. package/src/components/select/Select.mdx +241 -0
  578. package/src/components/select/Select.stories.tsx +404 -0
  579. package/src/components/select/Select.tsx +381 -0
  580. package/src/components/select/index.ts +1 -0
  581. package/src/components/select-field/SelectField.mdx +324 -0
  582. package/src/components/select-field/SelectField.stories.tsx +460 -0
  583. package/src/components/select-field/SelectField.tsx +138 -0
  584. package/src/components/select-field/index.ts +1 -0
  585. package/src/components/skeleton/Skeleton.mdx +194 -0
  586. package/src/components/skeleton/Skeleton.stories.tsx +260 -0
  587. package/src/components/skeleton/Skeleton.tsx +107 -0
  588. package/src/components/skeleton/index.ts +1 -0
  589. package/src/components/split-button/SplitButton.mdx +445 -0
  590. package/src/components/split-button/SplitButton.stories.tsx +465 -0
  591. package/src/components/split-button/SplitButton.tsx +361 -0
  592. package/src/components/split-button/index.ts +7 -0
  593. package/src/components/status-summary-bar/StatusSummaryBar.mdx +338 -0
  594. package/src/components/status-summary-bar/StatusSummaryBar.stories.tsx +408 -0
  595. package/src/components/status-summary-bar/StatusSummaryBar.tsx +428 -0
  596. package/src/components/status-summary-bar/index.ts +8 -0
  597. package/src/components/subject-lookup-field/SubjectLookupField.mdx +378 -0
  598. package/src/components/subject-lookup-field/SubjectLookupField.stories.tsx +393 -0
  599. package/src/components/subject-lookup-field/SubjectLookupField.tsx +1079 -0
  600. package/src/components/subject-lookup-field/index.ts +11 -0
  601. package/src/components/switch/Switch.mdx +376 -0
  602. package/src/components/switch/Switch.stories.tsx +296 -0
  603. package/src/components/switch/Switch.tsx +483 -0
  604. package/src/components/switch/index.ts +1 -0
  605. package/src/components/table/Table.mdx +575 -0
  606. package/src/components/table/Table.stories.tsx +1049 -0
  607. package/src/components/table/Table.tsx +745 -0
  608. package/src/components/table/TableConsumers.stories.tsx +195 -0
  609. package/src/components/table/_tableFixtures.ts +1189 -0
  610. package/src/components/table/index.ts +22 -0
  611. package/src/components/text-field/TextField.mdx +699 -0
  612. package/src/components/text-field/TextField.stories.tsx +674 -0
  613. package/src/components/text-field/TextField.tsx +645 -0
  614. package/src/components/text-field/index.ts +11 -0
  615. package/src/components/text-link/TextLink.mdx +353 -0
  616. package/src/components/text-link/TextLink.stories.tsx +458 -0
  617. package/src/components/text-link/TextLink.tsx +504 -0
  618. package/src/components/text-link/index.ts +10 -0
  619. package/src/components/textarea/Textarea.mdx +244 -0
  620. package/src/components/textarea/Textarea.stories.tsx +371 -0
  621. package/src/components/textarea/Textarea.tsx +489 -0
  622. package/src/components/textarea/index.ts +9 -0
  623. package/src/components/tooltip/Tooltip.mdx +462 -0
  624. package/src/components/tooltip/Tooltip.stories.tsx +500 -0
  625. package/src/components/tooltip/Tooltip.tsx +756 -0
  626. package/src/components/tooltip/index.ts +13 -0
  627. package/src/components/unit-field/UnitField.mdx +215 -0
  628. package/src/components/unit-field/UnitField.stories.tsx +291 -0
  629. package/src/components/unit-field/UnitField.tsx +255 -0
  630. package/src/components/unit-field/index.ts +7 -0
  631. package/src/icons/icon-registry.generated.ts +510 -0
  632. package/src/icons/icon-types.generated.ts +256 -0
  633. package/src/index.ts +70 -0
  634. package/src/internal/BottomSheet.tsx +714 -0
  635. package/src/internal/FodsProvider.tsx +36 -0
  636. package/src/internal/MotionCaret.tsx +53 -0
  637. package/src/internal/NumberFormatInput.tsx +276 -0
  638. package/src/internal/SummaryDonut.tsx +359 -0
  639. package/src/internal/buttonSegment.ts +241 -0
  640. package/src/internal/collapseRoom.ts +130 -0
  641. package/src/internal/comboboxKeys.ts +90 -0
  642. package/src/internal/contentPresence.ts +46 -0
  643. package/src/internal/dayCell.ts +274 -0
  644. package/src/internal/dialogPortal.ts +50 -0
  645. package/src/internal/donutSweeps.ts +77 -0
  646. package/src/internal/enterOnViewGeometry.ts +53 -0
  647. package/src/internal/faqItem.ts +104 -0
  648. package/src/internal/floatingLabelMotion.tsx +109 -0
  649. package/src/internal/formBlockContext.ts +27 -0
  650. package/src/internal/heightRoom.ts +135 -0
  651. package/src/internal/numberSeparators.ts +93 -0
  652. package/src/internal/overlayMotion.tsx +32 -0
  653. package/src/internal/paginationItem.ts +106 -0
  654. package/src/internal/popoverSurface.ts +78 -0
  655. package/src/internal/portalContainer.ts +11 -0
  656. package/src/internal/progressBarItem.ts +356 -0
  657. package/src/internal/selectionControlText.ts +42 -0
  658. package/src/internal/statusSummaryParts.tsx +475 -0
  659. package/src/internal/summaryMotion.ts +111 -0
  660. package/src/internal/table/ChildConnector.tsx +57 -0
  661. package/src/internal/table/ChildRowPrefix.tsx +21 -0
  662. package/src/internal/table/ColumnSettings.tsx +194 -0
  663. package/src/internal/table/ScrollRegion.tsx +176 -0
  664. package/src/internal/table/TableEmpty.tsx +99 -0
  665. package/src/internal/table/TableLayout.tsx +29 -0
  666. package/src/internal/table/TableLoadStatus.tsx +60 -0
  667. package/src/internal/table/TableMobile.tsx +582 -0
  668. package/src/internal/table/TruncatedCell.tsx +35 -0
  669. package/src/internal/table/emptyValue.ts +11 -0
  670. package/src/internal/table/features.ts +44 -0
  671. package/src/internal/table/recipes.ts +263 -0
  672. package/src/internal/table/rowClick.ts +8 -0
  673. package/src/internal/table/types.ts +342 -0
  674. package/src/internal/tailwind-variants.ts +65 -0
  675. package/src/internal/tooltipContext.ts +15 -0
  676. package/src/internal/tw-merge-config.generated.ts +275 -0
  677. package/src/internal/useAnchoredPanel.ts +340 -0
  678. package/src/internal/useCountUp.ts +65 -0
  679. package/src/internal/useDateFieldTrigger.tsx +497 -0
  680. package/src/internal/useEChart.ts +88 -0
  681. package/src/internal/useEnterOnView.ts +80 -0
  682. package/src/internal/useFloatingBar.ts +125 -0
  683. package/src/internal/useFormReset.ts +57 -0
  684. package/src/internal/useIsMobile.ts +64 -0
  685. package/src/internal/useNoImplicitSubmit.ts +41 -0
  686. package/src/internal/useOneRowOverflow.ts +103 -0
  687. package/src/internal/usePrefersReducedMotion.ts +27 -0
  688. package/src/internal/useReturnFocus.ts +34 -0
  689. package/src/internal/utils.ts +58 -0
  690. package/src/recipes/EmptyState.stories.tsx +105 -0
  691. package/src/recipes/Form.stories.tsx +360 -0
  692. package/src/recipes/ModalWithForm.stories.tsx +219 -0
  693. package/src/recipes/Recipes.mdx +61 -0
  694. package/src/recipes/TableWithFilters.stories.tsx +278 -0
  695. package/src/storybook/FodsFamily.tsx +39 -0
  696. package/src/storybook/Section.tsx +36 -0
  697. package/src/storybook/a11y.ts +24 -0
  698. package/src/storybook/assets/banner-character-bartender.webp +0 -0
  699. package/src/storybook/assets/banner-invoice-sheet-left.webp +0 -0
  700. package/src/storybook/assets/banner-invoice-sheet-right.webp +0 -0
  701. package/src/storybook/assets/invoice-hero.webp +0 -0
  702. package/src/storybook/assets/invoice.webp +0 -0
  703. package/src/storybook/assets/section-document-info.svg +21 -0
  704. package/src/storybook/assets/section-gear-checklist.svg +11 -0
  705. package/src/storybook/assets/section-person-arrow-in.svg +15 -0
  706. package/src/storybook/assets/section-person-arrow-out.svg +22 -0
  707. package/src/storybook/assets/section-receipt-dollar.svg +23 -0
  708. package/src/storybook/assets/table-empty-folder-empty.png +0 -0
  709. package/src/storybook/assets/table-empty-folder-magnifying-glass.png +0 -0
  710. package/src/storybook/assets/table-empty-funnel.png +0 -0
  711. package/src/storybook/assets/table-empty-load-failed.png +0 -0
  712. package/src/storybook/assets/wallet-spot.png +0 -0
  713. package/src/storybook/assets.d.ts +17 -0
  714. package/src/storybook/componentDoc.ts +41 -0
  715. package/src/storybook/fitFrame.tsx +70 -0
  716. package/src/storybook/forceStates.tsx +647 -0
  717. package/src/storybook/illustrations.tsx +66 -0
  718. package/src/storybook/viewportFrame.tsx +58 -0
  719. package/src/styles/assets/label-brush-1.svg +6 -0
  720. package/src/styles/assets/pattern-dark.svg +113 -0
  721. package/src/styles/base.css +106 -0
  722. package/src/styles/index.css +15 -0
  723. package/src/styles/motion.css +157 -0
  724. package/src/styles/promo-sticker.css +27 -0
  725. package/src/styles/promo-surface.css +49 -0
  726. package/src/styles/shared.css +11 -0
  727. package/src/styles/theme.generated.css +314 -0
  728. package/src/styles/theme.map.json +278 -0
  729. package/src/styles/tracking.generated.css +12 -0
  730. package/src/tokens/index.ts +4 -0
  731. package/src/tokens/tokens.generated.ts +542 -0
@@ -0,0 +1,699 @@
1
+ import { Meta, Canvas, Controls } from '@storybook/addon-docs/blocks';
2
+ import * as TextFieldStories from './TextField.stories';
3
+
4
+
5
+ <Meta of={TextFieldStories} tags={['autodocs']} />
6
+
7
+ # TextField
8
+
9
+ ## Metadata
10
+
11
+ - **Layer:** atom
12
+ - **Status:** draft — the `type="date"` mode built against manifest 2.15.0 has no recorded design
13
+ acceptance yet; the page returns to `stable` once it does.
14
+ - **Manifest version:** `2.15.0`
15
+ - **Tokens used:** `--bg-primary`, `--bg-readonly`, `--border-width-100`, `--border-width-200`, `--disabled-background`, `--disabled-foreground`, `--font-body`, `--font-size-base`, `--font-size-heading-h5`, `--font-size-sm`, `--font-size-xs`, `--font-size-xxs`, `--font-weight-bold`, `--font-weight-normal`, `--icon-muted`, `--leading-loose`, `--leading-relaxed`, `--outline-default`, `--outline-focus`, `--outline-strong`, `--radius-200`, `--radius-400`, `--size-icon`, `--size-icon-small`, `--space-1000`, `--space-1100`, `--space-200`, `--space-300`, `--space-400`, `--space-500`, `--space-700`, `--space-800`, `--status-danger`, `--status-success-solid`, `--status-success-tint-foreground`, `--text-placeholder`, `--text-primary`, `--text-secondary`, `--text-wrap-body`
16
+
17
+ ## Overview
18
+
19
+ TextField is the single-line text input for short, free-form values: name, IČO / DIČ, e-mail,
20
+ phone, web, address, amount, date, or a search / filter box. `type` is a non-visual prop
21
+ (`text · email · tel · url · search · password · numeric`, plus `date`) — it changes the on-screen
22
+ keyboard and slot behaviour, never the look (`numeric` only right-aligns the value); any other HTML input type does not type-check. `type="date"` turns the field into a date field: a typeable date with
23
+ the calendar glyph and the Single month Date Picker (see [Date mode](#date-mode)). A date field is
24
+ this component, not a separate one.
25
+
26
+ Reach for a different component when: the value spans multiple lines (→ **Textarea**), it comes from
27
+ a fixed set of options (→ **Select**), or it needs an in-field unit / computed suffix
28
+ (→ **UnitField** / **NumberField**). A field that _looks_ editable but offers a list is a Select, not
29
+ a TextField. The **Date Picker** is not a competing field: it is the panel a `type="date"` TextField
30
+ opens.
31
+
32
+ TextField is only the **shell + value**. The floating label, helper text and error / success
33
+ messaging live in the `Field` wrapper — the canonical usage is
34
+ `<Field label="IČO"><TextField id="ico" /></Field>`.
35
+
36
+ <Canvas of={TextFieldStories.Playground} />
37
+
38
+ ## Rationale
39
+
40
+ TextField codifies the parts that were previously implicit:
41
+
42
+ 1. **The label belongs to the control, not to a sibling.** `Field` renders a real floating `<label>`
43
+ that cross-fades from placeholder position to the top border — so the field is always programmatically
44
+ labelled and the placeholder is never the only label.
45
+ 2. **Validation is a first-class state, signalled twice.** Error / Success carry a border colour
46
+ **and** a trailing status icon — colour is never the sole cue (WCAG 1.4.1).
47
+ 3. **One shell, many fields.** The border / fill / radius / floating-label notch is a single shape,
48
+ reused by UnitField, NumberField and the Select trigger — fix it once, it lands everywhere. The
49
+ inner `<input>` is borderless and transparent; the outer shell `<div>` owns all the chrome.
50
+
51
+ ## Anatomy
52
+
53
+ - **Shell** (`<div>`) — outlined frame that owns border / fill / radius. `--bg-primary` fill,
54
+ `--outline-default` 1px border, radius `--radius-400`, horizontal padding `--space-500`, gap
55
+ `--space-400`. Height is fixed on the 4-grid (`md` 48, `sm` 40). A content-driven `min-width` of
56
+ 80px keeps a ~5-char value from truncating.
57
+ - **Leading slot** (optional, `leadingIcon`) — 24/20px glyph (`--size-icon` md / `--size-icon-small` sm) in `--text-secondary`; a contextual icon
58
+ such as `magnifying-glass` for a filter field.
59
+ - **Value** (`<input>`) — borderless, transparent, `Body/M/Regular` in every size. `--text-primary`
60
+ when filled; placeholder ink is `--text-placeholder` (one tier quieter than the label) so an empty
61
+ field reads value > label > placeholder. **Overflow:** an over-long placeholder ellipsizes rather
62
+ than clipping mid-glyph (spec `text.placeholder.overflow = truncate`). `text-overflow` has to sit on
63
+ the `<input>` — `::placeholder` ignores it (verified in Chrome) — which leaves `text.value.overflow =
64
+ scroll` intact: a focused input still scrolls horizontally natively, so the ellipsis only appears on a
65
+ resting, unfocused, overflowing value. The `type="date"` mode renders this same shell, so it
66
+ behaves the same.
67
+ - **Trailing slot** (optional, `trailingIcon`) — 24/20px affordance (clear, password reveal). Becomes
68
+ an interactive `<button>` when `onTrailingIconClick` is set (`trailingIconLabel` is its accessible
69
+ name). On Error / Success this slot is taken by the intrinsic status icon and the user affordance is
70
+ suppressed.
71
+ - **Status icon** (Error / Success) — trailing `warning-circle` (`--status-danger`) or `check-circle`
72
+ (`--status-success-solid`), both the Figma glyphs.
73
+ - **Focus** — on Default the shell border swaps to `--outline-focus` (1px, same weight). No additive
74
+ ring: the border swap is the sole focus indicator. On an **invalid** field the
75
+ border keeps `--status-danger` and thickens from `--border-width-100` to `--border-width-200`
76
+ instead — `--outline-focus` never shows on Error (see States → Error + focus). Success + focus is the
77
+ plain Focused swap. There is **no** hover state.
78
+
79
+ ## Variants
80
+
81
+ TextField exposes no colour / style variants of its own — its manifest axes are `state`, `size` and
82
+ `content` (below). The state × size grid mirrors the Figma labelled matrix.
83
+
84
+ <Canvas of={TextFieldStories.Matrix} />
85
+
86
+ <table>
87
+ <thead>
88
+ <tr><th>Axis</th><th>Values</th><th>Notes</th></tr>
89
+ </thead>
90
+ <tbody>
91
+ <tr>
92
+ <td><code>state</code></td>
93
+ <td><code>default</code> · <code>focused</code> · <code>error</code> · <code>success</code> · <code>disabled</code> · <code>readonly</code></td>
94
+ <td>the colour matrix axis — see <a href="#states">States</a></td>
95
+ </tr>
96
+ <tr>
97
+ <td><code>size</code></td>
98
+ <td><code>md</code> · <code>sm</code></td>
99
+ <td>the measurement axis — see <a href="#sizes">Sizes</a></td>
100
+ </tr>
101
+ <tr>
102
+ <td><code>content</code></td>
103
+ <td><code>empty</code> · <code>filled</code></td>
104
+ <td>Figma <strong>Has value</strong>; not a prop — it is the presence of a <code>value</code> / <code>defaultValue</code>. See <a href="#content">Content</a></td>
105
+ </tr>
106
+ <tr>
107
+ <td><code>leadingIcon</code></td>
108
+ <td>any <code>IconName</code></td>
109
+ <td>leading glyph (search / filter); off by default</td>
110
+ </tr>
111
+ <tr>
112
+ <td><code>trailingIcon</code></td>
113
+ <td>any <code>IconName</code></td>
114
+ <td>trailing affordance (clear / reveal) on Default / Focused / Disabled; replaced by the status icon on Error / Success</td>
115
+ </tr>
116
+ </tbody>
117
+ </table>
118
+
119
+ The floating label, helper, error message and the "Volitelný" optional tag are **not** TextField
120
+ props — they are provided by the `Field` wrapper.
121
+
122
+ ### Content
123
+
124
+ <Canvas of={TextFieldStories.ContentMatrix} />
125
+
126
+ The manifest's third axis — Figma's **Has value** (True/False) — is not a prop: it is simply whether
127
+ the field carries a value. It changes two things. **Inside the field:** an empty field shows the
128
+ placeholder in `--text-placeholder`, one tier quieter than the label; a filled field shows the value
129
+ in `--text-primary`. An **empty Disabled** field shows no placeholder at all — it shows an en dash
130
+ `–` in `--disabled-foreground` (manifest 2.9.0, `field-readonly.md` § En dash semantics). The dash
131
+ is visual only (`aria-hidden`); the accessible value stays empty, and the placeholder stays in
132
+ the DOM (transparent) as the accessible-name fallback for an unlabelled field. **On the `Field` label:** the
133
+ float rule keys off it — the label rests inside (placeholder position) only when the field is CALM,
134
+ i.e. empty *and* unfocused *and* valid *and* editable; a value, focus, a placeholder,
135
+ `state="error"`, Disabled or Read-only floats it. Read-only exists only *with* a value — there is no
136
+ empty Read-only cell in the Figma set (if one does occur, the same dash renders in `--text-primary`). The label
137
+ side of the axis is shown under [Label](#label); the matrix above renders the bare field.
138
+
139
+ ## Sizes
140
+
141
+ <Canvas of={TextFieldStories.Sizes} />
142
+
143
+ <table>
144
+ <thead>
145
+ <tr>
146
+ <th><code>size</code></th>
147
+ <th style={{ textAlign: 'right' }}>Height</th>
148
+ <th>Padding&nbsp;(X)</th>
149
+ <th>Gap</th>
150
+ <th>Helper gap</th>
151
+ <th style={{ textAlign: 'right' }}>Icon</th>
152
+ <th>Radius</th>
153
+ <th>When</th>
154
+ </tr>
155
+ </thead>
156
+ <tbody>
157
+ <tr>
158
+ <td><code>md</code> (default)</td>
159
+ <td style={{ textAlign: 'right' }}>48px</td>
160
+ <td><code>--space-500</code></td>
161
+ <td><code>--space-400</code></td>
162
+ <td><code>--space-200</code></td>
163
+ <td style={{ textAlign: 'right' }}>24</td>
164
+ <td><code>--radius-400</code></td>
165
+ <td>standard forms</td>
166
+ </tr>
167
+ <tr>
168
+ <td><code>sm</code></td>
169
+ <td style={{ textAlign: 'right' }}>40px</td>
170
+ <td><code>--space-500</code></td>
171
+ <td><code>--space-400</code></td>
172
+ <td><code>--space-200</code></td>
173
+ <td style={{ textAlign: 'right' }}>20</td>
174
+ <td><code>--radius-400</code></td>
175
+ <td>dense rows, filter bars, table cells</td>
176
+ </tr>
177
+ </tbody>
178
+ </table>
179
+
180
+ **Helper gap** is the vertical step from the shell to the helper / message line that `Field`
181
+ renders below it — `sizes[].helperGap`, `--space-200` (4) since manifest 2.13.0 (8 read as too far
182
+ from the field). It is safe at 4 because the field has no focus ring to collide with the message,
183
+ and `Body/XS`'s loose leading keeps the optical gap near 8.
184
+
185
+ Heights are fixed on the 4-grid. Width is layout-driven — a field fills its column; the hard
186
+ `min-width` floor is 80px (baseline, no icons / Optional tag). Keep one size consistent within a form.
187
+
188
+ ## States
189
+
190
+ <Canvas of={TextFieldStories.States} />
191
+
192
+ Six visual states. Native attributes win when set explicitly (`disabled` / `readOnly`), otherwise the
193
+ state is derived from the `state` prop.
194
+
195
+ <table>
196
+ <thead>
197
+ <tr><th>State</th><th>Border / fill</th><th>Behaviour</th></tr>
198
+ </thead>
199
+ <tbody>
200
+ <tr>
201
+ <td><code>default</code></td>
202
+ <td><code>--outline-default</code> border, <code>--bg-primary</code> fill</td>
203
+ <td>resting; border swaps to <code>--outline-focus</code> on focus-within (Default and Success only — Error keeps its colour, see below)</td>
204
+ </tr>
205
+ <tr>
206
+ <td><code>focused</code></td>
207
+ <td><code>--outline-focus</code> border (1px, no ring)</td>
208
+ <td>editing state; the <code>Field</code> label floats even when empty</td>
209
+ </tr>
210
+ <tr>
211
+ <td><code>error</code></td>
212
+ <td><code>--status-danger</code> border + trailing <code>warning-circle</code> icon</td>
213
+ <td>sets <code>aria-invalid="true"</code>; pair with a matching <code>error</code> message on <code>Field</code>; on focus the border stays <code>--status-danger</code> and thickens to <code>--border-width-200</code> (never <code>--outline-focus</code>)</td>
214
+ </tr>
215
+ <tr>
216
+ <td><code>success</code></td>
217
+ <td><code>--status-success-solid</code> border + trailing <code>check-circle</code> icon (non-text); <code>Field</code> label + confirmation message in <code>--status-success-tint-foreground</code> (AA)</td>
218
+ <td>colour + icon, never colour alone</td>
219
+ </tr>
220
+ <tr>
221
+ <td><code>disabled</code></td>
222
+ <td><code>--outline-default</code> border @ <code>--border-width-100</code>, <code>--disabled-background</code> fill, <code>--disabled-foreground</code> content; empty → <code>–</code></td>
223
+ <td>"not applicable" — drops from the tab order, value not submitted</td>
224
+ </tr>
225
+ <tr>
226
+ <td><code>readonly</code></td>
227
+ <td><code>--outline-default</code> border @ <code>--border-width-100</code>, <code>--bg-readonly</code> fill, <code>--text-primary</code> value</td>
228
+ <td>"informative, not editable" — stays focusable, copyable and in the tab order, value submits (native <code>readonly</code>)</td>
229
+ </tr>
230
+ </tbody>
231
+ </table>
232
+
233
+ **Read-only ≠ Disabled.** Use `state="readonly"` for a value the user should see and copy but not edit
234
+ here (computed / derived / locked — e.g. a variable symbol derived from the invoice number). Use
235
+ `disabled` only when the field is genuinely not applicable. Focus is a 1px border-colour swap with no
236
+ ring — except on an invalid field (below); there is no hover state.
237
+
238
+ **Error + focus.** A composition, not a seventh State value. The border **keeps** `--status-danger` and
239
+ goes from `--border-width-100` to `--border-width-200` while the field has focus — colour carries the
240
+ state, weight carries the focus. `--outline-focus` never shows on an invalid field: a blue border would
241
+ say "fine" while label, icon and message say "wrong", and tabbing through an invalid form would blink
242
+ red → blue → red. The added weight sits **inside** the shell — an inset `box-shadow` of
243
+ `calc(var(--border-width-200) - var(--border-width-100))` on top of the 1px border — so the height
244
+ (48 / 40) is unchanged and the content does not shift. Label, status icon and message stay exactly as
245
+ in Error. Success + focus stays the plain Focused swap.
246
+
247
+ **Uncontrolled emptiness.** Without `value`, the field tracks whether it is empty from its own change
248
+ events rather than from the stale `defaultValue`, so the en dash of an empty Disabled / Read-only
249
+ field reflects what the user actually left in it. A native form reset fires no change event; the
250
+ field re-syncs from the restored value instead.
251
+
252
+ ### Icons
253
+
254
+ An optional **leading** glyph (search / filter fields) and a **trailing** affordance (clear, password
255
+ reveal). On Error / Success the trailing slot is taken by the intrinsic status icon, so a user trailing
256
+ icon shows only on Default / Focused / Disabled.
257
+
258
+ Both glyph slots take `--disabled-foreground` on a Disabled field — the glyph is content, and Disabled
259
+ mutes all of it (manifest `families[].states.disabled.icon`) — and step down to `--icon-muted` on a
260
+ Read-only one, where the glyph marks what the field holds rather than offering an action. The Error /
261
+ Success ink belongs to the status icon, not to the user slots: a leading glyph stays `--text-secondary`
262
+ on an invalid field.
263
+
264
+ <Canvas of={TextFieldStories.WithIcons} />
265
+
266
+ ### Label
267
+
268
+ The floating label across value × state. Empty + calm keeps the label **resting inside** (placeholder
269
+ position); a value, focus, error, Disabled or Read-only floats it to the top border. The floated
270
+ label's notch is a `--border-width-100` strip in the surface colour under the field (default
271
+ `--bg-primary`) that interrupts only the border line — not a full-height backplate — so the shell fill
272
+ (Disabled, Read-only) shows through behind the glyphs. The notch (and the optional tag's notch) widens
273
+ to `--border-width-200` while an invalid field is focused, so no red line shows under the label. Per spec a Read-only field always carries a
274
+ value — the empty Read-only cell is shown only for completeness.
275
+
276
+ <Canvas of={TextFieldStories.WithLabel} />
277
+
278
+ ### Motion
279
+
280
+ <Canvas of={TextFieldStories.Motion} />
281
+
282
+ Manifest 2.14.0 `motion.states.value` — the one thing that moves. The label **never travels and never
283
+ scales** between its two poses: the pose change is a cross-fade of two copies. The `<label>` itself
284
+ jumps to its new pose and plays the enter keyframe; an `aria-hidden` ghost paints the pose it left
285
+ (through `::before`, so there is no second text node) and fades out, then unmounts. Nothing plays on
286
+ mount — only a real change of pose (focus, first character, clear + blur, error appearing).
287
+
288
+ <table>
289
+ <thead>
290
+ <tr><th>What</th><th>How</th><th>Reduced motion</th></tr>
291
+ </thead>
292
+ <tbody>
293
+ <tr>
294
+ <td>Resting → floated (enter)</td>
295
+ <td>Floated label: opacity 0 → 1 and <code>translateY(-{'--space-200'})</code> → 0 (it settles 4px <em>down</em> onto the border) over <code>--duration-normal</code> + <code>--easing-enter</code> (<code>animate-field-label-float-in</code>). Resting copy: opacity 1 → 0 over <code>--duration-fast</code> + <code>--easing-exit</code> (<code>animate-field-label-out</code>).</td>
296
+ <td>Pose swaps at once — <code>motion-reduce:animate-none</code> on the label, <code>motion-reduce:hidden</code> on the ghost.</td>
297
+ </tr>
298
+ <tr>
299
+ <td>Floated → resting (exit)</td>
300
+ <td>Resting label: opacity only, <code>--duration-normal</code> + <code>--easing-enter</code> (<code>animate-field-label-rest-in</code>), no settle. Floated copy fades out on <code>--duration-fast</code> + <code>--easing-exit</code>.</td>
301
+ <td>Same — instant swap.</td>
302
+ </tr>
303
+ </tbody>
304
+ </table>
305
+
306
+ The `--space-200` settle is a deliberate calm-motion exception (like Hero's); text never scales. The leaving pose on the way back reuses the exit pair the manifest names
307
+ for the resting label — the manifest does not bind the floated label's fade-out separately. The
308
+ floated label's notch is painted on the label itself, so the border shows through it while it fades
309
+ in. The field family inherits this through the shared `Field` label (Textarea, Select / Combobox
310
+ Field, Subject Lookup Field, and TextField's own `type="date"` mode) and Field Pair's cells (`_field-segment`); fields whose
311
+ label is always floated (Unit Field, Number Field, Select Field) never change pose and never animate.
312
+
313
+ ## Date mode
314
+
315
+ <Canvas of={TextFieldStories.DateMode} />
316
+
317
+ `type="date"` is this field with a calendar (manifest `delivery.react`, 2.15.0). What changes:
318
+
319
+ - **The value is a `Date`**, in through `value` (controlled) or `defaultValue` (uncontrolled) and out
320
+ through `onValueChange`, never the formatted string. Clearing the field reports `undefined`.
321
+ Turning the `Date` into what the API stores is the consumer's job. The native string `value` /
322
+ `defaultValue` / `onChange` of the plain field give way to these `Date` props.
323
+ - **The format is the market's, not the design system's.** `dateFormat` (a date-fns pattern) and
324
+ `locale` (a date-fns `Locale`) are both required, with no default and no Czech fallback: the
325
+ consumer passes the format and locale of the market the field is shown in, and the field both
326
+ displays and parses the typed text in that format. `locale` also sets the calendar's week start,
327
+ weekday and month names. Examples: Czech `dd. MM. yyyy`, US `MM/dd/yyyy`, Dutch `dd-MM-yyyy`.
328
+ - **The native input stays `type="text"`**, never the native date input: no browser picker, no native
329
+ formatting. A typist keys the date straight in; the calendar is a faster alternative, never the only
330
+ way in.
331
+ - **The whole field is the trigger.** A click anywhere on the field (the input, the glyph or the shell
332
+ padding) opens the Single month Date Picker anchored to it. A press that misses the input keeps focus
333
+ and a half-typed draft in the input. Clicking the input again while the calendar is open does not
334
+ close it, so the caret can be placed.
335
+ - **The `calendar-dots` glyph is decorative.** It is forced into the leading slot, `aria-hidden` and not
336
+ focusable; there is no button in the field. `leadingIcon`, `trailingIcon` and the trailing-button
337
+ props are not accepted in this mode.
338
+ - **`minDate` / `maxDate` bound both routes.** The calendar disables the days outside them, and a typed
339
+ date outside them is rejected, the same as an unparseable one. Both bounds are inclusive and compared
340
+ by day.
341
+ - **The typed draft commits on blur, and on Enter.** Enter commits before it submits the form, so a
342
+ submit never carries a date the input no longer shows. The draft is parsed against `dateFormat` and `locale`; a draft that does
343
+ not parse, or parses to a day outside `minDate` / `maxDate`, is never coerced and never swapped back
344
+ for the old date. The typed text stays in the input, and the value becomes `undefined`
345
+ (`onValueChange(undefined)`, unless it already was), so a form cannot submit a date the user no
346
+ longer sees. The field raises no error state of its own; validation messaging stays the form's job
347
+ (`state="error"` + `error` on `Field`). `onInvalidInput(raw, reason)` tells the form why: `'unparseable'`
348
+ or `'out-of-range'`, with the text the user typed — the hook for the [Copy](#copy) error pattern,
349
+ shown next to that text (story `Date — Invalid typed date`). A valid or an emptied draft does not
350
+ fire it, and a rejected text the user has not edited is reported once, not on every blur; after a
351
+ change of `minDate` / `maxDate` or the format, the next blur or Enter judges it again. Picking
352
+ a day, a date the consumer sets, or a native form reset replaces the rejected text; text the user
353
+ is still typing is never replaced by an outside value change. Setting `value` to `undefined` does
354
+ not clear the rejected text (the value already is `undefined`); to empty the field from code,
355
+ reset its form or remount it with a new `key`.
356
+ - **One action reports one value.** Picking a day over a half-typed draft reports only the picked day:
357
+ the blur that moves focus into the calendar does not commit the draft.
358
+ - **Read-only never opens the calendar.** The glyph stays as a quiet marker in `--icon-muted`; the value
359
+ stays focusable and copyable. Disabled does not open it either. A calendar that is open when the
360
+ field turns disabled or read-only closes, and unlocking the field does not reopen it.
361
+ - **The label follows the one floating-label rule.** An empty, unfocused, valid date field without a
362
+ placeholder rests its `Field` label inside; a value, focus or a format placeholder floats it. The label
363
+ is offset past the calendar glyph in both poses.
364
+
365
+ The same field for another market, here `dateFormat="MM/dd/yyyy"` + `locale={enUS}`:
366
+
367
+ <Canvas of={TextFieldStories.DateOtherMarket} />
368
+
369
+ State × size, as for the plain field:
370
+
371
+ <Canvas of={TextFieldStories.DateMatrix} />
372
+
373
+ The calendar open from the keyboard (focus the field, press `ArrowDown`): focus lands on the selected
374
+ day, and the dialog is named by the field's label.
375
+
376
+ <Canvas of={TextFieldStories.DateOpen} />
377
+
378
+ An invalid typed date stays where the user typed it: `32. 13. 2026` + Tab keeps the text, the value
379
+ becomes `undefined`, and the form shows the [Copy](#copy) error next to it.
380
+
381
+ <Canvas of={TextFieldStories.DateInvalid} />
382
+
383
+ The date-mode props (the shared ones, `state`, `size`, `disabled`, `readOnly`, `placeholder`, `id`
384
+ and the rest, work as for the plain field):
385
+
386
+ <table>
387
+ <thead>
388
+ <tr><th>Prop</th><th>Type</th><th>Required</th><th>Notes</th></tr>
389
+ </thead>
390
+ <tbody>
391
+ <tr>
392
+ <td><code>type</code></td>
393
+ <td><code>'date'</code></td>
394
+ <td>yes</td>
395
+ <td>selects the date mode</td>
396
+ </tr>
397
+ <tr>
398
+ <td><code>value</code></td>
399
+ <td><code>Date</code></td>
400
+ <td>no</td>
401
+ <td>the chosen date; controlled while it is not <code>undefined</code></td>
402
+ </tr>
403
+ <tr>
404
+ <td><code>defaultValue</code></td>
405
+ <td><code>Date</code></td>
406
+ <td>no</td>
407
+ <td>initial date of an uncontrolled field (<code>value</code> left out)</td>
408
+ </tr>
409
+ <tr>
410
+ <td><code>onValueChange</code></td>
411
+ <td><code>(value: Date | undefined) =&gt; void</code></td>
412
+ <td>no</td>
413
+ <td>the committed date: a parsed typed draft, a picked day, or <code>undefined</code> when cleared</td>
414
+ </tr>
415
+ <tr>
416
+ <td><code>onInvalidInput</code></td>
417
+ <td><code>(raw: string, reason: 'unparseable' | 'out-of-range') =&gt; void</code></td>
418
+ <td>no</td>
419
+ <td>a typed draft was rejected on commit (blur or Enter): not in <code>dateFormat</code>, or outside <code>minDate</code> / <code>maxDate</code>; the typed text stays and the value becomes <code>undefined</code> (reported through <code>onValueChange</code> first). Use it to show the error on <code>Field</code></td>
420
+ </tr>
421
+ <tr>
422
+ <td><code>dateFormat</code></td>
423
+ <td><code>string</code></td>
424
+ <td>yes, no default</td>
425
+ <td>display + parse pattern in date-fns syntax, the market's (<code>dd. MM. yyyy</code>, <code>MM/dd/yyyy</code>, <code>dd-MM-yyyy</code>)</td>
426
+ </tr>
427
+ <tr>
428
+ <td><code>locale</code></td>
429
+ <td><code>Locale</code> (date-fns)</td>
430
+ <td>yes, no default</td>
431
+ <td>the market's locale: the calendar's week start, weekday and month names, and the parse</td>
432
+ </tr>
433
+ <tr>
434
+ <td><code>minDate</code> / <code>maxDate</code></td>
435
+ <td><code>Date</code></td>
436
+ <td>no</td>
437
+ <td>earliest / latest selectable day, inclusive; bounds the calendar and a typed date</td>
438
+ </tr>
439
+ <tr>
440
+ <td><code>panelLabelledBy</code></td>
441
+ <td><code>string</code></td>
442
+ <td>no</td>
443
+ <td>id of the visible text naming the calendar dialog (<code>aria-labelledby</code>); <code>Field</code> fills it with its <code>&lt;label&gt;</code> id, so inside a labelled <code>Field</code> there is nothing to pass. Wins over <code>panelLabel</code></td>
444
+ </tr>
445
+ <tr>
446
+ <td><code>panelLabel</code></td>
447
+ <td><code>string</code></td>
448
+ <td>no, no default</td>
449
+ <td>fallback accessible name (<code>aria-label</code>) of the calendar dialog, used only when nothing visible names the field. Without it the dialog takes the field's own <code>aria-labelledby</code> / <code>aria-label</code>; with no name at all it warns in development</td>
450
+ </tr>
451
+ <tr>
452
+ <td><code>navLabels</code></td>
453
+ <td><code>DatePickerNavLabels</code></td>
454
+ <td>yes</td>
455
+ <td>accessible names of the calendar's four chevrons: <code>previousMonth</code>, <code>nextMonth</code>, <code>previousYear</code>, <code>nextYear</code></td>
456
+ </tr>
457
+ <tr>
458
+ <td><code>className</code></td>
459
+ <td><code>string</code></td>
460
+ <td>no</td>
461
+ <td>applied to the trigger wrapper around the shell</td>
462
+ </tr>
463
+ </tbody>
464
+ </table>
465
+
466
+ ## API
467
+
468
+ <Controls />
469
+
470
+ ## Do / Don't
471
+
472
+ - ✅ Always wrap in `Field` and give the `<input>` an `id` — the floating `<label>` is the accessible name.
473
+ - ✅ Use `state="readonly"` for locked values — it stays copyable and in the tab order.
474
+ - ✅ Write specific, impersonal errors ("IČO musí mít 8 číslic" — problem + fix) and pair `state="error"` with a matching `error` on `Field`.
475
+ - ✅ Reach for the right component — Select for a fixed set, Textarea for multi-line; a date is a `type="date"` TextField that opens the Date Picker.
476
+ - ✅ For a date, pass the `dateFormat` and `locale` of the market the field is shown in, from the app's market config.
477
+ - ❌ Don't use the placeholder as the only label — it disappears on input and fails a11y.
478
+ - ❌ Don't build a separate "date field" component — a date field is this one with `type="date"`.
479
+ - ❌ Don't use `disabled` for a value the user still needs to read or copy.
480
+ - ❌ Don't ship generic "Neplatná hodnota" or commands ("Zadejte…").
481
+ - ❌ Don't place a TextField on a tinted / secondary background — the shell fill and contrast are built for `--bg-primary` only.
482
+
483
+ ## Accessibility
484
+
485
+ - **Keyboard** — standard text entry. `disabled` fields drop from the tab order; a `readonly` field
486
+ stays focusable, its text is selectable / copyable, and its value **is** submitted with the form. To
487
+ show a non-editable but readable value use Read-only, never `disabled`.
488
+ - **ARIA** — `state="error"` sets `aria-invalid="true"`; associate the message via `aria-describedby`
489
+ (handled by `Field`). `readonly` sets `aria-readonly`. A label-less filter / search field needs an
490
+ explicit `aria-label` — the placeholder is not a label (WCAG 1.3.1 / 3.3.2). An interactive trailing
491
+ icon (`onTrailingIconClick`) requires `trailingIconLabel`.
492
+ - **Date mode: keyboard** — the input is typeable like any TextField. `ArrowDown` opens the calendar and
493
+ moves focus onto the selected day (or today); with the calendar already open from a click, `ArrowDown`
494
+ moves focus into the grid. Opening by click leaves focus in the input, so typing keeps working.
495
+ Picking a day closes the calendar and returns focus to the input; `Esc` closes it and returns focus
496
+ to the field. With the calendar open, `Tab` runs from the input through the year and month
497
+ chevrons to the day, then leaves the calendar. A half-typed draft commits when `Tab` leaves the
498
+ input, as on any blur, so `onValueChange` or `onInvalidInput` fires before focus reaches the
499
+ calendar. The draft is kept only when focus moves straight into the open calendar — `ArrowDown`,
500
+ or a press on a day or a chevron: picking a day there replaces the draft, and only the picked day
501
+ is reported.
502
+ - **Date mode: format** — tell the user the format in the helper (or in the error), never only in the
503
+ placeholder, which disappears as soon as they type (WCAG 3.3.2). The Date story does it with the
504
+ helper «Formát DD. MM. RRRR».
505
+ - **Date mode: ARIA** — the input itself is the trigger: `role="combobox"`, `aria-haspopup="dialog"`,
506
+ `aria-expanded`, and `aria-controls` pointing at the calendar while it is open. A disabled date
507
+ field keeps the combobox role; a read-only one owns no calendar, so it is a plain textbox without
508
+ `role="combobox"` or `aria-haspopup`. The calendar is `role="dialog"`, named by the field's visible
509
+ `<label>` through `aria-labelledby` (`Field` passes it as `panelLabelledBy`); `panelLabel` is the
510
+ `aria-label` fallback for a field with no visible label, and without it the field's own
511
+ `aria-label` names the dialog too. Its chevrons are named by `navLabels`, which is required and
512
+ has no default — the consumer passes the names in the market's language. The calendar glyph is `aria-hidden`. Inside a `Modal` the calendar renders within the modal's dialog, so a day can take focus
513
+ past the focus trap.
514
+ - **Screen reader** — the floating `<label>` from `Field` is the accessible name; error / success are
515
+ conveyed by colour **and** a status icon (WCAG 1.4.1), so the cue is not colour-only.
516
+ - **Announcement** (manifest 2.9.1) — `Field` keeps the helper / message line **always mounted** as a
517
+ polite live region (`aria-live="polite"`), empty when there is no message, so an error or
518
+ confirmation that appears while focus is elsewhere (blur validation, an async check such as ARES) is
519
+ read out without moving focus — a region inserted together with its text is not announced. Never
520
+ `role="alert"`: an assertive announcement interrupts typing in the next field. The empty line adds no
521
+ gap, and `aria-describedby` points at it only while it holds a message. On a failed submit the form
522
+ moves focus to the first invalid field and the error is read via `aria-describedby`.
523
+ - **Contrast & motion** — focus is a 1px `--outline-focus` border swap with **no** ring. ⚠️ Accepted
524
+ tradeoff: a 1px swap is weaker than an offset ring and borderline for WCAG 2.4.11. The mitigation — thicken the focus border, never re-add a ring — is applied on invalid
525
+ fields: Error + focus keeps `--status-danger` and goes to `--border-width-200`, so focus stays
526
+ visible without trading the error colour for blue. Besides the border, the only motion of the field
527
+ is the floating label's cross-fade (see States → Motion), which honours `prefers-reduced-motion` and
528
+ swaps the pose at once there.
529
+
530
+ Accessibility floor for every FODS component: `spec/01-foundations/accessibility.md`.
531
+
532
+ ## Copy
533
+
534
+ These are the canonical copy rules for fields: other field components (Field Pair, Select,
535
+ Textarea …) follow them. Examples are Czech (the primary market); the rules hold for every language
536
+ version. Text length varies by language, so the maximum lengths below are guidance, not an enforced
537
+ `maxlength`, and the helper and error lines wrap.
538
+
539
+ Voice: five principles.
540
+
541
+ 1. **Impersonal and neutral.** In-app copy is depersonalised: avoid addressing the user (vy / ty)
542
+ where possible; prefer noun labels and plain statements.
543
+ 2. **Clear over clever.** Plain language, active voice, no jargon: being clear always matters more
544
+ than being entertaining.
545
+ 3. **Concise.** The shortest text that is still specific; honour the per-run maximum length.
546
+ 4. **Specific and helpful.** Especially errors: say what is wrong **and** how to fix it; never
547
+ blame, never generic.
548
+ 5. **Consistent terminology.** One word per concept (faktura, IČO, DIČ, odběratel …), matching the
549
+ product; don't introduce synonyms.
550
+
551
+ Per text run:
552
+
553
+ - **Label** (`label` on `Field`) — a noun phrase in sentence case, 1–3 words, no colon and no
554
+ command; always present. Instructions go in the helper, not the label. Single line, truncates with
555
+ an ellipsis at the field's inner width; about 24 characters at most.
556
+ - **Value** (the input's value) — single line; the editable input scrolls horizontally (no
557
+ ellipsis) and truncates only when rendered read-only. The component sets no maximum length: the
558
+ consumer sets `maxlength` per type (IČO 8, PSČ 5, …).
559
+ - **Placeholder** (`placeholder` on `TextField`) — optional, a **format example** only, never a
560
+ substitute for the label or a repeat of it. Shown only while the field is empty; never on a
561
+ Disabled field, which shows an en dash "–" instead. Single line, truncates with an ellipsis; about
562
+ 30 characters at most.
563
+ - **Helper** (`helperText` on `Field`) — a persistent hint: the format, or where to find the value.
564
+ Concise, about one line; wraps and is never truncated; about 120 characters at most.
565
+ - **Error** (`error` on `Field`) — impersonal, **problem + fix or format**, specific; it replaces
566
+ the helper. Wraps and must stay fully visible (WCAG 3.3.1); the field keeps its height and only
567
+ the message area below grows; about 140 characters at most.
568
+ - **Optional tag** (`optionalLabel` on `Field`) — `Volitelný`, capitalised and without brackets, on
569
+ optional fields **only**.
570
+
571
+ Error pattern: `[what's wrong]( + [expected format])`, impersonal, e.g. "Neplatné datum — formát
572
+ DD. MM. RRRR". The format named is the market's own (see [Date mode](#date-mode)); `DD. MM. RRRR` is
573
+ the Czech one, and the same holds for a date field's format placeholder. Not a command ("Zadejte…"),
574
+ not a bare label ("Chyba").
575
+
576
+ <table>
577
+ <thead>
578
+ <tr><th>Run</th><th>✅</th><th>❌</th></tr>
579
+ </thead>
580
+ <tbody>
581
+ <tr><td>Label</td><td><code>IČO</code> · <code>Datum splatnosti</code></td><td><code>Zadejte vaše IČO:</code></td></tr>
582
+ <tr><td>Placeholder</td><td><code>12345678</code></td><td><code>Sem napište IČO</code></td></tr>
583
+ <tr><td>Helper</td><td><code>Najdete v hlavičce faktury</code></td><td><code>Toto pole je pro IČO</code></td></tr>
584
+ <tr><td>Error</td><td><code>IČO musí mít 8 číslic</code></td><td><code>Chyba</code> · <code>Neplatná hodnota</code></td></tr>
585
+ <tr><td>Optional tag</td><td><code>Volitelný</code></td><td><code>*</code> on every required field</td></tr>
586
+ </tbody>
587
+ </table>
588
+
589
+ ## Usage
590
+
591
+ <Canvas of={TextFieldStories.WithField} />
592
+
593
+ ```tsx
594
+ // Good — wrapped in Field, input has an id, label is the accessible name
595
+ <Field label="IČO" helperText="Najdete v hlavičce faktury">
596
+ <TextField id="ico" defaultValue="12345678" />
597
+ </Field>
598
+
599
+ // Good — error state paired with a matching, specific message
600
+ <Field label="IČO" error="IČO musí mít 8 číslic">
601
+ <TextField id="ico" state="error" defaultValue="1234" />
602
+ </Field>
603
+
604
+ // Good — locked, computed value stays copyable (readonly, not disabled)
605
+ <Field label="Variabilní symbol" helperText="Odvozeno z čísla faktury">
606
+ <TextField id="vs" state="readonly" defaultValue="20260721" />
607
+ </Field>
608
+
609
+ // Good — search / filter field with a leading glyph and an aria-label
610
+ <TextField leadingIcon="magnifying-glass" placeholder="Hledat…" aria-label="Hledat" />
611
+
612
+ // Good — a date: a Date in and out; format, locale and the calendar's names
613
+ // come from the market the field is shown in (here the Czech one); the helper
614
+ // states the format, and a rejected draft becomes the Field's error, shown
615
+ // next to the text the user typed
616
+ const [issuedOn, setIssuedOn] = React.useState<Date | undefined>();
617
+ const [dateError, setDateError] = React.useState<string>();
618
+
619
+ <Field
620
+ label="Datum vystavení"
621
+ helperText="Formát DD. MM. RRRR"
622
+ error={dateError}
623
+ >
624
+ <TextField
625
+ type="date"
626
+ id="issued-on"
627
+ state={dateError ? 'error' : undefined}
628
+ value={issuedOn}
629
+ onValueChange={date => { setDateError(undefined); setIssuedOn(date); }}
630
+ onInvalidInput={(_raw, reason) => setDateError(
631
+ reason === 'out-of-range'
632
+ ? 'Datum musí být nejdříve 1. 1. 2020'
633
+ : 'Neplatné datum — formát DD. MM. RRRR',
634
+ )}
635
+ dateFormat="dd. MM. yyyy" // another market passes its own pattern and texts
636
+ locale={cs} // the date-fns Locale of the market
637
+ navLabels={{
638
+ previousMonth: 'Předchozí měsíc',
639
+ nextMonth: 'Další měsíc',
640
+ previousYear: 'Předchozí rok',
641
+ nextYear: 'Další rok',
642
+ }}
643
+ placeholder="DD. MM. RRRR"
644
+ minDate={new Date(2020, 0, 1)}
645
+ />
646
+ </Field>
647
+ ```
648
+
649
+ ```tsx
650
+ // Don't — placeholder used as the only label (no Field, no id, no aria-label)
651
+ <TextField placeholder="IČO" />
652
+
653
+ // Don't — disabled hides a value the user still needs to read / copy
654
+ <TextField state="disabled" defaultValue="20260721" />
655
+
656
+ // Don't — a formatted string is not a date value; the value is a Date
657
+ <TextField type="date" value="15. 04. 2026" {...marketDateProps} />
658
+ ```
659
+
660
+ ## Related
661
+
662
+ - [`Field`](?path=/docs/design-system-atoms-field--docs) — the wrapper that supplies the floating label, helper and error / success messaging (mandatory partner).
663
+ - [`Textarea`](?path=/docs/design-system-atoms-textarea--docs) — multi-line sibling sharing the same shell.
664
+ - [`DatePicker`](?path=/docs/design-system-molecules-datepicker--docs) — the calendar panel `type="date"` opens; use it directly for a dual-month range.
665
+ - [`FieldPair`](?path=/docs/design-system-molecules-fieldpair--docs) — `format="date"`: a date range as two fused cells, each opening its own single-month calendar.
666
+ - `UnitField` — TextField shell with an in-field unit / suffix (`Kč`, `%`).
667
+ - `NumberField` — the stepper variant for numeric quantities.
668
+ - `Select` — for choosing from a fixed set of options; reuses the same field shell.
669
+ - Spec: `spec/03-atoms/text-field.md`.
670
+
671
+ ## Migration notes
672
+
673
+ - **Manifest 2.14.0 (2026-11-03) — floating-label motion.** The label used to *travel*: a 200ms
674
+ transition on `top` / `left` / `transform` / `font-size` / `color` / `padding` / `max-width`, plus a
675
+ delayed `background` for the notch, all on raw values. It now cross-fades on motion tokens (States →
676
+ Motion) and has no transition at all — status ink changes (error ↔ default) are now instant too, as
677
+ the manifest's motion block lists nothing else that moves. Field Pair dropped its own copy of the
678
+ old transition (`SEGMENT_LABEL_TRANSITION`) and cross-fades its cells the same way.
679
+ - **Manifest 2.15.0 (2026-11-19) — `type="date"` built.** The type that manifest 2.7.0 added is now
680
+ implemented (see [Date mode](#date-mode)); before, `type` was passed straight to the input. 2.15.0
681
+ makes the format the market's: the value is a `Date`, and `dateFormat` + `locale` are required props
682
+ with no Czech default. A `type="date"` TextField without them, or with a string `value`, does not
683
+ type-check. `type` is also narrowed to the manifest's list (`text`, `email`, `tel`, `url`,
684
+ `search`, `password`, `numeric`, `date`). `numeric` is not an HTML input type: it renders
685
+ `type="text"` with `inputMode="numeric"`, right-aligned, so a digit string such as an IČO keeps its
686
+ leading zeros. A number you calculate with belongs in `NumberField` or `UnitField`.
687
+ - **`Help` (the label's ⓘ Tooltip trigger) is specified upstream but NOT built here.** The manifest
688
+ property `Help` (on the nested `_labelContainer`) puts an info ⓘ after the label text; `Field` has
689
+ no prop for it. Manifest 2.11.0 (2026-10-13) adds that a field with `Help` on floats its label even
690
+ while empty and shows the placeholder inside — the one exception to the floating-label rule — and
691
+ that there is no trailing help slot. Without a `Help` prop that exception has nothing to hang on, so
692
+ the float rule here is unchanged; until `Help` ships, put a hint the user needs before typing into
693
+ `helperText` (the spec's "helper first" route), never into a trailing icon.
694
+ - **Numeric quantities** with a stepper are a **separate NumberField component**, not a TextField
695
+ variant. **In-field units / computed suffixes** (`Kč`, `%`) live in the **separate UnitField**,
696
+ keeping TextField's trailing slot icons-only.
697
+ - **Icon names match the spec.** The component uses the canonical FODS names (Error
698
+ `warning-circle`, Success `check-circle`, leading `magnifying-glass`); the legacy icon-font names
699
+ are not part of `IconName` in React.