@invoiceonline/ui-react 0.0.0-stage → 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (738) hide show
  1. package/AGENTS.md +99 -0
  2. package/CHANGELOG.md +131 -0
  3. package/LICENSE +9 -0
  4. package/README.md +78 -2
  5. package/dist/assets/label-brush-1.svg +6 -0
  6. package/dist/assets/pattern-dark.svg +113 -0
  7. package/dist/components/action-row/ActionRow.d.ts +178 -0
  8. package/dist/components/action-row/ActionRow.js +340 -0
  9. package/dist/components/action-row/index.d.ts +2 -0
  10. package/dist/components/action-row/index.js +1 -0
  11. package/dist/components/alert/Alert.d.ts +314 -0
  12. package/dist/components/alert/Alert.js +446 -0
  13. package/dist/components/alert/index.d.ts +2 -0
  14. package/dist/components/alert/index.js +1 -0
  15. package/dist/components/anchored-panel/AnchoredPanel.d.ts +41 -0
  16. package/dist/components/anchored-panel/AnchoredPanel.js +72 -0
  17. package/dist/components/anchored-panel/index.d.ts +3 -0
  18. package/dist/components/anchored-panel/index.js +3 -0
  19. package/dist/components/badge/Badge.d.ts +146 -0
  20. package/dist/components/badge/Badge.js +258 -0
  21. package/dist/components/badge/index.d.ts +2 -0
  22. package/dist/components/badge/index.js +1 -0
  23. package/dist/components/banner/Banner.d.ts +209 -0
  24. package/dist/components/banner/Banner.js +339 -0
  25. package/dist/components/banner/index.d.ts +2 -0
  26. package/dist/components/banner/index.js +1 -0
  27. package/dist/components/button/Button.d.ts +54 -0
  28. package/dist/components/button/Button.js +312 -0
  29. package/dist/components/button/index.d.ts +2 -0
  30. package/dist/components/button/index.js +1 -0
  31. package/dist/components/button-group/ButtonGroup.d.ts +187 -0
  32. package/dist/components/button-group/ButtonGroup.js +217 -0
  33. package/dist/components/button-group/index.d.ts +2 -0
  34. package/dist/components/button-group/index.js +1 -0
  35. package/dist/components/card-select/CardSelect.d.ts +274 -0
  36. package/dist/components/card-select/CardSelect.js +561 -0
  37. package/dist/components/card-select/CardSelectGroup.d.ts +92 -0
  38. package/dist/components/card-select/CardSelectGroup.js +72 -0
  39. package/dist/components/card-select/index.d.ts +3 -0
  40. package/dist/components/card-select/index.js +3 -0
  41. package/dist/components/checkbox/Checkbox.d.ts +104 -0
  42. package/dist/components/checkbox/Checkbox.js +194 -0
  43. package/dist/components/checkbox/index.d.ts +2 -0
  44. package/dist/components/checkbox/index.js +1 -0
  45. package/dist/components/chip/Chip.d.ts +250 -0
  46. package/dist/components/chip/Chip.js +441 -0
  47. package/dist/components/chip/index.d.ts +2 -0
  48. package/dist/components/chip/index.js +1 -0
  49. package/dist/components/column-header/ColumnHeader.d.ts +144 -0
  50. package/dist/components/column-header/ColumnHeader.js +209 -0
  51. package/dist/components/column-header/index.d.ts +2 -0
  52. package/dist/components/column-header/index.js +1 -0
  53. package/dist/components/combobox-field/Combobox.d.ts +104 -0
  54. package/dist/components/combobox-field/Combobox.js +355 -0
  55. package/dist/components/combobox-field/ComboboxField.d.ts +76 -0
  56. package/dist/components/combobox-field/ComboboxField.js +98 -0
  57. package/dist/components/combobox-field/index.d.ts +3 -0
  58. package/dist/components/combobox-field/index.js +3 -0
  59. package/dist/components/date-field/DateField.d.ts +52 -0
  60. package/dist/components/date-field/DateField.js +45 -0
  61. package/dist/components/date-field/index.d.ts +2 -0
  62. package/dist/components/date-field/index.js +1 -0
  63. package/dist/components/date-picker/DatePicker.d.ts +53 -0
  64. package/dist/components/date-picker/DatePicker.js +329 -0
  65. package/dist/components/date-picker/index.d.ts +2 -0
  66. package/dist/components/date-picker/index.js +1 -0
  67. package/dist/components/divider/Divider.d.ts +81 -0
  68. package/dist/components/divider/Divider.js +93 -0
  69. package/dist/components/divider/index.d.ts +2 -0
  70. package/dist/components/divider/index.js +1 -0
  71. package/dist/components/drawer/Drawer.d.ts +128 -0
  72. package/dist/components/drawer/Drawer.js +367 -0
  73. package/dist/components/drawer/index.d.ts +2 -0
  74. package/dist/components/drawer/index.js +1 -0
  75. package/dist/components/dropdown-button/DropdownButton.d.ts +72 -0
  76. package/dist/components/dropdown-button/DropdownButton.js +122 -0
  77. package/dist/components/dropdown-button/index.d.ts +2 -0
  78. package/dist/components/dropdown-button/index.js +1 -0
  79. package/dist/components/faq/FAQ.d.ts +135 -0
  80. package/dist/components/faq/FAQ.js +258 -0
  81. package/dist/components/faq/index.d.ts +2 -0
  82. package/dist/components/faq/index.js +1 -0
  83. package/dist/components/field/Field.d.ts +118 -0
  84. package/dist/components/field/Field.js +327 -0
  85. package/dist/components/field/index.d.ts +2 -0
  86. package/dist/components/field/index.js +1 -0
  87. package/dist/components/field-pair/FieldPair.d.ts +194 -0
  88. package/dist/components/field-pair/FieldPair.js +321 -0
  89. package/dist/components/field-pair/index.d.ts +2 -0
  90. package/dist/components/field-pair/index.js +1 -0
  91. package/dist/components/file-upload/FileUpload.d.ts +137 -0
  92. package/dist/components/file-upload/FileUpload.js +434 -0
  93. package/dist/components/file-upload/index.d.ts +2 -0
  94. package/dist/components/file-upload/index.js +1 -0
  95. package/dist/components/filter-chip/FilterChip.d.ts +373 -0
  96. package/dist/components/filter-chip/FilterChip.js +517 -0
  97. package/dist/components/filter-chip/index.d.ts +2 -0
  98. package/dist/components/filter-chip/index.js +1 -0
  99. package/dist/components/filter-facet/FilterFacet.d.ts +116 -0
  100. package/dist/components/filter-facet/FilterFacet.js +632 -0
  101. package/dist/components/filter-facet/index.d.ts +2 -0
  102. package/dist/components/filter-facet/index.js +1 -0
  103. package/dist/components/firm-avatar/FirmAvatar.d.ts +75 -0
  104. package/dist/components/firm-avatar/FirmAvatar.js +119 -0
  105. package/dist/components/firm-avatar/index.d.ts +2 -0
  106. package/dist/components/firm-avatar/index.js +1 -0
  107. package/dist/components/form-actions/FormActions.d.ts +123 -0
  108. package/dist/components/form-actions/FormActions.js +195 -0
  109. package/dist/components/form-actions/index.d.ts +2 -0
  110. package/dist/components/form-actions/index.js +1 -0
  111. package/dist/components/form-block/FormBlock.d.ts +252 -0
  112. package/dist/components/form-block/FormBlock.js +420 -0
  113. package/dist/components/form-block/index.d.ts +3 -0
  114. package/dist/components/form-block/index.js +3 -0
  115. package/dist/components/form-section/FormSection.d.ts +130 -0
  116. package/dist/components/form-section/FormSection.js +206 -0
  117. package/dist/components/form-section/index.d.ts +2 -0
  118. package/dist/components/form-section/index.js +1 -0
  119. package/dist/components/heading/Heading.d.ts +69 -0
  120. package/dist/components/heading/Heading.js +79 -0
  121. package/dist/components/heading/index.d.ts +2 -0
  122. package/dist/components/heading/index.js +1 -0
  123. package/dist/components/heading-group/HeadingGroup.d.ts +258 -0
  124. package/dist/components/heading-group/HeadingGroup.js +255 -0
  125. package/dist/components/heading-group/index.d.ts +2 -0
  126. package/dist/components/heading-group/index.js +1 -0
  127. package/dist/components/hero/Hero.d.ts +268 -0
  128. package/dist/components/hero/Hero.js +316 -0
  129. package/dist/components/hero/index.d.ts +2 -0
  130. package/dist/components/hero/index.js +1 -0
  131. package/dist/components/icon/Icon.d.ts +27 -0
  132. package/dist/components/icon/Icon.js +30 -0
  133. package/dist/components/icon/index.d.ts +3 -0
  134. package/dist/components/icon/index.js +3 -0
  135. package/dist/components/icon-button/IconButton.d.ts +75 -0
  136. package/dist/components/icon-button/IconButton.js +151 -0
  137. package/dist/components/icon-button/index.d.ts +2 -0
  138. package/dist/components/icon-button/index.js +1 -0
  139. package/dist/components/item-row/ItemRow.d.ts +253 -0
  140. package/dist/components/item-row/ItemRow.js +496 -0
  141. package/dist/components/item-row/index.d.ts +2 -0
  142. package/dist/components/item-row/index.js +1 -0
  143. package/dist/components/list-row/ListRow.d.ts +165 -0
  144. package/dist/components/list-row/ListRow.js +233 -0
  145. package/dist/components/list-row/index.d.ts +2 -0
  146. package/dist/components/list-row/index.js +1 -0
  147. package/dist/components/menu/Menu.d.ts +64 -0
  148. package/dist/components/menu/Menu.js +186 -0
  149. package/dist/components/menu/index.d.ts +2 -0
  150. package/dist/components/menu/index.js +1 -0
  151. package/dist/components/modal/Modal.d.ts +272 -0
  152. package/dist/components/modal/Modal.js +788 -0
  153. package/dist/components/modal/index.d.ts +2 -0
  154. package/dist/components/modal/index.js +1 -0
  155. package/dist/components/nav-link/NavLink.d.ts +123 -0
  156. package/dist/components/nav-link/NavLink.js +157 -0
  157. package/dist/components/nav-link/index.d.ts +2 -0
  158. package/dist/components/nav-link/index.js +1 -0
  159. package/dist/components/number-field/NumberField.d.ts +62 -0
  160. package/dist/components/number-field/NumberField.js +210 -0
  161. package/dist/components/number-field/index.d.ts +2 -0
  162. package/dist/components/number-field/index.js +1 -0
  163. package/dist/components/pagination/Pagination.d.ts +133 -0
  164. package/dist/components/pagination/Pagination.js +217 -0
  165. package/dist/components/pagination/index.d.ts +3 -0
  166. package/dist/components/pagination/index.js +3 -0
  167. package/dist/components/popover-surface/index.d.ts +2 -0
  168. package/dist/components/popover-surface/index.js +1 -0
  169. package/dist/components/progress-bar/ProgressBar.d.ts +260 -0
  170. package/dist/components/progress-bar/ProgressBar.js +470 -0
  171. package/dist/components/progress-bar/index.d.ts +2 -0
  172. package/dist/components/progress-bar/index.js +1 -0
  173. package/dist/components/promo-sticker/PromoSticker.d.ts +204 -0
  174. package/dist/components/promo-sticker/PromoSticker.js +177 -0
  175. package/dist/components/promo-sticker/index.d.ts +2 -0
  176. package/dist/components/promo-sticker/index.js +1 -0
  177. package/dist/components/promo-surface/PromoSurface.d.ts +94 -0
  178. package/dist/components/promo-surface/PromoSurface.js +119 -0
  179. package/dist/components/promo-surface/index.d.ts +2 -0
  180. package/dist/components/promo-surface/index.js +1 -0
  181. package/dist/components/radio/Radio.d.ts +92 -0
  182. package/dist/components/radio/Radio.js +171 -0
  183. package/dist/components/radio/index.d.ts +2 -0
  184. package/dist/components/radio/index.js +1 -0
  185. package/dist/components/radio-group/RadioGroup.d.ts +61 -0
  186. package/dist/components/radio-group/RadioGroup.js +51 -0
  187. package/dist/components/radio-group/index.d.ts +2 -0
  188. package/dist/components/radio-group/index.js +1 -0
  189. package/dist/components/select/Select.d.ts +65 -0
  190. package/dist/components/select/Select.js +176 -0
  191. package/dist/components/select/index.d.ts +2 -0
  192. package/dist/components/select/index.js +1 -0
  193. package/dist/components/select-field/SelectField.d.ts +16 -0
  194. package/dist/components/select-field/SelectField.js +55 -0
  195. package/dist/components/select-field/index.d.ts +2 -0
  196. package/dist/components/select-field/index.js +1 -0
  197. package/dist/components/skeleton/Skeleton.d.ts +64 -0
  198. package/dist/components/skeleton/Skeleton.js +65 -0
  199. package/dist/components/skeleton/index.d.ts +2 -0
  200. package/dist/components/skeleton/index.js +1 -0
  201. package/dist/components/split-button/SplitButton.d.ts +80 -0
  202. package/dist/components/split-button/SplitButton.js +182 -0
  203. package/dist/components/split-button/index.d.ts +2 -0
  204. package/dist/components/split-button/index.js +1 -0
  205. package/dist/components/status-summary-bar/StatusSummaryBar.d.ts +118 -0
  206. package/dist/components/status-summary-bar/StatusSummaryBar.js +278 -0
  207. package/dist/components/status-summary-bar/index.d.ts +2 -0
  208. package/dist/components/status-summary-bar/index.js +1 -0
  209. package/dist/components/subject-lookup-field/SubjectLookupField.d.ts +157 -0
  210. package/dist/components/subject-lookup-field/SubjectLookupField.js +663 -0
  211. package/dist/components/subject-lookup-field/index.d.ts +2 -0
  212. package/dist/components/subject-lookup-field/index.js +1 -0
  213. package/dist/components/switch/Switch.d.ts +152 -0
  214. package/dist/components/switch/Switch.js +307 -0
  215. package/dist/components/switch/index.d.ts +2 -0
  216. package/dist/components/switch/index.js +1 -0
  217. package/dist/components/table/Table.d.ts +5 -0
  218. package/dist/components/table/Table.js +601 -0
  219. package/dist/components/table/index.d.ts +6 -0
  220. package/dist/components/table/index.js +6 -0
  221. package/dist/components/text-field/TextField.d.ts +65 -0
  222. package/dist/components/text-field/TextField.js +173 -0
  223. package/dist/components/text-field/index.d.ts +2 -0
  224. package/dist/components/text-field/index.js +1 -0
  225. package/dist/components/text-link/TextLink.d.ts +260 -0
  226. package/dist/components/text-link/TextLink.js +303 -0
  227. package/dist/components/text-link/index.d.ts +2 -0
  228. package/dist/components/text-link/index.js +1 -0
  229. package/dist/components/textarea/Textarea.d.ts +93 -0
  230. package/dist/components/textarea/Textarea.js +256 -0
  231. package/dist/components/textarea/index.d.ts +2 -0
  232. package/dist/components/textarea/index.js +1 -0
  233. package/dist/components/tooltip/Tooltip.d.ts +129 -0
  234. package/dist/components/tooltip/Tooltip.js +457 -0
  235. package/dist/components/tooltip/index.d.ts +2 -0
  236. package/dist/components/tooltip/index.js +1 -0
  237. package/dist/components/unit-field/UnitField.d.ts +46 -0
  238. package/dist/components/unit-field/UnitField.js +133 -0
  239. package/dist/components/unit-field/index.d.ts +2 -0
  240. package/dist/components/unit-field/index.js +1 -0
  241. package/dist/icons/icon-registry.generated.js +500 -0
  242. package/dist/icons/icon-types.generated.d.ts +2 -0
  243. package/dist/icons/icon-types.generated.js +126 -0
  244. package/dist/index.d.ts +132 -0
  245. package/dist/index.js +75 -0
  246. package/dist/internal/BottomSheet.js +496 -0
  247. package/dist/internal/FodsProvider.d.ts +25 -0
  248. package/dist/internal/FodsProvider.js +32 -0
  249. package/dist/internal/MotionCaret.js +35 -0
  250. package/dist/internal/NumberFormatInput.d.ts +21 -0
  251. package/dist/internal/NumberFormatInput.js +126 -0
  252. package/dist/internal/SummaryDonut.d.ts +3 -0
  253. package/dist/internal/SummaryDonut.js +300 -0
  254. package/dist/internal/buttonSegment.d.ts +44 -0
  255. package/dist/internal/buttonSegment.js +126 -0
  256. package/dist/internal/collapseRoom.js +128 -0
  257. package/dist/internal/comboboxKeys.js +44 -0
  258. package/dist/internal/contentPresence.js +46 -0
  259. package/dist/internal/dayCell.js +95 -0
  260. package/dist/internal/dialogPortal.d.ts +2 -0
  261. package/dist/internal/dialogPortal.js +21 -0
  262. package/dist/internal/donutSweeps.js +65 -0
  263. package/dist/internal/enterOnViewGeometry.js +46 -0
  264. package/dist/internal/faqItem.js +80 -0
  265. package/dist/internal/floatingLabelMotion.js +68 -0
  266. package/dist/internal/formBlockContext.d.ts +22 -0
  267. package/dist/internal/formBlockContext.js +20 -0
  268. package/dist/internal/heightRoom.js +87 -0
  269. package/dist/internal/numberSeparators.js +62 -0
  270. package/dist/internal/overlayMotion.js +48 -0
  271. package/dist/internal/paginationItem.d.ts +8 -0
  272. package/dist/internal/paginationItem.js +22 -0
  273. package/dist/internal/popoverSurface.d.ts +8 -0
  274. package/dist/internal/popoverSurface.js +23 -0
  275. package/dist/internal/portalContainer.d.ts +1 -0
  276. package/dist/internal/portalContainer.js +6 -0
  277. package/dist/internal/progressBarItem.d.ts +207 -0
  278. package/dist/internal/progressBarItem.js +264 -0
  279. package/dist/internal/selectionControlText.js +12 -0
  280. package/dist/internal/statusSummaryParts.js +371 -0
  281. package/dist/internal/summaryMotion.js +75 -0
  282. package/dist/internal/table/ChildConnector.js +62 -0
  283. package/dist/internal/table/ChildRowPrefix.d.ts +9 -0
  284. package/dist/internal/table/ChildRowPrefix.js +27 -0
  285. package/dist/internal/table/ColumnSettings.js +135 -0
  286. package/dist/internal/table/ScrollRegion.js +114 -0
  287. package/dist/internal/table/TableEmpty.js +93 -0
  288. package/dist/internal/table/TableLayout.d.ts +17 -0
  289. package/dist/internal/table/TableLayout.js +29 -0
  290. package/dist/internal/table/TableLoadStatus.js +56 -0
  291. package/dist/internal/table/TableMobile.js +488 -0
  292. package/dist/internal/table/TruncatedCell.js +33 -0
  293. package/dist/internal/table/emptyValue.js +10 -0
  294. package/dist/internal/table/features.d.ts +41 -0
  295. package/dist/internal/table/features.js +31 -0
  296. package/dist/internal/table/recipes.js +227 -0
  297. package/dist/internal/table/rowClick.js +9 -0
  298. package/dist/internal/table/types.d.ts +325 -0
  299. package/dist/internal/table/types.js +13 -0
  300. package/dist/internal/tailwind-variants.d.ts +3 -0
  301. package/dist/internal/tailwind-variants.js +37 -0
  302. package/dist/internal/tooltipContext.js +5 -0
  303. package/dist/internal/tw-merge-config.generated.js +314 -0
  304. package/dist/internal/useAnchoredPanel.d.ts +87 -0
  305. package/dist/internal/useAnchoredPanel.js +108 -0
  306. package/dist/internal/useCountUp.js +53 -0
  307. package/dist/internal/useDateFieldTrigger.js +183 -0
  308. package/dist/internal/useEChart.js +59 -0
  309. package/dist/internal/useEnterOnView.js +42 -0
  310. package/dist/internal/useFloatingBar.js +100 -0
  311. package/dist/internal/useFormReset.js +37 -0
  312. package/dist/internal/useIsMobile.js +44 -0
  313. package/dist/internal/useOneRowOverflow.js +88 -0
  314. package/dist/internal/usePrefersReducedMotion.js +25 -0
  315. package/dist/internal/useReturnFocus.js +26 -0
  316. package/dist/internal/utils.d.ts +7 -0
  317. package/dist/internal/utils.js +58 -0
  318. package/dist/node_modules/@tanstack/store/dist/store.d.ts +29 -0
  319. package/dist/node_modules/@tanstack/store/dist/types.d.ts +38 -0
  320. package/dist/node_modules/@tanstack/table-core/dist/core/cells/coreCellsFeature.d.ts +6 -0
  321. package/dist/node_modules/@tanstack/table-core/dist/core/cells/coreCellsFeature.types.d.ts +53 -0
  322. package/dist/node_modules/@tanstack/table-core/dist/core/columns/coreColumnsFeature.d.ts +6 -0
  323. package/dist/node_modules/@tanstack/table-core/dist/core/columns/coreColumnsFeature.types.d.ts +90 -0
  324. package/dist/node_modules/@tanstack/table-core/dist/core/coreFeatures.d.ts +17 -0
  325. package/dist/node_modules/@tanstack/table-core/dist/core/headers/coreHeadersFeature.d.ts +6 -0
  326. package/dist/node_modules/@tanstack/table-core/dist/core/headers/coreHeadersFeature.types.d.ts +114 -0
  327. package/dist/node_modules/@tanstack/table-core/dist/core/reactivity/coreReactivityFeature.types.d.ts +51 -0
  328. package/dist/node_modules/@tanstack/table-core/dist/core/row-models/coreRowModelsFeature.d.ts +6 -0
  329. package/dist/node_modules/@tanstack/table-core/dist/core/row-models/coreRowModelsFeature.types.d.ts +29 -0
  330. package/dist/node_modules/@tanstack/table-core/dist/core/rows/coreRowsFeature.d.ts +6 -0
  331. package/dist/node_modules/@tanstack/table-core/dist/core/rows/coreRowsFeature.types.d.ts +129 -0
  332. package/dist/node_modules/@tanstack/table-core/dist/core/table/coreTablesFeature.d.ts +6 -0
  333. package/dist/node_modules/@tanstack/table-core/dist/core/table/coreTablesFeature.types.d.ts +203 -0
  334. package/dist/node_modules/@tanstack/table-core/dist/features/cell-selection/cellSelectionFeature.d.ts +6 -0
  335. package/dist/node_modules/@tanstack/table-core/dist/features/cell-selection/cellSelectionFeature.types.d.ts +294 -0
  336. package/dist/node_modules/@tanstack/table-core/dist/features/cell-spanning/cellSpanningFeature.d.ts +11 -0
  337. package/dist/node_modules/@tanstack/table-core/dist/features/cell-spanning/cellSpanningFeature.types.d.ts +148 -0
  338. package/dist/node_modules/@tanstack/table-core/dist/features/column-faceting/columnFacetingFeature.d.ts +12 -0
  339. package/dist/node_modules/@tanstack/table-core/dist/features/column-faceting/columnFacetingFeature.types.d.ts +63 -0
  340. package/dist/node_modules/@tanstack/table-core/dist/features/column-filtering/columnFilteringFeature.d.ts +6 -0
  341. package/dist/node_modules/@tanstack/table-core/dist/features/column-filtering/columnFilteringFeature.types.d.ts +209 -0
  342. package/dist/node_modules/@tanstack/table-core/dist/features/column-filtering/filterFns.d.ts +35 -0
  343. package/dist/node_modules/@tanstack/table-core/dist/features/column-grouping/columnGroupingFeature.d.ts +6 -0
  344. package/dist/node_modules/@tanstack/table-core/dist/features/column-grouping/columnGroupingFeature.types.d.ts +128 -0
  345. package/dist/node_modules/@tanstack/table-core/dist/features/column-ordering/columnOrderingFeature.d.ts +6 -0
  346. package/dist/node_modules/@tanstack/table-core/dist/features/column-ordering/columnOrderingFeature.types.d.ts +82 -0
  347. package/dist/node_modules/@tanstack/table-core/dist/features/column-pinning/columnPinningFeature.d.ts +11 -0
  348. package/dist/node_modules/@tanstack/table-core/dist/features/column-pinning/columnPinningFeature.types.d.ts +195 -0
  349. package/dist/node_modules/@tanstack/table-core/dist/features/column-resizing/columnResizingFeature.d.ts +6 -0
  350. package/dist/node_modules/@tanstack/table-core/dist/features/column-resizing/columnResizingFeature.types.d.ts +73 -0
  351. package/dist/node_modules/@tanstack/table-core/dist/features/column-sizing/columnSizingFeature.d.ts +6 -0
  352. package/dist/node_modules/@tanstack/table-core/dist/features/column-sizing/columnSizingFeature.types.d.ts +134 -0
  353. package/dist/node_modules/@tanstack/table-core/dist/features/column-visibility/columnVisibilityFeature.d.ts +6 -0
  354. package/dist/node_modules/@tanstack/table-core/dist/features/column-visibility/columnVisibilityFeature.types.d.ts +92 -0
  355. package/dist/node_modules/@tanstack/table-core/dist/features/global-filtering/globalFilteringFeature.d.ts +6 -0
  356. package/dist/node_modules/@tanstack/table-core/dist/features/global-filtering/globalFilteringFeature.types.d.ts +67 -0
  357. package/dist/node_modules/@tanstack/table-core/dist/features/row-aggregation/aggregationFns.d.ts +23 -0
  358. package/dist/node_modules/@tanstack/table-core/dist/features/row-aggregation/rowAggregationFeature.d.ts +6 -0
  359. package/dist/node_modules/@tanstack/table-core/dist/features/row-aggregation/rowAggregationFeature.types.d.ts +183 -0
  360. package/dist/node_modules/@tanstack/table-core/dist/features/row-aggregation/rowAggregationFeature.utils.d.ts +18 -0
  361. package/dist/node_modules/@tanstack/table-core/dist/features/row-expanding/rowExpandingFeature.d.ts +6 -0
  362. package/dist/node_modules/@tanstack/table-core/dist/features/row-expanding/rowExpandingFeature.types.d.ts +125 -0
  363. package/dist/node_modules/@tanstack/table-core/dist/features/row-pagination/rowPaginationFeature.d.ts +6 -0
  364. package/dist/node_modules/@tanstack/table-core/dist/features/row-pagination/rowPaginationFeature.types.d.ts +135 -0
  365. package/dist/node_modules/@tanstack/table-core/dist/features/row-pinning/rowPinningFeature.d.ts +6 -0
  366. package/dist/node_modules/@tanstack/table-core/dist/features/row-pinning/rowPinningFeature.types.d.ts +76 -0
  367. package/dist/node_modules/@tanstack/table-core/dist/features/row-selection/rowSelectionFeature.d.ts +6 -0
  368. package/dist/node_modules/@tanstack/table-core/dist/features/row-selection/rowSelectionFeature.types.d.ts +187 -0
  369. package/dist/node_modules/@tanstack/table-core/dist/features/row-sorting/rowSortingFeature.d.ts +6 -0
  370. package/dist/node_modules/@tanstack/table-core/dist/features/row-sorting/rowSortingFeature.types.d.ts +236 -0
  371. package/dist/node_modules/@tanstack/table-core/dist/features/row-sorting/sortFns.d.ts +23 -0
  372. package/dist/node_modules/@tanstack/table-core/dist/features/stockFeatures.d.ts +37 -0
  373. package/dist/node_modules/@tanstack/table-core/dist/helpers/columnHelper.d.ts +47 -0
  374. package/dist/node_modules/@tanstack/table-core/dist/types/Cell.d.ts +16 -0
  375. package/dist/node_modules/@tanstack/table-core/dist/types/Column.d.ts +30 -0
  376. package/dist/node_modules/@tanstack/table-core/dist/types/ColumnDef.d.ts +123 -0
  377. package/dist/node_modules/@tanstack/table-core/dist/types/Header.d.ts +12 -0
  378. package/dist/node_modules/@tanstack/table-core/dist/types/HeaderGroup.d.ts +6 -0
  379. package/dist/node_modules/@tanstack/table-core/dist/types/Row.d.ts +24 -0
  380. package/dist/node_modules/@tanstack/table-core/dist/types/RowModel.d.ts +19 -0
  381. package/dist/node_modules/@tanstack/table-core/dist/types/RowModelFns.d.ts +11 -0
  382. package/dist/node_modules/@tanstack/table-core/dist/types/Table.d.ts +53 -0
  383. package/dist/node_modules/@tanstack/table-core/dist/types/TableFeatures.d.ts +416 -0
  384. package/dist/node_modules/@tanstack/table-core/dist/types/TableOptions.d.ts +78 -0
  385. package/dist/node_modules/@tanstack/table-core/dist/types/TableState.d.ts +46 -0
  386. package/dist/node_modules/@tanstack/table-core/dist/types/type-utils.d.ts +25 -0
  387. package/dist/shared.css +179 -0
  388. package/dist/styles.css +5467 -0
  389. package/dist/theme.css +314 -0
  390. package/dist/theme.map.json +278 -0
  391. package/dist/tokens/index.d.ts +2 -0
  392. package/dist/tokens/index.js +1 -0
  393. package/dist/tokens/tokens.generated.d.ts +2040 -0
  394. package/dist/tokens/tokens.generated.js +2053 -0
  395. package/dist/tokens.css +484 -0
  396. package/dist/tokens.flat.json +429 -0
  397. package/docs/Consuming.mdx +379 -0
  398. package/docs/Contributing.mdx +78 -0
  399. package/docs/ForAgents.mdx +53 -0
  400. package/docs/Introduction.mdx +54 -0
  401. package/llms.txt +556 -0
  402. package/package.json +357 -4
  403. package/src/components/action-row/ActionRow.mdx +686 -0
  404. package/src/components/action-row/ActionRow.stories.tsx +669 -0
  405. package/src/components/action-row/ActionRow.tsx +632 -0
  406. package/src/components/action-row/index.ts +9 -0
  407. package/src/components/alert/Alert.mdx +377 -0
  408. package/src/components/alert/Alert.stories.tsx +674 -0
  409. package/src/components/alert/Alert.tsx +579 -0
  410. package/src/components/alert/index.ts +13 -0
  411. package/src/components/anchored-panel/AnchoredPanel.mdx +381 -0
  412. package/src/components/anchored-panel/AnchoredPanel.stories.tsx +593 -0
  413. package/src/components/anchored-panel/AnchoredPanel.tsx +176 -0
  414. package/src/components/anchored-panel/index.ts +15 -0
  415. package/src/components/badge/Badge.mdx +487 -0
  416. package/src/components/badge/Badge.stories.tsx +375 -0
  417. package/src/components/badge/Badge.tsx +360 -0
  418. package/src/components/badge/index.ts +10 -0
  419. package/src/components/banner/Banner.mdx +704 -0
  420. package/src/components/banner/Banner.stories.tsx +448 -0
  421. package/src/components/banner/Banner.tsx +602 -0
  422. package/src/components/banner/index.ts +14 -0
  423. package/src/components/button/Button.mdx +286 -0
  424. package/src/components/button/Button.stories.tsx +381 -0
  425. package/src/components/button/Button.tsx +384 -0
  426. package/src/components/button/index.ts +1 -0
  427. package/src/components/button-group/ButtonGroup.mdx +512 -0
  428. package/src/components/button-group/ButtonGroup.stories.tsx +714 -0
  429. package/src/components/button-group/ButtonGroup.tsx +491 -0
  430. package/src/components/button-group/index.ts +10 -0
  431. package/src/components/card-select/CardSelect.mdx +662 -0
  432. package/src/components/card-select/CardSelect.stories.tsx +784 -0
  433. package/src/components/card-select/CardSelect.tsx +783 -0
  434. package/src/components/card-select/CardSelectGroup.tsx +169 -0
  435. package/src/components/card-select/index.ts +18 -0
  436. package/src/components/checkbox/Checkbox.mdx +269 -0
  437. package/src/components/checkbox/Checkbox.stories.tsx +306 -0
  438. package/src/components/checkbox/Checkbox.tsx +343 -0
  439. package/src/components/checkbox/index.ts +1 -0
  440. package/src/components/chip/Chip.mdx +683 -0
  441. package/src/components/chip/Chip.stories.tsx +734 -0
  442. package/src/components/chip/Chip.tsx +732 -0
  443. package/src/components/chip/index.ts +9 -0
  444. package/src/components/column-header/ColumnHeader.mdx +301 -0
  445. package/src/components/column-header/ColumnHeader.stories.tsx +319 -0
  446. package/src/components/column-header/ColumnHeader.tsx +287 -0
  447. package/src/components/column-header/index.ts +7 -0
  448. package/src/components/combobox-field/Combobox.tsx +693 -0
  449. package/src/components/combobox-field/ComboboxField.mdx +525 -0
  450. package/src/components/combobox-field/ComboboxField.stories.tsx +502 -0
  451. package/src/components/combobox-field/ComboboxField.tsx +259 -0
  452. package/src/components/combobox-field/index.ts +12 -0
  453. package/src/components/date-field/DateField.mdx +340 -0
  454. package/src/components/date-field/DateField.stories.tsx +221 -0
  455. package/src/components/date-field/DateField.tsx +176 -0
  456. package/src/components/date-field/index.ts +1 -0
  457. package/src/components/date-picker/DatePicker.mdx +436 -0
  458. package/src/components/date-picker/DatePicker.stories.tsx +458 -0
  459. package/src/components/date-picker/DatePicker.tsx +688 -0
  460. package/src/components/date-picker/index.ts +9 -0
  461. package/src/components/divider/Divider.mdx +256 -0
  462. package/src/components/divider/Divider.stories.tsx +177 -0
  463. package/src/components/divider/Divider.tsx +193 -0
  464. package/src/components/divider/index.ts +1 -0
  465. package/src/components/drawer/Drawer.mdx +518 -0
  466. package/src/components/drawer/Drawer.stories.tsx +392 -0
  467. package/src/components/drawer/Drawer.tsx +683 -0
  468. package/src/components/drawer/index.ts +1 -0
  469. package/src/components/dropdown-button/DropdownButton.mdx +285 -0
  470. package/src/components/dropdown-button/DropdownButton.stories.tsx +398 -0
  471. package/src/components/dropdown-button/DropdownButton.tsx +198 -0
  472. package/src/components/dropdown-button/index.ts +7 -0
  473. package/src/components/faq/FAQ.mdx +364 -0
  474. package/src/components/faq/FAQ.stories.tsx +343 -0
  475. package/src/components/faq/FAQ.tsx +337 -0
  476. package/src/components/faq/index.ts +1 -0
  477. package/src/components/field/Field.mdx +129 -0
  478. package/src/components/field/Field.stories.tsx +461 -0
  479. package/src/components/field/Field.tsx +765 -0
  480. package/src/components/field/index.ts +20 -0
  481. package/src/components/field-pair/FieldPair.mdx +308 -0
  482. package/src/components/field-pair/FieldPair.stories.tsx +530 -0
  483. package/src/components/field-pair/FieldPair.tsx +796 -0
  484. package/src/components/field-pair/index.ts +9 -0
  485. package/src/components/file-upload/FileUpload.mdx +345 -0
  486. package/src/components/file-upload/FileUpload.stories.tsx +698 -0
  487. package/src/components/file-upload/FileUpload.tsx +802 -0
  488. package/src/components/file-upload/index.ts +6 -0
  489. package/src/components/filter-chip/FilterChip.mdx +778 -0
  490. package/src/components/filter-chip/FilterChip.stories.tsx +827 -0
  491. package/src/components/filter-chip/FilterChip.tsx +881 -0
  492. package/src/components/filter-chip/index.ts +11 -0
  493. package/src/components/filter-facet/FilterFacet.mdx +536 -0
  494. package/src/components/filter-facet/FilterFacet.stories.tsx +506 -0
  495. package/src/components/filter-facet/FilterFacet.tsx +1160 -0
  496. package/src/components/filter-facet/index.ts +7 -0
  497. package/src/components/firm-avatar/FirmAvatar.mdx +280 -0
  498. package/src/components/firm-avatar/FirmAvatar.stories.tsx +147 -0
  499. package/src/components/firm-avatar/FirmAvatar.tsx +172 -0
  500. package/src/components/firm-avatar/index.ts +7 -0
  501. package/src/components/form-actions/FormActions.mdx +518 -0
  502. package/src/components/form-actions/FormActions.stories.tsx +621 -0
  503. package/src/components/form-actions/FormActions.tsx +273 -0
  504. package/src/components/form-actions/index.ts +6 -0
  505. package/src/components/form-block/FormBlock.mdx +728 -0
  506. package/src/components/form-block/FormBlock.stories.tsx +813 -0
  507. package/src/components/form-block/FormBlock.tsx +679 -0
  508. package/src/components/form-block/index.ts +13 -0
  509. package/src/components/form-section/FormSection.mdx +436 -0
  510. package/src/components/form-section/FormSection.stories.tsx +407 -0
  511. package/src/components/form-section/FormSection.tsx +290 -0
  512. package/src/components/form-section/index.ts +17 -0
  513. package/src/components/heading/Heading.mdx +206 -0
  514. package/src/components/heading/Heading.stories.tsx +169 -0
  515. package/src/components/heading/Heading.tsx +124 -0
  516. package/src/components/heading/index.ts +8 -0
  517. package/src/components/heading-group/HeadingGroup.mdx +521 -0
  518. package/src/components/heading-group/HeadingGroup.stories.tsx +353 -0
  519. package/src/components/heading-group/HeadingGroup.tsx +396 -0
  520. package/src/components/heading-group/index.ts +7 -0
  521. package/src/components/hero/Hero.mdx +742 -0
  522. package/src/components/hero/Hero.stories.tsx +527 -0
  523. package/src/components/hero/Hero.tsx +807 -0
  524. package/src/components/hero/index.ts +1 -0
  525. package/src/components/icon/Icon.mdx +329 -0
  526. package/src/components/icon/Icon.stories.tsx +398 -0
  527. package/src/components/icon/Icon.tsx +97 -0
  528. package/src/components/icon/index.ts +2 -0
  529. package/src/components/icon-button/IconButton.mdx +206 -0
  530. package/src/components/icon-button/IconButton.stories.tsx +341 -0
  531. package/src/components/icon-button/IconButton.tsx +273 -0
  532. package/src/components/icon-button/index.ts +1 -0
  533. package/src/components/item-row/ItemRow.mdx +533 -0
  534. package/src/components/item-row/ItemRow.stories.tsx +434 -0
  535. package/src/components/item-row/ItemRow.tsx +676 -0
  536. package/src/components/item-row/index.ts +9 -0
  537. package/src/components/list-row/ListRow.mdx +404 -0
  538. package/src/components/list-row/ListRow.stories.tsx +404 -0
  539. package/src/components/list-row/ListRow.tsx +424 -0
  540. package/src/components/list-row/index.ts +1 -0
  541. package/src/components/menu/Menu.mdx +268 -0
  542. package/src/components/menu/Menu.stories.tsx +455 -0
  543. package/src/components/menu/Menu.tsx +452 -0
  544. package/src/components/menu/index.ts +1 -0
  545. package/src/components/modal/Modal.mdx +854 -0
  546. package/src/components/modal/Modal.stories.tsx +881 -0
  547. package/src/components/modal/Modal.tsx +1434 -0
  548. package/src/components/modal/index.ts +1 -0
  549. package/src/components/nav-link/NavLink.mdx +196 -0
  550. package/src/components/nav-link/NavLink.stories.tsx +243 -0
  551. package/src/components/nav-link/NavLink.tsx +222 -0
  552. package/src/components/nav-link/index.ts +1 -0
  553. package/src/components/number-field/NumberField.mdx +223 -0
  554. package/src/components/number-field/NumberField.stories.tsx +291 -0
  555. package/src/components/number-field/NumberField.tsx +388 -0
  556. package/src/components/number-field/index.ts +6 -0
  557. package/src/components/pagination/Pagination.mdx +305 -0
  558. package/src/components/pagination/Pagination.stories.tsx +333 -0
  559. package/src/components/pagination/Pagination.tsx +343 -0
  560. package/src/components/pagination/index.ts +8 -0
  561. package/src/components/popover-surface/PopoverSurface.mdx +158 -0
  562. package/src/components/popover-surface/PopoverSurface.stories.tsx +421 -0
  563. package/src/components/popover-surface/index.ts +1 -0
  564. package/src/components/progress-bar/ProgressBar.mdx +802 -0
  565. package/src/components/progress-bar/ProgressBar.stories.tsx +533 -0
  566. package/src/components/progress-bar/ProgressBar.tsx +654 -0
  567. package/src/components/progress-bar/index.ts +9 -0
  568. package/src/components/promo-sticker/PromoSticker.mdx +436 -0
  569. package/src/components/promo-sticker/PromoSticker.stories.tsx +363 -0
  570. package/src/components/promo-sticker/PromoSticker.tsx +313 -0
  571. package/src/components/promo-sticker/index.ts +7 -0
  572. package/src/components/promo-surface/PromoSurface.mdx +399 -0
  573. package/src/components/promo-surface/PromoSurface.stories.tsx +270 -0
  574. package/src/components/promo-surface/PromoSurface.tsx +305 -0
  575. package/src/components/promo-surface/index.ts +7 -0
  576. package/src/components/radio/Radio.mdx +243 -0
  577. package/src/components/radio/Radio.stories.tsx +307 -0
  578. package/src/components/radio/Radio.tsx +288 -0
  579. package/src/components/radio/index.ts +1 -0
  580. package/src/components/radio-group/RadioGroup.mdx +119 -0
  581. package/src/components/radio-group/RadioGroup.stories.tsx +225 -0
  582. package/src/components/radio-group/RadioGroup.tsx +139 -0
  583. package/src/components/radio-group/index.ts +1 -0
  584. package/src/components/select/Select.mdx +241 -0
  585. package/src/components/select/Select.stories.tsx +404 -0
  586. package/src/components/select/Select.tsx +381 -0
  587. package/src/components/select/index.ts +1 -0
  588. package/src/components/select-field/SelectField.mdx +324 -0
  589. package/src/components/select-field/SelectField.stories.tsx +460 -0
  590. package/src/components/select-field/SelectField.tsx +138 -0
  591. package/src/components/select-field/index.ts +1 -0
  592. package/src/components/skeleton/Skeleton.mdx +194 -0
  593. package/src/components/skeleton/Skeleton.stories.tsx +260 -0
  594. package/src/components/skeleton/Skeleton.tsx +107 -0
  595. package/src/components/skeleton/index.ts +1 -0
  596. package/src/components/split-button/SplitButton.mdx +445 -0
  597. package/src/components/split-button/SplitButton.stories.tsx +465 -0
  598. package/src/components/split-button/SplitButton.tsx +361 -0
  599. package/src/components/split-button/index.ts +7 -0
  600. package/src/components/status-summary-bar/StatusSummaryBar.mdx +338 -0
  601. package/src/components/status-summary-bar/StatusSummaryBar.stories.tsx +408 -0
  602. package/src/components/status-summary-bar/StatusSummaryBar.tsx +428 -0
  603. package/src/components/status-summary-bar/index.ts +8 -0
  604. package/src/components/subject-lookup-field/SubjectLookupField.mdx +378 -0
  605. package/src/components/subject-lookup-field/SubjectLookupField.stories.tsx +393 -0
  606. package/src/components/subject-lookup-field/SubjectLookupField.tsx +1079 -0
  607. package/src/components/subject-lookup-field/index.ts +11 -0
  608. package/src/components/switch/Switch.mdx +376 -0
  609. package/src/components/switch/Switch.stories.tsx +296 -0
  610. package/src/components/switch/Switch.tsx +483 -0
  611. package/src/components/switch/index.ts +1 -0
  612. package/src/components/table/Table.mdx +575 -0
  613. package/src/components/table/Table.stories.tsx +1049 -0
  614. package/src/components/table/Table.tsx +745 -0
  615. package/src/components/table/TableConsumers.stories.tsx +195 -0
  616. package/src/components/table/_tableFixtures.ts +1189 -0
  617. package/src/components/table/index.ts +22 -0
  618. package/src/components/text-field/TextField.mdx +479 -0
  619. package/src/components/text-field/TextField.stories.tsx +366 -0
  620. package/src/components/text-field/TextField.tsx +391 -0
  621. package/src/components/text-field/index.ts +8 -0
  622. package/src/components/text-link/TextLink.mdx +353 -0
  623. package/src/components/text-link/TextLink.stories.tsx +458 -0
  624. package/src/components/text-link/TextLink.tsx +504 -0
  625. package/src/components/text-link/index.ts +10 -0
  626. package/src/components/textarea/Textarea.mdx +244 -0
  627. package/src/components/textarea/Textarea.stories.tsx +371 -0
  628. package/src/components/textarea/Textarea.tsx +489 -0
  629. package/src/components/textarea/index.ts +9 -0
  630. package/src/components/tooltip/Tooltip.mdx +462 -0
  631. package/src/components/tooltip/Tooltip.stories.tsx +500 -0
  632. package/src/components/tooltip/Tooltip.tsx +756 -0
  633. package/src/components/tooltip/index.ts +13 -0
  634. package/src/components/unit-field/UnitField.mdx +215 -0
  635. package/src/components/unit-field/UnitField.stories.tsx +291 -0
  636. package/src/components/unit-field/UnitField.tsx +255 -0
  637. package/src/components/unit-field/index.ts +7 -0
  638. package/src/icons/icon-registry.generated.ts +510 -0
  639. package/src/icons/icon-types.generated.ts +256 -0
  640. package/src/index.ts +71 -0
  641. package/src/internal/BottomSheet.tsx +714 -0
  642. package/src/internal/FodsProvider.tsx +36 -0
  643. package/src/internal/MotionCaret.tsx +53 -0
  644. package/src/internal/NumberFormatInput.tsx +276 -0
  645. package/src/internal/SummaryDonut.tsx +359 -0
  646. package/src/internal/buttonSegment.ts +241 -0
  647. package/src/internal/collapseRoom.ts +130 -0
  648. package/src/internal/comboboxKeys.ts +90 -0
  649. package/src/internal/contentPresence.ts +46 -0
  650. package/src/internal/dayCell.ts +274 -0
  651. package/src/internal/dialogPortal.ts +50 -0
  652. package/src/internal/donutSweeps.ts +77 -0
  653. package/src/internal/enterOnViewGeometry.ts +53 -0
  654. package/src/internal/faqItem.ts +104 -0
  655. package/src/internal/floatingLabelMotion.tsx +109 -0
  656. package/src/internal/formBlockContext.ts +27 -0
  657. package/src/internal/heightRoom.ts +135 -0
  658. package/src/internal/numberSeparators.ts +93 -0
  659. package/src/internal/overlayMotion.tsx +32 -0
  660. package/src/internal/paginationItem.ts +106 -0
  661. package/src/internal/popoverSurface.ts +78 -0
  662. package/src/internal/portalContainer.ts +11 -0
  663. package/src/internal/progressBarItem.ts +356 -0
  664. package/src/internal/selectionControlText.ts +42 -0
  665. package/src/internal/statusSummaryParts.tsx +475 -0
  666. package/src/internal/summaryMotion.ts +111 -0
  667. package/src/internal/table/ChildConnector.tsx +57 -0
  668. package/src/internal/table/ChildRowPrefix.tsx +21 -0
  669. package/src/internal/table/ColumnSettings.tsx +194 -0
  670. package/src/internal/table/ScrollRegion.tsx +176 -0
  671. package/src/internal/table/TableEmpty.tsx +99 -0
  672. package/src/internal/table/TableLayout.tsx +29 -0
  673. package/src/internal/table/TableLoadStatus.tsx +60 -0
  674. package/src/internal/table/TableMobile.tsx +582 -0
  675. package/src/internal/table/TruncatedCell.tsx +35 -0
  676. package/src/internal/table/emptyValue.ts +11 -0
  677. package/src/internal/table/features.ts +44 -0
  678. package/src/internal/table/recipes.ts +263 -0
  679. package/src/internal/table/rowClick.ts +8 -0
  680. package/src/internal/table/types.ts +342 -0
  681. package/src/internal/tailwind-variants.ts +65 -0
  682. package/src/internal/tooltipContext.ts +15 -0
  683. package/src/internal/tw-merge-config.generated.ts +275 -0
  684. package/src/internal/useAnchoredPanel.ts +340 -0
  685. package/src/internal/useCountUp.ts +65 -0
  686. package/src/internal/useDateFieldTrigger.tsx +357 -0
  687. package/src/internal/useEChart.ts +88 -0
  688. package/src/internal/useEnterOnView.ts +80 -0
  689. package/src/internal/useFloatingBar.ts +125 -0
  690. package/src/internal/useFormReset.ts +47 -0
  691. package/src/internal/useIsMobile.ts +64 -0
  692. package/src/internal/useNoImplicitSubmit.ts +41 -0
  693. package/src/internal/useOneRowOverflow.ts +103 -0
  694. package/src/internal/usePrefersReducedMotion.ts +27 -0
  695. package/src/internal/useReturnFocus.ts +34 -0
  696. package/src/internal/utils.ts +58 -0
  697. package/src/recipes/EmptyState.stories.tsx +105 -0
  698. package/src/recipes/Form.stories.tsx +355 -0
  699. package/src/recipes/ModalWithForm.stories.tsx +219 -0
  700. package/src/recipes/Recipes.mdx +61 -0
  701. package/src/recipes/TableWithFilters.stories.tsx +278 -0
  702. package/src/storybook/FodsFamily.tsx +39 -0
  703. package/src/storybook/Section.tsx +36 -0
  704. package/src/storybook/a11y.ts +24 -0
  705. package/src/storybook/assets/banner-character-bartender.webp +0 -0
  706. package/src/storybook/assets/banner-invoice-sheet-left.webp +0 -0
  707. package/src/storybook/assets/banner-invoice-sheet-right.webp +0 -0
  708. package/src/storybook/assets/invoice-hero.webp +0 -0
  709. package/src/storybook/assets/invoice.webp +0 -0
  710. package/src/storybook/assets/section-document-info.svg +21 -0
  711. package/src/storybook/assets/section-gear-checklist.svg +11 -0
  712. package/src/storybook/assets/section-person-arrow-in.svg +15 -0
  713. package/src/storybook/assets/section-person-arrow-out.svg +22 -0
  714. package/src/storybook/assets/section-receipt-dollar.svg +23 -0
  715. package/src/storybook/assets/table-empty-folder-empty.png +0 -0
  716. package/src/storybook/assets/table-empty-folder-magnifying-glass.png +0 -0
  717. package/src/storybook/assets/table-empty-funnel.png +0 -0
  718. package/src/storybook/assets/table-empty-load-failed.png +0 -0
  719. package/src/storybook/assets/wallet-spot.png +0 -0
  720. package/src/storybook/assets.d.ts +17 -0
  721. package/src/storybook/componentDoc.ts +41 -0
  722. package/src/storybook/fitFrame.tsx +70 -0
  723. package/src/storybook/forceStates.tsx +647 -0
  724. package/src/storybook/illustrations.tsx +66 -0
  725. package/src/storybook/viewportFrame.tsx +58 -0
  726. package/src/styles/assets/label-brush-1.svg +6 -0
  727. package/src/styles/assets/pattern-dark.svg +113 -0
  728. package/src/styles/base.css +106 -0
  729. package/src/styles/index.css +15 -0
  730. package/src/styles/motion.css +157 -0
  731. package/src/styles/promo-sticker.css +27 -0
  732. package/src/styles/promo-surface.css +49 -0
  733. package/src/styles/shared.css +11 -0
  734. package/src/styles/theme.generated.css +314 -0
  735. package/src/styles/theme.map.json +278 -0
  736. package/src/styles/tracking.generated.css +12 -0
  737. package/src/tokens/index.ts +4 -0
  738. package/src/tokens/tokens.generated.ts +542 -0
@@ -0,0 +1,306 @@
1
+ import { Fragment } from 'react';
2
+ import type { Meta, StoryObj } from '@storybook/react-vite';
3
+ import { Checkbox } from './Checkbox';
4
+ import { Section, Showcase } from '../../storybook/Section';
5
+ import { componentDoc } from '../../storybook/componentDoc';
6
+ import { ForceStateStyles, FORCE_HOVER, FORCE_FOCUS } from '../../storybook/forceStates';
7
+
8
+ /** manifest axes.size — spec S / M, spelled sm / md in code. */
9
+ const SIZES = ['sm', 'md'] as const;
10
+
11
+ /**
12
+ * Section heading per size. Kept out of `SIZES` on purpose — that constant is the
13
+ * size axis itself and must hold nothing but axis values.
14
+ */
15
+ const SIZE_LABEL: Record<(typeof SIZES)[number], string> = {
16
+ sm: 'Size S (16 px box / 14 px glyph)',
17
+ md: 'Size M (20 px box / 14 px glyph)',
18
+ };
19
+
20
+ const SELECTIONS = [
21
+ { key: 'unchecked', label: 'Unchecked', props: {} },
22
+ { key: 'checked', label: 'Checked', props: { defaultChecked: true } },
23
+ { key: 'indeterminate', label: 'Indeterminate', props: { indeterminate: true } },
24
+ ] as const;
25
+
26
+ // `force` forces the interactive row's state statically: Hover via a scoped CSS
27
+ // helper (ForceStateStyles), Focused via storybook-addon-pseudo-states.
28
+ const STATES = [
29
+ { key: 'default', label: 'Default', props: {}, force: '' },
30
+ { key: 'hover', label: 'Hover', props: {}, force: FORCE_HOVER },
31
+ { key: 'focused', label: 'Focused', props: {}, force: FORCE_FOCUS },
32
+ { key: 'disabled', label: 'Disabled', props: { disabled: true }, force: '' },
33
+ { key: 'error', label: 'Error', props: { error: true }, force: '' },
34
+ ] as const;
35
+
36
+ // Shared grid: rows = State, columns = Selection, for a single size.
37
+ // EVERY cell of the manifest matrix is rendered, Error × Checked / Indeterminate
38
+ // included: the manifest gives both families a `--secondary-solid` fill under
39
+ // `error` too, so those cells are what document "error is a no-op once the box is
40
+ // checked". An omitted cell documents nothing and reads as a hole in the matrix.
41
+ const SelectionStateGrid = ({ size }: { size: (typeof SIZES)[number] }) => (
42
+ <div className="grid grid-cols-[8rem_repeat(3,5rem)] items-center gap-400">
43
+ <ForceStateStyles />
44
+ <span />
45
+ {SELECTIONS.map(sel => (
46
+ <span key={sel.key} className="text-body-sm text-text-secondary">
47
+ {sel.label}
48
+ </span>
49
+ ))}
50
+ {STATES.map(state => (
51
+ <Fragment key={state.key}>
52
+ <span className="text-body-sm text-text-secondary">{state.label}</span>
53
+ {SELECTIONS.map(sel => (
54
+ <span key={sel.key} className={`inline-flex ${state.force}`}>
55
+ <Checkbox
56
+ size={size}
57
+ aria-label={`${sel.label} ${state.label} ${size}`}
58
+ {...sel.props}
59
+ {...state.props}
60
+ />
61
+ </span>
62
+ ))}
63
+ </Fragment>
64
+ ))}
65
+ </div>
66
+ );
67
+
68
+ const meta = {
69
+ title: 'Design System/Atoms/Checkbox',
70
+ component: Checkbox,
71
+ parameters: {
72
+ layout: 'centered',
73
+ docs: {
74
+ description: {
75
+ component: componentDoc({
76
+ summary:
77
+ 'Native `<input type="checkbox">` styled to the ui-system spec, with an optional text label. Axes: Selection (unchecked / checked / indeterminate) × State (default / hover / disabled / error) × Size (S = 16px box, M = 20px box). Focus is an additive offset ring the component owns, not a variant.',
78
+ useCases: [
79
+ 'Boolean opt-in in forms (terms, newsletter, feature flags)',
80
+ 'Row selection in tables / lists — omit `label` for a bare control in the leading slot',
81
+ '`indeterminate` — a parent checkbox summarising a partially-selected group',
82
+ '`error` — required-but-unchecked validation (danger border + `aria-invalid`); a lone checkbox adds `errorMessage`, shown on the support line in `--status-danger`',
83
+ ],
84
+ bestPractices: [
85
+ 'Prefer the `label` prop over an external `<label>` — clicking the label toggles the box and wires `htmlFor`/`id` for you',
86
+ 'Use `indeterminate` only for a parent summarising children; it is a visual/ARIA state, not a third value',
87
+ 'A checked box is never in error — `error` styling only shows while unchecked',
88
+ 'Pass `id` when you need a stable target; otherwise one is generated via `useId`',
89
+ ],
90
+ docsLink: {
91
+ label: 'spec/03-atoms/checkbox.md',
92
+ },
93
+ }),
94
+ },
95
+ },
96
+ },
97
+ } satisfies Meta<typeof Checkbox>;
98
+
99
+ export default meta;
100
+ type Story = StoryObj<typeof meta>;
101
+
102
+ export const Playground: Story = {
103
+ args: {
104
+ label: 'Souhlasím s podmínkami',
105
+ supportText: 'Kopie odejde na adresu odběratele hned po odeslání.',
106
+ size: 'md',
107
+ indeterminate: false,
108
+ error: false,
109
+ errorMessage: 'Potvrďte souhlas s podmínkami',
110
+ disabled: false,
111
+ defaultChecked: false,
112
+ },
113
+ argTypes: {
114
+ size: { control: 'inline-radio', options: ['sm', 'md'] },
115
+ label: { control: 'text' },
116
+ supportText: { control: 'text' },
117
+ indeterminate: { control: 'boolean' },
118
+ error: { control: 'boolean' },
119
+ errorMessage: { control: 'text', if: { arg: 'error' } },
120
+ disabled: { control: 'boolean' },
121
+ checked: { control: 'boolean' },
122
+ defaultChecked: { control: 'boolean' },
123
+ },
124
+ // Error swaps the support line to `errorMessage` (manifest 1.7.0), which the
125
+ // input references via `aria-describedby` — so `aria-invalid` announces a real
126
+ // message (WCAG 3.3.1) without the story playing a host.
127
+ };
128
+
129
+ export const Variants: Story = {
130
+ parameters: {
131
+ docs: {
132
+ description: {
133
+ story:
134
+ 'Selection (columns = Unchecked / Checked / Indeterminate) × State (rows = Default / Hover / Focused / Disabled / Error) at the default `md` size. Selection drives the box fill + glyph; State drives the border / interaction treatment. Hover is forced statically (a scoped CSS helper re-declaring the peer-driven hover tokens), Focused via storybook-addon-pseudo-states. The Error × Checked / Indeterminate cells render as plain filled boxes on purpose — a checked box is never in error, so the fill overrides the danger border. See the Matrix story for the same grid in both S and M.',
135
+ },
136
+ },
137
+ },
138
+ render: () => (
139
+ <Showcase>
140
+ <SelectionStateGrid size="md" />
141
+ </Showcase>
142
+ ),
143
+ };
144
+
145
+ export const Matrix: Story = {
146
+ parameters: {
147
+ docs: {
148
+ description: {
149
+ story:
150
+ 'The whole manifest matrix — Size (box / glyph: S 16 / 14, M 20 / 14) × State (rows = Default / Hover / Focused / Disabled / Error) × Selection (columns = Unchecked / Checked / Indeterminate), mirroring the Figma labelled grid. Every cell is rendered: Hover is forced statically (a scoped CSS helper re-declaring the peer-driven hover tokens — the box is a sibling of the hidden input, so no pseudo-state addon reaches it), Focused via storybook-addon-pseudo-states. Error × Checked / Indeterminate look like plain filled boxes because that is what the manifest declares — the `--secondary-solid` fill overrides the danger border.',
151
+ },
152
+ },
153
+ },
154
+ render: () => (
155
+ <Showcase>
156
+ {SIZES.map(size => (
157
+ <Section key={size} title={SIZE_LABEL[size]} layout="column">
158
+ <SelectionStateGrid size={size} />
159
+ </Section>
160
+ ))}
161
+ </Showcase>
162
+ ),
163
+ };
164
+
165
+ export const WithLabel: Story = {
166
+ parameters: {
167
+ docs: {
168
+ description: {
169
+ story:
170
+ 'Control + label pairs at both sizes — the label is part of the clickable control, and the 32×32 hit area extends across the text. Confirms the box is vertically centred to the label baseline.',
171
+ },
172
+ },
173
+ },
174
+ render: () => (
175
+ <Showcase>
176
+ <Section title="Size S (16 px)" layout="column">
177
+ <Checkbox size="sm" label="Souhlasím s podmínkami" defaultChecked />
178
+ <Checkbox size="sm" label="Zasílat newsletter" />
179
+ </Section>
180
+ <Section title="Size M (20 px)" layout="column">
181
+ <Checkbox size="md" label="Souhlasím s podmínkami" defaultChecked />
182
+ <Checkbox size="md" label="Zasílat newsletter" />
183
+ </Section>
184
+ </Showcase>
185
+ ),
186
+ };
187
+
188
+ export const WithSupportText: Story = {
189
+ parameters: {
190
+ docs: {
191
+ description: {
192
+ story:
193
+ 'The optional second line under the label (`supportText`, manifest `Support text`). Body/XS at both sizes — only the label steps — and `--text-secondary` in every state except Disabled. The last row is the reason the control slot has a fixed height: against a wrapping label the box stays on the label\'s first line, not in the middle of the block.',
194
+ },
195
+ },
196
+ },
197
+ render: () => (
198
+ <Showcase>
199
+ <Section title="Size S (16 px)" layout="column">
200
+ <Checkbox
201
+ size="sm"
202
+ label="Zasílat kopii faktury na e-mail"
203
+ supportText="Kopie odejde na adresu odběratele hned po odeslání."
204
+ />
205
+ </Section>
206
+ <Section title="Size M (20 px)" layout="column">
207
+ <Checkbox
208
+ size="md"
209
+ label="Zasílat kopii faktury na e-mail"
210
+ supportText="Kopie odejde na adresu odběratele hned po odeslání."
211
+ defaultChecked
212
+ />
213
+ <Checkbox
214
+ size="md"
215
+ label="Zasílat kopii faktury na e-mail"
216
+ supportText="Kopie odejde na adresu odběratele hned po odeslání."
217
+ disabled
218
+ />
219
+ </Section>
220
+ <Section title="Wrapping label — the box stays on the first line" layout="column">
221
+ <div style={{ maxWidth: 280 }}>
222
+ <Checkbox
223
+ size="md"
224
+ label="Zasílat kopii každé vystavené faktury na kontaktní e-mail odběratele"
225
+ supportText="Odesílá se automaticky, bez dalšího potvrzení."
226
+ />
227
+ </div>
228
+ </Section>
229
+ </Showcase>
230
+ ),
231
+ };
232
+
233
+ export const Unchecked: Story = {
234
+ args: { label: 'Unchecked' },
235
+ };
236
+
237
+ export const Checked: Story = {
238
+ args: { label: 'Checked', defaultChecked: true },
239
+ };
240
+
241
+ export const Indeterminate: Story = {
242
+ args: { label: 'Indeterminate', indeterminate: true },
243
+ parameters: {
244
+ docs: {
245
+ description: {
246
+ story:
247
+ 'Mixed / partial state for a parent summarising a partially-selected group. Sets the DOM `indeterminate` property and `aria-checked="mixed"`.',
248
+ },
249
+ },
250
+ },
251
+ };
252
+
253
+ export const Disabled: Story = {
254
+ parameters: {
255
+ docs: {
256
+ description: {
257
+ story: 'Non-interactive across all selections — muted fill/border and `not-allowed` cursor.',
258
+ },
259
+ },
260
+ },
261
+ render: () => (
262
+ <Showcase>
263
+ <Section title="Disabled">
264
+ <Checkbox label="Unchecked" disabled />
265
+ <Checkbox label="Checked" defaultChecked disabled />
266
+ <Checkbox label="Indeterminate" indeterminate disabled />
267
+ </Section>
268
+ </Showcase>
269
+ ),
270
+ };
271
+
272
+ export const Error: Story = {
273
+ args: {
274
+ label: 'Souhlasím s podmínkami',
275
+ error: true,
276
+ errorMessage: 'Potvrďte souhlas s podmínkami',
277
+ },
278
+ parameters: {
279
+ docs: {
280
+ description: {
281
+ story:
282
+ 'Required-but-unchecked validation on a LONE checkbox — danger border + `aria-invalid`, and the support line carries `errorMessage` in `--status-danger` instead of the description (the label stays `--text-primary`). Inside a Control group pass `error` only: the group owns the message. Once checked the box leaves the error state (the fill overrides the danger border).',
283
+ },
284
+ },
285
+ },
286
+ };
287
+
288
+ export const WithoutLabel: Story = {
289
+ parameters: {
290
+ docs: {
291
+ description: {
292
+ story:
293
+ 'Bare control (no `label`) for a ListRow / table leading slot. Provide an accessible name via `aria-label` on the consumer side.',
294
+ },
295
+ },
296
+ },
297
+ render: () => (
298
+ <Showcase>
299
+ <Section title="Bare control (row selection)">
300
+ <Checkbox aria-label="Vybrat řádek" />
301
+ <Checkbox aria-label="Vybrat řádek" defaultChecked />
302
+ <Checkbox aria-label="Vybrat řádek" indeterminate />
303
+ </Section>
304
+ </Showcase>
305
+ ),
306
+ };
@@ -0,0 +1,343 @@
1
+ "use client";
2
+ import * as React from 'react';
3
+ import { tv, type VariantProps } from '../../internal/tailwind-variants';
4
+ import { Icon } from '../icon/Icon';
5
+ import { cn } from '../../internal/utils';
6
+ import { selectionControlTextWiring } from '../../internal/selectionControlText';
7
+ import { useFormReset } from '../../internal/useFormReset';
8
+
9
+ /**
10
+ * Checkbox — native `<input type="checkbox">` styled to the ui-system spec, with
11
+ * an optional text label.
12
+ *
13
+ * The visual box is a sibling `<span>` driven purely by CSS `peer-*` variants
14
+ * reading the input state, so the component works identically controlled and
15
+ * uncontrolled. Check / minus glyphs are absolutely overlaid siblings of the
16
+ * input (also peer-driven) — they must sit next to the input, not inside the
17
+ * box, for the general-sibling combinator to reach them.
18
+ *
19
+ * Axes: Selection (unchecked / checked / indeterminate) × State (default /
20
+ * hover / disabled / error) × Size (sm = 16 px box, md = 20 px box). Focus is not
21
+ * a variant — it is an additive offset ring the component owns.
22
+ *
23
+ * Hover splits into two questions the spec answers separately (`checkbox.md`
24
+ * § States): the TRIGGER is the whole hit-target — with a label that is the entire
25
+ * row, so `group-hover` off the wrapping `<label>` — while the PAINT stays on the
26
+ * control alone. The row gets no wash of its own. Where a host row owns one (a
27
+ * filter Popover row, a table row) the two compose. If such a host ever wraps this
28
+ * in its own `group`, switch both sides to a NAMED group (`group/checkbox`) so the
29
+ * ancestor cannot trigger the box by accident.
30
+ *
31
+ * `indeterminate` is a DOM-only property, so it is applied to the input via a
32
+ * ref in an effect, plus `aria-checked="mixed"` for assistive tech.
33
+ *
34
+ * `error` (required-but-unchecked) paints a danger border and sets
35
+ * `aria-invalid`. A checked (or indeterminate) box is never in error: the
36
+ * component tracks the checked state — the `checked` prop when controlled, a
37
+ * mirror of `onChange` (resynced on a native form reset) when not — and drops the
38
+ * danger border, the error line and `aria-invalid` together. `peer-checked`
39
+ * additionally neutralises the border in CSS (Tailwind emits the `peer-checked`
40
+ * variant after the base rule, so it wins over the error border).
41
+ *
42
+ * In Error the support line becomes the error line (manifest 1.7.0): it carries
43
+ * `errorMessage` in --status-danger instead of the description — never both. That
44
+ * is the LONE checkbox's error carrier. A member of a Control group passes `error`
45
+ * without `errorMessage`: the group's own error line holds the sentence, and the
46
+ * member's support line stays off in that state.
47
+ */
48
+ const checkboxVariants = tv({
49
+ slots: {
50
+ // Row wrapper: the whole control is a clickable label.
51
+ //
52
+ // Cross-axis alignment is MIN (top), not centre — manifest notes[0] is explicit:
53
+ // the label wraps (maxChars 60) and a centred control against a two-line label
54
+ // reads as broken. The box is centred on the LABEL's line instead, by the
55
+ // `control` slot below, which also keeps it on the label's line rather than the
56
+ // middle of the block once Support text is on.
57
+ root: 'group inline-flex items-start gap-400 cursor-pointer',
58
+ // The box's carrier. Manifest notes[0]: a FIXED height equal to the label's
59
+ // line-height for that size (S 22 / M 24), box centred inside it, glyph riding
60
+ // along as an absolute child. That is what puts the box's centre on the label's
61
+ // centre line. Composed from the type tokens rather than written as raw px, so
62
+ // it tracks the scale: S = --font-size-sm x --leading-loose (14 x 1.6 = 22.4),
63
+ // M = --font-size-base x --leading-relaxed (16 x 1.5 = 24) — the line-heights
64
+ // Body/S and Body/M resolve to in _text-styles.json.
65
+ //
66
+ // Consequence the manifest names: a label-less instance measures 16x22 / 20x24
67
+ // rather than 16x16 / 20x20. The extra is transparent padding and the visual box
68
+ // does not move, because a bare control sits in a CENTER-aligned parent. Do not
69
+ // "fix" the slot back to hug — top-aligning returns the 2px error.
70
+ control: 'relative inline-flex shrink-0 items-center',
71
+ // The text column: label, and the optional support line under it.
72
+ textBlock: 'flex min-w-0 flex-col gap-100',
73
+ // The visible square.
74
+ box: [
75
+ 'box-border flex items-center justify-center shrink-0',
76
+ 'rounded-200 border-100',
77
+ // Motion (manifest 1.8.1 `motion.states`): hover and toggle both move the box's
78
+ // border-color / background-color on --easing-standard — hover over
79
+ // --duration-hover, the selection flip over --duration-toggle. The property
80
+ // list is explicit rather than `transition-colors`, which would also ease
81
+ // outline-color, and the focus ring is never animated (motion-system.md).
82
+ // CSS takes the duration from the state a transition lands in, and a pointer
83
+ // flip lands in the same hovered state as a hover-in, so the two cannot be
84
+ // told apart: the pointer flip runs on --duration-hover. A keyboard flip lands
85
+ // under :focus-visible and gets --duration-toggle.
86
+ 'transition-[background-color,border-color] duration-hover ease-standard peer-focus-visible:duration-toggle',
87
+ // Unchecked default.
88
+ 'bg-background-primary border-outline-strong',
89
+ // Unchecked hover. The TRIGGER is the whole hit-target — the wrapping
90
+ // <label>, i.e. `group-hover` — not the input alone (`peer-hover`), which
91
+ // only covers the 32×32 box and left the label text as a clickable area
92
+ // with no feedback. The PAINT stays on the control: the row itself takes no
93
+ // wash (that is List Row / Action Row language). Gated on enabled, because
94
+ // a disabled control has no hover state.
95
+ 'group-hover:peer-enabled:border-secondary',
96
+ // Checked / indeterminate fill.
97
+ 'peer-checked:bg-secondary-solid peer-checked:border-transparent',
98
+ 'peer-indeterminate:bg-secondary-solid peer-indeterminate:border-transparent',
99
+ // Checked / indeterminate hover — same trigger, same enabled gate.
100
+ 'group-hover:peer-enabled:peer-checked:bg-secondary-hover',
101
+ 'group-hover:peer-enabled:peer-indeterminate:bg-secondary-hover',
102
+ // Focus ring (additive offset ring the component owns).
103
+ 'peer-focus-visible:ring-200 peer-focus-visible:ring-outline-focus',
104
+ 'peer-focus-visible:ring-offset-2 peer-focus-visible:ring-offset-background-primary',
105
+ // Disabled.
106
+ 'peer-disabled:bg-disabled-control peer-disabled:border-outline-default',
107
+ ],
108
+ // Absolutely centred glyph overlays; visibility is peer-driven.
109
+ glyph: [
110
+ 'pointer-events-none absolute inset-0 flex items-center justify-center',
111
+ 'text-secondary-foreground peer-disabled:text-disabled-foreground',
112
+ ],
113
+ // Label text next to the control.
114
+ labelText: 'text-text-primary',
115
+ // Support text — the optional description line under the label. Body/XS in BOTH
116
+ // sizes (manifest typography.runs.support-text: only the LABEL steps). In Error
117
+ // the same line carries the error message in --status-danger (the `error`
118
+ // variant below; manifest parts.support-text).
119
+ // No leading spelled out: `text-body-xs` carries the Body/XS run's own
120
+ // --leading-loose (20.8px).
121
+ supportText: 'text-body-xs text-text-secondary',
122
+ },
123
+ variants: {
124
+ size: {
125
+ sm: {
126
+ box: 'size-600',
127
+ // `text-body-sm` carries Body/S's --leading-loose, so the label is 22.4px
128
+ // without spelling it out. `control` below still computes
129
+ // the same product explicitly — it has to align the box to the first line,
130
+ // and a height cannot be derived from a font-size utility.
131
+ labelText: 'text-body-sm',
132
+ control: 'h-[calc(var(--font-size-sm)*var(--leading-loose))]',
133
+ },
134
+ md: {
135
+ box: 'size-700',
136
+ labelText: 'text-body-base',
137
+ control: 'h-[calc(var(--font-size-base)*var(--leading-relaxed))]',
138
+ },
139
+ },
140
+ disabled: {
141
+ true: {
142
+ root: 'cursor-not-allowed',
143
+ // Plain, not `peer-disabled:` — labelText sits inside textBlock, which is a
144
+ // sibling of `control`, not of the input, so the peer selector never matches.
145
+ labelText: 'text-disabled-foreground',
146
+ supportText: 'text-disabled-foreground',
147
+ },
148
+ false: {},
149
+ },
150
+ error: {
151
+ // Fed the derived in-error state (`error` on an unchecked, determinate box),
152
+ // not the raw prop; `peer-checked:border-transparent` in the base backs it up.
153
+ // The label keeps --text-primary in Error; only the support line turns danger.
154
+ true: { box: 'border-status-danger', supportText: 'text-status-danger' },
155
+ false: {},
156
+ },
157
+ },
158
+ defaultVariants: {
159
+ size: 'md',
160
+ disabled: false,
161
+ error: false,
162
+ },
163
+ });
164
+
165
+ export interface CheckboxProps
166
+ extends Omit<React.InputHTMLAttributes<HTMLInputElement>, 'size' | 'type'>,
167
+ Pick<VariantProps<typeof checkboxVariants>, 'size'> {
168
+ /** Box size: `sm` = 16px, `md` = 20px (default, per manifest Size = M). */
169
+ size?: 'sm' | 'md';
170
+ /** Optional text label; when omitted the control renders bare (e.g. a ListRow leading slot). */
171
+ label?: string;
172
+ /**
173
+ * Optional description line under the label (manifest `Support text`, off by
174
+ * default). Genuinely supplementary — a checkbox label that needs a paragraph is
175
+ * usually a label that needs rewriting. Replaced by `errorMessage` in Error (and
176
+ * hidden there when no message is given). Inert without `label`.
177
+ */
178
+ supportText?: string;
179
+ /** Mixed / partial selection — sets the DOM `indeterminate` property + `aria-checked="mixed"`. */
180
+ indeterminate?: boolean;
181
+ /** Required-but-unchecked — danger border + `aria-invalid`. A checked box is never in error. */
182
+ error?: boolean;
183
+ /**
184
+ * The error sentence of a LONE checkbox ("Potvrďte souhlas s podmínkami"), shown
185
+ * on the support line in --status-danger while `error` is set, referenced by
186
+ * `aria-describedby`. Leave it out for a member of a Control group — the group's
187
+ * error line carries the message there. Inert without `label` or `error`.
188
+ */
189
+ errorMessage?: string;
190
+ }
191
+
192
+ const Checkbox = React.forwardRef<HTMLInputElement, CheckboxProps>(
193
+ (
194
+ {
195
+ className,
196
+ size = 'md',
197
+ label,
198
+ supportText,
199
+ indeterminate = false,
200
+ error = false,
201
+ errorMessage,
202
+ id,
203
+ disabled = false,
204
+ checked,
205
+ defaultChecked,
206
+ onChange,
207
+ 'aria-describedby': consumerDescribedBy,
208
+ ...props
209
+ },
210
+ ref,
211
+ ) => {
212
+ const generatedId = React.useId();
213
+ const inputId = id ?? generatedId;
214
+
215
+ // Keep an internal ref so we can drive the DOM-only `indeterminate` property,
216
+ // while still forwarding the node to the consumer.
217
+ const innerRef = React.useRef<HTMLInputElement>(null);
218
+ React.useImperativeHandle(ref, () => innerRef.current as HTMLInputElement, []);
219
+
220
+ // Uncontrolled checked state is mirrored so Error can clear once the box is
221
+ // ticked; a native form reset restores `checked` without a change event.
222
+ const isControlled = checked !== undefined;
223
+ const [uncontrolledChecked, setUncontrolledChecked] = React.useState(Boolean(defaultChecked));
224
+ useFormReset(innerRef, element => setUncontrolledChecked(element.checked), props.form);
225
+ const isChecked = isControlled ? Boolean(checked) : uncontrolledChecked;
226
+ const inError = error && !isChecked && !indeterminate;
227
+
228
+ // One line, two roles: the description at rest, the error message in Error.
229
+ const supportLine = inError ? errorMessage : supportText;
230
+ const {
231
+ labelTextId,
232
+ supportTextId,
233
+ 'aria-labelledby': ariaLabelledBy,
234
+ 'aria-describedby': ownDescribedBy,
235
+ } = selectionControlTextWiring(inputId, label, supportLine);
236
+ const ariaDescribedBy = [ownDescribedBy, consumerDescribedBy].filter(Boolean).join(' ') || undefined;
237
+ // Sync the DOM-only `indeterminate` property on mount and whenever the prop
238
+ // changes via a render (controlled / programmatic updates). The click case —
239
+ // where the browser clears it synchronously without a re-render — is handled
240
+ // in `handleChange` below.
241
+ React.useLayoutEffect(() => {
242
+ if (innerRef.current) {
243
+ innerRef.current.indeterminate = indeterminate;
244
+ }
245
+ });
246
+
247
+ // The browser clears the DOM-only `indeterminate` property during activation.
248
+ // Re-apply it from the prop in the change handler (fires after activation), so
249
+ // a static `indeterminate` box keeps its mixed glyph even without a re-render.
250
+ const handleChange = (event: React.ChangeEvent<HTMLInputElement>) => {
251
+ if (innerRef.current) {
252
+ innerRef.current.indeterminate = indeterminate;
253
+ }
254
+ if (!isControlled) {
255
+ setUncontrolledChecked(event.target.checked);
256
+ }
257
+ onChange?.(event);
258
+ };
259
+
260
+ const {
261
+ root,
262
+ control,
263
+ box,
264
+ glyph,
265
+ labelText,
266
+ textBlock,
267
+ supportText: supportTextClass,
268
+ } = checkboxVariants({
269
+ size,
270
+ disabled,
271
+ error: inError,
272
+ });
273
+
274
+ return (
275
+ // data-fods-part marks the parts the FODS verifier measures in the browser
276
+ // (the checkbox parts map). Not inert in this package: `styles/base.css` scopes its reset to these attributes.
277
+ <label
278
+ htmlFor={inputId}
279
+ data-fods-component="checkbox"
280
+ data-fods-part="root"
281
+ className={cn(root(), className)}
282
+ >
283
+ <span className={control()}>
284
+ <input
285
+ ref={innerRef}
286
+ id={inputId}
287
+ type="checkbox"
288
+ disabled={disabled}
289
+ checked={checked}
290
+ defaultChecked={defaultChecked}
291
+ aria-checked={indeterminate ? 'mixed' : undefined}
292
+ aria-invalid={inError || undefined}
293
+ aria-labelledby={ariaLabelledBy}
294
+ aria-describedby={ariaDescribedBy}
295
+ onChange={handleChange}
296
+ // Enlarged, centred hit area: the input is 32×32px regardless of the
297
+ // 16/20 px visual box, so a bare control (no label) still meets the
298
+ // selection-control minimum tap target. `absolute` keeps the overlap
299
+ // out of layout — the box and label spacing are unaffected.
300
+ className="peer absolute left-1/2 top-1/2 size-900 -translate-x-1/2 -translate-y-1/2 opacity-0 outline-none cursor-pointer disabled:cursor-not-allowed"
301
+ {...props}
302
+ />
303
+ {/*
304
+ One element renders all three selection families: `box-checked` and
305
+ `box-indeterminate` are this same span under `peer-checked:` /
306
+ `peer-indeterminate:`, so they cannot carry an attribute of their own —
307
+ see the note in checkbox.parts.json.
308
+ */}
309
+ <span data-fods-part="box" className={box()} aria-hidden />
310
+ {/*
311
+ Check glyph — visible only when checked (indeterminate takes over).
312
+ manifest sizes[].icon: check and minus are --size-icon-2xsmall in both sizes.
313
+ */}
314
+ <span
315
+ data-fods-part="glyph"
316
+ className={cn(glyph(), 'hidden peer-checked:flex peer-indeterminate:hidden')}
317
+ >
318
+ <Icon name="check" size="2xsmall" />
319
+ </span>
320
+ {/* Minus glyph — visible only when indeterminate. */}
321
+ <span data-fods-part="glyph" className={cn(glyph(), 'hidden peer-indeterminate:flex')}>
322
+ <Icon name="minus" size="2xsmall" />
323
+ </span>
324
+ </span>
325
+ {label && (
326
+ <span className={textBlock()}>
327
+ <span id={labelTextId} data-fods-part="label" className={labelText()}>
328
+ {label}
329
+ </span>
330
+ {supportLine && (
331
+ <span id={supportTextId} data-fods-part="support-text" className={supportTextClass()}>
332
+ {supportLine}
333
+ </span>
334
+ )}
335
+ </span>
336
+ )}
337
+ </label>
338
+ );
339
+ },
340
+ );
341
+ Checkbox.displayName = 'Checkbox';
342
+
343
+ export { Checkbox, checkboxVariants };
@@ -0,0 +1 @@
1
+ export { Checkbox, checkboxVariants, type CheckboxProps } from './Checkbox';