@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,783 @@
1
+ "use client";
2
+ import * as React from 'react';
3
+ import { AnimatePresence, motion, useIsPresent } from 'motion/react';
4
+ import { tv } from '../../internal/tailwind-variants';
5
+ import { Icon, type IconName, type IconSize } from '../icon/Icon';
6
+ import { CardSelectGroupContext } from './CardSelectGroup';
7
+ import { radioVariants } from '../radio/Radio';
8
+ import { useContentFade } from '../../internal/contentPresence';
9
+ import { useHeightRoom, type HeightRoom } from '../../internal/heightRoom';
10
+ import { cn } from '../../internal/utils';
11
+
12
+ /**
13
+ * CardSelect — the WHOLE-CARD selection control (upstream spec `03-atoms/card-select.md`,
14
+ * manifest **3.0.3**). A bordered card the user picks with a click: a media slot, a
15
+ * semibold label and an optional subtitle, marked Selected by a check-circle (or, in
16
+ * Layout=Option, by its leading radio). It is
17
+ * `Radio` / `Checkbox` wearing a card, for dialogs and wizard steps where a choice needs a
18
+ * visual and a line of description to be made (an authentication-method or two-factor
19
+ * picker, a tax-mode or tax-band tile, a correction-type choice).
20
+ *
21
+ * **It is not the comparison-card.** A card that carries its own CTA button and a
22
+ * benefit list is a separate pattern whose selection lives on a Button; nesting a button
23
+ * or a link in here is explicitly forbidden by the spec (and by the roving radiogroup).
24
+ *
25
+ * **Layout** (`properties[Layout]`, 2.0.0 — replaces the old `Align` axis; `option` 3.0.0):
26
+ * - `stacked` (default) — media on top, the text block below, all left-aligned.
27
+ * - `horizontal` — media left, text right, items vertically centred.
28
+ * - `option` — the card's own input shown as a leading Radio md, vertically centred with
29
+ * the text block; no media, no corner check (the radio carries the selection), and an
30
+ * optional `trailing` status Badge at the end of the label line.
31
+ * The text block reserves `--space-900` of right padding for the checkmark in Horizontal
32
+ * and in a Stacked card without media, so selecting never reflows. Option reserves nothing.
33
+ * Text is always left-aligned; a centred tile is an instance override in the consuming
34
+ * layout (`className`), not a prop.
35
+ *
36
+ * - **Root** — a `div` (spec § Accessibility → Structure, 3.0.0). It owns the chrome:
37
+ * fill, the 1px inset border, radius and the focus ring. It holds the hit area, the
38
+ * Badge and the Details, so a link or field in Details is not swallowed by the label.
39
+ * - **Hit area** — the `<label>`: the selecting hit target and the accessible name of
40
+ * its input. It owns the padding, the layout and the hover (the root washes only while
41
+ * the pointer is on it, so hovering Details does not wash the card).
42
+ * - **Input** — a native `<input type="radio">`, visually hidden with `sr-only` (never
43
+ * `display: none`, which would take it out of the tab order and kill the focus ring).
44
+ * - **Media** — `slots.media`, holding its content directly: an `Icon` glyph (24) or an
45
+ * illustration element at 80×80. 0 vertical padding in every layout. A disabled
46
+ * illustration renders `grayscale` (the manifest's code-side rule). Not in Option.
47
+ * - **Label** / **Subtitle** — `Body/M` Semibold label; `Body/XS` Regular subtitle
48
+ * (`sizes[].runTextStyles.subtitle`). Both wrap to 2 lines. The subtitle is where help
49
+ * lives (no tooltip).
50
+ * - **Check** — `slots.check`: the `check-circle` glyph (`--size-icon`, 24) on a
51
+ * `--bg-primary` disc, absolutely positioned at the top right, inset `--space-600` and
52
+ * CENTRED ON THE MEDIA'S AXIS (on the label's first line when there is no media).
53
+ * Rendered only when selected — the non-colour cue (WCAG 1.4.1). Not in Option.
54
+ * - **Leading control** — `slots.leading-control` (Option only): the Radio md box + dot
55
+ * from `radioVariants`, driven by `peer-*` off the card's own input — not a second
56
+ * input. Its own focus ring is switched off: focus is the card's ring.
57
+ * - **Trailing** — `slots.trailing` (Option only): a caller-supplied status Badge,
58
+ * inside the label after the label text, so it is part of the card's accessible name.
59
+ * It keeps its own colours on a Disabled card (it says why the card is unavailable).
60
+ * - **Badge** — `slots.badge` (every layout): a strip inset `--space-600` on both sides
61
+ * whose vertical centre sits on the top border; `badgeAlign` is the screen's choice.
62
+ * Outside the label, referenced from the input's `aria-describedby`.
63
+ * - **Details** — `slots.details` (Stacked · Option, Selected only): after the label,
64
+ * outside it. Referenced from `aria-describedby` only while it holds nothing focusable;
65
+ * `inert` on a Disabled card.
66
+ *
67
+ * **Card state binds to the card's OWN input only.** The family is derived in JS from the
68
+ * selection, never from `:checked`, and the focus ring keys off `data-card-select-input`,
69
+ * so an input inside Details can neither tint nor ring the card.
70
+ *
71
+ * **How the check is centred without a magic offset.** It is `absolute` with `top: auto`,
72
+ * so it keeps its *static position* — and the static position of an absolutely positioned
73
+ * child of a flex container is computed as if it were the sole flex item, i.e. it obeys
74
+ * `align-items`. In Stacked the check is therefore rendered INSIDE the (unpositioned,
75
+ * `items-center`) media container: it lands centred on the media whatever the media's
76
+ * height (24 icon or 80 illustration), while `right-*` still resolves against the card,
77
+ * the nearest positioned ancestor (the hit area). In Horizontal (with or without media) it is a child of
78
+ * the card itself, whose `items-center` centres it in the card. In a media-less Stacked
79
+ * card (valid since 2.3.1) the check is a child of the `items-start` card, so its top
80
+ * lands on the label's top: Body/M is a 24px line (16 × 1.5), so the centres match exactly.
81
+ * No translate, no per-media-height offset table.
82
+ *
83
+ * **Selection is derived, never a variant**: `checked` › the group's `value` › the card's
84
+ * own state seeded from `defaultChecked`. **`axes.state` is not a prop either**: hover is
85
+ * `:hover` on the hit area (read by the root through `:has()`, `group-hover` for the ink
86
+ * slots), focus is `:focus-visible` on the input, `disabled` is the only state prop.
87
+ *
88
+ * **One combined `family` axis, four values** (`unselected` · `selected` ·
89
+ * `danger-unselected` · `danger-selected`), derived from `tone` + the selection: a family
90
+ * that needs two recipe keys cannot be written into `data-fods-family`, which carries a
91
+ * single value.
92
+ *
93
+ * **Deprecated, kept:** `tone="danger"` (kept for backwards compatibility). Danger has no
94
+ * Option cells — with `layout="option"` the tone is ignored and the card renders
95
+ * Tone=Default. `size="sm"` is gone (3.0.0); `size="md"` stays as a no-op (3.0.1).
96
+ *
97
+ * **Focus ring — `has-[[data-card-select-input]:focus-visible]` on the root, not
98
+ * `peer-focus-visible`.** Tailwind compiles `peer-*` to a general-SIBLING combinator and
99
+ * this input is a descendant of the card, so a `peer-*` rule could never match; the marker
100
+ * attribute (not a bare `input`) keeps a field inside Details from ringing the card. The
101
+ * ring is a CSS outline with a 2px offset, so its corners follow the card radius grown by
102
+ * the offset (≈ 14).
103
+ *
104
+ * **Badge stacking.** The root is `isolate` and the badge strip `-z-10`: it paints over
105
+ * the card fill but under the root's own outline, so the focus ring crosses ABOVE the
106
+ * Badge (spec § Accessibility → Structure).
107
+ */
108
+ const cardSelectVariants = tv({
109
+ slots: {
110
+ // `isolate` scopes the badge's `-z-10`; no `overflow` clip, the Badge protrudes.
111
+ root: [
112
+ 'relative isolate flex w-full flex-col box-border border-100',
113
+ 'has-[[data-card-select-input]:focus-visible]:outline',
114
+ 'has-[[data-card-select-input]:focus-visible]:outline-200',
115
+ 'has-[[data-card-select-input]:focus-visible]:outline-outline-focus',
116
+ 'has-[[data-card-select-input]:focus-visible]:outline-offset-2',
117
+ // Chrome on `states.toggle` (the selection flip). The hover wash rides the same
118
+ // --duration-toggle: one property cannot carry two durations without a hover-keyed
119
+ // class, which the forced-hover twin would have to mirror. The focus ring
120
+ // (outline) is not animated.
121
+ 'transition-[background-color,border-color] duration-toggle ease-standard',
122
+ ],
123
+ // `grow`: a card stretched by its group row keeps the whole box as the hit target and
124
+ // keeps Horizontal content centred in it. Positioned, so the check resolves `right-*`
125
+ // against it.
126
+ hitArea: 'group relative flex w-full grow cursor-pointer',
127
+ // Deliberately NOT positioned: the stacked check inside it must resolve `right-*`
128
+ // against the hit area while taking its vertical static position from this container.
129
+ media: 'flex shrink-0 items-center justify-center py-0 transition-[color] duration-hover ease-standard',
130
+ text: 'flex w-full min-w-0 flex-col gap-200 text-left',
131
+ // Every published Body style binds `--text-wrap-body` (_text-styles.json
132
+ // $textWrapRule). Arbitrary property because Tailwind has no textWrap namespace —
133
+ // `text-pretty` would hard-code the value and stop tracking the token.
134
+ label: 'line-clamp-2 font-semibold [text-wrap:var(--text-wrap-body)] transition-[color] duration-hover ease-standard',
135
+ subtitle: 'line-clamp-2 font-normal transition-[color] duration-hover ease-standard',
136
+ check: 'absolute inline-flex shrink-0 rounded-full bg-background-primary transition-[color] duration-hover ease-standard',
137
+ // Option only: the label line — label fills, the trailing Badge hugs at the right edge.
138
+ titleRow: 'flex w-full min-w-0 items-center gap-400',
139
+ trailing: 'inline-flex shrink-0',
140
+ // `slots.badge`: a strip inset --space-600 on both sides, its vertical centre on the
141
+ // centre line of the 1px top border (top = −border/2, then −50% of its own height).
142
+ badge: [
143
+ 'pointer-events-none absolute inset-x-600 -z-10 flex',
144
+ '-top-[calc(var(--border-width-100)/2)] -translate-y-1/2',
145
+ ],
146
+ details: 'flex flex-col px-600',
147
+ detailsContent: 'min-w-0',
148
+ },
149
+ variants: {
150
+ /** ONE variant per manifest family — derived from `tone` + the selection. */
151
+ family: {
152
+ unselected: {},
153
+ selected: {},
154
+ 'danger-unselected': {},
155
+ 'danger-selected': {},
156
+ },
157
+ size: {
158
+ md: {
159
+ root: 'rounded-500',
160
+ hitArea: 'gap-400 p-600',
161
+ label: 'text-body-base',
162
+ subtitle: 'text-body-xs',
163
+ check: 'right-600',
164
+ details: 'pb-600',
165
+ },
166
+ },
167
+ /** `properties[Layout]` — the 2.0.0 axis that replaced `Align`. */
168
+ layout: {
169
+ stacked: { hitArea: 'flex-col items-start' },
170
+ horizontal: { hitArea: 'flex-row items-center', text: 'pr-900' },
171
+ // Details lines up with the text column: inset --space-900 (radio 20 + gap 12).
172
+ option: {
173
+ hitArea: 'flex-row items-center',
174
+ label: 'min-w-0 flex-1',
175
+ detailsContent: 'pl-900',
176
+ },
177
+ },
178
+ /** `properties[Show badge]` alignment — the consuming screen's choice (a recipe). */
179
+ badgeAlign: {
180
+ start: { badge: 'justify-start' },
181
+ center: { badge: 'justify-center' },
182
+ end: { badge: 'justify-end' },
183
+ },
184
+ /** Derived: `details` given, the card Selected and the layout not Horizontal. */
185
+ hasDetails: {
186
+ true: {},
187
+ false: {},
188
+ },
189
+ /**
190
+ * Derived from the media content, never a public prop. An icon hugs its glyph; an
191
+ * illustration sits in a fixed 80×80 box (`slots.media`).
192
+ */
193
+ mediaKind: {
194
+ icon: {},
195
+ illustration: { media: 'size-illustration-card' },
196
+ },
197
+ /** Derived from `media != null`, never a public prop (`properties[Show media]`). */
198
+ hasMedia: {
199
+ true: {},
200
+ false: {},
201
+ },
202
+ disabled: {
203
+ true: { hitArea: 'cursor-not-allowed' },
204
+ false: {},
205
+ },
206
+ },
207
+ compoundVariants: [
208
+ {
209
+ // Hover only washes the fill: the border is already `--outline-strong` at rest. The
210
+ // chrome sits on the root but reacts to the hit area only (`:has(> label:hover)`),
211
+ // so hovering Details does not wash the card.
212
+ family: 'unselected',
213
+ disabled: false,
214
+ class: {
215
+ root: 'bg-background-primary border-outline-strong has-[>label:hover]:bg-background-hover',
216
+ label: 'text-text-primary',
217
+ subtitle: 'text-text-secondary',
218
+ media: 'text-secondary',
219
+ // Declared although an Unselected card renders no checkmark node: the manifest
220
+ // binds ONE `icon` token per family/state, shared by slots.media and slots.check,
221
+ // so stating it in all four families keeps the aspect gradable per family.
222
+ check: 'text-secondary',
223
+ },
224
+ },
225
+ {
226
+ // Hover is the same chrome as Default here, so no `hover:` class — per the manifest.
227
+ family: 'selected',
228
+ disabled: false,
229
+ class: {
230
+ root: 'bg-secondary-subtle border-secondary',
231
+ label: 'text-text-primary',
232
+ subtitle: 'text-text-secondary',
233
+ media: 'text-secondary',
234
+ check: 'text-secondary',
235
+ },
236
+ },
237
+ {
238
+ // Neutral chrome, danger INK: tint-foreground at rest → danger-hover on Hover.
239
+ family: 'danger-unselected',
240
+ disabled: false,
241
+ class: {
242
+ root: 'bg-background-primary border-outline-strong has-[>label:hover]:bg-background-hover',
243
+ label: 'text-status-danger-tint-foreground group-hover:text-status-danger-hover',
244
+ subtitle: 'text-text-secondary',
245
+ media: 'text-status-danger-tint-foreground group-hover:text-status-danger-hover',
246
+ check: 'text-status-danger-tint-foreground group-hover:text-status-danger-hover',
247
+ },
248
+ },
249
+ {
250
+ // The one cell where the subtitle is NOT `--text-secondary` at rest; it steps BACK
251
+ // to `--text-secondary` on Hover.
252
+ family: 'danger-selected',
253
+ disabled: false,
254
+ class: {
255
+ root: [
256
+ 'bg-status-danger-subtle border-status-danger-subtle-border',
257
+ 'has-[>label:hover]:bg-status-danger-soft',
258
+ 'has-[>label:hover]:border-status-danger-tint-foreground',
259
+ ],
260
+ label: 'text-status-danger-tint-foreground group-hover:text-status-danger-hover',
261
+ subtitle: 'text-status-danger-tint-foreground group-hover:text-text-secondary',
262
+ media: 'text-status-danger-tint-foreground group-hover:text-status-danger-hover',
263
+ check: 'text-status-danger-tint-foreground group-hover:text-status-danger-hover',
264
+ },
265
+ },
266
+
267
+ // Disabled is identical in all four families (the manifest states it for Danger too,
268
+ // as a code contract with no Figma cell). The check disc stays `--bg-primary`.
269
+ {
270
+ family: 'unselected',
271
+ disabled: true,
272
+ class: {
273
+ root: 'bg-disabled-control border-outline-default',
274
+ label: 'text-disabled-foreground',
275
+ subtitle: 'text-disabled-foreground',
276
+ media: 'text-disabled-foreground',
277
+ check: 'text-disabled-foreground',
278
+ },
279
+ },
280
+ {
281
+ // A Selected + Disabled card keeps its checkmark: dropping it would leave selection
282
+ // carried by colour alone (WCAG 1.4.1).
283
+ family: 'selected',
284
+ disabled: true,
285
+ class: {
286
+ root: 'bg-disabled-control border-outline-default',
287
+ label: 'text-disabled-foreground',
288
+ subtitle: 'text-disabled-foreground',
289
+ media: 'text-disabled-foreground',
290
+ check: 'text-disabled-foreground',
291
+ },
292
+ },
293
+ {
294
+ family: 'danger-unselected',
295
+ disabled: true,
296
+ class: {
297
+ root: 'bg-disabled-control border-outline-default',
298
+ label: 'text-disabled-foreground',
299
+ subtitle: 'text-disabled-foreground',
300
+ media: 'text-disabled-foreground',
301
+ check: 'text-disabled-foreground',
302
+ },
303
+ },
304
+ {
305
+ family: 'danger-selected',
306
+ disabled: true,
307
+ class: {
308
+ root: 'bg-disabled-control border-outline-default',
309
+ label: 'text-disabled-foreground',
310
+ subtitle: 'text-disabled-foreground',
311
+ media: 'text-disabled-foreground',
312
+ check: 'text-disabled-foreground',
313
+ },
314
+ },
315
+ // `sizes[md].layouts.{Horizontal,Option}` (2.3.3 / 3.0.0) — the top-level `sizes[]`
316
+ // padding / gap are Stacked's, which the size variant above carries.
317
+ {
318
+ layout: ['horizontal', 'option'],
319
+ size: 'md',
320
+ class: { hitArea: 'gap-500 px-600 py-500', details: 'pb-500' },
321
+ },
322
+ {
323
+ // Details follows the hit area: the row↔details gap (--space-400, the Stacked main
324
+ // gap too) is the hit area's bottom padding, so the gap stays clickable.
325
+ hasDetails: true,
326
+ class: { hitArea: 'pb-400' },
327
+ },
328
+ {
329
+ // 2.3.1: a Stacked card without media reserves the check's room like Horizontal.
330
+ layout: 'stacked',
331
+ hasMedia: false,
332
+ class: { text: 'pr-900' },
333
+ },
334
+ {
335
+ // `slots.media`: "an illustration is rendered greyscale … at full opacity".
336
+ mediaKind: 'illustration',
337
+ disabled: true,
338
+ class: { media: 'grayscale' },
339
+ },
340
+ ],
341
+ defaultVariants: {
342
+ family: 'unselected',
343
+ size: 'md',
344
+ layout: 'stacked',
345
+ mediaKind: 'icon',
346
+ hasMedia: true,
347
+ badgeAlign: 'start',
348
+ hasDetails: false,
349
+ disabled: false,
350
+ },
351
+ });
352
+
353
+ /** md is the only size since 3.0.0; the prop stays as a no-op (3.0.1). */
354
+ export type CardSelectSize = 'md';
355
+ export type CardSelectLayout = 'stacked' | 'horizontal' | 'option';
356
+ export type CardSelectTone = 'default' | 'danger';
357
+ /**
358
+ * One key per manifest family — the recipe's colour axis. Not a prop: the component
359
+ * derives it from `tone` + the selection.
360
+ */
361
+ export type CardSelectFamily =
362
+ | 'unselected'
363
+ | 'selected'
364
+ | 'danger-unselected'
365
+ | 'danger-selected';
366
+ /**
367
+ * The two contents `slots.media` accepts. An `IconName` renders as an `Icon` glyph at the
368
+ * size row's dimension; a `ReactElement` is an illustration asset in an 80×80 box.
369
+ *
370
+ * `ReactElement` rather than `ReactNode` on purpose: `ReactNode` subsumes `string`, so it
371
+ * would type-check `media="not-an-icon"` and silently render a missing glyph.
372
+ */
373
+ export type CardSelectMedia = IconName | React.ReactElement | null;
374
+ /**
375
+ * Horizontal position of the top-border Badge — the consuming screen's choice
376
+ * (`slots.badge`: Left by default, Center or Right on the instance).
377
+ */
378
+ export type CardSelectBadgeAlign = 'start' | 'center' | 'end';
379
+
380
+ /** The danger half of the family axis, keyed by the selection. */
381
+ const DANGER_FAMILY = {
382
+ selected: 'danger-selected',
383
+ unselected: 'danger-unselected',
384
+ } as const satisfies Record<'selected' | 'unselected', CardSelectFamily>;
385
+
386
+ /** Media glyph (`sizes[md].icon`, `--size-icon`). */
387
+ const MEDIA_ICON_SIZE: IconSize = 'default';
388
+ /** Check-circle, `--size-icon` (`slots.check`). */
389
+ const CHECK_ICON_SIZE: IconSize = 'default';
390
+
391
+ /** What makes Details "hold links or fields" (`slots.details`: then it is not referenced). */
392
+ const FOCUSABLE_SELECTOR =
393
+ 'a[href], button, input, select, textarea, [tabindex]:not([tabindex="-1"]), [contenteditable="true"]';
394
+
395
+ /**
396
+ * The Radio md visual for Option's leading control. Two overrides on Radio's own recipe,
397
+ * both from `slots.leading-control`: Selected · Hover renders as Selected · Default (Radio
398
+ * alone deepens its fill on hover), and the box draws no focus ring of its own — the card
399
+ * carries the one ring, so a second one on the box would double it.
400
+ */
401
+ const leadingRadio = (disabled: boolean) => {
402
+ const radio = radioVariants({ size: 'md', disabled });
403
+ return {
404
+ control: radio.control(),
405
+ box: cn(
406
+ radio.box(),
407
+ 'group-hover:peer-enabled:peer-checked:bg-secondary-solid',
408
+ 'peer-focus-visible:ring-0 peer-focus-visible:ring-offset-0',
409
+ ),
410
+ dot: radio.dot(),
411
+ dotInner: radio.dotInner(),
412
+ };
413
+ };
414
+
415
+ export interface CardSelectProps
416
+ extends Omit<React.InputHTMLAttributes<HTMLInputElement>, 'size' | 'type'> {
417
+ /** The option's value — what the group reports through `onValueChange`. */
418
+ value: string;
419
+ /**
420
+ * The choice name (`properties[Label]`). A short noun phrase, 1–3 words, sentence case,
421
+ * no terminal period; it wraps to 2 lines rather than truncating. Always present.
422
+ */
423
+ label: string;
424
+ /**
425
+ * One plain-language line on what the choice means (`properties[Subtitle]`). Wraps to 2
426
+ * lines. Its PRESENCE is the Figma `Support text` boolean — and it is the only place
427
+ * supplementary help may live, since the card takes no tooltip.
428
+ */
429
+ subtitle?: string;
430
+ /**
431
+ * The Media slot — an `Icon` name or an illustration element. Its PRESENCE is the Figma
432
+ * `Show media` boolean, valid off in both layouts. A Stacked card without media centres
433
+ * the check-circle on the label's first line and reserves `--space-900` on the text.
434
+ */
435
+ media?: CardSelectMedia;
436
+ /** `md`, the only size (3.0.0). Kept as a no-op so `size="md"` stays valid (3.0.1). */
437
+ size?: CardSelectSize;
438
+ /**
439
+ * `stacked` (media on top, the default), `horizontal` (media left, text right) or
440
+ * `option` (a leading radio, no media, no corner check). One layout per group.
441
+ */
442
+ layout?: CardSelectLayout;
443
+ /**
444
+ * The Trailing slot (`properties[Show trailing]`) — a status `Badge` with its icon at the
445
+ * end of the label line (`2 dodávatelia`, `Nová`). Layout=Option only; ignored elsewhere.
446
+ * It sits inside the label, so it is part of the card's accessible name. Never put an
447
+ * interactive element here.
448
+ */
449
+ trailing?: React.ReactNode;
450
+ /**
451
+ * The Badge slot (`properties[Show badge]`, every layout) — a recommendation `Badge` with
452
+ * its icon (`Odporúčané`), centred on the card's top border. Outside the label; its text
453
+ * is referenced from the input's `aria-describedby`. Never interactive. In a group with a
454
+ * badged card, keep the gap between cards at least half the badge height.
455
+ */
456
+ badge?: React.ReactNode;
457
+ /**
458
+ * Where the Badge sits along the top border — the screen's choice, `start` by default.
459
+ * Do not use `end` in Stacked or Horizontal: the Badge must never cover the check-circle.
460
+ */
461
+ badgeAlign?: CardSelectBadgeAlign;
462
+ /**
463
+ * The Details slot (`properties[Show details]`) — an `Alert` (Info by default, no `live`)
464
+ * or plain text, rendered ONLY while the card is Selected, in Stacked and Option (ignored
465
+ * in Horizontal). It sits after the label, outside it, so a link or a field inside stays
466
+ * operable and does not select the card. Referenced from `aria-describedby` only while
467
+ * it holds nothing focusable; `inert` on a Disabled card.
468
+ */
469
+ details?: React.ReactNode;
470
+ /**
471
+ * `default` (blue selection) or `danger`.
472
+ * @deprecated `danger` is kept for backwards compatibility only; do not use it
473
+ * in new work. Ignored at `layout="option"` (Danger has no Option cells).
474
+ */
475
+ tone?: CardSelectTone;
476
+ /**
477
+ * `--disabled-control` / `--disabled-foreground` greying — never `opacity`. Propagates
478
+ * to the native input (native `disabled`) and to everything in Details (`inert`).
479
+ */
480
+ disabled?: boolean;
481
+ }
482
+
483
+ const CardSelect = React.forwardRef<HTMLInputElement, CardSelectProps>(
484
+ (
485
+ {
486
+ className,
487
+ value,
488
+ label,
489
+ subtitle,
490
+ media,
491
+ // md is the only size; destructured so it never reaches the input as an attribute.
492
+ size: _size,
493
+ layout,
494
+ trailing,
495
+ badge,
496
+ badgeAlign = 'start',
497
+ details,
498
+ tone,
499
+ disabled,
500
+ id,
501
+ name,
502
+ checked,
503
+ defaultChecked,
504
+ onChange,
505
+ 'aria-describedby': ariaDescribedBy,
506
+ ...props
507
+ },
508
+ ref,
509
+ ) => {
510
+ const generatedId = React.useId();
511
+ const inputId = id ?? generatedId;
512
+ const badgeId = `${inputId}-badge`;
513
+ const detailsId = `${inputId}-details`;
514
+
515
+ const group = React.useContext(CardSelectGroupContext);
516
+
517
+ const resolvedName = name ?? group?.name;
518
+ const resolvedLayout = layout ?? group?.layout ?? 'stacked';
519
+ const resolvedTone = tone ?? group?.tone ?? 'default';
520
+ const resolvedDisabled = disabled ?? group?.disabled ?? false;
521
+
522
+ // Selection, in precedence order: an explicit `checked`, then the group's value, then
523
+ // the card's own state (a lone card outside a group).
524
+ const [internalChecked, setInternalChecked] = React.useState(defaultChecked ?? false);
525
+ const groupChecked = group != null ? group.value === value : undefined;
526
+ const selected = checked ?? groupChecked ?? internalChecked;
527
+
528
+ const selection: 'selected' | 'unselected' = selected ? 'selected' : 'unselected';
529
+ const isOption = resolvedLayout === 'option';
530
+ // Danger has no Option cells: the tone is ignored at Layout=Option.
531
+ const isDanger = resolvedTone === 'danger' && !isOption;
532
+ const family: CardSelectFamily = isDanger ? DANGER_FAMILY[selection] : selection;
533
+
534
+ const radio = isOption ? leadingRadio(resolvedDisabled) : null;
535
+
536
+ const handleChange = (event: React.ChangeEvent<HTMLInputElement>) => {
537
+ onChange?.(event);
538
+ if (group != null) {
539
+ group.onValueChange(value);
540
+ } else if (checked === undefined) {
541
+ setInternalChecked(true);
542
+ }
543
+ };
544
+
545
+ // Option has no media slot.
546
+ const shownMedia = isOption ? null : media;
547
+ const mediaKind =
548
+ shownMedia != null && typeof shownMedia !== 'string' ? 'illustration' : 'icon';
549
+
550
+ // Progressive disclosure: Details only on the Selected card, never in Horizontal.
551
+ const showDetails = details != null && selected && resolvedLayout !== 'horizontal';
552
+ // Details stays in the layout while its exit fade plays; the room closes only after.
553
+ const [detailsMounted, setDetailsMounted] = React.useState(showDetails);
554
+ if (showDetails && !detailsMounted) setDetailsMounted(true);
555
+
556
+ // `motion.layout` (3.0.2): the card's own height moves on `springs.gentle` when Details
557
+ // enters (together with its fade) or has left (after its fade). Height on the card, not
558
+ // Motion `layout` — a transform would scale the border, the radius and the focus ring —
559
+ // so the cards below follow in the normal flow.
560
+ const room = useHeightRoom({ clip: true });
561
+ const roomContentRef = React.useRef(detailsMounted);
562
+ React.useLayoutEffect(() => {
563
+ if (roomContentRef.current === detailsMounted) return;
564
+ roomContentRef.current = detailsMounted;
565
+ room.resize();
566
+ }, [detailsMounted, room]);
567
+
568
+ // Details holding a link or a field is read in tab order, not as a description, so it
569
+ // is referenced only while it holds nothing focusable. Measured after render and on
570
+ // every change inside it, because the content is the caller's and may change on its own.
571
+ const detailsRef = React.useRef<HTMLDivElement>(null);
572
+ const [detailsInteractive, setDetailsInteractive] = React.useState(false);
573
+ React.useLayoutEffect(() => {
574
+ const element = detailsRef.current;
575
+ const measure = () => {
576
+ setDetailsInteractive(element?.querySelector(FOCUSABLE_SELECTOR) != null);
577
+ };
578
+ measure();
579
+ if (element == null || typeof MutationObserver === 'undefined') return undefined;
580
+
581
+ const observer = new MutationObserver(measure);
582
+ observer.observe(element, {
583
+ childList: true,
584
+ subtree: true,
585
+ attributes: true,
586
+ attributeFilter: ['href', 'tabindex', 'contenteditable'],
587
+ });
588
+ return () => observer.disconnect();
589
+ }, [showDetails, details]);
590
+
591
+ const describedBy =
592
+ [
593
+ ariaDescribedBy,
594
+ badge != null ? badgeId : null,
595
+ showDetails && !detailsInteractive ? detailsId : null,
596
+ ]
597
+ .filter(Boolean)
598
+ .join(' ') || undefined;
599
+
600
+ const fade = useContentFade();
601
+ const slots = cardSelectVariants({
602
+ family,
603
+ size: 'md',
604
+ layout: resolvedLayout,
605
+ mediaKind,
606
+ hasMedia: shownMedia != null,
607
+ badgeAlign,
608
+ hasDetails: detailsMounted,
609
+ disabled: resolvedDisabled,
610
+ });
611
+
612
+ // Option: the leading radio carries the selection, so there is no corner check. It
613
+ // fades in on the Details fade (`motion.enter.note`) and leaves with the flip, at once.
614
+ const check = (
615
+ <AnimatePresence initial={false}>
616
+ {selected && !isOption && (
617
+ <motion.span
618
+ key="check"
619
+ data-fods-part="check"
620
+ className={slots.check()}
621
+ initial={fade.initial}
622
+ animate={fade.animate}
623
+ >
624
+ <Icon name="check-circle" size={CHECK_ICON_SIZE} />
625
+ </motion.span>
626
+ )}
627
+ </AnimatePresence>
628
+ );
629
+ // See the recipe note: in Stacked the check lives inside the media container so its
630
+ // static position centres it on the media's axis.
631
+ const checkInMedia = resolvedLayout === 'stacked' && shownMedia != null;
632
+
633
+ const input = (
634
+ <input
635
+ ref={ref}
636
+ id={inputId}
637
+ type="radio"
638
+ name={resolvedName}
639
+ value={value}
640
+ checked={selected}
641
+ onChange={handleChange}
642
+ disabled={resolvedDisabled}
643
+ aria-disabled={resolvedDisabled || undefined}
644
+ aria-describedby={describedBy}
645
+ // The card's state hooks (focus ring) key off this marker, never a bare `input`,
646
+ // so a field inside Details cannot ring the card.
647
+ data-card-select-input=""
648
+ // `peer` drives Option's radio box; harmless in the other layouts.
649
+ className="peer sr-only"
650
+ {...props}
651
+ />
652
+ );
653
+
654
+ const labelText = (
655
+ <span data-fods-part="label" className={slots.label()}>
656
+ {label}
657
+ </span>
658
+ );
659
+
660
+ return (
661
+ <motion.div
662
+ ref={room.setNode}
663
+ style={room.style}
664
+ data-fods-component="card-select"
665
+ data-fods-part="root"
666
+ data-fods-family={family}
667
+ className={cn(slots.root(), className)}
668
+ >
669
+ <label htmlFor={inputId} data-fods-part="hit-area" className={slots.hitArea()}>
670
+ {/*
671
+ Visually hidden, but a real tab stop: `sr-only` keeps the input focusable so the
672
+ card's `:has()` focus ring can fire, which `hidden` / `display: none` would not.
673
+ In Option the input is the leading radio: its visible box is a `peer-*` sibling.
674
+ */}
675
+ {isOption ? (
676
+ <span data-fods-part="leading-control" className={radio?.control}>
677
+ {input}
678
+ <span className={radio?.box} aria-hidden />
679
+ <span className={radio?.dot} aria-hidden>
680
+ <span className={radio?.dotInner} />
681
+ </span>
682
+ </span>
683
+ ) : (
684
+ input
685
+ )}
686
+ {shownMedia != null && (
687
+ <span data-fods-part="media" className={slots.media()}>
688
+ {typeof shownMedia === 'string' ? (
689
+ <Icon name={shownMedia} size={MEDIA_ICON_SIZE} />
690
+ ) : (
691
+ shownMedia
692
+ )}
693
+ {checkInMedia && check}
694
+ </span>
695
+ )}
696
+ <span data-fods-part="text-column" className={slots.text()}>
697
+ {isOption && trailing != null ? (
698
+ <span className={slots.titleRow()}>
699
+ {labelText}
700
+ <span data-fods-part="trailing" className={slots.trailing()}>
701
+ {trailing}
702
+ </span>
703
+ </span>
704
+ ) : (
705
+ labelText
706
+ )}
707
+ {subtitle != null && (
708
+ <span data-fods-part="subtitle" className={slots.subtitle()}>
709
+ {subtitle}
710
+ </span>
711
+ )}
712
+ </span>
713
+ {!checkInMedia && check}
714
+ </label>
715
+ {badge != null && (
716
+ <div data-fods-part="badge" className={slots.badge()}>
717
+ <span id={badgeId} className="inline-flex">
718
+ {badge}
719
+ </span>
720
+ </div>
721
+ )}
722
+ <AnimatePresence initial={false} onExitComplete={() => setDetailsMounted(false)}>
723
+ {showDetails && (
724
+ <CardSelectDetails
725
+ key="details"
726
+ ref={detailsRef}
727
+ room={room}
728
+ id={detailsId}
729
+ disabled={resolvedDisabled}
730
+ className={slots.details()}
731
+ contentClassName={slots.detailsContent()}
732
+ >
733
+ {details}
734
+ </CardSelectDetails>
735
+ )}
736
+ </AnimatePresence>
737
+ </motion.div>
738
+ );
739
+ },
740
+ );
741
+ CardSelect.displayName = 'CardSelect';
742
+
743
+ interface CardSelectDetailsProps {
744
+ id: string;
745
+ room: HeightRoom;
746
+ disabled: boolean;
747
+ className: string;
748
+ contentClassName: string;
749
+ children: React.ReactNode;
750
+ }
751
+
752
+ /**
753
+ * The Details slot with its motion (manifest 3.0.2): it fades in over `--duration-slow` +
754
+ * `--easing-enter` and out over `--duration-fast` + `--easing-exit`; it leaves the DOM once
755
+ * the fade has ended. While it fades out it is `inert`, so its links and fields leave the
756
+ * tab order at once (`motion.collapsed`), and it pins the card's height, which closes only
757
+ * once Details has gone.
758
+ */
759
+ const CardSelectDetails = React.forwardRef<HTMLDivElement, CardSelectDetailsProps>(
760
+ ({ id, room, disabled, className, contentClassName, children }, ref) => {
761
+ const fade = useContentFade();
762
+ const isPresent = useIsPresent();
763
+ React.useLayoutEffect(() => {
764
+ if (isPresent) room.release();
765
+ else room.hold();
766
+ }, [isPresent, room]);
767
+ return (
768
+ <motion.div
769
+ ref={ref}
770
+ id={id}
771
+ data-fods-part="details"
772
+ inert={disabled || !isPresent || undefined}
773
+ className={className}
774
+ {...fade}
775
+ >
776
+ <div className={contentClassName}>{children}</div>
777
+ </motion.div>
778
+ );
779
+ },
780
+ );
781
+ CardSelectDetails.displayName = 'CardSelectDetails';
782
+
783
+ export { CardSelect, cardSelectVariants };