@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,11 @@
1
+ export {
2
+ FilterChip,
3
+ filterChipVariants,
4
+ type FilterChipProps,
5
+ type FilterChipBaseProps,
6
+ type FilterChipType,
7
+ type FilterChipEmotion,
8
+ type FilterChipSize,
9
+ type FilterChipFamily,
10
+ type FilterChipPopup,
11
+ } from './FilterChip';
@@ -0,0 +1,536 @@
1
+ import { Meta, Canvas, Controls } from '@storybook/addon-docs/blocks';
2
+ import * as FilterFacetStories from './FilterFacet.stories';
3
+
4
+ <Meta of={FilterFacetStories} tags={['autodocs']} />
5
+
6
+ # FilterFacet
7
+
8
+ ## Metadata
9
+
10
+ - **Layer:** organism
11
+ - **Status:** draft
12
+ - **Composes:** [`FilterChip`](?path=/docs/design-system-atoms-filterchip--docs) (Facet trigger) + [`PopoverSurface`](?path=/docs/design-system-patterns-popover-surface--docs) (panel chrome) + [`ListRow`](?path=/docs/design-system-atoms-listrow--docs) Small 36 (`option` rows; checkbox rows under `multiple`) + [`TextField`](?path=/docs/design-system-atoms-textfield--docs) Small 40 (optional search header) · under `multiple` also [`Checkbox`](?path=/docs/design-system-atoms-checkbox--docs) Small 16, a label-only [`Divider`](?path=/docs/design-system-atoms-divider--docs) title and, on the mobile bottom sheet only, a [`Button`](?path=/docs/design-system-atoms-button--docs) footer
13
+ - **Behaviour engine:** [`@floating-ui/react`](https://floating-ui.com/docs/react) — positioning, list navigation, typeahead, dismiss, role, transition; under `multiple` and for a searchable single facet a non-modal focus manager instead of list navigation (the searchable single facet's input drives the row cursor itself)
14
+ - **Built against:** `filter-chip` manifest `1.14.1` (the organism has no manifest of its own)
15
+ - **Tokens used:** `--bg-active`, `--bg-hover`, `--bg-primary`, `--bg-secondary`, `--border-width-100`, `--border-width-200`, `--disabled-control`, `--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`, `--outline-focus-inverse`, `--radius-200`, `--radius-300`, `--radius-400`, `--radius-500`, `--secondary`, `--secondary-active`, `--secondary-foreground`, `--secondary-hover`, `--secondary-solid`, `--shadow-overlay`, `--size-icon-small`, `--size-icon-xsmall`, `--space-100`, `--space-1000`, `--space-200`, `--space-300`, `--space-400`, `--space-500`, `--space-600`, `--space-900`, `--status-danger`, `--status-danger-foreground`, `--status-danger-hover`, `--status-danger-solid`, `--status-warning-foreground`, `--status-warning-hover`, `--status-warning-solid`, `--text-link`, `--text-link-hover`, `--text-primary`, `--text-secondary`, `--text-wrap-body`, `--z-index-dropdown`
16
+
17
+ ## Overview
18
+
19
+ **FilterFacet** is the working half of a faceted filter bar: a `FilterChip` Facet and the options
20
+ panel it opens, wired together. You pass `options`, `value` and `onValueChange`; it owns open/close,
21
+ the keyboard model, the search header, collision flip/shift and the exit transition.
22
+
23
+ It ships **two selection models**, keyed on `multiple`, because they are two incompatible ARIA and
24
+ keyboard contracts rather than one widget with a flag:
25
+
26
+ - **Single** (the default) — § Filter facet. The chip is a `role="combobox"` that points into a
27
+ `listbox` with `aria-activedescendant`; a `Vše` row comes first, and a pick commits and closes.
28
+ - **Multiple** (`multiple`) — § Multi-select filter. The chip is a plain button with
29
+ `aria-haspopup="dialog"` (`filter-chip` 1.7.0), focus moves **into** a `role="group"` of native
30
+ checkboxes, every tick is applied live and the panel stays open.
31
+
32
+ The division is the spec's, not a convenience. The **chip** is the trigger and the applied-value
33
+ display — it morphs in place from the category noun into the chosen value and grows a clearing ×.
34
+ The **panel** is a separate composition that fills the shared popover surface with rows. Neither
35
+ knows the other's internals, which is why the chip alone is a usable control in a bar that has no
36
+ panel yet.
37
+
38
+ Reach for it when a filter-bar control picks **one value out of a bounded set** whose options carry
39
+ live result counts — Kraj, Stav, Obor činnosti — and for `multiple` when several values of one facet may
40
+ apply at once, OR-ed together — Dodavatel. For a binary flag use `FilterChip` with `type="toggle"`
41
+ directly: there is nothing to open.
42
+
43
+ <Canvas of={FilterFacetStories.Playground} />
44
+ <Controls />
45
+
46
+ The Playground drives the single form: CSF args cannot resolve the `multiple` union, so the multi
47
+ form has its own stories (see [Variants](#variants)).
48
+
49
+ ## Rationale
50
+
51
+ Four things make this its own organism rather than a `Select` with a different trigger.
52
+
53
+ **The panel hugs, the field's panel does not.** A `Select` panel is never narrower than the field
54
+ that opened it, because a field has a meaningful width to fill. A chip does not — it is hug-width by
55
+ construction, so a panel matched to it would be a sliver. This one sits in the spec's compact-trigger
56
+ band instead, roughly 180 to 320.
57
+
58
+ **The trigger locks the row density.** The chip ships in two tiers, Small 32 and Medium 40, but the
59
+ panel has exactly one form: `ListRow` **Small 36** either way. That is stated in the chip's own
60
+ manifest and it is why the Matrix below shows two chip sizes opening the same panel.
61
+
62
+ **The reset lives in two places at once.** The × on an applied chip and the `Vše` row at the top of
63
+ the single panel do the same thing. Both exist because they answer the same question from different
64
+ places — one from the bar, one from inside the list — and dropping either one strands a user who is
65
+ looking in the wrong place. A `multiple` panel has no `Vše` row: unticking is the in-panel way out,
66
+ and the chip's × clears every tick at once. The panel is anchored to the trigger `<button>`, not to
67
+ the pill, so pressing × while the panel is open counts as an outside press: the panel closes first,
68
+ then the selection clears.
69
+
70
+ **Several values need a different panel, not a flag.** A `listbox` commits and closes on a single
71
+ pick, which is exactly wrong for "tick three, then keep ticking". So the multi form is the spec's
72
+ Multi-select filter — a `group` of real checkboxes that focus enters — and the chip announces that
73
+ panel as a dialog instead of a listbox. Same chip, same rows, same search header; different roles
74
+ and a different focus model.
75
+
76
+ ## Anatomy
77
+
78
+ **Single** (the default):
79
+
80
+ ```
81
+ [ ⌄ Dodavatel ] ← FilterChip, type="facet" — role="combobox", aria-haspopup="listbox"
82
+ │ aria-expanded, aria-controls, aria-activedescendant
83
+ │ ↕ --space-200 (4), bottom-start, flips on collision
84
+ ┌─────┴──────────────────────┐
85
+ │ 🔍 Hledat… │ ← header — TextField Small 40, label-less, in an 8 / 4 frame.
86
+ ├────────────────────────────┤ CONDITIONAL: only past ~5 options.
87
+ │ ✓ Vše │ ← the panel's bottom rule, added by the surface.
88
+ │ Čistota Plus 36 │ ← body — ListRow Small 36, showCount on,
89
+ │ Datacentrum Sever 24 │ one group at the 4px inset
90
+ │ Pekárna Růžička 19 │
91
+ │ Beta Servis 0 │ ← zero renders; the row goes Disabled, never hidden
92
+ └────────────────────────────┘
93
+ width: hug, min ~180 / max ~320 — never the trigger's width
94
+ ```
95
+
96
+ **Multiple** (`multiple`):
97
+
98
+ ```
99
+ [ ▣ Čistota Plus +2 × ] ← FilterChip, type="facet", popup="dialog" — plain <button>,
100
+ │ aria-haspopup="dialog", aria-expanded, aria-controls (while open)
101
+ │ ↕ --space-200 (4), bottom-start, flips on collision
102
+ ┌─────┴──────────────────────┐ role="group", aria-labelledby → title (+ hidden count text)
103
+ │ 🔍 Hledat… │ ← header — the same search field and frame as single
104
+ ├────────────────────────────┤
105
+ │ Dodavatel (3) │ ← title — label-only Divider, "(N)" only while N ≥ 1
106
+ │ ☑ Čistota Plus 36 │ ← ListRow Small 36 + Checkbox Small 16 in the leading slot;
107
+ │ ☑ Datacentrum Sever 24 │ the row text is a native <label htmlFor> to the checkbox
108
+ │ ☑ Pekárna Růžička 19 │
109
+ │ ☐ Alfa Obchod 11 │
110
+ │ ☐ Gama Telekom 0 │ ← zero → a genuinely disabled checkbox; the row stays
111
+ └────────────────────────────┘ ← no footer: every tick is already applied
112
+ ```
113
+
114
+ The anchored multi panel has no footer. The „Hotovo“ footer (`doneLabel`) belongs to the mobile
115
+ bottom sheet only, see Accessibility → Mobile bottom sheet.
116
+
117
+ With fewer than about five options there is **no header and no divider**. The rule is the placement
118
+ law rather than a style preference: the divider's job is to separate the header from the rows, so
119
+ with nothing above them there is nothing to separate. The multi title is a **label-only** divider for
120
+ the same law — a line may never open the body.
121
+
122
+ **The search frame is the one exception to the 16px content column.** It pads `--space-400` (8)
123
+ horizontally and `--space-200` (4) vertically. The surface has no horizontal padding, a flat 4 top and
124
+ bottom, and a 4 gap between header, divider and body, so the field's **box** sits 8 from the panel edge
125
+ on top, left and right and 8 above the divider below it — the spec's "Search header frame padding"
126
+ row. Every other header/footer frame lands its content on the 16 column; this one aligns the field's
127
+ box, not its text. The frame lives in the organism, not in the generic header slot, and is the same in
128
+ both modes.
129
+
130
+ ## Variants
131
+
132
+ The assembly has no variant axis of its own. What varies is the chip's selection, which the applied
133
+ value drives, whether the panel carries a search header, which the option count drives, and the
134
+ selection model, which `multiple` picks.
135
+
136
+ <Canvas of={FilterFacetStories.Matrix} />
137
+
138
+ ### Multiple
139
+
140
+ <Canvas of={FilterFacetStories.MultiSelect} />
141
+
142
+ Each toggle emits the **whole** new array through `onValueChange`, live, and the panel stays open. The
143
+ array keeps **pick order**: a newly ticked value is appended, so the chip's leading value is the first
144
+ one applied and does not jump when an earlier option is ticked later. The chip shows the values in that
145
+ order, collapsing to `Čistota Plus +2` with the rest in `FilterChip`'s remainder Tooltip — which needs a
146
+ **`TooltipProvider` ancestor**. The chip's × emits `[]`.
147
+
148
+ ## Sizes
149
+
150
+ `size` sets the **chip** tier only — Small 32 or Medium 40, matching the bar around it. The panel
151
+ does not follow. Its rows are Small 36 and its surface padding is the flat 4/4 under both. Under
152
+ `multiple` the checkbox is matched to that row — Small 16, never scaled.
153
+
154
+ <Canvas of={FilterFacetStories.ShortFacet} />
155
+
156
+ ## States
157
+
158
+ **Single.** Row states come from `ListRow`: Default, Hover, Highlighted, Selected and Disabled.
159
+ Exactly one row is selected at a time, and it is marked by `ListRow`'s solid **`--bg-secondary`
160
+ Selected fill plus the leading checkmark** in `--secondary` (list-row 2.7.0); `aria-selected="true"`
161
+ carries the state for assistive tech. The label stays Regular: **no bolding, no recolour**.
162
+
163
+ Keyboard-current rows render the same `--bg-hover` wash as pointer hover — one visual for one
164
+ meaning, whichever device produced it — and on the chosen row the wash layers over the Selected
165
+ fill. The owner ruling of list-row 2.7.0 (2026-10-20) reverses an earlier design-QA build,
166
+ which had dropped the fill so the wash stayed the only one in the panel; see Migration notes.
167
+
168
+ **Multiple.** A checkbox row uses Default, Hover and Disabled; checked is read off the **checkbox**,
169
+ so `ListRow`'s Selected fill is never used and there is no checkmark — the box is the only selection
170
+ indicator, and the label stays Regular. The row never takes focus itself: the focus ring is the
171
+ checkbox's own, and the keyboard-current row gets the hover wash through CSS `:has(:focus-visible)`
172
+ (`has-[:focus-visible]:before:opacity-100`) while its checkbox holds keyboard focus. A zero-count or
173
+ `disabled` option renders a genuinely `disabled` checkbox — out of the tab order — and the row stays
174
+ visible, so the option set does not shift.
175
+
176
+ <Canvas of={FilterFacetStories.ZeroCounts} />
177
+
178
+ ## Counts
179
+
180
+ A count answers **"how many rows would I get if I applied this"**. Three rules follow from that
181
+ sentence and all three are easy to get wrong:
182
+
183
+ - **Zero renders.** It is an answer, not an absence, so the row stays and goes Disabled. A row that
184
+ disappears makes the user hunt for an option that is simply empty right now.
185
+ - **Counts belong to the rows, never to an unselected chip.** A category is not appliable, so the
186
+ number on it would only ever be the unfiltered total. `FilterChip` enforces this structurally —
187
+ a Facet renders no count node at all.
188
+ - **An option's count is computed against the OTHER facets only.** Never against this facet's own
189
+ pick — or, under `multiple`, its own ticks. Counting against its own selection zeroes every sibling
190
+ the moment one supplier is chosen, and the filter reads as broken. The counts are the consumer's
191
+ job; the organism only renders what `options[].count` carries.
192
+
193
+ <Canvas of={FilterFacetStories.Searchable} />
194
+
195
+ ## Search
196
+
197
+ The header appears from roughly **five** options. Below that the rows are faster to scan than to
198
+ type, and the spec's Do/Don't forbids a search input on a two- or three-option facet — a dev warning
199
+ fires in both directions.
200
+
201
+ The input is a label-less `TextField` Small 40 with a leading `magnifying-glass` glyph, pinned above the scroll
202
+ region, in the 8 / 4 frame described under [Anatomy](#anatomy). It is the same in both modes.
203
+ Matching folds diacritics, so `ruzicka` finds `Pekárna Růžička`. In single mode the `Vše` row is never
204
+ filtered out: it is not one of the options, it is the way out of an applied filter. Under `multiple`
205
+ the query only hides rows — a ticked value that does not match stays applied. Closing the panel clears
206
+ the query — re-opening to a stale filter would hide rows the user never chose to hide.
207
+
208
+ ## Sorting
209
+
210
+ Sort rows by count, descending, **only where the option set has no order of its own.** A supplier
211
+ list qualifies. A period does not — it runs newest to oldest — and neither does a status, which runs
212
+ paid to overdue. Re-sorting either by number destroys the information the sequence itself carries.
213
+
214
+ ## API
215
+
216
+ `FilterFacetProps` is a union discriminated on `multiple` — `FilterFacetSingleProps` |
217
+ `FilterFacetMultipleProps`, both exported. The props a form does not accept are type errors, not
218
+ silently ignored values.
219
+
220
+ <table>
221
+ <thead>
222
+ <tr><th>Prop</th><th>Form</th><th>Type</th><th>Note</th></tr>
223
+ </thead>
224
+ <tbody>
225
+ <tr><td><code>label</code></td><td>both</td><td><code>string</code></td><td>Required. The category noun on the chip; under <code>multiple</code> also the panel's title and the group's name.</td></tr>
226
+ <tr><td><code>options</code></td><td>both</td><td><code>FilterFacetOption[]</code></td><td>Required. <code>value</code>, <code>label</code>, optional <code>count</code>, <code>disabled</code>, <code>testId</code>. A <code>count</code> of <code>0</code> disables the row.</td></tr>
227
+ <tr><td><code>clearLabel</code></td><td>both</td><td><code>string</code></td><td>Required. The chip ×'s accessible name.</td></tr>
228
+ <tr><td><code>search</code></td><td>both</td><td>object: <code>label</code>, <code>placeholder?</code>, <code>emptyLabel</code></td><td>Opt-in search header. <code>label</code> names the label-less input, <code>emptyLabel</code> shows when the query matches nothing.</td></tr>
229
+ <tr><td><code>size</code></td><td>both</td><td><code>'sm' | 'md'</code></td><td>Chip tier only; default <code>'md'</code>.</td></tr>
230
+ <tr><td><code>leadingIcon</code></td><td>both</td><td><code>IconName | null</code></td><td>Forwarded to the chip.</td></tr>
231
+ <tr><td><code>disabled</code></td><td>both</td><td><code>boolean</code></td><td>Disables the chip (trigger and ×), so the panel cannot open.</td></tr>
232
+ <tr><td><code>className</code>, <code>data-testid</code></td><td>both</td><td><code>string</code></td><td>Land on the chip.</td></tr>
233
+ <tr><td><code>multiple</code></td><td>single</td><td><code>false</code> (optional)</td><td>Omit for the single form.</td></tr>
234
+ <tr><td><code>value</code></td><td>single</td><td><code>string</code></td><td>The applied value; the chip shows that option's label.</td></tr>
235
+ <tr><td><code>onValueChange</code></td><td>single</td><td><code>(value: string | undefined) =&gt; void</code></td><td>The picked value, or <code>undefined</code> from <code>Vše</code> or the ×.</td></tr>
236
+ <tr><td><code>allLabel</code></td><td>single</td><td><code>string</code></td><td>Required. The reset row's text. Not accepted under <code>multiple</code>, which has no reset row.</td></tr>
237
+ <tr><td><code>multiple</code></td><td>multiple</td><td><code>true</code></td><td>Required to pick the multi form.</td></tr>
238
+ <tr><td><code>value</code></td><td>multiple</td><td><code>string[]</code></td><td>The applied values, OR-ed together, in pick order.</td></tr>
239
+ <tr><td><code>onValueChange</code></td><td>multiple</td><td><code>(value: string[]) =&gt; void</code></td><td>Fired live on every toggle with the whole new array; <code>[]</code> from the ×.</td></tr>
240
+ <tr><td><code>selectedCountLabel</code></td><td>multiple</td><td><code>(count: number) =&gt; string</code></td><td>Required. The checked count as words for assistive tech (<code>Vybráno 2</code>). On the anchored panel (from <code>sm</code> up) it is part of the group's name; on the mobile bottom sheet it is the group's description and what the sheet's live region speaks. Called only for a count of 1 and up.</td></tr>
241
+ <tr><td><code>doneLabel</code></td><td>multiple</td><td><code>string</code></td><td>Default <code>'Hotovo'</code>. The label of the button in the mobile bottom sheet's footer, which only <strong>closes</strong> the sheet — it never commits, because every tick was already applied. The anchored panel from <code>sm</code> up has no footer and ignores it.</td></tr>
242
+ <tr><td><code>sheetCloseLabel</code></td><td>both</td><td><code>string</code></td><td>Default <code>'Zavřít'</code>. The name of the mobile bottom sheet's visually hidden close button.</td></tr>
243
+ </tbody>
244
+ </table>
245
+
246
+ The required strings — `label`, `clearLabel`, `allLabel`, `selectedCountLabel` and the strings inside
247
+ `search` — have no default. This organism ships on nine markets and has no locale of its own; a fallback string would
248
+ announce Czech on the PL, SK or EN sites. The caller translates them — and `selectedCountLabel` is a
249
+ function precisely so numeral agreement stays the locale's business — the same contract `FilterChip`
250
+ already carries for `clearLabel`.
251
+
252
+ The two strings of the mobile bottom sheet, `sheetCloseLabel` and `doneLabel`, are optional and fall
253
+ back to Czech („Zavřít“, „Hotovo“). They are locale texts: an app with more than one language version
254
+ passes both from its translations on every use. The full list of such props is in
255
+ [Consuming → Texts and locale](?path=/docs/getting-started-consuming--docs#texts-and-locale).
256
+
257
+ ## Do / Don't
258
+
259
+ <table>
260
+ <thead>
261
+ <tr><th>✓ Do</th><th>✗ Don't</th></tr>
262
+ </thead>
263
+ <tbody>
264
+ <tr><td>Put <code>Vše</code> first, as the single facet's reset</td><td>Bury the reset among the value rows, or leave it out</td></tr>
265
+ <tr><td>Show the search header once the options outgrow scanning</td><td>Add a search input to a two- or three-option facet</td></tr>
266
+ <tr><td>Mark the chosen row with the Selected fill plus a leading <code>--secondary</code> checkmark (single)</td><td>Bold or recolour the selected row's label to show the choice</td></tr>
267
+ <tr><td>Commit and close on pick (single)</td><td>Leave the panel open after a single-select commit</td></tr>
268
+ <tr><td>Keep the panel open and apply every tick live (<code>multiple</code>)</td><td>Close the panel on a tick, or make <code>doneLabel</code> the moment the filter applies</td></tr>
269
+ <tr><td>Let the checkbox be the only selection indicator (<code>multiple</code>)</td><td>Add a checkmark or a Selected fill to a checked row</td></tr>
270
+ <tr><td>Render a zero count and disable the row</td><td>Hide an option that currently returns nothing</td></tr>
271
+ <tr><td>Let the chip show the applied value</td><td>Prefix it with the category — the morph replaces the label, it does not annotate it</td></tr>
272
+ </tbody>
273
+ </table>
274
+
275
+ ## Accessibility
276
+
277
+ ### Single
278
+
279
+ Two shapes, keyed on whether the panel carries the search header (`filter-chip` 1.9.0
280
+ `delivery.react`).
281
+
282
+ **Without search** — the trigger is the chip's own `<button role="combobox" aria-haspopup="listbox" aria-expanded>`, with
283
+ `aria-controls` pointing at the listbox while it is open. The panel is a `listbox` named by
284
+ `aria-label` = `label`, its rows are `option` with `aria-selected`, and **DOM focus never leaves the
285
+ trigger** — the current row is pointed at by `aria-activedescendant`, the virtual-focus model a
286
+ trigger that must keep focus requires. Since `filter-chip` 1.6.0 that is also what the spec says.
287
+
288
+ The role is written by `FilterChip` itself, not stamped by floating-ui, so a Facet announces the same
289
+ whoever mounts it. A combobox takes no name from its content, so the trigger is named by an
290
+ `aria-label`: the category (*"Dodavatel"*), or the category plus the applied value (*"Dodavatel:
291
+ Čistota Plus"*).
292
+
293
+ That wiring lands on the trigger button through `triggerProps`, not on the chip's root. The root is a
294
+ plain `<span>`, and `aria-activedescendant` is only read on the element that actually holds focus.
295
+
296
+ Keyboard: Enter, Space or ↓ / ↑ opens; ↑ ↓ move the highlight; Home and End jump; Enter or Space commits and
297
+ closes; Esc closes and returns focus to the trigger. Typing jumps to a matching row.
298
+
299
+ **With search** — the Combobox (search) pattern (`filter-chip` 1.8.0 focus model, 1.9.0 roles). The
300
+ chip trigger is a plain `<button aria-haspopup="listbox" aria-expanded>` (`FilterChip searchable`):
301
+ no `combobox` role, no `aria-activedescendant`. Opening moves **DOM focus into the search input**,
302
+ and the input is the combobox: `role="combobox"`, `aria-expanded`, `aria-autocomplete="list"`,
303
+ `aria-controls` pointing at the listbox and `aria-activedescendant` pointing at the highlighted
304
+ option. Because the input sits inside the panel, the panel is a `dialog` and the rows group below the
305
+ search header is the `listbox` (a listbox may own only options and groups), named by `label`. The
306
+ input owns the keys — the same handler `Combobox` uses: ↑ ↓ move the highlight, Home and
307
+ End jump, Enter commits the highlighted option and closes, Esc closes; in both cases focus returns
308
+ to the **chip trigger**, which is not a persistent input the way a Combobox field is. Typing narrows
309
+ the rows and re-seats the highlight on the first enabled match, so Enter after typing commits what
310
+ was searched for; with an empty query the highlight starts on the applied row (else `Vše`). A rows
311
+ change under an unchanged query — a parent re-rendering with a fresh but equal `options` array, or
312
+ a count update — keeps the highlight on the same option by value, and only re-seats it when that
313
+ option is gone or disabled, so Enter still commits the row reached with ↓. Enter, Space or ↓ / ↑
314
+ on the closed chip open the panel.
315
+
316
+ Focus returns to the trigger **button**: the floating reference is the button inside the pill, while
317
+ the panel is still positioned against the whole pill (`setPositionReference` on the root `<span>`).
318
+ Registering the span as the reference — as before — sent focus nowhere on close, because the span is
319
+ not focusable.
320
+
321
+ A disabled row carries `aria-disabled` and is skipped by navigation rather than removed, so the
322
+ sequence a screen-reader user hears matches what is on screen.
323
+
324
+ ### Multiple
325
+
326
+ The trigger is a **plain** `<button aria-haspopup="dialog" aria-expanded>` — `FilterChip` with
327
+ `popup="dialog"`, `filter-chip` 1.7.0. It has no `combobox` role and no `aria-activedescendant`;
328
+ `aria-controls` points at the panel while it is open. The accessible name is the same string as in
329
+ single mode: the category followed by every applied value (*"Dodavatel: Čistota Plus, Datacentrum Sever,
330
+ Pekárna Růžička"*).
331
+
332
+ The panel is `role="group"`, named by `aria-labelledby` pointing at the title divider's label — and,
333
+ from one ticked row up, also at a hidden node holding `selectedCountLabel(n)`, so the group reads
334
+ *"Dodavatel Vybráno 2"* and the visual `(2)` is never the only carrier of how many filters are active.
335
+ Each row is a real `<input type="checkbox">` (`Checkbox` Small) whose name comes from the row text, a
336
+ native `<label htmlFor>` pointing at it; clicking the text toggles the box.
337
+
338
+ Keyboard: Enter or Space on the chip opens the panel and **focus moves in** — onto the search field
339
+ when there is one, else the first enabled checkbox. Tab / Shift-Tab walk the controls in DOM order,
340
+ Space toggles the focused checkbox and the panel stays open; there are no arrow keys and no typeahead,
341
+ because these are independent form controls, not a single-selection list. Esc closes and returns
342
+ focus to the chip. The focus manager is non-modal: there is **no focus trap** — it is a `group`, not a
343
+ modal dialog.
344
+
345
+ ### Mobile bottom sheet (below `sm`)
346
+
347
+ Below `sm` a list facet opens a bottom sheet instead of the anchored panel (`overlay-behavior.md` §
348
+ Mobile; `filter-chip` § Accessibility). The sheet is a modal `dialog` (`aria-modal`, page `inert`)
349
+ titled by the facet `label`; Esc, the scrim, a drag down and the hidden „Zavřít“ button close it, and
350
+ focus returns to the **chip trigger**. The trigger is a plain `<button aria-haspopup="dialog"
351
+ aria-expanded>` in every form — no `combobox` role, no `aria-activedescendant`. A Range facet is not
352
+ a list facet and stays anchored. 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).
353
+
354
+ - **Single without search** — the rows are a `listbox` named by `label`, `Vše` first, each row an
355
+ `option` with `aria-selected`; DOM focus moves onto the applied row (else `Vše`) and arrows, Home and
356
+ End move it roving-tabindex style; Enter or Space commits and closes. The applied row carries the
357
+ Selected fill and a trailing check after the count.
358
+ - **Single with search** — the search row at the top of the sheet is the combobox: focus moves into
359
+ it, it owns `role="combobox"`, `aria-controls`, `aria-activedescendant` and the same keys as
360
+ `Combobox`'s sheet; it is labelled by the sheet title.
361
+ - **Multiple** — the multi-select filter sheet. Every row is a native checkbox and focus moves onto
362
+ the first enabled checkbox, not the search row; the search input is named by `search.label`.
363
+ - *Title and names.* The sheet title is the facet `label` followed by ` (N)` while N ≥ 1 boxes are
364
+ ticked — `Dodavatel (2)`, bare `Dodavatel` at zero. The `(N)` sits in an `aria-hidden` span, so
365
+ the dialog's accessible name stays the bare label.
366
+ - *Group.* The rows are a `role="group"` with `aria-labelledby` pointing at the sheet title, so it
367
+ is named by the same bare label. The sheet's single row group renders no label and no count of its
368
+ own: a divider under the header would only repeat the title.
369
+ - *Count on entry.* From N ≥ 1 the group also carries `aria-describedby` pointing at a `hidden`
370
+ `<span id>` holding `selectedCountLabel(N)`, so a screen reader hears the count with the bare
371
+ group name when the sheet opens — `Dodavatel`, described as „Vybráno 2“. At N = 0 neither the span
372
+ nor `aria-describedby` is rendered.
373
+ - *Live region.* A visually hidden `role="status" aria-live="polite"` node
374
+ (`data-fods-part="live-count"`) speaks the total as `selectedCountLabel(N)` — „Vybráno 3“ in the
375
+ stories. It waits `curves.duration.slow` after the last tick, so each settled change is spoken
376
+ once: ticks that land closer together than that delay are spoken only as their final total. It
377
+ is silent on open, since the count the sheet opened with is already the group's description, and
378
+ silent at N = 0, where the unticked checkbox has already announced itself. Each checkbox
379
+ announces its own state; the region carries only the total.
380
+ - *Footer.* The sheet always renders a fixed footer (`data-fods-part="footer-action"`) holding a
381
+ full-width Primary `Button` `lg` labelled by `doneLabel` (default „Hotovo“). It is the sheet's one
382
+ closing action and only closes — every tick is already applied. Esc, the scrim, a drag down and
383
+ „Zavřít“ close it as well.
384
+ - *Safe area.* The footer pads `--space-600` on the top and sides and `--space-600` plus the bottom
385
+ safe-area inset below. A sheet without a footer — the single forms — keeps `--space-800` plus the
386
+ bottom inset under its last row instead. Row groups are inset by the larger of `--space-400` and
387
+ the left / right safe-area inset.
388
+
389
+ ### a11y floor
390
+
391
+ The rows of the FODS a11y floor (`spec/01-foundations/accessibility.md`) that apply, per form.
392
+
393
+ <table>
394
+ <thead>
395
+ <tr><th>Floor row</th><th>Single</th><th>Multiple</th></tr>
396
+ </thead>
397
+ <tbody>
398
+ <tr><td>A role without visible text has a name enforced in TypeScript</td><td>✓ <code>listbox</code> gets <code>aria-label</code> from the required <code>label</code></td><td>✓ <code>group</code> gets <code>aria-labelledby</code> to the title rendered from the required <code>label</code></td></tr>
399
+ <tr><td>Checkbox / selection</td><td>✓ <code>aria-selected</code> on every <code>option</code> inside the listbox</td><td>✓ native <code>&lt;input type="checkbox"&gt;</code> + a native <code>&lt;label htmlFor&gt;</code></td></tr>
400
+ <tr><td><code>aria-expanded</code> explicit <code>"false"</code> when closed</td><td>✓ written by <code>FilterChip</code> from <code>open</code></td><td>✓ the same</td></tr>
401
+ <tr><td>Counter / status text</td><td>— no checked count; per-row counts are row content</td><td>✓ the count text has an <code>id</code> and is in the group's name via <code>aria-labelledby</code> — the first of the two options § Multi-select filter allows. On the mobile bottom sheet the group keeps the bare name; the count text has its own <code>id</code> and is the group's description via <code>aria-describedby</code> (N ≥ 1 only), and a polite <code>role="status"</code> region (<code>data-fods-part="live-count"</code>) speaks each settled change of the total</td></tr>
402
+ <tr><td>Disabled</td><td>✓ a disabled row is <code>aria-disabled</code>, <code>--disabled-foreground</code>, skipped by navigation</td><td>✓ a genuinely <code>disabled</code> input, out of the tab order, <code>--disabled-foreground</code> on the row</td></tr>
403
+ <tr><td>Disabled composite</td><td colSpan="2">✓ <code>disabled</code> reaches the chip's trigger and × as the native attribute plus <code>aria-disabled</code>, so the panel cannot be opened and the value cannot be cleared</td></tr>
404
+ <tr><td>Icon-only control / decorative icons</td><td colSpan="2">✓ the × is named by the required <code>clearLabel</code>; every glyph (caret, leading, checkmark, search) goes through <code>Icon</code> with <code>aria-hidden</code></td></tr>
405
+ <tr><td>Focus is visible</td><td>✓ the chip's offset ring — focus never leaves it without search; with search the input's own focus treatment while open, the chip's ring again after close</td><td>✓ the checkbox's own <code>:focus-visible</code> ring and the search field's; never on the row</td></tr>
406
+ <tr><td><code>aria-live</code> on a list</td><td>— no live region; the empty-search text is a plain paragraph</td><td>— no live region on the anchored panel; the empty-search text is a plain paragraph. The mobile bottom sheet adds one <code>role="status"</code> region for the checked total, outside the row group</td></tr>
407
+ </tbody>
408
+ </table>
409
+
410
+ The search field has no visible label by spec; it is named by `aria-label` from the required
411
+ `search.label`.
412
+
413
+ Accessibility floor for every FODS component: `spec/01-foundations/accessibility.md`.
414
+
415
+ ## Mobile bottom sheet
416
+
417
+ <Canvas of={FilterFacetStories.MobileSheet} />
418
+
419
+ At a 390 viewport each list facet opens the bottom sheet described under Accessibility → Mobile bottom
420
+ sheet: a single facet (Stav), a searchable single facet (Odběratel) and a multiple facet
421
+ (Dodavatel) with three suppliers ticked, so its sheet opens titled `Dodavatel (3)` above the
422
+ „Hotovo“ footer. The story's `play` opens the Dodavatel sheet, checks that the dialog is named by
423
+ the bare `Dodavatel` and closes it with „Hotovo“. The docs column is wider than `sm`; open the story
424
+ in the canvas to see the sheet.
425
+
426
+ ## Usage
427
+
428
+ <Canvas of={FilterFacetStories.FilterBar} />
429
+
430
+ Within one facet the values OR together; across facets they AND. The bar above has both: Kraj and
431
+ Stav are single facets, Dodavatel is `multiple`. Per-row counts are the consumer's job, computed
432
+ against the other facets only.
433
+
434
+ The bar-level reset that clears every facet at once is a **Tertiary Button beside the chips**, not a
435
+ facet affordance. It is also the only way to clear a facet that has gone Disabled while applied.
436
+
437
+ ```tsx
438
+ import { FilterFacet, TooltipProvider } from '@invoiceonline/ui-react';
439
+
440
+ // Good — single: commit and close, Vše first
441
+ <FilterFacet
442
+ size="sm"
443
+ label="Stav"
444
+ leadingIcon="funnel-simple"
445
+ options={statuses} // ordered paid → overdue, not by count
446
+ value={filters.status}
447
+ onValueChange={status => setFilters(prev => ({ ...prev, status }))}
448
+ allLabel={t('filters.all')}
449
+ clearLabel={t('filters.clear', { facet: 'Stav' })}
450
+ />
451
+
452
+ // Good — multiple: live array, chip collapses to "Čistota Plus +2"
453
+ <TooltipProvider>
454
+ <FilterFacet
455
+ multiple
456
+ size="sm"
457
+ label="Dodavatel"
458
+ leadingIcon="buildings"
459
+ options={suppliers} // counts computed against the OTHER facets
460
+ value={filters.suppliers} // string[], pick order
461
+ onValueChange={suppliers => setFilters(prev => ({ ...prev, suppliers }))}
462
+ clearLabel={t('filters.clear', { facet: 'Dodavatel' })}
463
+ selectedCountLabel={count => t('filters.selectedCount', { count })}
464
+ doneLabel={t('filters.done')} // the mobile sheet's closing button
465
+ search={{
466
+ label: t('filters.searchSupplier'),
467
+ placeholder: t('filters.searchPlaceholder'),
468
+ emptyLabel: t('filters.noSupplier'),
469
+ }}
470
+ />
471
+ </TooltipProvider>
472
+ ```
473
+
474
+ ```tsx
475
+ // Don't — allLabel on a multiple facet; there is no reset row (type error)
476
+ <FilterFacet multiple allLabel="Vše" ... />
477
+
478
+ // Don't — count an option against this facet's own ticks; siblings zero out
479
+ options={suppliers.map(s => ({ ...s, count: countWith({ ...filters, suppliers: [s.value] }) }))}
480
+
481
+ // Don't — hardcode the strings; this organism ships on nine markets
482
+ <FilterFacet multiple selectedCountLabel={n => `Vybráno ${n}`} ... />
483
+ ```
484
+
485
+ ## Related
486
+
487
+ - [`FilterChip`](?path=/docs/design-system-atoms-filterchip--docs) — the trigger on its own; use it
488
+ directly for a Toggle flag, which opens nothing. Its `popup` prop is what this organism sets to
489
+ `dialog` under `multiple`
490
+ - [`Checkbox`](?path=/docs/design-system-atoms-checkbox--docs) — the native input in every
491
+ `multiple` row, at Small 16
492
+ - [`Select`](?path=/docs/design-system-organisms-select--docs) — the same substrate under a field
493
+ trigger; its panel matches the field width and its rows follow the trigger density
494
+ - [`Menu`](?path=/docs/design-system-organisms-menu--docs) — for commands (verbs), not values
495
+ - [`Chip`](?path=/docs/design-system-atoms-chip--docs) — the 22/30 tag tier, whose selection lives in
496
+ a checkbox and whose pill never recolours
497
+
498
+ ## Migration notes
499
+
500
+ New composition — no product screen renders it yet.
501
+
502
+ **`filter-chip` 1.6.0 / 1.7.0 (2026-10-05).** 1.6.0 rewrote the spec's Facet trigger to
503
+ `role="combobox"` + `aria-haspopup="listbox"` + `aria-expanded` — what this build already shipped
504
+ (team decision after designer QA, 2026-09-29), so the deviation this page used to record is closed
505
+ and the single form did not change. 1.7.0 decided how a facet that opens a `group` announces itself:
506
+ a plain `<button aria-haspopup="dialog" aria-expanded>`, no `aria-activedescendant`, focus moves into
507
+ the panel. That unblocked `multiple`, which this page previously listed as deliberately not built.
508
+ For a single-form caller nothing changes; `multiple` is additive.
509
+
510
+ **`filter-chip` 1.8.0 / 1.9.0 (2026-10-08).** A single-value facet **with search** follows the
511
+ Combobox (search) pattern: focus moves into the search input, which takes `role="combobox"` and the
512
+ `aria-activedescendant` wiring, and the chip trigger becomes a plain listbox button; Enter / Esc / a
513
+ click on a row return focus to the trigger. After the × clears, focus lands on the same chip's
514
+ trigger. Without search nothing changes. The × focus ring is now structured in the manifest as
515
+ `chrome.clear.focus.ring = --outline-focus-inverse`; the chip already bound it.
516
+
517
+ **`list-row` 2.7.0 (2026-10-20, owner ruling).** The single facet's chosen row takes the
518
+ `ListRow` Selected fill (`--bg-secondary`) again, next to its checkmark — the design-QA build
519
+ (2026-10-12) had dropped the fill. The checkmark is `--secondary` (blue) at every size: leading on
520
+ the anchored panel (was `--text-secondary`), trailing on the bottom sheet (was `--text-primary`).
521
+
522
+ **`filter-chip` 1.11.2 → 1.14.1.** 1.11.2 takes Období out of the facets — it is a Select Field — so
523
+ the stories show Kraj instead. 1.14.0 adds the optional `sheetCloseLabel`, the name of the bottom
524
+ sheet's hidden close button. 1.12.0, 1.13.0, 1.13.1 and 1.14.1 change nothing here: the icon rule is
525
+ docs-only, the status and the caret motion are the chip's own, and 1.14.1 only renames copy examples.
526
+
527
+ ### Known limitations
528
+
529
+ - **The facet title does not become sticky on scroll.** § Multi-select filter moves the title of a
530
+ facet whose rows pass the cap into a sticky header frame; here the title stays a label-only divider
531
+ inside the scroll body, so it scrolls away with the rows.
532
+ - **The keyboard-current row wash is CSS.** Under `multiple` the row is washed through
533
+ `:has(:focus-visible)` on the checkbox it holds, not by the substrate's highlight state.
534
+ - **A numeric range facet is not built.** `filter-chip.manifest.json` `intent.rules[7]` puts a Field
535
+ Pair in the panel with the unit stated once and the applied bounds pre-filled on re-open. It has no
536
+ section in `popover-patterns.md` yet.