@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,460 @@
1
+ import * as React from 'react';
2
+ import type { Meta, StoryObj } from '@storybook/react-vite';
3
+ import type { ReactNode } from 'react';
4
+ import type { SelectFieldProps } from './SelectField';
5
+ import { Field } from '../field/Field';
6
+ import { Select } from '../select/Select';
7
+ import { SelectField } from './SelectField';
8
+ import { ListRow } from '../list-row/ListRow';
9
+ import {
10
+ popoverSurfaceVariants,
11
+ popoverBodyClass,
12
+ popoverGroupClass,
13
+ } from '../../internal/popoverSurface';
14
+ import { Icon } from '../icon/Icon';
15
+ import { Section, Showcase } from '../../storybook/Section';
16
+ import { componentDoc } from '../../storybook/componentDoc';
17
+ import { a11yRulesOff } from '../../storybook/a11y';
18
+ import { FORCE_ERROR_FOCUS, FieldErrorFocusStyles } from '../../storybook/forceStates';
19
+
20
+ const SIZES = ['md', 'sm'] as const;
21
+ // Manifest `axes.state` — all five rows, in manifest order. `filled` is NOT a
22
+ // value of the `state` prop: a filled select is `state="default"` carrying a
23
+ // `value`, which is what swaps the trigger ink from `--text-placeholder` to
24
+ // `--text-primary`. The row is therefore described by props, see STATE_PROPS.
25
+ const STATES = ['default', 'focused', 'filled', 'error', 'disabled'] as const;
26
+ // The `state` prop union — the four values the component actually accepts.
27
+ const STATE_PROP_OPTIONS = ['default', 'focused', 'error', 'disabled'] as const;
28
+
29
+ const SELECTED = 'CZK — Česká koruna';
30
+ const PLACEHOLDER = 'Vyberte měnu';
31
+ // The bare-trigger exhibits have no `Field` <label>, and a `role="combobox"` button takes
32
+ // no name from its content (the value / placeholder), so each one is named directly.
33
+ const LABEL = 'Měna';
34
+
35
+ type MatrixState = (typeof STATES)[number];
36
+
37
+ const STATE_PROPS: Record<MatrixState, Pick<SelectFieldProps, 'state' | 'value' | 'placeholder' | 'open'>> = {
38
+ // Default / Focused (open) / Error all paint the trigger's text as
39
+ // --text-placeholder in the manifest, i.e. nothing is selected yet.
40
+ default: { state: 'default', placeholder: PLACEHOLDER },
41
+ focused: { state: 'focused', placeholder: PLACEHOLDER, open: true },
42
+ filled: { state: 'default', value: SELECTED },
43
+ error: { state: 'error', placeholder: PLACEHOLDER },
44
+ // Disabled carries a value so the --disabled-foreground value ink is visible.
45
+ disabled: { state: 'disabled', value: SELECTED },
46
+ };
47
+
48
+ // aria-required-attr, for the stories whose Focused row draws the BARE trigger with
49
+ // `open` (caret up, `aria-expanded="true"`). An expanded combobox needs `aria-controls`,
50
+ // but the listbox is not part of this trigger: the organism that owns the panel passes it
51
+ // (the Select organism; WithPanel here, which runs with the rule on). These exhibits
52
+ // render no panel it could point at.
53
+ const FROZEN_OPEN_TRIGGER_A11Y = a11yRulesOff('aria-required-attr');
54
+
55
+ const Frame = ({ children }: { children: ReactNode }) => (
56
+ <div className="w-[calc(var(--space-1200)*4)]">{children}</div>
57
+ );
58
+
59
+ const meta = {
60
+ title: 'Design System/Molecules/SelectField',
61
+ component: SelectField,
62
+ parameters: {
63
+ layout: 'centered',
64
+ containerWidth: 300,
65
+ docs: {
66
+ description: {
67
+ component: componentDoc({
68
+ summary:
69
+ 'Trigger for a single-select dropdown — a reuse of the Text Field shell plus a trailing caret. This is the closed trigger only (value/placeholder + caret); the options panel (listbox) is composed separately. For a floating label, helper or error messaging wrap it in `Field`.',
70
+ useCases: [
71
+ 'Pick one value from a fixed set — currency, country, VAT rate, payment method',
72
+ '`open` — panel is open: the caret rotates up and `aria-expanded` is set',
73
+ '`state="error"` — the caret is replaced by the intrinsic `warning-circle` status icon',
74
+ '`state="disabled"` — not applicable; keeps the `--outline-default` border, takes the `--disabled-background` fill and dims all ink',
75
+ ],
76
+ bestPractices: [
77
+ 'Wrap in `Field` for the floating label — the `<label>` is the accessible name, never the placeholder',
78
+ 'Use for a fixed, discoverable set of options — reach for a Text Field for free-form input, an autocomplete for long/searchable lists',
79
+ 'Pair `state="error"` with a matching `error` message on the `Field`',
80
+ 'SelectField is a read-only trigger — the value truncates, it never scrolls; keep option labels short',
81
+ ],
82
+ knownIssues: [
83
+ 'Error replaces the caret with the `warning-circle` status glyph',
84
+ 'Unlike TextField, SelectField has no `success` or `readonly` state (a select is either editable, focused/open, in error, or disabled)',
85
+ ],
86
+ docsLink: { label: 'spec/04-molecules/select-field.md' },
87
+ }),
88
+ },
89
+ },
90
+ },
91
+ } satisfies Meta<typeof SelectField>;
92
+
93
+ export default meta;
94
+ type Story = StoryObj<typeof SelectField>;
95
+
96
+ export const Playground: Story = {
97
+ args: {
98
+ placeholder: 'Vyberte…',
99
+ value: '',
100
+ size: 'md',
101
+ state: 'default',
102
+ open: false,
103
+ },
104
+ argTypes: {
105
+ size: { control: 'select', options: SIZES },
106
+ // Not STATES — `filled` is a manifest row, not a prop value. Clear `value`
107
+ // to see the placeholder tier, type one in to see the Filled tier.
108
+ state: { control: 'select', options: STATE_PROP_OPTIONS },
109
+ value: { control: 'text' },
110
+ placeholder: { control: 'text' },
111
+ open: { control: 'boolean' },
112
+ },
113
+ /*
114
+ * Wrapped in `Field`, which is how the component actually ships: the floating
115
+ * label is the real <label> and is what gives the control its accessible name
116
+ * (WCAG 4.1.2), and the helper line is what `aria-describedby` resolves to, so
117
+ * the Error state announces its message (WCAG 3.3.1). `Field` derives both from
118
+ * the child's `id`, so the Playground supplies one.
119
+ */
120
+ render: args => (
121
+ <Frame>
122
+ <Field
123
+ label="Měna"
124
+ error={args.state === 'error' ? 'Vyberte měnu' : undefined}
125
+ helperText={args.state === 'error' ? undefined : 'Použije se na celé faktuře'}
126
+ >
127
+ <SelectField id="playground-select-field" {...args} />
128
+ </Field>
129
+ </Frame>
130
+ ),
131
+ };
132
+
133
+ export const Matrix: Story = {
134
+ parameters: {
135
+ // aria-required-attr: see FROZEN_OPEN_TRIGGER_A11Y.
136
+ a11y: FROZEN_OPEN_TRIGGER_A11Y,
137
+ docs: {
138
+ description: {
139
+ story:
140
+ 'Full state × size matrix — mirrors the Figma labelled grid, all five manifest states. Rows = states, columns = sizes. **Default / Focused / Error** show the placeholder tier (`--text-placeholder`), because the manifest paints those three states with nothing selected; **Filled** is the same trigger carrying a value, so the ink steps up to `--text-primary`. Focused also carries the open affordance (`open` — caret up, `aria-expanded`), Error swaps the caret for the status icon, Disabled drops the border and dims all ink.',
141
+ },
142
+ },
143
+ },
144
+ render: () => (
145
+ <Showcase>
146
+ {STATES.map(state => (
147
+ <Section key={state} title={state} layout="row">
148
+ {SIZES.map(size => (
149
+ <div key={size} className="w-[calc(var(--space-1000)*6)]">
150
+ <SelectField size={size} aria-label={LABEL} {...STATE_PROPS[state]} />
151
+ </div>
152
+ ))}
153
+ </Section>
154
+ ))}
155
+ </Showcase>
156
+ ),
157
+ };
158
+
159
+ export const Sizes: Story = {
160
+ parameters: {
161
+ docs: { description: { story: 'Medium (48) — standard forms · Small (40) — dense rows, filter bars. Pick by density.' } },
162
+ },
163
+ render: () => (
164
+ <Showcase>
165
+ <Section title="Medium (default)" layout="column">
166
+ <Frame><SelectField size="md" aria-label={LABEL} value="CZK — Česká koruna" /></Frame>
167
+ <Frame><SelectField size="md" aria-label={LABEL} placeholder="Vyberte měnu" /></Frame>
168
+ </Section>
169
+ <Section title="Small" layout="column">
170
+ <Frame><SelectField size="sm" aria-label={LABEL} value="CZK — Česká koruna" /></Frame>
171
+ <Frame><SelectField size="sm" aria-label={LABEL} placeholder="Vyberte měnu" /></Frame>
172
+ </Section>
173
+ </Showcase>
174
+ ),
175
+ };
176
+
177
+ export const States: Story = {
178
+ parameters: {
179
+ // aria-required-attr: see FROZEN_OPEN_TRIGGER_A11Y.
180
+ a11y: FROZEN_OPEN_TRIGGER_A11Y,
181
+ docs: { description: { story: 'All five manifest states, one per row. Default rests with a placeholder; Focused shows the open panel; Filled carries a selected value (`state="default"` + a `value` — the only difference from Default is the `--text-primary` ink); Error swaps the caret for the status icon; Disabled is not applicable. Error + focus keeps the `--status-danger` border and thickens it to `--border-width-200` inside the shell; `--outline-focus` never shows on an invalid field (forced statically below — focus is runtime-only). Error + open is the same red `--border-width-200` border plus the panel, and the warning-circle stays.' } },
182
+ },
183
+ render: () => (
184
+ <Showcase>
185
+ <FieldErrorFocusStyles />
186
+ <Section title="Editable" layout="column">
187
+ {(['default', 'focused', 'filled', 'error'] as const).map(state => (
188
+ <Frame key={state}><SelectField aria-label={LABEL} {...STATE_PROPS[state]} /></Frame>
189
+ ))}
190
+ </Section>
191
+ <Section title="Error + focus" layout="column">
192
+ <Frame>
193
+ <div className={FORCE_ERROR_FOCUS}>
194
+ <SelectField aria-label={LABEL} {...STATE_PROPS.error} />
195
+ </div>
196
+ </Frame>
197
+ </Section>
198
+ <Section title="Non-editable" layout="column">
199
+ <Frame><SelectField aria-label={LABEL} {...STATE_PROPS.disabled} /></Frame>
200
+ </Section>
201
+ </Showcase>
202
+ ),
203
+ };
204
+
205
+ // -----------------------------------------------------------------------------
206
+ // Composed demo — SelectField is the trigger only; the option panel is composed
207
+ // separately (Popover surface + List Row `option` rows). This small interactive
208
+ // example wires the two together to show the full open dropdown.
209
+ // -----------------------------------------------------------------------------
210
+ const CURRENCIES = [
211
+ { value: 'CZK', label: 'CZK — Česká koruna' },
212
+ { value: 'EUR', label: 'EUR — Euro' },
213
+ { value: 'USD', label: 'USD — americký dolar' },
214
+ { value: 'GBP', label: 'GBP — britská libra' },
215
+ ];
216
+
217
+ const SelectFieldWithPanel = ({ size = 'md' }: { size?: 'md' | 'sm' }) => {
218
+ // Closed by default — a Select opens on interaction, it is never stuck open.
219
+ const [open, setOpen] = React.useState(false);
220
+ const [value, setValue] = React.useState('CZK');
221
+ const selected = CURRENCIES.find(c => c.value === value);
222
+ const rowSize = size === 'sm' ? 'sm' : 'md';
223
+ const listboxId = `currency-listbox-${size}`;
224
+ const optionId = (v: string) => `currency-option-${v}-${size}`;
225
+ const rootRef = React.useRef<HTMLDivElement>(null);
226
+ const triggerRef = React.useRef<HTMLButtonElement>(null);
227
+
228
+ // Dismissal (spec overlay-behavior.md § Dismissal): close on OUTSIDE pointer-down
229
+ // (anything outside the panel + trigger) and on Esc (returning focus to the trigger).
230
+ React.useEffect(() => {
231
+ if (!open) return undefined;
232
+ const onPointerDown = (e: PointerEvent) => {
233
+ if (!rootRef.current?.contains(e.target as Node)) setOpen(false);
234
+ };
235
+ const onKeyDown = (e: KeyboardEvent) => {
236
+ if (e.key === 'Escape') {
237
+ setOpen(false);
238
+ triggerRef.current?.focus();
239
+ }
240
+ };
241
+ document.addEventListener('pointerdown', onPointerDown);
242
+ document.addEventListener('keydown', onKeyDown);
243
+ return () => {
244
+ document.removeEventListener('pointerdown', onPointerDown);
245
+ document.removeEventListener('keydown', onKeyDown);
246
+ };
247
+ }, [open]);
248
+
249
+ return (
250
+ <div ref={rootRef} className="relative w-[calc(var(--space-1200)*4)]">
251
+ <Field label="Měna">
252
+ <SelectField
253
+ ref={triggerRef}
254
+ id={`currency-trigger-${size}`}
255
+ size={size}
256
+ value={selected?.label}
257
+ placeholder="Vyberte měnu"
258
+ open={open}
259
+ state={open ? 'focused' : 'default'}
260
+ aria-controls={listboxId}
261
+ // Focus stays on the trigger while open; the current option is pointed at
262
+ // by aria-activedescendant (spec overlay-behavior.md § Focus & highlight —
263
+ // on open the highlight lands on the selected option).
264
+ aria-activedescendant={open ? optionId(value) : undefined}
265
+ onClick={() => setOpen(o => !o)}
266
+ />
267
+ </Field>
268
+
269
+ {/* Popover surface — the shared FODS chrome recipe (`popoverSurfaceVariants`).
270
+ Anchored BELOW the trigger and absolutely positioned, so it floats over the
271
+ page instead of pushing it (spec § Positioning: anchored, page behind does
272
+ not scroll), with the --space-200 offset and z-dropdown (from the recipe).
273
+ Fades + slides in over --duration-fast. A production widget would
274
+ portal this and add collision flip/shift + an exit transition (Select organism). */}
275
+ <div
276
+ id={listboxId}
277
+ role="listbox"
278
+ aria-label="Měna"
279
+ aria-hidden={!open}
280
+ className={popoverSurfaceVariants({
281
+ size,
282
+ className: `absolute left-0 right-0 top-full mt-200 origin-top transition-[opacity,transform] duration-fast ease-enter ${
283
+ open ? 'opacity-100 translate-y-0' : 'pointer-events-none -translate-y-200 opacity-0'
284
+ }`,
285
+ })}
286
+ >
287
+ <div className={popoverBodyClass}>
288
+ <div className={popoverGroupClass}>
289
+ {CURRENCIES.map((c) => {
290
+ const isSelected = c.value === value;
291
+ return (
292
+ <ListRow
293
+ key={c.value}
294
+ id={optionId(c.value)}
295
+ role="option"
296
+ size={rowSize}
297
+ selected={isSelected}
298
+ // On open the highlight lands on the selected option — the same
299
+ // row aria-activedescendant points at (keyboard-current visual).
300
+ highlighted={isSelected && open}
301
+ aria-selected={isSelected}
302
+ leading={
303
+ <Icon
304
+ name="check"
305
+ size="small"
306
+ className={isSelected ? 'text-secondary' : 'invisible'}
307
+ />
308
+ }
309
+ onClick={() => {
310
+ setValue(c.value);
311
+ setOpen(false);
312
+ }}
313
+ >
314
+ {c.label}
315
+ </ListRow>
316
+ );
317
+ })}
318
+ </div>
319
+ </div>
320
+ </div>
321
+ </div>
322
+ );
323
+ };
324
+
325
+ export const WithPanel: Story = {
326
+ name: 'With panel (composed)',
327
+ parameters: {
328
+ docs: {
329
+ description: {
330
+ story:
331
+ 'The full open dropdown. SelectField is the **trigger only** — the option panel is composed separately from a Popover surface + `ListRow` `option` rows (single-select → a leading checkmark marks the chosen row; the trigger opens Medium rows for a Medium trigger, Small rows for Small). Click the trigger to toggle, an option to select. This wiring is illustrative; the shipped widget is the `Select` organism.',
332
+ },
333
+ },
334
+ },
335
+ render: () => (
336
+ // The panel floats (absolute), so it does not grow the story — each size reserves
337
+ // room for the trigger + the four open rows (4 × --space-1200 = 256px) so the docs
338
+ // Canvas does not clip the open panel.
339
+ <Showcase>
340
+ <Section title="Medium — Medium rows (40)" layout="column">
341
+ <div className="min-h-[calc(var(--space-1200)*4)]">
342
+ <SelectFieldWithPanel size="md" />
343
+ </div>
344
+ </Section>
345
+ <Section title="Small — Small rows (36)" layout="column">
346
+ <div className="min-h-[calc(var(--space-1200)*4)]">
347
+ <SelectFieldWithPanel size="sm" />
348
+ </div>
349
+ </Section>
350
+ </Showcase>
351
+ ),
352
+ };
353
+
354
+ const MotionToggle = ({ size }: { size: 'md' | 'sm' }) => {
355
+ const [open, setOpen] = React.useState(false);
356
+ return (
357
+ <SelectField
358
+ size={size}
359
+ value="CZK"
360
+ open={open}
361
+ aria-label="Měna"
362
+ onClick={() => setOpen(current => !current)}
363
+ />
364
+ );
365
+ };
366
+
367
+ export const Motion: Story = {
368
+ parameters: {
369
+ docs: {
370
+ description: {
371
+ story:
372
+ 'Caret motion (manifest 1.10.0 `motion.states.open`) — click a trigger to toggle `open`. The one `caret-down-small` glyph turns 180° (down → up) on `--spring-standard` and back on close; it is never swapped for `caret-up-small`. Click twice quickly: the caret turns around mid-turn without a jerk (`motion.interrupt`). Under `prefers-reduced-motion: reduce` (emulate it in DevTools → Rendering) the caret shows its end pose at once, without the turn.',
373
+ },
374
+ },
375
+ },
376
+ render: () => (
377
+ <Showcase>
378
+ <Section title="Click to toggle open" layout="column">
379
+ <Frame>
380
+ <MotionToggle size="md" />
381
+ </Frame>
382
+ <Frame>
383
+ <MotionToggle size="sm" />
384
+ </Frame>
385
+ </Section>
386
+ </Showcase>
387
+ ),
388
+ };
389
+
390
+ export const WithField: Story = {
391
+ parameters: {
392
+ docs: {
393
+ description: {
394
+ story:
395
+ 'Real usage — wrapped in `Field` for the floating label, helper and error messaging. A SelectField label **always floats to the top** (SelectField is in `Field`’s auto-float list): in Figma the label only ever lives in the top position (hidden when empty, with a placeholder shown inside), it never rests inside.',
396
+ },
397
+ },
398
+ },
399
+ render: () => (
400
+ <Showcase>
401
+ <Section title="Editable" layout="column">
402
+ <Frame>
403
+ <Field label="Měna" helperText="Použije se pro všechny položky faktury">
404
+ <SelectField id="currency" value="CZK — Česká koruna" />
405
+ </Field>
406
+ </Frame>
407
+ <Frame>
408
+ <Field label="Měna">
409
+ <SelectField id="currency-empty" placeholder="Vyberte měnu" />
410
+ </Field>
411
+ </Frame>
412
+ <Frame>
413
+ <Field label="Měna" error="Vyberte měnu">
414
+ <SelectField id="currency-err" state="error" placeholder="Vyberte měnu" />
415
+ </Field>
416
+ </Frame>
417
+ </Section>
418
+ </Showcase>
419
+ ),
420
+ };
421
+
422
+ /** A 390 viewport — below `sm`, where the list opens as the mobile bottom sheet. */
423
+ const MOBILE_VIEWPORTS = {
424
+ // fods-lint-disable-next-line Storybook viewport preset: the 390 mobile exhibit width, not a design value
425
+ mobile: { name: 'Below sm · 390', styles: { width: '390px', height: '844px' } },
426
+ };
427
+
428
+ const SHEET_CURRENCIES = [
429
+ { value: 'CZK', label: 'CZK — Česká koruna' },
430
+ { value: 'EUR', label: 'EUR — Euro' },
431
+ { value: 'USD', label: 'USD — americký dolar' },
432
+ { value: 'GBP', label: 'GBP — britská libra' },
433
+ ];
434
+
435
+ const MobileSheetDemo = () => {
436
+ const [value, setValue] = React.useState('CZK');
437
+ return (
438
+ <div className="p-600">
439
+ <Field label="Měna">
440
+ <Select id="currency-mobile" options={SHEET_CURRENCIES} value={value} onValueChange={setValue} placeholder={PLACEHOLDER} />
441
+ </Field>
442
+ </div>
443
+ );
444
+ };
445
+
446
+ export const MobileSheet: Story = {
447
+ name: 'Mobile — bottom sheet',
448
+ parameters: {
449
+ layout: 'fullscreen',
450
+ viewport: { options: MOBILE_VIEWPORTS },
451
+ docs: {
452
+ description: {
453
+ story:
454
+ 'Below `sm` the panel this trigger opens is a **bottom sheet** (select-field 1.8.0), rendered by the `Select` organism: the trigger announces `aria-haspopup="dialog"`, the sheet title defaults to the field label (`sheetTitle` overrides it), rows are List Row Mobile with a trailing check. Open the story in the canvas — the docs column is wider than `sm`.',
455
+ },
456
+ },
457
+ },
458
+ globals: { viewport: { value: 'mobile' } },
459
+ render: () => <MobileSheetDemo />,
460
+ };
@@ -0,0 +1,138 @@
1
+ "use client";
2
+
3
+ import * as React from 'react';
4
+ import { Icon, type IconSize } from '../icon/Icon';
5
+ import { MotionCaret } from '../../internal/MotionCaret';
6
+ import { cn } from '../../internal/utils';
7
+ import {
8
+ EMPTY_VALUE_DASH,
9
+ textFieldShellVariants,
10
+ textFieldValueVariants,
11
+ type TextFieldSize,
12
+ } from '../text-field/TextField';
13
+
14
+ // =============================================================================
15
+ // SelectField — trigger for a single-select dropdown (Figma node 6307-228724,
16
+ // spec 04-molecules/select-field, manifest 1.11.0).
17
+ //
18
+ // This is the *closed trigger only* — not the options panel. Visually it is a
19
+ // reuse of the Text Field shell (`textFieldShellVariants` / `textFieldValueVariants`)
20
+ // so it stays pixel-locked with TextField, plus a trailing caret. It renders a
21
+ // read-only <button>; there is no Radix and no panel here — the listbox panel is
22
+ // composed separately. The floating label / helper / messaging live in `Field`.
23
+ // =============================================================================
24
+
25
+ export interface SelectFieldProps
26
+ extends Omit<React.ButtonHTMLAttributes<HTMLButtonElement>, 'value' | 'children'> {
27
+ /** Field height — Medium (48) standalone, Small (40) dense rows */
28
+ size?: TextFieldSize;
29
+ /** Visual state; SelectField has no `success`/`readonly` (unlike TextField) */
30
+ state?: 'default' | 'focused' | 'error' | 'disabled';
31
+ /** Selected value (label of the chosen option). When empty → placeholder. */
32
+ value?: string;
33
+ placeholder?: string;
34
+ /** Panel is open — caret rotates up + `aria-expanded`. */
35
+ open?: boolean;
36
+ className?: string;
37
+ }
38
+
39
+ const SelectField = React.forwardRef<HTMLButtonElement, SelectFieldProps>(
40
+ (
41
+ {
42
+ className,
43
+ size = 'md',
44
+ state,
45
+ value,
46
+ placeholder,
47
+ open,
48
+ disabled,
49
+ ...props
50
+ },
51
+ ref,
52
+ ) => {
53
+ // Native `disabled` wins when set explicitly; otherwise derive from `state`.
54
+ const isDisabled = disabled ?? state === 'disabled';
55
+ const currentState: 'default' | 'focused' | 'error' | 'disabled' = isDisabled
56
+ ? 'disabled'
57
+ : (state ?? 'default');
58
+
59
+ // Trailing icon size follows the Text Field shell tier (Figma trailing frame:
60
+ // Medium 24, Small 20) — parity with TextField, used by both the caret and the
61
+ // Error status icon.
62
+ const iconSize: IconSize = size === 'sm' ? 'small' : 'default';
63
+
64
+ // Trailing slot: the intrinsic status icon wins on Error (caret suppressed);
65
+ // otherwise the caret. Disabled dims all ink — the caret drops to
66
+ // --disabled-foreground rather than --icon-muted.
67
+ const trailingEl =
68
+ currentState === 'error' ? (
69
+ <Icon name="warning-circle" size={iconSize} className="shrink-0 text-status-danger" />
70
+ ) : (
71
+ <MotionCaret open={Boolean(open)}>
72
+ <Icon
73
+ name="caret-down-small"
74
+ size={iconSize}
75
+ className={cn('shrink-0', isDisabled ? 'text-disabled-foreground' : 'text-icon-muted')}
76
+ />
77
+ </MotionCaret>
78
+ );
79
+
80
+ const hasValue = Boolean(value);
81
+
82
+ return (
83
+ <button
84
+ ref={ref}
85
+ type="button"
86
+ role="combobox"
87
+ aria-haspopup="listbox"
88
+ aria-expanded={open ?? false}
89
+ aria-invalid={currentState === 'error' || undefined}
90
+ disabled={isDisabled}
91
+ // data-fods-* mark the parts the FODS verifier measures in the browser.
92
+ // The trigger reuses
93
+ // TextField's recipes but NOT its markup, so the attributes have to be
94
+ // repeated here — otherwise nothing in a rendered SelectField carries them.
95
+ // Not inert in this package: `styles/base.css` scopes its reset to them.
96
+ data-fods-component="select-field"
97
+ data-fods-part="root"
98
+ className={cn(
99
+ textFieldShellVariants({ inputSize: size, state: currentState }),
100
+ // Focus is the shell's border swap to --outline-focus (select-field
101
+ // manifest `focus.ring: null`, focus-ring.md § border-swap). The trigger
102
+ // is a <button>, so without this the browser's own :focus-visible outline
103
+ // (`outline-style: auto`, wider than the 1px label notch) painted over the
104
+ // floating label. Same suppression TextField's <input> carries in
105
+ // textFieldValueVariants.
106
+ 'outline-none',
107
+ // Clickable trigger — the shell variant only sets cursor-not-allowed on
108
+ // disabled, so add the pointer for the interactive states.
109
+ !isDisabled && 'cursor-pointer',
110
+ className,
111
+ )}
112
+ {...props}
113
+ >
114
+ <span
115
+ data-fods-part="value"
116
+ className={cn(
117
+ // `hasValue` carries the placeholder tier: the recipe's
118
+ // `placeholder:text-text-placeholder` needs a real ::placeholder and is
119
+ // inert on a <span>, so the empty-trigger ink comes from the variant
120
+ // (and from its disabled compound) instead of an inline class.
121
+ textFieldValueVariants({ state: currentState, hasValue }),
122
+ // Read-only trigger — the value truncates rather than scrolls.
123
+ 'truncate text-left',
124
+ )}
125
+ >
126
+ {/* A Disabled trigger with nothing chosen shows "–", never the prompt
127
+ (select-field 1.6.0); aria-hidden so the empty value is not read as "dash". */}
128
+ {value || (isDisabled ? <span aria-hidden="true">{EMPTY_VALUE_DASH}</span> : placeholder)}
129
+ </span>
130
+
131
+ {trailingEl}
132
+ </button>
133
+ );
134
+ },
135
+ );
136
+ SelectField.displayName = 'SelectField';
137
+
138
+ export { SelectField };
@@ -0,0 +1 @@
1
+ export { SelectField, type SelectFieldProps } from './SelectField';