@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,593 @@
1
+ import * as React from 'react';
2
+ import type { Meta, StoryObj } from '@storybook/react-vite';
3
+ import { Button } from '../button/Button';
4
+ import { Divider } from '../divider/Divider';
5
+ import { AnchoredPanel } from './AnchoredPanel';
6
+ import { ListRow } from '../list-row/ListRow';
7
+ import { TextLink } from '../text-link/TextLink';
8
+ import {
9
+ useAnchoredPanel,
10
+ type AnchoredFocusModel,
11
+ type AnchoredPanelRole,
12
+ type AnchoredPanelSize,
13
+ type AnchoredWidthPolicy,
14
+ } from '../../internal/useAnchoredPanel';
15
+ import { popoverSurfaceVariants, popoverBodyClass } from '../../internal/popoverSurface';
16
+ import { Icon } from '../icon/Icon';
17
+ import { Section, Showcase } from '../../storybook/Section';
18
+ import { componentDoc } from '../../storybook/componentDoc';
19
+ import { a11yRulesOff } from '../../storybook/a11y';
20
+
21
+ // =============================================================================
22
+ // AnchoredPanel — the shared panel SUBSTRATE (behaviour hook + composition
23
+ // helper), not a design-system entity: no manifest, no Figma node, no variants.
24
+ // It applies the `popoverSurface` chrome recipe to a portalled, positioned panel
25
+ // so every organism in the family stops re-typing the same nested divs.
26
+ //
27
+ // These stories exercise the substrate on its own — by default an
28
+ // arbitrary-content panel (`role="dialog"`), which is the case that has no
29
+ // organism yet; the Playground and the Matrix drive the other three pairings as
30
+ // well. The two real organisms are documented separately: Menu (role=menu,
31
+ // roving focus) and Select (role=listbox, virtual focus).
32
+ // =============================================================================
33
+
34
+ // -----------------------------------------------------------------------------
35
+ // Axes.
36
+ //
37
+ // The substrate has NO manifest and deliberately no `variant` axis, so the axes
38
+ // below are the ones the upstream prose defines instead: `popover-patterns.md`
39
+ // § Filling rules gives the chrome frames a panel may carry and § One density per
40
+ // panel the density, `overlay-behavior.md` § Positioning / § Focus give the three
41
+ // behaviour axes the organism has to choose. The Matrix story renders all of
42
+ // them; nothing here is a hand-picked sample.
43
+ // -----------------------------------------------------------------------------
44
+
45
+ const SIZES = ['md', 'sm'] as const;
46
+ const CHROME = ['none', 'header', 'footer', 'both'] as const;
47
+ const ROLES = ['menu', 'listbox', 'group', 'dialog'] as const;
48
+ const FOCUS_MODELS = ['virtual', 'roving'] as const;
49
+ const WIDTH_POLICIES = ['trigger', 'content'] as const;
50
+ const PLACEMENTS = [
51
+ 'bottom-start',
52
+ 'bottom',
53
+ 'bottom-end',
54
+ 'top-start',
55
+ 'top',
56
+ 'top-end',
57
+ 'right-start',
58
+ 'left-start',
59
+ ] as const;
60
+
61
+ /**
62
+ * Which chrome frames the panel carries. Not a prop of its own — `header` and
63
+ * `footer` are `ReactNode`s, and this axis names the four ways they combine.
64
+ */
65
+ type Chrome = (typeof CHROME)[number];
66
+ type Placement = (typeof PLACEMENTS)[number];
67
+
68
+ const SIZE_LABEL: Record<AnchoredPanelSize, string> = {
69
+ md: 'Medium — rows 40',
70
+ sm: 'Small — rows 36',
71
+ };
72
+
73
+ /** The Sizes story's trigger text, which also names the panel — Czech UI copy. */
74
+ const SIZE_TRIGGER: Record<AnchoredPanelSize, string> = {
75
+ md: 'Střední panel',
76
+ sm: 'Malý panel',
77
+ };
78
+
79
+ const CHROME_LABEL: Record<Chrome, string> = {
80
+ none: 'Body only',
81
+ header: 'Header + body',
82
+ footer: 'Body + footer',
83
+ both: 'Header + body + footer',
84
+ };
85
+
86
+ /**
87
+ * The row role per panel role. A `group` / `dialog` panel holds arbitrary
88
+ * content, so its rows stay role-free — the substrate contributes no semantics
89
+ * and neither does an arbitrary-content panel.
90
+ */
91
+ const ROW_ROLE: Record<AnchoredPanelRole, 'menuitem' | 'option' | undefined> = {
92
+ menu: 'menuitem',
93
+ listbox: 'option',
94
+ group: undefined,
95
+ dialog: undefined,
96
+ };
97
+
98
+ /**
99
+ * The four pairings the spec sanctions. `role`, `focusModel` and `widthPolicy`
100
+ * are not free axes of one another: a field trigger must KEEP DOM focus
101
+ * (`virtual`) and must not be narrower than the field (`trigger`), while a
102
+ * command menu must TAKE focus (`roving`) and has no trigger width worth filling
103
+ * (`content`). The Matrix therefore renders the pairings, not the 4 × 2 × 2
104
+ * cartesian product of widgets that could not exist.
105
+ */
106
+ const PAIRINGS: ReadonlyArray<{
107
+ role: AnchoredPanelRole;
108
+ focusModel: AnchoredFocusModel;
109
+ widthPolicy: AnchoredWidthPolicy;
110
+ organism: string;
111
+ /** The trigger's text, which also names the panel — Czech UI copy. */
112
+ trigger: string;
113
+ }> = [
114
+ { role: 'menu', focusModel: 'roving', widthPolicy: 'content', organism: 'Menu — commands', trigger: 'Akce' },
115
+ { role: 'listbox', focusModel: 'virtual', widthPolicy: 'trigger', organism: 'Select / Combobox', trigger: 'Měna' },
116
+ { role: 'group', focusModel: 'virtual', widthPolicy: 'content', organism: 'Filter popover', trigger: 'Stav' },
117
+ { role: 'dialog', focusModel: 'roving', widthPolicy: 'content', organism: 'Arbitrary content', trigger: 'Můj účet' },
118
+ ];
119
+
120
+ const ROWS = ['Faktury', 'Kontakty', 'Nastavení', 'Reporty'];
121
+
122
+ const LONG_ROWS = Array.from({ length: 20 }, (_, i) => `Položka ${i + 1}`);
123
+
124
+ /** A longer, typeahead-friendly pool behind the Playground's row-count control. */
125
+ const PLAYGROUND_ROWS = [
126
+ 'Faktury',
127
+ 'Kontakty',
128
+ 'Nastavení',
129
+ 'Reporty',
130
+ 'Sklad',
131
+ 'Šablony',
132
+ 'Uživatelé',
133
+ 'Exporty',
134
+ 'Archiv',
135
+ 'Účetnictví',
136
+ 'Banka',
137
+ 'Předplatné',
138
+ ];
139
+
140
+ /** Leading glyph per group — the second group is the "settings" group. */
141
+ const GROUP_ICON = ['file-text', 'gear'] as const;
142
+
143
+ /**
144
+ * Rows are split into two groups (first three, then the rest) so the full-bleed
145
+ * `Divider` between them is always part of the anatomy on show.
146
+ */
147
+ const groupsOf = (rows: string[]): string[][] =>
148
+ rows.length > 3 ? [rows.slice(0, 3), rows.slice(3)] : [rows];
149
+
150
+ // The chrome link is a real `TextLink` atom — never a hand-styled span, and never a
151
+ // `ListRow`: a row is padL 12 at min-height 40 with a hover wash, while a chrome
152
+ // frame is padL 16 / padY 8, and both land on the same 16px content column.
153
+ const ChromeHeader = () => (
154
+ <div className="flex flex-col gap-100 px-600 py-400">
155
+ <span className="text-body-sm font-semibold text-text-primary">Můj účet</span>
156
+ <TextLink href="#" variant="strong" size="sm">
157
+ Spravovat tarif
158
+ </TextLink>
159
+ </div>
160
+ );
161
+
162
+ // The panel adds the footer's top divider itself — chrome seams are the
163
+ // surface's, not the caller's.
164
+ const ChromeFooter = () => (
165
+ <div className="px-600 py-400">
166
+ {/* No `href` — signing out is an in-page action, so the atom renders a `<button>`. */}
167
+ <TextLink variant="strong" size="sm">
168
+ Odhlásit se
169
+ </TextLink>
170
+ </div>
171
+ );
172
+
173
+ interface SubstratePanelProps {
174
+ label: string;
175
+ rows: string[];
176
+ chrome?: Chrome;
177
+ size?: AnchoredPanelSize;
178
+ role?: AnchoredPanelRole;
179
+ focusModel?: AnchoredFocusModel;
180
+ widthPolicy?: AnchoredWidthPolicy;
181
+ placement?: Placement;
182
+ typeahead?: boolean;
183
+ /** Initial open state — only the Playground drives this from a control. */
184
+ open?: boolean;
185
+ }
186
+
187
+ /** A minimal arbitrary-content panel built straight on the substrate. */
188
+ const SubstratePanel = ({
189
+ label,
190
+ rows,
191
+ chrome = 'none',
192
+ size = 'md',
193
+ // Arbitrary content — the organism (here: this story) owns the semantics.
194
+ role = 'dialog',
195
+ focusModel = 'roving',
196
+ widthPolicy = 'content',
197
+ placement = 'bottom-start',
198
+ typeahead = true,
199
+ open: openArg = false,
200
+ }: SubstratePanelProps) => {
201
+ const [open, setOpen] = React.useState(openArg);
202
+ // Follow the Playground control; every other story mounts closed and stays so.
203
+ React.useEffect(() => setOpen(openArg), [openArg]);
204
+
205
+ const panel = useAnchoredPanel({
206
+ open,
207
+ onOpenChange: setOpen,
208
+ role,
209
+ focusModel,
210
+ widthPolicy,
211
+ itemCount: rows.length,
212
+ labels: rows,
213
+ typeahead,
214
+ placement,
215
+ });
216
+
217
+ const rowRole = ROW_ROLE[role];
218
+ const groups = groupsOf(rows);
219
+
220
+ return (
221
+ // Reserve room for the opened panel — it is absolutely positioned, so without
222
+ // this it covers the next section of the docs page. Token-derived, no raw px.
223
+ <div className="flex items-start" style={{ minHeight: 'calc(var(--space-1200) * 7)' }}>
224
+ <Button
225
+ ref={panel.refs.setReference}
226
+ variant="secondary"
227
+ // The `listbox` pairing turns the trigger into `role="combobox"`, a role that
228
+ // takes no name from its content, so the visible text is repeated as its name
229
+ // (the shipped Select gets it from Field's <label> instead).
230
+ aria-label={role === 'listbox' ? label : undefined}
231
+ {...panel.getReferenceProps()}
232
+ >
233
+ {label}
234
+ </Button>
235
+
236
+ <AnchoredPanel
237
+ panel={panel}
238
+ size={size}
239
+ focusModel={focusModel}
240
+ // `group` is the one role floating-ui does not wire, so the caller sets it
241
+ // through `panelProps` — exactly what the spec asks the organism to do.
242
+ panelProps={
243
+ role === 'group' ? { role: 'group', 'aria-label': label } : { 'aria-label': label }
244
+ }
245
+ header={chrome === 'header' || chrome === 'both' ? <ChromeHeader /> : undefined}
246
+ footer={chrome === 'footer' || chrome === 'both' ? <ChromeFooter /> : undefined}
247
+ >
248
+ {groups.map((group, groupIndex) => {
249
+ const offset = groupIndex === 0 ? 0 : groups[0].length;
250
+ return (
251
+ <React.Fragment key={group[0]}>
252
+ {/* A plain divider is a BODY SIBLING at 0 inset — full-bleed. */}
253
+ {groupIndex > 0 && <Divider variant="line" />}
254
+
255
+ {/* No role on the row-group wrapper: a `group` role is earned by
256
+ its name, and nothing here names it (overlay-behavior.md § A
257
+ group role is earned by its name). It is the --space-200 inset
258
+ frame, i.e. geometry. Setting it unnamed was two a11y-floor
259
+ blockers on this very Playground. */}
260
+ <AnchoredPanel.Group>
261
+ {group.map((row, i) => {
262
+ const index = offset + i;
263
+ return (
264
+ <ListRow
265
+ key={row}
266
+ ref={(node) => {
267
+ panel.listRef.current[index] = node;
268
+ }}
269
+ role={rowRole}
270
+ aria-selected={rowRole === 'option' ? false : undefined}
271
+ size={size}
272
+ highlighted={panel.activeIndex === index}
273
+ // A ListRow is a div: in the roving model exactly one row may
274
+ // be tabbable, and that is the active one.
275
+ tabIndex={
276
+ focusModel === 'roving' ? (panel.activeIndex === index ? 0 : -1) : undefined
277
+ }
278
+ leading={<Icon name={GROUP_ICON[groupIndex] ?? 'gear'} />}
279
+ {...panel.getItemProps()}
280
+ >
281
+ {row}
282
+ </ListRow>
283
+ );
284
+ })}
285
+ </AnchoredPanel.Group>
286
+ </React.Fragment>
287
+ );
288
+ })}
289
+ </AnchoredPanel>
290
+ </div>
291
+ );
292
+ };
293
+
294
+ /**
295
+ * One Matrix cell — the panel anatomy rendered INLINE, without the portal.
296
+ *
297
+ * `AnchoredPanel` always renders through `FloatingPortal` and floating-ui
298
+ * positions it against a live trigger, so eight open panels in one grid would
299
+ * cover one another, fight over initial focus on mount, and all dismiss together
300
+ * on the first outside click: the grid could not be read at all. Each cell
301
+ * therefore composes the SAME parts the component composes, in the same order
302
+ * (`popoverSurfaceVariants` surface → `popoverBodyClass` body →
303
+ * `AnchoredPanel.Group` → the header / footer `Divider variant="line"` seams),
304
+ * only anchored in the flow. No class is re-declared and no token restated, so a
305
+ * token change reaches this grid and the live panel in Anatomy at the same time.
306
+ */
307
+ const PanelMirror = ({
308
+ size,
309
+ chrome,
310
+ rows,
311
+ }: {
312
+ size: AnchoredPanelSize;
313
+ chrome: Chrome;
314
+ rows: string[];
315
+ }) => {
316
+ const groups = groupsOf(rows);
317
+
318
+ return (
319
+ // role="none" on both chrome wrappers, exactly as AnchoredPanel does it, so
320
+ // the rows stay owned children of whatever role the organism sets.
321
+ <div className={popoverSurfaceVariants({ size, className: 'w-[calc(var(--space-1100)*6)]' })} role="none">
322
+ {(chrome === 'header' || chrome === 'both') && (
323
+ <>
324
+ <ChromeHeader />
325
+ <Divider variant="line" />
326
+ </>
327
+ )}
328
+
329
+ <div className={popoverBodyClass} role="none">
330
+ {groups.map((group, groupIndex) => (
331
+ <React.Fragment key={group[0]}>
332
+ {groupIndex > 0 && <Divider variant="line" />}
333
+ <AnchoredPanel.Group>
334
+ {group.map(row => (
335
+ <ListRow
336
+ key={row}
337
+ size={size}
338
+ leading={<Icon name={GROUP_ICON[groupIndex] ?? 'gear'} />}
339
+ >
340
+ {row}
341
+ </ListRow>
342
+ ))}
343
+ </AnchoredPanel.Group>
344
+ </React.Fragment>
345
+ ))}
346
+ </div>
347
+
348
+ {(chrome === 'footer' || chrome === 'both') && (
349
+ <>
350
+ <Divider variant="line" />
351
+ <ChromeFooter />
352
+ </>
353
+ )}
354
+ </div>
355
+ );
356
+ };
357
+
358
+ const meta = {
359
+ title: 'Design System/Patterns/Anchored Panel',
360
+ parameters: {
361
+ layout: 'padded',
362
+ docs: {
363
+ description: {
364
+ component: componentDoc({
365
+ summary:
366
+ 'The shared anchored-panel SUBSTRATE — `useAnchoredPanel` (positioning, dismissal, focus model, transition, width/height policy) + `AnchoredPanel` (portal + the popover surface chrome recipe applied). NOT a design-system entity: no manifest, no Figma node, and deliberately no `type` / `variant` axis. The ARIA role and keyboard contract always come from the organism on top.',
367
+ useCases: [
368
+ 'Building a new panel in the Menu / Select / Combobox / Popover family',
369
+ 'An arbitrary-content popover (filters, column chooser) that has no organism yet',
370
+ 'Reusing the exact positioning + dismissal behaviour of the shipped Select and Menu',
371
+ ],
372
+ bestPractices: [
373
+ 'Pass `role` + `focusModel` explicitly: `menu` + `roving` for commands, `listbox` + `virtual` for values',
374
+ 'Rows go inside `AnchoredPanel.Group` (the `--space-200` inset); `Divider`s are siblings at 0 inset so they run full-bleed',
375
+ 'Leave the row-group wrapper role-less — a `group` role is earned by its name, and only the multi-select filter (named by its labelled divider) has one',
376
+ 'Header / footer are passed as props — they render OUTSIDE the scroll body and stay sticky',
377
+ 'In the roving model, give each row a `tabIndex` (0 for the active row, -1 otherwise) — a `ListRow` div is not focusable on its own',
378
+ ],
379
+ knownIssues: [
380
+ 'The content-width band (min ~180 / max ~320) has no token yet — the stand-in lives in `useAnchoredPanel`; the soft ~8–10-row scroll cap is `--ds-overlay-max-height`',
381
+ 'Submenus / side flyouts (hover-with-intent + safe triangle, `FloatingTree`) are specced but not wired here yet',
382
+ '`role="group"` PANELS (the filter popover) are not wired by floating-ui — set the role via `panelProps`, together with the name that earns it; the row-group wrapper inside takes no role at all',
383
+ "The Matrix's chrome × density grid renders the anatomy INLINE, not portalled: eight live panels would overlap, fight over focus and dismiss together. The live panel is in Anatomy, ScrollCap, Sizes and the Playground",
384
+ ],
385
+ docsLink: { label: 'spec/06-patterns/popover-patterns.md' },
386
+ }),
387
+ },
388
+ },
389
+ },
390
+ } satisfies Meta;
391
+
392
+ export default meta;
393
+ type Story = StoryObj<typeof meta>;
394
+
395
+ /**
396
+ * Everything the substrate lets a caller decide, as one control set.
397
+ *
398
+ * The Playground is typed off this instead of `typeof meta`: the meta declares no
399
+ * `component` (there is none — the substrate's central prop is a hook return
400
+ * value), so `StoryObj<typeof meta>` has no args to infer and would reject every
401
+ * control below.
402
+ */
403
+ interface PlaygroundArgs {
404
+ size: AnchoredPanelSize;
405
+ role: AnchoredPanelRole;
406
+ focusModel: AnchoredFocusModel;
407
+ widthPolicy: AnchoredWidthPolicy;
408
+ placement: Placement;
409
+ chrome: Chrome;
410
+ typeahead: boolean;
411
+ rowCount: number;
412
+ open: boolean;
413
+ }
414
+
415
+ const PlaygroundDemo = ({ rowCount, ...args }: PlaygroundArgs) => (
416
+ <div className="flex justify-center">
417
+ <SubstratePanel
418
+ {...args}
419
+ label="Otevřít panel"
420
+ rows={PLAYGROUND_ROWS.slice(0, rowCount)}
421
+ />
422
+ </div>
423
+ );
424
+
425
+ export const Playground = {
426
+ parameters: {
427
+ // aria-hidden-focus: the panel opens on mount, and its non-modal
428
+ // FloatingFocusManager (@floating-ui/react) brackets it with zero-size
429
+ // `<span tabindex="0" aria-hidden="true" data-floating-ui-focus-guard>` sentinels
430
+ // that forward focus into the panel or back to the trigger the moment they get it.
431
+ // Never a focus stop and nothing to read, so axe's "hidden but focusable" is a
432
+ // false positive (same exception as the Menu stories).
433
+ a11y: a11yRulesOff('aria-hidden-focus'),
434
+ docs: {
435
+ description: {
436
+ story:
437
+ 'Every knob the substrate exposes, on live controls. The panel is portalled and collision-aware, so move `placement` towards an edge of the canvas and watch it flip. Keep `role` and `focusModel` a sanctioned pair (`menu` + `roving`, `listbox` + `virtual`) — the other combinations are reachable here on purpose, to show what they break.',
438
+ },
439
+ },
440
+ },
441
+ args: {
442
+ size: 'md',
443
+ role: 'menu',
444
+ focusModel: 'roving',
445
+ widthPolicy: 'content',
446
+ placement: 'bottom-start',
447
+ // The default is the sanctioned menu pairing, and a `role="menu"` panel may hold
448
+ // only menuitems, groups and separators: the chrome's link and button would break
449
+ // it (axe aria-required-children). Header / footer chrome stays one control away.
450
+ chrome: 'none',
451
+ typeahead: true,
452
+ rowCount: 6,
453
+ open: true,
454
+ },
455
+ argTypes: {
456
+ size: { control: 'inline-radio', options: SIZES },
457
+ role: { control: 'select', options: ROLES },
458
+ focusModel: { control: 'inline-radio', options: FOCUS_MODELS },
459
+ widthPolicy: { control: 'inline-radio', options: WIDTH_POLICIES },
460
+ placement: { control: 'select', options: PLACEMENTS },
461
+ chrome: { control: 'select', options: CHROME },
462
+ typeahead: { control: 'boolean' },
463
+ rowCount: { control: { type: 'range', min: 1, max: PLAYGROUND_ROWS.length, step: 1 } },
464
+ open: { control: 'boolean' },
465
+ },
466
+ render: args => <PlaygroundDemo {...args} />,
467
+ } satisfies StoryObj<PlaygroundArgs>;
468
+
469
+ export const Matrix: Story = {
470
+ parameters: {
471
+ docs: {
472
+ description: {
473
+ story:
474
+ "The whole matrix, in its two halves. **Chrome × density** is the visual grid — rows = which chrome frames the panel carries, columns = density — rendered inline so every cell is readable at once (the live portalled panel is in Anatomy). **Behaviour pairings** is the other axis triple: the four `role` × `focusModel` × `widthPolicy` combinations the spec sanctions, each a real panel you can open and drive from the keyboard. The substrate owns no Hover / Active / Focus / Disabled of its own — a row's states belong to `ListRow`, and the panel must never render a focus visual.",
475
+ },
476
+ },
477
+ },
478
+ render: () => <MatrixDemo />,
479
+ };
480
+
481
+ const MatrixDemo = () => (
482
+ <Showcase>
483
+ <Section
484
+ title="Chrome × density"
485
+ description="Rows = chrome composition · columns = density. The header's bottom rule and the footer's top rule are added by the panel, never by the caller; the surface padding is a flat --space-200 in both densities, so between the two columns only the row height changes."
486
+ layout="column"
487
+ >
488
+ <div className="grid grid-cols-[max-content_repeat(2,max-content)] items-start gap-x-800 gap-y-600">
489
+ <span />
490
+ {SIZES.map(size => (
491
+ <span key={size} className="text-body-sm font-semibold text-text-primary">
492
+ {SIZE_LABEL[size]}
493
+ </span>
494
+ ))}
495
+
496
+ {CHROME.map(chrome => (
497
+ <React.Fragment key={chrome}>
498
+ <span className="self-center text-body-sm font-semibold text-text-secondary">
499
+ {CHROME_LABEL[chrome]}
500
+ </span>
501
+ {SIZES.map(size => (
502
+ <PanelMirror key={size} size={size} chrome={chrome} rows={ROWS} />
503
+ ))}
504
+ </React.Fragment>
505
+ ))}
506
+ </div>
507
+ </Section>
508
+
509
+ <Section
510
+ title="Behaviour pairings — role × focusModel × widthPolicy"
511
+ description="Open each one: the menu moves focus into the panel, the listbox keeps it on the trigger and fills the trigger's width, the filter popover sets its own role through panelProps, the dialog is the arbitrary-content case that has no organism yet."
512
+ layout="row"
513
+ >
514
+ {PAIRINGS.map(pairing => (
515
+ <div key={pairing.role} className="flex flex-col gap-200">
516
+ <span className="text-body-sm font-semibold text-text-primary">
517
+ {pairing.role} · {pairing.focusModel} · {pairing.widthPolicy}
518
+ </span>
519
+ <span className="text-body-xs text-text-secondary">{pairing.organism}</span>
520
+ <SubstratePanel
521
+ label={pairing.trigger}
522
+ rows={ROWS}
523
+ role={pairing.role}
524
+ focusModel={pairing.focusModel}
525
+ widthPolicy={pairing.widthPolicy}
526
+ />
527
+ </div>
528
+ ))}
529
+ </Section>
530
+ </Showcase>
531
+ );
532
+
533
+ export const Anatomy: Story = {
534
+ parameters: {
535
+ docs: {
536
+ description: {
537
+ story:
538
+ 'A live panel on the substrate. Header and footer sit outside the scroll region (sticky by construction); the body holds two groups split by a full-bleed divider. Open it and press Esc — focus returns to the trigger.',
539
+ },
540
+ },
541
+ },
542
+ render: () => (
543
+ <Showcase>
544
+ <Section title="Bare panel — body only" layout="column">
545
+ <SubstratePanel label="Otevřít panel" rows={ROWS} />
546
+ </Section>
547
+ <Section title="With header + footer chrome" layout="column">
548
+ <SubstratePanel label="Můj účet" rows={ROWS} chrome="both" />
549
+ </Section>
550
+ </Showcase>
551
+ ),
552
+ };
553
+
554
+ export const ScrollCap: Story = {
555
+ parameters: {
556
+ docs: {
557
+ description: {
558
+ story:
559
+ 'Past the soft ~8–10-row cap the BODY scrolls — the panel never grows past the viewport and the page behind does not scroll. With header/footer chrome, only the body moves.',
560
+ },
561
+ },
562
+ },
563
+ render: () => (
564
+ <Showcase>
565
+ <Section title="20 rows — body scrolls, panel is capped" layout="column">
566
+ <SubstratePanel label="Dlouhý seznam" rows={LONG_ROWS} />
567
+ </Section>
568
+ <Section title="20 rows + sticky header / footer" layout="column">
569
+ <SubstratePanel label="Dlouhý seznam se záhlavím a zápatím" rows={LONG_ROWS} chrome="both" />
570
+ </Section>
571
+ </Showcase>
572
+ ),
573
+ };
574
+
575
+ export const Sizes: Story = {
576
+ parameters: {
577
+ docs: {
578
+ description: {
579
+ story:
580
+ 'Density drives the row height (40 / 36). It no longer drives the surface padding — that is a flat `--space-200` in both densities. One density per panel; it tracks the trigger that opened it.',
581
+ },
582
+ },
583
+ },
584
+ render: () => (
585
+ <Showcase>
586
+ {SIZES.map(size => (
587
+ <Section key={size} title={SIZE_LABEL[size]} layout="column">
588
+ <SubstratePanel label={SIZE_TRIGGER[size]} rows={ROWS} size={size} />
589
+ </Section>
590
+ ))}
591
+ </Showcase>
592
+ ),
593
+ };