@invoiceonline/ui-react 0.0.0 → 0.2.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 (731) hide show
  1. package/AGENTS.md +100 -0
  2. package/CHANGELOG.md +149 -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-picker/DatePicker.d.ts +53 -0
  60. package/dist/components/date-picker/DatePicker.js +329 -0
  61. package/dist/components/date-picker/index.d.ts +2 -0
  62. package/dist/components/date-picker/index.js +1 -0
  63. package/dist/components/divider/Divider.d.ts +81 -0
  64. package/dist/components/divider/Divider.js +93 -0
  65. package/dist/components/divider/index.d.ts +2 -0
  66. package/dist/components/divider/index.js +1 -0
  67. package/dist/components/drawer/Drawer.d.ts +128 -0
  68. package/dist/components/drawer/Drawer.js +367 -0
  69. package/dist/components/drawer/index.d.ts +2 -0
  70. package/dist/components/drawer/index.js +1 -0
  71. package/dist/components/dropdown-button/DropdownButton.d.ts +72 -0
  72. package/dist/components/dropdown-button/DropdownButton.js +122 -0
  73. package/dist/components/dropdown-button/index.d.ts +2 -0
  74. package/dist/components/dropdown-button/index.js +1 -0
  75. package/dist/components/faq/FAQ.d.ts +135 -0
  76. package/dist/components/faq/FAQ.js +258 -0
  77. package/dist/components/faq/index.d.ts +2 -0
  78. package/dist/components/faq/index.js +1 -0
  79. package/dist/components/field/Field.d.ts +119 -0
  80. package/dist/components/field/Field.js +332 -0
  81. package/dist/components/field/index.d.ts +2 -0
  82. package/dist/components/field/index.js +1 -0
  83. package/dist/components/field-pair/FieldPair.d.ts +210 -0
  84. package/dist/components/field-pair/FieldPair.js +335 -0
  85. package/dist/components/field-pair/index.d.ts +2 -0
  86. package/dist/components/field-pair/index.js +1 -0
  87. package/dist/components/file-upload/FileUpload.d.ts +137 -0
  88. package/dist/components/file-upload/FileUpload.js +434 -0
  89. package/dist/components/file-upload/index.d.ts +2 -0
  90. package/dist/components/file-upload/index.js +1 -0
  91. package/dist/components/filter-chip/FilterChip.d.ts +373 -0
  92. package/dist/components/filter-chip/FilterChip.js +517 -0
  93. package/dist/components/filter-chip/index.d.ts +2 -0
  94. package/dist/components/filter-chip/index.js +1 -0
  95. package/dist/components/filter-facet/FilterFacet.d.ts +116 -0
  96. package/dist/components/filter-facet/FilterFacet.js +632 -0
  97. package/dist/components/filter-facet/index.d.ts +2 -0
  98. package/dist/components/filter-facet/index.js +1 -0
  99. package/dist/components/firm-avatar/FirmAvatar.d.ts +75 -0
  100. package/dist/components/firm-avatar/FirmAvatar.js +119 -0
  101. package/dist/components/firm-avatar/index.d.ts +2 -0
  102. package/dist/components/firm-avatar/index.js +1 -0
  103. package/dist/components/form-actions/FormActions.d.ts +123 -0
  104. package/dist/components/form-actions/FormActions.js +195 -0
  105. package/dist/components/form-actions/index.d.ts +2 -0
  106. package/dist/components/form-actions/index.js +1 -0
  107. package/dist/components/form-block/FormBlock.d.ts +252 -0
  108. package/dist/components/form-block/FormBlock.js +420 -0
  109. package/dist/components/form-block/index.d.ts +3 -0
  110. package/dist/components/form-block/index.js +3 -0
  111. package/dist/components/form-section/FormSection.d.ts +130 -0
  112. package/dist/components/form-section/FormSection.js +206 -0
  113. package/dist/components/form-section/index.d.ts +2 -0
  114. package/dist/components/form-section/index.js +1 -0
  115. package/dist/components/heading/Heading.d.ts +69 -0
  116. package/dist/components/heading/Heading.js +79 -0
  117. package/dist/components/heading/index.d.ts +2 -0
  118. package/dist/components/heading/index.js +1 -0
  119. package/dist/components/heading-group/HeadingGroup.d.ts +258 -0
  120. package/dist/components/heading-group/HeadingGroup.js +255 -0
  121. package/dist/components/heading-group/index.d.ts +2 -0
  122. package/dist/components/heading-group/index.js +1 -0
  123. package/dist/components/hero/Hero.d.ts +268 -0
  124. package/dist/components/hero/Hero.js +316 -0
  125. package/dist/components/hero/index.d.ts +2 -0
  126. package/dist/components/hero/index.js +1 -0
  127. package/dist/components/icon/Icon.d.ts +27 -0
  128. package/dist/components/icon/Icon.js +30 -0
  129. package/dist/components/icon/index.d.ts +3 -0
  130. package/dist/components/icon/index.js +3 -0
  131. package/dist/components/icon-button/IconButton.d.ts +75 -0
  132. package/dist/components/icon-button/IconButton.js +151 -0
  133. package/dist/components/icon-button/index.d.ts +2 -0
  134. package/dist/components/icon-button/index.js +1 -0
  135. package/dist/components/item-row/ItemRow.d.ts +253 -0
  136. package/dist/components/item-row/ItemRow.js +496 -0
  137. package/dist/components/item-row/index.d.ts +2 -0
  138. package/dist/components/item-row/index.js +1 -0
  139. package/dist/components/list-row/ListRow.d.ts +165 -0
  140. package/dist/components/list-row/ListRow.js +233 -0
  141. package/dist/components/list-row/index.d.ts +2 -0
  142. package/dist/components/list-row/index.js +1 -0
  143. package/dist/components/menu/Menu.d.ts +64 -0
  144. package/dist/components/menu/Menu.js +186 -0
  145. package/dist/components/menu/index.d.ts +2 -0
  146. package/dist/components/menu/index.js +1 -0
  147. package/dist/components/modal/Modal.d.ts +272 -0
  148. package/dist/components/modal/Modal.js +788 -0
  149. package/dist/components/modal/index.d.ts +2 -0
  150. package/dist/components/modal/index.js +1 -0
  151. package/dist/components/nav-link/NavLink.d.ts +123 -0
  152. package/dist/components/nav-link/NavLink.js +157 -0
  153. package/dist/components/nav-link/index.d.ts +2 -0
  154. package/dist/components/nav-link/index.js +1 -0
  155. package/dist/components/number-field/NumberField.d.ts +62 -0
  156. package/dist/components/number-field/NumberField.js +210 -0
  157. package/dist/components/number-field/index.d.ts +2 -0
  158. package/dist/components/number-field/index.js +1 -0
  159. package/dist/components/pagination/Pagination.d.ts +133 -0
  160. package/dist/components/pagination/Pagination.js +217 -0
  161. package/dist/components/pagination/index.d.ts +3 -0
  162. package/dist/components/pagination/index.js +3 -0
  163. package/dist/components/popover-surface/index.d.ts +2 -0
  164. package/dist/components/popover-surface/index.js +1 -0
  165. package/dist/components/progress-bar/ProgressBar.d.ts +260 -0
  166. package/dist/components/progress-bar/ProgressBar.js +470 -0
  167. package/dist/components/progress-bar/index.d.ts +2 -0
  168. package/dist/components/progress-bar/index.js +1 -0
  169. package/dist/components/promo-sticker/PromoSticker.d.ts +204 -0
  170. package/dist/components/promo-sticker/PromoSticker.js +177 -0
  171. package/dist/components/promo-sticker/index.d.ts +2 -0
  172. package/dist/components/promo-sticker/index.js +1 -0
  173. package/dist/components/promo-surface/PromoSurface.d.ts +94 -0
  174. package/dist/components/promo-surface/PromoSurface.js +119 -0
  175. package/dist/components/promo-surface/index.d.ts +2 -0
  176. package/dist/components/promo-surface/index.js +1 -0
  177. package/dist/components/radio/Radio.d.ts +92 -0
  178. package/dist/components/radio/Radio.js +171 -0
  179. package/dist/components/radio/index.d.ts +2 -0
  180. package/dist/components/radio/index.js +1 -0
  181. package/dist/components/radio-group/RadioGroup.d.ts +61 -0
  182. package/dist/components/radio-group/RadioGroup.js +51 -0
  183. package/dist/components/radio-group/index.d.ts +2 -0
  184. package/dist/components/radio-group/index.js +1 -0
  185. package/dist/components/select/Select.d.ts +65 -0
  186. package/dist/components/select/Select.js +176 -0
  187. package/dist/components/select/index.d.ts +2 -0
  188. package/dist/components/select/index.js +1 -0
  189. package/dist/components/select-field/SelectField.d.ts +16 -0
  190. package/dist/components/select-field/SelectField.js +55 -0
  191. package/dist/components/select-field/index.d.ts +2 -0
  192. package/dist/components/select-field/index.js +1 -0
  193. package/dist/components/skeleton/Skeleton.d.ts +64 -0
  194. package/dist/components/skeleton/Skeleton.js +65 -0
  195. package/dist/components/skeleton/index.d.ts +2 -0
  196. package/dist/components/skeleton/index.js +1 -0
  197. package/dist/components/split-button/SplitButton.d.ts +80 -0
  198. package/dist/components/split-button/SplitButton.js +182 -0
  199. package/dist/components/split-button/index.d.ts +2 -0
  200. package/dist/components/split-button/index.js +1 -0
  201. package/dist/components/status-summary-bar/StatusSummaryBar.d.ts +118 -0
  202. package/dist/components/status-summary-bar/StatusSummaryBar.js +278 -0
  203. package/dist/components/status-summary-bar/index.d.ts +2 -0
  204. package/dist/components/status-summary-bar/index.js +1 -0
  205. package/dist/components/subject-lookup-field/SubjectLookupField.d.ts +157 -0
  206. package/dist/components/subject-lookup-field/SubjectLookupField.js +663 -0
  207. package/dist/components/subject-lookup-field/index.d.ts +2 -0
  208. package/dist/components/subject-lookup-field/index.js +1 -0
  209. package/dist/components/switch/Switch.d.ts +152 -0
  210. package/dist/components/switch/Switch.js +307 -0
  211. package/dist/components/switch/index.d.ts +2 -0
  212. package/dist/components/switch/index.js +1 -0
  213. package/dist/components/table/Table.d.ts +5 -0
  214. package/dist/components/table/Table.js +601 -0
  215. package/dist/components/table/index.d.ts +6 -0
  216. package/dist/components/table/index.js +6 -0
  217. package/dist/components/text-field/TextField.d.ts +160 -0
  218. package/dist/components/text-field/TextField.js +244 -0
  219. package/dist/components/text-field/index.d.ts +2 -0
  220. package/dist/components/text-field/index.js +1 -0
  221. package/dist/components/text-link/TextLink.d.ts +260 -0
  222. package/dist/components/text-link/TextLink.js +303 -0
  223. package/dist/components/text-link/index.d.ts +2 -0
  224. package/dist/components/text-link/index.js +1 -0
  225. package/dist/components/textarea/Textarea.d.ts +93 -0
  226. package/dist/components/textarea/Textarea.js +256 -0
  227. package/dist/components/textarea/index.d.ts +2 -0
  228. package/dist/components/textarea/index.js +1 -0
  229. package/dist/components/tooltip/Tooltip.d.ts +129 -0
  230. package/dist/components/tooltip/Tooltip.js +457 -0
  231. package/dist/components/tooltip/index.d.ts +2 -0
  232. package/dist/components/tooltip/index.js +1 -0
  233. package/dist/components/unit-field/UnitField.d.ts +46 -0
  234. package/dist/components/unit-field/UnitField.js +133 -0
  235. package/dist/components/unit-field/index.d.ts +2 -0
  236. package/dist/components/unit-field/index.js +1 -0
  237. package/dist/icons/icon-registry.generated.js +500 -0
  238. package/dist/icons/icon-types.generated.d.ts +2 -0
  239. package/dist/icons/icon-types.generated.js +126 -0
  240. package/dist/index.d.ts +130 -0
  241. package/dist/index.js +74 -0
  242. package/dist/internal/BottomSheet.js +496 -0
  243. package/dist/internal/FodsProvider.d.ts +25 -0
  244. package/dist/internal/FodsProvider.js +32 -0
  245. package/dist/internal/MotionCaret.js +35 -0
  246. package/dist/internal/NumberFormatInput.d.ts +21 -0
  247. package/dist/internal/NumberFormatInput.js +126 -0
  248. package/dist/internal/SummaryDonut.d.ts +3 -0
  249. package/dist/internal/SummaryDonut.js +300 -0
  250. package/dist/internal/buttonSegment.d.ts +44 -0
  251. package/dist/internal/buttonSegment.js +126 -0
  252. package/dist/internal/collapseRoom.js +128 -0
  253. package/dist/internal/comboboxKeys.js +44 -0
  254. package/dist/internal/contentPresence.js +46 -0
  255. package/dist/internal/dayCell.js +95 -0
  256. package/dist/internal/dialogPortal.d.ts +2 -0
  257. package/dist/internal/dialogPortal.js +21 -0
  258. package/dist/internal/donutSweeps.js +65 -0
  259. package/dist/internal/enterOnViewGeometry.js +46 -0
  260. package/dist/internal/faqItem.js +80 -0
  261. package/dist/internal/floatingLabelMotion.js +68 -0
  262. package/dist/internal/formBlockContext.d.ts +22 -0
  263. package/dist/internal/formBlockContext.js +20 -0
  264. package/dist/internal/heightRoom.js +87 -0
  265. package/dist/internal/numberSeparators.js +62 -0
  266. package/dist/internal/overlayMotion.js +48 -0
  267. package/dist/internal/paginationItem.d.ts +8 -0
  268. package/dist/internal/paginationItem.js +22 -0
  269. package/dist/internal/popoverSurface.d.ts +8 -0
  270. package/dist/internal/popoverSurface.js +23 -0
  271. package/dist/internal/portalContainer.d.ts +1 -0
  272. package/dist/internal/portalContainer.js +6 -0
  273. package/dist/internal/progressBarItem.d.ts +207 -0
  274. package/dist/internal/progressBarItem.js +264 -0
  275. package/dist/internal/selectionControlText.js +12 -0
  276. package/dist/internal/statusSummaryParts.js +371 -0
  277. package/dist/internal/summaryMotion.js +75 -0
  278. package/dist/internal/table/ChildConnector.js +62 -0
  279. package/dist/internal/table/ChildRowPrefix.d.ts +9 -0
  280. package/dist/internal/table/ChildRowPrefix.js +27 -0
  281. package/dist/internal/table/ColumnSettings.js +135 -0
  282. package/dist/internal/table/ScrollRegion.js +114 -0
  283. package/dist/internal/table/TableEmpty.js +93 -0
  284. package/dist/internal/table/TableLayout.d.ts +17 -0
  285. package/dist/internal/table/TableLayout.js +29 -0
  286. package/dist/internal/table/TableLoadStatus.js +56 -0
  287. package/dist/internal/table/TableMobile.js +488 -0
  288. package/dist/internal/table/TruncatedCell.js +33 -0
  289. package/dist/internal/table/emptyValue.js +10 -0
  290. package/dist/internal/table/features.d.ts +41 -0
  291. package/dist/internal/table/features.js +31 -0
  292. package/dist/internal/table/recipes.js +227 -0
  293. package/dist/internal/table/rowClick.js +9 -0
  294. package/dist/internal/table/types.d.ts +325 -0
  295. package/dist/internal/table/types.js +13 -0
  296. package/dist/internal/tailwind-variants.d.ts +3 -0
  297. package/dist/internal/tailwind-variants.js +37 -0
  298. package/dist/internal/tooltipContext.js +5 -0
  299. package/dist/internal/tw-merge-config.generated.js +314 -0
  300. package/dist/internal/useAnchoredPanel.d.ts +87 -0
  301. package/dist/internal/useAnchoredPanel.js +108 -0
  302. package/dist/internal/useCountUp.js +53 -0
  303. package/dist/internal/useDateFieldTrigger.d.ts +60 -0
  304. package/dist/internal/useDateFieldTrigger.js +235 -0
  305. package/dist/internal/useEChart.js +59 -0
  306. package/dist/internal/useEnterOnView.js +42 -0
  307. package/dist/internal/useFloatingBar.js +100 -0
  308. package/dist/internal/useFormReset.js +44 -0
  309. package/dist/internal/useIsMobile.js +44 -0
  310. package/dist/internal/useOneRowOverflow.js +88 -0
  311. package/dist/internal/usePrefersReducedMotion.js +25 -0
  312. package/dist/internal/useReturnFocus.js +26 -0
  313. package/dist/internal/utils.d.ts +7 -0
  314. package/dist/internal/utils.js +58 -0
  315. package/dist/node_modules/@tanstack/store/dist/store.d.ts +29 -0
  316. package/dist/node_modules/@tanstack/store/dist/types.d.ts +38 -0
  317. package/dist/node_modules/@tanstack/table-core/dist/core/cells/coreCellsFeature.d.ts +6 -0
  318. package/dist/node_modules/@tanstack/table-core/dist/core/cells/coreCellsFeature.types.d.ts +53 -0
  319. package/dist/node_modules/@tanstack/table-core/dist/core/columns/coreColumnsFeature.d.ts +6 -0
  320. package/dist/node_modules/@tanstack/table-core/dist/core/columns/coreColumnsFeature.types.d.ts +90 -0
  321. package/dist/node_modules/@tanstack/table-core/dist/core/coreFeatures.d.ts +17 -0
  322. package/dist/node_modules/@tanstack/table-core/dist/core/headers/coreHeadersFeature.d.ts +6 -0
  323. package/dist/node_modules/@tanstack/table-core/dist/core/headers/coreHeadersFeature.types.d.ts +114 -0
  324. package/dist/node_modules/@tanstack/table-core/dist/core/reactivity/coreReactivityFeature.types.d.ts +51 -0
  325. package/dist/node_modules/@tanstack/table-core/dist/core/row-models/coreRowModelsFeature.d.ts +6 -0
  326. package/dist/node_modules/@tanstack/table-core/dist/core/row-models/coreRowModelsFeature.types.d.ts +29 -0
  327. package/dist/node_modules/@tanstack/table-core/dist/core/rows/coreRowsFeature.d.ts +6 -0
  328. package/dist/node_modules/@tanstack/table-core/dist/core/rows/coreRowsFeature.types.d.ts +129 -0
  329. package/dist/node_modules/@tanstack/table-core/dist/core/table/coreTablesFeature.d.ts +6 -0
  330. package/dist/node_modules/@tanstack/table-core/dist/core/table/coreTablesFeature.types.d.ts +203 -0
  331. package/dist/node_modules/@tanstack/table-core/dist/features/cell-selection/cellSelectionFeature.d.ts +6 -0
  332. package/dist/node_modules/@tanstack/table-core/dist/features/cell-selection/cellSelectionFeature.types.d.ts +294 -0
  333. package/dist/node_modules/@tanstack/table-core/dist/features/cell-spanning/cellSpanningFeature.d.ts +11 -0
  334. package/dist/node_modules/@tanstack/table-core/dist/features/cell-spanning/cellSpanningFeature.types.d.ts +148 -0
  335. package/dist/node_modules/@tanstack/table-core/dist/features/column-faceting/columnFacetingFeature.d.ts +12 -0
  336. package/dist/node_modules/@tanstack/table-core/dist/features/column-faceting/columnFacetingFeature.types.d.ts +63 -0
  337. package/dist/node_modules/@tanstack/table-core/dist/features/column-filtering/columnFilteringFeature.d.ts +6 -0
  338. package/dist/node_modules/@tanstack/table-core/dist/features/column-filtering/columnFilteringFeature.types.d.ts +209 -0
  339. package/dist/node_modules/@tanstack/table-core/dist/features/column-filtering/filterFns.d.ts +35 -0
  340. package/dist/node_modules/@tanstack/table-core/dist/features/column-grouping/columnGroupingFeature.d.ts +6 -0
  341. package/dist/node_modules/@tanstack/table-core/dist/features/column-grouping/columnGroupingFeature.types.d.ts +128 -0
  342. package/dist/node_modules/@tanstack/table-core/dist/features/column-ordering/columnOrderingFeature.d.ts +6 -0
  343. package/dist/node_modules/@tanstack/table-core/dist/features/column-ordering/columnOrderingFeature.types.d.ts +82 -0
  344. package/dist/node_modules/@tanstack/table-core/dist/features/column-pinning/columnPinningFeature.d.ts +11 -0
  345. package/dist/node_modules/@tanstack/table-core/dist/features/column-pinning/columnPinningFeature.types.d.ts +195 -0
  346. package/dist/node_modules/@tanstack/table-core/dist/features/column-resizing/columnResizingFeature.d.ts +6 -0
  347. package/dist/node_modules/@tanstack/table-core/dist/features/column-resizing/columnResizingFeature.types.d.ts +73 -0
  348. package/dist/node_modules/@tanstack/table-core/dist/features/column-sizing/columnSizingFeature.d.ts +6 -0
  349. package/dist/node_modules/@tanstack/table-core/dist/features/column-sizing/columnSizingFeature.types.d.ts +134 -0
  350. package/dist/node_modules/@tanstack/table-core/dist/features/column-visibility/columnVisibilityFeature.d.ts +6 -0
  351. package/dist/node_modules/@tanstack/table-core/dist/features/column-visibility/columnVisibilityFeature.types.d.ts +92 -0
  352. package/dist/node_modules/@tanstack/table-core/dist/features/global-filtering/globalFilteringFeature.d.ts +6 -0
  353. package/dist/node_modules/@tanstack/table-core/dist/features/global-filtering/globalFilteringFeature.types.d.ts +67 -0
  354. package/dist/node_modules/@tanstack/table-core/dist/features/row-aggregation/aggregationFns.d.ts +23 -0
  355. package/dist/node_modules/@tanstack/table-core/dist/features/row-aggregation/rowAggregationFeature.d.ts +6 -0
  356. package/dist/node_modules/@tanstack/table-core/dist/features/row-aggregation/rowAggregationFeature.types.d.ts +183 -0
  357. package/dist/node_modules/@tanstack/table-core/dist/features/row-aggregation/rowAggregationFeature.utils.d.ts +18 -0
  358. package/dist/node_modules/@tanstack/table-core/dist/features/row-expanding/rowExpandingFeature.d.ts +6 -0
  359. package/dist/node_modules/@tanstack/table-core/dist/features/row-expanding/rowExpandingFeature.types.d.ts +125 -0
  360. package/dist/node_modules/@tanstack/table-core/dist/features/row-pagination/rowPaginationFeature.d.ts +6 -0
  361. package/dist/node_modules/@tanstack/table-core/dist/features/row-pagination/rowPaginationFeature.types.d.ts +135 -0
  362. package/dist/node_modules/@tanstack/table-core/dist/features/row-pinning/rowPinningFeature.d.ts +6 -0
  363. package/dist/node_modules/@tanstack/table-core/dist/features/row-pinning/rowPinningFeature.types.d.ts +76 -0
  364. package/dist/node_modules/@tanstack/table-core/dist/features/row-selection/rowSelectionFeature.d.ts +6 -0
  365. package/dist/node_modules/@tanstack/table-core/dist/features/row-selection/rowSelectionFeature.types.d.ts +187 -0
  366. package/dist/node_modules/@tanstack/table-core/dist/features/row-sorting/rowSortingFeature.d.ts +6 -0
  367. package/dist/node_modules/@tanstack/table-core/dist/features/row-sorting/rowSortingFeature.types.d.ts +236 -0
  368. package/dist/node_modules/@tanstack/table-core/dist/features/row-sorting/sortFns.d.ts +23 -0
  369. package/dist/node_modules/@tanstack/table-core/dist/features/stockFeatures.d.ts +37 -0
  370. package/dist/node_modules/@tanstack/table-core/dist/helpers/columnHelper.d.ts +47 -0
  371. package/dist/node_modules/@tanstack/table-core/dist/types/Cell.d.ts +16 -0
  372. package/dist/node_modules/@tanstack/table-core/dist/types/Column.d.ts +30 -0
  373. package/dist/node_modules/@tanstack/table-core/dist/types/ColumnDef.d.ts +123 -0
  374. package/dist/node_modules/@tanstack/table-core/dist/types/Header.d.ts +12 -0
  375. package/dist/node_modules/@tanstack/table-core/dist/types/HeaderGroup.d.ts +6 -0
  376. package/dist/node_modules/@tanstack/table-core/dist/types/Row.d.ts +24 -0
  377. package/dist/node_modules/@tanstack/table-core/dist/types/RowModel.d.ts +19 -0
  378. package/dist/node_modules/@tanstack/table-core/dist/types/RowModelFns.d.ts +11 -0
  379. package/dist/node_modules/@tanstack/table-core/dist/types/Table.d.ts +53 -0
  380. package/dist/node_modules/@tanstack/table-core/dist/types/TableFeatures.d.ts +416 -0
  381. package/dist/node_modules/@tanstack/table-core/dist/types/TableOptions.d.ts +78 -0
  382. package/dist/node_modules/@tanstack/table-core/dist/types/TableState.d.ts +46 -0
  383. package/dist/node_modules/@tanstack/table-core/dist/types/type-utils.d.ts +25 -0
  384. package/dist/shared.css +179 -0
  385. package/dist/styles.css +5467 -0
  386. package/dist/theme.css +314 -0
  387. package/dist/theme.map.json +278 -0
  388. package/dist/tokens/index.d.ts +2 -0
  389. package/dist/tokens/index.js +1 -0
  390. package/dist/tokens/tokens.generated.d.ts +2040 -0
  391. package/dist/tokens/tokens.generated.js +2053 -0
  392. package/dist/tokens.css +484 -0
  393. package/dist/tokens.flat.json +429 -0
  394. package/docs/Consuming.mdx +396 -0
  395. package/docs/Contributing.mdx +78 -0
  396. package/docs/ForAgents.mdx +53 -0
  397. package/docs/Introduction.mdx +54 -0
  398. package/llms.txt +550 -0
  399. package/package.json +347 -3
  400. package/src/components/action-row/ActionRow.mdx +686 -0
  401. package/src/components/action-row/ActionRow.stories.tsx +669 -0
  402. package/src/components/action-row/ActionRow.tsx +632 -0
  403. package/src/components/action-row/index.ts +9 -0
  404. package/src/components/alert/Alert.mdx +377 -0
  405. package/src/components/alert/Alert.stories.tsx +674 -0
  406. package/src/components/alert/Alert.tsx +579 -0
  407. package/src/components/alert/index.ts +13 -0
  408. package/src/components/anchored-panel/AnchoredPanel.mdx +381 -0
  409. package/src/components/anchored-panel/AnchoredPanel.stories.tsx +593 -0
  410. package/src/components/anchored-panel/AnchoredPanel.tsx +176 -0
  411. package/src/components/anchored-panel/index.ts +15 -0
  412. package/src/components/badge/Badge.mdx +487 -0
  413. package/src/components/badge/Badge.stories.tsx +375 -0
  414. package/src/components/badge/Badge.tsx +360 -0
  415. package/src/components/badge/index.ts +10 -0
  416. package/src/components/banner/Banner.mdx +704 -0
  417. package/src/components/banner/Banner.stories.tsx +448 -0
  418. package/src/components/banner/Banner.tsx +602 -0
  419. package/src/components/banner/index.ts +14 -0
  420. package/src/components/button/Button.mdx +286 -0
  421. package/src/components/button/Button.stories.tsx +381 -0
  422. package/src/components/button/Button.tsx +384 -0
  423. package/src/components/button/index.ts +1 -0
  424. package/src/components/button-group/ButtonGroup.mdx +512 -0
  425. package/src/components/button-group/ButtonGroup.stories.tsx +714 -0
  426. package/src/components/button-group/ButtonGroup.tsx +491 -0
  427. package/src/components/button-group/index.ts +10 -0
  428. package/src/components/card-select/CardSelect.mdx +662 -0
  429. package/src/components/card-select/CardSelect.stories.tsx +784 -0
  430. package/src/components/card-select/CardSelect.tsx +783 -0
  431. package/src/components/card-select/CardSelectGroup.tsx +169 -0
  432. package/src/components/card-select/index.ts +18 -0
  433. package/src/components/checkbox/Checkbox.mdx +269 -0
  434. package/src/components/checkbox/Checkbox.stories.tsx +306 -0
  435. package/src/components/checkbox/Checkbox.tsx +343 -0
  436. package/src/components/checkbox/index.ts +1 -0
  437. package/src/components/chip/Chip.mdx +683 -0
  438. package/src/components/chip/Chip.stories.tsx +734 -0
  439. package/src/components/chip/Chip.tsx +732 -0
  440. package/src/components/chip/index.ts +9 -0
  441. package/src/components/column-header/ColumnHeader.mdx +301 -0
  442. package/src/components/column-header/ColumnHeader.stories.tsx +319 -0
  443. package/src/components/column-header/ColumnHeader.tsx +287 -0
  444. package/src/components/column-header/index.ts +7 -0
  445. package/src/components/combobox-field/Combobox.tsx +693 -0
  446. package/src/components/combobox-field/ComboboxField.mdx +525 -0
  447. package/src/components/combobox-field/ComboboxField.stories.tsx +502 -0
  448. package/src/components/combobox-field/ComboboxField.tsx +259 -0
  449. package/src/components/combobox-field/index.ts +12 -0
  450. package/src/components/date-picker/DatePicker.mdx +440 -0
  451. package/src/components/date-picker/DatePicker.stories.tsx +458 -0
  452. package/src/components/date-picker/DatePicker.tsx +688 -0
  453. package/src/components/date-picker/index.ts +9 -0
  454. package/src/components/divider/Divider.mdx +256 -0
  455. package/src/components/divider/Divider.stories.tsx +177 -0
  456. package/src/components/divider/Divider.tsx +193 -0
  457. package/src/components/divider/index.ts +1 -0
  458. package/src/components/drawer/Drawer.mdx +518 -0
  459. package/src/components/drawer/Drawer.stories.tsx +392 -0
  460. package/src/components/drawer/Drawer.tsx +683 -0
  461. package/src/components/drawer/index.ts +1 -0
  462. package/src/components/dropdown-button/DropdownButton.mdx +285 -0
  463. package/src/components/dropdown-button/DropdownButton.stories.tsx +398 -0
  464. package/src/components/dropdown-button/DropdownButton.tsx +198 -0
  465. package/src/components/dropdown-button/index.ts +7 -0
  466. package/src/components/faq/FAQ.mdx +364 -0
  467. package/src/components/faq/FAQ.stories.tsx +343 -0
  468. package/src/components/faq/FAQ.tsx +337 -0
  469. package/src/components/faq/index.ts +1 -0
  470. package/src/components/field/Field.mdx +129 -0
  471. package/src/components/field/Field.stories.tsx +461 -0
  472. package/src/components/field/Field.tsx +787 -0
  473. package/src/components/field/index.ts +20 -0
  474. package/src/components/field-pair/FieldPair.mdx +312 -0
  475. package/src/components/field-pair/FieldPair.stories.tsx +539 -0
  476. package/src/components/field-pair/FieldPair.tsx +845 -0
  477. package/src/components/field-pair/index.ts +9 -0
  478. package/src/components/file-upload/FileUpload.mdx +345 -0
  479. package/src/components/file-upload/FileUpload.stories.tsx +698 -0
  480. package/src/components/file-upload/FileUpload.tsx +802 -0
  481. package/src/components/file-upload/index.ts +6 -0
  482. package/src/components/filter-chip/FilterChip.mdx +778 -0
  483. package/src/components/filter-chip/FilterChip.stories.tsx +827 -0
  484. package/src/components/filter-chip/FilterChip.tsx +881 -0
  485. package/src/components/filter-chip/index.ts +11 -0
  486. package/src/components/filter-facet/FilterFacet.mdx +536 -0
  487. package/src/components/filter-facet/FilterFacet.stories.tsx +506 -0
  488. package/src/components/filter-facet/FilterFacet.tsx +1160 -0
  489. package/src/components/filter-facet/index.ts +7 -0
  490. package/src/components/firm-avatar/FirmAvatar.mdx +280 -0
  491. package/src/components/firm-avatar/FirmAvatar.stories.tsx +147 -0
  492. package/src/components/firm-avatar/FirmAvatar.tsx +172 -0
  493. package/src/components/firm-avatar/index.ts +7 -0
  494. package/src/components/form-actions/FormActions.mdx +518 -0
  495. package/src/components/form-actions/FormActions.stories.tsx +621 -0
  496. package/src/components/form-actions/FormActions.tsx +273 -0
  497. package/src/components/form-actions/index.ts +6 -0
  498. package/src/components/form-block/FormBlock.mdx +728 -0
  499. package/src/components/form-block/FormBlock.stories.tsx +813 -0
  500. package/src/components/form-block/FormBlock.tsx +679 -0
  501. package/src/components/form-block/index.ts +13 -0
  502. package/src/components/form-section/FormSection.mdx +436 -0
  503. package/src/components/form-section/FormSection.stories.tsx +407 -0
  504. package/src/components/form-section/FormSection.tsx +290 -0
  505. package/src/components/form-section/index.ts +17 -0
  506. package/src/components/heading/Heading.mdx +206 -0
  507. package/src/components/heading/Heading.stories.tsx +169 -0
  508. package/src/components/heading/Heading.tsx +124 -0
  509. package/src/components/heading/index.ts +8 -0
  510. package/src/components/heading-group/HeadingGroup.mdx +521 -0
  511. package/src/components/heading-group/HeadingGroup.stories.tsx +353 -0
  512. package/src/components/heading-group/HeadingGroup.tsx +396 -0
  513. package/src/components/heading-group/index.ts +7 -0
  514. package/src/components/hero/Hero.mdx +742 -0
  515. package/src/components/hero/Hero.stories.tsx +527 -0
  516. package/src/components/hero/Hero.tsx +807 -0
  517. package/src/components/hero/index.ts +1 -0
  518. package/src/components/icon/Icon.mdx +329 -0
  519. package/src/components/icon/Icon.stories.tsx +398 -0
  520. package/src/components/icon/Icon.tsx +97 -0
  521. package/src/components/icon/index.ts +2 -0
  522. package/src/components/icon-button/IconButton.mdx +206 -0
  523. package/src/components/icon-button/IconButton.stories.tsx +341 -0
  524. package/src/components/icon-button/IconButton.tsx +273 -0
  525. package/src/components/icon-button/index.ts +1 -0
  526. package/src/components/item-row/ItemRow.mdx +533 -0
  527. package/src/components/item-row/ItemRow.stories.tsx +434 -0
  528. package/src/components/item-row/ItemRow.tsx +676 -0
  529. package/src/components/item-row/index.ts +9 -0
  530. package/src/components/list-row/ListRow.mdx +404 -0
  531. package/src/components/list-row/ListRow.stories.tsx +404 -0
  532. package/src/components/list-row/ListRow.tsx +424 -0
  533. package/src/components/list-row/index.ts +1 -0
  534. package/src/components/menu/Menu.mdx +268 -0
  535. package/src/components/menu/Menu.stories.tsx +455 -0
  536. package/src/components/menu/Menu.tsx +452 -0
  537. package/src/components/menu/index.ts +1 -0
  538. package/src/components/modal/Modal.mdx +854 -0
  539. package/src/components/modal/Modal.stories.tsx +881 -0
  540. package/src/components/modal/Modal.tsx +1434 -0
  541. package/src/components/modal/index.ts +1 -0
  542. package/src/components/nav-link/NavLink.mdx +196 -0
  543. package/src/components/nav-link/NavLink.stories.tsx +243 -0
  544. package/src/components/nav-link/NavLink.tsx +222 -0
  545. package/src/components/nav-link/index.ts +1 -0
  546. package/src/components/number-field/NumberField.mdx +223 -0
  547. package/src/components/number-field/NumberField.stories.tsx +291 -0
  548. package/src/components/number-field/NumberField.tsx +388 -0
  549. package/src/components/number-field/index.ts +6 -0
  550. package/src/components/pagination/Pagination.mdx +305 -0
  551. package/src/components/pagination/Pagination.stories.tsx +333 -0
  552. package/src/components/pagination/Pagination.tsx +343 -0
  553. package/src/components/pagination/index.ts +8 -0
  554. package/src/components/popover-surface/PopoverSurface.mdx +158 -0
  555. package/src/components/popover-surface/PopoverSurface.stories.tsx +421 -0
  556. package/src/components/popover-surface/index.ts +1 -0
  557. package/src/components/progress-bar/ProgressBar.mdx +802 -0
  558. package/src/components/progress-bar/ProgressBar.stories.tsx +533 -0
  559. package/src/components/progress-bar/ProgressBar.tsx +654 -0
  560. package/src/components/progress-bar/index.ts +9 -0
  561. package/src/components/promo-sticker/PromoSticker.mdx +436 -0
  562. package/src/components/promo-sticker/PromoSticker.stories.tsx +363 -0
  563. package/src/components/promo-sticker/PromoSticker.tsx +313 -0
  564. package/src/components/promo-sticker/index.ts +7 -0
  565. package/src/components/promo-surface/PromoSurface.mdx +399 -0
  566. package/src/components/promo-surface/PromoSurface.stories.tsx +270 -0
  567. package/src/components/promo-surface/PromoSurface.tsx +305 -0
  568. package/src/components/promo-surface/index.ts +7 -0
  569. package/src/components/radio/Radio.mdx +243 -0
  570. package/src/components/radio/Radio.stories.tsx +307 -0
  571. package/src/components/radio/Radio.tsx +288 -0
  572. package/src/components/radio/index.ts +1 -0
  573. package/src/components/radio-group/RadioGroup.mdx +119 -0
  574. package/src/components/radio-group/RadioGroup.stories.tsx +225 -0
  575. package/src/components/radio-group/RadioGroup.tsx +139 -0
  576. package/src/components/radio-group/index.ts +1 -0
  577. package/src/components/select/Select.mdx +241 -0
  578. package/src/components/select/Select.stories.tsx +404 -0
  579. package/src/components/select/Select.tsx +381 -0
  580. package/src/components/select/index.ts +1 -0
  581. package/src/components/select-field/SelectField.mdx +324 -0
  582. package/src/components/select-field/SelectField.stories.tsx +460 -0
  583. package/src/components/select-field/SelectField.tsx +138 -0
  584. package/src/components/select-field/index.ts +1 -0
  585. package/src/components/skeleton/Skeleton.mdx +194 -0
  586. package/src/components/skeleton/Skeleton.stories.tsx +260 -0
  587. package/src/components/skeleton/Skeleton.tsx +107 -0
  588. package/src/components/skeleton/index.ts +1 -0
  589. package/src/components/split-button/SplitButton.mdx +445 -0
  590. package/src/components/split-button/SplitButton.stories.tsx +465 -0
  591. package/src/components/split-button/SplitButton.tsx +361 -0
  592. package/src/components/split-button/index.ts +7 -0
  593. package/src/components/status-summary-bar/StatusSummaryBar.mdx +338 -0
  594. package/src/components/status-summary-bar/StatusSummaryBar.stories.tsx +408 -0
  595. package/src/components/status-summary-bar/StatusSummaryBar.tsx +428 -0
  596. package/src/components/status-summary-bar/index.ts +8 -0
  597. package/src/components/subject-lookup-field/SubjectLookupField.mdx +378 -0
  598. package/src/components/subject-lookup-field/SubjectLookupField.stories.tsx +393 -0
  599. package/src/components/subject-lookup-field/SubjectLookupField.tsx +1079 -0
  600. package/src/components/subject-lookup-field/index.ts +11 -0
  601. package/src/components/switch/Switch.mdx +376 -0
  602. package/src/components/switch/Switch.stories.tsx +296 -0
  603. package/src/components/switch/Switch.tsx +483 -0
  604. package/src/components/switch/index.ts +1 -0
  605. package/src/components/table/Table.mdx +575 -0
  606. package/src/components/table/Table.stories.tsx +1049 -0
  607. package/src/components/table/Table.tsx +745 -0
  608. package/src/components/table/TableConsumers.stories.tsx +195 -0
  609. package/src/components/table/_tableFixtures.ts +1189 -0
  610. package/src/components/table/index.ts +22 -0
  611. package/src/components/text-field/TextField.mdx +699 -0
  612. package/src/components/text-field/TextField.stories.tsx +674 -0
  613. package/src/components/text-field/TextField.tsx +645 -0
  614. package/src/components/text-field/index.ts +11 -0
  615. package/src/components/text-link/TextLink.mdx +353 -0
  616. package/src/components/text-link/TextLink.stories.tsx +458 -0
  617. package/src/components/text-link/TextLink.tsx +504 -0
  618. package/src/components/text-link/index.ts +10 -0
  619. package/src/components/textarea/Textarea.mdx +244 -0
  620. package/src/components/textarea/Textarea.stories.tsx +371 -0
  621. package/src/components/textarea/Textarea.tsx +489 -0
  622. package/src/components/textarea/index.ts +9 -0
  623. package/src/components/tooltip/Tooltip.mdx +462 -0
  624. package/src/components/tooltip/Tooltip.stories.tsx +500 -0
  625. package/src/components/tooltip/Tooltip.tsx +756 -0
  626. package/src/components/tooltip/index.ts +13 -0
  627. package/src/components/unit-field/UnitField.mdx +215 -0
  628. package/src/components/unit-field/UnitField.stories.tsx +291 -0
  629. package/src/components/unit-field/UnitField.tsx +255 -0
  630. package/src/components/unit-field/index.ts +7 -0
  631. package/src/icons/icon-registry.generated.ts +510 -0
  632. package/src/icons/icon-types.generated.ts +256 -0
  633. package/src/index.ts +70 -0
  634. package/src/internal/BottomSheet.tsx +714 -0
  635. package/src/internal/FodsProvider.tsx +36 -0
  636. package/src/internal/MotionCaret.tsx +53 -0
  637. package/src/internal/NumberFormatInput.tsx +276 -0
  638. package/src/internal/SummaryDonut.tsx +359 -0
  639. package/src/internal/buttonSegment.ts +241 -0
  640. package/src/internal/collapseRoom.ts +130 -0
  641. package/src/internal/comboboxKeys.ts +90 -0
  642. package/src/internal/contentPresence.ts +46 -0
  643. package/src/internal/dayCell.ts +274 -0
  644. package/src/internal/dialogPortal.ts +50 -0
  645. package/src/internal/donutSweeps.ts +77 -0
  646. package/src/internal/enterOnViewGeometry.ts +53 -0
  647. package/src/internal/faqItem.ts +104 -0
  648. package/src/internal/floatingLabelMotion.tsx +109 -0
  649. package/src/internal/formBlockContext.ts +27 -0
  650. package/src/internal/heightRoom.ts +135 -0
  651. package/src/internal/numberSeparators.ts +93 -0
  652. package/src/internal/overlayMotion.tsx +32 -0
  653. package/src/internal/paginationItem.ts +106 -0
  654. package/src/internal/popoverSurface.ts +78 -0
  655. package/src/internal/portalContainer.ts +11 -0
  656. package/src/internal/progressBarItem.ts +356 -0
  657. package/src/internal/selectionControlText.ts +42 -0
  658. package/src/internal/statusSummaryParts.tsx +475 -0
  659. package/src/internal/summaryMotion.ts +111 -0
  660. package/src/internal/table/ChildConnector.tsx +57 -0
  661. package/src/internal/table/ChildRowPrefix.tsx +21 -0
  662. package/src/internal/table/ColumnSettings.tsx +194 -0
  663. package/src/internal/table/ScrollRegion.tsx +176 -0
  664. package/src/internal/table/TableEmpty.tsx +99 -0
  665. package/src/internal/table/TableLayout.tsx +29 -0
  666. package/src/internal/table/TableLoadStatus.tsx +60 -0
  667. package/src/internal/table/TableMobile.tsx +582 -0
  668. package/src/internal/table/TruncatedCell.tsx +35 -0
  669. package/src/internal/table/emptyValue.ts +11 -0
  670. package/src/internal/table/features.ts +44 -0
  671. package/src/internal/table/recipes.ts +263 -0
  672. package/src/internal/table/rowClick.ts +8 -0
  673. package/src/internal/table/types.ts +342 -0
  674. package/src/internal/tailwind-variants.ts +65 -0
  675. package/src/internal/tooltipContext.ts +15 -0
  676. package/src/internal/tw-merge-config.generated.ts +275 -0
  677. package/src/internal/useAnchoredPanel.ts +340 -0
  678. package/src/internal/useCountUp.ts +65 -0
  679. package/src/internal/useDateFieldTrigger.tsx +497 -0
  680. package/src/internal/useEChart.ts +88 -0
  681. package/src/internal/useEnterOnView.ts +80 -0
  682. package/src/internal/useFloatingBar.ts +125 -0
  683. package/src/internal/useFormReset.ts +57 -0
  684. package/src/internal/useIsMobile.ts +64 -0
  685. package/src/internal/useNoImplicitSubmit.ts +41 -0
  686. package/src/internal/useOneRowOverflow.ts +103 -0
  687. package/src/internal/usePrefersReducedMotion.ts +27 -0
  688. package/src/internal/useReturnFocus.ts +34 -0
  689. package/src/internal/utils.ts +58 -0
  690. package/src/recipes/EmptyState.stories.tsx +105 -0
  691. package/src/recipes/Form.stories.tsx +360 -0
  692. package/src/recipes/ModalWithForm.stories.tsx +219 -0
  693. package/src/recipes/Recipes.mdx +61 -0
  694. package/src/recipes/TableWithFilters.stories.tsx +278 -0
  695. package/src/storybook/FodsFamily.tsx +39 -0
  696. package/src/storybook/Section.tsx +36 -0
  697. package/src/storybook/a11y.ts +24 -0
  698. package/src/storybook/assets/banner-character-bartender.webp +0 -0
  699. package/src/storybook/assets/banner-invoice-sheet-left.webp +0 -0
  700. package/src/storybook/assets/banner-invoice-sheet-right.webp +0 -0
  701. package/src/storybook/assets/invoice-hero.webp +0 -0
  702. package/src/storybook/assets/invoice.webp +0 -0
  703. package/src/storybook/assets/section-document-info.svg +21 -0
  704. package/src/storybook/assets/section-gear-checklist.svg +11 -0
  705. package/src/storybook/assets/section-person-arrow-in.svg +15 -0
  706. package/src/storybook/assets/section-person-arrow-out.svg +22 -0
  707. package/src/storybook/assets/section-receipt-dollar.svg +23 -0
  708. package/src/storybook/assets/table-empty-folder-empty.png +0 -0
  709. package/src/storybook/assets/table-empty-folder-magnifying-glass.png +0 -0
  710. package/src/storybook/assets/table-empty-funnel.png +0 -0
  711. package/src/storybook/assets/table-empty-load-failed.png +0 -0
  712. package/src/storybook/assets/wallet-spot.png +0 -0
  713. package/src/storybook/assets.d.ts +17 -0
  714. package/src/storybook/componentDoc.ts +41 -0
  715. package/src/storybook/fitFrame.tsx +70 -0
  716. package/src/storybook/forceStates.tsx +647 -0
  717. package/src/storybook/illustrations.tsx +66 -0
  718. package/src/storybook/viewportFrame.tsx +58 -0
  719. package/src/styles/assets/label-brush-1.svg +6 -0
  720. package/src/styles/assets/pattern-dark.svg +113 -0
  721. package/src/styles/base.css +106 -0
  722. package/src/styles/index.css +15 -0
  723. package/src/styles/motion.css +157 -0
  724. package/src/styles/promo-sticker.css +27 -0
  725. package/src/styles/promo-surface.css +49 -0
  726. package/src/styles/shared.css +11 -0
  727. package/src/styles/theme.generated.css +314 -0
  728. package/src/styles/theme.map.json +278 -0
  729. package/src/styles/tracking.generated.css +12 -0
  730. package/src/tokens/index.ts +4 -0
  731. package/src/tokens/tokens.generated.ts +542 -0
@@ -0,0 +1,662 @@
1
+ import { Meta, Canvas, Controls } from '@storybook/addon-docs/blocks';
2
+ import * as CardSelectStories from './CardSelect.stories';
3
+
4
+ <Meta of={CardSelectStories} tags={['autodocs']} />
5
+
6
+ # CardSelect
7
+
8
+ ## Metadata
9
+
10
+ - **Layer:** atom
11
+ - **Status:** draft
12
+ - **Tokens used:** `--bg-hover`, `--bg-primary`, `--border-width-100`, `--border-width-200`, `--disabled-control`, `--disabled-foreground`, `--font-size-base`, `--font-size-xs`, `--font-weight-normal`, `--font-weight-semibold`, `--leading-loose`, `--leading-relaxed`, `--outline-default`, `--outline-focus`, `--outline-strong`, `--radius-500`, `--radius-full`, `--secondary`, `--secondary-solid`, `--secondary-subtle`, `--size-illustration-card`, `--space-200`, `--space-400`, `--space-500`, `--space-600`, `--space-900`, `--status-danger-hover`, `--status-danger-soft`, `--status-danger-subtle`, `--status-danger-subtle-border`, `--status-danger-tint-foreground`, `--text-primary`, `--text-secondary`, `--text-wrap-body`
13
+ - **Manifest version:** `3.0.3`
14
+
15
+ ## Overview
16
+
17
+ CardSelect is the **whole-card selection control** — a card the user picks with a click, with a
18
+ media slot (icon or illustration), a semibold label and an optional subtitle, laid out **Stacked**
19
+ (media on top), **Horizontal** (media left) or **Option** (a leading radio, no media). Selection
20
+ shows as a `--secondary` (brand-blue) border and a top-right `--secondary` check-circle on a
21
+ `--bg-primary` disc (in Option: the selected leading radio), over a `--secondary-subtle` fill. It is `Radio` / `Checkbox` wearing a card: reach for it when a choice needs
22
+ **more than a bare label** to be made — a visual plus a line of description — inside a dialog or a
23
+ wizard step. Typical usages (manifest `intent.whenToUse`) are an authentication-method or two-factor
24
+ picker, a tax-mode or tax-band tile, a correction-type choice and, as **Option**, the choice of which
25
+ firm a mailbox connects to.
26
+
27
+ **It always ships as a group.** `CardSelect` is rendered inside a `CardSelectGroup`, which owns the
28
+ selection and carries the question as its accessible name — a lone card is a modelling bug.
29
+
30
+ **Do NOT use it** for a plain option list with no description (that is `Radio` for one-of,
31
+ `Checkbox` for many), for more than ~6 options (`Select`), for a single binary on/off (`Checkbox`),
32
+ or for a card that carries **its own action button plus a benefit list** — that is the
33
+ comparison-card, a separate pattern whose selection lives on a Button, and nesting a button or a link
34
+ inside the card's `<label>` is forbidden by both the spec and the roving radiogroup (see
35
+ [Accessibility](#accessibility)) — a follow-up link or field lives only in **Details**, outside the
36
+ label.
37
+
38
+ Two optional slots extend it (3.0.0): a recommendation **Badge** on the top border (every layout) and
39
+ **Details** — an Alert or plain text — that opens under the **selected** card (Stacked and Option).
40
+
41
+ <Canvas of={CardSelectStories.Playground} />
42
+
43
+ ## Rationale
44
+
45
+ The upstream spec promotes the pattern to a named atom for three reasons, and the React
46
+ implementation follows each of them:
47
+
48
+ - **One whole-card control.** This atom is the **whole-card** model only; the comparison card is
49
+ deliberately kept apart.
50
+ - **It settles the selection language.** Selection is a `--secondary` border plus a `--secondary`
51
+ corner check-circle on a `--secondary-subtle` fill. The border uses the colored-border role
52
+ `--secondary`, never the focus-ring token `--outline-focus`, so the two roles stay clean.
53
+ - **It flexes through one Layout axis and content properties** — `layout` (Stacked · Horizontal ·
54
+ Option),
55
+ an optional media slot, an optional subtitle — rather than a spray of variants; text is always
56
+ left-aligned (a centred tile is an instance override, not a prop), and it
57
+ carries **no in-card tooltip**: supplementary text lives in the subtitle, which keeps the
58
+ one-tab-stop radiogroup free of an unreachable focusable ⓘ.
59
+
60
+ Two implementation decisions are worth stating here, because they are contract, not style:
61
+
62
+ - **`CardSelect` and `CardSelectGroup` are two components.** The group provides `name`, the selected
63
+ `value` and the shared `layout` / `tone` / `disabled` through `CardSelectGroupContext`; the
64
+ card reads them and falls back to its own props. The group also enforces its accessible name **at
65
+ the TypeScript level** (a union of `aria-label` or `aria-labelledby`, never neither), because
66
+ axe-core sets `accessibleNameRequired: false` on `radiogroup` and would report nothing.
67
+ - **Selection and colour family are derived, not props.** Selection resolves as `checked` › the
68
+ group's `value` › the component's own state seeded from `defaultChecked`; the family is computed
69
+ from `tone` plus that selection. See [Variants](#variants).
70
+
71
+ ## Anatomy
72
+
73
+ Layout decides how the parts are arranged — `layout="stacked"` (default): media on top, the text
74
+ block below it; `layout="horizontal"`: media left, the text block right, items vertically centred;
75
+ `layout="option"`: a leading radio left, the text block right, vertically centred — no media and no
76
+ corner check. Text is left-aligned in all three.
77
+
78
+ - **Root** — a `div` (the spec's `div.card-select`, 3.0.1) wrapping the hit area, the Badge and
79
+ Details. It owns the chrome (fill, a `--border-width-100` inset border, radius) and the focus ring,
80
+ and does not clip, because the Badge protrudes above it. Every state selector on it targets the
81
+ card's **own** input (`data-card-select-input`), never a field inside Details. Emits
82
+ `data-fods-component="card-select"`, `data-fods-part="root"` plus `data-fods-family`.
83
+ - **Hit area** — the `<label>` inside the root, so the card's content is the hit target *and* the
84
+ accessible name of its input. It carries the padding and the media→content gap, and it alone
85
+ triggers the hover wash: hovering Details does not wash the card. It grows to fill the root, so a
86
+ stretched card in a row stays clickable edge to edge. Emits `data-fods-part="hit-area"`.
87
+ - **Input** — a native `<input type="radio">`, visually hidden with `sr-only` (never `display: none`
88
+ / `hidden`, which would take it out of the tab order and kill the focus ring). Selection, keyboard
89
+ and the checked state all come from it.
90
+ - **Media** — holding its content directly (no wrapper, **0 vertical padding in every
91
+ layout**). One nullable prop with two accepted contents: an `IconName` renders an `Icon` glyph
92
+ (24), or a `React.ReactElement` renders an illustration in an **80×80** box, greyed
93
+ with `grayscale` when disabled. Omitting the prop (`Show media` off) renders nothing — valid in
94
+ Stacked and Horizontal since 2.3.1. Layout=Option has no media; the prop is ignored there.
95
+ - **Label** — the choice name, `--font-weight-semibold`, `--font-size-base` (Body/M), clamped to 2
96
+ lines.
97
+ - **Subtitle** *(optional)* — `--font-size-xs` (Body/XS, `sizes[].runTextStyles.subtitle`) at
98
+ `--font-weight-normal`, clamped to 2 lines. **This is where supplementary help lives.**
99
+ - **Check** — the `check-circle` glyph (24, the icon-size step) on a `--bg-primary` disc
100
+ (`--radius-full`), absolutely positioned at the top right, inset `--space-600` and
101
+ **centred on the media's axis**. It needs no offset table for that: it keeps its flex *static
102
+ position*, so in Stacked it is rendered inside the `items-center` media container (centred on a 24
103
+ icon and an 80 illustration alike), and in Horizontal inside the `items-center` card. A Stacked
104
+ card **without media** centres it on the **label's first line** instead: the check sits at the top
105
+ of the `items-start` card, level with the label, whose first line is 24 high (Body/M, 16 × 1.5) —
106
+ an exact match. Not rendered in Option. Rendered **only when selected** — the primary, NON-COLOUR selection cue (WCAG 1.4.1). In Horizontal,
107
+ and in a Stacked card without media, the text block reserves `--space-900` on the right, so the
108
+ check never overlaps the text and selecting never reflows the card.
109
+ - **Leading control** *(Option only)* — the card's own native input, shown as a Radio md (20) box and
110
+ dot. It is not a second control: the box and dot come from `radioVariants` and react to the input
111
+ through `peer-*`. Two deliberate overrides — Selected · Hover renders as Selected · Default, and the
112
+ box draws no focus ring of its own (the card carries the one ring). Emits
113
+ `data-fods-part="leading-control"`.
114
+ - **Trailing** *(Option only, optional)* — a status `Badge` with its icon at the end of the label
115
+ line (`2 dodavatelé` · `Jiné DIČ` · `Nová`): the label fills, the slot hugs, centred on the label
116
+ line, gap `--space-400`. It sits **inside** the label, so it is part of the accessible name, and it
117
+ keeps its own colours on a Disabled card — it says why the card cannot be chosen. Emits
118
+ `data-fods-part="trailing"`.
119
+ - **Badge** *(optional, every layout)* — a recommendation `Badge` with its icon (Info · **Solid** · sm,
120
+ `Doporučeno`; the Figma examples — the manifest default says Soft, which on a
121
+ Selected card is the same `--ds-blue-100` as the card fill) on the **top border**: a strip inset `--space-600` on both sides whose vertical centre
122
+ sits on the border, so the Badge protrudes by half its height and never moves the content.
123
+ `badgeAlign` places it `start` (default) · `center` · `end`; it never covers the check-circle, so
124
+ Stacked and Horizontal do not take `end`. It sits **outside** the label and is announced as the
125
+ input's description. Emits `data-fods-part="badge"`.
126
+ - **Details** *(optional; Stacked and Option, Selected only)* — an `Alert` (Info, no title, no
127
+ action, no `live`) or plain text after the label, rendered **only on the Selected card**. Stacked:
128
+ the content width; Option: inset `--space-900` to line up with the text column. The row↔details
129
+ gap `--space-400` is the label's bottom padding, so it still selects. Being outside the label, a
130
+ link or a field inside it is a control of its own. Emits `data-fods-part="details"`.
131
+ - **Group** — the `CardSelectGroup` wrapper: `role="radiogroup"`, a flex column (or row with
132
+ `orientation="horizontal"`) at a `--space-400` gap — a group where any card has a Badge needs at least
133
+ half the badge height (Badge sm 22 → `className="gap-500"`). It carries no `data-fods-*` attributes, since it
134
+ is not a part of the `card-select` manifest.
135
+
136
+ The label↔subtitle gap is `--space-200` (`sizes[].textGap`). Height hugs the content (the manifest
137
+ states none, so no `h-*` class is emitted); the card is `w-full` and fills whatever track the group
138
+ gives it.
139
+
140
+ ## Variants
141
+
142
+ <Canvas of={CardSelectStories.Matrix} />
143
+
144
+ The colour axis is **one combined `family` variant with four values** — Tone × Selection — derived in
145
+ the component from `tone` plus the resolved selection and never a public prop. Why one combined axis
146
+ rather than `tone` × `selected` as two recipe selectors: a family that needs TWO keys cannot be
147
+ written into `data-fods-family`, which carries a single value, and the runtime pass then
148
+ could not grade any family's interaction states. Hover is a real difference in three of the four
149
+ families, so leaving it ungraded would strip the interaction DoD of its only mechanical support.
150
+
151
+ <table>
152
+ <thead>
153
+ <tr><th>Family (<code>data-fods-family</code>)</th><th>Rendered by</th><th>Rest tokens</th></tr>
154
+ </thead>
155
+ <tbody>
156
+ <tr>
157
+ <td><code>unselected</code></td>
158
+ <td><code>tone="default"</code>, not selected</td>
159
+ <td>fill <code>--bg-primary</code>, border <code>--outline-strong</code> at <code>--border-width-100</code>, label <code>--text-primary</code>, subtitle <code>--text-secondary</code>, media <code>--secondary</code>, no checkmark</td>
160
+ </tr>
161
+ <tr>
162
+ <td><code>selected</code></td>
163
+ <td><code>tone="default"</code>, selected</td>
164
+ <td>fill <code>--secondary-subtle</code>, border <code>--secondary</code>, label <code>--text-primary</code>, subtitle <code>--text-secondary</code>, media <code>--secondary</code>, check-circle <code>--secondary</code> on a <code>--bg-primary</code> disc</td>
165
+ </tr>
166
+ <tr>
167
+ <td><code>danger-unselected</code></td>
168
+ <td><code>tone="danger"</code> (<strong>deprecated</strong>), not selected</td>
169
+ <td>a completely <strong>neutral box</strong> — fill <code>--bg-primary</code>, border <code>--outline-strong</code> — with red only in the ink: label and media <code>--status-danger-tint-foreground</code>, subtitle <code>--text-secondary</code></td>
170
+ </tr>
171
+ <tr>
172
+ <td><code>danger-selected</code></td>
173
+ <td><code>tone="danger"</code> (<strong>deprecated</strong>), selected</td>
174
+ <td>fill <code>--status-danger-subtle</code>, border <code>--status-danger-subtle-border</code>, label, subtitle, media and checkmark all <code>--status-danger-tint-foreground</code></td>
175
+ </tr>
176
+ </tbody>
177
+ </table>
178
+
179
+ <Canvas of={CardSelectStories.Tone} />
180
+
181
+ `tone="danger"` is **deprecated** since manifest 2.0.0 — do not build new work on it. It has no Option cells:
182
+ with `layout="option"` the component ignores the tone and renders Tone=Default. What it
183
+ recolours is deliberately narrow: the ink runs one ladder across both selections, and an Unselected
184
+ danger card keeps a neutral box. Only Selected tints the fill.
185
+
186
+ The danger Selected/Default **subtitle** is the one cell that joins the tinted ink
187
+ (`--status-danger-tint-foreground`); every other danger subtitle, including Selected/Hover, stays
188
+ `--text-secondary`.
189
+
190
+ <Canvas of={CardSelectStories.Layout} />
191
+
192
+ `layout` replaced the old `align` in 2.0.0. **Stacked** (default) puts the media on top, left-aligned
193
+ with the text; **Horizontal** puts the media left and the text right, vertically centred, with the
194
+ text block reserving `--space-900` for the check (as does a Stacked card without media). **Option**
195
+ (3.0.0) shows the card's own input as a leading radio, vertically centred with the text block, with
196
+ the Horizontal padding and gap; there is no media and no corner check, so nothing is reserved on the
197
+ right. Use it for a list of entities to pick one of (firms, accounts); a new record (*Nová firma*) is
198
+ one more Option, and the footer button relabels by the selection — a card never opens anything
199
+ itself. Text is always left-aligned — a centred tile is an instance override in the consuming layout
200
+ (`className`), not a prop. Use one `layout` per group.
201
+
202
+ <Canvas of={CardSelectStories.Media} />
203
+
204
+ The media prop is typed `IconName | React.ReactElement | null` — a `ReactNode` would subsume `string`
205
+ and silently type-check a non-existent icon name, so the union narrows on `typeof media === 'string'`
206
+ with no cast and no invalid-name hole. The illustration branch takes an element from the caller
207
+ because Illustrations are raster assets (`Illustration / Spot`), not components; the card gives it an
208
+ 80×80 box and the element should fill it (`size-full`).
209
+
210
+ <Canvas of={CardSelectStories.BadgeSlot} />
211
+
212
+ `badge` takes the Badge element; `badgeAlign` is the screen's choice of its horizontal place. Keep a
213
+ recommendation here and a record's status in `trailing` (Option).
214
+
215
+ <Canvas of={CardSelectStories.Details} />
216
+
217
+ `details` is progressive disclosure: the selection, not a separate toggle, opens it, and it moves
218
+ with the selection. `layout="horizontal"` has no Details — the prop is ignored there.
219
+
220
+ <Canvas of={CardSelectStories.DetailsInteractive} />
221
+
222
+ A link or a field in Details is operable on its own: clicking or typing in it never changes the
223
+ selection, and the card's state never reacts to it.
224
+
225
+ ## Sizes
226
+
227
+ <Canvas of={CardSelectStories.Sizes} />
228
+
229
+ <table>
230
+ <thead>
231
+ <tr><th>Layout</th><th>Padding (block / inline)</th><th>Main gap</th><th>Label↔subtitle</th></tr>
232
+ </thead>
233
+ <tbody>
234
+ <tr>
235
+ <td>Stacked</td>
236
+ <td><code>--space-600</code> (16) all sides</td>
237
+ <td>media↔text <code>--space-400</code></td>
238
+ <td><code>--space-200</code></td>
239
+ </tr>
240
+ <tr>
241
+ <td>Horizontal</td>
242
+ <td><code>--space-500</code> / <code>--space-600</code></td>
243
+ <td>media↔text <code>--space-500</code></td>
244
+ <td><code>--space-200</code></td>
245
+ </tr>
246
+ <tr>
247
+ <td>Option</td>
248
+ <td><code>--space-500</code> / <code>--space-600</code></td>
249
+ <td>radio↔text <code>--space-500</code></td>
250
+ <td><code>--space-200</code></td>
251
+ </tr>
252
+ </tbody>
253
+ </table>
254
+
255
+ **`md` is the only size** since manifest 3.0.0 (`sm` was removed).
256
+ `size="md"` stays accepted as a no-op (3.0.1). Radius `--radius-500` (12), label `--font-size-base`
257
+ (Body/M) Semibold, subtitle `--font-size-xs` (Body/XS) Regular; icon 24, check-circle 24, radio 20,
258
+ illustration 80×80. The check's right inset equals the inline padding (`--space-600`). Height hugs
259
+ the content. The per-layout numbers are `sizes[md].layouts` in the manifest.
260
+
261
+ ## States
262
+
263
+ <Canvas of={CardSelectStories.States} />
264
+
265
+ <table>
266
+ <thead>
267
+ <tr><th>Family</th><th>Hover</th><th>Disabled</th></tr>
268
+ </thead>
269
+ <tbody>
270
+ <tr>
271
+ <td><code>unselected</code></td>
272
+ <td>fill <code>--bg-hover</code>; border stays <code>--outline-strong</code>; ink unchanged</td>
273
+ <td>fill <code>--disabled-control</code>, border <code>--outline-default</code>, all ink <code>--disabled-foreground</code>; an illustration renders <code>grayscale</code></td>
274
+ </tr>
275
+ <tr>
276
+ <td><code>selected</code></td>
277
+ <td><strong>identical to Default</strong> — the same <code>--secondary-subtle</code> fill and <code>--secondary</code> border</td>
278
+ <td>fill <code>--disabled-control</code>, border <code>--outline-default</code>, all ink incl. the check-circle <code>--disabled-foreground</code> (disc stays <code>--bg-primary</code>)</td>
279
+ </tr>
280
+ <tr>
281
+ <td><code>danger-unselected</code></td>
282
+ <td>the neutral box washes to <code>--bg-hover</code> (border stays <code>--outline-strong</code>) and the ink steps one rung to <code>--status-danger-hover</code>; subtitle stays <code>--text-secondary</code></td>
283
+ <td>same as the neutral families — a code contract in the manifest, no Figma cell</td>
284
+ </tr>
285
+ <tr>
286
+ <td><code>danger-selected</code></td>
287
+ <td>fill deepens <code>--status-danger-subtle</code> → <code>--status-danger-soft</code>, border strengthens to <code>--status-danger-tint-foreground</code>, label, media and checkmark step to <code>--status-danger-hover</code> — while the subtitle steps back to <code>--text-secondary</code></td>
288
+ <td>same as the neutral families — a code contract in the manifest, no Figma cell</td>
289
+ </tr>
290
+ </tbody>
291
+ </table>
292
+
293
+ - **Hover** is `has-[>label:hover]` on the root for fill and border — the spec's
294
+ `.card-select:has(> .card-select__label:hover)`, so only the label part washes the card and
295
+ hovering Details does not — and `group-hover` for the ink slots, keyed to the label: pointing
296
+ anywhere on the hit area must step the ink, not just pointing at the text. Neither is reachable by
297
+ a prop; the States story forces both statically.
298
+ - **Focus** is **not a variant**. It is the cross-cutting additive offset ring: `--outline-focus` at
299
+ `--border-width-200`, sitting 2px outside the card, never a border on it. It is painted as an
300
+ `outline` on the root under `has-[[data-card-select-input]:focus-visible]:` with a 2px
301
+ `outline-offset`, so its corners
302
+ follow the card radius grown by the offset (12 → ≈ 14) — no separate
303
+ ring-radius token, the same ring every FODS control uses. It cannot be a `peer-*` variant here: Tailwind compiles `peer-focus-visible:` to
304
+ `.peer:focus-visible ~ &`, a general-SIBLING combinator, and the input is a **descendant** of the
305
+ card — the rule could never match and the classes would be dead CSS. `:has()` is the same
306
+ relationship read the other way. The selector names the card's own input by its marker attribute,
307
+ not a bare `input`, so focusing a field inside Details rings the field and never the card. The root
308
+ is `isolate` and the Badge strip `-z-10` inside it, so the ring paints above the Badge, never under.
309
+ - **Disabled** is the only state prop. Greying is token-based (`--disabled-control` / `--disabled-foreground`),
310
+ never `opacity`, and it reaches the native input, which stops being operable and focusable. A
311
+ Selected + Disabled card **keeps its checkmark** in `--disabled-foreground` on the grey fill:
312
+ dropping it would leave selection carried by colour alone (WCAG 1.4.1) — and colour is exactly what
313
+ Disabled takes away. In Option the leading radio goes Disabled with the card (it is the same
314
+ input); a trailing Badge keeps its own colours. Details on a Disabled card is `inert`: nothing in it
315
+ can be focused or clicked.
316
+ - **There is no Active and no Error state on the card.** The manifest's state axis is Default ·
317
+ Hover, with Disabled declared per family. A required group validates with `aria-invalid`
318
+ plus helper text at the GROUP level, exactly like `RadioGroup`.
319
+
320
+ ### Motion
321
+
322
+ Manifest 3.0.2 `motion`. The card's fill and border cross-fade on `--duration-toggle` /
323
+ `--easing-standard` when the selection changes, and the label, subtitle, media and check inks follow
324
+ on `--duration-hover` / `--easing-standard`. The hover wash of the card shares the toggle duration —
325
+ one transition rule on the root, because a separate hover duration would leak a hover class into the
326
+ Selected family (the States grid checks it). Details, on the newly Selected card, fades in over
327
+ `--duration-slow` / `--easing-enter` while its room opens: the room is the card's own `height`,
328
+ moving on `--spring-gentle` from the measured height to the new one and then back to `auto`, so the
329
+ cards below follow in the normal flow. Height, not a Motion `layout` transform, which would scale
330
+ the border, the radius and the focus ring (approved deviation `collapse-room-height`). On the card that
331
+ lost the selection, Details fades out over `--duration-fast` / `--easing-exit` first, is `inert`
332
+ while it fades, and is unmounted once the fade ends, so its links and fields leave the tab order;
333
+ the card holds its height meanwhile, and only then does the room close. The Stacked / Horizontal corner check-circle fades in on the same
334
+ fade and leaves at once. Changing the selection mid-way turns every movement around from where it
335
+ is. Nothing animates on the first render. Under `prefers-reduced-motion` the rooms open and close at
336
+ once and the fade shortens to `--duration-instant`.
337
+
338
+ <Canvas of={CardSelectStories.Motion} />
339
+
340
+ ## API
341
+
342
+ <Controls />
343
+
344
+ Selection resolves in a fixed precedence: **`checked`** › the group's **`value`** › the component's
345
+ own state seeded from **`defaultChecked`**. The component needs it in JS, not only as `:checked` CSS,
346
+ because it decides whether the checkmark node exists at all and which family renders. `layout`,
347
+ `tone` and `disabled` resolve the same way: the card's own prop first, then the group's, then the
348
+ default (`stacked` / `default` / `false`). `tone="danger"` is ignored at `layout="option"`, and so are
349
+ `media` (Option has no media) and `trailing` outside Option. `size` accepts only `md` and changes
350
+ nothing (manifest 3.0.1).
351
+
352
+ `badge` (a Badge element) renders on every layout, placed by `badgeAlign` (`'start' | 'center' |
353
+ 'end'`, type `CardSelectBadgeAlign`; `end` only in Option). `details` (an Alert or plain text) renders
354
+ only while the card is selected and never at `layout="horizontal"`. Both feed the input's
355
+ `aria-describedby`, merged after a caller's own value: the Badge always; Details only when it holds
356
+ no focusable content (a link or a field is read in tab order instead). States bind to the card's own
357
+ input only — a field in Details changes nothing on the card.
358
+
359
+ `CardSelectGroup` is a separate component, so its props are not in the table above:
360
+
361
+ <table>
362
+ <thead>
363
+ <tr><th>Prop</th><th>Type</th><th>Notes</th></tr>
364
+ </thead>
365
+ <tbody>
366
+ <tr>
367
+ <td><code>aria-label</code> / <code>aria-labelledby</code></td>
368
+ <td><code>string</code></td>
369
+ <td><strong>Required — exactly one of the two</strong>, enforced by a TypeScript union.</td>
370
+ </tr>
371
+ <tr>
372
+ <td><code>value</code> / <code>defaultValue</code></td>
373
+ <td><code>string</code></td>
374
+ <td><code>value</code> makes the group controlled; <code>defaultValue</code> seeds an uncontrolled one.</td>
375
+ </tr>
376
+ <tr>
377
+ <td><code>onValueChange</code></td>
378
+ <td><code>(value: string) =&gt; void</code></td>
379
+ <td>Called with the newly selected value.</td>
380
+ </tr>
381
+ <tr>
382
+ <td><code>name</code></td>
383
+ <td><code>string</code></td>
384
+ <td>Shared radio <code>name</code> tying the children into one native roving group; auto-generated when omitted.</td>
385
+ </tr>
386
+ <tr>
387
+ <td><code>layout</code> / <code>tone</code> / <code>disabled</code></td>
388
+ <td>as on the card</td>
389
+ <td>Inherited by every child through context. <code>size</code> (<code>'md'</code> only) is a no-op.</td>
390
+ </tr>
391
+ <tr>
392
+ <td><code>orientation</code></td>
393
+ <td><code>'vertical' | 'horizontal'</code></td>
394
+ <td>Flex direction; default <code>'vertical'</code>. Gap is <code>--space-400</code>.</td>
395
+ </tr>
396
+ </tbody>
397
+ </table>
398
+
399
+ ## Do / Don't
400
+
401
+ - ✅ Always ship it inside a `CardSelectGroup` **with a group label** — a lone card-select is a
402
+ modelling bug; a single exclusive choice is a `Checkbox`.
403
+ - ✅ Let the group own the question ("Jak chcete ověřovat přihlášení?") and never repeat it in the
404
+ cards.
405
+ - ✅ Put supplementary help in the **subtitle**.
406
+ - ✅ Keep the label a short noun phrase (1–3 words, sentence case, no terminal period) — it clamps to
407
+ 2 lines, so shorten instead of relying on the wrap.
408
+ - ✅ Use one `layout` per group; keep text left-aligned (centre a tile with an
409
+ instance override where a layout needs it).
410
+ - ✅ Use `tone="default"` for new work.
411
+ - ✅ Put a 24 icon or an 80×80 illustration straight into `media`.
412
+ - ✅ In Option, put a record's status in `trailing` as a Badge with its icon; add a new record
413
+ (*Nová firma*) as one more Option and let the footer button relabel by the selection.
414
+ - ✅ Put a recommendation in `badge`, clear of the check, and widen the group gap to at least half the
415
+ badge height.
416
+ - ✅ Put a longer note, a follow-up link or a field in `details` — it shows on the selected card only.
417
+ - ❌ Don't nest a button or a link inside the card's label — a card carrying its own CTA and a benefit
418
+ list is the comparison-card, a separate pattern; a follow-up link goes in `details`.
419
+ - ❌ Don't right-align the Badge (`badgeAlign="end"`) on a Stacked or Horizontal card — it would
420
+ cover the check-circle.
421
+ - ❌ Don't squeeze badged cards closer than half the badge height.
422
+ - ❌ Don't fake Details on an unselected card, or give an Alert in Details `live`, a title or an
423
+ action.
424
+ - ❌ Don't add an interactive ⓘ inside the card: a focusable tooltip trigger cannot live in a
425
+ one-tab-stop roving radiogroup.
426
+ - ❌ Don't signal selection by colour alone or invert the whole card — the checkmark is the cue.
427
+ - ❌ Don't start new work on `tone="danger"` — it is deprecated.
428
+ - ❌ Don't mix Stacked, Horizontal and Option cards in one group.
429
+ - ❌ Don't put a link or a button in `trailing` — it sits inside the card's `<label>`.
430
+ - ❌ Don't reach for CardSelect when the options need no description (`Radio` / `Checkbox`) or when
431
+ there are more than ~6 of them (`Select`).
432
+ - ❌ Don't override the chrome through `className` — every family × state pair is token-bound.
433
+
434
+ ## Accessibility
435
+
436
+ - **Keyboard** — behaviour is **native**, from the shared radio `name`: the group is one tab stop,
437
+ arrow keys move the selection, Space selects. There is no custom key handling in the component and
438
+ therefore no roving tabindex to keep in sync. `disabled` removes a card from the tab order through
439
+ the native attribute on its input. Focusable content in the checked card's **Details** adds its own
440
+ tab stops after that radio: Tab enters Details, Shift+Tab returns, and the arrow keys inside a text
441
+ field there move the caret, not the selection.
442
+ - **ARIA** — the group renders `role="radiogroup"` and its accessible name is **required by the type
443
+ system** (`aria-label` or `aria-labelledby`), because axe-core sets `accessibleNameRequired: false`
444
+ on `radiogroup` and an optional prop would simply be left out. A `radiogroup` does not inherit a
445
+ name from an ancestor `<fieldset>` / `<legend>` either. Group-level validation attributes
446
+ (`aria-invalid`, `aria-describedby`) pass straight through to the group's root with the rest props.
447
+ A disabled card sets both the native `disabled` and `aria-disabled` on its input.
448
+ - **Screen reader** — the card IS the `<label>` of its input (`htmlFor`), so the accessible name is
449
+ the label plus the subtitle text; checked state is announced natively from the radio. Every glyph
450
+ goes through `Icon`, which always renders `aria-hidden="true"`, so the media and the checkmark are
451
+ decorative — the checkmark is the **visual** non-colour cue, not the announced one. In Option the
452
+ radio box and dot are `aria-hidden` drawings of the one native input, and the `trailing` Badge text
453
+ is read as part of the card's name. The top-border **Badge** is outside the label and is the input's
454
+ description (`aria-describedby`), so `Doporučeno` is announced without lengthening the name.
455
+ **Details** is outside the label too, so it is never part of the name: text-only Details is the
456
+ input's description; Details with links or fields is not referenced and is read in tab order. An
457
+ Alert in Details is plain content, not a live region, so arrowing through the group announces
458
+ nothing extra.
459
+ - **Contrast & motion** — the ratios below are quoted from the manifest's `notes` and the spec's
460
+ `## Accessibility` (computed against the main / red-v2 token values, which bind the same names).
461
+ Every danger **text** pairing clears the 4.5:1 floor: Unselected/Default ink
462
+ `--status-danger-tint-foreground` #c50000 on white = 6.22:1; Unselected/Hover ink
463
+ `--status-danger-hover` #ac0704 on the light `--bg-hover` wash is darker still; Selected/Default
464
+ label and subtitle #c50000 on `--status-danger-subtle` #ffebe8 = 5.42:1; Selected/Hover ink #ac0704
465
+ on `--status-danger-soft` #fed6cf = 5.65:1. The Selected/Hover border clears the 3:1 non-text floor
466
+ (6.22:1 on white, 4.66:1 on the `-soft` fill). The selected `--secondary` edge measures 5.93:1 on
467
+ white and 5.14:1 on its `--secondary-subtle` fill. The Unselected edge `--outline-strong` is 1.73:1
468
+ on `--bg-primary` — an accepted exception upstream (`accessibility.md`, "Card Select resting
469
+ edge"): the label, the media glyph and the Selected chrome carry the locator role. Disabled ink
470
+ `--disabled-foreground` on `--disabled-control` is 4.08:1 — WCAG exempts disabled controls anyway. One accepted limitation
471
+ remains, see [Known issues](#known-issues). `--outline-focus` shares its hue with the selected
472
+ `--secondary` border; the two are disambiguated by **shape and position** (an offset ring around the
473
+ whole card vs. an inset border plus a corner glyph). The focus ring never animates. The Details
474
+ reveal and the reflow of the cards below collapse to an instant change under
475
+ `prefers-reduced-motion`, and the fade shortens to `--duration-instant` (see [States](#states) →
476
+ Motion).
477
+
478
+ Accessibility floor for every FODS component: `spec/01-foundations/accessibility.md`.
479
+
480
+ ## Known issues
481
+
482
+ - **Hover on the Default-tone `selected` family is legitimately identical to Default.** The manifest
483
+ binds the same `--secondary-subtle` fill and `--secondary` border in both states. On the two
484
+ Unselected families Hover only washes the fill — the border is `--outline-strong` at rest already.
485
+ - **The Horizontal / Option measurements are not statically graded.** They are structured in
486
+ `sizes[md].layouts` since 2.3.3, but the static grading does not read that field yet; the static pass
487
+ grades Stacked and the runtime pass carries the other two.
488
+ - **The group does not widen its gap for a Badge.** The spec asks for at least half the badge height
489
+ between cards when any card has one (Badge sm 22 → ≥ 11); the group default is `--space-400` (8),
490
+ so pass `gap-500` on the group yourself.
491
+ - **The hover wash is not gated on `(hover: hover)`.** It is a `:has(> label:hover)` selector on the
492
+ root, which Tailwind does not wrap in the hover media query, so on touch a tapped card may keep the
493
+ wash until the next tap. Tapping selects, and Selected has no hover step, so it shows only where
494
+ the tapped card stays Unselected.
495
+ - **The Badge's description does not repeat the subtitle.** The spec pairs the Badge id with the
496
+ subtitle id in `aria-describedby`; here the subtitle is already in the label's accessible name, so it
497
+ is not referenced a second time. There is no opt-out for a purely decorative Badge.
498
+ - **The check-circle size (24) comes from `slots.check` prose** — a
499
+ structured `sizes[].checkIcon` is an open upstream `backlog` item that needs a schema addition.
500
+ - **The check-circle is an `<Icon>` glyph on a disc of the same box.** The `check-circle` drawing's
501
+ circle fills ~0.81 em, so a thin `--bg-primary` rim of the disc
502
+ shows on the Selected tint.
503
+ - **Accepted a11y limitation, mirroring Figma:** the danger Selected/Default border
504
+ `--status-danger-subtle-border` #ffb7ac measures 1.66:1 against a white surround, under the 3:1
505
+ non-text floor — the check-circle and the `-subtle` fill carry selection there.
506
+ - **The group's layout model is unfinished upstream.** Responsive columns and equal-height cards are
507
+ an open manifest `backlog` item (`card-select-group`); until it lands, the group is the `RadioGroup`
508
+ precedent — a flex row/column at `--space-400`, with `w-full` cards filling whatever track they land
509
+ in.
510
+ - **The `type="checkbox"` many-of mode is not modelled yet.** `delivery.react` names it as a future
511
+ mode; the card is byte-identical there, so it stays a zero-cost later add.
512
+
513
+ ## Copy
514
+
515
+ Voice: impersonal, clear, concise, specific, one word per concept. The examples are Czech; the rules
516
+ hold for every market mutation.
517
+
518
+ - **Label** (`label`, required) — a short noun or noun phrase naming the choice, parallel in form
519
+ across the group; sentence case, no terminal period, no command. 1–3 words, at most 40 characters.
520
+ It wraps to 2 lines at most (e.g. `Aplikacja uwierzytelniająca`), so shorten rather than let it
521
+ wrap.
522
+ - **Subtitle** (`subtitle`, optional) — one plain line on what the choice means or what follows from
523
+ it, at most 90 characters; it wraps to 2 lines at most. Supplementary help lives here, there is no
524
+ in-card tooltip. Description, not marketing.
525
+ - **Badge** (`badge` on the top border, `trailing` in Option) — one or two words, a recommendation
526
+ (top border) or a status (Trailing), sentence case, always with its icon.
527
+ - The **group** owns the question (`Jak chcete ověřovat?`); do not repeat it in each card.
528
+
529
+ <table>
530
+ <thead>
531
+ <tr><th>Run</th><th>Write</th><th>Don't write</th></tr>
532
+ </thead>
533
+ <tbody>
534
+ <tr><td>Label</td><td><code>Jen paušál</code> · <code>Paušál + DPH</code> · <code>Aplikacja uwierzytelniająca</code> (PL, wraps to 2 lines)</td><td><code>Vyberte si jen paušál</code></td></tr>
535
+ <tr><td>Badge</td><td><code>Odporúčané</code> · <code>Nová</code> · <code>2 dodávatelia</code> · <code>Iné DIČ</code></td><td><code>Najlepšia voľba!</code></td></tr>
536
+ <tr><td>Subtitle</td><td><code>Kód přijde na váš telefon</code> · <code>Google Authenticator, Authy apod.</code></td><td><code>Nejlepší volba pro každého podnikatele</code></td></tr>
537
+ </tbody>
538
+ </table>
539
+
540
+ ## Usage
541
+
542
+ <Canvas of={CardSelectStories.Group} />
543
+
544
+ ```tsx
545
+ import { CardSelect, CardSelectGroup } from '@invoiceonline/ui-react';
546
+
547
+ // Good — the group owns the question and the selection; the cards only carry choices
548
+ const [method, setMethod] = useState('sms');
549
+
550
+ <p id="two-factor-question">Jak chcete ověřovat přihlášení?</p>
551
+ <CardSelectGroup
552
+ aria-labelledby="two-factor-question"
553
+ value={method}
554
+ onValueChange={setMethod}
555
+ layout="horizontal"
556
+ >
557
+ <CardSelect value="sms" label="SMS" subtitle="Kód přijde na váš telefon" media="bell" />
558
+ <CardSelect
559
+ value="app"
560
+ label="Autentizační aplikace"
561
+ subtitle="Aplikace s ověřovacími kódy"
562
+ media="shield-check"
563
+ />
564
+ </CardSelectGroup>
565
+ ```
566
+
567
+ ```tsx
568
+ // Don't — a lone card outside a group: no radiogroup, no group label, no shared name
569
+ <CardSelect value="sms" label="SMS" subtitle="Kód přijde na váš telefon" media="bell" />
570
+
571
+ // Don't — a nested control inside the card; that is the comparison-card pattern
572
+ <CardSelect value="app" label="Autentizační aplikace">
573
+ <Button variant="primary">Vybrat</Button>
574
+ </CardSelect>
575
+
576
+ // Don't — an interactive ⓘ in the card; supplementary help belongs in the subtitle
577
+ <CardSelect value="app" label="Autentizační aplikace" media="shield-check" />
578
+ <Tooltip content="Aplikace s ověřovacími kódy">…</Tooltip>
579
+ ```
580
+
581
+ ## Related
582
+
583
+ - [`Radio`](?path=/docs/design-system-atoms-radio--docs) and
584
+ [`RadioGroup`](?path=/docs/design-system-atoms-radiogroup--docs) — the plain one-of control this
585
+ atom dresses as a card; reach for them when the options need no description. `RadioGroup` is also
586
+ the layout and group-name precedent this component follows.
587
+ - [`Checkbox`](?path=/docs/design-system-atoms-checkbox--docs) — many-of, and the right control for a
588
+ single exclusive choice that would otherwise be a lone card.
589
+ - [`Select`](?path=/docs/design-system-organisms-select--docs) — past ~6 options.
590
+ - [`Modal`](?path=/docs/design-system-organisms-modal--docs) — the usual host: a dialog or a wizard
591
+ step.
592
+ - Spec: `spec/03-atoms/card-select.md`.
593
+
594
+ ## Migration notes
595
+
596
+ **Manifest 3.0.2 → 3.0.3 (patch, documentation only).** `delivery.migration` records the waiver for
597
+ the 3.0.0 major: no consumer has a step to apply; the
598
+ Storybook, its only consumer, dropped `sm` at 3.0.1 (see the 2.3.1 → 3.0.1 table below). No code
599
+ change.
600
+
601
+ **Manifest 3.0.1 → 3.0.2 (patch, motion).** The card had no transition at all; it now cross-fades
602
+ fill and border on `--duration-toggle`, fades Details and the check-circle in and out, and moves the
603
+ cards below on `--spring-gentle` (see [States](#states) → Motion). No API change. The Details room
604
+ is the card's own height on `--spring-gentle`; `CardSelectGroup` needs no Motion `LayoutGroup`, the
605
+ cards below follow in the normal flow.
606
+
607
+ **Manifest 2.3.1 → 3.0.1 (major).**
608
+
609
+ <table>
610
+ <thead>
611
+ <tr><th>2.3.1</th><th>3.0.1</th></tr>
612
+ </thead>
613
+ <tbody>
614
+ <tr><td><code>size: 'md' | 'sm'</code> (card + group), <code>sm</code> deprecated</td><td><code>sm</code> <strong>removed</strong>; <code>size</code> accepts only <code>'md'</code> and is a no-op. No consumer set <code>sm</code>.</td></tr>
615
+ <tr><td><code>layout: 'stacked' | 'horizontal'</code></td><td>adds <strong><code>'option'</code></strong>: leading radio, no media, no check-circle, Horizontal padding and gap. <code>tone="danger"</code> is ignored there.</td></tr>
616
+ <tr><td>—</td><td><strong><code>trailing</code></strong> slot prop (Option only): a status Badge at the end of the label line.</td></tr>
617
+ <tr><td>—</td><td><strong><code>badge</code></strong> slot prop (every layout, on the top border, placed by <strong><code>badgeAlign</code></strong>) and <strong><code>details</code></strong> slot prop (Stacked and Option, Selected only, outside the <code>&lt;label&gt;</code>).</td></tr>
618
+ <tr><td>the card root is the <code>&lt;label&gt;</code></td><td>the root is a <code>div</code> owning the chrome; the <code>&lt;label&gt;</code> inside it (<code>data-fods-part="hit-area"</code>) owns hover, padding and the hit area. <code>className</code> still lands on the root. Visuals unchanged.</td></tr>
619
+ </tbody>
620
+ </table>
621
+
622
+ The 2.3.2 / 2.3.3 patches changed no value: the check note says 24, and the Horizontal numbers and
623
+ the subtitle style are structured (`sizes[].layouts`, `sizes[].runTextStyles`).
624
+
625
+ **Manifest 2.1.1 → 2.3.1 (one visual change, no API change).**
626
+
627
+ - **2.2.0** — the Selected check-circle is 24 (the icon-size step) at both sizes; `md` was 28, an
628
+ off-scale box. Visual change on `md` only (−4px); the position rules are unchanged.
629
+ - **2.1.2 / 2.1.3 / 2.3.0** — prose only: the illustration box names its size token
630
+ (80×80), `sizes[].icon` names the icon token, and the Figma Size values are renamed to the code
631
+ vocabulary (`md` / `sm`, which the `size` prop already used). The recipe now binds that token —
632
+ `size-illustration-card` (`--size-illustration-card`) instead of `size-1300`; same 80px.
633
+ - **2.3.1** — `Show media` off is valid on Stacked too: the text block reserves `--space-900` on
634
+ the right and the check centres on the label's first line. The focus ring is documented as what
635
+ ships — a CSS outline with a 2px offset whose corners follow the card radius.
636
+
637
+ **Manifest 2.1.0 → 2.1.1 (patch, nothing to rebuild).** `slots.media` now lists what the slot accepts
638
+ (`accepts`: icon, illustrations) — the `media` prop already takes an icon name or an illustration element.
639
+
640
+ **Manifest 2.0.1 → 2.1.0 (minor, no API change).** The illustration box is 80×80 (was 82×82), onto the
641
+ 4px grid — the recipe is `size-1300`.
642
+
643
+ **Manifest 1.5.2 → 2.0.0 (major).** The React API changed in one breaking place and several visual
644
+ ones:
645
+
646
+ <table>
647
+ <thead>
648
+ <tr><th>1.5.2</th><th>2.0.0</th></tr>
649
+ </thead>
650
+ <tbody>
651
+ <tr><td><code>align: 'left' | 'center'</code> (card + group), type <code>CardSelectAlign</code></td><td><strong>removed</strong> → <code>layout: 'stacked' | 'horizontal'</code> (card + group), type <code>CardSelectLayout</code>. Centring is an instance override via <code>className</code>.</td></tr>
652
+ <tr><td>media container with <code>--space-400</code> vertical padding; illustration 64×64</td><td>no container padding; illustration <strong>82×82</strong> (80×80 since 2.1.0); disabled illustration <code>grayscale</code></td></tr>
653
+ <tr><td>Selected fill <code>--bg-secondary</code></td><td><code>--secondary-subtle</code></td></tr>
654
+ <tr><td>Unselected border <code>--outline-default</code> (hover <code>--outline-strong</code>)</td><td><code>--outline-strong</code> at rest and on hover</td></tr>
655
+ <tr><td>radius <code>md</code> <code>--radius-400</code> · <code>sm</code> <code>--radius-300</code></td><td><code>md</code> <code>--radius-500</code> · <code>sm</code> <code>--radius-400</code></td></tr>
656
+ <tr><td><code>check</code> glyph 20 / 16, no disc</td><td><code>check-circle</code> 28 / 24 on a <code>--bg-primary</code> disc, centred on the media's axis</td></tr>
657
+ <tr><td>subtitle <code>Body/XS</code> at both sizes</td><td><code>Body/XS</code> (<code>md</code>) / <code>Body/XXS</code> (<code>sm</code>)</td></tr>
658
+ <tr><td>Disabled fill <code>--disabled</code></td><td><code>--disabled-control</code> (1.6.0)</td></tr>
659
+ <tr><td><code>tone="danger"</code>, <code>size="sm"</code></td><td><strong>deprecated, kept</strong>; Danger is ignored at <code>sm</code></td></tr>
660
+ </tbody>
661
+ </table>
662
+