@invoiceonline/ui-react 0.0.0 → 0.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (731) hide show
  1. package/AGENTS.md +100 -0
  2. package/CHANGELOG.md +149 -0
  3. package/LICENSE +9 -0
  4. package/README.md +77 -1
  5. package/dist/assets/label-brush-1.svg +6 -0
  6. package/dist/assets/pattern-dark.svg +113 -0
  7. package/dist/components/action-row/ActionRow.d.ts +178 -0
  8. package/dist/components/action-row/ActionRow.js +340 -0
  9. package/dist/components/action-row/index.d.ts +2 -0
  10. package/dist/components/action-row/index.js +1 -0
  11. package/dist/components/alert/Alert.d.ts +314 -0
  12. package/dist/components/alert/Alert.js +446 -0
  13. package/dist/components/alert/index.d.ts +2 -0
  14. package/dist/components/alert/index.js +1 -0
  15. package/dist/components/anchored-panel/AnchoredPanel.d.ts +41 -0
  16. package/dist/components/anchored-panel/AnchoredPanel.js +72 -0
  17. package/dist/components/anchored-panel/index.d.ts +3 -0
  18. package/dist/components/anchored-panel/index.js +3 -0
  19. package/dist/components/badge/Badge.d.ts +146 -0
  20. package/dist/components/badge/Badge.js +258 -0
  21. package/dist/components/badge/index.d.ts +2 -0
  22. package/dist/components/badge/index.js +1 -0
  23. package/dist/components/banner/Banner.d.ts +209 -0
  24. package/dist/components/banner/Banner.js +339 -0
  25. package/dist/components/banner/index.d.ts +2 -0
  26. package/dist/components/banner/index.js +1 -0
  27. package/dist/components/button/Button.d.ts +54 -0
  28. package/dist/components/button/Button.js +312 -0
  29. package/dist/components/button/index.d.ts +2 -0
  30. package/dist/components/button/index.js +1 -0
  31. package/dist/components/button-group/ButtonGroup.d.ts +187 -0
  32. package/dist/components/button-group/ButtonGroup.js +217 -0
  33. package/dist/components/button-group/index.d.ts +2 -0
  34. package/dist/components/button-group/index.js +1 -0
  35. package/dist/components/card-select/CardSelect.d.ts +274 -0
  36. package/dist/components/card-select/CardSelect.js +561 -0
  37. package/dist/components/card-select/CardSelectGroup.d.ts +92 -0
  38. package/dist/components/card-select/CardSelectGroup.js +72 -0
  39. package/dist/components/card-select/index.d.ts +3 -0
  40. package/dist/components/card-select/index.js +3 -0
  41. package/dist/components/checkbox/Checkbox.d.ts +104 -0
  42. package/dist/components/checkbox/Checkbox.js +194 -0
  43. package/dist/components/checkbox/index.d.ts +2 -0
  44. package/dist/components/checkbox/index.js +1 -0
  45. package/dist/components/chip/Chip.d.ts +250 -0
  46. package/dist/components/chip/Chip.js +441 -0
  47. package/dist/components/chip/index.d.ts +2 -0
  48. package/dist/components/chip/index.js +1 -0
  49. package/dist/components/column-header/ColumnHeader.d.ts +144 -0
  50. package/dist/components/column-header/ColumnHeader.js +209 -0
  51. package/dist/components/column-header/index.d.ts +2 -0
  52. package/dist/components/column-header/index.js +1 -0
  53. package/dist/components/combobox-field/Combobox.d.ts +104 -0
  54. package/dist/components/combobox-field/Combobox.js +355 -0
  55. package/dist/components/combobox-field/ComboboxField.d.ts +76 -0
  56. package/dist/components/combobox-field/ComboboxField.js +98 -0
  57. package/dist/components/combobox-field/index.d.ts +3 -0
  58. package/dist/components/combobox-field/index.js +3 -0
  59. package/dist/components/date-picker/DatePicker.d.ts +53 -0
  60. package/dist/components/date-picker/DatePicker.js +329 -0
  61. package/dist/components/date-picker/index.d.ts +2 -0
  62. package/dist/components/date-picker/index.js +1 -0
  63. package/dist/components/divider/Divider.d.ts +81 -0
  64. package/dist/components/divider/Divider.js +93 -0
  65. package/dist/components/divider/index.d.ts +2 -0
  66. package/dist/components/divider/index.js +1 -0
  67. package/dist/components/drawer/Drawer.d.ts +128 -0
  68. package/dist/components/drawer/Drawer.js +367 -0
  69. package/dist/components/drawer/index.d.ts +2 -0
  70. package/dist/components/drawer/index.js +1 -0
  71. package/dist/components/dropdown-button/DropdownButton.d.ts +72 -0
  72. package/dist/components/dropdown-button/DropdownButton.js +122 -0
  73. package/dist/components/dropdown-button/index.d.ts +2 -0
  74. package/dist/components/dropdown-button/index.js +1 -0
  75. package/dist/components/faq/FAQ.d.ts +135 -0
  76. package/dist/components/faq/FAQ.js +258 -0
  77. package/dist/components/faq/index.d.ts +2 -0
  78. package/dist/components/faq/index.js +1 -0
  79. package/dist/components/field/Field.d.ts +119 -0
  80. package/dist/components/field/Field.js +332 -0
  81. package/dist/components/field/index.d.ts +2 -0
  82. package/dist/components/field/index.js +1 -0
  83. package/dist/components/field-pair/FieldPair.d.ts +210 -0
  84. package/dist/components/field-pair/FieldPair.js +335 -0
  85. package/dist/components/field-pair/index.d.ts +2 -0
  86. package/dist/components/field-pair/index.js +1 -0
  87. package/dist/components/file-upload/FileUpload.d.ts +137 -0
  88. package/dist/components/file-upload/FileUpload.js +434 -0
  89. package/dist/components/file-upload/index.d.ts +2 -0
  90. package/dist/components/file-upload/index.js +1 -0
  91. package/dist/components/filter-chip/FilterChip.d.ts +373 -0
  92. package/dist/components/filter-chip/FilterChip.js +517 -0
  93. package/dist/components/filter-chip/index.d.ts +2 -0
  94. package/dist/components/filter-chip/index.js +1 -0
  95. package/dist/components/filter-facet/FilterFacet.d.ts +116 -0
  96. package/dist/components/filter-facet/FilterFacet.js +632 -0
  97. package/dist/components/filter-facet/index.d.ts +2 -0
  98. package/dist/components/filter-facet/index.js +1 -0
  99. package/dist/components/firm-avatar/FirmAvatar.d.ts +75 -0
  100. package/dist/components/firm-avatar/FirmAvatar.js +119 -0
  101. package/dist/components/firm-avatar/index.d.ts +2 -0
  102. package/dist/components/firm-avatar/index.js +1 -0
  103. package/dist/components/form-actions/FormActions.d.ts +123 -0
  104. package/dist/components/form-actions/FormActions.js +195 -0
  105. package/dist/components/form-actions/index.d.ts +2 -0
  106. package/dist/components/form-actions/index.js +1 -0
  107. package/dist/components/form-block/FormBlock.d.ts +252 -0
  108. package/dist/components/form-block/FormBlock.js +420 -0
  109. package/dist/components/form-block/index.d.ts +3 -0
  110. package/dist/components/form-block/index.js +3 -0
  111. package/dist/components/form-section/FormSection.d.ts +130 -0
  112. package/dist/components/form-section/FormSection.js +206 -0
  113. package/dist/components/form-section/index.d.ts +2 -0
  114. package/dist/components/form-section/index.js +1 -0
  115. package/dist/components/heading/Heading.d.ts +69 -0
  116. package/dist/components/heading/Heading.js +79 -0
  117. package/dist/components/heading/index.d.ts +2 -0
  118. package/dist/components/heading/index.js +1 -0
  119. package/dist/components/heading-group/HeadingGroup.d.ts +258 -0
  120. package/dist/components/heading-group/HeadingGroup.js +255 -0
  121. package/dist/components/heading-group/index.d.ts +2 -0
  122. package/dist/components/heading-group/index.js +1 -0
  123. package/dist/components/hero/Hero.d.ts +268 -0
  124. package/dist/components/hero/Hero.js +316 -0
  125. package/dist/components/hero/index.d.ts +2 -0
  126. package/dist/components/hero/index.js +1 -0
  127. package/dist/components/icon/Icon.d.ts +27 -0
  128. package/dist/components/icon/Icon.js +30 -0
  129. package/dist/components/icon/index.d.ts +3 -0
  130. package/dist/components/icon/index.js +3 -0
  131. package/dist/components/icon-button/IconButton.d.ts +75 -0
  132. package/dist/components/icon-button/IconButton.js +151 -0
  133. package/dist/components/icon-button/index.d.ts +2 -0
  134. package/dist/components/icon-button/index.js +1 -0
  135. package/dist/components/item-row/ItemRow.d.ts +253 -0
  136. package/dist/components/item-row/ItemRow.js +496 -0
  137. package/dist/components/item-row/index.d.ts +2 -0
  138. package/dist/components/item-row/index.js +1 -0
  139. package/dist/components/list-row/ListRow.d.ts +165 -0
  140. package/dist/components/list-row/ListRow.js +233 -0
  141. package/dist/components/list-row/index.d.ts +2 -0
  142. package/dist/components/list-row/index.js +1 -0
  143. package/dist/components/menu/Menu.d.ts +64 -0
  144. package/dist/components/menu/Menu.js +186 -0
  145. package/dist/components/menu/index.d.ts +2 -0
  146. package/dist/components/menu/index.js +1 -0
  147. package/dist/components/modal/Modal.d.ts +272 -0
  148. package/dist/components/modal/Modal.js +788 -0
  149. package/dist/components/modal/index.d.ts +2 -0
  150. package/dist/components/modal/index.js +1 -0
  151. package/dist/components/nav-link/NavLink.d.ts +123 -0
  152. package/dist/components/nav-link/NavLink.js +157 -0
  153. package/dist/components/nav-link/index.d.ts +2 -0
  154. package/dist/components/nav-link/index.js +1 -0
  155. package/dist/components/number-field/NumberField.d.ts +62 -0
  156. package/dist/components/number-field/NumberField.js +210 -0
  157. package/dist/components/number-field/index.d.ts +2 -0
  158. package/dist/components/number-field/index.js +1 -0
  159. package/dist/components/pagination/Pagination.d.ts +133 -0
  160. package/dist/components/pagination/Pagination.js +217 -0
  161. package/dist/components/pagination/index.d.ts +3 -0
  162. package/dist/components/pagination/index.js +3 -0
  163. package/dist/components/popover-surface/index.d.ts +2 -0
  164. package/dist/components/popover-surface/index.js +1 -0
  165. package/dist/components/progress-bar/ProgressBar.d.ts +260 -0
  166. package/dist/components/progress-bar/ProgressBar.js +470 -0
  167. package/dist/components/progress-bar/index.d.ts +2 -0
  168. package/dist/components/progress-bar/index.js +1 -0
  169. package/dist/components/promo-sticker/PromoSticker.d.ts +204 -0
  170. package/dist/components/promo-sticker/PromoSticker.js +177 -0
  171. package/dist/components/promo-sticker/index.d.ts +2 -0
  172. package/dist/components/promo-sticker/index.js +1 -0
  173. package/dist/components/promo-surface/PromoSurface.d.ts +94 -0
  174. package/dist/components/promo-surface/PromoSurface.js +119 -0
  175. package/dist/components/promo-surface/index.d.ts +2 -0
  176. package/dist/components/promo-surface/index.js +1 -0
  177. package/dist/components/radio/Radio.d.ts +92 -0
  178. package/dist/components/radio/Radio.js +171 -0
  179. package/dist/components/radio/index.d.ts +2 -0
  180. package/dist/components/radio/index.js +1 -0
  181. package/dist/components/radio-group/RadioGroup.d.ts +61 -0
  182. package/dist/components/radio-group/RadioGroup.js +51 -0
  183. package/dist/components/radio-group/index.d.ts +2 -0
  184. package/dist/components/radio-group/index.js +1 -0
  185. package/dist/components/select/Select.d.ts +65 -0
  186. package/dist/components/select/Select.js +176 -0
  187. package/dist/components/select/index.d.ts +2 -0
  188. package/dist/components/select/index.js +1 -0
  189. package/dist/components/select-field/SelectField.d.ts +16 -0
  190. package/dist/components/select-field/SelectField.js +55 -0
  191. package/dist/components/select-field/index.d.ts +2 -0
  192. package/dist/components/select-field/index.js +1 -0
  193. package/dist/components/skeleton/Skeleton.d.ts +64 -0
  194. package/dist/components/skeleton/Skeleton.js +65 -0
  195. package/dist/components/skeleton/index.d.ts +2 -0
  196. package/dist/components/skeleton/index.js +1 -0
  197. package/dist/components/split-button/SplitButton.d.ts +80 -0
  198. package/dist/components/split-button/SplitButton.js +182 -0
  199. package/dist/components/split-button/index.d.ts +2 -0
  200. package/dist/components/split-button/index.js +1 -0
  201. package/dist/components/status-summary-bar/StatusSummaryBar.d.ts +118 -0
  202. package/dist/components/status-summary-bar/StatusSummaryBar.js +278 -0
  203. package/dist/components/status-summary-bar/index.d.ts +2 -0
  204. package/dist/components/status-summary-bar/index.js +1 -0
  205. package/dist/components/subject-lookup-field/SubjectLookupField.d.ts +157 -0
  206. package/dist/components/subject-lookup-field/SubjectLookupField.js +663 -0
  207. package/dist/components/subject-lookup-field/index.d.ts +2 -0
  208. package/dist/components/subject-lookup-field/index.js +1 -0
  209. package/dist/components/switch/Switch.d.ts +152 -0
  210. package/dist/components/switch/Switch.js +307 -0
  211. package/dist/components/switch/index.d.ts +2 -0
  212. package/dist/components/switch/index.js +1 -0
  213. package/dist/components/table/Table.d.ts +5 -0
  214. package/dist/components/table/Table.js +601 -0
  215. package/dist/components/table/index.d.ts +6 -0
  216. package/dist/components/table/index.js +6 -0
  217. package/dist/components/text-field/TextField.d.ts +160 -0
  218. package/dist/components/text-field/TextField.js +244 -0
  219. package/dist/components/text-field/index.d.ts +2 -0
  220. package/dist/components/text-field/index.js +1 -0
  221. package/dist/components/text-link/TextLink.d.ts +260 -0
  222. package/dist/components/text-link/TextLink.js +303 -0
  223. package/dist/components/text-link/index.d.ts +2 -0
  224. package/dist/components/text-link/index.js +1 -0
  225. package/dist/components/textarea/Textarea.d.ts +93 -0
  226. package/dist/components/textarea/Textarea.js +256 -0
  227. package/dist/components/textarea/index.d.ts +2 -0
  228. package/dist/components/textarea/index.js +1 -0
  229. package/dist/components/tooltip/Tooltip.d.ts +129 -0
  230. package/dist/components/tooltip/Tooltip.js +457 -0
  231. package/dist/components/tooltip/index.d.ts +2 -0
  232. package/dist/components/tooltip/index.js +1 -0
  233. package/dist/components/unit-field/UnitField.d.ts +46 -0
  234. package/dist/components/unit-field/UnitField.js +133 -0
  235. package/dist/components/unit-field/index.d.ts +2 -0
  236. package/dist/components/unit-field/index.js +1 -0
  237. package/dist/icons/icon-registry.generated.js +500 -0
  238. package/dist/icons/icon-types.generated.d.ts +2 -0
  239. package/dist/icons/icon-types.generated.js +126 -0
  240. package/dist/index.d.ts +130 -0
  241. package/dist/index.js +74 -0
  242. package/dist/internal/BottomSheet.js +496 -0
  243. package/dist/internal/FodsProvider.d.ts +25 -0
  244. package/dist/internal/FodsProvider.js +32 -0
  245. package/dist/internal/MotionCaret.js +35 -0
  246. package/dist/internal/NumberFormatInput.d.ts +21 -0
  247. package/dist/internal/NumberFormatInput.js +126 -0
  248. package/dist/internal/SummaryDonut.d.ts +3 -0
  249. package/dist/internal/SummaryDonut.js +300 -0
  250. package/dist/internal/buttonSegment.d.ts +44 -0
  251. package/dist/internal/buttonSegment.js +126 -0
  252. package/dist/internal/collapseRoom.js +128 -0
  253. package/dist/internal/comboboxKeys.js +44 -0
  254. package/dist/internal/contentPresence.js +46 -0
  255. package/dist/internal/dayCell.js +95 -0
  256. package/dist/internal/dialogPortal.d.ts +2 -0
  257. package/dist/internal/dialogPortal.js +21 -0
  258. package/dist/internal/donutSweeps.js +65 -0
  259. package/dist/internal/enterOnViewGeometry.js +46 -0
  260. package/dist/internal/faqItem.js +80 -0
  261. package/dist/internal/floatingLabelMotion.js +68 -0
  262. package/dist/internal/formBlockContext.d.ts +22 -0
  263. package/dist/internal/formBlockContext.js +20 -0
  264. package/dist/internal/heightRoom.js +87 -0
  265. package/dist/internal/numberSeparators.js +62 -0
  266. package/dist/internal/overlayMotion.js +48 -0
  267. package/dist/internal/paginationItem.d.ts +8 -0
  268. package/dist/internal/paginationItem.js +22 -0
  269. package/dist/internal/popoverSurface.d.ts +8 -0
  270. package/dist/internal/popoverSurface.js +23 -0
  271. package/dist/internal/portalContainer.d.ts +1 -0
  272. package/dist/internal/portalContainer.js +6 -0
  273. package/dist/internal/progressBarItem.d.ts +207 -0
  274. package/dist/internal/progressBarItem.js +264 -0
  275. package/dist/internal/selectionControlText.js +12 -0
  276. package/dist/internal/statusSummaryParts.js +371 -0
  277. package/dist/internal/summaryMotion.js +75 -0
  278. package/dist/internal/table/ChildConnector.js +62 -0
  279. package/dist/internal/table/ChildRowPrefix.d.ts +9 -0
  280. package/dist/internal/table/ChildRowPrefix.js +27 -0
  281. package/dist/internal/table/ColumnSettings.js +135 -0
  282. package/dist/internal/table/ScrollRegion.js +114 -0
  283. package/dist/internal/table/TableEmpty.js +93 -0
  284. package/dist/internal/table/TableLayout.d.ts +17 -0
  285. package/dist/internal/table/TableLayout.js +29 -0
  286. package/dist/internal/table/TableLoadStatus.js +56 -0
  287. package/dist/internal/table/TableMobile.js +488 -0
  288. package/dist/internal/table/TruncatedCell.js +33 -0
  289. package/dist/internal/table/emptyValue.js +10 -0
  290. package/dist/internal/table/features.d.ts +41 -0
  291. package/dist/internal/table/features.js +31 -0
  292. package/dist/internal/table/recipes.js +227 -0
  293. package/dist/internal/table/rowClick.js +9 -0
  294. package/dist/internal/table/types.d.ts +325 -0
  295. package/dist/internal/table/types.js +13 -0
  296. package/dist/internal/tailwind-variants.d.ts +3 -0
  297. package/dist/internal/tailwind-variants.js +37 -0
  298. package/dist/internal/tooltipContext.js +5 -0
  299. package/dist/internal/tw-merge-config.generated.js +314 -0
  300. package/dist/internal/useAnchoredPanel.d.ts +87 -0
  301. package/dist/internal/useAnchoredPanel.js +108 -0
  302. package/dist/internal/useCountUp.js +53 -0
  303. package/dist/internal/useDateFieldTrigger.d.ts +60 -0
  304. package/dist/internal/useDateFieldTrigger.js +235 -0
  305. package/dist/internal/useEChart.js +59 -0
  306. package/dist/internal/useEnterOnView.js +42 -0
  307. package/dist/internal/useFloatingBar.js +100 -0
  308. package/dist/internal/useFormReset.js +44 -0
  309. package/dist/internal/useIsMobile.js +44 -0
  310. package/dist/internal/useOneRowOverflow.js +88 -0
  311. package/dist/internal/usePrefersReducedMotion.js +25 -0
  312. package/dist/internal/useReturnFocus.js +26 -0
  313. package/dist/internal/utils.d.ts +7 -0
  314. package/dist/internal/utils.js +58 -0
  315. package/dist/node_modules/@tanstack/store/dist/store.d.ts +29 -0
  316. package/dist/node_modules/@tanstack/store/dist/types.d.ts +38 -0
  317. package/dist/node_modules/@tanstack/table-core/dist/core/cells/coreCellsFeature.d.ts +6 -0
  318. package/dist/node_modules/@tanstack/table-core/dist/core/cells/coreCellsFeature.types.d.ts +53 -0
  319. package/dist/node_modules/@tanstack/table-core/dist/core/columns/coreColumnsFeature.d.ts +6 -0
  320. package/dist/node_modules/@tanstack/table-core/dist/core/columns/coreColumnsFeature.types.d.ts +90 -0
  321. package/dist/node_modules/@tanstack/table-core/dist/core/coreFeatures.d.ts +17 -0
  322. package/dist/node_modules/@tanstack/table-core/dist/core/headers/coreHeadersFeature.d.ts +6 -0
  323. package/dist/node_modules/@tanstack/table-core/dist/core/headers/coreHeadersFeature.types.d.ts +114 -0
  324. package/dist/node_modules/@tanstack/table-core/dist/core/reactivity/coreReactivityFeature.types.d.ts +51 -0
  325. package/dist/node_modules/@tanstack/table-core/dist/core/row-models/coreRowModelsFeature.d.ts +6 -0
  326. package/dist/node_modules/@tanstack/table-core/dist/core/row-models/coreRowModelsFeature.types.d.ts +29 -0
  327. package/dist/node_modules/@tanstack/table-core/dist/core/rows/coreRowsFeature.d.ts +6 -0
  328. package/dist/node_modules/@tanstack/table-core/dist/core/rows/coreRowsFeature.types.d.ts +129 -0
  329. package/dist/node_modules/@tanstack/table-core/dist/core/table/coreTablesFeature.d.ts +6 -0
  330. package/dist/node_modules/@tanstack/table-core/dist/core/table/coreTablesFeature.types.d.ts +203 -0
  331. package/dist/node_modules/@tanstack/table-core/dist/features/cell-selection/cellSelectionFeature.d.ts +6 -0
  332. package/dist/node_modules/@tanstack/table-core/dist/features/cell-selection/cellSelectionFeature.types.d.ts +294 -0
  333. package/dist/node_modules/@tanstack/table-core/dist/features/cell-spanning/cellSpanningFeature.d.ts +11 -0
  334. package/dist/node_modules/@tanstack/table-core/dist/features/cell-spanning/cellSpanningFeature.types.d.ts +148 -0
  335. package/dist/node_modules/@tanstack/table-core/dist/features/column-faceting/columnFacetingFeature.d.ts +12 -0
  336. package/dist/node_modules/@tanstack/table-core/dist/features/column-faceting/columnFacetingFeature.types.d.ts +63 -0
  337. package/dist/node_modules/@tanstack/table-core/dist/features/column-filtering/columnFilteringFeature.d.ts +6 -0
  338. package/dist/node_modules/@tanstack/table-core/dist/features/column-filtering/columnFilteringFeature.types.d.ts +209 -0
  339. package/dist/node_modules/@tanstack/table-core/dist/features/column-filtering/filterFns.d.ts +35 -0
  340. package/dist/node_modules/@tanstack/table-core/dist/features/column-grouping/columnGroupingFeature.d.ts +6 -0
  341. package/dist/node_modules/@tanstack/table-core/dist/features/column-grouping/columnGroupingFeature.types.d.ts +128 -0
  342. package/dist/node_modules/@tanstack/table-core/dist/features/column-ordering/columnOrderingFeature.d.ts +6 -0
  343. package/dist/node_modules/@tanstack/table-core/dist/features/column-ordering/columnOrderingFeature.types.d.ts +82 -0
  344. package/dist/node_modules/@tanstack/table-core/dist/features/column-pinning/columnPinningFeature.d.ts +11 -0
  345. package/dist/node_modules/@tanstack/table-core/dist/features/column-pinning/columnPinningFeature.types.d.ts +195 -0
  346. package/dist/node_modules/@tanstack/table-core/dist/features/column-resizing/columnResizingFeature.d.ts +6 -0
  347. package/dist/node_modules/@tanstack/table-core/dist/features/column-resizing/columnResizingFeature.types.d.ts +73 -0
  348. package/dist/node_modules/@tanstack/table-core/dist/features/column-sizing/columnSizingFeature.d.ts +6 -0
  349. package/dist/node_modules/@tanstack/table-core/dist/features/column-sizing/columnSizingFeature.types.d.ts +134 -0
  350. package/dist/node_modules/@tanstack/table-core/dist/features/column-visibility/columnVisibilityFeature.d.ts +6 -0
  351. package/dist/node_modules/@tanstack/table-core/dist/features/column-visibility/columnVisibilityFeature.types.d.ts +92 -0
  352. package/dist/node_modules/@tanstack/table-core/dist/features/global-filtering/globalFilteringFeature.d.ts +6 -0
  353. package/dist/node_modules/@tanstack/table-core/dist/features/global-filtering/globalFilteringFeature.types.d.ts +67 -0
  354. package/dist/node_modules/@tanstack/table-core/dist/features/row-aggregation/aggregationFns.d.ts +23 -0
  355. package/dist/node_modules/@tanstack/table-core/dist/features/row-aggregation/rowAggregationFeature.d.ts +6 -0
  356. package/dist/node_modules/@tanstack/table-core/dist/features/row-aggregation/rowAggregationFeature.types.d.ts +183 -0
  357. package/dist/node_modules/@tanstack/table-core/dist/features/row-aggregation/rowAggregationFeature.utils.d.ts +18 -0
  358. package/dist/node_modules/@tanstack/table-core/dist/features/row-expanding/rowExpandingFeature.d.ts +6 -0
  359. package/dist/node_modules/@tanstack/table-core/dist/features/row-expanding/rowExpandingFeature.types.d.ts +125 -0
  360. package/dist/node_modules/@tanstack/table-core/dist/features/row-pagination/rowPaginationFeature.d.ts +6 -0
  361. package/dist/node_modules/@tanstack/table-core/dist/features/row-pagination/rowPaginationFeature.types.d.ts +135 -0
  362. package/dist/node_modules/@tanstack/table-core/dist/features/row-pinning/rowPinningFeature.d.ts +6 -0
  363. package/dist/node_modules/@tanstack/table-core/dist/features/row-pinning/rowPinningFeature.types.d.ts +76 -0
  364. package/dist/node_modules/@tanstack/table-core/dist/features/row-selection/rowSelectionFeature.d.ts +6 -0
  365. package/dist/node_modules/@tanstack/table-core/dist/features/row-selection/rowSelectionFeature.types.d.ts +187 -0
  366. package/dist/node_modules/@tanstack/table-core/dist/features/row-sorting/rowSortingFeature.d.ts +6 -0
  367. package/dist/node_modules/@tanstack/table-core/dist/features/row-sorting/rowSortingFeature.types.d.ts +236 -0
  368. package/dist/node_modules/@tanstack/table-core/dist/features/row-sorting/sortFns.d.ts +23 -0
  369. package/dist/node_modules/@tanstack/table-core/dist/features/stockFeatures.d.ts +37 -0
  370. package/dist/node_modules/@tanstack/table-core/dist/helpers/columnHelper.d.ts +47 -0
  371. package/dist/node_modules/@tanstack/table-core/dist/types/Cell.d.ts +16 -0
  372. package/dist/node_modules/@tanstack/table-core/dist/types/Column.d.ts +30 -0
  373. package/dist/node_modules/@tanstack/table-core/dist/types/ColumnDef.d.ts +123 -0
  374. package/dist/node_modules/@tanstack/table-core/dist/types/Header.d.ts +12 -0
  375. package/dist/node_modules/@tanstack/table-core/dist/types/HeaderGroup.d.ts +6 -0
  376. package/dist/node_modules/@tanstack/table-core/dist/types/Row.d.ts +24 -0
  377. package/dist/node_modules/@tanstack/table-core/dist/types/RowModel.d.ts +19 -0
  378. package/dist/node_modules/@tanstack/table-core/dist/types/RowModelFns.d.ts +11 -0
  379. package/dist/node_modules/@tanstack/table-core/dist/types/Table.d.ts +53 -0
  380. package/dist/node_modules/@tanstack/table-core/dist/types/TableFeatures.d.ts +416 -0
  381. package/dist/node_modules/@tanstack/table-core/dist/types/TableOptions.d.ts +78 -0
  382. package/dist/node_modules/@tanstack/table-core/dist/types/TableState.d.ts +46 -0
  383. package/dist/node_modules/@tanstack/table-core/dist/types/type-utils.d.ts +25 -0
  384. package/dist/shared.css +179 -0
  385. package/dist/styles.css +5467 -0
  386. package/dist/theme.css +314 -0
  387. package/dist/theme.map.json +278 -0
  388. package/dist/tokens/index.d.ts +2 -0
  389. package/dist/tokens/index.js +1 -0
  390. package/dist/tokens/tokens.generated.d.ts +2040 -0
  391. package/dist/tokens/tokens.generated.js +2053 -0
  392. package/dist/tokens.css +484 -0
  393. package/dist/tokens.flat.json +429 -0
  394. package/docs/Consuming.mdx +396 -0
  395. package/docs/Contributing.mdx +78 -0
  396. package/docs/ForAgents.mdx +53 -0
  397. package/docs/Introduction.mdx +54 -0
  398. package/llms.txt +550 -0
  399. package/package.json +347 -3
  400. package/src/components/action-row/ActionRow.mdx +686 -0
  401. package/src/components/action-row/ActionRow.stories.tsx +669 -0
  402. package/src/components/action-row/ActionRow.tsx +632 -0
  403. package/src/components/action-row/index.ts +9 -0
  404. package/src/components/alert/Alert.mdx +377 -0
  405. package/src/components/alert/Alert.stories.tsx +674 -0
  406. package/src/components/alert/Alert.tsx +579 -0
  407. package/src/components/alert/index.ts +13 -0
  408. package/src/components/anchored-panel/AnchoredPanel.mdx +381 -0
  409. package/src/components/anchored-panel/AnchoredPanel.stories.tsx +593 -0
  410. package/src/components/anchored-panel/AnchoredPanel.tsx +176 -0
  411. package/src/components/anchored-panel/index.ts +15 -0
  412. package/src/components/badge/Badge.mdx +487 -0
  413. package/src/components/badge/Badge.stories.tsx +375 -0
  414. package/src/components/badge/Badge.tsx +360 -0
  415. package/src/components/badge/index.ts +10 -0
  416. package/src/components/banner/Banner.mdx +704 -0
  417. package/src/components/banner/Banner.stories.tsx +448 -0
  418. package/src/components/banner/Banner.tsx +602 -0
  419. package/src/components/banner/index.ts +14 -0
  420. package/src/components/button/Button.mdx +286 -0
  421. package/src/components/button/Button.stories.tsx +381 -0
  422. package/src/components/button/Button.tsx +384 -0
  423. package/src/components/button/index.ts +1 -0
  424. package/src/components/button-group/ButtonGroup.mdx +512 -0
  425. package/src/components/button-group/ButtonGroup.stories.tsx +714 -0
  426. package/src/components/button-group/ButtonGroup.tsx +491 -0
  427. package/src/components/button-group/index.ts +10 -0
  428. package/src/components/card-select/CardSelect.mdx +662 -0
  429. package/src/components/card-select/CardSelect.stories.tsx +784 -0
  430. package/src/components/card-select/CardSelect.tsx +783 -0
  431. package/src/components/card-select/CardSelectGroup.tsx +169 -0
  432. package/src/components/card-select/index.ts +18 -0
  433. package/src/components/checkbox/Checkbox.mdx +269 -0
  434. package/src/components/checkbox/Checkbox.stories.tsx +306 -0
  435. package/src/components/checkbox/Checkbox.tsx +343 -0
  436. package/src/components/checkbox/index.ts +1 -0
  437. package/src/components/chip/Chip.mdx +683 -0
  438. package/src/components/chip/Chip.stories.tsx +734 -0
  439. package/src/components/chip/Chip.tsx +732 -0
  440. package/src/components/chip/index.ts +9 -0
  441. package/src/components/column-header/ColumnHeader.mdx +301 -0
  442. package/src/components/column-header/ColumnHeader.stories.tsx +319 -0
  443. package/src/components/column-header/ColumnHeader.tsx +287 -0
  444. package/src/components/column-header/index.ts +7 -0
  445. package/src/components/combobox-field/Combobox.tsx +693 -0
  446. package/src/components/combobox-field/ComboboxField.mdx +525 -0
  447. package/src/components/combobox-field/ComboboxField.stories.tsx +502 -0
  448. package/src/components/combobox-field/ComboboxField.tsx +259 -0
  449. package/src/components/combobox-field/index.ts +12 -0
  450. package/src/components/date-picker/DatePicker.mdx +440 -0
  451. package/src/components/date-picker/DatePicker.stories.tsx +458 -0
  452. package/src/components/date-picker/DatePicker.tsx +688 -0
  453. package/src/components/date-picker/index.ts +9 -0
  454. package/src/components/divider/Divider.mdx +256 -0
  455. package/src/components/divider/Divider.stories.tsx +177 -0
  456. package/src/components/divider/Divider.tsx +193 -0
  457. package/src/components/divider/index.ts +1 -0
  458. package/src/components/drawer/Drawer.mdx +518 -0
  459. package/src/components/drawer/Drawer.stories.tsx +392 -0
  460. package/src/components/drawer/Drawer.tsx +683 -0
  461. package/src/components/drawer/index.ts +1 -0
  462. package/src/components/dropdown-button/DropdownButton.mdx +285 -0
  463. package/src/components/dropdown-button/DropdownButton.stories.tsx +398 -0
  464. package/src/components/dropdown-button/DropdownButton.tsx +198 -0
  465. package/src/components/dropdown-button/index.ts +7 -0
  466. package/src/components/faq/FAQ.mdx +364 -0
  467. package/src/components/faq/FAQ.stories.tsx +343 -0
  468. package/src/components/faq/FAQ.tsx +337 -0
  469. package/src/components/faq/index.ts +1 -0
  470. package/src/components/field/Field.mdx +129 -0
  471. package/src/components/field/Field.stories.tsx +461 -0
  472. package/src/components/field/Field.tsx +787 -0
  473. package/src/components/field/index.ts +20 -0
  474. package/src/components/field-pair/FieldPair.mdx +312 -0
  475. package/src/components/field-pair/FieldPair.stories.tsx +539 -0
  476. package/src/components/field-pair/FieldPair.tsx +845 -0
  477. package/src/components/field-pair/index.ts +9 -0
  478. package/src/components/file-upload/FileUpload.mdx +345 -0
  479. package/src/components/file-upload/FileUpload.stories.tsx +698 -0
  480. package/src/components/file-upload/FileUpload.tsx +802 -0
  481. package/src/components/file-upload/index.ts +6 -0
  482. package/src/components/filter-chip/FilterChip.mdx +778 -0
  483. package/src/components/filter-chip/FilterChip.stories.tsx +827 -0
  484. package/src/components/filter-chip/FilterChip.tsx +881 -0
  485. package/src/components/filter-chip/index.ts +11 -0
  486. package/src/components/filter-facet/FilterFacet.mdx +536 -0
  487. package/src/components/filter-facet/FilterFacet.stories.tsx +506 -0
  488. package/src/components/filter-facet/FilterFacet.tsx +1160 -0
  489. package/src/components/filter-facet/index.ts +7 -0
  490. package/src/components/firm-avatar/FirmAvatar.mdx +280 -0
  491. package/src/components/firm-avatar/FirmAvatar.stories.tsx +147 -0
  492. package/src/components/firm-avatar/FirmAvatar.tsx +172 -0
  493. package/src/components/firm-avatar/index.ts +7 -0
  494. package/src/components/form-actions/FormActions.mdx +518 -0
  495. package/src/components/form-actions/FormActions.stories.tsx +621 -0
  496. package/src/components/form-actions/FormActions.tsx +273 -0
  497. package/src/components/form-actions/index.ts +6 -0
  498. package/src/components/form-block/FormBlock.mdx +728 -0
  499. package/src/components/form-block/FormBlock.stories.tsx +813 -0
  500. package/src/components/form-block/FormBlock.tsx +679 -0
  501. package/src/components/form-block/index.ts +13 -0
  502. package/src/components/form-section/FormSection.mdx +436 -0
  503. package/src/components/form-section/FormSection.stories.tsx +407 -0
  504. package/src/components/form-section/FormSection.tsx +290 -0
  505. package/src/components/form-section/index.ts +17 -0
  506. package/src/components/heading/Heading.mdx +206 -0
  507. package/src/components/heading/Heading.stories.tsx +169 -0
  508. package/src/components/heading/Heading.tsx +124 -0
  509. package/src/components/heading/index.ts +8 -0
  510. package/src/components/heading-group/HeadingGroup.mdx +521 -0
  511. package/src/components/heading-group/HeadingGroup.stories.tsx +353 -0
  512. package/src/components/heading-group/HeadingGroup.tsx +396 -0
  513. package/src/components/heading-group/index.ts +7 -0
  514. package/src/components/hero/Hero.mdx +742 -0
  515. package/src/components/hero/Hero.stories.tsx +527 -0
  516. package/src/components/hero/Hero.tsx +807 -0
  517. package/src/components/hero/index.ts +1 -0
  518. package/src/components/icon/Icon.mdx +329 -0
  519. package/src/components/icon/Icon.stories.tsx +398 -0
  520. package/src/components/icon/Icon.tsx +97 -0
  521. package/src/components/icon/index.ts +2 -0
  522. package/src/components/icon-button/IconButton.mdx +206 -0
  523. package/src/components/icon-button/IconButton.stories.tsx +341 -0
  524. package/src/components/icon-button/IconButton.tsx +273 -0
  525. package/src/components/icon-button/index.ts +1 -0
  526. package/src/components/item-row/ItemRow.mdx +533 -0
  527. package/src/components/item-row/ItemRow.stories.tsx +434 -0
  528. package/src/components/item-row/ItemRow.tsx +676 -0
  529. package/src/components/item-row/index.ts +9 -0
  530. package/src/components/list-row/ListRow.mdx +404 -0
  531. package/src/components/list-row/ListRow.stories.tsx +404 -0
  532. package/src/components/list-row/ListRow.tsx +424 -0
  533. package/src/components/list-row/index.ts +1 -0
  534. package/src/components/menu/Menu.mdx +268 -0
  535. package/src/components/menu/Menu.stories.tsx +455 -0
  536. package/src/components/menu/Menu.tsx +452 -0
  537. package/src/components/menu/index.ts +1 -0
  538. package/src/components/modal/Modal.mdx +854 -0
  539. package/src/components/modal/Modal.stories.tsx +881 -0
  540. package/src/components/modal/Modal.tsx +1434 -0
  541. package/src/components/modal/index.ts +1 -0
  542. package/src/components/nav-link/NavLink.mdx +196 -0
  543. package/src/components/nav-link/NavLink.stories.tsx +243 -0
  544. package/src/components/nav-link/NavLink.tsx +222 -0
  545. package/src/components/nav-link/index.ts +1 -0
  546. package/src/components/number-field/NumberField.mdx +223 -0
  547. package/src/components/number-field/NumberField.stories.tsx +291 -0
  548. package/src/components/number-field/NumberField.tsx +388 -0
  549. package/src/components/number-field/index.ts +6 -0
  550. package/src/components/pagination/Pagination.mdx +305 -0
  551. package/src/components/pagination/Pagination.stories.tsx +333 -0
  552. package/src/components/pagination/Pagination.tsx +343 -0
  553. package/src/components/pagination/index.ts +8 -0
  554. package/src/components/popover-surface/PopoverSurface.mdx +158 -0
  555. package/src/components/popover-surface/PopoverSurface.stories.tsx +421 -0
  556. package/src/components/popover-surface/index.ts +1 -0
  557. package/src/components/progress-bar/ProgressBar.mdx +802 -0
  558. package/src/components/progress-bar/ProgressBar.stories.tsx +533 -0
  559. package/src/components/progress-bar/ProgressBar.tsx +654 -0
  560. package/src/components/progress-bar/index.ts +9 -0
  561. package/src/components/promo-sticker/PromoSticker.mdx +436 -0
  562. package/src/components/promo-sticker/PromoSticker.stories.tsx +363 -0
  563. package/src/components/promo-sticker/PromoSticker.tsx +313 -0
  564. package/src/components/promo-sticker/index.ts +7 -0
  565. package/src/components/promo-surface/PromoSurface.mdx +399 -0
  566. package/src/components/promo-surface/PromoSurface.stories.tsx +270 -0
  567. package/src/components/promo-surface/PromoSurface.tsx +305 -0
  568. package/src/components/promo-surface/index.ts +7 -0
  569. package/src/components/radio/Radio.mdx +243 -0
  570. package/src/components/radio/Radio.stories.tsx +307 -0
  571. package/src/components/radio/Radio.tsx +288 -0
  572. package/src/components/radio/index.ts +1 -0
  573. package/src/components/radio-group/RadioGroup.mdx +119 -0
  574. package/src/components/radio-group/RadioGroup.stories.tsx +225 -0
  575. package/src/components/radio-group/RadioGroup.tsx +139 -0
  576. package/src/components/radio-group/index.ts +1 -0
  577. package/src/components/select/Select.mdx +241 -0
  578. package/src/components/select/Select.stories.tsx +404 -0
  579. package/src/components/select/Select.tsx +381 -0
  580. package/src/components/select/index.ts +1 -0
  581. package/src/components/select-field/SelectField.mdx +324 -0
  582. package/src/components/select-field/SelectField.stories.tsx +460 -0
  583. package/src/components/select-field/SelectField.tsx +138 -0
  584. package/src/components/select-field/index.ts +1 -0
  585. package/src/components/skeleton/Skeleton.mdx +194 -0
  586. package/src/components/skeleton/Skeleton.stories.tsx +260 -0
  587. package/src/components/skeleton/Skeleton.tsx +107 -0
  588. package/src/components/skeleton/index.ts +1 -0
  589. package/src/components/split-button/SplitButton.mdx +445 -0
  590. package/src/components/split-button/SplitButton.stories.tsx +465 -0
  591. package/src/components/split-button/SplitButton.tsx +361 -0
  592. package/src/components/split-button/index.ts +7 -0
  593. package/src/components/status-summary-bar/StatusSummaryBar.mdx +338 -0
  594. package/src/components/status-summary-bar/StatusSummaryBar.stories.tsx +408 -0
  595. package/src/components/status-summary-bar/StatusSummaryBar.tsx +428 -0
  596. package/src/components/status-summary-bar/index.ts +8 -0
  597. package/src/components/subject-lookup-field/SubjectLookupField.mdx +378 -0
  598. package/src/components/subject-lookup-field/SubjectLookupField.stories.tsx +393 -0
  599. package/src/components/subject-lookup-field/SubjectLookupField.tsx +1079 -0
  600. package/src/components/subject-lookup-field/index.ts +11 -0
  601. package/src/components/switch/Switch.mdx +376 -0
  602. package/src/components/switch/Switch.stories.tsx +296 -0
  603. package/src/components/switch/Switch.tsx +483 -0
  604. package/src/components/switch/index.ts +1 -0
  605. package/src/components/table/Table.mdx +575 -0
  606. package/src/components/table/Table.stories.tsx +1049 -0
  607. package/src/components/table/Table.tsx +745 -0
  608. package/src/components/table/TableConsumers.stories.tsx +195 -0
  609. package/src/components/table/_tableFixtures.ts +1189 -0
  610. package/src/components/table/index.ts +22 -0
  611. package/src/components/text-field/TextField.mdx +699 -0
  612. package/src/components/text-field/TextField.stories.tsx +674 -0
  613. package/src/components/text-field/TextField.tsx +645 -0
  614. package/src/components/text-field/index.ts +11 -0
  615. package/src/components/text-link/TextLink.mdx +353 -0
  616. package/src/components/text-link/TextLink.stories.tsx +458 -0
  617. package/src/components/text-link/TextLink.tsx +504 -0
  618. package/src/components/text-link/index.ts +10 -0
  619. package/src/components/textarea/Textarea.mdx +244 -0
  620. package/src/components/textarea/Textarea.stories.tsx +371 -0
  621. package/src/components/textarea/Textarea.tsx +489 -0
  622. package/src/components/textarea/index.ts +9 -0
  623. package/src/components/tooltip/Tooltip.mdx +462 -0
  624. package/src/components/tooltip/Tooltip.stories.tsx +500 -0
  625. package/src/components/tooltip/Tooltip.tsx +756 -0
  626. package/src/components/tooltip/index.ts +13 -0
  627. package/src/components/unit-field/UnitField.mdx +215 -0
  628. package/src/components/unit-field/UnitField.stories.tsx +291 -0
  629. package/src/components/unit-field/UnitField.tsx +255 -0
  630. package/src/components/unit-field/index.ts +7 -0
  631. package/src/icons/icon-registry.generated.ts +510 -0
  632. package/src/icons/icon-types.generated.ts +256 -0
  633. package/src/index.ts +70 -0
  634. package/src/internal/BottomSheet.tsx +714 -0
  635. package/src/internal/FodsProvider.tsx +36 -0
  636. package/src/internal/MotionCaret.tsx +53 -0
  637. package/src/internal/NumberFormatInput.tsx +276 -0
  638. package/src/internal/SummaryDonut.tsx +359 -0
  639. package/src/internal/buttonSegment.ts +241 -0
  640. package/src/internal/collapseRoom.ts +130 -0
  641. package/src/internal/comboboxKeys.ts +90 -0
  642. package/src/internal/contentPresence.ts +46 -0
  643. package/src/internal/dayCell.ts +274 -0
  644. package/src/internal/dialogPortal.ts +50 -0
  645. package/src/internal/donutSweeps.ts +77 -0
  646. package/src/internal/enterOnViewGeometry.ts +53 -0
  647. package/src/internal/faqItem.ts +104 -0
  648. package/src/internal/floatingLabelMotion.tsx +109 -0
  649. package/src/internal/formBlockContext.ts +27 -0
  650. package/src/internal/heightRoom.ts +135 -0
  651. package/src/internal/numberSeparators.ts +93 -0
  652. package/src/internal/overlayMotion.tsx +32 -0
  653. package/src/internal/paginationItem.ts +106 -0
  654. package/src/internal/popoverSurface.ts +78 -0
  655. package/src/internal/portalContainer.ts +11 -0
  656. package/src/internal/progressBarItem.ts +356 -0
  657. package/src/internal/selectionControlText.ts +42 -0
  658. package/src/internal/statusSummaryParts.tsx +475 -0
  659. package/src/internal/summaryMotion.ts +111 -0
  660. package/src/internal/table/ChildConnector.tsx +57 -0
  661. package/src/internal/table/ChildRowPrefix.tsx +21 -0
  662. package/src/internal/table/ColumnSettings.tsx +194 -0
  663. package/src/internal/table/ScrollRegion.tsx +176 -0
  664. package/src/internal/table/TableEmpty.tsx +99 -0
  665. package/src/internal/table/TableLayout.tsx +29 -0
  666. package/src/internal/table/TableLoadStatus.tsx +60 -0
  667. package/src/internal/table/TableMobile.tsx +582 -0
  668. package/src/internal/table/TruncatedCell.tsx +35 -0
  669. package/src/internal/table/emptyValue.ts +11 -0
  670. package/src/internal/table/features.ts +44 -0
  671. package/src/internal/table/recipes.ts +263 -0
  672. package/src/internal/table/rowClick.ts +8 -0
  673. package/src/internal/table/types.ts +342 -0
  674. package/src/internal/tailwind-variants.ts +65 -0
  675. package/src/internal/tooltipContext.ts +15 -0
  676. package/src/internal/tw-merge-config.generated.ts +275 -0
  677. package/src/internal/useAnchoredPanel.ts +340 -0
  678. package/src/internal/useCountUp.ts +65 -0
  679. package/src/internal/useDateFieldTrigger.tsx +497 -0
  680. package/src/internal/useEChart.ts +88 -0
  681. package/src/internal/useEnterOnView.ts +80 -0
  682. package/src/internal/useFloatingBar.ts +125 -0
  683. package/src/internal/useFormReset.ts +57 -0
  684. package/src/internal/useIsMobile.ts +64 -0
  685. package/src/internal/useNoImplicitSubmit.ts +41 -0
  686. package/src/internal/useOneRowOverflow.ts +103 -0
  687. package/src/internal/usePrefersReducedMotion.ts +27 -0
  688. package/src/internal/useReturnFocus.ts +34 -0
  689. package/src/internal/utils.ts +58 -0
  690. package/src/recipes/EmptyState.stories.tsx +105 -0
  691. package/src/recipes/Form.stories.tsx +360 -0
  692. package/src/recipes/ModalWithForm.stories.tsx +219 -0
  693. package/src/recipes/Recipes.mdx +61 -0
  694. package/src/recipes/TableWithFilters.stories.tsx +278 -0
  695. package/src/storybook/FodsFamily.tsx +39 -0
  696. package/src/storybook/Section.tsx +36 -0
  697. package/src/storybook/a11y.ts +24 -0
  698. package/src/storybook/assets/banner-character-bartender.webp +0 -0
  699. package/src/storybook/assets/banner-invoice-sheet-left.webp +0 -0
  700. package/src/storybook/assets/banner-invoice-sheet-right.webp +0 -0
  701. package/src/storybook/assets/invoice-hero.webp +0 -0
  702. package/src/storybook/assets/invoice.webp +0 -0
  703. package/src/storybook/assets/section-document-info.svg +21 -0
  704. package/src/storybook/assets/section-gear-checklist.svg +11 -0
  705. package/src/storybook/assets/section-person-arrow-in.svg +15 -0
  706. package/src/storybook/assets/section-person-arrow-out.svg +22 -0
  707. package/src/storybook/assets/section-receipt-dollar.svg +23 -0
  708. package/src/storybook/assets/table-empty-folder-empty.png +0 -0
  709. package/src/storybook/assets/table-empty-folder-magnifying-glass.png +0 -0
  710. package/src/storybook/assets/table-empty-funnel.png +0 -0
  711. package/src/storybook/assets/table-empty-load-failed.png +0 -0
  712. package/src/storybook/assets/wallet-spot.png +0 -0
  713. package/src/storybook/assets.d.ts +17 -0
  714. package/src/storybook/componentDoc.ts +41 -0
  715. package/src/storybook/fitFrame.tsx +70 -0
  716. package/src/storybook/forceStates.tsx +647 -0
  717. package/src/storybook/illustrations.tsx +66 -0
  718. package/src/storybook/viewportFrame.tsx +58 -0
  719. package/src/styles/assets/label-brush-1.svg +6 -0
  720. package/src/styles/assets/pattern-dark.svg +113 -0
  721. package/src/styles/base.css +106 -0
  722. package/src/styles/index.css +15 -0
  723. package/src/styles/motion.css +157 -0
  724. package/src/styles/promo-sticker.css +27 -0
  725. package/src/styles/promo-surface.css +49 -0
  726. package/src/styles/shared.css +11 -0
  727. package/src/styles/theme.generated.css +314 -0
  728. package/src/styles/theme.map.json +278 -0
  729. package/src/styles/tracking.generated.css +12 -0
  730. package/src/tokens/index.ts +4 -0
  731. package/src/tokens/tokens.generated.ts +542 -0
@@ -0,0 +1,1434 @@
1
+ "use client";
2
+
3
+ import * as React from 'react';
4
+ import * as DialogPrimitive from '@radix-ui/react-dialog';
5
+ import {
6
+ AnimatePresence,
7
+ motion,
8
+ useIsPresent,
9
+ useReducedMotion,
10
+ } from 'motion/react';
11
+ import { curves, springs } from '../../tokens';
12
+ import { tv } from '../../internal/tailwind-variants';
13
+ import { useIsMobile } from '../../internal/useIsMobile';
14
+ import { Icon } from '../icon/Icon';
15
+ import { Button } from '../button/Button';
16
+ import { IconButton } from '../icon-button/IconButton';
17
+ import { hasOpenFloatingPanel, usePortalTarget } from '../../internal/dialogPortal';
18
+ import { useHeightRoom, type HeightRoom } from '../../internal/heightRoom';
19
+ import { InertWhileExiting, scrimFade } from '../../internal/overlayMotion';
20
+ import { useReturnFocus } from '../../internal/useReturnFocus';
21
+ import { cn } from '../../internal/utils';
22
+
23
+ /**
24
+ * Modal — the blocking dialog organism (`modal.manifest.json`, organism, v6.5.0).
25
+ *
26
+ * Spec: `spec/05-organisms/modal.md`.
27
+ *
28
+ * One component, five chrome archetypes (`axes.variant`, called `type` here because
29
+ * the word describes WHICH REGIONS EXIST, not a colour family):
30
+ *
31
+ * - `compact` / `marketing` — no header, no footer. Visual, title, copy and the CTA
32
+ * row all live centred in the body; the close control floats in the card's corner.
33
+ * - `center` / `corner` — header (Heading Group H4 + close), body, footer Actions row.
34
+ * They differ only in the alignment PAIR (5.0.0): Center centres the title and the
35
+ * actions, Corner puts the title at the start and the actions at the end.
36
+ * - `wizard` — the header Types' regions plus the stepper band (back Button + Step
37
+ * indicator slot) and a start/end footer (decline link · exit + advance).
38
+ *
39
+ * No node carries a max-width (5.0.0): content fills the Size's track. Center, Corner and
40
+ * Wizard step their region padding up with Size (5.2.0 density ladder). The body is the
41
+ * only scroll region (6.2.0): header, Wizard band and footer stay pinned. The code-only
42
+ * `pinnedFooter={false}` puts the footer back into the scroll region, at the end of the
43
+ * content.
44
+ *
45
+ * Size=Mobile (6.0.0) is platform-driven, never a prop value: below md every Modal renders
46
+ * its Type's Mobile cell, whichever desktop Size it was given — card = viewport − 2 ×
47
+ * --space-400, region padding --space-700, CTAs in a full-width column with the primary
48
+ * first. The switch is `useIsMobile('md')` — the VIEWPORT width, an exact complement of the
49
+ * Tailwind `md:` prefix — because it changes which controls exist (the mobile Wizard's
50
+ * header back and close) and the DOM order of the actions, not just geometry.
51
+ *
52
+ * Built on Radix `Dialog`, per `delivery.react`: focus trap, scroll lock, Esc and portal
53
+ * come from the primitive. `Dialog.Overlay` and the frame holding `Dialog.Content` are
54
+ * SIBLINGS in the portal — the card is never nested in the scrim. `role="alertdialog"` is passed straight to Content — Radix spreads the
55
+ * consumer's props after its own `role="dialog"`, so the override is the primitive's own
56
+ * mechanism rather than a second (AlertDialog) tree with a different API.
57
+ */
58
+
59
+ /** Header-region Types (`regions[0].role`). */
60
+ const CHROME_TYPES = ['center', 'corner', 'wizard'] as const;
61
+ const DESKTOP_SIZES = ['sm', 'md', 'lg', 'xl'] as const;
62
+ /* Mobile decline link: the hit area padded to 44 high by a `::before` on the link itself. */
63
+ const DECLINE_LINK_HIT_AREA = [
64
+ '[&>*]:relative',
65
+ "[&>*]:before:absolute [&>*]:before:inset-x-0 [&>*]:before:top-1/2 [&>*]:before:-translate-y-1/2 [&>*]:before:content-['']",
66
+ '[&>*]:before:h-[calc(var(--space-1000)_+_var(--space-100)*2)]',
67
+ ];
68
+
69
+ const modalVariants = tv({
70
+ slots: {
71
+ /*
72
+ * `overlay` — --bg-overlay at --z-index-modal-backdrop (1300), one step under the
73
+ * card. It only fades (Motion props, see SCRIM_MOTION in the component).
74
+ */
75
+ scrim: ['fixed inset-0', 'bg-background-overlay z-modal-backdrop'],
76
+ /*
77
+ * Positioning frame — not a manifest part. A fixed, full-viewport flex box that
78
+ * centres the card and carries the viewport margins as padding: `chrome.desktop.surface`
79
+ * — the layout side-padding ladder, --space-900 (32) at md and --space-1000 (40) from
80
+ * lg, equal on all four sides; Size=Mobile swaps in `chrome.mobile.surface`. It carries
81
+ * --z-index-modal: a fixed box is always a stacking context, so this is the value
82
+ * that actually lifts the card one step above the scrim.
83
+ *
84
+ * Two things are deliberately absent:
85
+ * - no `transform` — nothing above the card may be a CSS containing block, or the
86
+ * floating-ui panels portalled into the dialog with `strategy: 'fixed'` would be
87
+ * positioned against it and clipped (see internal/dialogPortal.ts);
88
+ * - no `fit-content` — WebKit (iOS Safari/Chrome) counts a scrollable flex item as 0
89
+ * in a column's intrinsic height, so an `h-fit` card collapses to its pinned chrome.
90
+ * Here the card is sized by its content in normal flow and capped by `max-h-full`.
91
+ *
92
+ * `pointer-events-none` so a press beside the card falls through to the Radix
93
+ * Overlay (which re-enables its own pointer events) and `onInteractOutside` still
94
+ * dismisses; it also keeps a non-modal preview from covering the page.
95
+ */
96
+ frame: 'fixed inset-0 z-modal flex items-center justify-center p-900 lg:p-1000 pointer-events-none',
97
+ /*
98
+ * `container` — --bg-primary, 1px --outline-default, --radius-600, --shadow-modal,
99
+ * --z-index-modal, clipsContent (`overflow-hidden`). The z-index stays on the card as
100
+ * the manifest binding; the frame's identical value is what stacks it over the scrim.
101
+ *
102
+ * Geometry: a `relative` flex item of the frame. `w-full` lets the Size's max-width
103
+ * cap the card (`chrome.desktop.rule`: Size is a MAX-WIDTH, the card shrinks to the
104
+ * margins on a narrower window); `max-h-full` pins tall content to the frame's padding
105
+ * so it scrolls inside the scroll region. `relative` keeps the card the containing
106
+ * block of the floating close control.
107
+ *
108
+ * Motion is set as Motion props in the component (`motion` 6.4.1). Its `transform`
109
+ * is transient: at rest Motion writes `transform: none`, so the card is not a
110
+ * containing block for the portalled floating-ui panels.
111
+ */
112
+ root: [
113
+ 'relative w-full max-h-full pointer-events-auto',
114
+ 'flex flex-col overflow-hidden outline-none',
115
+ 'bg-background-primary border-100 border-outline-default rounded-600 shadow-modal z-modal',
116
+ ],
117
+ /*
118
+ * `regions[0]` — row with the Heading Group as its only in-flow child; the close
119
+ * control is absolutely positioned over it. Gap --space-400, bottom divider
120
+ * --outline-default at --border-width-100 (a plain border, not a Divider atom).
121
+ *
122
+ * Padding and min-height follow the density ladder (compoundVariants): the min-height
123
+ * is the padded close-button row, paddingY × 2 + 40 — 72 on sm · md, 80 on lg, 88 on
124
+ * xl — so turning Has close off never moves the title's baseline. `chrome.header`: the
125
+ * band is border-box with the 1px divider INSIDE it, so the bottom padding gives the
126
+ * divider's width back (it matters where an in-flow 40 control fills the row — the
127
+ * mobile Wizard's back Icon Button).
128
+ */
129
+ header: [
130
+ 'relative flex shrink-0 items-center gap-400',
131
+ 'border-b-100 border-b-outline-default',
132
+ ],
133
+ /*
134
+ * `slots.title` = Heading Group, Size H4: heading + optional description at
135
+ * --space-200 (`heading-group.manifest.json` sizes[H4].gap). FILL width.
136
+ */
137
+ sectionHeader: 'flex min-w-0 flex-1 flex-col gap-200',
138
+ /*
139
+ * `parts.title` — --text-primary. Heading/H4 (Marketing steps up to H2 — the SIZE,
140
+ * never the ink). `text.title` (6.5.0): wraps and is never truncated or clamped — copy
141
+ * keeps it within 2 lines (spec § Copy M3), so no `line-clamp`; the heading's own
142
+ * text-wrap binding applies. An unbroken run (a filename as the title, `file-upload`
143
+ * 1.6.0) wraps inside the word via `wrap-anywhere` (`overflow-wrap: anywhere`, the
144
+ * recipe `text.title` names); unlike `break-word` it lowers min-content, so the fit-content `h2` that
145
+ * `items-center` makes on Compact/Marketing/Center still wraps without a max-width.
146
+ * On Compact/Marketing with nothing above it, the close footprint moves onto the title as
147
+ * symmetric padding — see the TITLE CLOSE RESERVATION compound.
148
+ */
149
+ title: [
150
+ 'font-poppins font-semibold text-text-primary',
151
+ 'wrap-anywhere [text-wrap:var(--text-wrap-heading)]',
152
+ ],
153
+ /*
154
+ * Heading Group description run — Body/S Regular in --text-secondary
155
+ * (`heading-group.md` § Anatomy). The optional scope line — the bare company name or
156
+ * account e-mail («Beta s.r.o.»), never with an entity prefix (4.1.1).
157
+ */
158
+ description: 'font-inter text-body-sm font-normal text-text-secondary',
159
+ /*
160
+ * `slots.close-button` — Icon Button Tertiary, Size md, Show surface on. Header
161
+ * placement: pinned to the right edge, vertically centred, out of flow; the inset is
162
+ * 24 on sm · md · lg and 32 on xl (`regions[0].align`), 20 on Mobile. Floating
163
+ * placement is set in the `type` variant.
164
+ */
165
+ closeButton: 'absolute right-800 top-1/2 -translate-y-1/2',
166
+ /*
167
+ * `slots.back-icon-button` — mobile Wizard only: Icon Button Tertiary md, Show surface
168
+ * on, at the start of the header row, in its flow (4.2.3). Box 40, hit area padded to
169
+ * 44 by a --space-100 `::before` on every side (`chrome.mobile.header.hit-area`).
170
+ */
171
+ backIconButton: [
172
+ 'relative shrink-0',
173
+ "before:absolute before:-inset-100 before:content-['']",
174
+ ],
175
+ /*
176
+ * `regions[2]` — Wizard only. Gap --space-400, paddingBottom --space-400, min-height
177
+ * 64 (--space-1200) so the band keeps its height with or without the back Button.
178
+ * paddingX / paddingTop follow the density ladder. The band spans the track — no cap.
179
+ */
180
+ stepper: [
181
+ 'relative flex w-full shrink-0',
182
+ 'items-center justify-center gap-400',
183
+ 'min-h-1200 pb-400',
184
+ ],
185
+ /*
186
+ * The `Step indicator` slot — the only in-flow child, centred. Width per Size under
187
+ * the corridor rule, min(Size width, track − 2 × 80) (`regions[2].note`).
188
+ */
189
+ stepIndicator: 'max-w-full',
190
+ /*
191
+ * The Modal-owned back Button, out of flow so the markers centre on the band: its
192
+ * arrow glyph on the content edge (x = paddingX − 12) and pinned to the band's top,
193
+ * centred on the 24 marker row (y = paddingTop − 8). Offsets per Size below.
194
+ */
195
+ backLink: 'absolute',
196
+ /*
197
+ * Positioning frame around the scroll region: the Edge mask has to sit OVER the scroll
198
+ * region, not inside it, or it would scroll away with the content. With the footer
199
+ * pinned the frame ends at the footer's top divider, so the mask lies directly above it.
200
+ */
201
+ bodyFrame: 'relative flex min-h-0 flex-1 flex-col',
202
+ /*
203
+ * The scroll region (`regions[1].note`, 6.2.1): the body alone, between the pinned
204
+ * header/band and the pinned footer; with `pinnedFooter={false}` body + footer, the
205
+ * footer reached at the end of the content. `min-h-0` lets it shrink inside the card's
206
+ * flex column. Not a manifest part. While it overflows with nothing focusable inside,
207
+ * it is a tab stop (`scrollbar.md` § Accessibility), so it draws the inset focus ring — inset, because
208
+ * the card clips anything outside it.
209
+ */
210
+ scroll: [
211
+ 'flex min-h-0 flex-1 flex-col overflow-y-auto',
212
+ 'outline-none focus-visible:ring-200 focus-visible:ring-inset focus-visible:ring-outline-focus',
213
+ ],
214
+ /*
215
+ * `regions[1]` — the body. Padding and the outer gap tier are set per Type and Size.
216
+ *
217
+ * `parts.body` ink --text-primary. The copy SIZE is not in the manifest; Body/Base is
218
+ * the system's default reading size.
219
+ */
220
+ body: [
221
+ 'relative flex shrink-0 flex-col',
222
+ 'font-inter text-body-base text-text-primary',
223
+ ],
224
+ /*
225
+ * Fade Overlay Kind=Edge mask at the scroll region's bottom edge
226
+ * (`chrome.mobile.body.edge-mask`, `chrome.desktop.body.scrollbar`): 40 (--space-1000)
227
+ * on the scroll axis, --bg-primary at alpha 0 -> 1, the zero end derived from the token
228
+ * (`scrollbar.md` § Fade the cut edge). The right inset keeps a classic scrollbar's
229
+ * thumb uncovered; it is set inline from the measured gutter. Hidden once the region is
230
+ * scrolled to its end (6.1.3), so it never covers the last row — or, with the footer in
231
+ * the scroll region, its CTAs.
232
+ */
233
+ edgeMask: [
234
+ 'pointer-events-none absolute bottom-0 left-0 h-1000',
235
+ // fods-lint-disable-next-line fade-overlay.md prescribes rgb(from var(--bg-primary) r g b / 0) for the zero stop, never transparent; no token for it
236
+ 'bg-[image:linear-gradient(to_bottom,rgb(from_var(--bg-primary)_r_g_b_/_0),var(--bg-primary))]',
237
+ ],
238
+ /*
239
+ * The same Edge mask mirrored onto the scroll region's TOP edge, directly under the
240
+ * header's divider (or the Wizard's stepper band), while the region is scrolled away
241
+ * from its start (`chrome.mobile.body.edge-mask-top`, 6.3.0).
242
+ */
243
+ edgeMaskTop: [
244
+ 'pointer-events-none absolute top-0 left-0 h-1000',
245
+ // fods-lint-disable-next-line fade-overlay.md prescribes rgb(from var(--bg-primary) r g b / 0) for the zero stop, never transparent; no token for it
246
+ 'bg-[image:linear-gradient(to_top,rgb(from_var(--bg-primary)_r_g_b_/_0),var(--bg-primary))]',
247
+ ],
248
+ /* The inset visual (enlarged icon / illustration) on Compact and Marketing. */
249
+ visual: 'flex shrink-0 items-center justify-center',
250
+ /*
251
+ * The full-bleed banner (`regions[1].note`): stretched edge-to-edge to the card's
252
+ * left/right/top, cropped by the card's clipsContent — the negative margins cancel
253
+ * the body's own padding (set per Type). `chrome.marketing-banner` (6.1.0): the
254
+ * Promo visuals crop-zone ratio for the Size, object-fit cover, no max-height cap.
255
+ */
256
+ banner: [
257
+ 'shrink-0 self-stretch overflow-hidden',
258
+ '[&>img]:size-full [&>img]:object-cover',
259
+ ],
260
+ /*
261
+ * The `Container` slot inside the Body — the content column. No max-width (5.0.0):
262
+ * it fills the track.
263
+ */
264
+ container: 'flex w-full flex-col',
265
+ /* Marketing only: title + copy form ONE text block at the inner gap. */
266
+ textBlock: 'flex w-full flex-col items-center gap-600',
267
+ /* The body-hosted CTA row (Compact/Marketing) — centred, gap --space-400. */
268
+ actions: 'flex w-full flex-wrap items-center justify-center gap-400',
269
+ /* Marketing: the CTA row with the decline link beneath it. */
270
+ actionCluster: 'flex w-full flex-col items-center gap-400',
271
+ /* The decline-link slot. */
272
+ declineLink: 'flex min-w-0',
273
+ /*
274
+ * `regions[3]` — top divider --outline-default at --border-width-100. Center, Corner
275
+ * and Wizard only. Padding per the density ladder; `chrome.footer`: the band is
276
+ * border-box with the 1px divider INSIDE it, so the top padding gives the divider's
277
+ * width back — on sm, 24 + 40 + 24 + 1 would be 89; the ladder changes the padding,
278
+ * not the rule. Pinned by default (6.2.0): a `shrink-0` sibling below the body frame;
279
+ * with `pinnedFooter={false}` the last child of the scroll region.
280
+ */
281
+ footer: 'flex shrink-0 border-t-100 border-t-outline-default',
282
+ /* The footer's Content column — the full track (5.0.0). */
283
+ footerContent: 'flex w-full flex-wrap items-center gap-400',
284
+ /* The footer `Actions` slot (gap --space-400). */
285
+ footerActions: 'flex flex-wrap items-center gap-400',
286
+ },
287
+ variants: {
288
+ type: {
289
+ /*
290
+ * Two-tier gap ladder (`regions[1].note`): outer --space-700 between visual ·
291
+ * title · content · CTA row, inner --space-500 inside the content block.
292
+ */
293
+ compact: {
294
+ body: 'items-center p-800 gap-700 text-center',
295
+ banner: '-mx-800 -mt-800',
296
+ title: 'text-heading-h4',
297
+ container: 'gap-500',
298
+ closeButton: 'top-600 right-600 translate-y-0',
299
+ },
300
+ /* One grid step up: padding --space-900, outer --space-800, inner --space-600. */
301
+ marketing: {
302
+ body: 'items-center p-900 gap-800 text-center',
303
+ banner: '-mx-900 -mt-900',
304
+ title: 'text-heading-h2',
305
+ container: 'gap-600',
306
+ closeButton: 'top-600 right-600 translate-y-0',
307
+ },
308
+ /*
309
+ * Flat --space-700 — the CTA lives in the footer, so the outer tier is the only one.
310
+ * The alignment pair: title centred + actions centred.
311
+ */
312
+ center: {
313
+ body: 'gap-700',
314
+ title: 'text-heading-h4',
315
+ container: 'gap-700',
316
+ sectionHeader: 'items-center text-center',
317
+ footerContent: 'justify-center',
318
+ },
319
+ /* The alignment pair: title at the start + actions at the end. */
320
+ corner: {
321
+ body: 'gap-700',
322
+ title: 'text-heading-h4',
323
+ container: 'gap-700',
324
+ footerContent: 'justify-end',
325
+ },
326
+ /* Title Align=Left at every Size (5.2.0); footer start/end. */
327
+ wizard: {
328
+ body: 'gap-700',
329
+ title: 'text-heading-h4',
330
+ container: 'gap-700',
331
+ declineLink: 'flex-1',
332
+ footerActions: 'ml-auto',
333
+ },
334
+ },
335
+ /*
336
+ * `sizes[]` — card width sm 480 / md 640 / lg 834 / xl 1238; `mobile` is the
337
+ * platform-driven Size=Mobile cell, set by the component below md, never by a caller.
338
+ * Per Size also: the Step indicator width (min(Size width, track − 160)) and the
339
+ * banner's crop-zone ratio (`chrome.marketing-banner.ratios`).
340
+ */
341
+ size: {
342
+ sm: {
343
+ // fods-lint-disable-next-line off-grid 480px modal width, manifest sizes[sm]; not a --space value
344
+ root: 'max-w-[480px]',
345
+ // fods-lint-disable-next-line off-grid 272px step-indicator width, manifest regions[2] (sm), under the track − 160 corridor
346
+ stepIndicator: 'w-[min(272px,calc(100%_-_var(--space-1300)*2))]',
347
+ banner: 'aspect-[455/380]',
348
+ },
349
+ md: {
350
+ // fods-lint-disable-next-line off-grid 640px modal width, manifest sizes[md]; not a --space value
351
+ root: 'max-w-[640px]',
352
+ // fods-lint-disable-next-line off-grid 432px step-indicator width, manifest regions[2] (md), under the track − 160 corridor
353
+ stepIndicator: 'w-[min(432px,calc(100%_-_var(--space-1300)*2))]',
354
+ banner: 'aspect-[631/380]',
355
+ },
356
+ lg: {
357
+ // fods-lint-disable-next-line off-grid 834px modal width, manifest sizes[lg]; not a --space value
358
+ root: 'max-w-[834px]',
359
+ // fods-lint-disable-next-line off-grid 600px step-indicator width, manifest regions[2] (lg), under the track − 160 corridor
360
+ stepIndicator: 'w-[min(600px,calc(100%_-_var(--space-1300)*2))]',
361
+ banner: 'aspect-[750/380]',
362
+ },
363
+ xl: {
364
+ // fods-lint-disable-next-line off-grid 1238px modal width, manifest sizes[xl]; not a --space value
365
+ root: 'max-w-[1238px]',
366
+ // fods-lint-disable-next-line off-grid 786px step-indicator width, manifest regions[2] (xl; Figma-only layout variable, no CSS binding), under the track − 160 corridor
367
+ stepIndicator: 'w-[min(786px,calc(100%_-_var(--space-1300)*2))]',
368
+ banner: 'aspect-[904/380]',
369
+ },
370
+ /*
371
+ * `sizes[Mobile]` + `chrome.mobile`: card = viewport − 2 × --space-400 (side), with
372
+ * --space-700 top and bottom; no max-width.
373
+ */
374
+ mobile: {
375
+ frame: 'px-400 py-700',
376
+ /* `chrome.mobile.stepper`: the Step indicator fills the band between its paddings. */
377
+ stepIndicator: 'w-full',
378
+ banner: 'aspect-[358/246]',
379
+ /* `chrome.mobile.header.note`: every Type's close pads its hit area to 44. */
380
+ closeButton: "before:absolute before:-inset-100 before:content-['']",
381
+ /*
382
+ * `chrome.mobile.footer.layout`: a column of FILL Buttons. The primary-first order
383
+ * is DOM order (the component reorders), never CSS order/reverse.
384
+ */
385
+ actions: 'flex-col flex-nowrap items-stretch [&>*]:w-full',
386
+ footerContent: 'flex-col flex-nowrap items-stretch',
387
+ footerActions: 'w-full flex-col flex-nowrap items-stretch [&>*]:w-full',
388
+ },
389
+ },
390
+ /* `axes.has-close` — the header reservation is switched in compoundVariants. */
391
+ hasClose: {
392
+ true: {},
393
+ false: {},
394
+ },
395
+ /*
396
+ * The body-hosted title (Compact/Marketing) sits in the floating close button's row when
397
+ * nothing — visual or banner — is above it. The header Types reserve the close footprint
398
+ * on the header (`regions[0].note`); here it moves onto the title, symmetric so the
399
+ * centred title stays on the card's axis (`text.title`, 6.3.0).
400
+ * Switched in compoundVariants.
401
+ */
402
+ titleReserve: {
403
+ true: {},
404
+ false: {},
405
+ },
406
+ /*
407
+ * `chrome.mobile.unpin` — header, band and pinned footer take more than half of the
408
+ * dialog's height: the card itself becomes the scroll region and everything scrolls in
409
+ * document order. Only ever set below md.
410
+ */
411
+ unpinned: {
412
+ true: {
413
+ root: 'overflow-auto',
414
+ bodyFrame: 'flex-none',
415
+ scroll: 'flex-none overflow-visible',
416
+ },
417
+ false: {},
418
+ },
419
+ },
420
+ compoundVariants: [
421
+ /*
422
+ * DENSITY LADDER (5.2.0, `regions[0].note`) on Center, Corner and Wizard: horizontal
423
+ * padding = sizes[].paddingX (24 · 24 · 32 · 40) on header, band, body and footer;
424
+ * vertical per region — header 16 · 16 · 20 · 24, band top 16 · 16 · 24 · 32, body =
425
+ * paddingX, footer 24 · 24 · 24 · 32. Size=Mobile: --space-700 (20) on every side.
426
+ */
427
+ {
428
+ type: [...CHROME_TYPES],
429
+ size: ['sm', 'md'],
430
+ class: {
431
+ header: [
432
+ 'px-800 pt-600 pb-[calc(var(--space-600)_-_var(--border-width-100))]',
433
+ 'min-h-[calc(var(--space-600)*2_+_var(--space-1000))]',
434
+ ],
435
+ stepper: 'px-800 pt-600',
436
+ backLink: 'left-500 top-400',
437
+ body: 'p-800',
438
+ footer: 'px-800 pb-800 pt-[calc(var(--space-800)_-_var(--border-width-100))]',
439
+ },
440
+ },
441
+ {
442
+ type: [...CHROME_TYPES],
443
+ size: 'lg',
444
+ class: {
445
+ header: [
446
+ 'px-900 pt-700 pb-[calc(var(--space-700)_-_var(--border-width-100))]',
447
+ 'min-h-[calc(var(--space-700)*2_+_var(--space-1000))]',
448
+ ],
449
+ stepper: 'px-900 pt-800',
450
+ backLink: 'left-700 top-600',
451
+ body: 'p-900',
452
+ footer: 'px-900 pb-800 pt-[calc(var(--space-800)_-_var(--border-width-100))]',
453
+ },
454
+ },
455
+ {
456
+ type: [...CHROME_TYPES],
457
+ size: 'xl',
458
+ class: {
459
+ header: [
460
+ 'px-1000 pt-800 pb-[calc(var(--space-800)_-_var(--border-width-100))]',
461
+ 'min-h-[calc(var(--space-800)*2_+_var(--space-1000))]',
462
+ ],
463
+ stepper: 'px-1000 pt-900',
464
+ backLink: 'left-[calc(var(--space-1000)_-_var(--space-500))] top-800',
465
+ body: 'p-1000',
466
+ footer: 'px-1000 pb-900 pt-[calc(var(--space-900)_-_var(--border-width-100))]',
467
+ /* From lg up the inset is paddingX − 8 (the 24 glyph on the content edge); lg lands on the 24 base. */
468
+ closeButton: 'right-900',
469
+ },
470
+ },
471
+ {
472
+ type: [...CHROME_TYPES],
473
+ size: 'mobile',
474
+ class: {
475
+ header: [
476
+ 'px-700 pt-700 pb-[calc(var(--space-700)_-_var(--border-width-100))]',
477
+ 'min-h-[calc(var(--space-700)*2_+_var(--space-1000))]',
478
+ ],
479
+ stepper: 'px-700 pt-600',
480
+ body: 'p-700',
481
+ footer: 'px-700 pb-700 pt-[calc(var(--space-700)_-_var(--border-width-100))]',
482
+ /* `chrome.mobile.header.note`: the close 20 from the card's corner. */
483
+ closeButton: 'right-700',
484
+ },
485
+ },
486
+ /* Size=Mobile on the body-only Types: --space-700 on every side, banner bleed to match. */
487
+ {
488
+ type: ['compact', 'marketing'],
489
+ size: 'mobile',
490
+ class: {
491
+ body: 'p-700',
492
+ banner: '-mx-700 -mt-700',
493
+ closeButton: 'top-700 right-700',
494
+ },
495
+ },
496
+ /*
497
+ * CLOSE-BUTTON RESERVATION (`regions[0].note`): with the close control out of flow,
498
+ * the header's right padding takes --space-1300 (80 = 24 edge + 40 button + 16 air)
499
+ * on every desktop Size; a CENTRED title (Center) takes it on BOTH sides so its centre
500
+ * stays on the card's axis. Mobile: --space-1200 (64 = 20 inset + 40 close + 4).
501
+ * After the ladder, so the side override wins over the ladder's `px-*`.
502
+ */
503
+ {
504
+ type: [...CHROME_TYPES],
505
+ size: [...DESKTOP_SIZES],
506
+ hasClose: true,
507
+ class: { header: 'pr-1300' },
508
+ },
509
+ {
510
+ type: [...CHROME_TYPES],
511
+ size: 'mobile',
512
+ hasClose: true,
513
+ class: { header: 'pr-1200' },
514
+ },
515
+ {
516
+ type: 'center',
517
+ size: [...DESKTOP_SIZES],
518
+ hasClose: true,
519
+ class: { header: 'pl-1300' },
520
+ },
521
+ {
522
+ type: 'center',
523
+ size: 'mobile',
524
+ hasClose: true,
525
+ class: { header: 'pl-1200' },
526
+ },
527
+ /*
528
+ * TITLE CLOSE RESERVATION (`text.title`, 6.3.0): the floating close
529
+ * sits 16 in with a 40 box, so it ends 56 from the card edge. --space-1000 (40) on both
530
+ * sides of the title puts its text edge at 64 on Compact (24 body padding, 8 air) and
531
+ * 72 on Marketing (32 body padding, 16 air). Mobile: the close ends at 60 (20 inset +
532
+ * 40); --space-1100 (48) + the 20 body padding = 68, 8 air on both Types.
533
+ */
534
+ {
535
+ type: ['compact', 'marketing'],
536
+ size: [...DESKTOP_SIZES],
537
+ titleReserve: true,
538
+ class: { title: 'px-1000' },
539
+ },
540
+ {
541
+ type: ['compact', 'marketing'],
542
+ size: 'mobile',
543
+ titleReserve: true,
544
+ class: { title: 'px-1100' },
545
+ },
546
+ /*
547
+ * `chrome.mobile.footer.wizard-only`: ONE column inside `Actions` — the start-aligned
548
+ * decline link, then the primary Button, gap --space-600; the link's hit area 44 high.
549
+ */
550
+ {
551
+ type: 'wizard',
552
+ size: 'mobile',
553
+ class: {
554
+ footerActions: 'ml-0 gap-600',
555
+ declineLink: ['flex-none self-start', ...DECLINE_LINK_HIT_AREA],
556
+ },
557
+ },
558
+ /* Marketing Mobile: the centred decline link, hit area 44 (`chrome.mobile.footer.layout`). */
559
+ {
560
+ type: 'marketing',
561
+ size: 'mobile',
562
+ class: {
563
+ declineLink: DECLINE_LINK_HIT_AREA,
564
+ },
565
+ },
566
+ ],
567
+ defaultVariants: {
568
+ /* `properties[Type].default` = Compact, `properties[Size].default` = sm. */
569
+ type: 'compact',
570
+ size: 'sm',
571
+ hasClose: true,
572
+ titleReserve: false,
573
+ unpinned: false,
574
+ },
575
+ });
576
+
577
+ /** The chrome archetype (`axes.variant`, default Compact). */
578
+ export type ModalType = 'compact' | 'marketing' | 'center' | 'wizard' | 'corner';
579
+ /**
580
+ * Desktop card width sm 480 / md 640 / lg 834 / xl 1238 (`axes.size`, default sm). The
581
+ * manifest's fifth value, Mobile, is platform-driven: below md the Modal renders it
582
+ * whatever this prop says.
583
+ */
584
+ export type ModalSize = 'sm' | 'md' | 'lg' | 'xl';
585
+
586
+ /**
587
+ * The first element in `container` that Tab would reach, other than `except` itself (its
588
+ * children stay candidates). The candidates Radix's FocusScope picks from: a non-negative
589
+ * tabIndex, not disabled, not a hidden input, and not hidden — `hidden` or `display: none`
590
+ * on the element or an ancestor drops the whole subtree, `visibility: hidden` the element
591
+ * (a child may set it back to visible).
592
+ */
593
+ function firstTabbableExcept(container: HTMLElement, except: HTMLElement): HTMLElement | null {
594
+ const view = container.ownerDocument.defaultView;
595
+ const walker = container.ownerDocument.createTreeWalker(container, NodeFilter.SHOW_ELEMENT, {
596
+ acceptNode: node => {
597
+ const el = node as HTMLElement & { disabled?: boolean };
598
+ const style = view?.getComputedStyle(el);
599
+ if (el.hidden || style?.display === 'none') return NodeFilter.FILTER_REJECT;
600
+ if (el === except || el.disabled || style?.visibility === 'hidden') return NodeFilter.FILTER_SKIP;
601
+ if (el instanceof HTMLInputElement && el.type === 'hidden') return NodeFilter.FILTER_SKIP;
602
+ return el.tabIndex >= 0 ? NodeFilter.FILTER_ACCEPT : NodeFilter.FILTER_SKIP;
603
+ },
604
+ });
605
+ return walker.nextNode() as HTMLElement | null;
606
+ }
607
+
608
+ /**
609
+ * The actions as a flat, keyed list. In a Mobile column (`chrome.mobile.footer.layout`)
610
+ * the primary comes first, because DOM order must equal visual order and CSS
611
+ * order/reverse is forbidden; consumers pass them secondary first, primary last (the
612
+ * desktop row order), so the column is the reverse. A fragment is unwrapped so its
613
+ * Buttons reorder individually, and both orders share the same keys — crossing md while
614
+ * open moves the Buttons instead of remounting them, so a focused one keeps focus.
615
+ */
616
+ function orderActions(node: React.ReactNode, primaryFirst: boolean): React.ReactNode {
617
+ if (node == null) return node;
618
+ const items = React.Children.toArray(node).flatMap(child =>
619
+ React.isValidElement<{ children?: React.ReactNode }>(child) && child.type === React.Fragment
620
+ ? React.Children.toArray(child.props.children)
621
+ : [child],
622
+ );
623
+ return primaryFirst ? items.reverse() : items;
624
+ }
625
+
626
+ interface ModalBaseProps {
627
+ /** Open state. The modal is always controlled — it has no trigger of its own. */
628
+ open: boolean;
629
+ /** Called by the close control, and by Esc / a scrim click when dismissal is allowed. */
630
+ onClose: () => void;
631
+ /**
632
+ * The dialog's name — rendered as `Dialog.Title`, so it is also the accessible name.
633
+ * Omit it only when the body carries its own heading rendered through `ModalTitle`.
634
+ * The header Types then keep an empty header with just the close control (no header
635
+ * at all without one); Compact/Marketing are unaffected.
636
+ */
637
+ title?: string;
638
+ /** Accessible name of the close control. Defaults to «Zavřít» (Czech); an app with more language versions passes it from its translations. */
639
+ closeLabel?: string;
640
+ /** The Body's `Container` slot. */
641
+ children?: React.ReactNode;
642
+ /**
643
+ * The CTA Buttons. In the footer's `Actions` slot on Center/Corner/Wizard; a centred
644
+ * body row on Compact/Marketing. Order them secondary first, primary last — on Mobile
645
+ * the Modal reverses them into a column with the primary first (DOM order = visual
646
+ * order). The Mobile column wants `size="lg"` Buttons (`chrome.mobile.footer`).
647
+ */
648
+ actions?: React.ReactNode;
649
+ /**
650
+ * The desktop Size, chosen once for the widest content (`chrome.desktop.rule`). Below md
651
+ * the Modal renders Size=Mobile instead, whatever this says.
652
+ */
653
+ size?: ModalSize;
654
+ /**
655
+ * `axes.has-close`. Defaults to true, except Wizard, which defaults to false. Ignored on
656
+ * a Wizard below md: the header close is its only exit there, so it always renders.
657
+ */
658
+ hasClose?: boolean;
659
+ /**
660
+ * Whether Esc and a scrim click close the modal. Defaults to true, except Wizard and
661
+ * an `alertdialog` (the destructive Confirmation), which force a terminal choice.
662
+ */
663
+ dismissOnBackdrop?: boolean;
664
+ /**
665
+ * `properties[Pinned footer]` (code-only, 6.2.0). Default true: the footer stays pinned
666
+ * below the body and only the body scrolls. False: the footer scrolls with the body and
667
+ * is reached at the end of the content. No effect on Compact/Marketing (no footer).
668
+ */
669
+ pinnedFooter?: boolean;
670
+ /** `alertdialog` for a destructive Confirmation (`notes[8]`). */
671
+ role?: 'dialog' | 'alertdialog';
672
+ /**
673
+ * Docs previews only: portals into this element and renders NON-modally — no scroll
674
+ * lock, focus trap, outside `aria-hidden` or open auto-focus — so several instances can
675
+ * sit on one page. The element must be a containing block for `position: fixed`
676
+ * (e.g. carry a `transform`).
677
+ */
678
+ previewContainer?: HTMLElement | null;
679
+ className?: string;
680
+ }
681
+
682
+ /** Props no Type but Wizard accepts. */
683
+ interface ModalNoWizardProps {
684
+ stepIndicator?: never;
685
+ onBack?: never;
686
+ backLabel?: never;
687
+ mobileAction?: never;
688
+ stepKey?: never;
689
+ }
690
+
691
+ /**
692
+ * Compact and Marketing carry EITHER an inset visual (an enlarged icon, an
693
+ * illustration) OR a full-bleed banner image — never both in the same body.
694
+ */
695
+ type ModalVisualProps =
696
+ | { visual?: React.ReactNode; banner?: never }
697
+ | { banner: React.ReactNode; visual?: never };
698
+
699
+ type ModalCompactProps = ModalNoWizardProps &
700
+ ModalVisualProps & {
701
+ type?: 'compact';
702
+ description?: never;
703
+ declineLink?: never;
704
+ };
705
+
706
+ type ModalMarketingProps = ModalNoWizardProps &
707
+ ModalVisualProps & {
708
+ type: 'marketing';
709
+ description?: never;
710
+ /** TextLink Quiet sm, underline on — beneath the CTA row (Quiet md on Mobile). */
711
+ declineLink?: React.ReactNode;
712
+ };
713
+
714
+ type ModalHeaderedProps = ModalNoWizardProps & {
715
+ type: 'center' | 'corner';
716
+ /** The Heading Group's optional scope line. */
717
+ description?: string;
718
+ visual?: never;
719
+ banner?: never;
720
+ declineLink?: never;
721
+ };
722
+
723
+ /**
724
+ * The back Button is one of the wizard's two ways back — it goes one step back; the other
725
+ * is a Done marker in the step indicator, which returns straight to its step through the
726
+ * Progress Bar's `onStepClick`, wired by the composer on the instance it passes into
727
+ * `stepIndicator`. The back Button has a visible label, so a handler without a translated
728
+ * label (or a label without a handler) is unrepresentable — same union shape as Drawer's
729
+ * Level. Omit both on step 1. Below md the same pair drives the header's arrow-left Icon
730
+ * Button, `backLabel` as its aria-label.
731
+ */
732
+ type ModalWizardBackProps =
733
+ | { onBack?: never; backLabel?: never }
734
+ | { onBack: () => void; backLabel: string };
735
+
736
+ type ModalWizardProps = ModalWizardBackProps & {
737
+ type: 'wizard';
738
+ description?: string;
739
+ /**
740
+ * The `Step indicator` slot — a Progress Bar (sm · Row · Blue) by default. The Modal
741
+ * does not wire the Done-step return; pass `onStepClick` on the Progress Bar itself.
742
+ */
743
+ stepIndicator?: React.ReactNode;
744
+ /**
745
+ * TextLink Quiet md at the start of the footer. Below md the same link renders as the
746
+ * first item of the footer column — pass it once, it is never shown twice.
747
+ */
748
+ declineLink?: React.ReactNode;
749
+ /**
750
+ * The footer below md (`chrome.mobile.footer`): the single advance / finish Button,
751
+ * `size="lg"`, which the Modal stretches to the footer width. There is no exit Button
752
+ * there — the exit is the header close. Without it the mobile column falls back to
753
+ * `actions`.
754
+ */
755
+ mobileAction?: React.ReactNode;
756
+ /**
757
+ * Identity of the current step (`motion.layout`). When it changes, the body's step
758
+ * content fades out, the card's height follows the new step on `--spring-gentle`, then
759
+ * the new step fades in. Without it the body swaps in place, unanimated.
760
+ */
761
+ stepKey?: React.Key;
762
+ visual?: never;
763
+ banner?: never;
764
+ };
765
+
766
+ export type ModalProps = ModalBaseProps &
767
+ (ModalCompactProps | ModalMarketingProps | ModalHeaderedProps | ModalWizardProps);
768
+
769
+ interface ScrollFit {
770
+ /** `chrome.mobile.unpin` — the pinned chrome exceeds half of the dialog's height. */
771
+ unpinned: boolean;
772
+ /** The scroll region overflows its own height — the Edge mask condition. */
773
+ overflowing: boolean;
774
+ /**
775
+ * The overflowing region holds nothing Tab reaches, so it is a tab stop itself
776
+ * (`scrollbar.md` § Accessibility: `tabindex="0"` only "where the region holds no
777
+ * focusable child"). With a focusable child, Tab scrolls the region as it moves.
778
+ */
779
+ tabStop: boolean;
780
+ /** The scroll region is scrolled to its end (`scrollTop + clientHeight >= scrollHeight - 1`). */
781
+ atEnd: boolean;
782
+ /** The scroll region is scrolled to its start (`scrollTop < 1`) — hides the top Edge mask. */
783
+ atStart: boolean;
784
+ /** Width of a classic scrollbar gutter on the scroll region, kept clear of the Edge mask. */
785
+ gutter: number;
786
+ }
787
+
788
+ const PINNED_FIT: ScrollFit = {
789
+ unpinned: false,
790
+ overflowing: false,
791
+ tabStop: false,
792
+ atEnd: true,
793
+ atStart: true,
794
+ gutter: 0,
795
+ };
796
+
797
+ interface ScrollRegions {
798
+ header: React.RefObject<HTMLElement | null>;
799
+ stepper: React.RefObject<HTMLDivElement | null>;
800
+ footer: React.RefObject<HTMLDivElement | null>;
801
+ scroll: React.RefObject<HTMLDivElement | null>;
802
+ }
803
+
804
+ /**
805
+ * Measures the two runtime conditions on the open card: the scroll region overflowing
806
+ * (Edge mask) and, below md only, the pinned chrome taking more than half of the card
807
+ * (unpin). The pinned chrome is the header, the band and — unless `pinnedFooter` is off
808
+ * and it scrolls with the body — the footer (6.2.0). Their heights do not depend on
809
+ * pinning and the card's height is the same capped value either way, so the verdict
810
+ * cannot oscillate between the layouts. Also tracks whether the region is scrolled to its
811
+ * start / end (re-measured on scroll), which hides the top / bottom Edge mask.
812
+ */
813
+ function useScrollFit(
814
+ root: HTMLElement | null,
815
+ regions: ScrollRegions,
816
+ canUnpin: boolean,
817
+ footerPinned: boolean,
818
+ layoutKey: string,
819
+ ): ScrollFit {
820
+ const [fit, setFit] = React.useState<ScrollFit>(PINNED_FIT);
821
+
822
+ React.useLayoutEffect(() => {
823
+ if (!root) {
824
+ setFit(PINNED_FIT);
825
+ return undefined;
826
+ }
827
+ const chromeNodes = [
828
+ regions.header.current,
829
+ regions.stepper.current,
830
+ footerPinned ? regions.footer.current : null,
831
+ ];
832
+ const scroll = regions.scroll.current;
833
+
834
+ const measure = () => {
835
+ const chrome = chromeNodes.reduce((sum, node) => sum + (node?.offsetHeight ?? 0), 0);
836
+ const unpinned = canUnpin && chrome > root.clientHeight / 2;
837
+ const overflowing = !unpinned && scroll != null && scroll.scrollHeight > scroll.clientHeight;
838
+ const next: ScrollFit = {
839
+ unpinned,
840
+ overflowing,
841
+ tabStop: overflowing && scroll != null && firstTabbableExcept(scroll, scroll) == null,
842
+ atEnd: scroll == null ? true : scroll.scrollTop + scroll.clientHeight >= scroll.scrollHeight - 1,
843
+ atStart: scroll == null ? true : scroll.scrollTop < 1,
844
+ gutter: scroll != null ? Math.max(scroll.offsetWidth - scroll.clientWidth, 0) : 0,
845
+ };
846
+ setFit(current =>
847
+ current.unpinned === next.unpinned &&
848
+ current.overflowing === next.overflowing &&
849
+ current.tabStop === next.tabStop &&
850
+ current.atEnd === next.atEnd &&
851
+ current.atStart === next.atStart &&
852
+ current.gutter === next.gutter
853
+ ? current
854
+ : next,
855
+ );
856
+ };
857
+
858
+ measure();
859
+ scroll?.addEventListener('scroll', measure, { passive: true });
860
+ // A control mounting, enabling or hiding inside the region changes whether the region
861
+ // itself has to be the tab stop, without changing any box.
862
+ const mutations = typeof MutationObserver === 'undefined' ? null : new MutationObserver(measure);
863
+ if (scroll) {
864
+ mutations?.observe(scroll, {
865
+ subtree: true,
866
+ childList: true,
867
+ attributes: true,
868
+ attributeFilter: ['disabled', 'hidden', 'tabindex', 'style', 'class'],
869
+ });
870
+ }
871
+ if (typeof ResizeObserver === 'undefined') {
872
+ return () => {
873
+ scroll?.removeEventListener('scroll', measure);
874
+ mutations?.disconnect();
875
+ };
876
+ }
877
+ const observer = new ResizeObserver(measure);
878
+ // The scroll region's children too (body, and the footer when it scrolls): their growth
879
+ // changes scrollHeight, not the scroll region's own box.
880
+ [root, ...chromeNodes, scroll, ...Array.from(scroll?.children ?? [])].forEach((node) => {
881
+ if (node) observer.observe(node);
882
+ });
883
+ return () => {
884
+ scroll?.removeEventListener('scroll', measure);
885
+ mutations?.disconnect();
886
+ observer.disconnect();
887
+ };
888
+ }, [root, regions, canUnpin, footerPinned, layoutKey]);
889
+
890
+ return fit;
891
+ }
892
+
893
+ /**
894
+ * The dialog's name when the Modal has no `title`: the body renders its own heading
895
+ * through it, so the heading is announced once, as the dialog name (a header Type's
896
+ * header then carries only the close control). Unstyled — pass the
897
+ * heading's classes. Without `asChild` Radix renders its default `<h2>`; with `asChild` it wraps the body's own
898
+ * heading element instead, keeping its level.
899
+ */
900
+ const ModalTitle = React.forwardRef<
901
+ React.ComponentRef<typeof DialogPrimitive.Title>,
902
+ React.ComponentPropsWithoutRef<typeof DialogPrimitive.Title>
903
+ >((props, ref) => <DialogPrimitive.Title ref={ref} data-fods-part="title" {...props} />);
904
+ ModalTitle.displayName = 'ModalTitle';
905
+
906
+ /*
907
+ * `motion.enter` / `motion.exit`. Size=Mobile rises from just below the viewport's bottom
908
+ * edge: the card rests centred in the full-viewport frame, so the distance from its resting
909
+ * top to the bottom edge — (viewport height − resting top) — is half the viewport plus half
910
+ * its own height, whatever that height is. Motion measures the calc() into px: an
911
+ * unrecognised unit against a number on a positional key sets `needsMeasurement`
912
+ * (motion-dom 14.11.1 `DOMKeyframesResolver.readKeyframes`), and `positionalValues.y`
913
+ * (`keyframes/utils/unit-conversion`) reads the resolved px from the computed transform.
914
+ */
915
+ const MOBILE_RISE = 'calc(50dvh + 50%)';
916
+ const DESKTOP_AWAY = { opacity: 0, scale: 0.98 };
917
+
918
+ function useModalMotion(mobile: boolean) {
919
+ const reduce = useReducedMotion() ?? false;
920
+ const scrim = scrimFade(reduce);
921
+ // Reduced motion: fade only — no scale, no rise. Otherwise the mobile card has no fade
922
+ // of its own; it rises fully opaque.
923
+ const away = reduce ? { opacity: 0 } : mobile ? { opacity: 1, y: MOBILE_RISE } : DESKTOP_AWAY;
924
+ const panel = {
925
+ initial: away,
926
+ animate: { opacity: 1, scale: 1, y: 0 },
927
+ exit: away,
928
+ transition: reduce ? { duration: curves.duration.instant } : springs.gentle,
929
+ };
930
+ return { scrim, panel };
931
+ }
932
+
933
+ /*
934
+ * `motion.layout` — the Wizard step swap. The outgoing step fades out (--duration-fast +
935
+ * --easing-exit) and is `inert` meanwhile; once it has left the layout, the card's height
936
+ * moves to the new step's through the shared `useHeightRoom` (height, not a transform: a
937
+ * scale would stretch the border, the corners and the scroll region); only then does the
938
+ * incoming step fade in (--duration-slow + --easing-enter). The room measures the card
939
+ * itself, so the `max-h-full` cap holds: a step taller than the cap lands at the cap and
940
+ * scrolls. Reduced motion: the height switches at once and both fades run at
941
+ * --duration-instant.
942
+ */
943
+
944
+ /**
945
+ * One Wizard step in the body. The first step (and every step without a height change)
946
+ * shows at once; after a resize it waits for the room to settle before fading in.
947
+ */
948
+ function WizardStep({ room, children }: { room: HeightRoom; children: React.ReactNode }) {
949
+ const isPresent = useIsPresent();
950
+ const [ready, setReady] = React.useState(() => !room.pending());
951
+
952
+ // A step that comes back while it is still leaving (AnimatePresence keeps the same
953
+ // instance) resumes the held room here, so `ready` waits on that resize too — the one it
954
+ // waited on before was cancelled by `hold` and never settles.
955
+ React.useLayoutEffect(() => {
956
+ if (!isPresent) {
957
+ room.hold();
958
+ return undefined;
959
+ }
960
+ if (!room.pending()) return undefined;
961
+ let live = true;
962
+ const settled = room.resize();
963
+ if (settled) settled.then(() => { if (live) setReady(true); });
964
+ else setReady(true);
965
+ return () => { live = false; };
966
+ }, [isPresent, room]);
967
+
968
+ const fadeIn = room.reduce ? curves.duration.instant : curves.duration.slow;
969
+ const fadeOut = room.reduce ? curves.duration.instant : curves.duration.fast;
970
+ return (
971
+ <motion.div
972
+ className="flex flex-col"
973
+ inert={!isPresent || undefined}
974
+ initial={{ opacity: 0 }}
975
+ animate={ready ? { opacity: 1, transition: { duration: fadeIn, ease: curves.easing.enter } } : { opacity: 0 }}
976
+ exit={{ opacity: 0, transition: { duration: fadeOut, ease: curves.easing.exit } }}
977
+ >
978
+ {children}
979
+ </motion.div>
980
+ );
981
+ }
982
+
983
+ const Modal = React.forwardRef<React.ComponentRef<typeof DialogPrimitive.Content>, ModalProps>(
984
+ (
985
+ {
986
+ open,
987
+ onClose,
988
+ title,
989
+ closeLabel,
990
+ children,
991
+ actions,
992
+ type = 'compact',
993
+ size = 'sm',
994
+ hasClose,
995
+ dismissOnBackdrop,
996
+ pinnedFooter = true,
997
+ role = 'dialog',
998
+ description,
999
+ visual,
1000
+ banner,
1001
+ declineLink,
1002
+ stepIndicator,
1003
+ onBack,
1004
+ backLabel,
1005
+ mobileAction,
1006
+ stepKey,
1007
+ previewContainer,
1008
+ className,
1009
+ },
1010
+ ref,
1011
+ ) => {
1012
+ const isMobileViewport = useIsMobile('md');
1013
+ const mobileWizard = type === 'wizard' && isMobileViewport;
1014
+ // Below md the close is forced: Esc and the scrim are blocked and `mobileAction` replaces
1015
+ // the exit Button, so the header close is the Wizard's only way out.
1016
+ const showClose = mobileWizard || (hasClose ?? type !== 'wizard');
1017
+ // The floating close shares the row with a body-hosted title only when nothing sits above it.
1018
+ const titleReserve =
1019
+ (type === 'compact' || type === 'marketing') &&
1020
+ showClose &&
1021
+ title != null &&
1022
+ visual == null &&
1023
+ banner == null;
1024
+ const dismissible = dismissOnBackdrop ?? !(type === 'wizard' || role === 'alertdialog');
1025
+ const handleCloseAutoFocus = useReturnFocus(open);
1026
+ const modalMotion = useModalMotion(isMobileViewport);
1027
+ const stepRoom = useHeightRoom();
1028
+ const isPreview = previewContainer != null;
1029
+ const portalTarget = usePortalTarget();
1030
+
1031
+ const hasChrome = type === 'center' || type === 'corner' || type === 'wizard';
1032
+ const showBackIcon = mobileWizard && onBack != null;
1033
+ const hasHeader = hasChrome && (title != null || showClose || showBackIcon);
1034
+ const hasBody = children != null;
1035
+ const hasStepper = type === 'wizard' && (stepIndicator != null || (!mobileWizard && onBack != null));
1036
+ const footerAction = orderActions(
1037
+ mobileWizard ? (mobileAction ?? actions) : actions,
1038
+ isMobileViewport,
1039
+ );
1040
+ const hasFooter =
1041
+ hasChrome && (footerAction != null || (type === 'wizard' && declineLink != null));
1042
+
1043
+ /*
1044
+ * `aria-describedby` (`notes[8]`): the header Types point it at the scope line when
1045
+ * there is one; otherwise — and always on Compact/Marketing — at the body's content
1046
+ * column. A header Type without a `title` describes nothing: its body carries the
1047
+ * dialog's name (`ModalTitle`) and is usually a whole form, which must not be read out
1048
+ * as the description. With nothing to point at, the explicit `undefined` is Radix's
1049
+ * documented opt-out.
1050
+ */
1051
+ const describeWithScopeLine = hasHeader && title != null && description != null;
1052
+ const isTitlelessChrome = hasChrome && title == null;
1053
+ const describeWithBody = hasBody && !describeWithScopeLine && !isTitlelessChrome;
1054
+ const described = describeWithScopeLine || describeWithBody;
1055
+
1056
+ const [rootNode, setRootNode] = React.useState<HTMLDivElement | null>(null);
1057
+ const headerRef = React.useRef<HTMLElement | null>(null);
1058
+ const stepperRef = React.useRef<HTMLDivElement | null>(null);
1059
+ const footerRef = React.useRef<HTMLDivElement | null>(null);
1060
+ const scrollRef = React.useRef<HTMLDivElement | null>(null);
1061
+ const regions = React.useMemo(
1062
+ () => ({ header: headerRef, stepper: stepperRef, footer: footerRef, scroll: scrollRef }),
1063
+ [],
1064
+ );
1065
+ const fit = useScrollFit(
1066
+ rootNode,
1067
+ regions,
1068
+ // `chrome.mobile.unpin` is a mobile rule; desktop keeps the header, band and footer
1069
+ // pinned at every viewport height (`chrome.desktop.pinned`). Not gated by `open`: Radix
1070
+ // keeps the card mounted through the close animation, and the unmount resets the fit
1071
+ // through the null root anyway.
1072
+ isMobileViewport,
1073
+ pinnedFooter,
1074
+ // The scroll region's children are observed by node, so a (re)mounted region must
1075
+ // re-subscribe.
1076
+ [hasHeader, hasStepper, hasFooter, hasBody, describeWithBody].map(String).join(),
1077
+ );
1078
+ const setRootRef = React.useCallback(
1079
+ (node: HTMLDivElement | null) => {
1080
+ setRootNode(node);
1081
+ stepRoom.setNode(node);
1082
+ if (typeof ref === 'function') ref(node);
1083
+ else if (ref) ref.current = node;
1084
+ },
1085
+ [ref, stepRoom],
1086
+ );
1087
+
1088
+ const slots = modalVariants({
1089
+ type,
1090
+ // `chrome.mobile.rule`: below md every Modal is its Type's Size=Mobile cell.
1091
+ size: isMobileViewport ? 'mobile' : size,
1092
+ hasClose: showClose,
1093
+ titleReserve,
1094
+ unpinned: isMobileViewport && fit.unpinned,
1095
+ });
1096
+
1097
+ const handleOpenChange = (next: boolean) => {
1098
+ if (!next) {
1099
+ onClose();
1100
+ }
1101
+ };
1102
+
1103
+ const blockUnlessDismissible = (event: Event) => {
1104
+ if (!dismissible) {
1105
+ event.preventDefault();
1106
+ }
1107
+ };
1108
+
1109
+ // Radix hears Escape on document in the capture phase, before floating-ui's useDismiss —
1110
+ // an open panel inside the dialog takes the keypress (floating-ui closes it regardless of
1111
+ // defaultPrevented), the dialog stays, like Radix's own nested layers.
1112
+ const handleEscapeKeyDown = (event: KeyboardEvent) => {
1113
+ if (!dismissible || hasOpenFloatingPanel(rootNode)) {
1114
+ event.preventDefault();
1115
+ }
1116
+ };
1117
+
1118
+ // Below md the primary leads the DOM (`orderActions`), so on Compact/Marketing — whose
1119
+ // close floats last in the DOM — the first tabbable of a destructive confirmation is the
1120
+ // destructive action itself and Enter would confirm it on open. The alertdialog focuses the
1121
+ // dialog instead (`modal.md` § States: "the first interactive element (or the dialog)").
1122
+ // The rule covers every Type: a header Type would focus its close (the mobile Wizard its
1123
+ // back icon), and the dialog is an equally valid start there. The FocusScope's mount event
1124
+ // is dispatched on the Content node, so `currentTarget` is the card.
1125
+ const focusDialogOnOpen = role === 'alertdialog' && isMobileViewport;
1126
+ const handleOpenAutoFocus = (event: Event) => {
1127
+ event.preventDefault();
1128
+ if (!isPreview) (event.currentTarget as HTMLElement | null)?.focus({ preventScroll: true });
1129
+ };
1130
+
1131
+ // A scroll region that overflows with nothing focusable inside is a tab stop
1132
+ // (`scrollbar.md` § Accessibility), but not an interactive element, so it never takes
1133
+ // the initial focus (`modal.md` § States: "the first interactive element (or the
1134
+ // dialog)"). On Compact/Marketing, whose close floats last in the DOM, it would
1135
+ // otherwise be the first tabbable. Radix's own pick stands
1136
+ // whenever the region is not a tab stop.
1137
+ const handleOpenAutoFocusSkipScroll = (event: Event) => {
1138
+ const region = scrollRef.current;
1139
+ const card = event.currentTarget as HTMLElement | null;
1140
+ if (!region || !card || region.tabIndex !== 0) return;
1141
+ event.preventDefault();
1142
+ (firstTabbableExcept(card, region) ?? card).focus({ preventScroll: true });
1143
+ };
1144
+
1145
+ const titleNode = title != null ? (
1146
+ <DialogPrimitive.Title data-fods-part="title" className={slots.title()}>
1147
+ {title}
1148
+ </DialogPrimitive.Title>
1149
+ ) : null;
1150
+
1151
+ const containerNode = hasBody ? (
1152
+ describeWithBody ? (
1153
+ <DialogPrimitive.Description asChild>
1154
+ <div data-fods-part="container" className={slots.container()}>
1155
+ {children}
1156
+ </div>
1157
+ </DialogPrimitive.Description>
1158
+ ) : (
1159
+ <div data-fods-part="container" className={slots.container()}>
1160
+ {children}
1161
+ </div>
1162
+ )
1163
+ ) : null;
1164
+
1165
+ const closeNode = showClose ? (
1166
+ <DialogPrimitive.Close asChild>
1167
+ <IconButton
1168
+ variant="tertiary"
1169
+ size="md"
1170
+ showSurface
1171
+ icon={<Icon name="x" />}
1172
+ aria-label={closeLabel || 'Zavřít'}
1173
+ data-fods-part="close-button"
1174
+ className={slots.closeButton()}
1175
+ />
1176
+ </DialogPrimitive.Close>
1177
+ ) : null;
1178
+
1179
+ const declineNode =
1180
+ declineLink != null ? (
1181
+ <div data-fods-part="decline-link" className={slots.declineLink()}>
1182
+ {declineLink}
1183
+ </div>
1184
+ ) : null;
1185
+
1186
+ /*
1187
+ * Below md the footer's `Actions` slot is ONE column (`chrome.mobile.footer`): the
1188
+ * decline link moves in as its first item, so the link renders in exactly one place.
1189
+ */
1190
+ const actionsNode =
1191
+ footerAction != null || (mobileWizard && declineNode != null) ? (
1192
+ <div data-fods-part="actions" className={hasChrome ? slots.footerActions() : slots.actions()}>
1193
+ {mobileWizard && declineNode}
1194
+ {footerAction}
1195
+ </div>
1196
+ ) : null;
1197
+
1198
+ const backIconNode = showBackIcon ? (
1199
+ <IconButton
1200
+ variant="tertiary"
1201
+ size="md"
1202
+ showSurface
1203
+ icon={<Icon name="arrow-left" />}
1204
+ aria-label={backLabel}
1205
+ onClick={onBack}
1206
+ data-fods-part="back-icon-button"
1207
+ className={slots.backIconButton()}
1208
+ />
1209
+ ) : null;
1210
+
1211
+ const bannerNode =
1212
+ banner != null ? (
1213
+ <div data-fods-part="banner" className={slots.banner()}>
1214
+ {banner}
1215
+ </div>
1216
+ ) : null;
1217
+
1218
+ const footerNode = hasFooter ? (
1219
+ <div ref={footerRef} data-fods-part="footer" className={slots.footer()}>
1220
+ <div className={slots.footerContent()}>
1221
+ {type === 'wizard' && !mobileWizard && declineNode}
1222
+ {actionsNode}
1223
+ </div>
1224
+ </div>
1225
+ ) : null;
1226
+
1227
+ const visualNode =
1228
+ visual != null ? (
1229
+ <div data-fods-part="visual" className={slots.visual()}>
1230
+ {visual}
1231
+ </div>
1232
+ ) : null;
1233
+
1234
+ return (
1235
+ <DialogPrimitive.Root open={open} onOpenChange={handleOpenChange} modal={!isPreview}>
1236
+ {/*
1237
+ * Every Radix part is force-mounted and the whole portal mounts through
1238
+ * AnimatePresence, so the exit plays before Radix unmounts — focus return, scroll
1239
+ * lock and aria-hidden release happen after it, as with the old keyframes.
1240
+ */}
1241
+ <AnimatePresence>
1242
+ {open && (
1243
+ <DialogPrimitive.Portal key="modal" forceMount container={previewContainer ?? portalTarget}>
1244
+ {/*
1245
+ * Sibling of the card, outside its subtree — so it carries
1246
+ * `data-fods-component` itself for the runtime probe's owner lookup.
1247
+ * Radix renders no Overlay for a non-modal dialog, so a preview draws its own.
1248
+ */}
1249
+ {isPreview ? (
1250
+ <motion.div
1251
+ data-fods-component="modal"
1252
+ data-fods-part="scrim"
1253
+ className={slots.scrim()}
1254
+ {...modalMotion.scrim}
1255
+ />
1256
+ ) : (
1257
+ <DialogPrimitive.Overlay
1258
+ forceMount
1259
+ asChild
1260
+ data-fods-component="modal"
1261
+ data-fods-part="scrim"
1262
+ className={slots.scrim()}
1263
+ >
1264
+ <motion.div {...modalMotion.scrim} />
1265
+ </DialogPrimitive.Overlay>
1266
+ )}
1267
+ {/*
1268
+ * The frame is a body-level portal child, and the runtime probe only searches
1269
+ * `body > [data-fods-component]` — without the marker
1270
+ * here the whole card would go unmeasured. Not a part, so no `data-fods-part`.
1271
+ */}
1272
+ <div data-fods-component="modal" className={slots.frame()}>
1273
+ <InertWhileExiting>
1274
+ <DialogPrimitive.Content
1275
+ forceMount
1276
+ asChild
1277
+ ref={setRootRef}
1278
+ role={role}
1279
+ // Radix sets no aria-modal of its own; `notes[8]` requires it.
1280
+ aria-modal={isPreview ? undefined : 'true'}
1281
+ {...(described ? {} : { 'aria-describedby': undefined })}
1282
+ data-fods-component="modal"
1283
+ data-fods-part="root"
1284
+ onEscapeKeyDown={handleEscapeKeyDown}
1285
+ onInteractOutside={blockUnlessDismissible}
1286
+ onOpenAutoFocus={
1287
+ isPreview || focusDialogOnOpen ? handleOpenAutoFocus : handleOpenAutoFocusSkipScroll
1288
+ }
1289
+ onCloseAutoFocus={handleCloseAutoFocus}
1290
+ className={cn(slots.root(), className)}
1291
+ >
1292
+ <motion.div
1293
+ {...modalMotion.panel}
1294
+ style={type === 'wizard' && stepKey !== undefined ? stepRoom.style : undefined}
1295
+ >
1296
+ {hasHeader && (
1297
+ <header ref={headerRef} data-fods-part="header" className={slots.header()}>
1298
+ {backIconNode}
1299
+ <div className={slots.sectionHeader()}>
1300
+ {titleNode}
1301
+ {describeWithScopeLine && (
1302
+ <DialogPrimitive.Description
1303
+ data-fods-part="description"
1304
+ className={slots.description()}
1305
+ >
1306
+ {description}
1307
+ </DialogPrimitive.Description>
1308
+ )}
1309
+ </div>
1310
+ {closeNode}
1311
+ </header>
1312
+ )}
1313
+
1314
+ {hasStepper && (
1315
+ <div ref={stepperRef} data-fods-part="stepper" className={slots.stepper()}>
1316
+ {/* `chrome.mobile.stepper.back`: below md one-step back is the header's Icon Button. */}
1317
+ {onBack != null && !mobileWizard && (
1318
+ <Button
1319
+ variant="tertiary"
1320
+ size="md"
1321
+ leadingIcon={<Icon name="arrow-left" />}
1322
+ onClick={onBack}
1323
+ data-fods-part="back-link"
1324
+ className={slots.backLink()}
1325
+ >
1326
+ {backLabel}
1327
+ </Button>
1328
+ )}
1329
+ {stepIndicator != null && (
1330
+ <div data-fods-part="step-indicator" className={slots.stepIndicator()}>
1331
+ {stepIndicator}
1332
+ </div>
1333
+ )}
1334
+ </div>
1335
+ )}
1336
+
1337
+ <div className={slots.bodyFrame()}>
1338
+ {/* The scroll region: the body, plus the footer at its end when not pinned. */}
1339
+ {/* A tab stop while it overflows and holds nothing focusable, so such a
1340
+ body still scrolls from the keyboard (`scrollbar.md` § Accessibility). */}
1341
+ <div
1342
+ ref={scrollRef}
1343
+ tabIndex={fit.tabStop ? 0 : undefined}
1344
+ className={slots.scroll()}
1345
+ >
1346
+ <div data-fods-part="body" className={slots.body()}>
1347
+ {type === 'compact' && (
1348
+ <>
1349
+ {bannerNode}
1350
+ {visualNode}
1351
+ {titleNode}
1352
+ {containerNode}
1353
+ {actionsNode}
1354
+ </>
1355
+ )}
1356
+ {type === 'marketing' && (
1357
+ <>
1358
+ {bannerNode}
1359
+ {visualNode}
1360
+ <div className={slots.textBlock()}>
1361
+ {titleNode}
1362
+ {containerNode}
1363
+ </div>
1364
+ {(actionsNode != null || declineNode != null) && (
1365
+ <div className={slots.actionCluster()}>
1366
+ {actionsNode}
1367
+ {declineNode}
1368
+ </div>
1369
+ )}
1370
+ </>
1371
+ )}
1372
+ {hasChrome &&
1373
+ (type === 'wizard' && stepKey !== undefined ? (
1374
+ <AnimatePresence mode="wait" initial={false}>
1375
+ <WizardStep key={stepKey} room={stepRoom}>
1376
+ {containerNode}
1377
+ </WizardStep>
1378
+ </AnimatePresence>
1379
+ ) : (
1380
+ containerNode
1381
+ ))}
1382
+ </div>
1383
+
1384
+ {!pinnedFooter && footerNode}
1385
+ </div>
1386
+ {/*
1387
+ * Edge mask: only while the scroll region overflows (never once unpinned)
1388
+ * and is not yet scrolled to its end (6.1.3, `scrollbar.md` § Fade the cut
1389
+ * edge). It sits at the frame's bottom edge — directly above the pinned
1390
+ * footer's divider, or the card's bottom edge when the footer scrolls.
1391
+ * Its mirror at the frame's top edge (6.3.0, `edge-mask-top`) shows once the
1392
+ * region is scrolled away from its start.
1393
+ */}
1394
+ {fit.overflowing && !fit.atStart && (
1395
+ <div
1396
+ aria-hidden="true"
1397
+ data-fods-part="edge-mask-top"
1398
+ className={slots.edgeMaskTop()}
1399
+ style={{ right: fit.gutter }}
1400
+ />
1401
+ )}
1402
+ {fit.overflowing && !fit.atEnd && (
1403
+ <div
1404
+ aria-hidden="true"
1405
+ data-fods-part="edge-mask"
1406
+ className={slots.edgeMask()}
1407
+ style={{ right: fit.gutter }}
1408
+ />
1409
+ )}
1410
+ </div>
1411
+
1412
+ {pinnedFooter && footerNode}
1413
+
1414
+ {/*
1415
+ * Compact/Marketing: the close control floats in the card's top-right
1416
+ * corner, positioned against the card (the `relative` root is its
1417
+ * containing block), overlaid on the content. Last in DOM order so the
1418
+ * tab order runs through the content and CTAs first.
1419
+ */}
1420
+ {!hasHeader && closeNode}
1421
+ </motion.div>
1422
+ </DialogPrimitive.Content>
1423
+ </InertWhileExiting>
1424
+ </div>
1425
+ </DialogPrimitive.Portal>
1426
+ )}
1427
+ </AnimatePresence>
1428
+ </DialogPrimitive.Root>
1429
+ );
1430
+ },
1431
+ );
1432
+ Modal.displayName = 'Modal';
1433
+
1434
+ export { Modal, ModalTitle, modalVariants };