@invoiceonline/ui-react 0.0.0 → 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (738) hide show
  1. package/AGENTS.md +99 -0
  2. package/CHANGELOG.md +131 -0
  3. package/LICENSE +9 -0
  4. package/README.md +77 -1
  5. package/dist/assets/label-brush-1.svg +6 -0
  6. package/dist/assets/pattern-dark.svg +113 -0
  7. package/dist/components/action-row/ActionRow.d.ts +178 -0
  8. package/dist/components/action-row/ActionRow.js +340 -0
  9. package/dist/components/action-row/index.d.ts +2 -0
  10. package/dist/components/action-row/index.js +1 -0
  11. package/dist/components/alert/Alert.d.ts +314 -0
  12. package/dist/components/alert/Alert.js +446 -0
  13. package/dist/components/alert/index.d.ts +2 -0
  14. package/dist/components/alert/index.js +1 -0
  15. package/dist/components/anchored-panel/AnchoredPanel.d.ts +41 -0
  16. package/dist/components/anchored-panel/AnchoredPanel.js +72 -0
  17. package/dist/components/anchored-panel/index.d.ts +3 -0
  18. package/dist/components/anchored-panel/index.js +3 -0
  19. package/dist/components/badge/Badge.d.ts +146 -0
  20. package/dist/components/badge/Badge.js +258 -0
  21. package/dist/components/badge/index.d.ts +2 -0
  22. package/dist/components/badge/index.js +1 -0
  23. package/dist/components/banner/Banner.d.ts +209 -0
  24. package/dist/components/banner/Banner.js +339 -0
  25. package/dist/components/banner/index.d.ts +2 -0
  26. package/dist/components/banner/index.js +1 -0
  27. package/dist/components/button/Button.d.ts +54 -0
  28. package/dist/components/button/Button.js +312 -0
  29. package/dist/components/button/index.d.ts +2 -0
  30. package/dist/components/button/index.js +1 -0
  31. package/dist/components/button-group/ButtonGroup.d.ts +187 -0
  32. package/dist/components/button-group/ButtonGroup.js +217 -0
  33. package/dist/components/button-group/index.d.ts +2 -0
  34. package/dist/components/button-group/index.js +1 -0
  35. package/dist/components/card-select/CardSelect.d.ts +274 -0
  36. package/dist/components/card-select/CardSelect.js +561 -0
  37. package/dist/components/card-select/CardSelectGroup.d.ts +92 -0
  38. package/dist/components/card-select/CardSelectGroup.js +72 -0
  39. package/dist/components/card-select/index.d.ts +3 -0
  40. package/dist/components/card-select/index.js +3 -0
  41. package/dist/components/checkbox/Checkbox.d.ts +104 -0
  42. package/dist/components/checkbox/Checkbox.js +194 -0
  43. package/dist/components/checkbox/index.d.ts +2 -0
  44. package/dist/components/checkbox/index.js +1 -0
  45. package/dist/components/chip/Chip.d.ts +250 -0
  46. package/dist/components/chip/Chip.js +441 -0
  47. package/dist/components/chip/index.d.ts +2 -0
  48. package/dist/components/chip/index.js +1 -0
  49. package/dist/components/column-header/ColumnHeader.d.ts +144 -0
  50. package/dist/components/column-header/ColumnHeader.js +209 -0
  51. package/dist/components/column-header/index.d.ts +2 -0
  52. package/dist/components/column-header/index.js +1 -0
  53. package/dist/components/combobox-field/Combobox.d.ts +104 -0
  54. package/dist/components/combobox-field/Combobox.js +355 -0
  55. package/dist/components/combobox-field/ComboboxField.d.ts +76 -0
  56. package/dist/components/combobox-field/ComboboxField.js +98 -0
  57. package/dist/components/combobox-field/index.d.ts +3 -0
  58. package/dist/components/combobox-field/index.js +3 -0
  59. package/dist/components/date-field/DateField.d.ts +52 -0
  60. package/dist/components/date-field/DateField.js +45 -0
  61. package/dist/components/date-field/index.d.ts +2 -0
  62. package/dist/components/date-field/index.js +1 -0
  63. package/dist/components/date-picker/DatePicker.d.ts +53 -0
  64. package/dist/components/date-picker/DatePicker.js +329 -0
  65. package/dist/components/date-picker/index.d.ts +2 -0
  66. package/dist/components/date-picker/index.js +1 -0
  67. package/dist/components/divider/Divider.d.ts +81 -0
  68. package/dist/components/divider/Divider.js +93 -0
  69. package/dist/components/divider/index.d.ts +2 -0
  70. package/dist/components/divider/index.js +1 -0
  71. package/dist/components/drawer/Drawer.d.ts +128 -0
  72. package/dist/components/drawer/Drawer.js +367 -0
  73. package/dist/components/drawer/index.d.ts +2 -0
  74. package/dist/components/drawer/index.js +1 -0
  75. package/dist/components/dropdown-button/DropdownButton.d.ts +72 -0
  76. package/dist/components/dropdown-button/DropdownButton.js +122 -0
  77. package/dist/components/dropdown-button/index.d.ts +2 -0
  78. package/dist/components/dropdown-button/index.js +1 -0
  79. package/dist/components/faq/FAQ.d.ts +135 -0
  80. package/dist/components/faq/FAQ.js +258 -0
  81. package/dist/components/faq/index.d.ts +2 -0
  82. package/dist/components/faq/index.js +1 -0
  83. package/dist/components/field/Field.d.ts +118 -0
  84. package/dist/components/field/Field.js +327 -0
  85. package/dist/components/field/index.d.ts +2 -0
  86. package/dist/components/field/index.js +1 -0
  87. package/dist/components/field-pair/FieldPair.d.ts +194 -0
  88. package/dist/components/field-pair/FieldPair.js +321 -0
  89. package/dist/components/field-pair/index.d.ts +2 -0
  90. package/dist/components/field-pair/index.js +1 -0
  91. package/dist/components/file-upload/FileUpload.d.ts +137 -0
  92. package/dist/components/file-upload/FileUpload.js +434 -0
  93. package/dist/components/file-upload/index.d.ts +2 -0
  94. package/dist/components/file-upload/index.js +1 -0
  95. package/dist/components/filter-chip/FilterChip.d.ts +373 -0
  96. package/dist/components/filter-chip/FilterChip.js +517 -0
  97. package/dist/components/filter-chip/index.d.ts +2 -0
  98. package/dist/components/filter-chip/index.js +1 -0
  99. package/dist/components/filter-facet/FilterFacet.d.ts +116 -0
  100. package/dist/components/filter-facet/FilterFacet.js +632 -0
  101. package/dist/components/filter-facet/index.d.ts +2 -0
  102. package/dist/components/filter-facet/index.js +1 -0
  103. package/dist/components/firm-avatar/FirmAvatar.d.ts +75 -0
  104. package/dist/components/firm-avatar/FirmAvatar.js +119 -0
  105. package/dist/components/firm-avatar/index.d.ts +2 -0
  106. package/dist/components/firm-avatar/index.js +1 -0
  107. package/dist/components/form-actions/FormActions.d.ts +123 -0
  108. package/dist/components/form-actions/FormActions.js +195 -0
  109. package/dist/components/form-actions/index.d.ts +2 -0
  110. package/dist/components/form-actions/index.js +1 -0
  111. package/dist/components/form-block/FormBlock.d.ts +252 -0
  112. package/dist/components/form-block/FormBlock.js +420 -0
  113. package/dist/components/form-block/index.d.ts +3 -0
  114. package/dist/components/form-block/index.js +3 -0
  115. package/dist/components/form-section/FormSection.d.ts +130 -0
  116. package/dist/components/form-section/FormSection.js +206 -0
  117. package/dist/components/form-section/index.d.ts +2 -0
  118. package/dist/components/form-section/index.js +1 -0
  119. package/dist/components/heading/Heading.d.ts +69 -0
  120. package/dist/components/heading/Heading.js +79 -0
  121. package/dist/components/heading/index.d.ts +2 -0
  122. package/dist/components/heading/index.js +1 -0
  123. package/dist/components/heading-group/HeadingGroup.d.ts +258 -0
  124. package/dist/components/heading-group/HeadingGroup.js +255 -0
  125. package/dist/components/heading-group/index.d.ts +2 -0
  126. package/dist/components/heading-group/index.js +1 -0
  127. package/dist/components/hero/Hero.d.ts +268 -0
  128. package/dist/components/hero/Hero.js +316 -0
  129. package/dist/components/hero/index.d.ts +2 -0
  130. package/dist/components/hero/index.js +1 -0
  131. package/dist/components/icon/Icon.d.ts +27 -0
  132. package/dist/components/icon/Icon.js +30 -0
  133. package/dist/components/icon/index.d.ts +3 -0
  134. package/dist/components/icon/index.js +3 -0
  135. package/dist/components/icon-button/IconButton.d.ts +75 -0
  136. package/dist/components/icon-button/IconButton.js +151 -0
  137. package/dist/components/icon-button/index.d.ts +2 -0
  138. package/dist/components/icon-button/index.js +1 -0
  139. package/dist/components/item-row/ItemRow.d.ts +253 -0
  140. package/dist/components/item-row/ItemRow.js +496 -0
  141. package/dist/components/item-row/index.d.ts +2 -0
  142. package/dist/components/item-row/index.js +1 -0
  143. package/dist/components/list-row/ListRow.d.ts +165 -0
  144. package/dist/components/list-row/ListRow.js +233 -0
  145. package/dist/components/list-row/index.d.ts +2 -0
  146. package/dist/components/list-row/index.js +1 -0
  147. package/dist/components/menu/Menu.d.ts +64 -0
  148. package/dist/components/menu/Menu.js +186 -0
  149. package/dist/components/menu/index.d.ts +2 -0
  150. package/dist/components/menu/index.js +1 -0
  151. package/dist/components/modal/Modal.d.ts +272 -0
  152. package/dist/components/modal/Modal.js +788 -0
  153. package/dist/components/modal/index.d.ts +2 -0
  154. package/dist/components/modal/index.js +1 -0
  155. package/dist/components/nav-link/NavLink.d.ts +123 -0
  156. package/dist/components/nav-link/NavLink.js +157 -0
  157. package/dist/components/nav-link/index.d.ts +2 -0
  158. package/dist/components/nav-link/index.js +1 -0
  159. package/dist/components/number-field/NumberField.d.ts +62 -0
  160. package/dist/components/number-field/NumberField.js +210 -0
  161. package/dist/components/number-field/index.d.ts +2 -0
  162. package/dist/components/number-field/index.js +1 -0
  163. package/dist/components/pagination/Pagination.d.ts +133 -0
  164. package/dist/components/pagination/Pagination.js +217 -0
  165. package/dist/components/pagination/index.d.ts +3 -0
  166. package/dist/components/pagination/index.js +3 -0
  167. package/dist/components/popover-surface/index.d.ts +2 -0
  168. package/dist/components/popover-surface/index.js +1 -0
  169. package/dist/components/progress-bar/ProgressBar.d.ts +260 -0
  170. package/dist/components/progress-bar/ProgressBar.js +470 -0
  171. package/dist/components/progress-bar/index.d.ts +2 -0
  172. package/dist/components/progress-bar/index.js +1 -0
  173. package/dist/components/promo-sticker/PromoSticker.d.ts +204 -0
  174. package/dist/components/promo-sticker/PromoSticker.js +177 -0
  175. package/dist/components/promo-sticker/index.d.ts +2 -0
  176. package/dist/components/promo-sticker/index.js +1 -0
  177. package/dist/components/promo-surface/PromoSurface.d.ts +94 -0
  178. package/dist/components/promo-surface/PromoSurface.js +119 -0
  179. package/dist/components/promo-surface/index.d.ts +2 -0
  180. package/dist/components/promo-surface/index.js +1 -0
  181. package/dist/components/radio/Radio.d.ts +92 -0
  182. package/dist/components/radio/Radio.js +171 -0
  183. package/dist/components/radio/index.d.ts +2 -0
  184. package/dist/components/radio/index.js +1 -0
  185. package/dist/components/radio-group/RadioGroup.d.ts +61 -0
  186. package/dist/components/radio-group/RadioGroup.js +51 -0
  187. package/dist/components/radio-group/index.d.ts +2 -0
  188. package/dist/components/radio-group/index.js +1 -0
  189. package/dist/components/select/Select.d.ts +65 -0
  190. package/dist/components/select/Select.js +176 -0
  191. package/dist/components/select/index.d.ts +2 -0
  192. package/dist/components/select/index.js +1 -0
  193. package/dist/components/select-field/SelectField.d.ts +16 -0
  194. package/dist/components/select-field/SelectField.js +55 -0
  195. package/dist/components/select-field/index.d.ts +2 -0
  196. package/dist/components/select-field/index.js +1 -0
  197. package/dist/components/skeleton/Skeleton.d.ts +64 -0
  198. package/dist/components/skeleton/Skeleton.js +65 -0
  199. package/dist/components/skeleton/index.d.ts +2 -0
  200. package/dist/components/skeleton/index.js +1 -0
  201. package/dist/components/split-button/SplitButton.d.ts +80 -0
  202. package/dist/components/split-button/SplitButton.js +182 -0
  203. package/dist/components/split-button/index.d.ts +2 -0
  204. package/dist/components/split-button/index.js +1 -0
  205. package/dist/components/status-summary-bar/StatusSummaryBar.d.ts +118 -0
  206. package/dist/components/status-summary-bar/StatusSummaryBar.js +278 -0
  207. package/dist/components/status-summary-bar/index.d.ts +2 -0
  208. package/dist/components/status-summary-bar/index.js +1 -0
  209. package/dist/components/subject-lookup-field/SubjectLookupField.d.ts +157 -0
  210. package/dist/components/subject-lookup-field/SubjectLookupField.js +663 -0
  211. package/dist/components/subject-lookup-field/index.d.ts +2 -0
  212. package/dist/components/subject-lookup-field/index.js +1 -0
  213. package/dist/components/switch/Switch.d.ts +152 -0
  214. package/dist/components/switch/Switch.js +307 -0
  215. package/dist/components/switch/index.d.ts +2 -0
  216. package/dist/components/switch/index.js +1 -0
  217. package/dist/components/table/Table.d.ts +5 -0
  218. package/dist/components/table/Table.js +601 -0
  219. package/dist/components/table/index.d.ts +6 -0
  220. package/dist/components/table/index.js +6 -0
  221. package/dist/components/text-field/TextField.d.ts +65 -0
  222. package/dist/components/text-field/TextField.js +173 -0
  223. package/dist/components/text-field/index.d.ts +2 -0
  224. package/dist/components/text-field/index.js +1 -0
  225. package/dist/components/text-link/TextLink.d.ts +260 -0
  226. package/dist/components/text-link/TextLink.js +303 -0
  227. package/dist/components/text-link/index.d.ts +2 -0
  228. package/dist/components/text-link/index.js +1 -0
  229. package/dist/components/textarea/Textarea.d.ts +93 -0
  230. package/dist/components/textarea/Textarea.js +256 -0
  231. package/dist/components/textarea/index.d.ts +2 -0
  232. package/dist/components/textarea/index.js +1 -0
  233. package/dist/components/tooltip/Tooltip.d.ts +129 -0
  234. package/dist/components/tooltip/Tooltip.js +457 -0
  235. package/dist/components/tooltip/index.d.ts +2 -0
  236. package/dist/components/tooltip/index.js +1 -0
  237. package/dist/components/unit-field/UnitField.d.ts +46 -0
  238. package/dist/components/unit-field/UnitField.js +133 -0
  239. package/dist/components/unit-field/index.d.ts +2 -0
  240. package/dist/components/unit-field/index.js +1 -0
  241. package/dist/icons/icon-registry.generated.js +500 -0
  242. package/dist/icons/icon-types.generated.d.ts +2 -0
  243. package/dist/icons/icon-types.generated.js +126 -0
  244. package/dist/index.d.ts +132 -0
  245. package/dist/index.js +75 -0
  246. package/dist/internal/BottomSheet.js +496 -0
  247. package/dist/internal/FodsProvider.d.ts +25 -0
  248. package/dist/internal/FodsProvider.js +32 -0
  249. package/dist/internal/MotionCaret.js +35 -0
  250. package/dist/internal/NumberFormatInput.d.ts +21 -0
  251. package/dist/internal/NumberFormatInput.js +126 -0
  252. package/dist/internal/SummaryDonut.d.ts +3 -0
  253. package/dist/internal/SummaryDonut.js +300 -0
  254. package/dist/internal/buttonSegment.d.ts +44 -0
  255. package/dist/internal/buttonSegment.js +126 -0
  256. package/dist/internal/collapseRoom.js +128 -0
  257. package/dist/internal/comboboxKeys.js +44 -0
  258. package/dist/internal/contentPresence.js +46 -0
  259. package/dist/internal/dayCell.js +95 -0
  260. package/dist/internal/dialogPortal.d.ts +2 -0
  261. package/dist/internal/dialogPortal.js +21 -0
  262. package/dist/internal/donutSweeps.js +65 -0
  263. package/dist/internal/enterOnViewGeometry.js +46 -0
  264. package/dist/internal/faqItem.js +80 -0
  265. package/dist/internal/floatingLabelMotion.js +68 -0
  266. package/dist/internal/formBlockContext.d.ts +22 -0
  267. package/dist/internal/formBlockContext.js +20 -0
  268. package/dist/internal/heightRoom.js +87 -0
  269. package/dist/internal/numberSeparators.js +62 -0
  270. package/dist/internal/overlayMotion.js +48 -0
  271. package/dist/internal/paginationItem.d.ts +8 -0
  272. package/dist/internal/paginationItem.js +22 -0
  273. package/dist/internal/popoverSurface.d.ts +8 -0
  274. package/dist/internal/popoverSurface.js +23 -0
  275. package/dist/internal/portalContainer.d.ts +1 -0
  276. package/dist/internal/portalContainer.js +6 -0
  277. package/dist/internal/progressBarItem.d.ts +207 -0
  278. package/dist/internal/progressBarItem.js +264 -0
  279. package/dist/internal/selectionControlText.js +12 -0
  280. package/dist/internal/statusSummaryParts.js +371 -0
  281. package/dist/internal/summaryMotion.js +75 -0
  282. package/dist/internal/table/ChildConnector.js +62 -0
  283. package/dist/internal/table/ChildRowPrefix.d.ts +9 -0
  284. package/dist/internal/table/ChildRowPrefix.js +27 -0
  285. package/dist/internal/table/ColumnSettings.js +135 -0
  286. package/dist/internal/table/ScrollRegion.js +114 -0
  287. package/dist/internal/table/TableEmpty.js +93 -0
  288. package/dist/internal/table/TableLayout.d.ts +17 -0
  289. package/dist/internal/table/TableLayout.js +29 -0
  290. package/dist/internal/table/TableLoadStatus.js +56 -0
  291. package/dist/internal/table/TableMobile.js +488 -0
  292. package/dist/internal/table/TruncatedCell.js +33 -0
  293. package/dist/internal/table/emptyValue.js +10 -0
  294. package/dist/internal/table/features.d.ts +41 -0
  295. package/dist/internal/table/features.js +31 -0
  296. package/dist/internal/table/recipes.js +227 -0
  297. package/dist/internal/table/rowClick.js +9 -0
  298. package/dist/internal/table/types.d.ts +325 -0
  299. package/dist/internal/table/types.js +13 -0
  300. package/dist/internal/tailwind-variants.d.ts +3 -0
  301. package/dist/internal/tailwind-variants.js +37 -0
  302. package/dist/internal/tooltipContext.js +5 -0
  303. package/dist/internal/tw-merge-config.generated.js +314 -0
  304. package/dist/internal/useAnchoredPanel.d.ts +87 -0
  305. package/dist/internal/useAnchoredPanel.js +108 -0
  306. package/dist/internal/useCountUp.js +53 -0
  307. package/dist/internal/useDateFieldTrigger.js +183 -0
  308. package/dist/internal/useEChart.js +59 -0
  309. package/dist/internal/useEnterOnView.js +42 -0
  310. package/dist/internal/useFloatingBar.js +100 -0
  311. package/dist/internal/useFormReset.js +37 -0
  312. package/dist/internal/useIsMobile.js +44 -0
  313. package/dist/internal/useOneRowOverflow.js +88 -0
  314. package/dist/internal/usePrefersReducedMotion.js +25 -0
  315. package/dist/internal/useReturnFocus.js +26 -0
  316. package/dist/internal/utils.d.ts +7 -0
  317. package/dist/internal/utils.js +58 -0
  318. package/dist/node_modules/@tanstack/store/dist/store.d.ts +29 -0
  319. package/dist/node_modules/@tanstack/store/dist/types.d.ts +38 -0
  320. package/dist/node_modules/@tanstack/table-core/dist/core/cells/coreCellsFeature.d.ts +6 -0
  321. package/dist/node_modules/@tanstack/table-core/dist/core/cells/coreCellsFeature.types.d.ts +53 -0
  322. package/dist/node_modules/@tanstack/table-core/dist/core/columns/coreColumnsFeature.d.ts +6 -0
  323. package/dist/node_modules/@tanstack/table-core/dist/core/columns/coreColumnsFeature.types.d.ts +90 -0
  324. package/dist/node_modules/@tanstack/table-core/dist/core/coreFeatures.d.ts +17 -0
  325. package/dist/node_modules/@tanstack/table-core/dist/core/headers/coreHeadersFeature.d.ts +6 -0
  326. package/dist/node_modules/@tanstack/table-core/dist/core/headers/coreHeadersFeature.types.d.ts +114 -0
  327. package/dist/node_modules/@tanstack/table-core/dist/core/reactivity/coreReactivityFeature.types.d.ts +51 -0
  328. package/dist/node_modules/@tanstack/table-core/dist/core/row-models/coreRowModelsFeature.d.ts +6 -0
  329. package/dist/node_modules/@tanstack/table-core/dist/core/row-models/coreRowModelsFeature.types.d.ts +29 -0
  330. package/dist/node_modules/@tanstack/table-core/dist/core/rows/coreRowsFeature.d.ts +6 -0
  331. package/dist/node_modules/@tanstack/table-core/dist/core/rows/coreRowsFeature.types.d.ts +129 -0
  332. package/dist/node_modules/@tanstack/table-core/dist/core/table/coreTablesFeature.d.ts +6 -0
  333. package/dist/node_modules/@tanstack/table-core/dist/core/table/coreTablesFeature.types.d.ts +203 -0
  334. package/dist/node_modules/@tanstack/table-core/dist/features/cell-selection/cellSelectionFeature.d.ts +6 -0
  335. package/dist/node_modules/@tanstack/table-core/dist/features/cell-selection/cellSelectionFeature.types.d.ts +294 -0
  336. package/dist/node_modules/@tanstack/table-core/dist/features/cell-spanning/cellSpanningFeature.d.ts +11 -0
  337. package/dist/node_modules/@tanstack/table-core/dist/features/cell-spanning/cellSpanningFeature.types.d.ts +148 -0
  338. package/dist/node_modules/@tanstack/table-core/dist/features/column-faceting/columnFacetingFeature.d.ts +12 -0
  339. package/dist/node_modules/@tanstack/table-core/dist/features/column-faceting/columnFacetingFeature.types.d.ts +63 -0
  340. package/dist/node_modules/@tanstack/table-core/dist/features/column-filtering/columnFilteringFeature.d.ts +6 -0
  341. package/dist/node_modules/@tanstack/table-core/dist/features/column-filtering/columnFilteringFeature.types.d.ts +209 -0
  342. package/dist/node_modules/@tanstack/table-core/dist/features/column-filtering/filterFns.d.ts +35 -0
  343. package/dist/node_modules/@tanstack/table-core/dist/features/column-grouping/columnGroupingFeature.d.ts +6 -0
  344. package/dist/node_modules/@tanstack/table-core/dist/features/column-grouping/columnGroupingFeature.types.d.ts +128 -0
  345. package/dist/node_modules/@tanstack/table-core/dist/features/column-ordering/columnOrderingFeature.d.ts +6 -0
  346. package/dist/node_modules/@tanstack/table-core/dist/features/column-ordering/columnOrderingFeature.types.d.ts +82 -0
  347. package/dist/node_modules/@tanstack/table-core/dist/features/column-pinning/columnPinningFeature.d.ts +11 -0
  348. package/dist/node_modules/@tanstack/table-core/dist/features/column-pinning/columnPinningFeature.types.d.ts +195 -0
  349. package/dist/node_modules/@tanstack/table-core/dist/features/column-resizing/columnResizingFeature.d.ts +6 -0
  350. package/dist/node_modules/@tanstack/table-core/dist/features/column-resizing/columnResizingFeature.types.d.ts +73 -0
  351. package/dist/node_modules/@tanstack/table-core/dist/features/column-sizing/columnSizingFeature.d.ts +6 -0
  352. package/dist/node_modules/@tanstack/table-core/dist/features/column-sizing/columnSizingFeature.types.d.ts +134 -0
  353. package/dist/node_modules/@tanstack/table-core/dist/features/column-visibility/columnVisibilityFeature.d.ts +6 -0
  354. package/dist/node_modules/@tanstack/table-core/dist/features/column-visibility/columnVisibilityFeature.types.d.ts +92 -0
  355. package/dist/node_modules/@tanstack/table-core/dist/features/global-filtering/globalFilteringFeature.d.ts +6 -0
  356. package/dist/node_modules/@tanstack/table-core/dist/features/global-filtering/globalFilteringFeature.types.d.ts +67 -0
  357. package/dist/node_modules/@tanstack/table-core/dist/features/row-aggregation/aggregationFns.d.ts +23 -0
  358. package/dist/node_modules/@tanstack/table-core/dist/features/row-aggregation/rowAggregationFeature.d.ts +6 -0
  359. package/dist/node_modules/@tanstack/table-core/dist/features/row-aggregation/rowAggregationFeature.types.d.ts +183 -0
  360. package/dist/node_modules/@tanstack/table-core/dist/features/row-aggregation/rowAggregationFeature.utils.d.ts +18 -0
  361. package/dist/node_modules/@tanstack/table-core/dist/features/row-expanding/rowExpandingFeature.d.ts +6 -0
  362. package/dist/node_modules/@tanstack/table-core/dist/features/row-expanding/rowExpandingFeature.types.d.ts +125 -0
  363. package/dist/node_modules/@tanstack/table-core/dist/features/row-pagination/rowPaginationFeature.d.ts +6 -0
  364. package/dist/node_modules/@tanstack/table-core/dist/features/row-pagination/rowPaginationFeature.types.d.ts +135 -0
  365. package/dist/node_modules/@tanstack/table-core/dist/features/row-pinning/rowPinningFeature.d.ts +6 -0
  366. package/dist/node_modules/@tanstack/table-core/dist/features/row-pinning/rowPinningFeature.types.d.ts +76 -0
  367. package/dist/node_modules/@tanstack/table-core/dist/features/row-selection/rowSelectionFeature.d.ts +6 -0
  368. package/dist/node_modules/@tanstack/table-core/dist/features/row-selection/rowSelectionFeature.types.d.ts +187 -0
  369. package/dist/node_modules/@tanstack/table-core/dist/features/row-sorting/rowSortingFeature.d.ts +6 -0
  370. package/dist/node_modules/@tanstack/table-core/dist/features/row-sorting/rowSortingFeature.types.d.ts +236 -0
  371. package/dist/node_modules/@tanstack/table-core/dist/features/row-sorting/sortFns.d.ts +23 -0
  372. package/dist/node_modules/@tanstack/table-core/dist/features/stockFeatures.d.ts +37 -0
  373. package/dist/node_modules/@tanstack/table-core/dist/helpers/columnHelper.d.ts +47 -0
  374. package/dist/node_modules/@tanstack/table-core/dist/types/Cell.d.ts +16 -0
  375. package/dist/node_modules/@tanstack/table-core/dist/types/Column.d.ts +30 -0
  376. package/dist/node_modules/@tanstack/table-core/dist/types/ColumnDef.d.ts +123 -0
  377. package/dist/node_modules/@tanstack/table-core/dist/types/Header.d.ts +12 -0
  378. package/dist/node_modules/@tanstack/table-core/dist/types/HeaderGroup.d.ts +6 -0
  379. package/dist/node_modules/@tanstack/table-core/dist/types/Row.d.ts +24 -0
  380. package/dist/node_modules/@tanstack/table-core/dist/types/RowModel.d.ts +19 -0
  381. package/dist/node_modules/@tanstack/table-core/dist/types/RowModelFns.d.ts +11 -0
  382. package/dist/node_modules/@tanstack/table-core/dist/types/Table.d.ts +53 -0
  383. package/dist/node_modules/@tanstack/table-core/dist/types/TableFeatures.d.ts +416 -0
  384. package/dist/node_modules/@tanstack/table-core/dist/types/TableOptions.d.ts +78 -0
  385. package/dist/node_modules/@tanstack/table-core/dist/types/TableState.d.ts +46 -0
  386. package/dist/node_modules/@tanstack/table-core/dist/types/type-utils.d.ts +25 -0
  387. package/dist/shared.css +179 -0
  388. package/dist/styles.css +5467 -0
  389. package/dist/theme.css +314 -0
  390. package/dist/theme.map.json +278 -0
  391. package/dist/tokens/index.d.ts +2 -0
  392. package/dist/tokens/index.js +1 -0
  393. package/dist/tokens/tokens.generated.d.ts +2040 -0
  394. package/dist/tokens/tokens.generated.js +2053 -0
  395. package/dist/tokens.css +484 -0
  396. package/dist/tokens.flat.json +429 -0
  397. package/docs/Consuming.mdx +379 -0
  398. package/docs/Contributing.mdx +78 -0
  399. package/docs/ForAgents.mdx +53 -0
  400. package/docs/Introduction.mdx +54 -0
  401. package/llms.txt +556 -0
  402. package/package.json +351 -3
  403. package/src/components/action-row/ActionRow.mdx +686 -0
  404. package/src/components/action-row/ActionRow.stories.tsx +669 -0
  405. package/src/components/action-row/ActionRow.tsx +632 -0
  406. package/src/components/action-row/index.ts +9 -0
  407. package/src/components/alert/Alert.mdx +377 -0
  408. package/src/components/alert/Alert.stories.tsx +674 -0
  409. package/src/components/alert/Alert.tsx +579 -0
  410. package/src/components/alert/index.ts +13 -0
  411. package/src/components/anchored-panel/AnchoredPanel.mdx +381 -0
  412. package/src/components/anchored-panel/AnchoredPanel.stories.tsx +593 -0
  413. package/src/components/anchored-panel/AnchoredPanel.tsx +176 -0
  414. package/src/components/anchored-panel/index.ts +15 -0
  415. package/src/components/badge/Badge.mdx +487 -0
  416. package/src/components/badge/Badge.stories.tsx +375 -0
  417. package/src/components/badge/Badge.tsx +360 -0
  418. package/src/components/badge/index.ts +10 -0
  419. package/src/components/banner/Banner.mdx +704 -0
  420. package/src/components/banner/Banner.stories.tsx +448 -0
  421. package/src/components/banner/Banner.tsx +602 -0
  422. package/src/components/banner/index.ts +14 -0
  423. package/src/components/button/Button.mdx +286 -0
  424. package/src/components/button/Button.stories.tsx +381 -0
  425. package/src/components/button/Button.tsx +384 -0
  426. package/src/components/button/index.ts +1 -0
  427. package/src/components/button-group/ButtonGroup.mdx +512 -0
  428. package/src/components/button-group/ButtonGroup.stories.tsx +714 -0
  429. package/src/components/button-group/ButtonGroup.tsx +491 -0
  430. package/src/components/button-group/index.ts +10 -0
  431. package/src/components/card-select/CardSelect.mdx +662 -0
  432. package/src/components/card-select/CardSelect.stories.tsx +784 -0
  433. package/src/components/card-select/CardSelect.tsx +783 -0
  434. package/src/components/card-select/CardSelectGroup.tsx +169 -0
  435. package/src/components/card-select/index.ts +18 -0
  436. package/src/components/checkbox/Checkbox.mdx +269 -0
  437. package/src/components/checkbox/Checkbox.stories.tsx +306 -0
  438. package/src/components/checkbox/Checkbox.tsx +343 -0
  439. package/src/components/checkbox/index.ts +1 -0
  440. package/src/components/chip/Chip.mdx +683 -0
  441. package/src/components/chip/Chip.stories.tsx +734 -0
  442. package/src/components/chip/Chip.tsx +732 -0
  443. package/src/components/chip/index.ts +9 -0
  444. package/src/components/column-header/ColumnHeader.mdx +301 -0
  445. package/src/components/column-header/ColumnHeader.stories.tsx +319 -0
  446. package/src/components/column-header/ColumnHeader.tsx +287 -0
  447. package/src/components/column-header/index.ts +7 -0
  448. package/src/components/combobox-field/Combobox.tsx +693 -0
  449. package/src/components/combobox-field/ComboboxField.mdx +525 -0
  450. package/src/components/combobox-field/ComboboxField.stories.tsx +502 -0
  451. package/src/components/combobox-field/ComboboxField.tsx +259 -0
  452. package/src/components/combobox-field/index.ts +12 -0
  453. package/src/components/date-field/DateField.mdx +340 -0
  454. package/src/components/date-field/DateField.stories.tsx +221 -0
  455. package/src/components/date-field/DateField.tsx +176 -0
  456. package/src/components/date-field/index.ts +1 -0
  457. package/src/components/date-picker/DatePicker.mdx +436 -0
  458. package/src/components/date-picker/DatePicker.stories.tsx +458 -0
  459. package/src/components/date-picker/DatePicker.tsx +688 -0
  460. package/src/components/date-picker/index.ts +9 -0
  461. package/src/components/divider/Divider.mdx +256 -0
  462. package/src/components/divider/Divider.stories.tsx +177 -0
  463. package/src/components/divider/Divider.tsx +193 -0
  464. package/src/components/divider/index.ts +1 -0
  465. package/src/components/drawer/Drawer.mdx +518 -0
  466. package/src/components/drawer/Drawer.stories.tsx +392 -0
  467. package/src/components/drawer/Drawer.tsx +683 -0
  468. package/src/components/drawer/index.ts +1 -0
  469. package/src/components/dropdown-button/DropdownButton.mdx +285 -0
  470. package/src/components/dropdown-button/DropdownButton.stories.tsx +398 -0
  471. package/src/components/dropdown-button/DropdownButton.tsx +198 -0
  472. package/src/components/dropdown-button/index.ts +7 -0
  473. package/src/components/faq/FAQ.mdx +364 -0
  474. package/src/components/faq/FAQ.stories.tsx +343 -0
  475. package/src/components/faq/FAQ.tsx +337 -0
  476. package/src/components/faq/index.ts +1 -0
  477. package/src/components/field/Field.mdx +129 -0
  478. package/src/components/field/Field.stories.tsx +461 -0
  479. package/src/components/field/Field.tsx +765 -0
  480. package/src/components/field/index.ts +20 -0
  481. package/src/components/field-pair/FieldPair.mdx +308 -0
  482. package/src/components/field-pair/FieldPair.stories.tsx +530 -0
  483. package/src/components/field-pair/FieldPair.tsx +796 -0
  484. package/src/components/field-pair/index.ts +9 -0
  485. package/src/components/file-upload/FileUpload.mdx +345 -0
  486. package/src/components/file-upload/FileUpload.stories.tsx +698 -0
  487. package/src/components/file-upload/FileUpload.tsx +802 -0
  488. package/src/components/file-upload/index.ts +6 -0
  489. package/src/components/filter-chip/FilterChip.mdx +778 -0
  490. package/src/components/filter-chip/FilterChip.stories.tsx +827 -0
  491. package/src/components/filter-chip/FilterChip.tsx +881 -0
  492. package/src/components/filter-chip/index.ts +11 -0
  493. package/src/components/filter-facet/FilterFacet.mdx +536 -0
  494. package/src/components/filter-facet/FilterFacet.stories.tsx +506 -0
  495. package/src/components/filter-facet/FilterFacet.tsx +1160 -0
  496. package/src/components/filter-facet/index.ts +7 -0
  497. package/src/components/firm-avatar/FirmAvatar.mdx +280 -0
  498. package/src/components/firm-avatar/FirmAvatar.stories.tsx +147 -0
  499. package/src/components/firm-avatar/FirmAvatar.tsx +172 -0
  500. package/src/components/firm-avatar/index.ts +7 -0
  501. package/src/components/form-actions/FormActions.mdx +518 -0
  502. package/src/components/form-actions/FormActions.stories.tsx +621 -0
  503. package/src/components/form-actions/FormActions.tsx +273 -0
  504. package/src/components/form-actions/index.ts +6 -0
  505. package/src/components/form-block/FormBlock.mdx +728 -0
  506. package/src/components/form-block/FormBlock.stories.tsx +813 -0
  507. package/src/components/form-block/FormBlock.tsx +679 -0
  508. package/src/components/form-block/index.ts +13 -0
  509. package/src/components/form-section/FormSection.mdx +436 -0
  510. package/src/components/form-section/FormSection.stories.tsx +407 -0
  511. package/src/components/form-section/FormSection.tsx +290 -0
  512. package/src/components/form-section/index.ts +17 -0
  513. package/src/components/heading/Heading.mdx +206 -0
  514. package/src/components/heading/Heading.stories.tsx +169 -0
  515. package/src/components/heading/Heading.tsx +124 -0
  516. package/src/components/heading/index.ts +8 -0
  517. package/src/components/heading-group/HeadingGroup.mdx +521 -0
  518. package/src/components/heading-group/HeadingGroup.stories.tsx +353 -0
  519. package/src/components/heading-group/HeadingGroup.tsx +396 -0
  520. package/src/components/heading-group/index.ts +7 -0
  521. package/src/components/hero/Hero.mdx +742 -0
  522. package/src/components/hero/Hero.stories.tsx +527 -0
  523. package/src/components/hero/Hero.tsx +807 -0
  524. package/src/components/hero/index.ts +1 -0
  525. package/src/components/icon/Icon.mdx +329 -0
  526. package/src/components/icon/Icon.stories.tsx +398 -0
  527. package/src/components/icon/Icon.tsx +97 -0
  528. package/src/components/icon/index.ts +2 -0
  529. package/src/components/icon-button/IconButton.mdx +206 -0
  530. package/src/components/icon-button/IconButton.stories.tsx +341 -0
  531. package/src/components/icon-button/IconButton.tsx +273 -0
  532. package/src/components/icon-button/index.ts +1 -0
  533. package/src/components/item-row/ItemRow.mdx +533 -0
  534. package/src/components/item-row/ItemRow.stories.tsx +434 -0
  535. package/src/components/item-row/ItemRow.tsx +676 -0
  536. package/src/components/item-row/index.ts +9 -0
  537. package/src/components/list-row/ListRow.mdx +404 -0
  538. package/src/components/list-row/ListRow.stories.tsx +404 -0
  539. package/src/components/list-row/ListRow.tsx +424 -0
  540. package/src/components/list-row/index.ts +1 -0
  541. package/src/components/menu/Menu.mdx +268 -0
  542. package/src/components/menu/Menu.stories.tsx +455 -0
  543. package/src/components/menu/Menu.tsx +452 -0
  544. package/src/components/menu/index.ts +1 -0
  545. package/src/components/modal/Modal.mdx +854 -0
  546. package/src/components/modal/Modal.stories.tsx +881 -0
  547. package/src/components/modal/Modal.tsx +1434 -0
  548. package/src/components/modal/index.ts +1 -0
  549. package/src/components/nav-link/NavLink.mdx +196 -0
  550. package/src/components/nav-link/NavLink.stories.tsx +243 -0
  551. package/src/components/nav-link/NavLink.tsx +222 -0
  552. package/src/components/nav-link/index.ts +1 -0
  553. package/src/components/number-field/NumberField.mdx +223 -0
  554. package/src/components/number-field/NumberField.stories.tsx +291 -0
  555. package/src/components/number-field/NumberField.tsx +388 -0
  556. package/src/components/number-field/index.ts +6 -0
  557. package/src/components/pagination/Pagination.mdx +305 -0
  558. package/src/components/pagination/Pagination.stories.tsx +333 -0
  559. package/src/components/pagination/Pagination.tsx +343 -0
  560. package/src/components/pagination/index.ts +8 -0
  561. package/src/components/popover-surface/PopoverSurface.mdx +158 -0
  562. package/src/components/popover-surface/PopoverSurface.stories.tsx +421 -0
  563. package/src/components/popover-surface/index.ts +1 -0
  564. package/src/components/progress-bar/ProgressBar.mdx +802 -0
  565. package/src/components/progress-bar/ProgressBar.stories.tsx +533 -0
  566. package/src/components/progress-bar/ProgressBar.tsx +654 -0
  567. package/src/components/progress-bar/index.ts +9 -0
  568. package/src/components/promo-sticker/PromoSticker.mdx +436 -0
  569. package/src/components/promo-sticker/PromoSticker.stories.tsx +363 -0
  570. package/src/components/promo-sticker/PromoSticker.tsx +313 -0
  571. package/src/components/promo-sticker/index.ts +7 -0
  572. package/src/components/promo-surface/PromoSurface.mdx +399 -0
  573. package/src/components/promo-surface/PromoSurface.stories.tsx +270 -0
  574. package/src/components/promo-surface/PromoSurface.tsx +305 -0
  575. package/src/components/promo-surface/index.ts +7 -0
  576. package/src/components/radio/Radio.mdx +243 -0
  577. package/src/components/radio/Radio.stories.tsx +307 -0
  578. package/src/components/radio/Radio.tsx +288 -0
  579. package/src/components/radio/index.ts +1 -0
  580. package/src/components/radio-group/RadioGroup.mdx +119 -0
  581. package/src/components/radio-group/RadioGroup.stories.tsx +225 -0
  582. package/src/components/radio-group/RadioGroup.tsx +139 -0
  583. package/src/components/radio-group/index.ts +1 -0
  584. package/src/components/select/Select.mdx +241 -0
  585. package/src/components/select/Select.stories.tsx +404 -0
  586. package/src/components/select/Select.tsx +381 -0
  587. package/src/components/select/index.ts +1 -0
  588. package/src/components/select-field/SelectField.mdx +324 -0
  589. package/src/components/select-field/SelectField.stories.tsx +460 -0
  590. package/src/components/select-field/SelectField.tsx +138 -0
  591. package/src/components/select-field/index.ts +1 -0
  592. package/src/components/skeleton/Skeleton.mdx +194 -0
  593. package/src/components/skeleton/Skeleton.stories.tsx +260 -0
  594. package/src/components/skeleton/Skeleton.tsx +107 -0
  595. package/src/components/skeleton/index.ts +1 -0
  596. package/src/components/split-button/SplitButton.mdx +445 -0
  597. package/src/components/split-button/SplitButton.stories.tsx +465 -0
  598. package/src/components/split-button/SplitButton.tsx +361 -0
  599. package/src/components/split-button/index.ts +7 -0
  600. package/src/components/status-summary-bar/StatusSummaryBar.mdx +338 -0
  601. package/src/components/status-summary-bar/StatusSummaryBar.stories.tsx +408 -0
  602. package/src/components/status-summary-bar/StatusSummaryBar.tsx +428 -0
  603. package/src/components/status-summary-bar/index.ts +8 -0
  604. package/src/components/subject-lookup-field/SubjectLookupField.mdx +378 -0
  605. package/src/components/subject-lookup-field/SubjectLookupField.stories.tsx +393 -0
  606. package/src/components/subject-lookup-field/SubjectLookupField.tsx +1079 -0
  607. package/src/components/subject-lookup-field/index.ts +11 -0
  608. package/src/components/switch/Switch.mdx +376 -0
  609. package/src/components/switch/Switch.stories.tsx +296 -0
  610. package/src/components/switch/Switch.tsx +483 -0
  611. package/src/components/switch/index.ts +1 -0
  612. package/src/components/table/Table.mdx +575 -0
  613. package/src/components/table/Table.stories.tsx +1049 -0
  614. package/src/components/table/Table.tsx +745 -0
  615. package/src/components/table/TableConsumers.stories.tsx +195 -0
  616. package/src/components/table/_tableFixtures.ts +1189 -0
  617. package/src/components/table/index.ts +22 -0
  618. package/src/components/text-field/TextField.mdx +479 -0
  619. package/src/components/text-field/TextField.stories.tsx +366 -0
  620. package/src/components/text-field/TextField.tsx +391 -0
  621. package/src/components/text-field/index.ts +8 -0
  622. package/src/components/text-link/TextLink.mdx +353 -0
  623. package/src/components/text-link/TextLink.stories.tsx +458 -0
  624. package/src/components/text-link/TextLink.tsx +504 -0
  625. package/src/components/text-link/index.ts +10 -0
  626. package/src/components/textarea/Textarea.mdx +244 -0
  627. package/src/components/textarea/Textarea.stories.tsx +371 -0
  628. package/src/components/textarea/Textarea.tsx +489 -0
  629. package/src/components/textarea/index.ts +9 -0
  630. package/src/components/tooltip/Tooltip.mdx +462 -0
  631. package/src/components/tooltip/Tooltip.stories.tsx +500 -0
  632. package/src/components/tooltip/Tooltip.tsx +756 -0
  633. package/src/components/tooltip/index.ts +13 -0
  634. package/src/components/unit-field/UnitField.mdx +215 -0
  635. package/src/components/unit-field/UnitField.stories.tsx +291 -0
  636. package/src/components/unit-field/UnitField.tsx +255 -0
  637. package/src/components/unit-field/index.ts +7 -0
  638. package/src/icons/icon-registry.generated.ts +510 -0
  639. package/src/icons/icon-types.generated.ts +256 -0
  640. package/src/index.ts +71 -0
  641. package/src/internal/BottomSheet.tsx +714 -0
  642. package/src/internal/FodsProvider.tsx +36 -0
  643. package/src/internal/MotionCaret.tsx +53 -0
  644. package/src/internal/NumberFormatInput.tsx +276 -0
  645. package/src/internal/SummaryDonut.tsx +359 -0
  646. package/src/internal/buttonSegment.ts +241 -0
  647. package/src/internal/collapseRoom.ts +130 -0
  648. package/src/internal/comboboxKeys.ts +90 -0
  649. package/src/internal/contentPresence.ts +46 -0
  650. package/src/internal/dayCell.ts +274 -0
  651. package/src/internal/dialogPortal.ts +50 -0
  652. package/src/internal/donutSweeps.ts +77 -0
  653. package/src/internal/enterOnViewGeometry.ts +53 -0
  654. package/src/internal/faqItem.ts +104 -0
  655. package/src/internal/floatingLabelMotion.tsx +109 -0
  656. package/src/internal/formBlockContext.ts +27 -0
  657. package/src/internal/heightRoom.ts +135 -0
  658. package/src/internal/numberSeparators.ts +93 -0
  659. package/src/internal/overlayMotion.tsx +32 -0
  660. package/src/internal/paginationItem.ts +106 -0
  661. package/src/internal/popoverSurface.ts +78 -0
  662. package/src/internal/portalContainer.ts +11 -0
  663. package/src/internal/progressBarItem.ts +356 -0
  664. package/src/internal/selectionControlText.ts +42 -0
  665. package/src/internal/statusSummaryParts.tsx +475 -0
  666. package/src/internal/summaryMotion.ts +111 -0
  667. package/src/internal/table/ChildConnector.tsx +57 -0
  668. package/src/internal/table/ChildRowPrefix.tsx +21 -0
  669. package/src/internal/table/ColumnSettings.tsx +194 -0
  670. package/src/internal/table/ScrollRegion.tsx +176 -0
  671. package/src/internal/table/TableEmpty.tsx +99 -0
  672. package/src/internal/table/TableLayout.tsx +29 -0
  673. package/src/internal/table/TableLoadStatus.tsx +60 -0
  674. package/src/internal/table/TableMobile.tsx +582 -0
  675. package/src/internal/table/TruncatedCell.tsx +35 -0
  676. package/src/internal/table/emptyValue.ts +11 -0
  677. package/src/internal/table/features.ts +44 -0
  678. package/src/internal/table/recipes.ts +263 -0
  679. package/src/internal/table/rowClick.ts +8 -0
  680. package/src/internal/table/types.ts +342 -0
  681. package/src/internal/tailwind-variants.ts +65 -0
  682. package/src/internal/tooltipContext.ts +15 -0
  683. package/src/internal/tw-merge-config.generated.ts +275 -0
  684. package/src/internal/useAnchoredPanel.ts +340 -0
  685. package/src/internal/useCountUp.ts +65 -0
  686. package/src/internal/useDateFieldTrigger.tsx +357 -0
  687. package/src/internal/useEChart.ts +88 -0
  688. package/src/internal/useEnterOnView.ts +80 -0
  689. package/src/internal/useFloatingBar.ts +125 -0
  690. package/src/internal/useFormReset.ts +47 -0
  691. package/src/internal/useIsMobile.ts +64 -0
  692. package/src/internal/useNoImplicitSubmit.ts +41 -0
  693. package/src/internal/useOneRowOverflow.ts +103 -0
  694. package/src/internal/usePrefersReducedMotion.ts +27 -0
  695. package/src/internal/useReturnFocus.ts +34 -0
  696. package/src/internal/utils.ts +58 -0
  697. package/src/recipes/EmptyState.stories.tsx +105 -0
  698. package/src/recipes/Form.stories.tsx +355 -0
  699. package/src/recipes/ModalWithForm.stories.tsx +219 -0
  700. package/src/recipes/Recipes.mdx +61 -0
  701. package/src/recipes/TableWithFilters.stories.tsx +278 -0
  702. package/src/storybook/FodsFamily.tsx +39 -0
  703. package/src/storybook/Section.tsx +36 -0
  704. package/src/storybook/a11y.ts +24 -0
  705. package/src/storybook/assets/banner-character-bartender.webp +0 -0
  706. package/src/storybook/assets/banner-invoice-sheet-left.webp +0 -0
  707. package/src/storybook/assets/banner-invoice-sheet-right.webp +0 -0
  708. package/src/storybook/assets/invoice-hero.webp +0 -0
  709. package/src/storybook/assets/invoice.webp +0 -0
  710. package/src/storybook/assets/section-document-info.svg +21 -0
  711. package/src/storybook/assets/section-gear-checklist.svg +11 -0
  712. package/src/storybook/assets/section-person-arrow-in.svg +15 -0
  713. package/src/storybook/assets/section-person-arrow-out.svg +22 -0
  714. package/src/storybook/assets/section-receipt-dollar.svg +23 -0
  715. package/src/storybook/assets/table-empty-folder-empty.png +0 -0
  716. package/src/storybook/assets/table-empty-folder-magnifying-glass.png +0 -0
  717. package/src/storybook/assets/table-empty-funnel.png +0 -0
  718. package/src/storybook/assets/table-empty-load-failed.png +0 -0
  719. package/src/storybook/assets/wallet-spot.png +0 -0
  720. package/src/storybook/assets.d.ts +17 -0
  721. package/src/storybook/componentDoc.ts +41 -0
  722. package/src/storybook/fitFrame.tsx +70 -0
  723. package/src/storybook/forceStates.tsx +647 -0
  724. package/src/storybook/illustrations.tsx +66 -0
  725. package/src/storybook/viewportFrame.tsx +58 -0
  726. package/src/styles/assets/label-brush-1.svg +6 -0
  727. package/src/styles/assets/pattern-dark.svg +113 -0
  728. package/src/styles/base.css +106 -0
  729. package/src/styles/index.css +15 -0
  730. package/src/styles/motion.css +157 -0
  731. package/src/styles/promo-sticker.css +27 -0
  732. package/src/styles/promo-surface.css +49 -0
  733. package/src/styles/shared.css +11 -0
  734. package/src/styles/theme.generated.css +314 -0
  735. package/src/styles/theme.map.json +278 -0
  736. package/src/styles/tracking.generated.css +12 -0
  737. package/src/tokens/index.ts +4 -0
  738. package/src/tokens/tokens.generated.ts +542 -0
@@ -0,0 +1,125 @@
1
+ "use client";
2
+ import * as React from 'react';
3
+
4
+ /**
5
+ * `form-actions.manifest.json` `chrome.position` / `delivery.react`: on a viewport 480 px
6
+ * tall or less the bar never floats — it stays in flow (`position: static`) and the
7
+ * observer is not attached. The CSS side of the same query lives on the bar's root.
8
+ */
9
+ // fods-lint-disable-next-line form-actions.manifest.json chrome.position / delivery.react: the literal (max-height: 480px) media query; a viewport-height condition, not a design length
10
+ export const FLOATING_BAR_SHORT_VIEWPORT_QUERY = '(max-height: 480px)';
11
+
12
+ /**
13
+ * `delivery.react`: the sentinel's IntersectionObserver extends the viewport bottom by
14
+ * 16 px — the height the bar loses when it floats (`chrome.measurements` 92 → 76). Kept
15
+ * verbatim, but it does NOT prevent oscillation on its own: what does is the root's
16
+ * compensating margin-bottom while floating (FormActions.tsx, "Docked / floating"), which
17
+ * keeps the bar's in-flow footprint — and so the sentinel — where it was.
18
+ */
19
+ // fods-lint-disable-next-line form-actions.manifest.json delivery.react: rootMargin '0px 0px 16px 0px' verbatim; an IntersectionObserver option string cannot read a CSS custom property
20
+ export const FLOATING_BAR_ROOT_MARGIN = '0px 0px 16px 0px';
21
+
22
+ /**
23
+ * Live `matchMedia` read; `false` when there is no window (SSR), no `matchMedia`, or the
24
+ * query is `null` (nothing is subscribed then).
25
+ */
26
+ export function useMediaQuery(query: string | null): boolean {
27
+ const mediaQuery = React.useMemo(
28
+ () =>
29
+ query === null || typeof window === 'undefined' || typeof window.matchMedia !== 'function'
30
+ ? null
31
+ : window.matchMedia(query),
32
+ [query],
33
+ );
34
+ const subscribe = React.useCallback(
35
+ (onChange: () => void) => {
36
+ if (!mediaQuery) return () => {};
37
+ mediaQuery.addEventListener('change', onChange);
38
+ return () => mediaQuery.removeEventListener('change', onChange);
39
+ },
40
+ [mediaQuery],
41
+ );
42
+ const getSnapshot = React.useCallback(() => mediaQuery?.matches ?? false, [mediaQuery]);
43
+ const getServerSnapshot = React.useCallback(() => false, []);
44
+ return React.useSyncExternalStore(subscribe, getSnapshot, getServerSnapshot);
45
+ }
46
+
47
+ /**
48
+ * Every bar currently floating → its height. `scroll-padding-bottom` lives on ONE page
49
+ * scroller, so several instances cannot each save and restore it: with A and B floating,
50
+ * A docking first would restore the value from before A while B still covers the
51
+ * bottom, and B docking would then "restore" A's height forever. The registry applies
52
+ * the tallest active bar and restores the pre-registry value only once it empties.
53
+ */
54
+ const activeBars = new Map<symbol, number>();
55
+ let scrollPaddingBeforeBars: string | null = null;
56
+
57
+ function syncScrollPadding(): void {
58
+ const scroller = document.documentElement;
59
+ if (activeBars.size === 0) {
60
+ if (scrollPaddingBeforeBars !== null) scroller.style.scrollPaddingBottom = scrollPaddingBeforeBars;
61
+ scrollPaddingBeforeBars = null;
62
+ return;
63
+ }
64
+ if (scrollPaddingBeforeBars === null) scrollPaddingBeforeBars = scroller.style.scrollPaddingBottom;
65
+ scroller.style.scrollPaddingBottom = `${Math.max(...activeBars.values())}px`;
66
+ }
67
+
68
+ /**
69
+ * Floating detection for a `position: sticky; bottom: 0` bar (Form Actions).
70
+ *
71
+ * - The bar floats while the zero-height sentinel rendered directly after it is outside
72
+ * the viewport, and docks while the sentinel intersects.
73
+ * - On a short viewport (`max-height: 480px`) no observer is attached and the bar is
74
+ * always docked.
75
+ * - While floating, the page scroller (`document.documentElement`) carries
76
+ * `scroll-padding-bottom` equal to the bar's current height, so a focused field is
77
+ * never scrolled in under it (spec § Accessibility → Focus). With several bars
78
+ * floating at once the tallest wins; the previous inline value is restored when the
79
+ * last of them docks or unmounts (`activeBars`).
80
+ */
81
+ export function useFloatingBar(
82
+ barRef: React.RefObject<HTMLElement | null>,
83
+ sentinelRef: React.RefObject<HTMLElement | null>,
84
+ ): boolean {
85
+ const shortViewport = useMediaQuery(FLOATING_BAR_SHORT_VIEWPORT_QUERY);
86
+ const [floating, setFloating] = React.useState(false);
87
+
88
+ React.useEffect(() => {
89
+ const sentinel = sentinelRef.current;
90
+ if (shortViewport || !sentinel || typeof IntersectionObserver === 'undefined') {
91
+ setFloating(false);
92
+ return undefined;
93
+ }
94
+ const observer = new IntersectionObserver(
95
+ (entries) => {
96
+ const entry = entries[entries.length - 1];
97
+ if (entry) setFloating(!entry.isIntersecting);
98
+ },
99
+ { rootMargin: FLOATING_BAR_ROOT_MARGIN },
100
+ );
101
+ observer.observe(sentinel);
102
+ return () => observer.disconnect();
103
+ }, [shortViewport, sentinelRef]);
104
+
105
+ React.useEffect(() => {
106
+ const bar = barRef.current;
107
+ if (!floating || !bar || typeof document === 'undefined') return undefined;
108
+ const id = Symbol('floating-bar');
109
+ const apply = () => {
110
+ activeBars.set(id, bar.getBoundingClientRect().height);
111
+ syncScrollPadding();
112
+ };
113
+ apply();
114
+ // The height changes with the breakpoint (one row / two rows) while floating.
115
+ const resizeObserver = typeof ResizeObserver === 'undefined' ? null : new ResizeObserver(apply);
116
+ resizeObserver?.observe(bar);
117
+ return () => {
118
+ resizeObserver?.disconnect();
119
+ activeBars.delete(id);
120
+ syncScrollPadding();
121
+ };
122
+ }, [floating, barRef]);
123
+
124
+ return floating;
125
+ }
@@ -0,0 +1,47 @@
1
+ "use client";
2
+ import * as React from 'react';
3
+
4
+ type FormControl = HTMLInputElement | HTMLTextAreaElement;
5
+
6
+ /**
7
+ * Calls `onReset` with the control's restored value after its form is reset.
8
+ *
9
+ * A native `form.reset()` restores every control to its default WITHOUT firing
10
+ * `change`/`input`, so state an uncontrolled component mirrors from `onChange`
11
+ * (emptiness, checked, a character count) would go stale. The `reset` event is
12
+ * dispatched BEFORE the browser restores the values — and is cancelable — so the
13
+ * value is read one task later, which also covers a reset that was prevented.
14
+ *
15
+ * `formAttr` is the control's `form` attribute: changing it re-associates the
16
+ * control with another form, so the listener is moved along.
17
+ */
18
+ export function useFormReset<T extends FormControl>(
19
+ elementRef: React.RefObject<T | null>,
20
+ onReset: (element: T) => void,
21
+ formAttr?: string,
22
+ ) {
23
+ const onResetRef = React.useRef(onReset);
24
+ onResetRef.current = onReset;
25
+
26
+ React.useEffect(() => {
27
+ const form = elementRef.current?.form;
28
+ if (!form) {
29
+ return undefined;
30
+ }
31
+ let timeout: ReturnType<typeof setTimeout> | undefined;
32
+ const handleReset = () => {
33
+ clearTimeout(timeout);
34
+ timeout = setTimeout(() => {
35
+ const element = elementRef.current;
36
+ if (element) {
37
+ onResetRef.current(element);
38
+ }
39
+ }, 0);
40
+ };
41
+ form.addEventListener('reset', handleReset);
42
+ return () => {
43
+ form.removeEventListener('reset', handleReset);
44
+ clearTimeout(timeout);
45
+ };
46
+ }, [elementRef, formAttr]);
47
+ }
@@ -0,0 +1,64 @@
1
+ "use client";
2
+ import { useCallback, useMemo, useSyncExternalStore } from 'react';
3
+ import { primitives } from '../tokens';
4
+
5
+ /** A named breakpoint of the token scale (`--ds-breakpoint-*`). */
6
+ export type Breakpoint = keyof typeof primitives.breakpoint;
7
+
8
+ /**
9
+ * Detects whether the current viewport is below a Tailwind breakpoint.
10
+ * Accepts a named breakpoint (`'sm' | 'md' | 'lg' | 'xl'`) or a raw pixel value.
11
+ *
12
+ * Backed by `matchMedia`, deliberately NOT a `resize` listener: the browser
13
+ * fires `change` only when the breakpoint is actually CROSSED, instead of once
14
+ * per pixel of a drag, and the value can be read synchronously — so the first
15
+ * render is already correct rather than rendering the desktop branch and
16
+ * correcting it in an effect (which flashes, and fights hydration).
17
+ *
18
+ * The query mirrors the Tailwind prefix exactly. `md:` compiles to a `min-width`
19
+ * at `--ds-breakpoint-md`, so "mobile" is its complement — a `max-width` 0.02
20
+ * below the same value. That .02 keeps a fractional viewport (browser zoom, some
21
+ * devices) from falling between the two rules. JS and CSS therefore never disagree by a pixel, which
22
+ * matters wherever a component's chrome is responsive in CSS while its layout
23
+ * is switched in JS.
24
+ *
25
+ * NOTE this is a VIEWPORT measure, not a device class: a narrowed desktop window
26
+ * is mobile here, a phone in landscape may not be. Use it whenever the decision
27
+ * is about available WIDTH.
28
+ *
29
+ * @example
30
+ * const isMobile = useIsMobile('md');
31
+ * return isMobile ? <MobileView /> : <DesktopView />;
32
+ */
33
+ export function useIsMobile(breakpoint: Breakpoint | number = 'md') {
34
+ const query = useMemo(() => {
35
+ const value = typeof breakpoint === 'number'
36
+ ? breakpoint
37
+ : parseInt(primitives.breakpoint[breakpoint as Breakpoint].value, 10);
38
+
39
+ return `(max-width: ${value - 0.02}px)`;
40
+ }, [breakpoint]);
41
+
42
+ // Built once per query, not per render: `getSnapshot` runs on every render and
43
+ // must stay cheap.
44
+ const mediaQuery = useMemo(
45
+ () => (typeof window === 'undefined' ? null : window.matchMedia(query)),
46
+ [query],
47
+ );
48
+
49
+ const subscribe = useCallback(
50
+ (onStoreChange: () => void) => {
51
+ if (!mediaQuery) return () => {};
52
+ mediaQuery.addEventListener('change', onStoreChange);
53
+ return () => mediaQuery.removeEventListener('change', onStoreChange);
54
+ },
55
+ [mediaQuery],
56
+ );
57
+
58
+ const getSnapshot = useCallback(() => mediaQuery?.matches ?? false, [mediaQuery]);
59
+ // A server render has no viewport at all. `false` (desktop) is the safe
60
+ // assumption; hydration reads the real value on the client.
61
+ const getServerSnapshot = useCallback(() => false, []);
62
+
63
+ return useSyncExternalStore(subscribe, getSnapshot, getServerSnapshot);
64
+ }
@@ -0,0 +1,41 @@
1
+ "use client";
2
+ import * as React from 'react';
3
+
4
+ /**
5
+ * Input types on which Enter is the browser's implicit submission and nothing else.
6
+ * Everything else is left alone: button types activate, checkbox / radio / range /
7
+ * file / color have no implicit submission of their own or use Enter for themselves,
8
+ * and the date / time family opens or drives a picker.
9
+ */
10
+ const IMPLICIT_SUBMIT_INPUT_TYPES = new Set(['text', 'search', 'url', 'tel', 'email', 'password', 'number']);
11
+
12
+ function isImplicitSubmitTarget(target: EventTarget | null): boolean {
13
+ if (!(target instanceof HTMLInputElement)) return false;
14
+ return IMPLICIT_SUBMIT_INPUT_TYPES.has(target.type);
15
+ }
16
+
17
+ /**
18
+ * Turns implicit submission off on the form that contains `ref`
19
+ * (`form-actions.manifest.json` `delivery.react`): Enter in a text-like field never
20
+ * commits, a commit only happens on an activated action button.
21
+ *
22
+ * The listener sits on the form's document in the bubble phase, not on the form: React
23
+ * dispatches from its root container, which is below the document, so every React
24
+ * handler (a combobox picking an option, Radix `composeEventHandlers`, cmdk) has run
25
+ * before this one and still sees `defaultPrevented === false`. An event a field has
26
+ * already prevented is skipped. Only the default is cancelled; propagation is untouched.
27
+ */
28
+ export function useNoImplicitSubmit(ref: React.RefObject<HTMLElement | null>): void {
29
+ React.useEffect(() => {
30
+ const form = ref.current?.closest('form');
31
+ if (!form) return undefined;
32
+ const doc = form.ownerDocument;
33
+ const onKeyDown = (event: KeyboardEvent) => {
34
+ if (event.key !== 'Enter' || event.isComposing || event.defaultPrevented) return;
35
+ if (!(event.target instanceof Node) || !form.contains(event.target)) return;
36
+ if (isImplicitSubmitTarget(event.target)) event.preventDefault();
37
+ };
38
+ doc.addEventListener('keydown', onKeyDown);
39
+ return () => doc.removeEventListener('keydown', onKeyDown);
40
+ }, [ref]);
41
+ }
@@ -0,0 +1,103 @@
1
+ "use client";
2
+ import * as React from 'react';
3
+ import { useMediaQuery } from './useFloatingBar';
4
+
5
+ /**
6
+ * Set on the bar for the length of one synchronous measurement. The bar's CSS keys
7
+ * the one-row probe layout on it (no wrap, start-aligned, children never shrink) and
8
+ * switches the `data-stacked` two-row rules off, so the result never depends on the
9
+ * layout currently shown.
10
+ */
11
+ export const ONE_ROW_MEASURING_ATTR = 'data-measuring';
12
+
13
+ /** Set on the bar by the component while the one-row content does not fit. */
14
+ export const ONE_ROW_STACKED_ATTR = 'data-stacked';
15
+
16
+ const OWN_ATTRS = new Set([ONE_ROW_MEASURING_ATTR, ONE_ROW_STACKED_ATTR]);
17
+
18
+ /** Rounding of fractional layout widths, not a real overflow. */
19
+ const SUBPIXEL_TOLERANCE = 0.5;
20
+
21
+ /** Right edge of the bar's content box — its border box minus the inline-end padding and border. */
22
+ function contentBoxEnd(bar: HTMLElement): number {
23
+ const style = getComputedStyle(bar);
24
+ return bar.getBoundingClientRect().right
25
+ - (parseFloat(style.paddingRight) || 0)
26
+ - (parseFloat(style.borderRightWidth) || 0);
27
+ }
28
+
29
+ /**
30
+ * Right edge of the start-aligned one-row probe — its last child. Not `scrollWidth`:
31
+ * Chrome leaves the flex container's inline-end padding out of it, so a row that runs
32
+ * only into the padding reads as fitting.
33
+ */
34
+ function oneRowEnd(bar: HTMLElement): number {
35
+ return bar.lastElementChild?.getBoundingClientRect().right ?? 0;
36
+ }
37
+
38
+ /**
39
+ * Whether the bar's children do NOT fit on one row (Form Actions `stackOnOverflow`,
40
+ * `chrome.layout.stack-on-overflow`). Disabled (`enabled: false`) it returns `false`
41
+ * and attaches nothing — no observer, no fonts listener, no `matchMedia` subscription.
42
+ *
43
+ * The bar is put into the one-row probe layout (`data-measuring`), the right edge of
44
+ * its last child is compared with the bar's content box and the attribute is removed again — all in the same
45
+ * task, so the probe layout is never painted, and independent of the current
46
+ * layout, so the answer cannot oscillate between one and two rows.
47
+ *
48
+ * Re-measured on a size change of the bar, on any change of its content (children,
49
+ * text, attributes of the actions — a new label, Loading) and once web fonts are
50
+ * ready. Nothing is measured while `stackedQuery` matches: the breakpoint already
51
+ * lays out two rows. Without `ResizeObserver` / `MutationObserver` (SSR, jsdom) only
52
+ * the first measurement runs.
53
+ */
54
+ export function useOneRowOverflow(
55
+ barRef: React.RefObject<HTMLElement | null>,
56
+ stackedQuery: string,
57
+ enabled: boolean,
58
+ ): boolean {
59
+ const stackedByViewport = useMediaQuery(enabled ? stackedQuery : null);
60
+ const [overflowing, setOverflowing] = React.useState(false);
61
+
62
+ React.useLayoutEffect(() => {
63
+ const bar = barRef.current;
64
+ if (!enabled || stackedByViewport || !bar) {
65
+ setOverflowing(false);
66
+ return undefined;
67
+ }
68
+ let active = true;
69
+ const measure = () => {
70
+ if (!active) return;
71
+ bar.setAttribute(ONE_ROW_MEASURING_ATTR, '');
72
+ const overflows = oneRowEnd(bar) > contentBoxEnd(bar) + SUBPIXEL_TOLERANCE;
73
+ bar.removeAttribute(ONE_ROW_MEASURING_ATTR);
74
+ setOverflowing(overflows);
75
+ };
76
+ measure();
77
+
78
+ const resizeObserver = typeof ResizeObserver === 'undefined' ? null : new ResizeObserver(measure);
79
+ resizeObserver?.observe(bar);
80
+
81
+ // The bar's own attributes are toggled by the measurement and by the result —
82
+ // reacting to them would loop.
83
+ const mutationObserver =
84
+ typeof MutationObserver === 'undefined'
85
+ ? null
86
+ : new MutationObserver((records) => {
87
+ if (records.some(r => !(r.target === bar && r.type === 'attributes' && OWN_ATTRS.has(r.attributeName ?? '')))) {
88
+ measure();
89
+ }
90
+ });
91
+ mutationObserver?.observe(bar, { childList: true, subtree: true, characterData: true, attributes: true });
92
+
93
+ if (typeof document !== 'undefined') document.fonts?.ready.then(measure).catch(() => {});
94
+
95
+ return () => {
96
+ active = false;
97
+ resizeObserver?.disconnect();
98
+ mutationObserver?.disconnect();
99
+ };
100
+ }, [barRef, enabled, stackedByViewport]);
101
+
102
+ return enabled && overflowing && !stackedByViewport;
103
+ }
@@ -0,0 +1,27 @@
1
+ "use client";
2
+ import * as React from 'react';
3
+
4
+ const QUERY = '(prefers-reduced-motion: reduce)';
5
+
6
+ /**
7
+ * `prefers-reduced-motion` read at runtime, for motion a CSS media query cannot
8
+ * reach — inline styles written by a library (floating-ui transitions) or values
9
+ * driven from JS (requestAnimationFrame count-ups, chart animations).
10
+ *
11
+ * Starts at `false` on the server and on the first client render so the markup
12
+ * hydrates identically, then syncs with the media query and follows its changes.
13
+ */
14
+ export function usePrefersReducedMotion(): boolean {
15
+ const [reduced, setReduced] = React.useState(false);
16
+
17
+ React.useEffect(() => {
18
+ if (typeof window === 'undefined' || !window.matchMedia) return undefined;
19
+ const query = window.matchMedia(QUERY);
20
+ setReduced(query.matches);
21
+ const onChange = (event: MediaQueryListEvent) => setReduced(event.matches);
22
+ query.addEventListener('change', onChange);
23
+ return () => query.removeEventListener('change', onChange);
24
+ }, []);
25
+
26
+ return reduced;
27
+ }
@@ -0,0 +1,34 @@
1
+ "use client";
2
+ import * as React from 'react';
3
+
4
+ /**
5
+ * The element that had focus when a controlled Radix dialog opened. Captured in a
6
+ * LAYOUT effect so it runs before Radix's FocusScope moves focus inside (a passive
7
+ * effect). Radix would otherwise return focus to its `Dialog.Trigger` — which a
8
+ * controlled dialog never has, so focus would fall to <body>.
9
+ *
10
+ * Pass the returned handler to `DialogPrimitive.Content`'s `onCloseAutoFocus`.
11
+ */
12
+ export function useReturnFocus(open: boolean) {
13
+ const returnFocusRef = React.useRef<HTMLElement | null>(null);
14
+
15
+ React.useLayoutEffect(() => {
16
+ if (!open) {
17
+ return;
18
+ }
19
+ const active = document.activeElement;
20
+ returnFocusRef.current = active instanceof HTMLElement && active !== document.body ? active : null;
21
+ }, [open]);
22
+
23
+ return React.useCallback((event: Event) => {
24
+ event.preventDefault();
25
+ const target = returnFocusRef.current;
26
+ returnFocusRef.current = null;
27
+ if (target?.isConnected) {
28
+ // `preventScroll` like Radix's own return focus: scrolling the trigger into view fires a
29
+ // scroll event, and Radix Tooltip closes on any scroll around its trigger — the tooltip
30
+ // the returned focus just opened would flash and vanish.
31
+ target.focus({ preventScroll: true });
32
+ }
33
+ }, []);
34
+ }
@@ -0,0 +1,58 @@
1
+ import * as React from 'react';
2
+ import { type ClassValue, clsx } from 'clsx';
3
+ import { twMerge } from './tailwind-variants';
4
+
5
+ /**
6
+ * Utility function for merging Tailwind CSS classes
7
+ * Combines clsx for conditional classes with tailwind-merge for deduplication
8
+ */
9
+ export function cn(...inputs: ClassValue[]) {
10
+ return twMerge(clsx(inputs));
11
+ }
12
+
13
+ /**
14
+ * Capture-phase click blocker for a DISABLED root that does not own its handlers —
15
+ * they either arrive as rest props or, in a Radix `Slot`, come from the slotted child.
16
+ * `pointer-events-none` stops the mouse, but never a keyboard-generated (Enter on a
17
+ * focused element that has just been disabled) or programmatic click.
18
+ *
19
+ * Why capture phase: `Slot`'s `mergeProps` composes handlers CHILD-FIRST and a
20
+ * colliding child handler cannot be overridden, so a bubble-phase guard runs only
21
+ * AFTER the child's own `onClick` has navigated / fired its mutation —
22
+ * `preventDefault()` then stops the native activation but not the side effect that
23
+ * already ran. A capture-phase listener runs before every bubble listener on the same
24
+ * element, and `stopPropagation()` on the synthetic event also stops the native one,
25
+ * which keeps React from ever dispatching the bubble phase.
26
+ *
27
+ * Wire it as `onClickCapture` AFTER the consumer's rest props so a disabled root
28
+ * cannot have its guard shadowed. In a `Slot` also pass the children through
29
+ * `stripChildClickHandlers` — a child that declares `onClickCapture` ITSELF would
30
+ * otherwise be composed child-first and outrun the guard.
31
+ */
32
+ export function suppressDisabledClick(event: React.MouseEvent): void {
33
+ event.preventDefault();
34
+ event.stopPropagation();
35
+ }
36
+
37
+ /**
38
+ * Removes a slotted child's OWN click handlers, for a root that is currently disabled.
39
+ *
40
+ * `Slot`'s `mergeProps` composes colliding handlers child-first, so the child's
41
+ * `onClickCapture` runs BEFORE the root's `suppressDisabledClick` and its side effect
42
+ * (navigation, a mutation) happens even though the root is disabled. Stopping
43
+ * propagation cannot help — the child handler has already been invoked. Dropping the
44
+ * prop before Radix clones the child is the only way to close that from the outside;
45
+ * the guard then stays the single click path.
46
+ *
47
+ * `onClick` is dropped as well, purely so the merge has nothing to compose — the
48
+ * capture guard already stops the bubble phase from ever being dispatched.
49
+ *
50
+ * Anything that is not a single element (a string, a fragment) is returned untouched;
51
+ * `Slot` rejects those anyway.
52
+ */
53
+ export function stripChildClickHandlers(children: React.ReactNode): React.ReactNode {
54
+ if (!React.isValidElement<{ onClick?: unknown; onClickCapture?: unknown }>(children)) {
55
+ return children;
56
+ }
57
+ return React.cloneElement(children, { onClick: undefined, onClickCapture: undefined });
58
+ }
@@ -0,0 +1,105 @@
1
+ import type { Meta, StoryObj } from '@storybook/react-vite';
2
+ import { expect, fn, userEvent, within } from 'storybook/test';
3
+ import { HeadingGroup } from '../components/heading-group';
4
+ import { Table, createTableColumnHelper, type TableEmptyState } from '../components/table';
5
+ import { componentDoc } from '../storybook/componentDoc';
6
+ import { tableEmptyIllustration } from '../storybook/illustrations';
7
+
8
+ /**
9
+ * The first-use region state of a list (spec/06-patterns/empty-states.md § Region state):
10
+ * no record of this kind exists yet, so the Table keeps its header, drops its footer and
11
+ * puts the one create action where the rows would be. The package has no EmptyState
12
+ * component; the region state is the Table's own `emptyState`. The page header carries no
13
+ * create action of its own here, because the empty state already does (table manifest
14
+ * `chrome.page-header`): one state, one button.
15
+ */
16
+
17
+ interface Contact {
18
+ id: string;
19
+ name: string;
20
+ email: string;
21
+ }
22
+
23
+ const col = createTableColumnHelper<Contact>();
24
+
25
+ // Module scope: the Table needs referentially stable columns.
26
+ const COLUMNS = col.columns([
27
+ col.accessor('name', {
28
+ id: 'name',
29
+ header: 'Název',
30
+ meta: { width: 360, flex: { min: 160 }, identity: true, locked: true, sortable: false },
31
+ }),
32
+ col.accessor('email', { id: 'email', header: 'E‑mail', meta: { width: 320, flex: { min: 180 }, sortable: false } }),
33
+ ]);
34
+
35
+ const NO_CONTACTS: Contact[] = [];
36
+ const ALWAYS_UNSORTED: never[] = [];
37
+
38
+ interface ContactListEmptyProps {
39
+ onCreate: () => void;
40
+ }
41
+
42
+ function ContactListEmpty({ onCreate }: ContactListEmptyProps) {
43
+ const emptyState: TableEmptyState = {
44
+ kind: 'empty',
45
+ illustration: tableEmptyIllustration('empty'),
46
+ title: 'Zatím tu nejsou žádné kontakty',
47
+ action: { label: 'Vytvořit kontakt', icon: 'user-plus', onClick: onCreate },
48
+ };
49
+ return (
50
+ // The gap from the page title to the list is not set by any manifest; --space-900
51
+ // (the form page's H1 → first block gap) stands in.
52
+ <div className="flex flex-col gap-900">
53
+ <HeadingGroup level={1} heading="Kontakty" />
54
+ <Table<Contact>
55
+ caption="Kontakty"
56
+ columns={COLUMNS}
57
+ data={NO_CONTACTS}
58
+ getRowId={row => row.id}
59
+ // Required by the Table even when no column sorts.
60
+ sorting={ALWAYS_UNSORTED}
61
+ onSortingChange={() => undefined}
62
+ emptyState={emptyState}
63
+ />
64
+ </div>
65
+ );
66
+ }
67
+
68
+ const meta = {
69
+ title: 'Recipes/Empty state',
70
+ component: ContactListEmpty,
71
+ args: { onCreate: fn() },
72
+ parameters: {
73
+ layout: 'padded',
74
+ controls: { disable: true },
75
+ docs: {
76
+ description: {
77
+ component: componentDoc({
78
+ summary:
79
+ 'The first-use state of a list: the Table keeps its header and shows its `empty` state with the one Primary create action in place of the rows. A recipe, not a component: nothing here is exported from the package.',
80
+ docsLink: { label: 'spec/06-patterns/empty-states.md' },
81
+ }),
82
+ },
83
+ },
84
+ },
85
+ } satisfies Meta<typeof ContactListEmpty>;
86
+
87
+ export default meta;
88
+
89
+ type Story = StoryObj<typeof meta>;
90
+
91
+ /** The header stays, the empty state names the entity, and its one button is the create action. */
92
+ export const FirstUse: Story = {
93
+ name: 'First use',
94
+ play: async ({ canvasElement, args }) => {
95
+ const canvas = within(canvasElement);
96
+ await expect(canvas.getByRole('columnheader', { name: 'Název' })).toBeVisible();
97
+ await expect(canvas.getByText('Zatím tu nejsou žádné kontakty')).toBeVisible();
98
+ // One state, one button: the create action is the only button on the page.
99
+ const buttons = canvas.getAllByRole('button');
100
+ await expect(buttons).toHaveLength(1);
101
+ await expect(buttons[0]).toHaveAccessibleName('Vytvořit kontakt');
102
+ await userEvent.click(buttons[0]);
103
+ await expect(args.onCreate).toHaveBeenCalledTimes(1);
104
+ },
105
+ };