@invoiceonline/ui-react 0.0.0-stage → 0.1.0

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