@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,398 @@
1
+ import type { Meta, StoryObj } from '@storybook/react-vite';
2
+ import { expect } from 'storybook/test';
3
+ import { Icon, type IconName, type IconSize } from './Icon';
4
+ import { Button } from '../button/Button';
5
+ import { IconButton } from '../icon-button/IconButton';
6
+ import { ButtonGroup, ButtonGroupItem } from '../button-group/ButtonGroup';
7
+ import { SplitButton } from '../split-button/SplitButton';
8
+ import { TextLink } from '../text-link/TextLink';
9
+ import { ListRow } from '../list-row/ListRow';
10
+ import { Checkbox } from '../checkbox/Checkbox';
11
+ import { Chip } from '../chip/Chip';
12
+ import { AVAILABLE_ICONS } from '../../icons/icon-types.generated';
13
+ import { Section, Showcase } from '../../storybook/Section';
14
+ import { componentDoc } from '../../storybook/componentDoc';
15
+
16
+ // Canonical names grouped by the manifest's `category` (icon.manifest.json). A generated
17
+ // name missing from this grouping lands in "Other".
18
+ const CATEGORY_ICONS: Record<string, IconName[]> = {
19
+ 'Content & business': [
20
+ 'address-book', 'bank', 'book', 'briefcase', 'buildings', 'calendar-dots', 'chart-bar',
21
+ 'cloud', 'columns', 'credit-card', 'dot', 'eet', 'envelope', 'expense', 'file-dashed',
22
+ 'file-minus', 'file-pdf', 'file-text', 'gear', 'globe', 'grid-four', 'hand-coins',
23
+ 'hand-waving', 'house', 'identification-card', 'invoice-new', 'key', 'mailbox',
24
+ 'microsoft-excel-logo', 'microsoft-word-logo', 'money', 'notepad', 'outcome-add', 'package',
25
+ 'paperclip', 'percent', 'phone', 'piggy-bank', 'plugs-connected', 'presentation-chart',
26
+ 'shield-check', 'shopping-cart', 'sort-ascending', 'table', 'user-circle', 'user-plus',
27
+ 'users-three', 'writer',
28
+ ],
29
+ Actions: [
30
+ 'archive', 'arrow-clockwise', 'arrow-square-out', 'arrows-left-right', 'check', 'copy',
31
+ 'dots-six-vertical', 'download-simple', 'eye', 'eye-closed', 'floppy-disk', 'funnel-simple',
32
+ 'funnel-simple-x', 'lock', 'lock-open', 'magic-wand', 'magnifying-glass', 'map-pin', 'minus',
33
+ 'paper-plane-tilt', 'pencil-simple', 'plus', 'printer', 'prohibit', 'scan', 'share',
34
+ 'sign-out', 'trash', 'upload-simple', 'x', 'x-small',
35
+ ],
36
+ 'Status & feedback': [
37
+ 'alarm', 'bell', 'binoculars', 'check-circle', 'checks', 'empty', 'file-magnifying-glass',
38
+ 'file-x', 'hourglass', 'info', 'question', 'smiley-meh', 'spinner', 'thumbs-down',
39
+ 'thumbs-up', 'warning', 'warning-circle',
40
+ ],
41
+ Navigation: [
42
+ 'arrow-down', 'arrow-elbow-down-right', 'arrow-left', 'arrow-right', 'arrow-up',
43
+ 'caret-double-left-small', 'caret-double-right-small', 'caret-down-small', 'caret-left-small',
44
+ 'caret-right-small', 'caret-up-down', 'caret-up-down-small', 'caret-up-small', 'dots-three',
45
+ 'list',
46
+ ],
47
+ Decorative: [
48
+ 'crown', 'hand', 'heart', 'lightbulb', 'rocket-launch', 'sparkle', 'trophy',
49
+ ],
50
+ 'Brand · social': [
51
+ 'facebook-logo', 'linkedin-logo', 'x-logo',
52
+ ],
53
+ };
54
+
55
+ // The -small tier is the Phosphor bold glyph drawn at 16/24 of the unchanged slot.
56
+ const TIER_PAIRS: IconName[] = ['caret-down-small', 'caret-up-down', 'caret-up-down-small', 'caret-right-small', 'x-small', 'x'];
57
+ const TIER_SIZES: IconSize[] = ['default', 'small'];
58
+
59
+ // The design system's own drawings — no Phosphor counterpart.
60
+ const CUSTOM_ICONS: IconName[] = ['eet', 'expense', 'invoice-new', 'outcome-add', 'writer'];
61
+
62
+ // Every step of the `--size-icon*` scale, smallest first; `default` is `--size-icon`.
63
+ const SIZES: IconSize[] = ['2xsmall', 'xsmall', 'small', 'default', 'large', 'display'];
64
+ const sizeToken = (size: IconSize) => (size === 'default' ? '--size-icon' : `--size-icon-${size}`);
65
+
66
+ // The resolved px of a token in the running page (custom properties compute with
67
+ // their var() chain substituted), so a play function asserts against the token,
68
+ // never against a number typed into the story.
69
+ const tokenPx = (token: string) =>
70
+ parseFloat(getComputedStyle(document.documentElement).getPropertyValue(token));
71
+ const boxOf = (el: Element | null) => {
72
+ if (!el) throw new Error('glyph not rendered');
73
+ const { width, height } = el.getBoundingClientRect();
74
+ return { width, height };
75
+ };
76
+ const square = (px: number) => ({ width: px, height: px });
77
+
78
+ const meta = {
79
+ title: 'Design System/Atoms/Icon',
80
+ component: Icon,
81
+ parameters: {
82
+ layout: 'centered',
83
+ docs: {
84
+ description: {
85
+ component: componentDoc({
86
+ summary:
87
+ `Inline SVG icon with type-safe canonical FODS names — ${AVAILABLE_ICONS.length} icons, every one a single-path SVG baked in at generation time. Phosphor (path data from \`@phosphor-icons/core\`) draws the bulk in the regular weight and the 8-icon \`-small\` tier in bold, scaled to 16/24 of the slot; the few custom glyphs with no Phosphor counterpart are custom SVGs the manifest names under \`assets/icons/\`. Always decorative (\`aria-hidden\`) and painted with \`currentColor\`. The legacy icon-font names are not accepted — they stay with the icon font.`,
88
+ useCases: [
89
+ 'Inside buttons (`Button` handles size automatically)',
90
+ 'In navigation, breadcrumbs, status indicators',
91
+ 'Inline in forms (search, mail prefixes)',
92
+ ],
93
+ bestPractices: [
94
+ 'Size with the `size` prop — a step of the `--size-icon*` scale; without it the glyph is `--size-icon`',
95
+ '`className` only for color (`text-status-success`) — not for size',
96
+ 'For text with a trailing icon use a `whitespace-nowrap` wrapper, otherwise the icon wraps to its own line with a space',
97
+ ],
98
+ docsLink: { label: 'spec/03-atoms/icon.md' },
99
+ }),
100
+ },
101
+ },
102
+ },
103
+ } satisfies Meta<typeof Icon>;
104
+
105
+ export default meta;
106
+ type Story = StoryObj<typeof meta>;
107
+
108
+ export const Playground: Story = {
109
+ args: {
110
+ name: 'house',
111
+ size: 'large',
112
+ className: '',
113
+ },
114
+ argTypes: {
115
+ name: { control: 'select', options: AVAILABLE_ICONS },
116
+ size: { control: 'select', options: SIZES },
117
+ className: { control: 'text' },
118
+ },
119
+ };
120
+
121
+ export const Variants: Story = {
122
+ args: { name: 'house' },
123
+ parameters: {
124
+ // 'centered' (meta default) shrinks the wrapper to its content, collapsing the auto-fit grid to one column.
125
+ layout: 'padded',
126
+ docs: { description: { story: `Catalog of all ${AVAILABLE_ICONS.length} icons grouped by the manifest category.` } },
127
+ },
128
+ render: () => {
129
+ const categorized = Object.values(CATEGORY_ICONS).flat();
130
+ const other = AVAILABLE_ICONS.filter(icon => !categorized.includes(icon));
131
+ const allCategories: Array<[string, IconName[]]> = [
132
+ ...Object.entries(CATEGORY_ICONS),
133
+ ...(other.length ? [['Other', other] as [string, IconName[]]] : []),
134
+ ];
135
+
136
+ return (
137
+ <Showcase>
138
+ {allCategories.map(([category, icons]) => (
139
+ <Section key={category} title={category} layout="grid">
140
+ {icons.map(iconName => (
141
+ <div
142
+ key={iconName}
143
+ className="flex flex-col items-center gap-100 rounded-400 border border-outline-default p-200"
144
+ title={`<Icon name="${iconName}" />`}
145
+ >
146
+ <Icon name={iconName} />
147
+ <span className="text-body-xs text-text-secondary">{iconName}</span>
148
+ </div>
149
+ ))}
150
+ </Section>
151
+ ))}
152
+ </Showcase>
153
+ );
154
+ },
155
+ };
156
+
157
+ export const Tiers: Story = {
158
+ args: { name: 'caret-down-small' },
159
+ parameters: {
160
+ docs: {
161
+ description: {
162
+ story:
163
+ 'Visual parity check of the design system\'s own drawings. **Small tier vs full** — the `-small` glyphs are Phosphor bold drawn at 16/24 of the slot (stroke 1.5px at 24, 1.25px at 20), shown next to their full-size Phosphor neighbours at `size="default"` (24) and `size="small"` (20). **Custom** — the five custom glyphs with no Phosphor counterpart.',
164
+ },
165
+ },
166
+ },
167
+ render: () => (
168
+ <Showcase>
169
+ {TIER_SIZES.map(size => (
170
+ <Section key={size} title={`Small tier vs full — size=${size}`}>
171
+ {TIER_PAIRS.map(iconName => (
172
+ <div key={iconName} className="flex flex-col items-center gap-100">
173
+ <Icon name={iconName} size={size} />
174
+ <span className="text-body-xs text-text-secondary">{iconName}</span>
175
+ </div>
176
+ ))}
177
+ </Section>
178
+ ))}
179
+ <Section title="Custom">
180
+ {CUSTOM_ICONS.map(iconName => (
181
+ <div key={iconName} className="flex flex-col items-center gap-100">
182
+ <Icon name={iconName} />
183
+ <span className="text-body-xs text-text-secondary">{iconName}</span>
184
+ </div>
185
+ ))}
186
+ </Section>
187
+ </Showcase>
188
+ ),
189
+ };
190
+
191
+ export const Sizes: Story = {
192
+ args: { name: 'check' },
193
+ parameters: {
194
+ docs: {
195
+ description: {
196
+ story:
197
+ 'All six steps of the `size` prop. Each sets the glyph\'s width and height from its `--size-icon*` token; `font-size` does not size an icon.',
198
+ },
199
+ },
200
+ },
201
+ render: () => (
202
+ <Showcase>
203
+ <Section title="size prop">
204
+ {SIZES.map(s => (
205
+ <div key={s} className="flex flex-col items-center gap-100" data-testid={`size-${s}`}>
206
+ <Icon name="check" size={s} />
207
+ <span className="text-body-xs text-text-secondary">size="{s}"</span>
208
+ <code className="text-body-xxs text-text-tertiary">{sizeToken(s)}</code>
209
+ </div>
210
+ ))}
211
+ </Section>
212
+ </Showcase>
213
+ ),
214
+ play: async ({ canvasElement }) => {
215
+ for (const s of SIZES) {
216
+ const glyph = canvasElement.querySelector(`[data-testid="size-${s}"] svg`);
217
+ await expect(boxOf(glyph)).toEqual(square(tokenPx(sizeToken(s))));
218
+ }
219
+ },
220
+ };
221
+
222
+ /**
223
+ * Cascade check, run by `test:stories` in Chromium against the real CSS: a parent's
224
+ * `[&_.icon]:size-icon-<step>` (two classes) must beat the glyph's own one-class
225
+ * `size-icon`, so the glyphs a component renders WITHOUT a `size` (the spinner, the
226
+ * caret) and the consumer's slot icons take the parent's step. And the reverse:
227
+ * ListRow sizes only its direct children, so a Checkbox in its slot keeps its own
228
+ * glyph. Not on the docs page.
229
+ */
230
+ export const SizingInParents: Story = {
231
+ args: { name: 'check' },
232
+ tags: ['!autodocs'],
233
+ render: () => (
234
+ <Showcase>
235
+ <Section title="Spinner and slot icons take the parent's step" layout="row">
236
+ <span data-testid="button-sm-loading">
237
+ <Button size="sm" loading>Ukládám…</Button>
238
+ </span>
239
+ <span data-testid="button-xl-icon">
240
+ <Button size="xl" leadingIcon={<Icon name="plus" />}>Přidat</Button>
241
+ </span>
242
+ <span data-testid="icon-button-xl-loading">
243
+ <IconButton size="xl" loading icon={<Icon name="check" />} aria-label="Potvrdit" />
244
+ </span>
245
+ <span data-testid="icon-button-xs">
246
+ <IconButton size="xs" icon={<Icon name="check" />} aria-label="Potvrdit" />
247
+ </span>
248
+ </Section>
249
+ <Section title="ButtonGroup / SplitButton: spinner and caret" layout="row">
250
+ <span data-testid="button-group-sm">
251
+ <ButtonGroup size="sm" aria-label="Akce dokumentu">
252
+ <ButtonGroupItem loading>Ukládám…</ButtonGroupItem>
253
+ <ButtonGroupItem caret>Odeslat</ButtonGroupItem>
254
+ </ButtonGroup>
255
+ </span>
256
+ <span data-testid="split-button-sm">
257
+ <SplitButton size="sm" loading label="Vystavuji…" triggerLabel="Další možnosti" />
258
+ </span>
259
+ </Section>
260
+ <Section title="TextLink inherit follows the running text" layout="row">
261
+ <p className="text-body-lg text-text-primary" data-testid="text-link-inherit">
262
+ Viz <TextLink href="#" size="inherit" trailingIcon="arrow-right">obchodní podmínky</TextLink>
263
+ </p>
264
+ </Section>
265
+ <Section title="Own glyphs keep their own size inside a sizing parent" layout="row">
266
+ <div data-testid="list-row-checkbox">
267
+ <ListRow size="md" leading={<Checkbox defaultChecked aria-label="Vybrat fakturu" />}>
268
+ Faktura za březen
269
+ </ListRow>
270
+ </div>
271
+ <div data-testid="list-row-icon">
272
+ <ListRow size="sm" leading={<Icon name="plus" />}>Přidat odběratele</ListRow>
273
+ </div>
274
+ <span data-testid="chip-check">
275
+ <Chip type="selectable" emotion="info" defaultChecked>Zaplaceno</Chip>
276
+ </span>
277
+ </Section>
278
+ </Showcase>
279
+ ),
280
+ play: async ({ canvasElement }) => {
281
+ const glyph = (testId: string, selector = 'svg') =>
282
+ boxOf(canvasElement.querySelector(`[data-testid="${testId}"] ${selector}`));
283
+
284
+ await expect(glyph('button-sm-loading', '.icon-spinner')).toEqual(square(tokenPx('--size-icon-small')));
285
+ await expect(glyph('button-xl-icon', '.icon-plus')).toEqual(square(tokenPx('--size-icon-large')));
286
+ await expect(glyph('icon-button-xl-loading', '.icon-spinner')).toEqual(square(tokenPx('--size-icon-large')));
287
+ await expect(glyph('icon-button-xs', '.icon-check')).toEqual(square(tokenPx('--size-icon-xsmall')));
288
+
289
+ await expect(glyph('button-group-sm', '.icon-spinner')).toEqual(square(tokenPx('--size-icon-small')));
290
+ await expect(glyph('button-group-sm', '.icon-caret-down-small')).toEqual(square(tokenPx('--size-icon-small')));
291
+ await expect(glyph('split-button-sm', '.icon-spinner')).toEqual(square(tokenPx('--size-icon-small')));
292
+ await expect(glyph('split-button-sm', '.icon-caret-down-small')).toEqual(square(tokenPx('--size-icon-small')));
293
+
294
+ const paragraph = canvasElement.querySelector('[data-testid="text-link-inherit"]');
295
+ const em = parseFloat(getComputedStyle(paragraph as Element).fontSize);
296
+ await expect(glyph('text-link-inherit', '.icon-arrow-right')).toEqual(square(em));
297
+
298
+ await expect(glyph('list-row-checkbox', '.icon-check')).toEqual(square(tokenPx('--size-icon-2xsmall')));
299
+ await expect(glyph('list-row-icon', '.icon-plus')).toEqual(square(tokenPx('--size-icon-xsmall')));
300
+ await expect(glyph('chip-check', '.icon-check')).toEqual(square(tokenPx('--size-icon-2xsmall')));
301
+ },
302
+ };
303
+
304
+ export const States: Story = {
305
+ args: { name: 'check' },
306
+ parameters: {
307
+ docs: { description: { story: 'The same icon in various semantic colors via Tailwind utilities.' } },
308
+ },
309
+ render: () => (
310
+ <Showcase>
311
+ <Section title="Semantic colors">
312
+ <div className="flex flex-col items-center gap-100">
313
+ <Icon name="check" size="large" className="text-status-success" />
314
+ <span className="text-body-xs text-text-secondary">Success</span>
315
+ </div>
316
+ <div className="flex flex-col items-center gap-100">
317
+ <Icon name="warning" size="large" className="text-status-warning" />
318
+ <span className="text-body-xs text-text-secondary">Warning</span>
319
+ </div>
320
+ <div className="flex flex-col items-center gap-100">
321
+ <Icon name="x" size="large" className="text-status-danger" />
322
+ <span className="text-body-xs text-text-secondary">Error</span>
323
+ </div>
324
+ <div className="flex flex-col items-center gap-100">
325
+ <Icon name="info" size="large" className="text-status-info" />
326
+ <span className="text-body-xs text-text-secondary">Info</span>
327
+ </div>
328
+ <div className="flex flex-col items-center gap-100">
329
+ <Icon name="lightbulb" size="large" className="text-icon-brand" />
330
+ <span className="text-body-xs text-text-secondary">Idea</span>
331
+ </div>
332
+ </Section>
333
+ </Showcase>
334
+ ),
335
+ };
336
+
337
+ export const Compositions: Story = {
338
+ args: { name: 'house' },
339
+ parameters: {
340
+ docs: { description: { story: 'Real compositions — breadcrumb, status list, form prefixes, whitespace-nowrap pattern.' } },
341
+ },
342
+ render: () => (
343
+ <Showcase>
344
+ <Section title="Breadcrumb navigation" layout="row">
345
+ <nav className="flex items-center gap-100 text-body-sm text-text-secondary">
346
+ <Icon name="house" />
347
+ <span>Domů</span>
348
+ <Icon name="caret-right-small" />
349
+ <span>Kategorie</span>
350
+ <Icon name="caret-right-small" />
351
+ <span className="text-text-primary">Aktuální</span>
352
+ </nav>
353
+ </Section>
354
+ <Section title="Status list" layout="column">
355
+ <div className="flex items-center gap-200">
356
+ <Icon name="check" className="text-status-success" />
357
+ <span>Operace úspěšně dokončena</span>
358
+ </div>
359
+ <div className="flex items-center gap-200">
360
+ <Icon name="warning" className="text-status-warning" />
361
+ <span>Pozor, zkontrolujte nastavení</span>
362
+ </div>
363
+ <div className="flex items-center gap-200">
364
+ <Icon name="x" className="text-status-danger" />
365
+ <span>Nastala chyba</span>
366
+ </div>
367
+ </Section>
368
+ <Section title="Form prefix">
369
+ {/* fods-lint-disable-next-line demo container width of the story, not a design value */}
370
+ <div className="relative w-[280px]">
371
+ <Icon
372
+ name="magnifying-glass"
373
+ className="absolute left-200 top-1/2 -translate-y-1/2 text-text-tertiary"
374
+ />
375
+ <input
376
+ type="text"
377
+ placeholder="Hledat..."
378
+ className="w-full rounded-200 border border-outline-default py-400 pl-700 pr-200 focus:border-outline-focus focus:outline-none"
379
+ />
380
+ </div>
381
+ </Section>
382
+ <Section
383
+ title="whitespace-nowrap pattern"
384
+ description="The icon never wraps alone — it stays with the last word."
385
+ >
386
+ {/* fods-lint-disable-next-line demo container width of the story, not a design value */}
387
+ <div className="w-[280px] rounded-200 border border-outline-default p-200">
388
+ <a className="text-body-sm font-semibold hover:underline">
389
+ <span className="underline">Vzor faktury s přenesenou daňovou povinností</span>
390
+ <span className="whitespace-nowrap">
391
+ <Icon name="arrow-right" size="small" className="ml-200 inline-block align-middle" />
392
+ </span>
393
+ </a>
394
+ </div>
395
+ </Section>
396
+ </Showcase>
397
+ ),
398
+ };
@@ -0,0 +1,97 @@
1
+ "use client";
2
+ import { FunctionComponent, HTMLAttributes } from 'react';
3
+ import type { IconName } from '../../icons/icon-types.generated';
4
+ import { SVG_ICONS } from '../../icons/icon-registry.generated';
5
+ import { cn } from '../../internal/utils';
6
+
7
+ /**
8
+ * A step of the `--size-icon*` scale (spec/02-tokens: size tokens). `default` is the
9
+ * bare `--size-icon`; the others are `--size-icon-<step>`. There is no px number: an
10
+ * icon is sized by a token or not at all.
11
+ */
12
+ export type IconSize = '2xsmall' | 'xsmall' | 'small' | 'default' | 'large' | 'display';
13
+
14
+ // IconSize → the theme utility that sets width + height from the token
15
+ // (`--spacing-icon*` in styles/theme.generated.css, so `size-icon*` exists).
16
+ const SIZE_CLASS: Record<IconSize, string> = {
17
+ '2xsmall': 'size-icon-2xsmall',
18
+ xsmall: 'size-icon-xsmall',
19
+ small: 'size-icon-small',
20
+ default: 'size-icon',
21
+ large: 'size-icon-large',
22
+ display: 'size-icon-display',
23
+ };
24
+
25
+ export type IconProps = {
26
+ /**
27
+ * The canonical FODS name a manifest uses (`check-circle`, `caret-right-small`).
28
+ * The legacy icon-font spellings (`tick`, `chevron-right-small`) are not accepted:
29
+ * they belong to the legacy icon font.
30
+ */
31
+ name: IconName;
32
+ className?: string;
33
+ /**
34
+ * A step of the `--size-icon*` scale, applied as the glyph's width and height
35
+ * (`size-icon-<step>`). Without it the glyph takes `--size-icon` (24). A component
36
+ * passes its manifest `sizes[].icon` here.
37
+ */
38
+ size?: IconSize;
39
+ /**
40
+ * Passed straight to the `<svg>`. The reason this exists is `data-fods-part`:
41
+ * where a glyph IS a manifest part (Badge binds its icon slot directly on the
42
+ * Icon, with no wrapper span), the attribute has nowhere else to land, and
43
+ * the FODS verifier's runtime pass finds parts by exactly that attribute. Wrapping
44
+ * the glyph instead would add a flex item and move the pill's height.
45
+ */
46
+ } & Pick<HTMLAttributes<HTMLElement>, 'aria-hidden'> & {
47
+ [dataAttribute: `data-${string}`]: string | undefined;
48
+ };
49
+
50
+ // Widened so an unresolved name (CMS content at runtime) can be looked up.
51
+ const drawings: Partial<Record<string, (typeof SVG_ICONS)[IconName]>> = SVG_ICONS;
52
+
53
+ // Inline SVG: a single-path drawing baked into icons/icon-registry.generated.ts by
54
+ // scripts/generate-icons.mjs — a Phosphor path (@phosphor-icons/core; regular weight,
55
+ // bold for the -small tier) or a custom glyph from assets/icons/, in currentColor.
56
+ //
57
+ // Sizing sets width and height from a `--size-icon*` token, never `font-size`: the
58
+ // `size` prop picks the step (`size-icon-<step>`), and without it the glyph takes
59
+ // `--size-icon`. The caller's `className` is merged after it through `cn`, so a
60
+ // `size-*` there replaces the step. A parent that sizes icons in a slot it does not
61
+ // render itself (Button's leading icon, TextLink's icon) sets
62
+ // `[&_.icon]:size-icon-<step>` (ListRow: `[&>.icon]:`): that selector is
63
+ // `.parent .icon` (two classes), so it beats the glyph's own one-class `size-icon`
64
+ // in the same cascade layer regardless of source order — in `styles.css` and in a
65
+ // consumer's own Tailwind build. The flip side: it also beats a `size` passed to a
66
+ // glyph nested inside that slot, which is why ListRow, whose slots host Checkbox,
67
+ // sizes only its direct children.
68
+ //
69
+ // The glyph class is `icon-<name>` (the `icon-` prefix as in the legacy icon font): a bare
70
+ // name such as `table` or `danger` would also match legacy global classes on the
71
+ // host page and restyle the glyph. `.icon` itself
72
+ // (styles/base.css) makes the <svg> inline-block with line-height 1.
73
+ const Icon: FunctionComponent<IconProps> = ({
74
+ name,
75
+ className,
76
+ size = 'default',
77
+ ...rest
78
+ }) => {
79
+ const svg = drawings[name];
80
+ // An unknown name (e.g. from CMS content at runtime) renders nothing.
81
+ if (!svg) return null;
82
+
83
+ return (
84
+ <svg
85
+ viewBox={svg.viewBox}
86
+ fill="currentColor"
87
+ className={cn('icon', `icon-${name}`, SIZE_CLASS[size], className)}
88
+ aria-hidden="true"
89
+ {...rest}
90
+ >
91
+ <path d={svg.d} transform={svg.transform} />
92
+ </svg>
93
+ );
94
+ };
95
+
96
+ export { Icon };
97
+ export type { IconName };
@@ -0,0 +1,2 @@
1
+ export { Icon, type IconProps, type IconName, type IconSize } from './Icon';
2
+ export { AVAILABLE_ICONS } from '../../icons/icon-types.generated';