@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,732 @@
1
+ "use client";
2
+ import * as React from 'react';
3
+ import { tv, type VariantProps } from '../../internal/tailwind-variants';
4
+ import { Icon, type IconName, type IconSize } from '../icon/Icon';
5
+ import { Tooltip } from '../tooltip/Tooltip';
6
+ import { cn, suppressDisabledClick } from '../../internal/utils';
7
+
8
+ /**
9
+ * Chip — the INTERACTIVE tag family (upstream spec `03-atoms/chip.md`, manifest
10
+ * 1.8.1). Three types in one set:
11
+ *
12
+ * - **Basic** — a plain filter tag: pill + label, the whole chip is the click
13
+ * target (e.g. a lightweight filter above a table). With `href` it is a LINK
14
+ * instead (manifest 1.7.3 `delivery.react`: "an <a href> when it leads
15
+ * somewhere … no ⓘ") — the article's category chips; a Basic that only filters
16
+ * stays a `<button>`.
17
+ * - **Selectable** — a filter / toggle chip. Selection is carried by a LEADING
18
+ * checkbox; the pill stays a soft status tint. This is the invoice-list status
19
+ * filter (Zaplaceno / Nezaplaceno / Po splatnosti / Budoucí).
20
+ * - **Deleteable** — a removable tag the user dismisses via a trailing ×.
21
+ *
22
+ * Anatomy:
23
+ * - **Pill** — chrome (fill + text per emotion × state, radius, gap) and PADDING
24
+ * come from the shared `06-patterns/pill.md` recipe, the same one Badge builds
25
+ * on. Padding follows Button and is per-size: the affordance side (leading
26
+ * checkbox / trailing ×) steps down ONE further spacing step in code; Basic has
27
+ * no affordance, so it is a compact symmetric `--space-300` at both sizes.
28
+ * - **Leading icon** (Deleteable · Basic, optional — manifest 1.7.0 `slots.leading-icon`)
29
+ * — a glyph before the label at `sizes[].icon` (16 / 14), ink = the label's via
30
+ * currentColor, decorative (`Icon` renders `aria-hidden`). Not on Selectable: its
31
+ * checkbox is the leading element. Like Badge's glyph it is a leading affordance
32
+ * side for the Pill padding rule, so Deleteable's left padding steps down with it;
33
+ * Basic stays at its compact symmetric `--space-300`.
34
+ * - **Label** — `Body/S/Semibold` (md) / `Body/XXS/Semibold` (sm), 1–2 words,
35
+ * truncated on overflow (a chip is a status, not a sentence).
36
+ * - **Checkbox** (Selectable) — a nested Checkbox at size S (16px box) in BOTH
37
+ * sizes; never scale it (scaling gives an off-grid border).
38
+ * - **ⓘ** (Selectable · Basic, optional) — a Tooltip trigger after the label. Composition
39
+ * by reference: the Chip does not own the tooltip, it attaches one.
40
+ * - **×** (Deleteable) — a real `<button>` carrying a caller-supplied
41
+ * `removeLabel`, the click target, with a ≥24×24 hit area even though the glyph
42
+ * is 14–16px.
43
+ *
44
+ * **The two icon-only controls take their accessible name from a REQUIRED prop.**
45
+ * The upstream spec writes the × as `<button aria-label="Odebrat {label}">` and the
46
+ * manifest repeats it, but that is spec prose for a Czech product, not a licence
47
+ * for a built-in default: this atom has no locale of its own and ships on ten
48
+ * markets, so a `?? 'Odebrat …'` fallback would announce Czech to every
49
+ * screen-reader user on the PL / SK / EN sites that forgot to pass one. Both names are
50
+ * therefore required at the TYPE level and come from the consumer's translation layer:
51
+ * `removeLabel` through the `type`-keyed union below, and the ⓘ name by travelling
52
+ * inside the `info` pair.
53
+ * Do not reintroduce a default from the manifest.
54
+ *
55
+ * Heights are grid-derived (line-height + block padding) and land at 30 / 22 —
56
+ * deliberately NOT a fixed `h-*`, exactly as in Badge.
57
+ *
58
+ * **Chip is interactive, Badge is read-only.** They share the soft status palette,
59
+ * but only Chip adds hover / focus / disabled plus an affordance. Anything that
60
+ * merely REPORTS state is a Badge; a filter-bar facet trigger that recolours on
61
+ * select is Filter Chip, a different (32/40) control tier.
62
+ *
63
+ * **The pill never recolours on selection.** The manifest shows a selected filter
64
+ * purely through its checkbox — there is no
65
+ * solid "selected" fill (that is Badge Solid). Only the checkbox fills, and it
66
+ * fills in the CHIP's family colour, overriding the standalone Checkbox's default
67
+ * blue `--secondary-solid` (the host-family override recorded in the Pill recipe).
68
+ *
69
+ * Focus is deliberately NOT a variant — the additive offset `--outline-focus` ring
70
+ * is the cross-cutting `06-patterns/focus-ring.md` pattern, applied by whatever
71
+ * holds DOM focus, and never a border on the pill (that would shift layout).
72
+ *
73
+ * Colour tokens are mapped 1:1 from the design system — no hardcoded values.
74
+ */
75
+ const chipVariants = tv({
76
+ slots: {
77
+ // `w-fit h-fit` is load-bearing, not belt-and-braces. A Pill is "a hug-width,
78
+ // fixed-height rounded rectangle" (06-patterns/pill.md) and `inline-flex`
79
+ // alone does NOT guarantee that: a grid item is blockified to `flex` and then
80
+ // stretched by the default `justify-self`/`align-self: stretch`. Measured in a
81
+ // 1fr grid cell the chip inflated to the cell's full 300×80 instead of its
82
+ // own 83×30, and the trailing × drifted 34px away from the label — which is
83
+ // exactly what a "hug" pill must never do. `max-w-full` still clamps an
84
+ // over-long label so it truncates instead of overflowing.
85
+ // Every published Body style binds `--text-wrap-body` (_text-styles.json
86
+ // $textWrapRule). It sits on `root` because that is where the per-size font
87
+ // lives, and it is an arbitrary property because Tailwind has no textWrap
88
+ // namespace — `text-pretty` would hard-code the value and stop tracking the
89
+ // token. The pill stays single-line: `truncate` on `label` is a direct
90
+ // declaration and outranks anything inherited from here.
91
+ // Motion (manifest 1.7.2 `motion.states.hover`): the hover fill eases over
92
+ // --duration-hover on --easing-standard.
93
+ root: 'inline-flex h-fit w-fit max-w-full items-center font-inter font-semibold transition-[background-color,color] duration-hover ease-standard [text-wrap:var(--text-wrap-body)]',
94
+ // Selectable only — the toggle hit target.
95
+ toggle: 'flex min-w-0 items-center self-stretch cursor-pointer',
96
+ // Relative anchor sized to the box; the check glyph overlays fill it.
97
+ control: 'relative inline-flex shrink-0',
98
+ // The visible 16px square (Checkbox size S in both chip sizes).
99
+ checkbox: [
100
+ 'box-border flex shrink-0 items-center justify-center',
101
+ // `motion.inherits: ["checkbox"]` (1.7.2) — the box owns the standalone
102
+ // Checkbox's toggle motion (`motion.states.toggle`: --duration-toggle on
103
+ // --easing-standard); the tick appears with the fill, at once.
104
+ 'size-600 rounded-200 border-100 transition-[background-color,border-color] duration-toggle ease-standard',
105
+ // Unchecked default. `border-outline-strong` is only the fallback: every
106
+ // enabled emotion compound swaps the border for its family's
107
+ // `-subtle-border` (designer request 2026-10-06 — a control on a status
108
+ // surface takes the border from that surface's tokens). Disabled keeps
109
+ // its own `--outline-default`.
110
+ //
111
+ // No hover rule on purpose. The standalone Checkbox darkens its unchecked
112
+ // border to `--secondary` on hover, but Chip does NOT inherit that: the
113
+ // Figma Hover variants differ from Default by exactly one variable — the
114
+ // pill's fill, `status/{f}/subtle` → `status/{f}/soft` — while the box
115
+ // border stays put (verified on nodes 6286:134519 vs 6286:134525, and the
116
+ // Deleteable pair 6286:134663 vs 6286:134667). The whole hover
117
+ // affordance lives on the pill.
118
+ 'bg-background-primary border-outline-strong',
119
+ ],
120
+ // Absolutely centred check overlay; visibility is peer-driven off the input.
121
+ //
122
+ // WHITE in every family, including Warning — `chip.manifest.json` 1.3.0
123
+ // `slots.checkbox`: "The check glyph is WHITE in EVERY family, including Warning
124
+ // (white on --status-warning-solid = 2.37:1) — an accepted, signed exception
125
+ // (owner 2026-09-04) ... Do NOT bind --status-warning-foreground (or any other
126
+ // -foreground role) to this glyph — it stays white, full stop." The checked
127
+ // contract is system-wide (one glyph colour, never re-derived per family) and the
128
+ // tick is already duplicated by the selected fill plus the label, so the sub-AA
129
+ // glyph is not the sole carrier of the checked state. Hence a single base
130
+ // binding here rather than a per-emotion one; only `disabled` overrides it.
131
+ glyph: [
132
+ 'pointer-events-none absolute inset-0 items-center justify-center',
133
+ 'hidden peer-checked:flex',
134
+ 'text-text-inverted',
135
+ ],
136
+ // Deleteable · Basic only. No colour of its own: it rides currentColor off
137
+ // the pill, exactly like the trailing glyphs.
138
+ leadingIcon: 'shrink-0',
139
+ label: 'min-w-0 truncate',
140
+ // Trailing affordances (ⓘ / ×). Both ring THEMSELVES on :focus-visible and
141
+ // both carry a ≥24×24 hit area via a centred ::before, so the target grows
142
+ // without the glyph or the pill height changing (spec § Accessibility
143
+ // „Target"). Ink is inherited from the pill (currentColor).
144
+ info: [
145
+ 'relative inline-flex shrink-0 items-center justify-center rounded-200 cursor-pointer',
146
+ "before:absolute before:left-1/2 before:top-1/2 before:size-800 before:content-['']",
147
+ 'before:-translate-x-1/2 before:-translate-y-1/2',
148
+ 'focus-visible:outline focus-visible:outline-200 focus-visible:outline-outline-focus focus-visible:outline-offset-2',
149
+ 'disabled:cursor-not-allowed',
150
+ ],
151
+ remove: [
152
+ 'relative inline-flex shrink-0 items-center justify-center rounded-200 cursor-pointer',
153
+ "before:absolute before:left-1/2 before:top-1/2 before:size-800 before:content-['']",
154
+ 'before:-translate-x-1/2 before:-translate-y-1/2',
155
+ 'focus-visible:outline focus-visible:outline-200 focus-visible:outline-outline-focus focus-visible:outline-offset-2',
156
+ 'disabled:cursor-not-allowed',
157
+ ],
158
+ },
159
+ variants: {
160
+ type: {
161
+ // The whole chip is the target and the focusable element, so it rings itself.
162
+ // That holds for both roots — the <button> and, with `href`, the <a>.
163
+ basic: {
164
+ root: [
165
+ // The link root (1.7.3) must not pick up a consuming app's global anchor
166
+ // underline; `!` for the same reason the ink below carries one (see the
167
+ // emotion compounds). Inert on the <button> root.
168
+ 'cursor-pointer !no-underline',
169
+ 'focus-visible:outline focus-visible:outline-200 focus-visible:outline-outline-focus focus-visible:outline-offset-2',
170
+ ],
171
+ // The ring above is right only while the root IS the button. With a
172
+ // trailing ⓘ the root degrades to a <span> (a <button> may not contain
173
+ // another control), so `:focus-visible` there can never match and the
174
+ // pill would fall back to the UA ring. The real target then is this inner
175
+ // button, so it carries the same ring itself. Not `has-[button:…]` on the
176
+ // root — that fires for the ⓘ trigger too, which rings itself; the same
177
+ // reason `selectable` scopes its own ring to `input`.
178
+ toggle: [
179
+ 'focus-visible:outline focus-visible:outline-200 focus-visible:outline-outline-focus focus-visible:outline-offset-2',
180
+ ],
181
+ },
182
+ // Focus lives on the WHOLE chip (manifest `focus.note`), but the ring is
183
+ // scoped to the checkbox input on purpose — a bare `has-[:focus-visible]`
184
+ // would also fire for the ⓘ trigger, which rings itself.
185
+ selectable: {
186
+ root: [
187
+ 'has-[input:focus-visible]:outline',
188
+ 'has-[input:focus-visible]:outline-200',
189
+ 'has-[input:focus-visible]:outline-outline-focus',
190
+ 'has-[input:focus-visible]:outline-offset-2',
191
+ ],
192
+ },
193
+ // The × is the click target and holds focus; the pill only carries the tint.
194
+ deleteable: {},
195
+ },
196
+ emotion: {
197
+ info: {},
198
+ success: {},
199
+ warning: {},
200
+ danger: {},
201
+ violet: {},
202
+ neutral: {},
203
+ },
204
+ size: {
205
+ // No leading spelled out: `text-body-sm` carries Body/S's own --leading-loose
206
+ // (160%) in the theme (styles/theme.generated.css), the same way `text-body-xxs` carries
207
+ // --leading-relaxed. A hand-written override would fight the tuple and leave
208
+ // the pill short of the spec height.
209
+ md: { root: 'gap-300 rounded-300 py-200 text-body-sm', toggle: 'gap-300' },
210
+ sm: { root: 'gap-200 rounded-200 py-100 text-body-xxs', toggle: 'gap-200' },
211
+ },
212
+ // `leadingIcon != null` on Deleteable / Basic (Selectable has no such layer).
213
+ // It moves only Deleteable's left padding — see the type × size compounds.
214
+ hasLeadingIcon: { true: {}, false: {} },
215
+ disabled: {
216
+ // Uniform grey, emotion-independent (Button token parity). Tokens, never
217
+ // `opacity` — the emotion compounds below are gated on `disabled: false`,
218
+ // so no fill or hover class is emitted to fight with.
219
+ //
220
+ // The neutral hairline (manifest 1.5.0) is `strokeMode: "inset-outline"`, the
221
+ // Filter Chip recipe: an `outline` at -1px, so the pill keeps its nominal box.
222
+ // It shares the root's single `outline` with the focus ring, but the two never
223
+ // meet: disabled reaches every control natively (and the disabled link root
224
+ // leaves the tab order), so nothing in a disabled chip takes keyboard focus
225
+ // and the ring classes above never match.
226
+ true: {
227
+ root: [
228
+ 'bg-disabled-control !text-disabled-foreground cursor-not-allowed',
229
+ 'outline outline-100 outline-outline-default -outline-offset-1',
230
+ ],
231
+ toggle: 'cursor-not-allowed',
232
+ checkbox: 'bg-background-secondary border-outline-default',
233
+ glyph: 'text-disabled-foreground',
234
+ },
235
+ false: {},
236
+ },
237
+ },
238
+ compoundVariants: [
239
+ // ── Emotion × enabled — pill fill + ink (every glyph inherits currentColor),
240
+ // hover deepens one tint step, and the checkbox adopts the chip's family on
241
+ // checked.
242
+ //
243
+ // The check glyph is NOT listed here — it is white in every family and lives
244
+ // as a single binding on the `glyph` base slot; see the note there.
245
+ //
246
+ // The `!` on the pill ink (and on the disabled ink above) is precedence only,
247
+ // the values are the manifest tokens: since 1.7.3 a Basic chip may be an <a>,
248
+ // and a consuming app's global `a { color }` outside any `@layer` beats every
249
+ // plain Tailwind colour utility on an anchor — the same guard Button and
250
+ // TextLink carry for their anchor roots. The hover ink equals the rest ink, so
251
+ // the one important rest class also holds against an `a:hover` rule.
252
+ {
253
+ emotion: 'info',
254
+ disabled: false,
255
+ class: {
256
+ root: 'bg-status-info-subtle !text-status-info-tint-foreground hover:bg-status-info-soft',
257
+ checkbox: 'border-status-info-subtle-border peer-checked:bg-status-info-solid peer-checked:border-transparent',
258
+ },
259
+ },
260
+ {
261
+ emotion: 'success',
262
+ disabled: false,
263
+ class: {
264
+ root: 'bg-status-success-subtle !text-status-success-tint-foreground hover:bg-status-success-soft',
265
+ checkbox: 'border-status-success-subtle-border peer-checked:bg-status-success-solid peer-checked:border-transparent',
266
+ },
267
+ },
268
+ {
269
+ emotion: 'warning',
270
+ disabled: false,
271
+ class: {
272
+ root: 'bg-status-warning-subtle !text-status-warning-tint-foreground hover:bg-status-warning-soft',
273
+ checkbox: 'border-status-warning-subtle-border peer-checked:bg-status-warning-solid peer-checked:border-transparent',
274
+ },
275
+ },
276
+ {
277
+ emotion: 'danger',
278
+ disabled: false,
279
+ class: {
280
+ root: 'bg-status-danger-subtle !text-status-danger-tint-foreground hover:bg-status-danger-soft',
281
+ checkbox: 'border-status-danger-subtle-border peer-checked:bg-status-danger-solid peer-checked:border-transparent',
282
+ },
283
+ },
284
+ {
285
+ emotion: 'violet',
286
+ disabled: false,
287
+ class: {
288
+ root: 'bg-status-violet-subtle !text-status-violet-tint-foreground hover:bg-status-violet-soft',
289
+ checkbox: 'border-status-violet-subtle-border peer-checked:bg-status-violet-solid peer-checked:border-transparent',
290
+ },
291
+ },
292
+ {
293
+ emotion: 'neutral',
294
+ disabled: false,
295
+ class: {
296
+ root: 'bg-tertiary-subtle !text-tertiary-tint-foreground hover:bg-tertiary-soft',
297
+ checkbox: 'border-tertiary-subtle-border peer-checked:bg-tertiary-solid peer-checked:border-transparent',
298
+ },
299
+ },
300
+
301
+ // ── Type × size — inline padding (Pill recipe): the text side keeps the size
302
+ // base, the affordance side steps down one spacing step. Basic has no
303
+ // affordance, so it is symmetric and compact at both sizes.
304
+ { type: 'basic', size: 'md', class: { root: 'px-300' } },
305
+ { type: 'basic', size: 'sm', class: { root: 'px-300' } },
306
+ { type: 'selectable', size: 'md', class: { root: 'pl-300 pr-400' } },
307
+ { type: 'selectable', size: 'sm', class: { root: 'pl-200 pr-300' } },
308
+ { type: 'deleteable', size: 'md', hasLeadingIcon: false, class: { root: 'pl-400 pr-300' } },
309
+ { type: 'deleteable', size: 'sm', hasLeadingIcon: false, class: { root: 'pl-300 pr-200' } },
310
+ // A leading glyph turns the left side into an affordance side as well (pill.md
311
+ // lists "leading checkbox · leading status glyph · trailing ×"), so both sides
312
+ // sit one step below the text base — the step Badge takes for its glyph.
313
+ // Basic keeps its symmetric --space-300: it has no text-side base to step from.
314
+ { type: 'deleteable', size: 'md', hasLeadingIcon: true, class: { root: 'pl-300 pr-300' } },
315
+ { type: 'deleteable', size: 'sm', hasLeadingIcon: true, class: { root: 'pl-200 pr-200' } },
316
+ ],
317
+ defaultVariants: {
318
+ type: 'selectable',
319
+ emotion: 'info',
320
+ size: 'md',
321
+ hasLeadingIcon: false,
322
+ disabled: false,
323
+ },
324
+ });
325
+
326
+ export type ChipType = 'basic' | 'selectable' | 'deleteable';
327
+ export type ChipEmotion = 'info' | 'success' | 'warning' | 'danger' | 'violet' | 'neutral';
328
+ export type ChipSize = 'md' | 'sm';
329
+
330
+ /**
331
+ * Leading glyph / trailing ⓘ / × size per chip size (manifest `sizes[].icon`:
332
+ * md --size-icon-xsmall, sm --size-icon-2xsmall).
333
+ */
334
+ const ICON_SIZE: Record<ChipSize, IconSize> = { md: 'xsmall', sm: '2xsmall' };
335
+
336
+ /**
337
+ * The permissive base: every prop the chip accepts, with the two accessible-name
338
+ * props still optional. `ChipProps` below tightens them per type — but CSF's
339
+ * `Args` machinery cannot resolve a union prop type (same wall `RadioGroup` hit),
340
+ * so the stories type themselves against THIS shape and the union does its work
341
+ * at the real callsites.
342
+ */
343
+ export interface ChipBaseProps
344
+ extends Omit<React.HTMLAttributes<HTMLElement>, 'children' | 'defaultChecked'>,
345
+ Omit<VariantProps<typeof chipVariants>, 'type' | 'emotion' | 'size' | 'disabled' | 'hasLeadingIcon'> {
346
+ /**
347
+ * Composition:
348
+ * - `basic` — plain filter tag, the whole chip is the click target (a link
349
+ * with `href`);
350
+ * - `selectable` — leading checkbox toggle (the default);
351
+ * - `deleteable` — trailing × remove affordance.
352
+ */
353
+ type?: ChipType;
354
+ /** Status colour family. `neutral` maps onto the `--tertiary-*` ramp. */
355
+ emotion?: ChipEmotion;
356
+ /** `md` (30px, the default) or `sm` (22px) for dense filter bars and token runs. */
357
+ size?: ChipSize;
358
+ /** Muted `--disabled-control` fill + `--outline-default` hairline + `--disabled-foreground`; propagates to every sub-control. */
359
+ disabled?: boolean;
360
+ /**
361
+ * Visible label — a status / category noun (Selectable) or the tag's value
362
+ * (Deleteable). Plain text on purpose: 1–2 words, ≤ ~24 chars, truncated on
363
+ * overflow.
364
+ */
365
+ children: string;
366
+ className?: string;
367
+
368
+ // ── Selectable ──────────────────────────────────────────────────────────────
369
+ /** Controlled selection. Selection is carried by the checkbox; the pill never recolours. */
370
+ checked?: boolean;
371
+ /** Uncontrolled initial selection — the DOM owns the value from there on. */
372
+ defaultChecked?: boolean;
373
+ /** Selection change. Receives the new boolean, not the DOM event. */
374
+ onCheckedChange?: (checked: boolean) => void;
375
+ /**
376
+ * Extra attributes for the native `<input type="checkbox">` (Selectable only).
377
+ * The rest props go to the PILL, which is the right target for `onClick`,
378
+ * `title` or a `data-*` hook but the wrong one for input metadata — a `name` /
379
+ * `value` pair on a `<span>` is invisible to `FormData`, and an `id` or
380
+ * `aria-describedby` there names the wrapper instead of the control. This is
381
+ * the way through to the input; the attributes the component drives itself
382
+ * (`type`, `checked`, `onChange`, `disabled`, `className`) are cut from the type
383
+ * so they cannot be fought over.
384
+ */
385
+ inputProps?: Omit<
386
+ React.InputHTMLAttributes<HTMLInputElement>,
387
+ 'type' | 'checked' | 'defaultChecked' | 'onChange' | 'disabled' | 'className'
388
+ >;
389
+ /**
390
+ * The optional trailing ⓘ — tooltip `content` plus the trigger's accessible
391
+ * `label`, as ONE prop. Its PRESENCE renders the trigger, so the Figma
392
+ * `Show info` boolean and the icon swap collapse into this slot and a caller can
393
+ * never ask for an icon it has no content for. The two live together because an
394
+ * icon-only button must have a name (WCAG 4.1.2) and there is no default to fall
395
+ * back on: a pair cannot be half-supplied, whereas two flat props could — and the
396
+ * `type`-keyed union below already spends the one discriminated axis TypeScript
397
+ * can distribute over a dynamic `type` (measured: a second intersected union
398
+ * breaks every `<Chip type={type}>` callsite in the docs matrices).
399
+ * The trigger is a plain `Tooltip`: it needs a `TooltipProvider` ancestor, or it
400
+ * throws "`Tooltip` must be used within `TooltipProvider`".
401
+ */
402
+ info?: { content: React.ReactNode; label: string };
403
+
404
+ // ── Basic ───────────────────────────────────────────────────────────────────
405
+ /**
406
+ * Navigation target — Basic only (manifest 1.7.3 `delivery.react`). With it the
407
+ * chip renders a real `<a href>` that leads to a listing (the article's category
408
+ * chips); without it a Basic chip stays the `<button>` filter tag. The whole pill
409
+ * is the link and owns the focus ring; its accessible name is the label.
410
+ *
411
+ * A link chip carries no trailing ⓘ (a tooltip trigger cannot nest inside an
412
+ * `<a>`): `info` is dropped with a dev warning. On `selectable` / `deleteable`
413
+ * `href` is dropped with a dev warning.
414
+ *
415
+ * `disabled` has no native equivalent on an `<a>`, so — as on `TextLink` — the
416
+ * href is removed, the `link` role is re-stated, `aria-disabled="true"` and
417
+ * `tabIndex={-1}` are set and clicks are suppressed.
418
+ */
419
+ href?: string;
420
+
421
+ // ── Deleteable ──────────────────────────────────────────────────────────────
422
+ /**
423
+ * Optional LEADING glyph before the label — Deleteable and Basic only (manifest
424
+ * 1.7.0 `slots.leading-icon`; the Figma `Show leading icon` boolean and the
425
+ * `Leading icon` swap collapse into this one prop). The spec keeps it ON by
426
+ * default, but the Figma default glyph (`info`) is a set artefact, not a code
427
+ * default: pass the glyph that fits the tag (Badge's `BADGE_STATUS_ICONS` are the
428
+ * preferred values) and leave it out only where space is tight. Rendered at
429
+ * 16 (`md`) / 14 (`sm`) in the label ink, decorative (`aria-hidden`). On
430
+ * `selectable` it logs a dev warning and renders nothing — the checkbox is the
431
+ * leading element there.
432
+ */
433
+ leadingIcon?: IconName;
434
+
435
+ /** Remove handler for the trailing ×. */
436
+ onRemove?: () => void;
437
+ /**
438
+ * Accessible name of the icon-only × button — required for Deleteable, and
439
+ * translated by the caller. Name the TAG, not the verb alone ("Odebrat Praha",
440
+ * not "Odebrat"): a bar of chips would otherwise announce the same name over
441
+ * and over.
442
+ */
443
+ removeLabel?: string;
444
+ }
445
+
446
+ /**
447
+ * The enforcing contract for the × name. The × is icon-only, so it needs a name
448
+ * (WCAG 4.1.2) and may not fall back to a hardcoded string — so the requirement is
449
+ * carried by the TYPE instead of by a runtime default, the same trick `RadioGroup`
450
+ * uses for its mandatory group name. `ChipBaseProps` keeps `removeLabel` optional and
451
+ * the intersection lets the required member win, so each branch only ever TIGHTENS
452
+ * the base.
453
+ *
454
+ * Exactly ONE union, keyed on `type`. TypeScript only distributes a source object
455
+ * over a discriminated target when there is a single such axis: intersect a second
456
+ * union (the earlier `info` / `infoLabel` pair) and every `<Chip type={type}>` in the
457
+ * docs matrices stops compiling, because the union-typed `type` then matches no
458
+ * constituent. Hence `info` carries its own label as a pair instead.
459
+ */
460
+ export type ChipProps = ChipBaseProps &
461
+ (
462
+ | { type: 'deleteable'; removeLabel: string }
463
+ | { type?: 'basic' | 'selectable'; removeLabel?: string }
464
+ );
465
+
466
+ const Chip = React.forwardRef<HTMLElement, ChipProps>(
467
+ (
468
+ {
469
+ className,
470
+ type = 'selectable',
471
+ emotion = 'info',
472
+ size = 'md',
473
+ disabled = false,
474
+ children,
475
+ checked,
476
+ defaultChecked,
477
+ onCheckedChange,
478
+ inputProps,
479
+ info,
480
+ href,
481
+ leadingIcon,
482
+ onRemove,
483
+ removeLabel,
484
+ ...props
485
+ },
486
+ ref,
487
+ ) => {
488
+ // 1.7.3: Basic is a link when it leads somewhere. Only Basic — the other two
489
+ // types carry their own control (checkbox / ×), which cannot nest in an <a>.
490
+ const isLink = type === 'basic' && href != null;
491
+ const hasLeadingIcon = leadingIcon != null && type !== 'selectable';
492
+ const slots = chipVariants({ type, emotion, size, disabled, hasLeadingIcon });
493
+ // Carries data-fods-part itself, as Badge's glyph does: a wrapper span would be
494
+ // one more flex item in the pill.
495
+ const leadingGlyph = hasLeadingIcon ? (
496
+ <Icon
497
+ name={leadingIcon}
498
+ size={ICON_SIZE[size]}
499
+ className={slots.leadingIcon()}
500
+ data-fods-part="leading-icon"
501
+ />
502
+ ) : null;
503
+ // Narrowed to the pair itself, not to a boolean, so the JSX below can read
504
+ // `content` / `label` without a non-null assertion.
505
+ // 1.2.0 (2026-09-02) opened the trailing ⓘ to Basic as well: a status pill that
506
+ // must not offer a payment checkbox — an invoice's `Budoucí` — still needs the
507
+ // tooltip trigger the rest of the Stav column shows. Deleteable stays ×-only:
508
+ // that trailing slot is the ×, and two trailing affordances compete for the
509
+ // same click. 1.7.3: a link chip carries no ⓘ either — a tooltip trigger is a
510
+ // <button>, and an interactive element may not nest inside an <a>.
511
+ const infoSlot = type === 'deleteable' || isLink ? undefined : info;
512
+
513
+ if (process.env.NODE_ENV !== 'production') {
514
+ if (info != null && type === 'deleteable') {
515
+ console.warn('Chip: `info` is the trailing slot Deleteable spends on the ×, so it is dropped for type="deleteable".');
516
+ }
517
+ if (info != null && isLink) {
518
+ console.warn('Chip: `info` is dropped on a link chip (`href`) — a tooltip trigger cannot nest inside an <a>.');
519
+ }
520
+ if (href != null && type !== 'basic') {
521
+ console.warn('Chip: `href` makes a Basic chip a link and is dropped for type="' + type + '".');
522
+ }
523
+ if (onRemove != null && type !== 'deleteable') {
524
+ console.warn('Chip: `onRemove` is a Deleteable-only affordance and is dropped for type="' + type + '".');
525
+ }
526
+ if (leadingIcon != null && type === 'selectable') {
527
+ console.warn('Chip: `leadingIcon` is dropped for type="selectable" — its checkbox is the leading element.');
528
+ }
529
+ if (inputProps != null && type !== 'selectable') {
530
+ console.warn('Chip: `inputProps` reaches the Selectable checkbox only and is dropped for type="' + type + '".');
531
+ }
532
+ }
533
+
534
+ const handleChange = (event: React.ChangeEvent<HTMLInputElement>) => {
535
+ onCheckedChange?.(event.target.checked);
536
+ };
537
+
538
+ // data-fods-part marks the parts the FODS verifier measures in the browser
539
+ // (the chip parts map). Not inert in this package: `styles/base.css` scopes its reset to these attributes. `root` is
540
+ // written out literally on each of the five shells rather than folded in
541
+ // here: the static S7c check greps the JSX for the attribute and a spread
542
+ // object is invisible to it.
543
+ const rootProps = {
544
+ 'data-fods-component': 'chip',
545
+ className: cn(slots.root(), className),
546
+ ...props,
547
+ };
548
+
549
+ // Native `disabled` on every control that has one (an `<a>` has none: the
550
+ // link shell below uses `aria-disabled`), and no `aria-disabled` beside it: a
551
+ // natively disabled control is already exposed as disabled, and the second
552
+ // attribute would only repeat it. Button Group is the deliberate exception —
553
+ // its manifest keeps disabled SEGMENTS in the tab order, so there the native
554
+ // attribute cannot be used at all; chip.manifest.json asks for no such thing,
555
+ // and a chip skipped by Tab is the correct behaviour for a standalone control.
556
+
557
+ // ── Basic as a link (1.7.3) — the whole pill IS the <a href>: the label is its
558
+ // accessible name, Enter follows it, and the root's own ring is the focus
559
+ // ring. Never a <button> or a clickable <span> for navigation (spec
560
+ // § Accessibility). `infoSlot` is already undefined here, so there is no ⓘ.
561
+ if (isLink) {
562
+ // Disabled: an <a> has no native `disabled`, so the TextLink recipe applies —
563
+ // drop the href, re-state the `link` role (an href-less <a> is a generic
564
+ // element on which `aria-disabled` announces nothing), leave the tab order
565
+ // and swallow the click, Enter included (Enter fires a click on a link). The
566
+ // click is cancelled in the CAPTURE phase (`suppressDisabledClick`, as TextLink
567
+ // and NavLink do), so neither the consumer's `onClick` nor its `onClickCapture`
568
+ // runs; both are wired AFTER the rest props so a consumer cannot shadow the guard.
569
+ const { onClick: onLinkClick, onClickCapture: onLinkClickCapture, ...restRootProps } = rootProps;
570
+ return (
571
+ <a
572
+ ref={ref as React.Ref<HTMLAnchorElement>}
573
+ data-fods-part="root"
574
+ {...restRootProps}
575
+ href={disabled ? undefined : href}
576
+ role={disabled ? 'link' : undefined}
577
+ aria-disabled={disabled || undefined}
578
+ tabIndex={disabled ? -1 : restRootProps.tabIndex}
579
+ onClick={disabled ? undefined : onLinkClick}
580
+ onClickCapture={disabled ? suppressDisabledClick : onLinkClickCapture}
581
+ >
582
+ {leadingGlyph}
583
+ <span data-fods-part="label" className={slots.label()}>
584
+ {children}
585
+ </span>
586
+ </a>
587
+ );
588
+ }
589
+
590
+ // ── Basic — the whole pill is the control, so it IS the button…
591
+ if (type === 'basic' && !infoSlot) {
592
+ return (
593
+ <button
594
+ ref={ref as React.Ref<HTMLButtonElement>}
595
+ type="button"
596
+ disabled={disabled}
597
+ data-fods-part="root"
598
+ {...rootProps}
599
+ >
600
+ {leadingGlyph}
601
+ <span data-fods-part="label" className={slots.label()}>
602
+ {children}
603
+ </span>
604
+ </button>
605
+ );
606
+ }
607
+
608
+ // …unless it carries the trailing ⓘ, which 1.2.0 opened to Basic. The ⓘ is a
609
+ // Tooltip trigger — a real <button> — and a <button> may not contain another
610
+ // interactive control, exactly the constraint the Selectable branch below
611
+ // already works around by keeping the ⓘ a SIBLING of its <label>. So Basic with
612
+ // an ⓘ takes the same shape: a <span> root, the pill's own click target as an
613
+ // inner <button> around the label, and the ⓘ beside it. The click target is
614
+ // then the label area rather than the literal whole pill — the same trade
615
+ // Selectable makes, and the only one that keeps the ⓘ keyboard-reachable.
616
+ // Without an ⓘ nothing changes: the branch above still renders the plain
617
+ // <button> root.
618
+ if (type === 'basic' && infoSlot) {
619
+ // `onClick` belongs to the clickable target, not to the wrapper: left on the
620
+ // <span> it would also fire when the ⓘ is pressed (the trigger sits inside
621
+ // that wrapper and does not stop propagation), so the same
622
+ // `<Chip type="basic" onClick>` would behave differently with and without
623
+ // `info`. Everything else still spreads onto the root.
624
+ const { onClick: onChipClick, ...restRootProps } = rootProps;
625
+ return (
626
+ <span ref={ref as React.Ref<HTMLSpanElement>} data-fods-part="root" {...restRootProps}>
627
+ <button
628
+ type="button"
629
+ data-fods-part="toggle"
630
+ disabled={disabled}
631
+ onClick={onChipClick}
632
+ className={slots.toggle()}
633
+ >
634
+ {leadingGlyph}
635
+ <span data-fods-part="label" className={slots.label()}>
636
+ {children}
637
+ </span>
638
+ </button>
639
+ <Tooltip content={infoSlot.content}>
640
+ <button
641
+ type="button"
642
+ data-fods-part="info"
643
+ aria-label={infoSlot.label}
644
+ disabled={disabled}
645
+ className={slots.info()}
646
+ >
647
+ <Icon name="info" size={ICON_SIZE[size]} />
648
+ </button>
649
+ </Tooltip>
650
+ </span>
651
+ );
652
+ }
653
+
654
+ // ── Deleteable — a tag plus a real remove button. The pill carries the hover
655
+ // tint; the × holds focus and rings itself.
656
+ if (type === 'deleteable') {
657
+ return (
658
+ <span ref={ref as React.Ref<HTMLSpanElement>} data-fods-part="root" {...rootProps}>
659
+ {leadingGlyph}
660
+ <span data-fods-part="label" className={slots.label()}>
661
+ {children}
662
+ </span>
663
+ <button
664
+ type="button"
665
+ data-fods-part="remove"
666
+ aria-label={removeLabel}
667
+ disabled={disabled}
668
+ onClick={onRemove}
669
+ className={slots.remove()}
670
+ >
671
+ <Icon name="x" size={ICON_SIZE[size]} />
672
+ </button>
673
+ </span>
674
+ );
675
+ }
676
+
677
+ // ── Selectable — a native checkbox + <label>, the pattern the a11y floor
678
+ // asks for. The visual box and the check glyph are SIBLINGS of the input so
679
+ // the `peer-*` combinator reaches them; the ⓘ trigger is a sibling of the
680
+ // <label>, because a label must not contain another interactive control.
681
+ return (
682
+ <span ref={ref as React.Ref<HTMLSpanElement>} data-fods-part="root" {...rootProps}>
683
+ <label data-fods-part="toggle" className={slots.toggle()}>
684
+ <span className={slots.control()}>
685
+ <input
686
+ // First, so the component's own attributes below always win — the
687
+ // type already cuts them out of `inputProps`, this is the belt to
688
+ // that braces.
689
+ {...inputProps}
690
+ type="checkbox"
691
+ checked={checked}
692
+ defaultChecked={defaultChecked}
693
+ onChange={handleChange}
694
+ disabled={disabled}
695
+ // Enlarged, centred hit area (24×24) kept OUT of layout, so the
696
+ // 16px box and the label spacing are unaffected.
697
+ className="peer absolute left-1/2 top-1/2 size-800 -translate-x-1/2 -translate-y-1/2 cursor-pointer opacity-0 outline-none disabled:cursor-not-allowed"
698
+ />
699
+ <span data-fods-part="checkbox" className={slots.checkbox()} aria-hidden />
700
+ <span data-fods-part="glyph" className={slots.glyph()}>
701
+ {/* Check glyph inside the 16px box at the nested Checkbox `sm`'s own
702
+ manifest sizes[].icon (checkbox 1.9.0: --size-icon-2xsmall).
703
+ chip 1.8.1 `slots.checkbox`: the Chip never sizes it — so it is
704
+ NOT keyed to the chip's `size` (ICON_SIZE), it stays the
705
+ Checkbox's step at both chip sizes. */}
706
+ <Icon name="check" size="2xsmall" />
707
+ </span>
708
+ </span>
709
+ <span data-fods-part="label" className={slots.label()}>
710
+ {children}
711
+ </span>
712
+ </label>
713
+ {infoSlot && (
714
+ <Tooltip content={infoSlot.content}>
715
+ <button
716
+ type="button"
717
+ data-fods-part="info"
718
+ aria-label={infoSlot.label}
719
+ disabled={disabled}
720
+ className={slots.info()}
721
+ >
722
+ <Icon name="info" size={ICON_SIZE[size]} />
723
+ </button>
724
+ </Tooltip>
725
+ )}
726
+ </span>
727
+ );
728
+ },
729
+ );
730
+ Chip.displayName = 'Chip';
731
+
732
+ export { Chip, chipVariants };