@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,285 @@
1
+ import { Meta, Canvas, Controls } from '@storybook/addon-docs/blocks';
2
+ import * as DropdownButtonStories from './DropdownButton.stories';
3
+
4
+ <Meta of={DropdownButtonStories} tags={['autodocs']} />
5
+
6
+ # DropdownButton
7
+
8
+ ## Metadata
9
+
10
+ - **Layer:** atom
11
+ - **Status:** stable
12
+ - **Tokens used:** `--bg-active`, `--bg-hover`, `--bg-primary`, `--border-width-100`, `--border-width-200`, `--disabled-control`, `--disabled-foreground`, `--font-body`, `--font-size-base`, `--font-size-md`, `--font-size-sm`, `--font-weight-semibold`, `--leading-loose`, `--leading-relaxed`, `--outline-default`, `--outline-focus`, `--primary-active`, `--primary-foreground`, `--primary-hover`, `--primary-solid`, `--radius-200`, `--secondary`, `--secondary-active`, `--secondary-foreground`, `--secondary-hover`, `--secondary-solid`, `--size-icon`, `--size-icon-small`, `--space-1000`, `--space-300`, `--space-400`, `--space-500`, `--space-600`, `--space-900`
13
+ - **Manifest version:** `2.1.1`
14
+
15
+ ## Overview
16
+
17
+ A label + trailing caret control whose **whole body opens a menu** — the „Akce ▾“ / „Možnosti ▾“ pattern, implementing the WAI-ARIA **menu button**. Use it when there is a set of **related actions with no single default**: clicking anywhere on the control opens the menu.
18
+
19
+ Use it **only as an action-menu trigger**. The label is a fixed noun (`Akce`, `Možnosti`, `Více`), never a chosen value. Do **not** use it when the label reflects a persisted selection („Seřadit: Nejnovější ▾“) — that is a **Select** (form semantics, `role="combobox"`/`listbox`), a separate component ([`Select`](?path=/docs/design-system-organisms-select--docs)). Do **not** use it when one action dominates and the menu only holds variants of it — that is a **SplitButton**. Several independent actions on one object belong in a **ButtonGroup**.
20
+
21
+ ### Choosing within the button family
22
+
23
+ <table>
24
+ <thead>
25
+ <tr><th>You have…</th><th>Use</th><th>Why</th></tr>
26
+ </thead>
27
+ <tbody>
28
+ <tr><td>one action, no menu</td><td><code>Button</code></td><td>plain action</td></tr>
29
+ <tr><td>one icon-only action, no menu</td><td><code>IconButton</code></td><td>square, label-less</td></tr>
30
+ <tr><td>an icon-only menu trigger („⋯“)</td><td><code>IconButton</code> + <code>aria-haspopup</code></td><td>reuses the square geometry; no separate component (needs <code>aria-label</code>)</td></tr>
31
+ <tr><td><strong>related choices, no single default</strong></td><td><strong><code>DropdownButton</code></strong></td><td>the whole body opens an action menu</td></tr>
32
+ <tr><td>one default action + variants of it</td><td><code>SplitButton</code></td><td>body fires the default; only the caret half opens the menu</td></tr>
33
+ <tr><td>several independent actions</td><td><code>ButtonGroup</code></td><td>connected toolbar / action bar</td></tr>
34
+ <tr><td>a persisted <strong>selected value</strong></td><td><a href="?path=/docs/design-system-organisms-select--docs"><code>Select</code></a></td><td>form field, not an action trigger</td></tr>
35
+ </tbody>
36
+ </table>
37
+
38
+ ## Rationale
39
+
40
+ Anatomically a DropdownButton is a [`Button`](?path=/docs/design-system-atoms-button--docs) with a trailing caret — so why a named component instead of `<Button trailingIcon={caret}>`? Because the **menu semantics must be correct by default**: `aria-haspopup="menu"`, `aria-expanded`, controlled/uncontrolled open state, and the caret as a **semantic affordance** (not a decorative trailing icon). A raw `<Button aria-haspopup>` usage pattern leaves every consumer to re-wire the ARIA, and some get it wrong — the same reasoning that keeps `SplitButton` a named component.
41
+
42
+ It is deliberately **thin**: geometry, colour families and the optical icon padding are delegated to `Button` (passing the caret as `trailingIcon` activates Button's `hasTrailing` optical padding automatically). Only the menu-button layer lives here.
43
+
44
+ Scoped to **4 families** (not Button's 8): a dropdown of *actions* is realistically a filled CTA (`primary` / `brand`), a quiet `secondary` „Akce ▾“, or — in a toolbar already built from tertiary buttons — a ghost `tertiary` so the trigger doesn't out-weigh its neighbours. There is no real danger/success dropdown pattern; if one ever appears it is a one-off `<Button>` config, not a maintained family.
45
+
46
+ ## Anatomy
47
+
48
+ A horizontal auto-layout row, centred, hug-width, fixed height per size — identical to `Button` plus:
49
+
50
+ - **Container** — fill / border / radius per family + state. Radius `--radius-200`; side padding + gap per size (Button metrics).
51
+ - **Leading icon** (optional) — the `icon` prop, decorative, rendered before the label; inherits the family foreground. Replaced by the spinner while `loading`.
52
+ - **Label** — `children`, `Body/*/Semibold` per size, family foreground. **Always present** — a label-less menu trigger is an `IconButton` + `aria-haspopup`. Single line: `whitespace-nowrap` comes from `Button`'s base per the manifest `text.label`.
53
+ - **Trailing caret** — a fixed `caret-down-small` glyph, `aria-hidden` (the affordance is announced via `aria-haspopup`). Not an instance-swap slot — it is the semantic menu marker; rotated 180° when open.
54
+ - **Menu panel** — **not part of this component.** The `role="menu"` panel is the [`Menu`](?path=/docs/design-system-organisms-menu--docs) organism, which takes this button as its `trigger`; this trigger owns only the open/close affordance and the expanded state.
55
+
56
+ ## Variants
57
+
58
+ <Canvas of={DropdownButtonStories.Variants} />
59
+
60
+ Four families, named identically to Button's; SplitButton exposes three of them (`tertiary` has no Split counterpart). **Tertiary is Secondary minus the border** — same fill/ink tokens per state.
61
+
62
+ <table>
63
+ <thead>
64
+ <tr><th>Varianta</th><th>Kdy</th><th>Tokeny</th></tr>
65
+ </thead>
66
+ <tbody>
67
+ <tr><td><code>primary</code></td><td>Filled blue — menu of actions on an in-product primary spot</td><td>fill <code>--secondary-solid</code>, hover <code>--secondary-hover</code>, active/open <code>--secondary-active</code>, ink <code>--secondary-foreground</code></td></tr>
68
+ <tr><td><code>brand</code></td><td>Filled orange — marketing / brand-tied surfaces</td><td>fill <code>--primary-solid</code>, hover <code>--primary-hover</code>, active/open <code>--primary-active</code>, ink <code>--primary-foreground</code></td></tr>
69
+ <tr><td><code>secondary</code> (default)</td><td>Neutral outline „Akce ▾“ — the default quiet trigger</td><td>transparent + border <code>--outline-default</code> (<code>--border-width-100</code>), ink <code>--secondary</code> → hover/active <code>--secondary-active</code>; wash <code>--bg-hover</code> / <code>--bg-active</code></td></tr>
70
+ <tr><td><code>tertiary</code></td><td>Ghost — toolbar / table bulk bar built from tertiary buttons („Označit jako ▾“)</td><td>transparent, no border, ink <code>--secondary</code> → hover/active <code>--secondary-active</code>; wash <code>--bg-hover</code> / <code>--bg-active</code></td></tr>
71
+ </tbody>
72
+ </table>
73
+
74
+ > Per the manifest (changelog 2026-07-31), hover **and** active share the `--secondary-active` ink on the borderless families — the wash depth (`--bg-hover` vs `--bg-active`) is what separates the two states. The binding is the one `Button` settled the same day (its manifest is 2.0.0 today), so the two stay locked.
75
+
76
+ ### Matrix
77
+
78
+ The full family × size grid.
79
+
80
+ <Canvas of={DropdownButtonStories.Matrix} />
81
+
82
+ ## Sizes
83
+
84
+ <Canvas of={DropdownButtonStories.Sizes} />
85
+
86
+ Button metrics, sm / md / lg only (no `xs` / `xl` — a menu trigger never needs those densities). Padding-X is the **base** (label side); the trailing side is one step tighter because the caret sits there (Button's optical icon-padding rule).
87
+
88
+ <table>
89
+ <thead>
90
+ <tr><th>Size</th><th style={{ textAlign: 'right' }}>Height</th><th>Font (Semibold)</th><th style={{ textAlign: 'right' }}>Caret</th><th>Padding-X (base)</th><th>Gap</th></tr>
91
+ </thead>
92
+ <tbody>
93
+ <tr><td><code>sm</code></td><td style={{ textAlign: 'right' }}>32 px</td><td><code>Body/S</code> (14)</td><td style={{ textAlign: 'right' }}>20 px</td><td><code>--space-500</code> (12)</td><td><code>--space-300</code> (6)</td></tr>
94
+ <tr><td><code>md</code> (default)</td><td style={{ textAlign: 'right' }}>40 px</td><td><code>Body/M</code> (16)</td><td style={{ textAlign: 'right' }}>24 px</td><td><code>--space-500</code> (12)</td><td><code>--space-400</code> (8)</td></tr>
95
+ <tr><td><code>lg</code></td><td style={{ textAlign: 'right' }}>44 px</td><td><code>Body/L</code> (18)</td><td style={{ textAlign: 'right' }}>24 px</td><td><code>--space-600</code> (16)</td><td><code>--space-400</code> (8)</td></tr>
96
+ </tbody>
97
+ </table>
98
+
99
+ ## States
100
+
101
+ <Canvas of={DropdownButtonStories.States} />
102
+
103
+ - **Default** — family base (see Variants).
104
+ - **Hover** — filled families shift the fill to the `-hover` step; borderless families add the neutral `--bg-hover` wash and move the ink to `--secondary-active`.
105
+ - **Active** — filled families use the `-active` fill; borderless families use the deeper `--bg-active` wash with the same `--secondary-active` ink.
106
+ - **Open** — **= the Active visual + caret rotated 180°.** No dedicated state token; the only new signal is caret direction. Emitted as `data-state="open"` (because CSS `:active` covers only the press) together with `aria-expanded="true"`.
107
+ - **Focus** — **not a variant**: the cross-cutting focus-ring pattern. An additive **offset** `--outline-focus` ring on `:focus-visible` (standalone control — not the inset double ring used by grouped segments). Never removed.
108
+ - **Disabled** — `--disabled-control` surface/border + `--disabled-foreground` ink; native `disabled`, the menu cannot open.
109
+ - **Loading** — spinner in the leading slot, `aria-busy="true"`, clicks suppressed; the menu cannot open. Keep a meaningful label („Načítám…“).
110
+
111
+ **How the grid above shows them.** `state` is **not a prop** — Hover and Active are CSS pseudo-classes, `disabled` / `loading` / `open` are the only states a consumer sets. The matrix therefore forces Hover and Active *statically*: every cell carries the bare (unprefixed) twin of the recipe's own `hover:` / `active:` class, passed through `className` so tailwind-merge drops the resting fill/border/ink class. `parameters.pseudo` is deliberately not used — Tailwind v4 wraps every `hover:` utility in `@media (hover: hover)` and the addon does not rewrite rules nested in a media query, so the row would render identically to Default. Open needs no forcing: it rides the real `data-state="open"` attribute. Focus is not part of the state axis and stays reachable with <kbd>Tab</kbd>.
112
+
113
+ ### Show surface
114
+
115
+ `showSurface` (default `false`, added 2026-08-28; named `surface` before 2.0.0) paints an opaque `--bg-primary` layer behind the label and caret, so a borderless trigger on a tinted section, card or banner stops borrowing the page colour. The two borderless families only — `secondary` and `tertiary`; it is inert on `primary` / `brand` and in `disabled`.
116
+
117
+ Because the washes are translucent, hover / active / **open** are emitted as a `background-image` layer over that white background-color — a second `background-color` would replace the surface instead of compositing over it. Open needs its own rule here rather than inheriting Button's, since `data-state="open"` is this component's own re-use of the Active visual.
118
+
119
+ Same layer, same token stack and the same prop name as [`Button`](?path=/docs/design-system-atoms-button--docs) and [`IconButton`](?path=/docs/design-system-atoms-iconbutton--docs) — the family's contracts are identical by design.
120
+
121
+ <Canvas of={DropdownButtonStories.Surface} />
122
+
123
+ ### Open per family
124
+
125
+ <Canvas of={DropdownButtonStories.Open} />
126
+
127
+ ### Motion
128
+
129
+ <Canvas of={DropdownButtonStories.Motion} />
130
+
131
+ Manifest 2.1.1 `motion`:
132
+
133
+ - **Hover / press** (`states.hover` / `states.press`) — the fill and ink ease over `--duration-hover` / `--duration-press` on `--easing-standard`, inherited from `Button`. Colour is not movement and needs no reduced-motion override.
134
+ - **Open** (`states.open`) — the caret turns 180° (down → up) on `--spring-standard` (`springs.standard` from the package tokens, in Motion; shared `internal/MotionCaret.tsx`) and back on close. A quick re-toggle turns it around mid-turn without a jerk (`interrupt`); the first paint and the server render show the current pose without a turn.
135
+ - **Loading** (`loop`) — the leading spinner turns once per `--duration-spin` on `--easing-linear`, forever (`animate-spin`, inherited from `Button`).
136
+ - **Reduced motion** — the app-root `MotionConfig reducedMotion="user"` drops the caret's transform animation, so it shows its end pose at once; colour washes switch at once; the spinner keeps turning — a loader is essential motion.
137
+
138
+ ### Compositions
139
+
140
+ <Canvas of={DropdownButtonStories.Compositions} />
141
+
142
+ ## API
143
+
144
+ <Controls />
145
+
146
+ <table>
147
+ <thead>
148
+ <tr><th>Prop</th><th>Type</th><th>Default</th><th>Description</th></tr>
149
+ </thead>
150
+ <tbody>
151
+ <tr><td><code>variant</code></td><td><code>'primary' | 'brand' | 'secondary' | 'tertiary'</code></td><td><code>'secondary'</code></td><td>Colour family.</td></tr>
152
+ <tr><td><code>size</code></td><td><code>'sm' | 'md' | 'lg'</code></td><td><code>'md'</code></td><td>Heights 32 / 40 / 44.</td></tr>
153
+ <tr><td><code>children</code></td><td><code>ReactNode</code></td><td>— (required)</td><td>Visible label = accessible name. A fixed menu noun, never a chosen value.</td></tr>
154
+ <tr><td><code>icon</code></td><td><code>ReactNode</code></td><td><code>undefined</code></td><td>Optional decorative leading icon (passed to Button's <code>leadingIcon</code>).</td></tr>
155
+ <tr><td><code>showSurface</code></td><td><code>boolean</code></td><td><code>false</code></td><td>Opaque <code>--bg-primary</code> layer under the borderless families, so the trigger stops borrowing the page colour (see Show surface).</td></tr>
156
+ <tr><td><code>open</code></td><td><code>boolean</code></td><td><code>undefined</code></td><td>Controlled open state.</td></tr>
157
+ <tr><td><code>defaultOpen</code></td><td><code>boolean</code></td><td><code>false</code></td><td>Initial open state when uncontrolled.</td></tr>
158
+ <tr><td><code>onOpenChange</code></td><td><code>(open: boolean) =&gt; void</code></td><td>—</td><td>Fires whenever the trigger requests an open/close.</td></tr>
159
+ <tr><td><code>disabled</code></td><td><code>boolean</code></td><td><code>false</code></td><td>Disabled trigger — the menu cannot open.</td></tr>
160
+ <tr><td><code>loading</code></td><td><code>boolean</code></td><td><code>false</code></td><td>Leading spinner + <code>aria-busy</code> — the menu cannot open.</td></tr>
161
+ </tbody>
162
+ </table>
163
+
164
+ All remaining native `<button>` attributes are forwarded; `ref` points at the underlying `<button>`.
165
+
166
+ ## Do / Don't
167
+
168
+ - ✅ Use it when the **whole body opens a menu of actions** — label + fixed trailing caret.
169
+ - ✅ Keep the label a **fixed menu noun** (`Akce`, `Možnosti`, `Více`) in the category form, not an imperative („Vybrat akci ▾“) — the verb-first imperatives live on the menu items.
170
+ - ✅ Let the caret speak: don't spell out „rozbalit“ / „otevřít menu“ — caret + `aria-haspopup` already announce the affordance.
171
+ - ✅ Rotate the caret 180° and set `aria-expanded` when open; re-use the Active visual (no new state).
172
+ - ✅ Use `tertiary` when the trigger sits among tertiary buttons (toolbar, bulk bar) so it doesn't out-weigh its neighbours.
173
+ - ❌ Don't use it for a control showing a **persisted chosen value** — that is a Select.
174
+ - ❌ Don't use it when one action dominates and the rest are its variants — that is a SplitButton.
175
+ - ❌ Don't group unrelated actions in one menu, and don't hide the label.
176
+ - ❌ Don't hand-roll `<Button trailingIcon={<Icon name="caret-down-small" />} aria-haspopup>` — you'll lose the open state and half the ARIA.
177
+ - ❌ Don't swap the glyph for a plain (non-small) caret — the small tier is the DS default, matching the Split trigger, Button Group and in-bar dropdowns.
178
+
179
+ ## Accessibility
180
+
181
+ - **Keyboard** — one tab stop (vs SplitButton's two). Tab focuses; **Enter / Space** activate natively and toggle the menu; **↓** opens it; **Esc** closes it. Disabled triggers are skipped by Tab.
182
+ - **ARIA** — the whole button is the trigger: `aria-haspopup="menu"` + `aria-expanded={open}` are set by the component, plus `data-state="open" | "closed"` for styling. The caret is decorative and `aria-hidden` (Button wraps icon slots). `loading` sets `aria-busy="true"`; `disabled` sets the native `disabled` attribute.
183
+ - **Screen reader** — the accessible name is the visible label; no `aria-label` needed. With `aria-haspopup="menu"` + `aria-expanded` set, screen readers announce the label together with the menu-button role and its collapsed/expanded state (exact wording differs per SR). An **icon-only** menu trigger is not this component — use `IconButton` + `aria-haspopup`, which does require an `aria-label`.
184
+ - **Focus management** — moving focus into the menu on open and returning it to the trigger on Esc is the panel's job, not this trigger's. Pass the button to [`Menu`](?path=/docs/design-system-organisms-menu--docs) as `trigger` (`<Menu trigger={<DropdownButton>Akce</DropdownButton>} items={…} />`): Menu clones it with its anchor `ref` and reference props, drives `open`, moves focus into the rows (roving tabindex) and returns it on Esc. Used standalone, the trigger toggles only its own state and `aria-expanded`.
185
+ - **Contrast** — borderless families rest on the `--secondary` ink, filled families pair their `-foreground` token (`--secondary-foreground` / `--primary-foreground`); both bindings come straight from Button, so contrast is whatever the package's `tokens.css` resolves them to. Those tokens carry the blue/700 base move, so the resting ink is the AA-safe blue/700 `#1c699b`; hover and active sit on blue/800.
186
+ - **Motion** — under `prefers-reduced-motion: reduce` the caret shows its end pose at once (no turn); the loading spinner keeps turning on purpose — a loader is essential motion. See [Motion](#motion).
187
+ - **Touch target** — ≥ 44×44 is met by `lg`; `sm` / `md` need extra hit area when used as a standalone tap target on mobile (pad the hit area, not the visual box).
188
+ - **Mobile bottom sheet (below `sm`)** — hosted by `Menu`, the trigger announces
189
+ `aria-haspopup="dialog"` instead of `menu` (the prop passed by the owner overrides the default) and
190
+ keeps `aria-expanded` in both states. The sheet is titled by the button's label; focus moves into it
191
+ and returns to this trigger on every close. See [Menu](?path=/docs/design-system-organisms-menu--docs).
192
+
193
+ Accessibility floor for every FODS component: `spec/01-foundations/accessibility.md`.
194
+
195
+ ## Copy
196
+
197
+ Voice: the canonical action-label rules shared with [`Button`](?path=/docs/design-system-atoms-button--docs) — concise, sentence case, impersonal in-app voice — with one difference: the trigger opens a list rather than firing one action, so its label is a category noun, not a verb-first imperative. The imperatives live on the menu items, each following Button's rules.
198
+
199
+ - **Label** (`children`) — a fixed noun for the *menu*, not a chosen value: `Akce`, `Možnosti`, `Více`. A label that reflects a persisted selection (`Seřadit: Nejnovější`, `Stav: Zaplaceno`) is a Select, not a Dropdown Button. It reads as the category — `Akce ▾`, not `Vybrat akci ▾`. Let the caret speak: don't spell out `rozbalit` / `otevřít menu` — the caret plus `aria-haspopup` already announce the affordance. Single line, truncates, max 16 characters; the button hugs it.
200
+
201
+ <table>
202
+ <thead>
203
+ <tr><th>Write</th><th>Not</th><th>Why</th></tr>
204
+ </thead>
205
+ <tbody>
206
+ <tr><td><code>Akce</code></td><td><code>Vybrat akci</code></td><td>Category noun, not an imperative.</td></tr>
207
+ <tr><td><code>Možnosti</code>, <code>Více</code></td><td><code>Seřadit: Nejnovější</code>, <code>Stav: Zaplaceno</code></td><td>A persisted chosen value is a Select.</td></tr>
208
+ <tr><td><code>Akce</code></td><td><code>rozbalit</code> / <code>otevřít menu</code> in the label</td><td>The caret and <code>aria-haspopup</code> carry the affordance.</td></tr>
209
+ </tbody>
210
+ </table>
211
+
212
+ ## Mobile bottom sheet
213
+
214
+ <Canvas of={DropdownButtonStories.MobileSheet} />
215
+
216
+ Below `sm` the menu this trigger opens is a bottom sheet (`dropdown-button.md` § Anatomy → Menu,
217
+ `overlay-behavior.md` § Mobile). The trigger itself does not change — `Menu` swaps the surface and the
218
+ popup type.
219
+
220
+ ## Usage
221
+
222
+ ```tsx
223
+ import { DropdownButton, Icon } from '@invoiceonline/ui-react';
224
+
225
+ // Good — the default quiet trigger in a detail header (uncontrolled)
226
+ <DropdownButton variant="secondary" size="md" onOpenChange={setMenuOpen}>
227
+ Akce
228
+ </DropdownButton>
229
+
230
+ // Good — controlled open state (standalone; inside a Menu, the Menu drives `open`)
231
+ <DropdownButton open={isOpen} onOpenChange={setIsOpen}>
232
+ Možnosti
233
+ </DropdownButton>
234
+
235
+ // Good — ghost trigger in a table bulk bar built from tertiary buttons
236
+ <DropdownButton variant="tertiary" size="sm">
237
+ Označit jako
238
+ </DropdownButton>
239
+
240
+ // Good — optional decorative leading icon
241
+ <DropdownButton size="lg" icon={<Icon name="gear" />}>
242
+ Nastavení
243
+ </DropdownButton>
244
+
245
+ // Good — loading: spinner in the leading slot, the menu cannot open
246
+ <DropdownButton loading>Načítám…</DropdownButton>
247
+ ```
248
+
249
+ ```tsx
250
+ // Don't — a label reflecting a persisted chosen value; that is a Select
251
+ <DropdownButton>Stav: Zaplaceno</DropdownButton>
252
+
253
+ // Don't — an imperative label; the control opens a category, not one action
254
+ <DropdownButton>Vybrat akci</DropdownButton>
255
+
256
+ // Don't — hand-rolled trigger; missing open state and half the ARIA
257
+ <Button trailingIcon={<Icon name="caret-down-small" />} aria-haspopup="menu">
258
+ Akce
259
+ </Button>
260
+
261
+ // Don't — one dominant action + variants of it; that is a SplitButton
262
+ <DropdownButton variant="primary">Odeslat fakturu na firma@priklad.cz</DropdownButton>
263
+ ```
264
+
265
+ ## Related
266
+
267
+ - [`Button`](?path=/docs/design-system-atoms-button--docs) — the atom this wraps (geometry, families, sizes, optical icon padding)
268
+ - [`IconButton`](?path=/docs/design-system-atoms-iconbutton--docs) — the icon-only menu trigger (`+ aria-haspopup`, requires `aria-label`)
269
+ - [`Icon`](?path=/story/design-system-atoms-icon--playground) — the DS icon set (`caret-down-small`, `gear`, …)
270
+ - `SplitButton` / `ButtonGroup` — the multi-cell siblings (default action + variants / independent actions)
271
+ - [`Menu`](?path=/docs/design-system-organisms-menu--docs) — the `role="menu"` panel this trigger opens (pass the button as `trigger`)
272
+ - `spec/03-atoms/dropdown-button.md` — upstream design spec
273
+
274
+ ## Migration notes
275
+
276
+ Notes for adopters:
277
+
278
+ - **2.0.0 — `surface` → `showSurface` (breaking).** The `Show surface` boolean's code prop is renamed so the three siblings — this trigger, [`Button`](?path=/docs/design-system-atoms-button--docs) 2.0.0 and [`IconButton`](?path=/docs/design-system-atoms-iconbutton--docs) 2.0.0 — share one prop name for one property. No alias is kept; rename the call site. No token, binding or measurement changed.
279
+ - **2.1.1 — motion audit (2026-11-03).** The caret turn moved from a CSS `transition-transform duration-150` + `rotate-180` (not suppressed under reduced motion) to Motion on `--spring-standard`: interruptible, end pose at once under reduced motion. The spinner turns on `--duration-spin` + `--easing-linear` (ui-system 0.17.0). New `Motion` story. 2.1.0 (Figma Size values renamed to `sm` / `md` / `lg`) needed no code change — the `size` prop already used them.
280
+ - **1.8.0 — disabled paint.** The disabled fill/border rebinds `--disabled` → `--disabled-control` (claudy/100, was gray/100), inherited from `Button`. `--disabled` is deprecated in `@invoiceonline/ui-system` 0.13.0.
281
+
282
+ - **Replaces hand-rolled triggers.** Any existing `<Button trailingIcon={<Icon name="caret-down-small" />}>` used as a menu trigger should become `<DropdownButton>` — you gain `aria-haspopup="menu"`, `aria-expanded`, the open state and the rotating caret for free.
283
+ - **The panel is [`Menu`](?path=/docs/design-system-organisms-menu--docs).** The `role="menu"` panel is a separate organism that takes this button as `trigger` and owns focus movement, Esc and the open state. Used without `Menu`, the trigger does not move focus anywhere — wire the panel yourself.
284
+ - **Glyph tier and naming are two different things.** The **tier** moved: `slots.caret` defaults to `caret-down-small` as of 2026-09-14, a library-wide decision that deprecated the plain `caret-*` glyphs and moved them out of the icon set's active set (icon 1.8.0). Split Button and Button Group inherit the same move through the shared `_button-segment` cell (same date), so the small caret is now the one consistent affordance across the trigger family — don't substitute the regular one. The name matches too: the React `Icon` renders `caret-down-small`; the legacy `chevron-down-small` is not an `IconName` in React — `icon-migration.json`'s alias table only tells the generator which font glyphs to keep out of the React registry.
285
+ - **Open state is not a variant axis.** In Figma the state axis is Default / Hover / Active / Disabled / Loading (Focus was removed 2026-07-03 per the focus-ring pattern); Open is a showcase example (Active + caret-180) and in code a `data-state="open"` re-emission of the Active token classes.