@invoiceonline/ui-react 0.0.0 → 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (738) hide show
  1. package/AGENTS.md +99 -0
  2. package/CHANGELOG.md +131 -0
  3. package/LICENSE +9 -0
  4. package/README.md +77 -1
  5. package/dist/assets/label-brush-1.svg +6 -0
  6. package/dist/assets/pattern-dark.svg +113 -0
  7. package/dist/components/action-row/ActionRow.d.ts +178 -0
  8. package/dist/components/action-row/ActionRow.js +340 -0
  9. package/dist/components/action-row/index.d.ts +2 -0
  10. package/dist/components/action-row/index.js +1 -0
  11. package/dist/components/alert/Alert.d.ts +314 -0
  12. package/dist/components/alert/Alert.js +446 -0
  13. package/dist/components/alert/index.d.ts +2 -0
  14. package/dist/components/alert/index.js +1 -0
  15. package/dist/components/anchored-panel/AnchoredPanel.d.ts +41 -0
  16. package/dist/components/anchored-panel/AnchoredPanel.js +72 -0
  17. package/dist/components/anchored-panel/index.d.ts +3 -0
  18. package/dist/components/anchored-panel/index.js +3 -0
  19. package/dist/components/badge/Badge.d.ts +146 -0
  20. package/dist/components/badge/Badge.js +258 -0
  21. package/dist/components/badge/index.d.ts +2 -0
  22. package/dist/components/badge/index.js +1 -0
  23. package/dist/components/banner/Banner.d.ts +209 -0
  24. package/dist/components/banner/Banner.js +339 -0
  25. package/dist/components/banner/index.d.ts +2 -0
  26. package/dist/components/banner/index.js +1 -0
  27. package/dist/components/button/Button.d.ts +54 -0
  28. package/dist/components/button/Button.js +312 -0
  29. package/dist/components/button/index.d.ts +2 -0
  30. package/dist/components/button/index.js +1 -0
  31. package/dist/components/button-group/ButtonGroup.d.ts +187 -0
  32. package/dist/components/button-group/ButtonGroup.js +217 -0
  33. package/dist/components/button-group/index.d.ts +2 -0
  34. package/dist/components/button-group/index.js +1 -0
  35. package/dist/components/card-select/CardSelect.d.ts +274 -0
  36. package/dist/components/card-select/CardSelect.js +561 -0
  37. package/dist/components/card-select/CardSelectGroup.d.ts +92 -0
  38. package/dist/components/card-select/CardSelectGroup.js +72 -0
  39. package/dist/components/card-select/index.d.ts +3 -0
  40. package/dist/components/card-select/index.js +3 -0
  41. package/dist/components/checkbox/Checkbox.d.ts +104 -0
  42. package/dist/components/checkbox/Checkbox.js +194 -0
  43. package/dist/components/checkbox/index.d.ts +2 -0
  44. package/dist/components/checkbox/index.js +1 -0
  45. package/dist/components/chip/Chip.d.ts +250 -0
  46. package/dist/components/chip/Chip.js +441 -0
  47. package/dist/components/chip/index.d.ts +2 -0
  48. package/dist/components/chip/index.js +1 -0
  49. package/dist/components/column-header/ColumnHeader.d.ts +144 -0
  50. package/dist/components/column-header/ColumnHeader.js +209 -0
  51. package/dist/components/column-header/index.d.ts +2 -0
  52. package/dist/components/column-header/index.js +1 -0
  53. package/dist/components/combobox-field/Combobox.d.ts +104 -0
  54. package/dist/components/combobox-field/Combobox.js +355 -0
  55. package/dist/components/combobox-field/ComboboxField.d.ts +76 -0
  56. package/dist/components/combobox-field/ComboboxField.js +98 -0
  57. package/dist/components/combobox-field/index.d.ts +3 -0
  58. package/dist/components/combobox-field/index.js +3 -0
  59. package/dist/components/date-field/DateField.d.ts +52 -0
  60. package/dist/components/date-field/DateField.js +45 -0
  61. package/dist/components/date-field/index.d.ts +2 -0
  62. package/dist/components/date-field/index.js +1 -0
  63. package/dist/components/date-picker/DatePicker.d.ts +53 -0
  64. package/dist/components/date-picker/DatePicker.js +329 -0
  65. package/dist/components/date-picker/index.d.ts +2 -0
  66. package/dist/components/date-picker/index.js +1 -0
  67. package/dist/components/divider/Divider.d.ts +81 -0
  68. package/dist/components/divider/Divider.js +93 -0
  69. package/dist/components/divider/index.d.ts +2 -0
  70. package/dist/components/divider/index.js +1 -0
  71. package/dist/components/drawer/Drawer.d.ts +128 -0
  72. package/dist/components/drawer/Drawer.js +367 -0
  73. package/dist/components/drawer/index.d.ts +2 -0
  74. package/dist/components/drawer/index.js +1 -0
  75. package/dist/components/dropdown-button/DropdownButton.d.ts +72 -0
  76. package/dist/components/dropdown-button/DropdownButton.js +122 -0
  77. package/dist/components/dropdown-button/index.d.ts +2 -0
  78. package/dist/components/dropdown-button/index.js +1 -0
  79. package/dist/components/faq/FAQ.d.ts +135 -0
  80. package/dist/components/faq/FAQ.js +258 -0
  81. package/dist/components/faq/index.d.ts +2 -0
  82. package/dist/components/faq/index.js +1 -0
  83. package/dist/components/field/Field.d.ts +118 -0
  84. package/dist/components/field/Field.js +327 -0
  85. package/dist/components/field/index.d.ts +2 -0
  86. package/dist/components/field/index.js +1 -0
  87. package/dist/components/field-pair/FieldPair.d.ts +194 -0
  88. package/dist/components/field-pair/FieldPair.js +321 -0
  89. package/dist/components/field-pair/index.d.ts +2 -0
  90. package/dist/components/field-pair/index.js +1 -0
  91. package/dist/components/file-upload/FileUpload.d.ts +137 -0
  92. package/dist/components/file-upload/FileUpload.js +434 -0
  93. package/dist/components/file-upload/index.d.ts +2 -0
  94. package/dist/components/file-upload/index.js +1 -0
  95. package/dist/components/filter-chip/FilterChip.d.ts +373 -0
  96. package/dist/components/filter-chip/FilterChip.js +517 -0
  97. package/dist/components/filter-chip/index.d.ts +2 -0
  98. package/dist/components/filter-chip/index.js +1 -0
  99. package/dist/components/filter-facet/FilterFacet.d.ts +116 -0
  100. package/dist/components/filter-facet/FilterFacet.js +632 -0
  101. package/dist/components/filter-facet/index.d.ts +2 -0
  102. package/dist/components/filter-facet/index.js +1 -0
  103. package/dist/components/firm-avatar/FirmAvatar.d.ts +75 -0
  104. package/dist/components/firm-avatar/FirmAvatar.js +119 -0
  105. package/dist/components/firm-avatar/index.d.ts +2 -0
  106. package/dist/components/firm-avatar/index.js +1 -0
  107. package/dist/components/form-actions/FormActions.d.ts +123 -0
  108. package/dist/components/form-actions/FormActions.js +195 -0
  109. package/dist/components/form-actions/index.d.ts +2 -0
  110. package/dist/components/form-actions/index.js +1 -0
  111. package/dist/components/form-block/FormBlock.d.ts +252 -0
  112. package/dist/components/form-block/FormBlock.js +420 -0
  113. package/dist/components/form-block/index.d.ts +3 -0
  114. package/dist/components/form-block/index.js +3 -0
  115. package/dist/components/form-section/FormSection.d.ts +130 -0
  116. package/dist/components/form-section/FormSection.js +206 -0
  117. package/dist/components/form-section/index.d.ts +2 -0
  118. package/dist/components/form-section/index.js +1 -0
  119. package/dist/components/heading/Heading.d.ts +69 -0
  120. package/dist/components/heading/Heading.js +79 -0
  121. package/dist/components/heading/index.d.ts +2 -0
  122. package/dist/components/heading/index.js +1 -0
  123. package/dist/components/heading-group/HeadingGroup.d.ts +258 -0
  124. package/dist/components/heading-group/HeadingGroup.js +255 -0
  125. package/dist/components/heading-group/index.d.ts +2 -0
  126. package/dist/components/heading-group/index.js +1 -0
  127. package/dist/components/hero/Hero.d.ts +268 -0
  128. package/dist/components/hero/Hero.js +316 -0
  129. package/dist/components/hero/index.d.ts +2 -0
  130. package/dist/components/hero/index.js +1 -0
  131. package/dist/components/icon/Icon.d.ts +27 -0
  132. package/dist/components/icon/Icon.js +30 -0
  133. package/dist/components/icon/index.d.ts +3 -0
  134. package/dist/components/icon/index.js +3 -0
  135. package/dist/components/icon-button/IconButton.d.ts +75 -0
  136. package/dist/components/icon-button/IconButton.js +151 -0
  137. package/dist/components/icon-button/index.d.ts +2 -0
  138. package/dist/components/icon-button/index.js +1 -0
  139. package/dist/components/item-row/ItemRow.d.ts +253 -0
  140. package/dist/components/item-row/ItemRow.js +496 -0
  141. package/dist/components/item-row/index.d.ts +2 -0
  142. package/dist/components/item-row/index.js +1 -0
  143. package/dist/components/list-row/ListRow.d.ts +165 -0
  144. package/dist/components/list-row/ListRow.js +233 -0
  145. package/dist/components/list-row/index.d.ts +2 -0
  146. package/dist/components/list-row/index.js +1 -0
  147. package/dist/components/menu/Menu.d.ts +64 -0
  148. package/dist/components/menu/Menu.js +186 -0
  149. package/dist/components/menu/index.d.ts +2 -0
  150. package/dist/components/menu/index.js +1 -0
  151. package/dist/components/modal/Modal.d.ts +272 -0
  152. package/dist/components/modal/Modal.js +788 -0
  153. package/dist/components/modal/index.d.ts +2 -0
  154. package/dist/components/modal/index.js +1 -0
  155. package/dist/components/nav-link/NavLink.d.ts +123 -0
  156. package/dist/components/nav-link/NavLink.js +157 -0
  157. package/dist/components/nav-link/index.d.ts +2 -0
  158. package/dist/components/nav-link/index.js +1 -0
  159. package/dist/components/number-field/NumberField.d.ts +62 -0
  160. package/dist/components/number-field/NumberField.js +210 -0
  161. package/dist/components/number-field/index.d.ts +2 -0
  162. package/dist/components/number-field/index.js +1 -0
  163. package/dist/components/pagination/Pagination.d.ts +133 -0
  164. package/dist/components/pagination/Pagination.js +217 -0
  165. package/dist/components/pagination/index.d.ts +3 -0
  166. package/dist/components/pagination/index.js +3 -0
  167. package/dist/components/popover-surface/index.d.ts +2 -0
  168. package/dist/components/popover-surface/index.js +1 -0
  169. package/dist/components/progress-bar/ProgressBar.d.ts +260 -0
  170. package/dist/components/progress-bar/ProgressBar.js +470 -0
  171. package/dist/components/progress-bar/index.d.ts +2 -0
  172. package/dist/components/progress-bar/index.js +1 -0
  173. package/dist/components/promo-sticker/PromoSticker.d.ts +204 -0
  174. package/dist/components/promo-sticker/PromoSticker.js +177 -0
  175. package/dist/components/promo-sticker/index.d.ts +2 -0
  176. package/dist/components/promo-sticker/index.js +1 -0
  177. package/dist/components/promo-surface/PromoSurface.d.ts +94 -0
  178. package/dist/components/promo-surface/PromoSurface.js +119 -0
  179. package/dist/components/promo-surface/index.d.ts +2 -0
  180. package/dist/components/promo-surface/index.js +1 -0
  181. package/dist/components/radio/Radio.d.ts +92 -0
  182. package/dist/components/radio/Radio.js +171 -0
  183. package/dist/components/radio/index.d.ts +2 -0
  184. package/dist/components/radio/index.js +1 -0
  185. package/dist/components/radio-group/RadioGroup.d.ts +61 -0
  186. package/dist/components/radio-group/RadioGroup.js +51 -0
  187. package/dist/components/radio-group/index.d.ts +2 -0
  188. package/dist/components/radio-group/index.js +1 -0
  189. package/dist/components/select/Select.d.ts +65 -0
  190. package/dist/components/select/Select.js +176 -0
  191. package/dist/components/select/index.d.ts +2 -0
  192. package/dist/components/select/index.js +1 -0
  193. package/dist/components/select-field/SelectField.d.ts +16 -0
  194. package/dist/components/select-field/SelectField.js +55 -0
  195. package/dist/components/select-field/index.d.ts +2 -0
  196. package/dist/components/select-field/index.js +1 -0
  197. package/dist/components/skeleton/Skeleton.d.ts +64 -0
  198. package/dist/components/skeleton/Skeleton.js +65 -0
  199. package/dist/components/skeleton/index.d.ts +2 -0
  200. package/dist/components/skeleton/index.js +1 -0
  201. package/dist/components/split-button/SplitButton.d.ts +80 -0
  202. package/dist/components/split-button/SplitButton.js +182 -0
  203. package/dist/components/split-button/index.d.ts +2 -0
  204. package/dist/components/split-button/index.js +1 -0
  205. package/dist/components/status-summary-bar/StatusSummaryBar.d.ts +118 -0
  206. package/dist/components/status-summary-bar/StatusSummaryBar.js +278 -0
  207. package/dist/components/status-summary-bar/index.d.ts +2 -0
  208. package/dist/components/status-summary-bar/index.js +1 -0
  209. package/dist/components/subject-lookup-field/SubjectLookupField.d.ts +157 -0
  210. package/dist/components/subject-lookup-field/SubjectLookupField.js +663 -0
  211. package/dist/components/subject-lookup-field/index.d.ts +2 -0
  212. package/dist/components/subject-lookup-field/index.js +1 -0
  213. package/dist/components/switch/Switch.d.ts +152 -0
  214. package/dist/components/switch/Switch.js +307 -0
  215. package/dist/components/switch/index.d.ts +2 -0
  216. package/dist/components/switch/index.js +1 -0
  217. package/dist/components/table/Table.d.ts +5 -0
  218. package/dist/components/table/Table.js +601 -0
  219. package/dist/components/table/index.d.ts +6 -0
  220. package/dist/components/table/index.js +6 -0
  221. package/dist/components/text-field/TextField.d.ts +65 -0
  222. package/dist/components/text-field/TextField.js +173 -0
  223. package/dist/components/text-field/index.d.ts +2 -0
  224. package/dist/components/text-field/index.js +1 -0
  225. package/dist/components/text-link/TextLink.d.ts +260 -0
  226. package/dist/components/text-link/TextLink.js +303 -0
  227. package/dist/components/text-link/index.d.ts +2 -0
  228. package/dist/components/text-link/index.js +1 -0
  229. package/dist/components/textarea/Textarea.d.ts +93 -0
  230. package/dist/components/textarea/Textarea.js +256 -0
  231. package/dist/components/textarea/index.d.ts +2 -0
  232. package/dist/components/textarea/index.js +1 -0
  233. package/dist/components/tooltip/Tooltip.d.ts +129 -0
  234. package/dist/components/tooltip/Tooltip.js +457 -0
  235. package/dist/components/tooltip/index.d.ts +2 -0
  236. package/dist/components/tooltip/index.js +1 -0
  237. package/dist/components/unit-field/UnitField.d.ts +46 -0
  238. package/dist/components/unit-field/UnitField.js +133 -0
  239. package/dist/components/unit-field/index.d.ts +2 -0
  240. package/dist/components/unit-field/index.js +1 -0
  241. package/dist/icons/icon-registry.generated.js +500 -0
  242. package/dist/icons/icon-types.generated.d.ts +2 -0
  243. package/dist/icons/icon-types.generated.js +126 -0
  244. package/dist/index.d.ts +132 -0
  245. package/dist/index.js +75 -0
  246. package/dist/internal/BottomSheet.js +496 -0
  247. package/dist/internal/FodsProvider.d.ts +25 -0
  248. package/dist/internal/FodsProvider.js +32 -0
  249. package/dist/internal/MotionCaret.js +35 -0
  250. package/dist/internal/NumberFormatInput.d.ts +21 -0
  251. package/dist/internal/NumberFormatInput.js +126 -0
  252. package/dist/internal/SummaryDonut.d.ts +3 -0
  253. package/dist/internal/SummaryDonut.js +300 -0
  254. package/dist/internal/buttonSegment.d.ts +44 -0
  255. package/dist/internal/buttonSegment.js +126 -0
  256. package/dist/internal/collapseRoom.js +128 -0
  257. package/dist/internal/comboboxKeys.js +44 -0
  258. package/dist/internal/contentPresence.js +46 -0
  259. package/dist/internal/dayCell.js +95 -0
  260. package/dist/internal/dialogPortal.d.ts +2 -0
  261. package/dist/internal/dialogPortal.js +21 -0
  262. package/dist/internal/donutSweeps.js +65 -0
  263. package/dist/internal/enterOnViewGeometry.js +46 -0
  264. package/dist/internal/faqItem.js +80 -0
  265. package/dist/internal/floatingLabelMotion.js +68 -0
  266. package/dist/internal/formBlockContext.d.ts +22 -0
  267. package/dist/internal/formBlockContext.js +20 -0
  268. package/dist/internal/heightRoom.js +87 -0
  269. package/dist/internal/numberSeparators.js +62 -0
  270. package/dist/internal/overlayMotion.js +48 -0
  271. package/dist/internal/paginationItem.d.ts +8 -0
  272. package/dist/internal/paginationItem.js +22 -0
  273. package/dist/internal/popoverSurface.d.ts +8 -0
  274. package/dist/internal/popoverSurface.js +23 -0
  275. package/dist/internal/portalContainer.d.ts +1 -0
  276. package/dist/internal/portalContainer.js +6 -0
  277. package/dist/internal/progressBarItem.d.ts +207 -0
  278. package/dist/internal/progressBarItem.js +264 -0
  279. package/dist/internal/selectionControlText.js +12 -0
  280. package/dist/internal/statusSummaryParts.js +371 -0
  281. package/dist/internal/summaryMotion.js +75 -0
  282. package/dist/internal/table/ChildConnector.js +62 -0
  283. package/dist/internal/table/ChildRowPrefix.d.ts +9 -0
  284. package/dist/internal/table/ChildRowPrefix.js +27 -0
  285. package/dist/internal/table/ColumnSettings.js +135 -0
  286. package/dist/internal/table/ScrollRegion.js +114 -0
  287. package/dist/internal/table/TableEmpty.js +93 -0
  288. package/dist/internal/table/TableLayout.d.ts +17 -0
  289. package/dist/internal/table/TableLayout.js +29 -0
  290. package/dist/internal/table/TableLoadStatus.js +56 -0
  291. package/dist/internal/table/TableMobile.js +488 -0
  292. package/dist/internal/table/TruncatedCell.js +33 -0
  293. package/dist/internal/table/emptyValue.js +10 -0
  294. package/dist/internal/table/features.d.ts +41 -0
  295. package/dist/internal/table/features.js +31 -0
  296. package/dist/internal/table/recipes.js +227 -0
  297. package/dist/internal/table/rowClick.js +9 -0
  298. package/dist/internal/table/types.d.ts +325 -0
  299. package/dist/internal/table/types.js +13 -0
  300. package/dist/internal/tailwind-variants.d.ts +3 -0
  301. package/dist/internal/tailwind-variants.js +37 -0
  302. package/dist/internal/tooltipContext.js +5 -0
  303. package/dist/internal/tw-merge-config.generated.js +314 -0
  304. package/dist/internal/useAnchoredPanel.d.ts +87 -0
  305. package/dist/internal/useAnchoredPanel.js +108 -0
  306. package/dist/internal/useCountUp.js +53 -0
  307. package/dist/internal/useDateFieldTrigger.js +183 -0
  308. package/dist/internal/useEChart.js +59 -0
  309. package/dist/internal/useEnterOnView.js +42 -0
  310. package/dist/internal/useFloatingBar.js +100 -0
  311. package/dist/internal/useFormReset.js +37 -0
  312. package/dist/internal/useIsMobile.js +44 -0
  313. package/dist/internal/useOneRowOverflow.js +88 -0
  314. package/dist/internal/usePrefersReducedMotion.js +25 -0
  315. package/dist/internal/useReturnFocus.js +26 -0
  316. package/dist/internal/utils.d.ts +7 -0
  317. package/dist/internal/utils.js +58 -0
  318. package/dist/node_modules/@tanstack/store/dist/store.d.ts +29 -0
  319. package/dist/node_modules/@tanstack/store/dist/types.d.ts +38 -0
  320. package/dist/node_modules/@tanstack/table-core/dist/core/cells/coreCellsFeature.d.ts +6 -0
  321. package/dist/node_modules/@tanstack/table-core/dist/core/cells/coreCellsFeature.types.d.ts +53 -0
  322. package/dist/node_modules/@tanstack/table-core/dist/core/columns/coreColumnsFeature.d.ts +6 -0
  323. package/dist/node_modules/@tanstack/table-core/dist/core/columns/coreColumnsFeature.types.d.ts +90 -0
  324. package/dist/node_modules/@tanstack/table-core/dist/core/coreFeatures.d.ts +17 -0
  325. package/dist/node_modules/@tanstack/table-core/dist/core/headers/coreHeadersFeature.d.ts +6 -0
  326. package/dist/node_modules/@tanstack/table-core/dist/core/headers/coreHeadersFeature.types.d.ts +114 -0
  327. package/dist/node_modules/@tanstack/table-core/dist/core/reactivity/coreReactivityFeature.types.d.ts +51 -0
  328. package/dist/node_modules/@tanstack/table-core/dist/core/row-models/coreRowModelsFeature.d.ts +6 -0
  329. package/dist/node_modules/@tanstack/table-core/dist/core/row-models/coreRowModelsFeature.types.d.ts +29 -0
  330. package/dist/node_modules/@tanstack/table-core/dist/core/rows/coreRowsFeature.d.ts +6 -0
  331. package/dist/node_modules/@tanstack/table-core/dist/core/rows/coreRowsFeature.types.d.ts +129 -0
  332. package/dist/node_modules/@tanstack/table-core/dist/core/table/coreTablesFeature.d.ts +6 -0
  333. package/dist/node_modules/@tanstack/table-core/dist/core/table/coreTablesFeature.types.d.ts +203 -0
  334. package/dist/node_modules/@tanstack/table-core/dist/features/cell-selection/cellSelectionFeature.d.ts +6 -0
  335. package/dist/node_modules/@tanstack/table-core/dist/features/cell-selection/cellSelectionFeature.types.d.ts +294 -0
  336. package/dist/node_modules/@tanstack/table-core/dist/features/cell-spanning/cellSpanningFeature.d.ts +11 -0
  337. package/dist/node_modules/@tanstack/table-core/dist/features/cell-spanning/cellSpanningFeature.types.d.ts +148 -0
  338. package/dist/node_modules/@tanstack/table-core/dist/features/column-faceting/columnFacetingFeature.d.ts +12 -0
  339. package/dist/node_modules/@tanstack/table-core/dist/features/column-faceting/columnFacetingFeature.types.d.ts +63 -0
  340. package/dist/node_modules/@tanstack/table-core/dist/features/column-filtering/columnFilteringFeature.d.ts +6 -0
  341. package/dist/node_modules/@tanstack/table-core/dist/features/column-filtering/columnFilteringFeature.types.d.ts +209 -0
  342. package/dist/node_modules/@tanstack/table-core/dist/features/column-filtering/filterFns.d.ts +35 -0
  343. package/dist/node_modules/@tanstack/table-core/dist/features/column-grouping/columnGroupingFeature.d.ts +6 -0
  344. package/dist/node_modules/@tanstack/table-core/dist/features/column-grouping/columnGroupingFeature.types.d.ts +128 -0
  345. package/dist/node_modules/@tanstack/table-core/dist/features/column-ordering/columnOrderingFeature.d.ts +6 -0
  346. package/dist/node_modules/@tanstack/table-core/dist/features/column-ordering/columnOrderingFeature.types.d.ts +82 -0
  347. package/dist/node_modules/@tanstack/table-core/dist/features/column-pinning/columnPinningFeature.d.ts +11 -0
  348. package/dist/node_modules/@tanstack/table-core/dist/features/column-pinning/columnPinningFeature.types.d.ts +195 -0
  349. package/dist/node_modules/@tanstack/table-core/dist/features/column-resizing/columnResizingFeature.d.ts +6 -0
  350. package/dist/node_modules/@tanstack/table-core/dist/features/column-resizing/columnResizingFeature.types.d.ts +73 -0
  351. package/dist/node_modules/@tanstack/table-core/dist/features/column-sizing/columnSizingFeature.d.ts +6 -0
  352. package/dist/node_modules/@tanstack/table-core/dist/features/column-sizing/columnSizingFeature.types.d.ts +134 -0
  353. package/dist/node_modules/@tanstack/table-core/dist/features/column-visibility/columnVisibilityFeature.d.ts +6 -0
  354. package/dist/node_modules/@tanstack/table-core/dist/features/column-visibility/columnVisibilityFeature.types.d.ts +92 -0
  355. package/dist/node_modules/@tanstack/table-core/dist/features/global-filtering/globalFilteringFeature.d.ts +6 -0
  356. package/dist/node_modules/@tanstack/table-core/dist/features/global-filtering/globalFilteringFeature.types.d.ts +67 -0
  357. package/dist/node_modules/@tanstack/table-core/dist/features/row-aggregation/aggregationFns.d.ts +23 -0
  358. package/dist/node_modules/@tanstack/table-core/dist/features/row-aggregation/rowAggregationFeature.d.ts +6 -0
  359. package/dist/node_modules/@tanstack/table-core/dist/features/row-aggregation/rowAggregationFeature.types.d.ts +183 -0
  360. package/dist/node_modules/@tanstack/table-core/dist/features/row-aggregation/rowAggregationFeature.utils.d.ts +18 -0
  361. package/dist/node_modules/@tanstack/table-core/dist/features/row-expanding/rowExpandingFeature.d.ts +6 -0
  362. package/dist/node_modules/@tanstack/table-core/dist/features/row-expanding/rowExpandingFeature.types.d.ts +125 -0
  363. package/dist/node_modules/@tanstack/table-core/dist/features/row-pagination/rowPaginationFeature.d.ts +6 -0
  364. package/dist/node_modules/@tanstack/table-core/dist/features/row-pagination/rowPaginationFeature.types.d.ts +135 -0
  365. package/dist/node_modules/@tanstack/table-core/dist/features/row-pinning/rowPinningFeature.d.ts +6 -0
  366. package/dist/node_modules/@tanstack/table-core/dist/features/row-pinning/rowPinningFeature.types.d.ts +76 -0
  367. package/dist/node_modules/@tanstack/table-core/dist/features/row-selection/rowSelectionFeature.d.ts +6 -0
  368. package/dist/node_modules/@tanstack/table-core/dist/features/row-selection/rowSelectionFeature.types.d.ts +187 -0
  369. package/dist/node_modules/@tanstack/table-core/dist/features/row-sorting/rowSortingFeature.d.ts +6 -0
  370. package/dist/node_modules/@tanstack/table-core/dist/features/row-sorting/rowSortingFeature.types.d.ts +236 -0
  371. package/dist/node_modules/@tanstack/table-core/dist/features/row-sorting/sortFns.d.ts +23 -0
  372. package/dist/node_modules/@tanstack/table-core/dist/features/stockFeatures.d.ts +37 -0
  373. package/dist/node_modules/@tanstack/table-core/dist/helpers/columnHelper.d.ts +47 -0
  374. package/dist/node_modules/@tanstack/table-core/dist/types/Cell.d.ts +16 -0
  375. package/dist/node_modules/@tanstack/table-core/dist/types/Column.d.ts +30 -0
  376. package/dist/node_modules/@tanstack/table-core/dist/types/ColumnDef.d.ts +123 -0
  377. package/dist/node_modules/@tanstack/table-core/dist/types/Header.d.ts +12 -0
  378. package/dist/node_modules/@tanstack/table-core/dist/types/HeaderGroup.d.ts +6 -0
  379. package/dist/node_modules/@tanstack/table-core/dist/types/Row.d.ts +24 -0
  380. package/dist/node_modules/@tanstack/table-core/dist/types/RowModel.d.ts +19 -0
  381. package/dist/node_modules/@tanstack/table-core/dist/types/RowModelFns.d.ts +11 -0
  382. package/dist/node_modules/@tanstack/table-core/dist/types/Table.d.ts +53 -0
  383. package/dist/node_modules/@tanstack/table-core/dist/types/TableFeatures.d.ts +416 -0
  384. package/dist/node_modules/@tanstack/table-core/dist/types/TableOptions.d.ts +78 -0
  385. package/dist/node_modules/@tanstack/table-core/dist/types/TableState.d.ts +46 -0
  386. package/dist/node_modules/@tanstack/table-core/dist/types/type-utils.d.ts +25 -0
  387. package/dist/shared.css +179 -0
  388. package/dist/styles.css +5467 -0
  389. package/dist/theme.css +314 -0
  390. package/dist/theme.map.json +278 -0
  391. package/dist/tokens/index.d.ts +2 -0
  392. package/dist/tokens/index.js +1 -0
  393. package/dist/tokens/tokens.generated.d.ts +2040 -0
  394. package/dist/tokens/tokens.generated.js +2053 -0
  395. package/dist/tokens.css +484 -0
  396. package/dist/tokens.flat.json +429 -0
  397. package/docs/Consuming.mdx +379 -0
  398. package/docs/Contributing.mdx +78 -0
  399. package/docs/ForAgents.mdx +53 -0
  400. package/docs/Introduction.mdx +54 -0
  401. package/llms.txt +556 -0
  402. package/package.json +351 -3
  403. package/src/components/action-row/ActionRow.mdx +686 -0
  404. package/src/components/action-row/ActionRow.stories.tsx +669 -0
  405. package/src/components/action-row/ActionRow.tsx +632 -0
  406. package/src/components/action-row/index.ts +9 -0
  407. package/src/components/alert/Alert.mdx +377 -0
  408. package/src/components/alert/Alert.stories.tsx +674 -0
  409. package/src/components/alert/Alert.tsx +579 -0
  410. package/src/components/alert/index.ts +13 -0
  411. package/src/components/anchored-panel/AnchoredPanel.mdx +381 -0
  412. package/src/components/anchored-panel/AnchoredPanel.stories.tsx +593 -0
  413. package/src/components/anchored-panel/AnchoredPanel.tsx +176 -0
  414. package/src/components/anchored-panel/index.ts +15 -0
  415. package/src/components/badge/Badge.mdx +487 -0
  416. package/src/components/badge/Badge.stories.tsx +375 -0
  417. package/src/components/badge/Badge.tsx +360 -0
  418. package/src/components/badge/index.ts +10 -0
  419. package/src/components/banner/Banner.mdx +704 -0
  420. package/src/components/banner/Banner.stories.tsx +448 -0
  421. package/src/components/banner/Banner.tsx +602 -0
  422. package/src/components/banner/index.ts +14 -0
  423. package/src/components/button/Button.mdx +286 -0
  424. package/src/components/button/Button.stories.tsx +381 -0
  425. package/src/components/button/Button.tsx +384 -0
  426. package/src/components/button/index.ts +1 -0
  427. package/src/components/button-group/ButtonGroup.mdx +512 -0
  428. package/src/components/button-group/ButtonGroup.stories.tsx +714 -0
  429. package/src/components/button-group/ButtonGroup.tsx +491 -0
  430. package/src/components/button-group/index.ts +10 -0
  431. package/src/components/card-select/CardSelect.mdx +662 -0
  432. package/src/components/card-select/CardSelect.stories.tsx +784 -0
  433. package/src/components/card-select/CardSelect.tsx +783 -0
  434. package/src/components/card-select/CardSelectGroup.tsx +169 -0
  435. package/src/components/card-select/index.ts +18 -0
  436. package/src/components/checkbox/Checkbox.mdx +269 -0
  437. package/src/components/checkbox/Checkbox.stories.tsx +306 -0
  438. package/src/components/checkbox/Checkbox.tsx +343 -0
  439. package/src/components/checkbox/index.ts +1 -0
  440. package/src/components/chip/Chip.mdx +683 -0
  441. package/src/components/chip/Chip.stories.tsx +734 -0
  442. package/src/components/chip/Chip.tsx +732 -0
  443. package/src/components/chip/index.ts +9 -0
  444. package/src/components/column-header/ColumnHeader.mdx +301 -0
  445. package/src/components/column-header/ColumnHeader.stories.tsx +319 -0
  446. package/src/components/column-header/ColumnHeader.tsx +287 -0
  447. package/src/components/column-header/index.ts +7 -0
  448. package/src/components/combobox-field/Combobox.tsx +693 -0
  449. package/src/components/combobox-field/ComboboxField.mdx +525 -0
  450. package/src/components/combobox-field/ComboboxField.stories.tsx +502 -0
  451. package/src/components/combobox-field/ComboboxField.tsx +259 -0
  452. package/src/components/combobox-field/index.ts +12 -0
  453. package/src/components/date-field/DateField.mdx +340 -0
  454. package/src/components/date-field/DateField.stories.tsx +221 -0
  455. package/src/components/date-field/DateField.tsx +176 -0
  456. package/src/components/date-field/index.ts +1 -0
  457. package/src/components/date-picker/DatePicker.mdx +436 -0
  458. package/src/components/date-picker/DatePicker.stories.tsx +458 -0
  459. package/src/components/date-picker/DatePicker.tsx +688 -0
  460. package/src/components/date-picker/index.ts +9 -0
  461. package/src/components/divider/Divider.mdx +256 -0
  462. package/src/components/divider/Divider.stories.tsx +177 -0
  463. package/src/components/divider/Divider.tsx +193 -0
  464. package/src/components/divider/index.ts +1 -0
  465. package/src/components/drawer/Drawer.mdx +518 -0
  466. package/src/components/drawer/Drawer.stories.tsx +392 -0
  467. package/src/components/drawer/Drawer.tsx +683 -0
  468. package/src/components/drawer/index.ts +1 -0
  469. package/src/components/dropdown-button/DropdownButton.mdx +285 -0
  470. package/src/components/dropdown-button/DropdownButton.stories.tsx +398 -0
  471. package/src/components/dropdown-button/DropdownButton.tsx +198 -0
  472. package/src/components/dropdown-button/index.ts +7 -0
  473. package/src/components/faq/FAQ.mdx +364 -0
  474. package/src/components/faq/FAQ.stories.tsx +343 -0
  475. package/src/components/faq/FAQ.tsx +337 -0
  476. package/src/components/faq/index.ts +1 -0
  477. package/src/components/field/Field.mdx +129 -0
  478. package/src/components/field/Field.stories.tsx +461 -0
  479. package/src/components/field/Field.tsx +765 -0
  480. package/src/components/field/index.ts +20 -0
  481. package/src/components/field-pair/FieldPair.mdx +308 -0
  482. package/src/components/field-pair/FieldPair.stories.tsx +530 -0
  483. package/src/components/field-pair/FieldPair.tsx +796 -0
  484. package/src/components/field-pair/index.ts +9 -0
  485. package/src/components/file-upload/FileUpload.mdx +345 -0
  486. package/src/components/file-upload/FileUpload.stories.tsx +698 -0
  487. package/src/components/file-upload/FileUpload.tsx +802 -0
  488. package/src/components/file-upload/index.ts +6 -0
  489. package/src/components/filter-chip/FilterChip.mdx +778 -0
  490. package/src/components/filter-chip/FilterChip.stories.tsx +827 -0
  491. package/src/components/filter-chip/FilterChip.tsx +881 -0
  492. package/src/components/filter-chip/index.ts +11 -0
  493. package/src/components/filter-facet/FilterFacet.mdx +536 -0
  494. package/src/components/filter-facet/FilterFacet.stories.tsx +506 -0
  495. package/src/components/filter-facet/FilterFacet.tsx +1160 -0
  496. package/src/components/filter-facet/index.ts +7 -0
  497. package/src/components/firm-avatar/FirmAvatar.mdx +280 -0
  498. package/src/components/firm-avatar/FirmAvatar.stories.tsx +147 -0
  499. package/src/components/firm-avatar/FirmAvatar.tsx +172 -0
  500. package/src/components/firm-avatar/index.ts +7 -0
  501. package/src/components/form-actions/FormActions.mdx +518 -0
  502. package/src/components/form-actions/FormActions.stories.tsx +621 -0
  503. package/src/components/form-actions/FormActions.tsx +273 -0
  504. package/src/components/form-actions/index.ts +6 -0
  505. package/src/components/form-block/FormBlock.mdx +728 -0
  506. package/src/components/form-block/FormBlock.stories.tsx +813 -0
  507. package/src/components/form-block/FormBlock.tsx +679 -0
  508. package/src/components/form-block/index.ts +13 -0
  509. package/src/components/form-section/FormSection.mdx +436 -0
  510. package/src/components/form-section/FormSection.stories.tsx +407 -0
  511. package/src/components/form-section/FormSection.tsx +290 -0
  512. package/src/components/form-section/index.ts +17 -0
  513. package/src/components/heading/Heading.mdx +206 -0
  514. package/src/components/heading/Heading.stories.tsx +169 -0
  515. package/src/components/heading/Heading.tsx +124 -0
  516. package/src/components/heading/index.ts +8 -0
  517. package/src/components/heading-group/HeadingGroup.mdx +521 -0
  518. package/src/components/heading-group/HeadingGroup.stories.tsx +353 -0
  519. package/src/components/heading-group/HeadingGroup.tsx +396 -0
  520. package/src/components/heading-group/index.ts +7 -0
  521. package/src/components/hero/Hero.mdx +742 -0
  522. package/src/components/hero/Hero.stories.tsx +527 -0
  523. package/src/components/hero/Hero.tsx +807 -0
  524. package/src/components/hero/index.ts +1 -0
  525. package/src/components/icon/Icon.mdx +329 -0
  526. package/src/components/icon/Icon.stories.tsx +398 -0
  527. package/src/components/icon/Icon.tsx +97 -0
  528. package/src/components/icon/index.ts +2 -0
  529. package/src/components/icon-button/IconButton.mdx +206 -0
  530. package/src/components/icon-button/IconButton.stories.tsx +341 -0
  531. package/src/components/icon-button/IconButton.tsx +273 -0
  532. package/src/components/icon-button/index.ts +1 -0
  533. package/src/components/item-row/ItemRow.mdx +533 -0
  534. package/src/components/item-row/ItemRow.stories.tsx +434 -0
  535. package/src/components/item-row/ItemRow.tsx +676 -0
  536. package/src/components/item-row/index.ts +9 -0
  537. package/src/components/list-row/ListRow.mdx +404 -0
  538. package/src/components/list-row/ListRow.stories.tsx +404 -0
  539. package/src/components/list-row/ListRow.tsx +424 -0
  540. package/src/components/list-row/index.ts +1 -0
  541. package/src/components/menu/Menu.mdx +268 -0
  542. package/src/components/menu/Menu.stories.tsx +455 -0
  543. package/src/components/menu/Menu.tsx +452 -0
  544. package/src/components/menu/index.ts +1 -0
  545. package/src/components/modal/Modal.mdx +854 -0
  546. package/src/components/modal/Modal.stories.tsx +881 -0
  547. package/src/components/modal/Modal.tsx +1434 -0
  548. package/src/components/modal/index.ts +1 -0
  549. package/src/components/nav-link/NavLink.mdx +196 -0
  550. package/src/components/nav-link/NavLink.stories.tsx +243 -0
  551. package/src/components/nav-link/NavLink.tsx +222 -0
  552. package/src/components/nav-link/index.ts +1 -0
  553. package/src/components/number-field/NumberField.mdx +223 -0
  554. package/src/components/number-field/NumberField.stories.tsx +291 -0
  555. package/src/components/number-field/NumberField.tsx +388 -0
  556. package/src/components/number-field/index.ts +6 -0
  557. package/src/components/pagination/Pagination.mdx +305 -0
  558. package/src/components/pagination/Pagination.stories.tsx +333 -0
  559. package/src/components/pagination/Pagination.tsx +343 -0
  560. package/src/components/pagination/index.ts +8 -0
  561. package/src/components/popover-surface/PopoverSurface.mdx +158 -0
  562. package/src/components/popover-surface/PopoverSurface.stories.tsx +421 -0
  563. package/src/components/popover-surface/index.ts +1 -0
  564. package/src/components/progress-bar/ProgressBar.mdx +802 -0
  565. package/src/components/progress-bar/ProgressBar.stories.tsx +533 -0
  566. package/src/components/progress-bar/ProgressBar.tsx +654 -0
  567. package/src/components/progress-bar/index.ts +9 -0
  568. package/src/components/promo-sticker/PromoSticker.mdx +436 -0
  569. package/src/components/promo-sticker/PromoSticker.stories.tsx +363 -0
  570. package/src/components/promo-sticker/PromoSticker.tsx +313 -0
  571. package/src/components/promo-sticker/index.ts +7 -0
  572. package/src/components/promo-surface/PromoSurface.mdx +399 -0
  573. package/src/components/promo-surface/PromoSurface.stories.tsx +270 -0
  574. package/src/components/promo-surface/PromoSurface.tsx +305 -0
  575. package/src/components/promo-surface/index.ts +7 -0
  576. package/src/components/radio/Radio.mdx +243 -0
  577. package/src/components/radio/Radio.stories.tsx +307 -0
  578. package/src/components/radio/Radio.tsx +288 -0
  579. package/src/components/radio/index.ts +1 -0
  580. package/src/components/radio-group/RadioGroup.mdx +119 -0
  581. package/src/components/radio-group/RadioGroup.stories.tsx +225 -0
  582. package/src/components/radio-group/RadioGroup.tsx +139 -0
  583. package/src/components/radio-group/index.ts +1 -0
  584. package/src/components/select/Select.mdx +241 -0
  585. package/src/components/select/Select.stories.tsx +404 -0
  586. package/src/components/select/Select.tsx +381 -0
  587. package/src/components/select/index.ts +1 -0
  588. package/src/components/select-field/SelectField.mdx +324 -0
  589. package/src/components/select-field/SelectField.stories.tsx +460 -0
  590. package/src/components/select-field/SelectField.tsx +138 -0
  591. package/src/components/select-field/index.ts +1 -0
  592. package/src/components/skeleton/Skeleton.mdx +194 -0
  593. package/src/components/skeleton/Skeleton.stories.tsx +260 -0
  594. package/src/components/skeleton/Skeleton.tsx +107 -0
  595. package/src/components/skeleton/index.ts +1 -0
  596. package/src/components/split-button/SplitButton.mdx +445 -0
  597. package/src/components/split-button/SplitButton.stories.tsx +465 -0
  598. package/src/components/split-button/SplitButton.tsx +361 -0
  599. package/src/components/split-button/index.ts +7 -0
  600. package/src/components/status-summary-bar/StatusSummaryBar.mdx +338 -0
  601. package/src/components/status-summary-bar/StatusSummaryBar.stories.tsx +408 -0
  602. package/src/components/status-summary-bar/StatusSummaryBar.tsx +428 -0
  603. package/src/components/status-summary-bar/index.ts +8 -0
  604. package/src/components/subject-lookup-field/SubjectLookupField.mdx +378 -0
  605. package/src/components/subject-lookup-field/SubjectLookupField.stories.tsx +393 -0
  606. package/src/components/subject-lookup-field/SubjectLookupField.tsx +1079 -0
  607. package/src/components/subject-lookup-field/index.ts +11 -0
  608. package/src/components/switch/Switch.mdx +376 -0
  609. package/src/components/switch/Switch.stories.tsx +296 -0
  610. package/src/components/switch/Switch.tsx +483 -0
  611. package/src/components/switch/index.ts +1 -0
  612. package/src/components/table/Table.mdx +575 -0
  613. package/src/components/table/Table.stories.tsx +1049 -0
  614. package/src/components/table/Table.tsx +745 -0
  615. package/src/components/table/TableConsumers.stories.tsx +195 -0
  616. package/src/components/table/_tableFixtures.ts +1189 -0
  617. package/src/components/table/index.ts +22 -0
  618. package/src/components/text-field/TextField.mdx +479 -0
  619. package/src/components/text-field/TextField.stories.tsx +366 -0
  620. package/src/components/text-field/TextField.tsx +391 -0
  621. package/src/components/text-field/index.ts +8 -0
  622. package/src/components/text-link/TextLink.mdx +353 -0
  623. package/src/components/text-link/TextLink.stories.tsx +458 -0
  624. package/src/components/text-link/TextLink.tsx +504 -0
  625. package/src/components/text-link/index.ts +10 -0
  626. package/src/components/textarea/Textarea.mdx +244 -0
  627. package/src/components/textarea/Textarea.stories.tsx +371 -0
  628. package/src/components/textarea/Textarea.tsx +489 -0
  629. package/src/components/textarea/index.ts +9 -0
  630. package/src/components/tooltip/Tooltip.mdx +462 -0
  631. package/src/components/tooltip/Tooltip.stories.tsx +500 -0
  632. package/src/components/tooltip/Tooltip.tsx +756 -0
  633. package/src/components/tooltip/index.ts +13 -0
  634. package/src/components/unit-field/UnitField.mdx +215 -0
  635. package/src/components/unit-field/UnitField.stories.tsx +291 -0
  636. package/src/components/unit-field/UnitField.tsx +255 -0
  637. package/src/components/unit-field/index.ts +7 -0
  638. package/src/icons/icon-registry.generated.ts +510 -0
  639. package/src/icons/icon-types.generated.ts +256 -0
  640. package/src/index.ts +71 -0
  641. package/src/internal/BottomSheet.tsx +714 -0
  642. package/src/internal/FodsProvider.tsx +36 -0
  643. package/src/internal/MotionCaret.tsx +53 -0
  644. package/src/internal/NumberFormatInput.tsx +276 -0
  645. package/src/internal/SummaryDonut.tsx +359 -0
  646. package/src/internal/buttonSegment.ts +241 -0
  647. package/src/internal/collapseRoom.ts +130 -0
  648. package/src/internal/comboboxKeys.ts +90 -0
  649. package/src/internal/contentPresence.ts +46 -0
  650. package/src/internal/dayCell.ts +274 -0
  651. package/src/internal/dialogPortal.ts +50 -0
  652. package/src/internal/donutSweeps.ts +77 -0
  653. package/src/internal/enterOnViewGeometry.ts +53 -0
  654. package/src/internal/faqItem.ts +104 -0
  655. package/src/internal/floatingLabelMotion.tsx +109 -0
  656. package/src/internal/formBlockContext.ts +27 -0
  657. package/src/internal/heightRoom.ts +135 -0
  658. package/src/internal/numberSeparators.ts +93 -0
  659. package/src/internal/overlayMotion.tsx +32 -0
  660. package/src/internal/paginationItem.ts +106 -0
  661. package/src/internal/popoverSurface.ts +78 -0
  662. package/src/internal/portalContainer.ts +11 -0
  663. package/src/internal/progressBarItem.ts +356 -0
  664. package/src/internal/selectionControlText.ts +42 -0
  665. package/src/internal/statusSummaryParts.tsx +475 -0
  666. package/src/internal/summaryMotion.ts +111 -0
  667. package/src/internal/table/ChildConnector.tsx +57 -0
  668. package/src/internal/table/ChildRowPrefix.tsx +21 -0
  669. package/src/internal/table/ColumnSettings.tsx +194 -0
  670. package/src/internal/table/ScrollRegion.tsx +176 -0
  671. package/src/internal/table/TableEmpty.tsx +99 -0
  672. package/src/internal/table/TableLayout.tsx +29 -0
  673. package/src/internal/table/TableLoadStatus.tsx +60 -0
  674. package/src/internal/table/TableMobile.tsx +582 -0
  675. package/src/internal/table/TruncatedCell.tsx +35 -0
  676. package/src/internal/table/emptyValue.ts +11 -0
  677. package/src/internal/table/features.ts +44 -0
  678. package/src/internal/table/recipes.ts +263 -0
  679. package/src/internal/table/rowClick.ts +8 -0
  680. package/src/internal/table/types.ts +342 -0
  681. package/src/internal/tailwind-variants.ts +65 -0
  682. package/src/internal/tooltipContext.ts +15 -0
  683. package/src/internal/tw-merge-config.generated.ts +275 -0
  684. package/src/internal/useAnchoredPanel.ts +340 -0
  685. package/src/internal/useCountUp.ts +65 -0
  686. package/src/internal/useDateFieldTrigger.tsx +357 -0
  687. package/src/internal/useEChart.ts +88 -0
  688. package/src/internal/useEnterOnView.ts +80 -0
  689. package/src/internal/useFloatingBar.ts +125 -0
  690. package/src/internal/useFormReset.ts +47 -0
  691. package/src/internal/useIsMobile.ts +64 -0
  692. package/src/internal/useNoImplicitSubmit.ts +41 -0
  693. package/src/internal/useOneRowOverflow.ts +103 -0
  694. package/src/internal/usePrefersReducedMotion.ts +27 -0
  695. package/src/internal/useReturnFocus.ts +34 -0
  696. package/src/internal/utils.ts +58 -0
  697. package/src/recipes/EmptyState.stories.tsx +105 -0
  698. package/src/recipes/Form.stories.tsx +355 -0
  699. package/src/recipes/ModalWithForm.stories.tsx +219 -0
  700. package/src/recipes/Recipes.mdx +61 -0
  701. package/src/recipes/TableWithFilters.stories.tsx +278 -0
  702. package/src/storybook/FodsFamily.tsx +39 -0
  703. package/src/storybook/Section.tsx +36 -0
  704. package/src/storybook/a11y.ts +24 -0
  705. package/src/storybook/assets/banner-character-bartender.webp +0 -0
  706. package/src/storybook/assets/banner-invoice-sheet-left.webp +0 -0
  707. package/src/storybook/assets/banner-invoice-sheet-right.webp +0 -0
  708. package/src/storybook/assets/invoice-hero.webp +0 -0
  709. package/src/storybook/assets/invoice.webp +0 -0
  710. package/src/storybook/assets/section-document-info.svg +21 -0
  711. package/src/storybook/assets/section-gear-checklist.svg +11 -0
  712. package/src/storybook/assets/section-person-arrow-in.svg +15 -0
  713. package/src/storybook/assets/section-person-arrow-out.svg +22 -0
  714. package/src/storybook/assets/section-receipt-dollar.svg +23 -0
  715. package/src/storybook/assets/table-empty-folder-empty.png +0 -0
  716. package/src/storybook/assets/table-empty-folder-magnifying-glass.png +0 -0
  717. package/src/storybook/assets/table-empty-funnel.png +0 -0
  718. package/src/storybook/assets/table-empty-load-failed.png +0 -0
  719. package/src/storybook/assets/wallet-spot.png +0 -0
  720. package/src/storybook/assets.d.ts +17 -0
  721. package/src/storybook/componentDoc.ts +41 -0
  722. package/src/storybook/fitFrame.tsx +70 -0
  723. package/src/storybook/forceStates.tsx +647 -0
  724. package/src/storybook/illustrations.tsx +66 -0
  725. package/src/storybook/viewportFrame.tsx +58 -0
  726. package/src/styles/assets/label-brush-1.svg +6 -0
  727. package/src/styles/assets/pattern-dark.svg +113 -0
  728. package/src/styles/base.css +106 -0
  729. package/src/styles/index.css +15 -0
  730. package/src/styles/motion.css +157 -0
  731. package/src/styles/promo-sticker.css +27 -0
  732. package/src/styles/promo-surface.css +49 -0
  733. package/src/styles/shared.css +11 -0
  734. package/src/styles/theme.generated.css +314 -0
  735. package/src/styles/theme.map.json +278 -0
  736. package/src/styles/tracking.generated.css +12 -0
  737. package/src/tokens/index.ts +4 -0
  738. package/src/tokens/tokens.generated.ts +542 -0
@@ -0,0 +1,765 @@
1
+ "use client";
2
+ import * as React from 'react';
3
+ import { tv } from '../../internal/tailwind-variants';
4
+ import type { IconName } from '../icon/Icon';
5
+ import { FloatingLabelGhost, useFloatingLabelMotion } from '../../internal/floatingLabelMotion';
6
+ import { cn } from '../../internal/utils';
7
+
8
+ // =============================================================================
9
+ // Styles for Structural Components
10
+ // =============================================================================
11
+
12
+ // Field group styles - spacing between multiple fields
13
+ const fieldGroupVariants = tv({
14
+ base: 'space-y-400',
15
+ });
16
+
17
+ // FieldSet styles - semantic grouping
18
+ const fieldSetVariants = tv({
19
+ base: 'space-y-400 border-0 p-0 m-0',
20
+ });
21
+
22
+ // FieldLegend styles - section headings
23
+ const fieldLegendVariants = tv({
24
+ base: 'text-heading-h5 font-inter font-bold text-text-primary mb-200',
25
+ });
26
+
27
+ // FieldSeparator styles - visual divider
28
+ const fieldSeparatorVariants = tv({
29
+ base: 'h-[1px] bg-outline-strong my-400',
30
+ });
31
+
32
+ // =============================================================================
33
+ // Styles for FloatingField
34
+ // =============================================================================
35
+
36
+ // Floating label styles
37
+ const floatingLabelVariants = tv({
38
+ base: [
39
+ 'absolute pointer-events-none z-4',
40
+ 'text-text-secondary font-inter font-normal',
41
+ // No transition: the label never travels or scales between its poses
42
+ // (text-field 2.14.0 motion.states.value). The pose change is a cross-fade
43
+ // played by the consumer — internal/floatingLabelMotion.tsx.
44
+ 'origin-left',
45
+ 'truncate',
46
+ 'bg-background-primary', // White background by default
47
+ ],
48
+ variants: {
49
+ floating: {
50
+ true: [
51
+ 'top-0 -translate-y-1/2',
52
+ 'left-300',
53
+ 'px-200',
54
+ // The notch is a --border-width-100 strip lying on the top border line,
55
+ // in the colour of the surface the FIELD sits on (text-field manifest
56
+ // parts.label note), never a full-height backplate and never the field's
57
+ // own fill. The label's centre sits on y=0 = the border's outer edge, so
58
+ // the strip spans 50% → 50% + border width. A container on a non-primary
59
+ // surface sets --field-notch-surface.
60
+ // Browser zoom (110–175 %) snaps the shell border to whole device px while
61
+ // the label's -translate-y-1/2 lands on a sub-pixel, so an exact strip
62
+ // drifts up to half a device px and a sliver of the (focus) border shows.
63
+ // Hence a 1px tolerance on both sides, each painting the colour already
64
+ // there: outwards in the surface colour, inwards in the field fill
65
+ // (--field-notch-inner, set only by Field's wrapper on editable fields).
66
+ // The visible notch stays exactly the border weight — not a backplate.
67
+ // --field-notch-weight follows the border (Error + focus → 200).
68
+ '[background:linear-gradient(to_bottom,transparent_calc(50%-1px),var(--field-notch-surface,var(--bg-primary))_calc(50%-1px),var(--field-notch-surface,var(--bg-primary))_calc(50%+var(--field-notch-weight,var(--border-width-100))),var(--field-notch-inner,transparent)_calc(50%+var(--field-notch-weight,var(--border-width-100))),var(--field-notch-inner,transparent)_calc(50%+var(--field-notch-weight,var(--border-width-100))+1px),transparent_calc(50%+var(--field-notch-weight,var(--border-width-100))+1px))]',
69
+ ],
70
+ false: [
71
+ 'left-500',
72
+ ],
73
+ },
74
+ size: {
75
+ md: '',
76
+ sm: '',
77
+ },
78
+ disabled: {
79
+ true: 'text-disabled-foreground',
80
+ },
81
+ hasOptionalLabel: {
82
+ true: '',
83
+ false: '',
84
+ },
85
+ // A leading glyph shifts the CONTENT, not the shell: `paddingX` stays
86
+ // --space-500 and the value starts at --space-500 + icon + gap. The label has
87
+ // to follow, or the resting label is painted on top of the glyph — and it has
88
+ // to follow in BOTH positions, because the floating label tracks the value's
89
+ // inline start so that floating stays a purely vertical move
90
+ // (text-field.md § Anatomy → Leading slot; inherited by _field-segment).
91
+ // The offsets live in the compounds below: the glyph is 24 at md and 20 at sm.
92
+ hasLeadingIcon: {
93
+ true: '',
94
+ false: '',
95
+ },
96
+ // Floating label mirrors the field status colour (Figma parity): red on error,
97
+ // green on success. Editable states only — Field forces `default` on
98
+ // readonly/disabled.
99
+ status: {
100
+ default: '',
101
+ error: 'text-status-danger',
102
+ // -solid is non-text-only (3.35:1); text needs the AA tint-foreground ink.
103
+ success: 'text-status-success-tint-foreground',
104
+ },
105
+ },
106
+ compoundVariants: [
107
+ // Floating chip is Body/XXS (12/18) regardless of field size (_labelContainer spec).
108
+ {
109
+ floating: true,
110
+ size: 'md',
111
+ class: 'text-body-xxs',
112
+ },
113
+ {
114
+ floating: true,
115
+ size: 'sm',
116
+ class: 'text-body-xxs',
117
+ },
118
+ {
119
+ floating: false,
120
+ size: 'md',
121
+ // Resting label centered in the medium field (value line-height 24 + padding).
122
+ class: 'top-800 -translate-y-1/2 text-body-base max-w-[calc(100%-24px)]',
123
+ },
124
+ {
125
+ floating: false,
126
+ size: 'sm',
127
+ class: 'top-700 -translate-y-1/2 text-body-sm max-w-[calc(100%-24px)]',
128
+ },
129
+ {
130
+ floating: true,
131
+ hasOptionalLabel: true,
132
+ class: 'max-w-[calc(100%-var(--optional-label-width,80px)-24px)]',
133
+ },
134
+ // Leading-glyph inline start. Resting sits where the VALUE sits
135
+ // (--space-500 + icon + gap); floating subtracts the chip's own --space-200
136
+ // padding so the text lands on the same x and the label never jumps sideways.
137
+ // The resting cap shrinks by the same amount it moved, or a long label would
138
+ // truncate past the shell's right padding instead of at it. `--space-500 * 2`
139
+ // is the shell's own left+right padding — the same 24 the base cap above spells
140
+ // as a literal, written in tokens here because this line is new.
141
+ {
142
+ hasLeadingIcon: true,
143
+ floating: false,
144
+ size: 'md',
145
+ class: [
146
+ 'left-[calc(var(--space-500)+var(--space-800)+var(--space-400))]',
147
+ 'max-w-[calc(100%-var(--space-500)*2-var(--space-800)-var(--space-400))]',
148
+ ],
149
+ },
150
+ {
151
+ hasLeadingIcon: true,
152
+ floating: false,
153
+ size: 'sm',
154
+ class: [
155
+ 'left-[calc(var(--space-500)+var(--space-700)+var(--space-400))]',
156
+ 'max-w-[calc(100%-var(--space-500)*2-var(--space-700)-var(--space-400))]',
157
+ ],
158
+ },
159
+ {
160
+ hasLeadingIcon: true,
161
+ floating: true,
162
+ size: 'md',
163
+ class: 'left-[calc(var(--space-500)+var(--space-800)+var(--space-400)-var(--space-200))]',
164
+ },
165
+ {
166
+ hasLeadingIcon: true,
167
+ floating: true,
168
+ size: 'sm',
169
+ class: 'left-[calc(var(--space-500)+var(--space-700)+var(--space-400)-var(--space-200))]',
170
+ },
171
+ ],
172
+ defaultVariants: {
173
+ floating: false,
174
+ size: 'md',
175
+ disabled: false,
176
+ hasOptionalLabel: false,
177
+ hasLeadingIcon: false,
178
+ status: 'default',
179
+ },
180
+ });
181
+
182
+ // Optional label styles
183
+ const optionalLabelVariants = tv({
184
+ base: [
185
+ 'absolute pointer-events-none z-4',
186
+ 'top-0 -translate-y-1/2 right-300',
187
+ 'px-200',
188
+ '[background:linear-gradient(to_bottom,transparent_calc(50%-1px),var(--field-notch-surface,var(--bg-primary))_calc(50%-1px),var(--field-notch-surface,var(--bg-primary))_calc(50%+var(--field-notch-weight,var(--border-width-100))),var(--field-notch-inner,transparent)_calc(50%+var(--field-notch-weight,var(--border-width-100))),var(--field-notch-inner,transparent)_calc(50%+var(--field-notch-weight,var(--border-width-100))+1px),transparent_calc(50%+var(--field-notch-weight,var(--border-width-100))+1px))]',
189
+ '[color:var(--text-secondary)] font-inter font-normal',
190
+ 'whitespace-nowrap',
191
+ ],
192
+ variants: {
193
+ // Optional tag is a reused _labelContainer chip — Body/XXS at every field size.
194
+ size: {
195
+ md: 'text-body-xxs',
196
+ sm: 'text-body-xxs',
197
+ },
198
+ },
199
+ defaultVariants: {
200
+ size: 'md',
201
+ },
202
+ });
203
+
204
+ // Helper text styles
205
+ // Gap field↔helper is sizes[].helperGap = --space-200 (4) — text-field 2.13.0,
206
+ // textarea / number-field / unit-field 1.11.0. File Upload still binds --space-400
207
+ // (8) and overrides it at its call site.
208
+ const helperTextVariants = tv({
209
+ // The helper line is Body/XS in every field, and every published Body style
210
+ // binds --text-wrap-body (text-styles.json $textWrapRule) — so it belongs in
211
+ // `base`, not in a variant. Written as an arbitrary property because Tailwind
212
+ // has no textWrap theme namespace: `text-pretty` would hard-code the value and
213
+ // stop tracking the token.
214
+ // No leading spelled out: `text-body-xs` carries Body/XS's own --leading-loose.
215
+ // If a font-size ever does need a hand-written leading, it has to sit AFTER the
216
+ // font-size class, in the state runs and never in `base`: tailwind-merge lists
217
+ // `leading` as a group `font-size` conflicts with, so a font-size composing later
218
+ // silently drops an earlier `leading-*`.
219
+ // `empty:mt-0`: Field / FieldPair keep the line mounted (empty) as a live region,
220
+ // and an empty line must not add the gap.
221
+ base: 'px-500 mt-200 empty:mt-0 [text-wrap:var(--text-wrap-body)]',
222
+ variants: {
223
+ state: {
224
+ default: 'text-body-xs font-normal text-text-secondary',
225
+ // Plain wrapping helper-style text (no pill): same size/weight as the
226
+ // default helper, only the danger colour differs. One shared slot.
227
+ error: 'text-body-xs font-normal text-status-danger',
228
+ // Confirmation message carries the state ink; tint-foreground is the AA
229
+ // success text token (-solid and base fail 4.5:1 on white).
230
+ success: 'text-body-xs font-normal text-status-success-tint-foreground',
231
+ },
232
+ // Both empty on purpose. The helper line is `Body/XS` at every field size, so
233
+ // every `state` above already carries `text-body-xs` — and repeating it HERE
234
+ // would be worse than redundant: `size` is declared after `state`, so the
235
+ // repeat lands later in the class string and tailwind-merge drops the
236
+ // `leading-loose` in front of it (font-size conflicts with leading). That is
237
+ // the same silent 20px-instead-of-20.8px regression the comment above
238
+ // describes, re-introduced through the back door and only on `size="sm"`.
239
+ // Pinned by Field.test.tsx.
240
+ size: {
241
+ md: '',
242
+ sm: '',
243
+ },
244
+ },
245
+ defaultVariants: {
246
+ state: 'default',
247
+ size: 'md',
248
+ },
249
+ });
250
+
251
+ // =============================================================================
252
+ // Structural Components
253
+ // =============================================================================
254
+
255
+ export type FieldGroupProps = React.HTMLAttributes<HTMLDivElement>;
256
+
257
+ const FieldGroup = React.forwardRef<HTMLDivElement, FieldGroupProps>(
258
+ ({ className, ...props }, ref) => {
259
+ return (
260
+ <div
261
+ ref={ref}
262
+ className={cn(fieldGroupVariants({ className }))}
263
+ {...props}
264
+ />
265
+ );
266
+ },
267
+ );
268
+ FieldGroup.displayName = 'FieldGroup';
269
+
270
+ // =============================================================================
271
+ // FieldSet
272
+ // =============================================================================
273
+
274
+ export type FieldSetProps = React.FieldsetHTMLAttributes<HTMLFieldSetElement>;
275
+
276
+ const FieldSet = React.forwardRef<HTMLFieldSetElement, FieldSetProps>(
277
+ ({ className, ...props }, ref) => {
278
+ return (
279
+ <fieldset
280
+ ref={ref}
281
+ className={cn(fieldSetVariants({ className }))}
282
+ {...props}
283
+ />
284
+ );
285
+ },
286
+ );
287
+ FieldSet.displayName = 'FieldSet';
288
+
289
+ // =============================================================================
290
+ // FieldLegend
291
+ // =============================================================================
292
+
293
+ export type FieldLegendProps = React.HTMLAttributes<HTMLLegendElement>;
294
+
295
+ const FieldLegend = React.forwardRef<HTMLLegendElement, FieldLegendProps>(
296
+ ({ className, ...props }, ref) => {
297
+ return (
298
+ <legend
299
+ ref={ref}
300
+ data-fods-part="legend"
301
+ className={cn(fieldLegendVariants({ className }))}
302
+ {...props}
303
+ />
304
+ );
305
+ },
306
+ );
307
+ FieldLegend.displayName = 'FieldLegend';
308
+
309
+ // =============================================================================
310
+ // FieldSeparator
311
+ // =============================================================================
312
+
313
+ export type FieldSeparatorProps = React.HTMLAttributes<HTMLDivElement>;
314
+
315
+ const FieldSeparator = React.forwardRef<HTMLDivElement, FieldSeparatorProps>(
316
+ ({ className, ...props }, ref) => {
317
+ return (
318
+ <div
319
+ ref={ref}
320
+ role="separator"
321
+ data-fods-part="separator"
322
+ className={cn(fieldSeparatorVariants({ className }))}
323
+ {...props}
324
+ />
325
+ );
326
+ },
327
+ );
328
+ FieldSeparator.displayName = 'FieldSeparator';
329
+
330
+ // =============================================================================
331
+ // Field - Main form field component with floating label
332
+ // =============================================================================
333
+
334
+ /**
335
+ * Detects if an input component has decorative elements (prefix/suffix adornments).
336
+ * Inputs with adornments should have floating labels to avoid visual overlap.
337
+ * @param childProps - Props of the child component
338
+ * @returns true if component has prefix/suffix adornments
339
+ */
340
+ function hasInputAdornments(childProps: any): boolean {
341
+ return Boolean(
342
+ // Standard prefix/suffix props (generic — kept for custom adornment components)
343
+ childProps.prefix ||
344
+ childProps.suffix ||
345
+ // Boolean flags
346
+ childProps.hasPrefix ||
347
+ childProps.hasSuffix ||
348
+ // Component-specific: UnitField always renders a unit, so the label must float
349
+ childProps.unit ||
350
+ // Component-specific: an amount input that shows its currency (`showCurrency`)
351
+ (childProps.showCurrency === true),
352
+ );
353
+ }
354
+
355
+ interface FieldChildTraits {
356
+ /**
357
+ * The label never rests inside: the field always shows a value, a placeholder
358
+ * or a trigger glyph. DateField is deliberately absent — it is a Text Field
359
+ * sibling and follows the one floating-label rule (spec text-field.md §
360
+ * States), so an empty, unfocused, valid date field rests its label inside;
361
+ * with a format `placeholder` it floats through `hasPlaceholder` instead.
362
+ */
363
+ autoFloating?: boolean;
364
+ /**
365
+ * The field renders a leading glyph that the wrapper cannot see on the child
366
+ * element, because the field sets it on the control it renders internally.
367
+ * Without it the resting label is painted straight over the glyph.
368
+ */
369
+ leadingIcon?: 'always';
370
+ /**
371
+ * The states in which an EMPTY field draws "–" on its value line (text-field
372
+ * 2.9.0, textarea 1.8.0, select-field 1.6.0). The dash is a value, so the label
373
+ * floats above it; a field that draws no dash keeps its resting label.
374
+ */
375
+ emptyDash?: 'disabled' | 'disabled-or-readonly';
376
+ }
377
+
378
+ /**
379
+ * What the wrapper needs to know about a field it cannot read off the rendered
380
+ * element, keyed by `displayName` (the only identity a cloned child exposes).
381
+ * One entry per field so a new one is registered in a single place.
382
+ */
383
+ const FIELD_CHILD_TRAITS: Record<string, FieldChildTraits> = {
384
+ // DateField renders a TextField, so it inherits the dash.
385
+ DateField: { leadingIcon: 'always', emptyDash: 'disabled-or-readonly' },
386
+ NumberField: { autoFloating: true },
387
+ Select: { autoFloating: true },
388
+ SelectField: { autoFloating: true, emptyDash: 'disabled' },
389
+ TextField: { emptyDash: 'disabled-or-readonly' },
390
+ Textarea: { emptyDash: 'disabled' },
391
+ UnitField: { autoFloating: true },
392
+ };
393
+
394
+ export type FieldSize = 'md' | 'sm';
395
+
396
+ export interface FieldProps {
397
+ /** Floating label text */
398
+ label?: string;
399
+ /**
400
+ * Visually hide the floating label while KEEPING it in the DOM.
401
+ *
402
+ * This is the field family's `Show label` property, inverted: the manifests
403
+ * (text-field 2.9.0, textarea 1.8.0, unit-field 1.8.0, number-field 1.8.0) map it
404
+ * as `Show label = false` ⇔ `hideLabel = true`, and spell out that the `<label>`
405
+ * element stays and is hidden with `sr-only` rather than removed, "so the field's
406
+ * accessible name is preserved without a separate `aria-label`".
407
+ *
408
+ * Never drop the `label` prop to hide the chip: that removes the `<label>` from
409
+ * the DOM and takes the accessible name with it, which is exactly what the
410
+ * property forbids. Hiding is always visual-only.
411
+ */
412
+ hideLabel?: boolean;
413
+ /** Optional label text displayed at top right (e.g. "Optional", "Volitelný") */
414
+ optionalLabel?: string;
415
+ /** Helper text displayed below the field */
416
+ helperText?: string;
417
+ /** Error message - displays error state when provided */
418
+ error?: string;
419
+ /** Success message - displays success state when provided */
420
+ success?: string;
421
+ /** Field size variant */
422
+ size?: FieldSize;
423
+ /** Additional className for the wrapper */
424
+ className?: string;
425
+ /**
426
+ * Force label to always stay in floating position.
427
+ * Note: NumberField is automatically detected and doesn't need this prop.
428
+ * Only set explicitly if you have a custom component that needs always-floating label.
429
+ */
430
+ alwaysFloating?: boolean;
431
+ /** The form control element (Input, Textarea, etc.) */
432
+ children: React.ReactElement<FieldChildProps>;
433
+ }
434
+
435
+ interface FieldChildProps {
436
+ id?: string;
437
+ // `Date` covers DateField, whose value is the date itself rather than the
438
+ // formatted string the input displays.
439
+ value?: string | number | readonly string[] | Date;
440
+ defaultValue?: string | number | readonly string[];
441
+ placeholder?: string;
442
+ disabled?: boolean;
443
+ readOnly?: boolean;
444
+ // A leading glyph in the child moves the value's inline start, and the label
445
+ // has to move with it (text-field.md § Anatomy → Leading slot). Typed here
446
+ // because the slot belongs to the field while the label belongs to Field.
447
+ leadingIcon?: IconName;
448
+ // Input/Textarea handlers
449
+ onFocus?: (e: React.FocusEvent) => void;
450
+ onBlur?: (e: React.FocusEvent) => void;
451
+ // Select-specific handlers
452
+ onOpenChange?: (open: boolean) => void;
453
+ onValueChange?: (value: string) => void;
454
+ // Accessibility
455
+ 'aria-invalid'?: boolean;
456
+ 'aria-describedby'?: string;
457
+ // A child that portals a named ARIA container (Select's `role="listbox"` panel)
458
+ // cannot reach the visible `<label>` the way the trigger does — `htmlFor` names
459
+ // the control, not a container rendered elsewhere in the DOM. Field therefore
460
+ // hands the label's id down and the child points its panel at it.
461
+ 'aria-label'?: string;
462
+ 'aria-labelledby'?: string;
463
+ // Combobox: same hand-down, but onto the panel only — its input is named by `htmlFor`.
464
+ panelLabelledBy?: string;
465
+ // Select-specific props
466
+ state?: 'default' | 'error' | 'success' | 'focused' | 'disabled' | 'readonly';
467
+ }
468
+
469
+ const Field: React.FC<FieldProps> = ({
470
+ label,
471
+ hideLabel = false,
472
+ optionalLabel,
473
+ helperText,
474
+ error,
475
+ success,
476
+ size = 'md',
477
+ className,
478
+ alwaysFloating = false,
479
+ children,
480
+ }) => {
481
+ const [isFocused, setIsFocused] = React.useState(false);
482
+ const [hasValue, setHasValue] = React.useState(false);
483
+ const optionalLabelRef = React.useRef<HTMLSpanElement>(null);
484
+ const [optionalLabelWidth, setOptionalLabelWidth] = React.useState<number | null>(null);
485
+ // Own id for the visible `<label>`, so a child can point an `aria-labelledby` at
486
+ // it. Deliberately NOT derived from the child's `id`: the label needs a stable id
487
+ // even when the child was rendered without one.
488
+ const labelId = React.useId();
489
+
490
+ // Extract props from child element
491
+ const childProps = children.props;
492
+ const fieldId = childProps.id;
493
+ const fieldValue = childProps.value;
494
+ const fieldDefaultValue = childProps.defaultValue;
495
+ const fieldPlaceholder = childProps.placeholder;
496
+ // Disabled derives from the native prop or the child's `state` (mirrors the
497
+ // readonly detection below) — UnitField/NumberField signal disabled via `state`.
498
+ const disabled = childProps.disabled ?? childProps.state === 'disabled';
499
+
500
+ const childType = (children.type as any)?.displayName || (children.type as any)?.name || '';
501
+ const childTraits = FIELD_CHILD_TRAITS[childType] ?? {};
502
+
503
+ // Check if component has adornments (prefix/suffix) that would overlap with non-floating label
504
+ const hasAdornments = hasInputAdornments(childProps);
505
+
506
+ // A leading glyph moves the value's inline start and the label has to move
507
+ // with it. Read off the child where the prop is visible, off the traits map
508
+ // where the field sets it on a control it renders internally.
509
+ const hasLeadingIcon = Boolean(childProps.leadingIcon) || childTraits.leadingIcon === 'always';
510
+
511
+ const shouldAutoFloat = Boolean(childTraits.autoFloating) || hasAdornments;
512
+ const isSelect = childType === 'Select';
513
+
514
+ const isReadOnly = childProps.readOnly ?? childProps.state === 'readonly';
515
+
516
+ // Label colour follows the field status (red/green), from either the Field
517
+ // `error`/`success` message props or the child's own `state`.
518
+ const labelStatus: 'default' | 'error' | 'success' =
519
+ error || childProps.state === 'error'
520
+ ? 'error'
521
+ : success || childProps.state === 'success'
522
+ ? 'success'
523
+ : 'default';
524
+
525
+ // Check if input has placeholder
526
+ const hasPlaceholder = Boolean(fieldPlaceholder) && String(fieldPlaceholder).length > 0;
527
+
528
+ // Focus reaches Field two ways and BOTH have to float the label. At runtime it
529
+ // arrives through onFocus/onBlur (`isFocused`); declaratively it arrives as the
530
+ // child's own `state="focused"`, which is how a statically rendered Focused cell
531
+ // (Matrix / MDX / forceStates) is built. Reading only the runtime flag left
532
+ // every static Focused+Empty cell with its label resting inside — a state the
533
+ // manifest float rule does not have (text-field 2.2.0 / textarea 1.2.0,
534
+ // property "Has value": "the label floats when the field is FOCUSED or FILLED
535
+ // or in ERROR; it sits inside … only when CALM = empty AND unfocused AND
536
+ // valid"), so the story documented something Figma never shows.
537
+ const isFocusedField = isFocused || childProps.state === 'focused';
538
+
539
+ // Track value changes. Controlled `value` wins (an empty controlled `''` is not
540
+ // nullish, so it keeps the label resting). An uncontrolled input is read back from
541
+ // the DOM on every render: react-hook-form `register()` writes `setValue`/`reset`
542
+ // values straight into it with no event, so neither `defaultValue` nor the next
543
+ // blur would see them. `defaultValue` is the fallback when the input is not found.
544
+ // No deps on purpose; an unchanged `hasValue` makes setState bail out, so no loop.
545
+ // eslint-disable-next-line react-hooks/exhaustive-deps
546
+ React.useLayoutEffect(() => {
547
+ const element = fieldValue === undefined && fieldId ? document.getElementById(fieldId) : null;
548
+ if (element instanceof HTMLInputElement || element instanceof HTMLTextAreaElement) {
549
+ setHasValue(element.value.length > 0);
550
+ return;
551
+ }
552
+ const effectiveValue = fieldValue ?? fieldDefaultValue;
553
+ setHasValue(Boolean(effectiveValue) && String(effectiveValue).length > 0);
554
+ });
555
+
556
+ // Measure optional label width for dynamic max-width calculation
557
+ React.useEffect(() => {
558
+ if (optionalLabelRef.current && optionalLabel) {
559
+ setOptionalLabelWidth(optionalLabelRef.current.offsetWidth);
560
+ }
561
+ }, [optionalLabel]);
562
+
563
+ // Label should float when:
564
+ // - alwaysFloating prop is explicitly true
565
+ // - Child component is auto-detected as always-floating (NumberField, Select, DatePicker, etc.)
566
+ // - Input is focused (runtime focus OR a declared `state="focused"`)
567
+ // - Input has value
568
+ // - Input has placeholder (to avoid label/placeholder overlap)
569
+ // - Field is in error (keep the label up beside the reddened field even when
570
+ // empty — parity with the Figma Focused variant and FieldSegment).
571
+ // - Field is locked in a state where its child draws "–" for an empty value:
572
+ // the dash sits on the value line under the floated label (text-field 2.9.0
573
+ // float rule, field-readonly.md § En dash semantics). See `emptyDash`.
574
+ const showsEmptyDash =
575
+ (Boolean(childTraits.emptyDash) && disabled) ||
576
+ (childTraits.emptyDash === 'disabled-or-readonly' && isReadOnly);
577
+ const shouldFloat =
578
+ alwaysFloating ||
579
+ shouldAutoFloat ||
580
+ isFocusedField ||
581
+ hasValue ||
582
+ hasPlaceholder ||
583
+ labelStatus === 'error' ||
584
+ showsEmptyDash;
585
+
586
+ // Every recipe input except the pose, shared by the label and the ghost of the
587
+ // pose it just left (text-field 2.14.0 cross-fade).
588
+ const labelMotion = useFloatingLabelMotion(shouldFloat);
589
+ const labelRecipe = {
590
+ size,
591
+ disabled,
592
+ hasOptionalLabel: Boolean(optionalLabel),
593
+ hasLeadingIcon,
594
+ // A locked field carries no status ink on its label.
595
+ status: disabled || isReadOnly ? 'default' : labelStatus,
596
+ } as const;
597
+
598
+ const displayHelperText = error || success || helperText;
599
+ const helperState = error ? 'error' : success ? 'success' : 'default';
600
+
601
+ // Clone child to inject handlers and accessibility props
602
+ // Select uses different handlers than Input/Textarea
603
+ let enhancedChild: React.ReactElement;
604
+
605
+ if (isSelect) {
606
+ // For Select component: use onOpenChange instead of onFocus/onBlur
607
+ enhancedChild = React.cloneElement(children, {
608
+ onOpenChange: (open: boolean) => {
609
+ setIsFocused(open);
610
+ childProps.onOpenChange?.(open);
611
+ },
612
+ state: error ? 'error' : success ? 'success' : childProps.state,
613
+ // Spread, not `error ? true : undefined`: an explicit `undefined` in the
614
+ // clone still overwrites the value a child derives from its own
615
+ // `state="error"`, which would drop the attribute off an errored field.
616
+ ...(error ? { 'aria-invalid': true } : {}),
617
+ 'aria-describedby': displayHelperText && fieldId ? `${fieldId}-helper` : undefined,
618
+ // The visible label also names Select's portalled `role="listbox"` panel,
619
+ // which `htmlFor` cannot reach. Skipped when the consumer already named the
620
+ // Select itself — an explicit name is a deliberate override, and two names
621
+ // would be worse than one (`aria-labelledby` silently wins accname).
622
+ 'aria-labelledby':
623
+ childProps['aria-labelledby']
624
+ ?? (label && !childProps['aria-label'] ? labelId : undefined),
625
+ });
626
+ } else {
627
+ // For Input/Textarea: use onFocus/onBlur
628
+ enhancedChild = React.cloneElement(children, {
629
+ onFocus: (e: React.FocusEvent) => {
630
+ setIsFocused(true);
631
+ childProps.onFocus?.(e);
632
+ },
633
+ onBlur: (e: React.FocusEvent) => {
634
+ setIsFocused(false);
635
+ const target = e.target as HTMLInputElement | HTMLTextAreaElement;
636
+ setHasValue(Boolean(target.value));
637
+ childProps.onBlur?.(e);
638
+ },
639
+ state: error ? 'error' : success ? 'success' : childProps.state,
640
+ ...(error ? { 'aria-invalid': true } : {}),
641
+ 'aria-describedby': displayHelperText && fieldId ? `${fieldId}-helper` : undefined,
642
+ // Combobox's portalled listbox takes its name from this label too
643
+ // (overlay-behavior.md § Naming). Unlike Select, the input is already named
644
+ // through `htmlFor`, so the reference goes to the panel alone.
645
+ ...(childType === 'Combobox' && label
646
+ ? { panelLabelledBy: childProps.panelLabelledBy ?? labelId }
647
+ : {}),
648
+ });
649
+ }
650
+
651
+ // CSS custom property for dynamic optional label width
652
+ const labelStyle = optionalLabelWidth
653
+ ? { '--optional-label-width': `${optionalLabelWidth}px` } as React.CSSProperties
654
+ : undefined;
655
+
656
+ return (
657
+ <div className={cn('relative flex flex-col w-full', disabled && 'cursor-not-allowed', className)}>
658
+ {/* Input container for positioning label */}
659
+ {/* The notch variables the label and optional-tag gradients read. Editable
660
+ shells fill with --bg-primary, so the notch's inner 1px tolerance paints
661
+ it; locked shells keep it transparent. Error + focus thickens the shell
662
+ border to --border-width-200 (CSS focus-within), so the notch has to
663
+ widen with it or the inner red pixel shows under the label. CSS
664
+ `has-[:focus]` rather than React focus state: the latter misses a
665
+ focused-but-closed Select trigger. */}
666
+ <div
667
+ className={cn(
668
+ 'relative',
669
+ !disabled && !isReadOnly && '[--field-notch-inner:var(--bg-primary)]',
670
+ labelStatus === 'error' && !disabled && !isReadOnly
671
+ && 'has-[:focus]:[--field-notch-weight:var(--border-width-200)]',
672
+ )}
673
+ >
674
+ {/* The pose the label just left, fading out (aria-hidden, no text node). */}
675
+ {label && !hideLabel && labelMotion.swap?.ghost && (
676
+ <FloatingLabelGhost
677
+ key={labelMotion.swap.key}
678
+ text={label}
679
+ className={floatingLabelVariants({ floating: labelMotion.swap.from, ...labelRecipe })}
680
+ style={labelStyle}
681
+ onDone={labelMotion.endGhost}
682
+ />
683
+ )}
684
+
685
+ {/* Floating label */}
686
+ {label && (
687
+ <label
688
+ htmlFor={fieldId}
689
+ id={labelId}
690
+ // data-fods-part marks the parts the FODS verifier measures in the
691
+ // browser. Not inert in this package: `styles/base.css` scopes its reset to it. The wrapping
692
+ // component supplies data-fods-component, because this label is
693
+ // shared by six of them.
694
+ data-fods-part="label"
695
+ // `hideLabel` REPLACES the floating-chip classes rather than layering
696
+ // `sr-only` on top of them. Both spell out `position`, `overflow` and
697
+ // the box, so stacking them would leave the winner to the order of the
698
+ // generated stylesheet — and the inline `labelStyle` (the optional-label
699
+ // measure cap) would beat either one. Swapping the whole class string is
700
+ // the only deterministic way to hide it.
701
+ // After a pose change the label plays its enter fade in the new pose;
702
+ // nothing plays on mount.
703
+ className={hideLabel ? 'sr-only' : cn(
704
+ floatingLabelVariants({ floating: shouldFloat, ...labelRecipe }),
705
+ labelMotion.enterClass,
706
+ )}
707
+ style={hideLabel ? undefined : labelStyle}
708
+ onAnimationEnd={labelMotion.endEnter}
709
+ >
710
+ {label}
711
+ </label>
712
+ )}
713
+
714
+ {/* Optional label (always at top right) */}
715
+ {optionalLabel && (
716
+ <span
717
+ ref={optionalLabelRef}
718
+ data-fods-part="optional-tag"
719
+ className={optionalLabelVariants({ size })}
720
+ >
721
+ {optionalLabel}
722
+ </span>
723
+ )}
724
+
725
+ {/* Form control (Input, Textarea, etc.) */}
726
+ {enhancedChild}
727
+ </div>
728
+
729
+ {/* Helper/Error/Success text. Always mounted as a polite live region
730
+ (text-field 2.9.1 § Announcement): a region inserted together with its
731
+ text is not announced, so it must exist, empty, before a blur-validation
732
+ or async message lands in it. `empty:mt-0` in the recipe drops the gap
733
+ while it is empty. Never role="alert" — assertive interrupts typing in
734
+ the next field. aria-describedby above stays conditional on a message. */}
735
+ <div
736
+ id={fieldId ? `${fieldId}-helper` : undefined}
737
+ data-fods-part="helper"
738
+ aria-live="polite"
739
+ className={helperTextVariants({ state: helperState, size })}
740
+ >
741
+ {displayHelperText}
742
+ </div>
743
+ </div>
744
+ );
745
+ };
746
+
747
+ Field.displayName = 'Field';
748
+
749
+ export {
750
+ // Structural components for form layout
751
+ FieldGroup,
752
+ FieldSet,
753
+ FieldLegend,
754
+ FieldSeparator,
755
+ // Main field component
756
+ Field,
757
+ // Style variants (exported for potential custom usage)
758
+ fieldGroupVariants,
759
+ fieldSetVariants,
760
+ fieldLegendVariants,
761
+ fieldSeparatorVariants,
762
+ floatingLabelVariants,
763
+ optionalLabelVariants,
764
+ helperTextVariants,
765
+ };