@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,527 @@
1
+ import * as React from 'react';
2
+ import type { Decorator, Meta, StoryObj } from '@storybook/react-vite';
3
+ import { Hero, type HeroSurface } from './Hero';
4
+ import { Button } from '../button/Button';
5
+ import { componentDoc } from '../../storybook/componentDoc';
6
+ import invoiceImage from '../../storybook/assets/invoice-hero.webp';
7
+
8
+ /** `axes.variant` — the Visual axis. Named VISUALS, not VARIANTS, because the axis is Visual. */
9
+ const VISUALS = ['on', 'off'] as const;
10
+
11
+ /** `axes.surface` of the plaque, passed through to `<PromoSurface>` (`chrome.ink` pairs the ink). */
12
+ const SURFACES = ['brand', 'utility', 'solid', 'inverse'] as const;
13
+
14
+ const ACTIONS_WIDTHS = ['narrow', 'medium'] as const;
15
+
16
+ /**
17
+ * `axes.breakpoint` — the sizing axis (`intent.sizing`: "Breakpoint IS the sizing").
18
+ *
19
+ * The widths below are the band MINIMUMS from `spec/02-tokens/layout-tokens.md`
20
+ * (`layout/breakpoint/min-width`: XL 1280 · LG 1024 · MD 768 · SM 640 · Mobile 0), NOT the
21
+ * Figma artboard widths (1270 · 960 · 720 · 600 · 390). That distinction is the whole
22
+ * reason this table exists:
23
+ *
24
+ * A viewport of exactly 600px — the SM artboard width — is BELOW Tailwind's `sm:` (640),
25
+ * so it would render the Mobile composition and the story would quietly document the
26
+ * wrong cell. Set the viewport to the band minimum instead and the container cap does the
27
+ * rest: at 640 the container clamps to `--ds-container-sm` (600), at 768 to 720, at 1024
28
+ * to 960, at 1280 to the 1270 hard cap. Each viewport therefore reproduces its Figma
29
+ * artboard exactly — which also makes these stories a live check of the whole ladder.
30
+ *
31
+ * The cap lives on `meta.decorators`, not on the Hero root: the width ladder and the side
32
+ * gutter are the PAGE container (layout-system.md), which the consuming page supplies and
33
+ * which here has to be modelled, because Storybook renders the component on a bare canvas.
34
+ */
35
+ const BREAKPOINTS = ['XL', 'LG', 'MD', 'SM', 'Mobile'] as const;
36
+
37
+ /** Band minimum, and the width the container cap produces there. */
38
+ const BREAKPOINT_BAND: Record<(typeof BREAKPOINTS)[number], { min: number; caps: string; height: number }> = {
39
+ XL: { min: 1280, caps: '1270 hard cap', height: 700 },
40
+ LG: { min: 1024, caps: '960', height: 700 },
41
+ MD: { min: 768, caps: '720', height: 1000 },
42
+ SM: { min: 640, caps: '600', height: 900 },
43
+ Mobile: { min: 390, caps: 'fluid', height: 900 },
44
+ };
45
+
46
+ /** One Storybook viewport per BREAKPOINTS entry, derived so the two can never drift apart. */
47
+ const HERO_VIEWPORTS = Object.fromEntries(
48
+ BREAKPOINTS.map(bp => [
49
+ bp,
50
+ {
51
+ name: `${bp} · ${BREAKPOINT_BAND[bp].min} → ${BREAKPOINT_BAND[bp].caps}`,
52
+ styles: { width: `${BREAKPOINT_BAND[bp].min}px`, height: `${BREAKPOINT_BAND[bp].height}px` },
53
+ },
54
+ ]),
55
+ );
56
+
57
+ /** The default copy from the manifest's `properties[]`, verbatim. */
58
+ const COPY = {
59
+ kicker: 'Rychle. Jednoduše. Zdarma.',
60
+ heading: 'Faktura online za 30\u00a0sekund',
61
+ body: 'Tady vidíte, jak má správná faktura vypadat.',
62
+ } as const;
63
+
64
+ /**
65
+ * The Actions slot takes ONE block, not a row of loose buttons (`slots.actions`) — the
66
+ * block owns its own internal rhythm, so Hero never has to know whether it holds two
67
+ * buttons or a search field.
68
+ *
69
+ * It DOES have to know the surface, though, and that is not a story convenience — it is
70
+ * a RULE. `intent.rules`: on a dark plaque the Actions slot carries one filled Brand CTA
71
+ * and no secondary action. Button has eight families and not one of them is built for a
72
+ * dark ground: `Secondary` and `Tertiary` both label with `--secondary` (blue/700), which
73
+ * measures 1.33:1 on `--secondary-solid` and 1.59:1 on `--bg-inverse` — the label vanishes
74
+ * and only the border survives.
75
+ *
76
+ * And none is coming. `spec/06-patterns/inverse-surface.md` records the stance as canon:
77
+ * "compose instead of recolouring... If a real consumer ever needs a full outlined-white
78
+ * button family, that is a new proposal against this pattern, not a silent extension."
79
+ * A quieter action beside the CTA exists only on `--bg-inverse` chrome and is a Text Link
80
+ * on the inverse recipe, never a button; on `--secondary-solid` no quiet text action
81
+ * passes AA at all. It is the same rule Banner holds on its own dark surface
82
+ * (`banner.manifest.json` `slots.actions`: one Brand Button by default, and Surface=Solid
83
+ * takes no second action).
84
+ */
85
+ function ActionsBlock({ surface = 'brand' }: { surface?: HeroSurface }) {
86
+ const onDark = surface === 'solid' || surface === 'inverse';
87
+
88
+ /*
89
+ * On a dark plaque the consumer — not Hero — binds --outline-focus-inverse.
90
+ * `inverse-surface.md` § Focus is absolute about it ("Every control on a dark
91
+ * surface binds --outline-focus-inverse"), and hero.manifest.json intent.rules[6]
92
+ * puts the obligation on whatever fills Actions, because Hero owns no focusable
93
+ * element of its own. Button carries no inverse branch — upstream gives it no
94
+ * Surface=Inverse variants on purpose — so the swap arrives through className,
95
+ * which tailwind-merge resolves in favour of the later outline colour.
96
+ *
97
+ * Without it the ring is invisible on Solid: --outline-focus is the same hex as
98
+ * --secondary-solid (1:1), and 2.12:1 on --bg-inverse. axe does not report it.
99
+ * It must be `outline-*`, never `ring-*` — the floor wants an additive offset
100
+ * outline, and a ring is a box-shadow that would sit alongside the real one.
101
+ */
102
+ const inverseFocus = onDark ? 'focus-visible:outline-outline-focus-inverse' : undefined;
103
+
104
+ return (
105
+ <>
106
+ <Button variant="brand" size="lg" className={inverseFocus}>
107
+ Vytvořit fakturu
108
+ </Button>
109
+ {/* slots.actions (1.4.0): the second action is Tertiary with Show surface off. */}
110
+ {!onDark && (
111
+ <Button variant="tertiary" size="lg">Prohlédnout vzor</Button>
112
+ )}
113
+ </>
114
+ );
115
+ }
116
+
117
+ /*
118
+ * The page container Hero sits in. The consuming page supplies it and every page has
119
+ * one; Hero itself carries only its vertical band, because the width ladder
120
+ * and the side gutter belong to the layout layer (`container.note` hands the code
121
+ * equivalent to layout-system.md). Storybook renders the story on a bare canvas, so the
122
+ * container is modelled here — same ladder, same gutter, which is what keeps the
123
+ * breakpoint stories below measuring their Figma artboards.
124
+ *
125
+ * Typed as `Decorator` rather than left inline: an untyped callback in `meta.decorators`
126
+ * collapses the `satisfies Meta<typeof Hero>` inference and every `StoryObj<typeof meta>`
127
+ * below it resolves its args to `never`.
128
+ */
129
+ const pageContainer: Decorator = Story => (
130
+ <div className="mx-auto w-full px-600 sm:max-w-container-sm sm:px-800 md:max-w-container-md md:px-900 lg:max-w-container-lg lg:px-1000 xl:max-w-container-xl">
131
+ <Story />
132
+ </div>
133
+ );
134
+
135
+ const heroImage = <img src={invoiceImage} alt="Vzor vyplněné faktury s rozpisem položek a součtem" />;
136
+
137
+ const meta = {
138
+ title: 'Design System/Organisms/Hero',
139
+ component: Hero,
140
+ decorators: [pageContainer],
141
+ parameters: {
142
+ layout: 'fullscreen',
143
+ viewport: { options: HERO_VIEWPORTS },
144
+ docs: {
145
+ description: {
146
+ component: componentDoc({
147
+ summary:
148
+ "The first-screen panel of a public page — a promo plaque carrying the page's single claim, at most two actions and, where the page has one, one image. It owns no chrome: the fill, pattern and veil are delegated whole to PromoSurface, rendered as an absolutely positioned sibling behind the content.",
149
+ useCases: [
150
+ 'The top of a landing page, the homepage, the news index or the register search — never an in-app card, section or callout.',
151
+ '`visual="on"` puts the image beside the copy at LG/XL and stacks it below at MD/SM/Mobile. `visual="off"` is the deliberate **centred** composition.',
152
+ '`surface` picks the plaque tone; Hero pairs the matching ink with it automatically (`chrome.ink`).',
153
+ 'The four slots take one component each: `formatIcon`, `actions`, `image`, `sub`.',
154
+ ],
155
+ bestPractices: [
156
+ 'The heading renders as the page `<h1>`, so there is exactly one Hero per page. The kicker is a plain line above it, never a heading itself.',
157
+ 'Give the image real alternative text describing the page claim visually — not a filename, not `alt=""`.',
158
+ '`actions` is one block. Whatever fills it owns its own internal spacing and its own focus behaviour.',
159
+ '`sub` sits outside the plaque fill — it is page chrome, so it does not inherit the panel radius, background or ink.',
160
+ 'On `surface="solid"` and `"inverse"`, anything focusable inside `actions` must bind `--outline-focus-inverse`; Hero does not supply it.',
161
+ ],
162
+ knownIssues: [
163
+ '`visual` has **no default** on purpose. An empty image slot is not a centred hero — `visual="off"` is built centred from the start, and the discriminated union makes TypeScript enforce the choice.',
164
+ '`visual="on"` renders **two** PromoSurface instances, swapped by visibility at `lg`. PromoSurface turns `layout` into inline custom properties for the veil geometry, and an inline style cannot carry a media query, so one instance can never be responsive.',
165
+ 'The Format icon deliberately overflows the panel edge at LG/XL — 20 px at LG, 19 px at XL. `notes[1]` calls the difference intentional variation and forbids equalizing it.',
166
+ '`overflow-hidden` sits on the image slot, not on the panel: the panel must let the Format icon bleed, while the image must be clipped. One clip on the shared ancestor cannot do both.',
167
+ 'The image keeps its ratio, never stretched. Stacked (MD/SM/Mobile) it takes the slot width; side by side (LG/XL) it takes the slot height, anchored bottom-left — a wider graphic is cut on the right by the slot, a narrower one leaves the rest empty (1.4.0 `intent.sizing`).',
168
+ 'Hero has no interaction states of its own (`intent.states`). Whatever lands in the slots owns its hover / focus / active / disabled behaviour.',
169
+ '**One brand CTA on the dark plaques, no secondary action** — now a rule in `intent.rules`, not an open finding. `Secondary` and `Tertiary` label with `--secondary`, which measures **1.33:1** on `--secondary-solid` and **1.59:1** on `--bg-inverse`: the label disappears and only the border survives. No Button family is built for a dark ground and none is coming — the stance is compose, not recolour (`spec/06-patterns/inverse-surface.md`). It is the same rule Banner holds.',
170
+ 'Anything focusable composed into `actions` on `solid` / `inverse` MUST bind `--outline-focus-inverse` — as `focus-visible:outline-outline-focus-inverse`, never `ring-*` (the floor wants an additive offset outline; a ring is a box-shadow that sits alongside the real one). `--outline-focus` is the *same hex* as `--secondary-solid` (1.00:1) and 2.12:1 on `--bg-inverse`, so the default ring is invisible or under the 3:1 floor. Hero cannot supply it: it owns no focusable element — `ActionsBlock` in this file does it instead. Actions-only: `sub` sits outside the plaque fill.',
171
+ ],
172
+ docsLink: {
173
+ label: 'spec/07-web/hero.md',
174
+ },
175
+ }),
176
+ },
177
+ },
178
+ },
179
+ globals: { viewport: { value: 'XL' } },
180
+ argTypes: {
181
+ visual: {
182
+ control: 'inline-radio',
183
+ options: VISUALS,
184
+ description: 'Image beside/below the copy (`on`) or the centred composition (`off`). No default.',
185
+ },
186
+ surface: {
187
+ control: 'inline-radio',
188
+ options: SURFACES,
189
+ description: 'Plaque tone, passed through to PromoSurface. Hero pairs the matching ink.',
190
+ },
191
+ actionsWidth: {
192
+ control: 'inline-radio',
193
+ options: ACTIONS_WIDTHS,
194
+ description:
195
+ 'Width cap on the actions block — `narrow` (580, the measure) for buttons and search, `medium` (786, the non-prose column) for a featured-content card.',
196
+ },
197
+ heading: { control: 'text' },
198
+ kicker: { control: 'text' },
199
+ body: { control: 'text' },
200
+ },
201
+ args: {
202
+ visual: 'on',
203
+ surface: 'brand',
204
+ ...COPY,
205
+ },
206
+ /*
207
+ * The default render lives on the META, not on Playground, and that placement is the
208
+ * fix for a real bug rather than tidiness: `actions` and `image` used to sit in
209
+ * `meta.args`, which meant a story overriding only `surface` still inherited an action
210
+ * block built for the DEFAULT surface. `WithSub` (surface="inverse") therefore shipped
211
+ * a second blue-labelled button on a dark plaque at 1.59:1 — exactly the pairing the block was
212
+ * changed to avoid. Deriving both from the story's own resolved args is the only way a
213
+ * per-story `surface` override can reach them.
214
+ *
215
+ * `image` is discarded from the rest spread because the `visual="off"` arm of the union
216
+ * forbids it (`image?: undefined`): the centred composition is built centred, never an
217
+ * image slot left empty (`intent.rules[1]`). A story may still pass its own `actions`
218
+ * to opt out of the surface-aware block entirely.
219
+ */
220
+ render: ({ surface = 'brand', visual, image: _image, actions, ...rest }) => {
221
+ const block = actions ?? <ActionsBlock surface={surface} />;
222
+
223
+ return visual === 'off' ? (
224
+ <Hero {...rest} visual="off" surface={surface} actions={block} />
225
+ ) : (
226
+ <Hero {...rest} visual="on" surface={surface} image={heroImage} actions={block} />
227
+ );
228
+ },
229
+ // No autodocs tag — Hero.mdx provides the dedicated Docs page.
230
+ } satisfies Meta<typeof Hero>;
231
+
232
+ export default meta;
233
+ type Story = StoryObj<typeof meta>;
234
+
235
+ /**
236
+ * The interactive cell. Switch the viewport in the toolbar to move along the Breakpoint
237
+ * axis, and `surface` to move along the tone axis — the meta render rebuilds the action
238
+ * block from whichever tone is selected, so the control can never show a second action
239
+ * on a dark plaque.
240
+ */
241
+ export const Playground: Story = {};
242
+
243
+ /**
244
+ * Visual (rows) × Surface (columns) — the 8 compositional cells at one viewport.
245
+ *
246
+ * The Breakpoint axis cannot be shown in a grid: Tailwind's responsive prefixes key off
247
+ * the VIEWPORT, not off a wrapper's width, so a row of fixed-width boxes would render
248
+ * every cell at the same breakpoint while looking as though it did not. The five
249
+ * breakpoints therefore get their own stories below, each with its own viewport.
250
+ */
251
+ export const Matrix: Story = {
252
+ parameters: { controls: { disable: true } },
253
+ render: () => (
254
+ <div className="flex flex-col gap-1200 py-800">
255
+ {VISUALS.map(visual => (
256
+ <div key={visual} className="flex flex-col gap-800">
257
+ {/* An <h2>, not an <h3>: it follows the previous row's Hero <h1>, and a level may
258
+ only step down by one. */}
259
+ <h2 className="px-800 text-body-lg font-semibold">visual = {visual}</h2>
260
+ {SURFACES.map(surface => (
261
+ <div key={surface} className="flex flex-col gap-300">
262
+ <p className="px-800 text-body-xs text-text-secondary">surface = {surface}</p>
263
+ {visual === 'on' ? (
264
+ <Hero visual="on" surface={surface} {...COPY} actions={<ActionsBlock surface={surface} />} image={heroImage} />
265
+ ) : (
266
+ <Hero visual="off" surface={surface} {...COPY} actions={<ActionsBlock surface={surface} />} />
267
+ )}
268
+ </div>
269
+ ))}
270
+ </div>
271
+ ))}
272
+ </div>
273
+ ),
274
+ };
275
+
276
+ /**
277
+ * Mobile — one column, image below the copy at full panel width, PromoSurface
278
+ * `layout="top"`. Container gutter 16 (`--space-600`), panel 390 − 32 = 358.
279
+ */
280
+ export const BreakpointMobile: Story = {
281
+ name: 'Breakpoint · Mobile',
282
+ globals: { viewport: { value: 'Mobile' } },
283
+ };
284
+
285
+ /** SM — still stacked; viewport 640 clamps the container to `--ds-container-sm` (600), panel 552. */
286
+ export const BreakpointSM: Story = {
287
+ name: 'Breakpoint · SM',
288
+ globals: { viewport: { value: 'SM' } },
289
+ };
290
+
291
+ /** MD — still stacked; container clamps to 720, panel 656. Format icon still in flow, centred. */
292
+ export const BreakpointMD: Story = {
293
+ name: 'Breakpoint · MD',
294
+ globals: { viewport: { value: 'MD' } },
295
+ };
296
+
297
+ /**
298
+ * LG — the composition flips: text column 480px (a 400 copy + 40 each side) beside the
299
+ * image, PromoSurface `layout="side"`, Format icon hangs 20px over the panel edge. From here
300
+ * up (LG and XL) the image is height-driven and anchored bottom-left: a wider graphic is cut
301
+ * on the right, a narrower one stops short of the slot width (`intent.sizing`, 1.4.0). It
302
+ * sits out of flow, so the text column alone sets the plaque height.
303
+ */
304
+ export const BreakpointLG: Story = {
305
+ name: 'Breakpoint · LG',
306
+ globals: { viewport: { value: 'LG' } },
307
+ };
308
+
309
+ /** XL — text column 639px, panel 1190, Format icon bleed 19px (`notes[1]`). */
310
+ export const BreakpointXL: Story = {
311
+ name: 'Breakpoint · XL',
312
+ globals: { viewport: { value: 'XL' } },
313
+ };
314
+
315
+ /*
316
+ * A stand-in for the real Format icon artwork.
317
+ *
318
+ * `intent.rules[2]` (1.5.0) sizes the slot a SQUARE 48x48 (`--size-illustration-spot` since 1.5.1) at every
319
+ * breakpoint and fits the artwork into it (`object-fit: contain`), never crops it. The
320
+ * slot carries the format's own mark artwork — the square Word / Excel / PDF / Sheets /
321
+ * Docs images a template landing page ships — not an icon glyph;
322
+ * Sheets and Docs are deliberately not being added to the icon set.
323
+ *
324
+ * Drawn inline here rather than imported so the story shows the SHAPE the slot expects
325
+ * without pretending five final assets exist yet.
326
+ */
327
+ function FormatMark({ label }: { label: string }) {
328
+ return (
329
+ <svg viewBox="0 0 48 48" role="presentation" aria-hidden="true">
330
+ {/* Document sheet with a folded corner. */}
331
+ <path
332
+ d="M10.5 2.5h19l8 8v33a2 2 0 0 1-2 2h-25a2 2 0 0 1-2-2v-39a2 2 0 0 1 2-2z"
333
+ fill="var(--bg-primary)"
334
+ stroke="var(--outline-default)"
335
+ />
336
+ <path d="M29.5 2.5v8h8" fill="none" stroke="var(--outline-default)" />
337
+ {[16, 22].map((y, i) => (
338
+ <rect
339
+ key={y}
340
+ x="14"
341
+ y={y}
342
+ width={i === 0 ? 16 : 12}
343
+ height="2.5"
344
+ rx="1.25"
345
+ fill="var(--bg-skeleton)"
346
+ />
347
+ ))}
348
+ {/* Format badge across the lower half, the way Word/Excel/PDF marks label the sheet. */}
349
+ <rect x="4" y="28" width="28" height="12" rx="2" fill="var(--secondary-solid)" />
350
+ <text
351
+ x="18"
352
+ y="36.5"
353
+ textAnchor="middle"
354
+ fontSize="7"
355
+ fontWeight="700"
356
+ fill="var(--secondary-foreground)"
357
+ fontFamily="Inter, sans-serif"
358
+ >
359
+ {label}
360
+ </text>
361
+ </svg>
362
+ );
363
+ }
364
+
365
+ /**
366
+ * The Format icon slot, on for document-format landing pages only (`properties[]`,
367
+ * default false).
368
+ *
369
+ * It is an ARTWORK slot, not a glyph slot: the box is a square 48x48 at every breakpoint,
370
+ * `intent.rules[2]` forbids stretching it, and the slot fits the artwork whole
371
+ * (`object-fit: contain`). What goes in is the format's own mark, not an icon from the
372
+ * font — see `FormatMark` above.
373
+ *
374
+ * At LG/XL it hangs left of the text column and deliberately overflows the panel edge —
375
+ * "not a bug, a signature bleed" (`intent.rules[3]`). At MD/SM/Mobile there is no side
376
+ * margin left to bleed into, so it stays in flow, centred above the kicker.
377
+ */
378
+ export const WithFormatIcon: Story = {
379
+ args: {
380
+ formatIcon: <FormatMark label="PDF" />,
381
+ heading: 'Faktura ve formátu PDF',
382
+ kicker: COPY.kicker,
383
+ body: 'Vzor ke stažení i k vyplnění online.',
384
+ },
385
+ };
386
+
387
+ /**
388
+ * The Sub strip — a format switcher, a figure strip or a progress bar. Off by default;
389
+ * the page opts in.
390
+ *
391
+ * It sits OUTSIDE the Promo Surface fill (`regions.sub.note`: "page chrome, not plaque
392
+ * chrome"), which is why it has no plaque background, no radius and does not inherit the
393
+ * plaque ink — visible here on `surface="inverse"`, where the panel ink is inverted but
394
+ * the strip below it is not.
395
+ */
396
+ export const WithSub: Story = {
397
+ args: {
398
+ surface: 'inverse',
399
+ sub: (
400
+ <div className="flex w-full flex-wrap items-center gap-400">
401
+ <Button variant="tertiary" size="md">PDF</Button>
402
+ <Button variant="tertiary" size="md">Word</Button>
403
+ <Button variant="tertiary" size="md">Excel</Button>
404
+ </div>
405
+ ),
406
+ },
407
+ };
408
+
409
+ /**
410
+ * `visual="off"` — the centred composition. Not "Visual=On with the image removed": the
411
+ * copy is centred and capped at the 580px measure from the start (`intent.rules[1]`), and
412
+ * the panel has no image child at all. PromoSurface switches to `layout="vertical"`, whose
413
+ * veil clears a band down the middle where the copy now sits.
414
+ */
415
+ export const CentredNoVisual: Story = {
416
+ args: { visual: 'off' },
417
+ };
418
+
419
+ /**
420
+ * `motion.enter` (1.5.2) — the entrance, replayable. Kicker → heading → body → CTA fade in
421
+ * one after another (60ms apart), each settling --space-200 up; the image follows and only
422
+ * fades. In a page it plays once, when 30 % of the hero first enters the viewport; here
423
+ * **Přehrát znovu** remounts the hero to run it again. With `prefers-reduced-motion:
424
+ * reduce` (OS setting, or DevTools → Rendering → Emulate CSS media feature) the content
425
+ * is simply there, no fade-up.
426
+ */
427
+ export const Entrance: Story = {
428
+ parameters: { controls: { disable: true } },
429
+ render: function EntranceStory() {
430
+ const [run, setRun] = React.useState(0);
431
+ return (
432
+ <div className="flex flex-col items-start gap-600 py-800">
433
+ <Button variant="secondary" onClick={() => setRun(current => current + 1)}>
434
+ Přehrát znovu
435
+ </Button>
436
+ <Hero
437
+ key={run}
438
+ visual="on"
439
+ {...COPY}
440
+ image={heroImage}
441
+ actions={<ActionsBlock surface="brand" />}
442
+ className="w-full"
443
+ />
444
+ </div>
445
+ );
446
+ },
447
+ };
448
+
449
+ /**
450
+ * The fill / ink pairing, rendered live across all four tones. Mixing one surface's fill
451
+ * with another's ink is the one way this composition fails contrast with no code defect
452
+ * (`hero.md` § Accessibility), so Hero binds the ink from `chrome.ink` itself rather than
453
+ * leaving it to the page.
454
+ */
455
+ export const InkPairing: Story = {
456
+ parameters: { controls: { disable: true } },
457
+ globals: { viewport: { value: 'LG' } },
458
+ render: () => (
459
+ <div className="flex flex-col gap-1200 py-800">
460
+ {SURFACES.map(surface => (
461
+ <Hero
462
+ key={surface}
463
+ visual="off"
464
+ surface={surface}
465
+ kicker={COPY.kicker}
466
+ heading={`Surface ${surface}`}
467
+ body={COPY.body}
468
+ actions={<ActionsBlock surface={surface} />}
469
+ />
470
+ ))}
471
+ </div>
472
+ ),
473
+ };
474
+
475
+ /**
476
+ * `actionsWidth="medium"` — the slot carrying FEATURED CONTENT instead of buttons.
477
+ *
478
+ * `notes[2]` caps `actions` at 580 for all three legal fillings, which is right for a
479
+ * button group or a search field: 580 is `--ds-content-narrow`, the measure. A featured
480
+ * card is the case it does not fit — a featured-content hero fills the slot with a bordered card
481
+ * **786** wide, centred in the 1190 panel, and 786 is `--ds-content-medium`, the
482
+ * non-prose "row and card stacks" column. At `narrow` the card below would clamp to 580
483
+ * and re-centre; switch the control to see it.
484
+ *
485
+ * The card here is deliberately a plain inline block, not a product component: FODS does not
486
+ * ship a Featured Content molecule yet (`hero.backlog[0]`, status `planned`), and a
487
+ * design-system story must not reach into product pages.
488
+ */
489
+ export const ActionsWidthMedium: Story = {
490
+ args: {
491
+ visual: 'off',
492
+ surface: 'utility',
493
+ actionsWidth: 'medium',
494
+ actions: (
495
+ <div className="flex w-full items-center rounded-600 border border-outline-default bg-background-primary text-left shadow-overlay">
496
+ <div className="flex min-w-0 flex-1 flex-col gap-400 p-900">
497
+ <p className="m-0 font-poppins text-heading-h3 font-semibold text-text-primary">
498
+ Přehled cashflow na jednom místě
499
+ </p>
500
+ <p className="m-0 text-body-base text-text-secondary">
501
+ Vizuální dashboard s přehledy příjmů a výdajů za každý měsíc.
502
+ </p>
503
+ </div>
504
+ </div>
505
+ ),
506
+ },
507
+ };
508
+
509
+ /**
510
+ * `bodyHtml` — the lead as rich text from a CMS instead of a plain node.
511
+ *
512
+ * A CMS wraps every `perex` in its own `<p>`, and a `<p>` cannot nest: the HTML parser
513
+ * splits it into siblings, which on a server-rendered page costs the whole SSR tree to a
514
+ * hydration mismatch. So this arm renders the part as a `<div>` and lets the CMS supply the
515
+ * paragraph one level in — same `data-fods-part`, same recipe slot, same Body/XL.
516
+ *
517
+ * It is the design system's only `dangerouslySetInnerHTML`: editorial HTML only, never
518
+ * anything a visitor can write, and the caller owns the sanitising.
519
+ */
520
+ export const BodyFromCms: Story = {
521
+ args: {
522
+ visual: 'off',
523
+ body: undefined,
524
+ bodyHtml:
525
+ '<p>Od 1. 2. 2027 se evidence tržeb vrací pro platby <strong>na místě</strong>, hotově i kartou.</p>',
526
+ },
527
+ };