@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,241 @@
1
+ import { Meta, Canvas, Controls } from '@storybook/addon-docs/blocks';
2
+ import * as SelectStories from './Select.stories';
3
+
4
+ <Meta of={SelectStories} tags={['autodocs']} />
5
+
6
+ # Select
7
+
8
+ ## Metadata
9
+
10
+ - **Layer:** organism
11
+ - **Status:** stable
12
+ - **Composes:** [`SelectField`](?path=/docs/design-system-molecules-selectfield--docs) (trigger) + [`PopoverSurface`](?path=/docs/design-system-patterns-popover-surface--docs) (panel chrome) + [`ListRow`](?path=/docs/design-system-atoms-listrow--docs) (`option` rows)
13
+ - **Behaviour engine:** [`@floating-ui/react`](https://floating-ui.com/docs/react) — positioning, list navigation, typeahead, dismiss, role, transition
14
+ - **Tokens used:** `--bg-hover`, `--bg-primary`, `--bg-readonly`, `--bg-secondary`, `--border-width-100`, `--border-width-200`, `--disabled-background`, `--disabled-foreground`, `--font-body`, `--font-size-base`, `--font-size-sm`, `--font-size-xs`, `--font-weight-normal`, `--font-weight-semibold`, `--icon-muted`, `--leading-loose`, `--leading-relaxed`, `--outline-default`, `--outline-focus`, `--radius-200`, `--radius-400`, `--radius-500`, `--secondary`, `--secondary-active`, `--shadow-overlay`, `--size-icon-small`, `--size-icon-xsmall`, `--space-100`, `--space-1000`, `--space-1100`, `--space-200`, `--space-300`, `--space-400`, `--space-500`, `--space-600`, `--status-danger`, `--status-success-solid`, `--text-link`, `--text-link-hover`, `--text-placeholder`, `--text-primary`, `--text-secondary`, `--z-index-dropdown`
15
+
16
+ ## Overview
17
+
18
+ Use a **Select** to pick **one value from a fixed, known set** — currency, country, VAT rate, unit,
19
+ payment method. It is the **working single-select organism**: a controlled widget you drive with
20
+ `options` + `value` + `onValueChange`. The design system ships the pieces (trigger, panel chrome,
21
+ rows); this organism wires them into a keyboard-driven, portalled dropdown and supplies what the
22
+ primitives deliberately do not — the role + keyboard contract, `aria-activedescendant` (DOM focus
23
+ stays on the trigger — virtual navigation), a portalled panel with collision flip/shift, and an exit
24
+ transition.
25
+
26
+ Wrap it in `Field` for a floating label, helper and error messaging — `Field` detects the Select and
27
+ keeps the label floating regardless of the open/closed state.
28
+
29
+ Do **not** use it for free-form text (→ **TextField**), for a large or **searchable / typed** set
30
+ (→ a Combobox / autocomplete), for **multi-select** or toggles (→ a Popover + checkbox list), or for
31
+ **navigation / commands** (→ a Menu). If the user should be able to *type to filter*, it is not a Select.
32
+
33
+ ## Anatomy
34
+
35
+ - **Trigger** — a [`SelectField`](?path=/docs/design-system-molecules-selectfield--docs): the reused
36
+ Text Field shell + a trailing caret. Shows the selected option's label (or the placeholder) and a
37
+ caret that flips down → up on open. Rendered as a read-only `<button>`; DOM focus stays here while open.
38
+ - **Panel** — the shared [`PopoverSurface`](?path=/docs/design-system-patterns-popover-surface--docs)
39
+ chrome recipe (`popoverSurfaceVariants` + `popoverBodyClass` + `popoverGroupClass`), **portalled** into
40
+ the enclosing `Modal` or `Drawer` when the trigger sits inside one, else into the `PortalContainerContext`
41
+ element when one is provided, else to `document.body`, and anchored below the trigger. Per spec the surface is a chrome recipe, **not a component**.
42
+ - **Option rows** — [`ListRow`](?path=/docs/design-system-atoms-listrow--docs) `role="option"` rows. The
43
+ trigger size cascades: a Medium trigger opens Medium rows (40), a Small trigger Small rows (36).
44
+ Single-select → the chosen row carries the Selected fill and a **leading checkmark** in `--secondary` (blue,
45
+ list-row 2.7.0 `slots.leading`) — the one glyph that leaves the family ink; the others reserve the slot (invisible icon)
46
+ so labels stay aligned. The checkmark tracks the row density (20 at Medium, 16 at Small) via
47
+ `ListRow`'s leading slot, so it must not carry an `Icon size` of its own. A disabled option is dimmed
48
+ and skipped by keyboard nav.
49
+ - **Floating label / helper / error** — NOT owned by Select; wrap it in **Field**.
50
+
51
+ ## Matrix
52
+
53
+ <Canvas of={SelectStories.Matrix} />
54
+
55
+ The full state × size grid, mirroring the Figma labelled grid — rows are states, columns are sizes.
56
+ Only the three states the trigger actually renders appear: open/focus is derived internally and never
57
+ passed in, so it has no cell of its own.
58
+
59
+ ## Sizes
60
+
61
+ <Canvas of={SelectStories.Sizes} />
62
+
63
+ Medium (48) is the default for standard forms; Small (40) is for dense contexts (filter bars, table
64
+ cells, tight toolbars). The trigger size cascades to the panel rows. Keep **one size per form**. Width is
65
+ layout — the trigger fills its column and the panel takes the trigger width (min-width = trigger width).
66
+
67
+ ## States
68
+
69
+ <Canvas of={SelectStories.States} />
70
+
71
+ Only **error** and **disabled** are passed in; open/focus is derived internally.
72
+
73
+ - **Default** — placeholder in `--text-placeholder`, caret-down in `--icon-muted`.
74
+ - **Focused (open)** — derived on open: the trigger border swaps to `--outline-focus` (no ring), the caret
75
+ flips up and the panel is anchored below.
76
+ - **Error** — `state="error"` (or `Field` injecting `aria-invalid`) → `--status-danger` border + a trailing
77
+ `warning-circle` status icon (replacing the caret); pair with a `Field` error message. Colour is never the sole cue (WCAG 1.4.1).
78
+ - **Disabled** — `--outline-default` border at `--border-width-100`, `--disabled-background` fill, content + caret in `--disabled-foreground` (nothing chosen → `–`); not focusable, does not open.
79
+ `disabled` wins over `state`.
80
+
81
+ ## With Field
82
+
83
+ <Canvas of={SelectStories.WithField} />
84
+
85
+ A Select label **always floats to the top** (Select is in `Field`’s auto-float list): the label lives on
86
+ the top border, hidden when empty with a placeholder shown inside, and never rests inside. `Field` injects
87
+ `error` / `aria-invalid` / `aria-describedby` and reads `onOpenChange` (not `onFocus`) to drive the label
88
+ focus state while the panel is open.
89
+
90
+ ## Long list
91
+
92
+ <Canvas of={SelectStories.LongList} />
93
+
94
+ The panel height is soft-capped (~8–10 rows), so a long set scrolls inside the body rather than off-screen;
95
+ collision **flip/shift** keeps the panel in the viewport.
96
+
97
+ ## Disabled option
98
+
99
+ <Canvas of={SelectStories.WithDisabledOption} />
100
+
101
+ Mark an option `disabled: true` to render it dimmed and non-selectable — keyboard navigation steps over it.
102
+
103
+ ## API
104
+
105
+ <Controls />
106
+
107
+ ## Do / Don't
108
+
109
+ - ✅ Reach for a Select for a **fixed, known set** the user recognises.
110
+ - ✅ Keep it **controlled** — hold `value` in state, update it in `onValueChange`.
111
+ - ✅ Wrap in **Field** for the floating `<label>` (the accessible name) + helper / error.
112
+ - ✅ Give a label-less filter Select an explicit **`aria-label`**.
113
+ - ✅ Pair `state="error"` with a matching `error` message on the `Field`.
114
+ - ❌ Don't use it for a set the user must **type to find** (that's a Combobox) or for free-form text (TextField).
115
+ - ❌ Don't use it for >20-30 items — use a Combobox / search pattern.
116
+ - ❌ Don't use it for binary choices — use `RadioGroup` or a switch.
117
+ - ❌ Don't rely on the placeholder as the accessible name.
118
+
119
+ ## Keyboard
120
+
121
+ <table>
122
+ <thead>
123
+ <tr><th>Key</th><th>Action</th></tr>
124
+ </thead>
125
+ <tbody>
126
+ <tr><td><kbd>Enter</kbd> / <kbd>Space</kbd> / <kbd>↓</kbd></td><td>Open the panel (highlight lands on the selected option)</td></tr>
127
+ <tr><td><kbd>↑</kbd> / <kbd>↓</kbd></td><td>Move the highlight (loops; skips disabled options)</td></tr>
128
+ <tr><td>typeahead</td><td>Type to jump to the option whose label matches</td></tr>
129
+ <tr><td><kbd>Home</kbd> / <kbd>End</kbd></td><td>Jump to the first / last option</td></tr>
130
+ <tr><td><kbd>Enter</kbd> / <kbd>Space</kbd></td><td>Select the highlighted option + close (Space suppressed mid-typeahead)</td></tr>
131
+ <tr><td><kbd>Esc</kbd></td><td>Close the panel and return focus to the trigger</td></tr>
132
+ </tbody>
133
+ </table>
134
+
135
+ Below `sm` the same keys work on the bottom sheet, with real DOM focus on the rows (roving `tabindex`)
136
+ instead of `aria-activedescendant`; there is no typeahead.
137
+
138
+ ## Accessibility
139
+
140
+ - **Semantics** — the trigger is `role="combobox"` with `aria-haspopup="listbox"` and `aria-expanded`; the
141
+ panel is `role="listbox"` and each option is `role="option"` with `aria-selected`. A label-less filter Select
142
+ needs an explicit `aria-label` — the placeholder is **not** a label.
143
+ - **Two things need the name, not one.** The `Field` label names the **trigger** natively (`<label htmlFor>`),
144
+ but a `role="listbox"` is name-required in its own right and the panel is portalled out of the field, where
145
+ `htmlFor` cannot reach it. `Field` therefore also hands its label's `id` down as `aria-labelledby`, which
146
+ `Select` puts on the panel — so both are named by the same visible text, with nothing retyped. Exactly one of
147
+ `aria-labelledby` / `aria-label` ever lands on the panel: `aria-labelledby` wins the accessible-name
148
+ computation, so a co-existing `aria-label` would look present and never be announced. An `aria-label` you pass
149
+ yourself is treated as a deliberate override and `Field` stays out of the way.
150
+ - **Virtual focus** — DOM focus **stays on the trigger** while open; the current option is pointed at by
151
+ **`aria-activedescendant`** (list navigation is virtual). The rows never own a focus ring — the current option is
152
+ a soft `--bg-hover` highlight. On selection or dismissal, focus returns to the trigger.
153
+ - **State & ARIA** — open sets `aria-expanded="true"`; **Error** = `aria-invalid="true"` + `aria-describedby` at
154
+ the message id, signalled by colour **and** the status icon (WCAG 1.4.1). Disabled drops from the tab order.
155
+ - **Screen reader** — VoiceOver / NVDA announce "combobox", the current value and the option count; as the
156
+ highlight moves, each option is announced with its position.
157
+
158
+ - **Mobile bottom sheet (below `sm`)** — the trigger announces `aria-haspopup="dialog"` instead of
159
+ `listbox`. The sheet is `role="dialog"` + `aria-modal="true"`, named by its title (`sheetTitle`, else the
160
+ field label); the page behind is `inert`. Focus lands on the **selected row** (roving `tabindex`, the
161
+ rows hold real DOM focus and show the inset `--outline-focus` ring); ↑ ↓ / Home / End move it, Enter /
162
+ Space select + close. A visually hidden «Zavřít» button, Esc, a drag down and the scrim close the sheet
163
+ without a change, and focus returns to the trigger. Inside a Modal the sheet stacks above it
164
+ (`--z-index-popover`) and Esc closes only the sheet. For the hidden close button, its name is the optional `sheetCloseLabel` (default «Zavřít»), which an app with more than one language version passes from its translations on every use; the full list of such props is in [Consuming → Texts and locale](?path=/docs/getting-started-consuming--docs#texts-and-locale).
165
+
166
+ Accessibility floor for every FODS component: `spec/01-foundations/accessibility.md`.
167
+
168
+ ## Mobile bottom sheet
169
+
170
+ <Canvas of={SelectStories.MobileSheet} />
171
+
172
+ Below `sm` (640 viewport width, `useIsMobile('sm')`) the options open in a **bottom sheet** instead of the
173
+ anchored panel (`overlay-behavior.md` § Mobile, select-field 1.8.0): grab handle, centred title
174
+ (`sheetTitle`, defaulting to the field label), List Row Mobile rows with the trailing check in
175
+ `--secondary` (list-row 2.7.0), no divider under the header. The sheet caps at 80% of the visual viewport and goes
176
+ full-height when fewer than three rows would fit; it closes on selection, a drag down past a quarter of its
177
+ height, the scrim, Esc and the hidden «Zavřít».
178
+
179
+ ## Positioning
180
+
181
+ Positioning and interactions come from `@floating-ui/react`:
182
+
183
+ - **Portal** — the panel renders in a `FloatingPortal` whose root is the enclosing `Modal` or `Drawer` dialog
184
+ when the trigger sits inside one (so the panel stays inside its focus trap), else the `PortalContainerContext`
185
+ element, else `document.body`; it floats over the page instead of pushing it (the page behind does not shift).
186
+ - **Anchor** — `placement: 'bottom-start'` with a **4px** (`--space-200`) `offset`, below the trigger.
187
+ - **Collision** — `flip` (above when there is no room below) + `shift` (nudge within the viewport), 8px padding.
188
+ - **Size** — the panel **min-width = trigger width**; the height is soft-capped so long lists scroll inside the body.
189
+ - **Transition** — fades + slides in/out over **150ms** (`--duration-fast`) via `useTransitionStyles`.
190
+
191
+ ## Usage
192
+
193
+ ```tsx
194
+ import { Field, Select } from '@invoiceonline/ui-react';
195
+ import type { SelectOption } from '@invoiceonline/ui-react';
196
+
197
+ const CURRENCIES: SelectOption[] = [
198
+ { value: 'CZK', label: 'CZK — Česká koruna' },
199
+ { value: 'EUR', label: 'EUR — Euro' },
200
+ { value: 'USD', label: 'USD — americký dolar' },
201
+ ];
202
+
203
+ function CurrencyPicker() {
204
+ const [value, setValue] = React.useState('CZK');
205
+
206
+ // Good — controlled, wrapped in Field for the floating label + helper
207
+ return (
208
+ <Field label="Měna" helperText="Použije se pro všechny položky faktury">
209
+ <Select id="currency" options={CURRENCIES} value={value} onValueChange={setValue} placeholder="Vyberte měnu" />
210
+ </Field>
211
+ );
212
+ }
213
+
214
+ // Good — label-less filter Select needs an explicit aria-label
215
+ <Select options={CURRENCIES} value={value} onValueChange={setValue} aria-label="Měna" />
216
+
217
+ // Good — small size for dense rows / filter bars
218
+ <Select size="sm" options={UNITS} value={unit} onValueChange={setUnit} aria-label="Jednotka" />
219
+
220
+ // Good — a non-selectable option
221
+ <Select options={[{ value: 'ex', label: 'Osvobozeno', disabled: true }, ...]} ... />
222
+ ```
223
+
224
+ ```tsx
225
+ // Don't — using <select> directly (Select is the widget)
226
+ <select onChange={...}>...</select>
227
+
228
+ // Don't — leaving it uncontrolled; hold `value` in state and update it in onValueChange
229
+
230
+ // Don't — relying on the placeholder as the accessible name; wrap in Field or add aria-label
231
+ <Select options={CURRENCIES} placeholder="Vyberte měnu" />
232
+ ```
233
+
234
+ ## Related
235
+
236
+ - [`SelectField`](?path=/docs/design-system-molecules-selectfield--docs) — the trigger this organism wires up
237
+ - [`PopoverSurface`](?path=/docs/design-system-patterns-popover-surface--docs) — the panel chrome recipe
238
+ - [`ListRow`](?path=/docs/design-system-atoms-listrow--docs) — the `option` rows
239
+ - [`Field`](?path=/docs/design-system-atoms-field--docs) — floating-label / helper / error wrapper
240
+ - [`RadioGroup`](?path=/docs/design-system-atoms-radiogroup--docs) — for ≤5 mutually exclusive options
241
+ - Spec: `spec/06-patterns/overlay-behavior.md`
@@ -0,0 +1,404 @@
1
+ import * as React from 'react';
2
+ import type { Meta, StoryObj } from '@storybook/react-vite';
3
+ import type { ReactNode } from 'react';
4
+ import { Field } from '../field/Field';
5
+ import { Select } from './Select';
6
+ import type { SelectOption } from './Select';
7
+ import { Section, Showcase } from '../../storybook/Section';
8
+ import { componentDoc } from '../../storybook/componentDoc';
9
+
10
+ const SIZES = ['md', 'sm'] as const;
11
+ // Only `error` and `disabled` change the trigger — the rest resolve to default
12
+ // (open/focus is derived internally, never passed in). See Select.tsx.
13
+ const STATES = ['default', 'error', 'disabled'] as const;
14
+
15
+ const Frame = ({ children }: { children: ReactNode }) => (
16
+ <div className="w-[calc(var(--space-1200)*4)]">{children}</div>
17
+ );
18
+
19
+ // -----------------------------------------------------------------------------
20
+ // Realistic option sets (cs) — a Select is for a fixed, known set.
21
+ // -----------------------------------------------------------------------------
22
+ const CURRENCIES: SelectOption[] = [
23
+ { value: 'CZK', label: 'CZK — Česká koruna' },
24
+ { value: 'EUR', label: 'EUR — Euro' },
25
+ { value: 'USD', label: 'USD — americký dolar' },
26
+ { value: 'GBP', label: 'GBP — britská libra' },
27
+ ];
28
+
29
+ const UNITS: SelectOption[] = [
30
+ { value: 'ks', label: 'ks' },
31
+ { value: 'hod', label: 'hod' },
32
+ { value: 'den', label: 'den' },
33
+ { value: 'kg', label: 'kg' },
34
+ { value: 'm', label: 'm' },
35
+ ];
36
+
37
+ const VAT_RATES: SelectOption[] = [
38
+ { value: '21', label: '21 %' },
39
+ { value: '12', label: '12 %' },
40
+ { value: '0', label: '0 %' },
41
+ { value: 'osvobozeno', label: 'Osvobozeno od DPH' },
42
+ ];
43
+
44
+ // A long set to demonstrate the panel's scroll cap (10+ rows).
45
+ const COUNTRIES: SelectOption[] = [
46
+ { value: 'cz', label: 'Česká republika' },
47
+ { value: 'sk', label: 'Slovensko' },
48
+ { value: 'pl', label: 'Polsko' },
49
+ { value: 'de', label: 'Německo' },
50
+ { value: 'at', label: 'Rakousko' },
51
+ { value: 'hu', label: 'Maďarsko' },
52
+ { value: 'ro', label: 'Rumunsko' },
53
+ { value: 'bg', label: 'Bulharsko' },
54
+ { value: 'hr', label: 'Chorvatsko' },
55
+ { value: 'si', label: 'Slovinsko' },
56
+ { value: 'fr', label: 'Francie' },
57
+ { value: 'es', label: 'Španělsko' },
58
+ { value: 'it', label: 'Itálie' },
59
+ { value: 'gb', label: 'Spojené království' },
60
+ { value: 'nl', label: 'Nizozemsko' },
61
+ { value: 'be', label: 'Belgie' },
62
+ { value: 'ch', label: 'Švýcarsko' },
63
+ { value: 'se', label: 'Švédsko' },
64
+ ];
65
+
66
+ const meta = {
67
+ title: 'Design System/Organisms/Select',
68
+ component: Select,
69
+ parameters: {
70
+ layout: 'centered',
71
+ containerWidth: 300,
72
+ docs: {
73
+ description: {
74
+ component: componentDoc({
75
+ summary:
76
+ 'Controlled single-select ORGANISM — the working widget that wires the `SelectField` trigger, the `PopoverSurface` chrome recipe and `ListRow` `option` rows into one keyboard-driven, portalled dropdown (via `@floating-ui/react`). You pass `options` + `value` + `onValueChange`; it owns open/close, virtual keyboard navigation (`aria-activedescendant`), collision flip/shift and the exit transition. Wrap it in `Field` for a floating label, helper or error messaging.',
77
+ useCases: [
78
+ 'Pick one value from a fixed set — currency, unit, VAT rate, country, payment method',
79
+ '`size="md"` (48) — standard forms · `size="sm"` (40) — dense rows, filter bars',
80
+ '`state="error"` — the trigger caret is replaced by the `warning-circle` status icon; pair with a `Field` error message',
81
+ '`options[].disabled` — a non-selectable, dimmed row skipped by keyboard navigation',
82
+ ],
83
+ bestPractices: [
84
+ 'Wrap in `Field` for the floating label — the `<label>` is the accessible name, never the placeholder',
85
+ 'For a label-less filter Select supply an explicit `aria-label`',
86
+ 'Use for a fixed, discoverable set — reach for a Combobox/autocomplete for long, searchable, or type-to-filter lists',
87
+ 'Keep it controlled — hold `value` in state and update it in `onValueChange`',
88
+ ],
89
+ knownIssues: [
90
+ 'Single-select only — searchable sets are a Combobox, multi-select is a Popover + checkbox list, command menus are a Menu',
91
+ 'The panel height is soft-capped at `--ds-overlay-max-height` (320 ≈ 8 rows of 40), published since ui-system 0.10.0; longer lists scroll inside the body',
92
+ ],
93
+ docsLink: { label: 'spec/06-patterns/popover-patterns.md' },
94
+ }),
95
+ },
96
+ },
97
+ },
98
+ } satisfies Meta<typeof Select>;
99
+
100
+ export default meta;
101
+ type Story = StoryObj<typeof Select>;
102
+
103
+ // Select is controlled — every demo owns the value in local state (the organism
104
+ // owns open/close). Hooks must live in components, not in Story `render` bodies
105
+ // (react-hooks/rules-of-hooks), so each story renders a small component below.
106
+
107
+ const PlaygroundDemo = (args: React.ComponentProps<typeof Select>) => {
108
+ const [value, setValue] = React.useState(args.value ?? '');
109
+ // Reset local value when the control changes it.
110
+ React.useEffect(() => setValue(args.value ?? ''), [args.value]);
111
+ return (
112
+ <Frame>
113
+ <Select {...args} value={value} onValueChange={setValue} />
114
+ </Frame>
115
+ );
116
+ };
117
+
118
+ export const Playground: Story = {
119
+ args: {
120
+ options: CURRENCIES,
121
+ value: '',
122
+ placeholder: 'Vyberte měnu',
123
+ size: 'md',
124
+ state: 'default',
125
+ disabled: false,
126
+ 'aria-label': 'Měna',
127
+ },
128
+ argTypes: {
129
+ size: { control: 'select', options: SIZES },
130
+ state: { control: 'select', options: STATES },
131
+ disabled: { control: 'boolean' },
132
+ placeholder: { control: 'text' },
133
+ value: { control: 'text' },
134
+ options: { control: false },
135
+ },
136
+ render: args => <PlaygroundDemo {...args} />,
137
+ };
138
+
139
+ export const Matrix: Story = {
140
+ parameters: {
141
+ layout: 'padded',
142
+ docs: {
143
+ description: {
144
+ story:
145
+ 'Full state × size matrix — mirrors the Figma labelled grid. Rows = states, columns = sizes. Only the three states the trigger actually renders are shown: open/focus is derived internally and never passed in, so it has no cell of its own.',
146
+ },
147
+ },
148
+ },
149
+ render: () => <MatrixDemo />,
150
+ };
151
+
152
+ const MatrixDemo = () => {
153
+ const [value, setValue] = React.useState('CZK');
154
+ return (
155
+ <Showcase>
156
+ {STATES.map(state => (
157
+ <Section key={state} title={state} layout="row">
158
+ {SIZES.map(size => (
159
+ <div key={size} className="w-[calc(var(--space-1000)*6)]">
160
+ <Select
161
+ state={state}
162
+ size={size}
163
+ options={CURRENCIES}
164
+ value={value}
165
+ onValueChange={setValue}
166
+ aria-label="Měna"
167
+ />
168
+ </div>
169
+ ))}
170
+ </Section>
171
+ ))}
172
+ </Showcase>
173
+ );
174
+ };
175
+
176
+ export const Sizes: Story = {
177
+ parameters: {
178
+ docs: {
179
+ description: {
180
+ story:
181
+ 'Medium (48) — standard forms · Small (40) — dense rows, filter bars. The trigger size cascades to the panel rows (Medium rows for Medium, Small rows for Small). Pick by density and keep one size per form.',
182
+ },
183
+ },
184
+ },
185
+ render: () => <SizesDemo />,
186
+ };
187
+
188
+ const SizesDemo = () => {
189
+ const [a, setA] = React.useState('CZK');
190
+ const [b, setB] = React.useState('CZK');
191
+ return (
192
+ <Showcase>
193
+ <Section title="Medium (default)" layout="column">
194
+ <Frame>
195
+ <Select size="md" options={CURRENCIES} value={a} onValueChange={setA} aria-label="Měna" />
196
+ </Frame>
197
+ </Section>
198
+ <Section title="Small" layout="column">
199
+ <Frame>
200
+ <Select size="sm" options={CURRENCIES} value={b} onValueChange={setB} aria-label="Měna" />
201
+ </Frame>
202
+ </Section>
203
+ </Showcase>
204
+ );
205
+ };
206
+
207
+ export const States: Story = {
208
+ parameters: {
209
+ docs: {
210
+ description: {
211
+ story:
212
+ 'The trigger states that Select actually renders — Default (with a placeholder), Error (border + `warning-circle` status icon; shown inside a `Field` with a matching message) and Disabled (border kept, `--disabled-background` fill, dimmed, not focusable). Open/focus is derived internally, never passed in.',
213
+ },
214
+ },
215
+ },
216
+ render: () => <StatesDemo />,
217
+ };
218
+
219
+ const StatesDemo = () => {
220
+ const [def, setDef] = React.useState('');
221
+ const [err, setErr] = React.useState('');
222
+ return (
223
+ <Showcase>
224
+ <Section title="Default" layout="column">
225
+ <Frame>
226
+ <Select options={CURRENCIES} value={def} onValueChange={setDef} placeholder="Vyberte měnu" aria-label="Měna" />
227
+ </Frame>
228
+ </Section>
229
+ <Section title="Error (in Field)" layout="column">
230
+ <Frame>
231
+ <Field label="Měna" error="Vyberte měnu">
232
+ <Select id="currency-err" options={CURRENCIES} value={err} onValueChange={setErr} state="error" placeholder="Vyberte měnu" />
233
+ </Field>
234
+ </Frame>
235
+ </Section>
236
+ <Section title="Disabled" layout="column">
237
+ <Frame>
238
+ <Select options={CURRENCIES} value="CZK" disabled aria-label="Měna" />
239
+ </Frame>
240
+ </Section>
241
+ </Showcase>
242
+ );
243
+ };
244
+
245
+ export const WithField: Story = {
246
+ parameters: {
247
+ docs: {
248
+ description: {
249
+ story:
250
+ 'Real usage — wrapped in `Field` for the floating label, helper and error messaging. A Select label **always floats to the top** (Select is in `Field`’s auto-float list): the label lives on the top border (hidden when empty, with a placeholder shown inside), it never rests inside. `Field` injects `error`/`aria-invalid`/`aria-describedby` and reads `onOpenChange` for the label focus state.',
251
+ },
252
+ },
253
+ },
254
+ render: () => <WithFieldDemo />,
255
+ };
256
+
257
+ const WithFieldDemo = () => {
258
+ const [filled, setFilled] = React.useState('CZK');
259
+ const [empty, setEmpty] = React.useState('');
260
+ const [err, setErr] = React.useState('');
261
+ return (
262
+ <Showcase>
263
+ <Section title="Editable" layout="column">
264
+ <Frame>
265
+ <Field label="Měna" helperText="Použije se pro všechny položky faktury">
266
+ <Select id="currency" options={CURRENCIES} value={filled} onValueChange={setFilled} placeholder="Vyberte měnu" />
267
+ </Field>
268
+ </Frame>
269
+ <Frame>
270
+ <Field label="Měna">
271
+ <Select id="currency-empty" options={CURRENCIES} value={empty} onValueChange={setEmpty} placeholder="Vyberte měnu" />
272
+ </Field>
273
+ </Frame>
274
+ <Frame>
275
+ <Field label="Měna" error="Vyberte měnu">
276
+ <Select id="currency-err2" options={CURRENCIES} value={err} onValueChange={setErr} state="error" placeholder="Vyberte měnu" />
277
+ </Field>
278
+ </Frame>
279
+ </Section>
280
+ </Showcase>
281
+ );
282
+ };
283
+
284
+ export const LongList: Story = {
285
+ name: 'Long list (scroll)',
286
+ parameters: {
287
+ docs: {
288
+ description: {
289
+ story:
290
+ 'A long option set (18 countries). The panel height is soft-capped, so the list scrolls inside the body rather than running off-screen — with collision flip/shift keeping it in the viewport. Typeahead jumps to a matching label; Home/End reach the ends.',
291
+ },
292
+ },
293
+ },
294
+ render: () => <LongListDemo />,
295
+ };
296
+
297
+ const LongListDemo = () => {
298
+ const [value, setValue] = React.useState('cz');
299
+ return (
300
+ <Showcase>
301
+ <Section title="Country" layout="column">
302
+ <Frame>
303
+ <Field label="Země">
304
+ <Select id="country" options={COUNTRIES} value={value} onValueChange={setValue} placeholder="Vyberte zemi" />
305
+ </Field>
306
+ </Frame>
307
+ </Section>
308
+ </Showcase>
309
+ );
310
+ };
311
+
312
+ export const WithDisabledOption: Story = {
313
+ parameters: {
314
+ docs: {
315
+ description: {
316
+ story:
317
+ 'A single option marked `disabled: true` — it is dimmed and skipped by keyboard navigation (↑ ↓ step over it, it cannot be selected). Here "Osvobozeno od DPH" is non-selectable.',
318
+ },
319
+ },
320
+ },
321
+ render: () => <WithDisabledOptionDemo />,
322
+ };
323
+
324
+ const WithDisabledOptionDemo = () => {
325
+ const options: SelectOption[] = VAT_RATES.map(o =>
326
+ o.value === 'osvobozeno' ? { ...o, disabled: true } : o,
327
+ );
328
+ const [value, setValue] = React.useState('21');
329
+ return (
330
+ <Showcase>
331
+ <Section title="VAT rate" layout="column">
332
+ <Frame>
333
+ <Field label="Sazba DPH">
334
+ <Select id="vat-rate" options={options} value={value} onValueChange={setValue} placeholder="Vyberte sazbu" />
335
+ </Field>
336
+ </Frame>
337
+ </Section>
338
+ </Showcase>
339
+ );
340
+ };
341
+
342
+ export const Units: Story = {
343
+ parameters: {
344
+ docs: { description: { story: 'A short units set — a compact fixed list, a typical dense-row Select.' } },
345
+ },
346
+ render: () => <UnitsDemo />,
347
+ };
348
+
349
+ const UnitsDemo = () => {
350
+ const [value, setValue] = React.useState('ks');
351
+ return (
352
+ <Showcase>
353
+ <Section title="Unit" layout="column">
354
+ <Frame>
355
+ <Select size="sm" options={UNITS} value={value} onValueChange={setValue} aria-label="Jednotka" />
356
+ </Frame>
357
+ </Section>
358
+ </Showcase>
359
+ );
360
+ };
361
+
362
+ /** A 390 viewport — below `sm`, where the list opens as the mobile bottom sheet. */
363
+ const MOBILE_VIEWPORTS = {
364
+ // fods-lint-disable-next-line Storybook viewport preset: the 390 mobile exhibit width, not a design value
365
+ mobile: { name: 'Below sm · 390', styles: { width: '390px', height: '844px' } },
366
+ };
367
+
368
+ const MobileSheetDemo = () => {
369
+ const [currency, setCurrency] = React.useState('CZK');
370
+ const [country, setCountry] = React.useState('');
371
+ return (
372
+ <div className="flex flex-col gap-600 p-600">
373
+ <Field label="Měna">
374
+ <Select id="currency-sheet" options={CURRENCIES} value={currency} onValueChange={setCurrency} placeholder="Vyberte měnu" />
375
+ </Field>
376
+ <Field label="Země">
377
+ <Select
378
+ id="country-sheet"
379
+ options={COUNTRIES}
380
+ value={country}
381
+ onValueChange={setCountry}
382
+ placeholder="Vyberte zemi"
383
+ sheetTitle="Země odběratele"
384
+ />
385
+ </Field>
386
+ </div>
387
+ );
388
+ };
389
+
390
+ export const MobileSheet: Story = {
391
+ name: 'Mobile — bottom sheet',
392
+ parameters: {
393
+ layout: 'fullscreen',
394
+ viewport: { options: MOBILE_VIEWPORTS },
395
+ docs: {
396
+ description: {
397
+ story:
398
+ 'Below `sm` (640 viewport) the options open as a **bottom sheet** (select-field 1.8.0): grab handle, centred title (the field label, or `sheetTitle` when the label is abbreviated), List Row Mobile rows with the trailing check in `--secondary` (list-row 2.7.0). The sheet is a modal `dialog` named by its title; focus lands on the selected row (roving, inset ring); drag down, the scrim, Esc or the hidden «Zavřít» close it and focus returns to the field. Open the story in the canvas — the docs column is wider than `sm`.',
399
+ },
400
+ },
401
+ },
402
+ globals: { viewport: { value: 'mobile' } },
403
+ render: () => <MobileSheetDemo />,
404
+ };