@invoiceonline/ui-react 0.0.0 → 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (738) hide show
  1. package/AGENTS.md +99 -0
  2. package/CHANGELOG.md +131 -0
  3. package/LICENSE +9 -0
  4. package/README.md +77 -1
  5. package/dist/assets/label-brush-1.svg +6 -0
  6. package/dist/assets/pattern-dark.svg +113 -0
  7. package/dist/components/action-row/ActionRow.d.ts +178 -0
  8. package/dist/components/action-row/ActionRow.js +340 -0
  9. package/dist/components/action-row/index.d.ts +2 -0
  10. package/dist/components/action-row/index.js +1 -0
  11. package/dist/components/alert/Alert.d.ts +314 -0
  12. package/dist/components/alert/Alert.js +446 -0
  13. package/dist/components/alert/index.d.ts +2 -0
  14. package/dist/components/alert/index.js +1 -0
  15. package/dist/components/anchored-panel/AnchoredPanel.d.ts +41 -0
  16. package/dist/components/anchored-panel/AnchoredPanel.js +72 -0
  17. package/dist/components/anchored-panel/index.d.ts +3 -0
  18. package/dist/components/anchored-panel/index.js +3 -0
  19. package/dist/components/badge/Badge.d.ts +146 -0
  20. package/dist/components/badge/Badge.js +258 -0
  21. package/dist/components/badge/index.d.ts +2 -0
  22. package/dist/components/badge/index.js +1 -0
  23. package/dist/components/banner/Banner.d.ts +209 -0
  24. package/dist/components/banner/Banner.js +339 -0
  25. package/dist/components/banner/index.d.ts +2 -0
  26. package/dist/components/banner/index.js +1 -0
  27. package/dist/components/button/Button.d.ts +54 -0
  28. package/dist/components/button/Button.js +312 -0
  29. package/dist/components/button/index.d.ts +2 -0
  30. package/dist/components/button/index.js +1 -0
  31. package/dist/components/button-group/ButtonGroup.d.ts +187 -0
  32. package/dist/components/button-group/ButtonGroup.js +217 -0
  33. package/dist/components/button-group/index.d.ts +2 -0
  34. package/dist/components/button-group/index.js +1 -0
  35. package/dist/components/card-select/CardSelect.d.ts +274 -0
  36. package/dist/components/card-select/CardSelect.js +561 -0
  37. package/dist/components/card-select/CardSelectGroup.d.ts +92 -0
  38. package/dist/components/card-select/CardSelectGroup.js +72 -0
  39. package/dist/components/card-select/index.d.ts +3 -0
  40. package/dist/components/card-select/index.js +3 -0
  41. package/dist/components/checkbox/Checkbox.d.ts +104 -0
  42. package/dist/components/checkbox/Checkbox.js +194 -0
  43. package/dist/components/checkbox/index.d.ts +2 -0
  44. package/dist/components/checkbox/index.js +1 -0
  45. package/dist/components/chip/Chip.d.ts +250 -0
  46. package/dist/components/chip/Chip.js +441 -0
  47. package/dist/components/chip/index.d.ts +2 -0
  48. package/dist/components/chip/index.js +1 -0
  49. package/dist/components/column-header/ColumnHeader.d.ts +144 -0
  50. package/dist/components/column-header/ColumnHeader.js +209 -0
  51. package/dist/components/column-header/index.d.ts +2 -0
  52. package/dist/components/column-header/index.js +1 -0
  53. package/dist/components/combobox-field/Combobox.d.ts +104 -0
  54. package/dist/components/combobox-field/Combobox.js +355 -0
  55. package/dist/components/combobox-field/ComboboxField.d.ts +76 -0
  56. package/dist/components/combobox-field/ComboboxField.js +98 -0
  57. package/dist/components/combobox-field/index.d.ts +3 -0
  58. package/dist/components/combobox-field/index.js +3 -0
  59. package/dist/components/date-field/DateField.d.ts +52 -0
  60. package/dist/components/date-field/DateField.js +45 -0
  61. package/dist/components/date-field/index.d.ts +2 -0
  62. package/dist/components/date-field/index.js +1 -0
  63. package/dist/components/date-picker/DatePicker.d.ts +53 -0
  64. package/dist/components/date-picker/DatePicker.js +329 -0
  65. package/dist/components/date-picker/index.d.ts +2 -0
  66. package/dist/components/date-picker/index.js +1 -0
  67. package/dist/components/divider/Divider.d.ts +81 -0
  68. package/dist/components/divider/Divider.js +93 -0
  69. package/dist/components/divider/index.d.ts +2 -0
  70. package/dist/components/divider/index.js +1 -0
  71. package/dist/components/drawer/Drawer.d.ts +128 -0
  72. package/dist/components/drawer/Drawer.js +367 -0
  73. package/dist/components/drawer/index.d.ts +2 -0
  74. package/dist/components/drawer/index.js +1 -0
  75. package/dist/components/dropdown-button/DropdownButton.d.ts +72 -0
  76. package/dist/components/dropdown-button/DropdownButton.js +122 -0
  77. package/dist/components/dropdown-button/index.d.ts +2 -0
  78. package/dist/components/dropdown-button/index.js +1 -0
  79. package/dist/components/faq/FAQ.d.ts +135 -0
  80. package/dist/components/faq/FAQ.js +258 -0
  81. package/dist/components/faq/index.d.ts +2 -0
  82. package/dist/components/faq/index.js +1 -0
  83. package/dist/components/field/Field.d.ts +118 -0
  84. package/dist/components/field/Field.js +327 -0
  85. package/dist/components/field/index.d.ts +2 -0
  86. package/dist/components/field/index.js +1 -0
  87. package/dist/components/field-pair/FieldPair.d.ts +194 -0
  88. package/dist/components/field-pair/FieldPair.js +321 -0
  89. package/dist/components/field-pair/index.d.ts +2 -0
  90. package/dist/components/field-pair/index.js +1 -0
  91. package/dist/components/file-upload/FileUpload.d.ts +137 -0
  92. package/dist/components/file-upload/FileUpload.js +434 -0
  93. package/dist/components/file-upload/index.d.ts +2 -0
  94. package/dist/components/file-upload/index.js +1 -0
  95. package/dist/components/filter-chip/FilterChip.d.ts +373 -0
  96. package/dist/components/filter-chip/FilterChip.js +517 -0
  97. package/dist/components/filter-chip/index.d.ts +2 -0
  98. package/dist/components/filter-chip/index.js +1 -0
  99. package/dist/components/filter-facet/FilterFacet.d.ts +116 -0
  100. package/dist/components/filter-facet/FilterFacet.js +632 -0
  101. package/dist/components/filter-facet/index.d.ts +2 -0
  102. package/dist/components/filter-facet/index.js +1 -0
  103. package/dist/components/firm-avatar/FirmAvatar.d.ts +75 -0
  104. package/dist/components/firm-avatar/FirmAvatar.js +119 -0
  105. package/dist/components/firm-avatar/index.d.ts +2 -0
  106. package/dist/components/firm-avatar/index.js +1 -0
  107. package/dist/components/form-actions/FormActions.d.ts +123 -0
  108. package/dist/components/form-actions/FormActions.js +195 -0
  109. package/dist/components/form-actions/index.d.ts +2 -0
  110. package/dist/components/form-actions/index.js +1 -0
  111. package/dist/components/form-block/FormBlock.d.ts +252 -0
  112. package/dist/components/form-block/FormBlock.js +420 -0
  113. package/dist/components/form-block/index.d.ts +3 -0
  114. package/dist/components/form-block/index.js +3 -0
  115. package/dist/components/form-section/FormSection.d.ts +130 -0
  116. package/dist/components/form-section/FormSection.js +206 -0
  117. package/dist/components/form-section/index.d.ts +2 -0
  118. package/dist/components/form-section/index.js +1 -0
  119. package/dist/components/heading/Heading.d.ts +69 -0
  120. package/dist/components/heading/Heading.js +79 -0
  121. package/dist/components/heading/index.d.ts +2 -0
  122. package/dist/components/heading/index.js +1 -0
  123. package/dist/components/heading-group/HeadingGroup.d.ts +258 -0
  124. package/dist/components/heading-group/HeadingGroup.js +255 -0
  125. package/dist/components/heading-group/index.d.ts +2 -0
  126. package/dist/components/heading-group/index.js +1 -0
  127. package/dist/components/hero/Hero.d.ts +268 -0
  128. package/dist/components/hero/Hero.js +316 -0
  129. package/dist/components/hero/index.d.ts +2 -0
  130. package/dist/components/hero/index.js +1 -0
  131. package/dist/components/icon/Icon.d.ts +27 -0
  132. package/dist/components/icon/Icon.js +30 -0
  133. package/dist/components/icon/index.d.ts +3 -0
  134. package/dist/components/icon/index.js +3 -0
  135. package/dist/components/icon-button/IconButton.d.ts +75 -0
  136. package/dist/components/icon-button/IconButton.js +151 -0
  137. package/dist/components/icon-button/index.d.ts +2 -0
  138. package/dist/components/icon-button/index.js +1 -0
  139. package/dist/components/item-row/ItemRow.d.ts +253 -0
  140. package/dist/components/item-row/ItemRow.js +496 -0
  141. package/dist/components/item-row/index.d.ts +2 -0
  142. package/dist/components/item-row/index.js +1 -0
  143. package/dist/components/list-row/ListRow.d.ts +165 -0
  144. package/dist/components/list-row/ListRow.js +233 -0
  145. package/dist/components/list-row/index.d.ts +2 -0
  146. package/dist/components/list-row/index.js +1 -0
  147. package/dist/components/menu/Menu.d.ts +64 -0
  148. package/dist/components/menu/Menu.js +186 -0
  149. package/dist/components/menu/index.d.ts +2 -0
  150. package/dist/components/menu/index.js +1 -0
  151. package/dist/components/modal/Modal.d.ts +272 -0
  152. package/dist/components/modal/Modal.js +788 -0
  153. package/dist/components/modal/index.d.ts +2 -0
  154. package/dist/components/modal/index.js +1 -0
  155. package/dist/components/nav-link/NavLink.d.ts +123 -0
  156. package/dist/components/nav-link/NavLink.js +157 -0
  157. package/dist/components/nav-link/index.d.ts +2 -0
  158. package/dist/components/nav-link/index.js +1 -0
  159. package/dist/components/number-field/NumberField.d.ts +62 -0
  160. package/dist/components/number-field/NumberField.js +210 -0
  161. package/dist/components/number-field/index.d.ts +2 -0
  162. package/dist/components/number-field/index.js +1 -0
  163. package/dist/components/pagination/Pagination.d.ts +133 -0
  164. package/dist/components/pagination/Pagination.js +217 -0
  165. package/dist/components/pagination/index.d.ts +3 -0
  166. package/dist/components/pagination/index.js +3 -0
  167. package/dist/components/popover-surface/index.d.ts +2 -0
  168. package/dist/components/popover-surface/index.js +1 -0
  169. package/dist/components/progress-bar/ProgressBar.d.ts +260 -0
  170. package/dist/components/progress-bar/ProgressBar.js +470 -0
  171. package/dist/components/progress-bar/index.d.ts +2 -0
  172. package/dist/components/progress-bar/index.js +1 -0
  173. package/dist/components/promo-sticker/PromoSticker.d.ts +204 -0
  174. package/dist/components/promo-sticker/PromoSticker.js +177 -0
  175. package/dist/components/promo-sticker/index.d.ts +2 -0
  176. package/dist/components/promo-sticker/index.js +1 -0
  177. package/dist/components/promo-surface/PromoSurface.d.ts +94 -0
  178. package/dist/components/promo-surface/PromoSurface.js +119 -0
  179. package/dist/components/promo-surface/index.d.ts +2 -0
  180. package/dist/components/promo-surface/index.js +1 -0
  181. package/dist/components/radio/Radio.d.ts +92 -0
  182. package/dist/components/radio/Radio.js +171 -0
  183. package/dist/components/radio/index.d.ts +2 -0
  184. package/dist/components/radio/index.js +1 -0
  185. package/dist/components/radio-group/RadioGroup.d.ts +61 -0
  186. package/dist/components/radio-group/RadioGroup.js +51 -0
  187. package/dist/components/radio-group/index.d.ts +2 -0
  188. package/dist/components/radio-group/index.js +1 -0
  189. package/dist/components/select/Select.d.ts +65 -0
  190. package/dist/components/select/Select.js +176 -0
  191. package/dist/components/select/index.d.ts +2 -0
  192. package/dist/components/select/index.js +1 -0
  193. package/dist/components/select-field/SelectField.d.ts +16 -0
  194. package/dist/components/select-field/SelectField.js +55 -0
  195. package/dist/components/select-field/index.d.ts +2 -0
  196. package/dist/components/select-field/index.js +1 -0
  197. package/dist/components/skeleton/Skeleton.d.ts +64 -0
  198. package/dist/components/skeleton/Skeleton.js +65 -0
  199. package/dist/components/skeleton/index.d.ts +2 -0
  200. package/dist/components/skeleton/index.js +1 -0
  201. package/dist/components/split-button/SplitButton.d.ts +80 -0
  202. package/dist/components/split-button/SplitButton.js +182 -0
  203. package/dist/components/split-button/index.d.ts +2 -0
  204. package/dist/components/split-button/index.js +1 -0
  205. package/dist/components/status-summary-bar/StatusSummaryBar.d.ts +118 -0
  206. package/dist/components/status-summary-bar/StatusSummaryBar.js +278 -0
  207. package/dist/components/status-summary-bar/index.d.ts +2 -0
  208. package/dist/components/status-summary-bar/index.js +1 -0
  209. package/dist/components/subject-lookup-field/SubjectLookupField.d.ts +157 -0
  210. package/dist/components/subject-lookup-field/SubjectLookupField.js +663 -0
  211. package/dist/components/subject-lookup-field/index.d.ts +2 -0
  212. package/dist/components/subject-lookup-field/index.js +1 -0
  213. package/dist/components/switch/Switch.d.ts +152 -0
  214. package/dist/components/switch/Switch.js +307 -0
  215. package/dist/components/switch/index.d.ts +2 -0
  216. package/dist/components/switch/index.js +1 -0
  217. package/dist/components/table/Table.d.ts +5 -0
  218. package/dist/components/table/Table.js +601 -0
  219. package/dist/components/table/index.d.ts +6 -0
  220. package/dist/components/table/index.js +6 -0
  221. package/dist/components/text-field/TextField.d.ts +65 -0
  222. package/dist/components/text-field/TextField.js +173 -0
  223. package/dist/components/text-field/index.d.ts +2 -0
  224. package/dist/components/text-field/index.js +1 -0
  225. package/dist/components/text-link/TextLink.d.ts +260 -0
  226. package/dist/components/text-link/TextLink.js +303 -0
  227. package/dist/components/text-link/index.d.ts +2 -0
  228. package/dist/components/text-link/index.js +1 -0
  229. package/dist/components/textarea/Textarea.d.ts +93 -0
  230. package/dist/components/textarea/Textarea.js +256 -0
  231. package/dist/components/textarea/index.d.ts +2 -0
  232. package/dist/components/textarea/index.js +1 -0
  233. package/dist/components/tooltip/Tooltip.d.ts +129 -0
  234. package/dist/components/tooltip/Tooltip.js +457 -0
  235. package/dist/components/tooltip/index.d.ts +2 -0
  236. package/dist/components/tooltip/index.js +1 -0
  237. package/dist/components/unit-field/UnitField.d.ts +46 -0
  238. package/dist/components/unit-field/UnitField.js +133 -0
  239. package/dist/components/unit-field/index.d.ts +2 -0
  240. package/dist/components/unit-field/index.js +1 -0
  241. package/dist/icons/icon-registry.generated.js +500 -0
  242. package/dist/icons/icon-types.generated.d.ts +2 -0
  243. package/dist/icons/icon-types.generated.js +126 -0
  244. package/dist/index.d.ts +132 -0
  245. package/dist/index.js +75 -0
  246. package/dist/internal/BottomSheet.js +496 -0
  247. package/dist/internal/FodsProvider.d.ts +25 -0
  248. package/dist/internal/FodsProvider.js +32 -0
  249. package/dist/internal/MotionCaret.js +35 -0
  250. package/dist/internal/NumberFormatInput.d.ts +21 -0
  251. package/dist/internal/NumberFormatInput.js +126 -0
  252. package/dist/internal/SummaryDonut.d.ts +3 -0
  253. package/dist/internal/SummaryDonut.js +300 -0
  254. package/dist/internal/buttonSegment.d.ts +44 -0
  255. package/dist/internal/buttonSegment.js +126 -0
  256. package/dist/internal/collapseRoom.js +128 -0
  257. package/dist/internal/comboboxKeys.js +44 -0
  258. package/dist/internal/contentPresence.js +46 -0
  259. package/dist/internal/dayCell.js +95 -0
  260. package/dist/internal/dialogPortal.d.ts +2 -0
  261. package/dist/internal/dialogPortal.js +21 -0
  262. package/dist/internal/donutSweeps.js +65 -0
  263. package/dist/internal/enterOnViewGeometry.js +46 -0
  264. package/dist/internal/faqItem.js +80 -0
  265. package/dist/internal/floatingLabelMotion.js +68 -0
  266. package/dist/internal/formBlockContext.d.ts +22 -0
  267. package/dist/internal/formBlockContext.js +20 -0
  268. package/dist/internal/heightRoom.js +87 -0
  269. package/dist/internal/numberSeparators.js +62 -0
  270. package/dist/internal/overlayMotion.js +48 -0
  271. package/dist/internal/paginationItem.d.ts +8 -0
  272. package/dist/internal/paginationItem.js +22 -0
  273. package/dist/internal/popoverSurface.d.ts +8 -0
  274. package/dist/internal/popoverSurface.js +23 -0
  275. package/dist/internal/portalContainer.d.ts +1 -0
  276. package/dist/internal/portalContainer.js +6 -0
  277. package/dist/internal/progressBarItem.d.ts +207 -0
  278. package/dist/internal/progressBarItem.js +264 -0
  279. package/dist/internal/selectionControlText.js +12 -0
  280. package/dist/internal/statusSummaryParts.js +371 -0
  281. package/dist/internal/summaryMotion.js +75 -0
  282. package/dist/internal/table/ChildConnector.js +62 -0
  283. package/dist/internal/table/ChildRowPrefix.d.ts +9 -0
  284. package/dist/internal/table/ChildRowPrefix.js +27 -0
  285. package/dist/internal/table/ColumnSettings.js +135 -0
  286. package/dist/internal/table/ScrollRegion.js +114 -0
  287. package/dist/internal/table/TableEmpty.js +93 -0
  288. package/dist/internal/table/TableLayout.d.ts +17 -0
  289. package/dist/internal/table/TableLayout.js +29 -0
  290. package/dist/internal/table/TableLoadStatus.js +56 -0
  291. package/dist/internal/table/TableMobile.js +488 -0
  292. package/dist/internal/table/TruncatedCell.js +33 -0
  293. package/dist/internal/table/emptyValue.js +10 -0
  294. package/dist/internal/table/features.d.ts +41 -0
  295. package/dist/internal/table/features.js +31 -0
  296. package/dist/internal/table/recipes.js +227 -0
  297. package/dist/internal/table/rowClick.js +9 -0
  298. package/dist/internal/table/types.d.ts +325 -0
  299. package/dist/internal/table/types.js +13 -0
  300. package/dist/internal/tailwind-variants.d.ts +3 -0
  301. package/dist/internal/tailwind-variants.js +37 -0
  302. package/dist/internal/tooltipContext.js +5 -0
  303. package/dist/internal/tw-merge-config.generated.js +314 -0
  304. package/dist/internal/useAnchoredPanel.d.ts +87 -0
  305. package/dist/internal/useAnchoredPanel.js +108 -0
  306. package/dist/internal/useCountUp.js +53 -0
  307. package/dist/internal/useDateFieldTrigger.js +183 -0
  308. package/dist/internal/useEChart.js +59 -0
  309. package/dist/internal/useEnterOnView.js +42 -0
  310. package/dist/internal/useFloatingBar.js +100 -0
  311. package/dist/internal/useFormReset.js +37 -0
  312. package/dist/internal/useIsMobile.js +44 -0
  313. package/dist/internal/useOneRowOverflow.js +88 -0
  314. package/dist/internal/usePrefersReducedMotion.js +25 -0
  315. package/dist/internal/useReturnFocus.js +26 -0
  316. package/dist/internal/utils.d.ts +7 -0
  317. package/dist/internal/utils.js +58 -0
  318. package/dist/node_modules/@tanstack/store/dist/store.d.ts +29 -0
  319. package/dist/node_modules/@tanstack/store/dist/types.d.ts +38 -0
  320. package/dist/node_modules/@tanstack/table-core/dist/core/cells/coreCellsFeature.d.ts +6 -0
  321. package/dist/node_modules/@tanstack/table-core/dist/core/cells/coreCellsFeature.types.d.ts +53 -0
  322. package/dist/node_modules/@tanstack/table-core/dist/core/columns/coreColumnsFeature.d.ts +6 -0
  323. package/dist/node_modules/@tanstack/table-core/dist/core/columns/coreColumnsFeature.types.d.ts +90 -0
  324. package/dist/node_modules/@tanstack/table-core/dist/core/coreFeatures.d.ts +17 -0
  325. package/dist/node_modules/@tanstack/table-core/dist/core/headers/coreHeadersFeature.d.ts +6 -0
  326. package/dist/node_modules/@tanstack/table-core/dist/core/headers/coreHeadersFeature.types.d.ts +114 -0
  327. package/dist/node_modules/@tanstack/table-core/dist/core/reactivity/coreReactivityFeature.types.d.ts +51 -0
  328. package/dist/node_modules/@tanstack/table-core/dist/core/row-models/coreRowModelsFeature.d.ts +6 -0
  329. package/dist/node_modules/@tanstack/table-core/dist/core/row-models/coreRowModelsFeature.types.d.ts +29 -0
  330. package/dist/node_modules/@tanstack/table-core/dist/core/rows/coreRowsFeature.d.ts +6 -0
  331. package/dist/node_modules/@tanstack/table-core/dist/core/rows/coreRowsFeature.types.d.ts +129 -0
  332. package/dist/node_modules/@tanstack/table-core/dist/core/table/coreTablesFeature.d.ts +6 -0
  333. package/dist/node_modules/@tanstack/table-core/dist/core/table/coreTablesFeature.types.d.ts +203 -0
  334. package/dist/node_modules/@tanstack/table-core/dist/features/cell-selection/cellSelectionFeature.d.ts +6 -0
  335. package/dist/node_modules/@tanstack/table-core/dist/features/cell-selection/cellSelectionFeature.types.d.ts +294 -0
  336. package/dist/node_modules/@tanstack/table-core/dist/features/cell-spanning/cellSpanningFeature.d.ts +11 -0
  337. package/dist/node_modules/@tanstack/table-core/dist/features/cell-spanning/cellSpanningFeature.types.d.ts +148 -0
  338. package/dist/node_modules/@tanstack/table-core/dist/features/column-faceting/columnFacetingFeature.d.ts +12 -0
  339. package/dist/node_modules/@tanstack/table-core/dist/features/column-faceting/columnFacetingFeature.types.d.ts +63 -0
  340. package/dist/node_modules/@tanstack/table-core/dist/features/column-filtering/columnFilteringFeature.d.ts +6 -0
  341. package/dist/node_modules/@tanstack/table-core/dist/features/column-filtering/columnFilteringFeature.types.d.ts +209 -0
  342. package/dist/node_modules/@tanstack/table-core/dist/features/column-filtering/filterFns.d.ts +35 -0
  343. package/dist/node_modules/@tanstack/table-core/dist/features/column-grouping/columnGroupingFeature.d.ts +6 -0
  344. package/dist/node_modules/@tanstack/table-core/dist/features/column-grouping/columnGroupingFeature.types.d.ts +128 -0
  345. package/dist/node_modules/@tanstack/table-core/dist/features/column-ordering/columnOrderingFeature.d.ts +6 -0
  346. package/dist/node_modules/@tanstack/table-core/dist/features/column-ordering/columnOrderingFeature.types.d.ts +82 -0
  347. package/dist/node_modules/@tanstack/table-core/dist/features/column-pinning/columnPinningFeature.d.ts +11 -0
  348. package/dist/node_modules/@tanstack/table-core/dist/features/column-pinning/columnPinningFeature.types.d.ts +195 -0
  349. package/dist/node_modules/@tanstack/table-core/dist/features/column-resizing/columnResizingFeature.d.ts +6 -0
  350. package/dist/node_modules/@tanstack/table-core/dist/features/column-resizing/columnResizingFeature.types.d.ts +73 -0
  351. package/dist/node_modules/@tanstack/table-core/dist/features/column-sizing/columnSizingFeature.d.ts +6 -0
  352. package/dist/node_modules/@tanstack/table-core/dist/features/column-sizing/columnSizingFeature.types.d.ts +134 -0
  353. package/dist/node_modules/@tanstack/table-core/dist/features/column-visibility/columnVisibilityFeature.d.ts +6 -0
  354. package/dist/node_modules/@tanstack/table-core/dist/features/column-visibility/columnVisibilityFeature.types.d.ts +92 -0
  355. package/dist/node_modules/@tanstack/table-core/dist/features/global-filtering/globalFilteringFeature.d.ts +6 -0
  356. package/dist/node_modules/@tanstack/table-core/dist/features/global-filtering/globalFilteringFeature.types.d.ts +67 -0
  357. package/dist/node_modules/@tanstack/table-core/dist/features/row-aggregation/aggregationFns.d.ts +23 -0
  358. package/dist/node_modules/@tanstack/table-core/dist/features/row-aggregation/rowAggregationFeature.d.ts +6 -0
  359. package/dist/node_modules/@tanstack/table-core/dist/features/row-aggregation/rowAggregationFeature.types.d.ts +183 -0
  360. package/dist/node_modules/@tanstack/table-core/dist/features/row-aggregation/rowAggregationFeature.utils.d.ts +18 -0
  361. package/dist/node_modules/@tanstack/table-core/dist/features/row-expanding/rowExpandingFeature.d.ts +6 -0
  362. package/dist/node_modules/@tanstack/table-core/dist/features/row-expanding/rowExpandingFeature.types.d.ts +125 -0
  363. package/dist/node_modules/@tanstack/table-core/dist/features/row-pagination/rowPaginationFeature.d.ts +6 -0
  364. package/dist/node_modules/@tanstack/table-core/dist/features/row-pagination/rowPaginationFeature.types.d.ts +135 -0
  365. package/dist/node_modules/@tanstack/table-core/dist/features/row-pinning/rowPinningFeature.d.ts +6 -0
  366. package/dist/node_modules/@tanstack/table-core/dist/features/row-pinning/rowPinningFeature.types.d.ts +76 -0
  367. package/dist/node_modules/@tanstack/table-core/dist/features/row-selection/rowSelectionFeature.d.ts +6 -0
  368. package/dist/node_modules/@tanstack/table-core/dist/features/row-selection/rowSelectionFeature.types.d.ts +187 -0
  369. package/dist/node_modules/@tanstack/table-core/dist/features/row-sorting/rowSortingFeature.d.ts +6 -0
  370. package/dist/node_modules/@tanstack/table-core/dist/features/row-sorting/rowSortingFeature.types.d.ts +236 -0
  371. package/dist/node_modules/@tanstack/table-core/dist/features/row-sorting/sortFns.d.ts +23 -0
  372. package/dist/node_modules/@tanstack/table-core/dist/features/stockFeatures.d.ts +37 -0
  373. package/dist/node_modules/@tanstack/table-core/dist/helpers/columnHelper.d.ts +47 -0
  374. package/dist/node_modules/@tanstack/table-core/dist/types/Cell.d.ts +16 -0
  375. package/dist/node_modules/@tanstack/table-core/dist/types/Column.d.ts +30 -0
  376. package/dist/node_modules/@tanstack/table-core/dist/types/ColumnDef.d.ts +123 -0
  377. package/dist/node_modules/@tanstack/table-core/dist/types/Header.d.ts +12 -0
  378. package/dist/node_modules/@tanstack/table-core/dist/types/HeaderGroup.d.ts +6 -0
  379. package/dist/node_modules/@tanstack/table-core/dist/types/Row.d.ts +24 -0
  380. package/dist/node_modules/@tanstack/table-core/dist/types/RowModel.d.ts +19 -0
  381. package/dist/node_modules/@tanstack/table-core/dist/types/RowModelFns.d.ts +11 -0
  382. package/dist/node_modules/@tanstack/table-core/dist/types/Table.d.ts +53 -0
  383. package/dist/node_modules/@tanstack/table-core/dist/types/TableFeatures.d.ts +416 -0
  384. package/dist/node_modules/@tanstack/table-core/dist/types/TableOptions.d.ts +78 -0
  385. package/dist/node_modules/@tanstack/table-core/dist/types/TableState.d.ts +46 -0
  386. package/dist/node_modules/@tanstack/table-core/dist/types/type-utils.d.ts +25 -0
  387. package/dist/shared.css +179 -0
  388. package/dist/styles.css +5467 -0
  389. package/dist/theme.css +314 -0
  390. package/dist/theme.map.json +278 -0
  391. package/dist/tokens/index.d.ts +2 -0
  392. package/dist/tokens/index.js +1 -0
  393. package/dist/tokens/tokens.generated.d.ts +2040 -0
  394. package/dist/tokens/tokens.generated.js +2053 -0
  395. package/dist/tokens.css +484 -0
  396. package/dist/tokens.flat.json +429 -0
  397. package/docs/Consuming.mdx +379 -0
  398. package/docs/Contributing.mdx +78 -0
  399. package/docs/ForAgents.mdx +53 -0
  400. package/docs/Introduction.mdx +54 -0
  401. package/llms.txt +556 -0
  402. package/package.json +351 -3
  403. package/src/components/action-row/ActionRow.mdx +686 -0
  404. package/src/components/action-row/ActionRow.stories.tsx +669 -0
  405. package/src/components/action-row/ActionRow.tsx +632 -0
  406. package/src/components/action-row/index.ts +9 -0
  407. package/src/components/alert/Alert.mdx +377 -0
  408. package/src/components/alert/Alert.stories.tsx +674 -0
  409. package/src/components/alert/Alert.tsx +579 -0
  410. package/src/components/alert/index.ts +13 -0
  411. package/src/components/anchored-panel/AnchoredPanel.mdx +381 -0
  412. package/src/components/anchored-panel/AnchoredPanel.stories.tsx +593 -0
  413. package/src/components/anchored-panel/AnchoredPanel.tsx +176 -0
  414. package/src/components/anchored-panel/index.ts +15 -0
  415. package/src/components/badge/Badge.mdx +487 -0
  416. package/src/components/badge/Badge.stories.tsx +375 -0
  417. package/src/components/badge/Badge.tsx +360 -0
  418. package/src/components/badge/index.ts +10 -0
  419. package/src/components/banner/Banner.mdx +704 -0
  420. package/src/components/banner/Banner.stories.tsx +448 -0
  421. package/src/components/banner/Banner.tsx +602 -0
  422. package/src/components/banner/index.ts +14 -0
  423. package/src/components/button/Button.mdx +286 -0
  424. package/src/components/button/Button.stories.tsx +381 -0
  425. package/src/components/button/Button.tsx +384 -0
  426. package/src/components/button/index.ts +1 -0
  427. package/src/components/button-group/ButtonGroup.mdx +512 -0
  428. package/src/components/button-group/ButtonGroup.stories.tsx +714 -0
  429. package/src/components/button-group/ButtonGroup.tsx +491 -0
  430. package/src/components/button-group/index.ts +10 -0
  431. package/src/components/card-select/CardSelect.mdx +662 -0
  432. package/src/components/card-select/CardSelect.stories.tsx +784 -0
  433. package/src/components/card-select/CardSelect.tsx +783 -0
  434. package/src/components/card-select/CardSelectGroup.tsx +169 -0
  435. package/src/components/card-select/index.ts +18 -0
  436. package/src/components/checkbox/Checkbox.mdx +269 -0
  437. package/src/components/checkbox/Checkbox.stories.tsx +306 -0
  438. package/src/components/checkbox/Checkbox.tsx +343 -0
  439. package/src/components/checkbox/index.ts +1 -0
  440. package/src/components/chip/Chip.mdx +683 -0
  441. package/src/components/chip/Chip.stories.tsx +734 -0
  442. package/src/components/chip/Chip.tsx +732 -0
  443. package/src/components/chip/index.ts +9 -0
  444. package/src/components/column-header/ColumnHeader.mdx +301 -0
  445. package/src/components/column-header/ColumnHeader.stories.tsx +319 -0
  446. package/src/components/column-header/ColumnHeader.tsx +287 -0
  447. package/src/components/column-header/index.ts +7 -0
  448. package/src/components/combobox-field/Combobox.tsx +693 -0
  449. package/src/components/combobox-field/ComboboxField.mdx +525 -0
  450. package/src/components/combobox-field/ComboboxField.stories.tsx +502 -0
  451. package/src/components/combobox-field/ComboboxField.tsx +259 -0
  452. package/src/components/combobox-field/index.ts +12 -0
  453. package/src/components/date-field/DateField.mdx +340 -0
  454. package/src/components/date-field/DateField.stories.tsx +221 -0
  455. package/src/components/date-field/DateField.tsx +176 -0
  456. package/src/components/date-field/index.ts +1 -0
  457. package/src/components/date-picker/DatePicker.mdx +436 -0
  458. package/src/components/date-picker/DatePicker.stories.tsx +458 -0
  459. package/src/components/date-picker/DatePicker.tsx +688 -0
  460. package/src/components/date-picker/index.ts +9 -0
  461. package/src/components/divider/Divider.mdx +256 -0
  462. package/src/components/divider/Divider.stories.tsx +177 -0
  463. package/src/components/divider/Divider.tsx +193 -0
  464. package/src/components/divider/index.ts +1 -0
  465. package/src/components/drawer/Drawer.mdx +518 -0
  466. package/src/components/drawer/Drawer.stories.tsx +392 -0
  467. package/src/components/drawer/Drawer.tsx +683 -0
  468. package/src/components/drawer/index.ts +1 -0
  469. package/src/components/dropdown-button/DropdownButton.mdx +285 -0
  470. package/src/components/dropdown-button/DropdownButton.stories.tsx +398 -0
  471. package/src/components/dropdown-button/DropdownButton.tsx +198 -0
  472. package/src/components/dropdown-button/index.ts +7 -0
  473. package/src/components/faq/FAQ.mdx +364 -0
  474. package/src/components/faq/FAQ.stories.tsx +343 -0
  475. package/src/components/faq/FAQ.tsx +337 -0
  476. package/src/components/faq/index.ts +1 -0
  477. package/src/components/field/Field.mdx +129 -0
  478. package/src/components/field/Field.stories.tsx +461 -0
  479. package/src/components/field/Field.tsx +765 -0
  480. package/src/components/field/index.ts +20 -0
  481. package/src/components/field-pair/FieldPair.mdx +308 -0
  482. package/src/components/field-pair/FieldPair.stories.tsx +530 -0
  483. package/src/components/field-pair/FieldPair.tsx +796 -0
  484. package/src/components/field-pair/index.ts +9 -0
  485. package/src/components/file-upload/FileUpload.mdx +345 -0
  486. package/src/components/file-upload/FileUpload.stories.tsx +698 -0
  487. package/src/components/file-upload/FileUpload.tsx +802 -0
  488. package/src/components/file-upload/index.ts +6 -0
  489. package/src/components/filter-chip/FilterChip.mdx +778 -0
  490. package/src/components/filter-chip/FilterChip.stories.tsx +827 -0
  491. package/src/components/filter-chip/FilterChip.tsx +881 -0
  492. package/src/components/filter-chip/index.ts +11 -0
  493. package/src/components/filter-facet/FilterFacet.mdx +536 -0
  494. package/src/components/filter-facet/FilterFacet.stories.tsx +506 -0
  495. package/src/components/filter-facet/FilterFacet.tsx +1160 -0
  496. package/src/components/filter-facet/index.ts +7 -0
  497. package/src/components/firm-avatar/FirmAvatar.mdx +280 -0
  498. package/src/components/firm-avatar/FirmAvatar.stories.tsx +147 -0
  499. package/src/components/firm-avatar/FirmAvatar.tsx +172 -0
  500. package/src/components/firm-avatar/index.ts +7 -0
  501. package/src/components/form-actions/FormActions.mdx +518 -0
  502. package/src/components/form-actions/FormActions.stories.tsx +621 -0
  503. package/src/components/form-actions/FormActions.tsx +273 -0
  504. package/src/components/form-actions/index.ts +6 -0
  505. package/src/components/form-block/FormBlock.mdx +728 -0
  506. package/src/components/form-block/FormBlock.stories.tsx +813 -0
  507. package/src/components/form-block/FormBlock.tsx +679 -0
  508. package/src/components/form-block/index.ts +13 -0
  509. package/src/components/form-section/FormSection.mdx +436 -0
  510. package/src/components/form-section/FormSection.stories.tsx +407 -0
  511. package/src/components/form-section/FormSection.tsx +290 -0
  512. package/src/components/form-section/index.ts +17 -0
  513. package/src/components/heading/Heading.mdx +206 -0
  514. package/src/components/heading/Heading.stories.tsx +169 -0
  515. package/src/components/heading/Heading.tsx +124 -0
  516. package/src/components/heading/index.ts +8 -0
  517. package/src/components/heading-group/HeadingGroup.mdx +521 -0
  518. package/src/components/heading-group/HeadingGroup.stories.tsx +353 -0
  519. package/src/components/heading-group/HeadingGroup.tsx +396 -0
  520. package/src/components/heading-group/index.ts +7 -0
  521. package/src/components/hero/Hero.mdx +742 -0
  522. package/src/components/hero/Hero.stories.tsx +527 -0
  523. package/src/components/hero/Hero.tsx +807 -0
  524. package/src/components/hero/index.ts +1 -0
  525. package/src/components/icon/Icon.mdx +329 -0
  526. package/src/components/icon/Icon.stories.tsx +398 -0
  527. package/src/components/icon/Icon.tsx +97 -0
  528. package/src/components/icon/index.ts +2 -0
  529. package/src/components/icon-button/IconButton.mdx +206 -0
  530. package/src/components/icon-button/IconButton.stories.tsx +341 -0
  531. package/src/components/icon-button/IconButton.tsx +273 -0
  532. package/src/components/icon-button/index.ts +1 -0
  533. package/src/components/item-row/ItemRow.mdx +533 -0
  534. package/src/components/item-row/ItemRow.stories.tsx +434 -0
  535. package/src/components/item-row/ItemRow.tsx +676 -0
  536. package/src/components/item-row/index.ts +9 -0
  537. package/src/components/list-row/ListRow.mdx +404 -0
  538. package/src/components/list-row/ListRow.stories.tsx +404 -0
  539. package/src/components/list-row/ListRow.tsx +424 -0
  540. package/src/components/list-row/index.ts +1 -0
  541. package/src/components/menu/Menu.mdx +268 -0
  542. package/src/components/menu/Menu.stories.tsx +455 -0
  543. package/src/components/menu/Menu.tsx +452 -0
  544. package/src/components/menu/index.ts +1 -0
  545. package/src/components/modal/Modal.mdx +854 -0
  546. package/src/components/modal/Modal.stories.tsx +881 -0
  547. package/src/components/modal/Modal.tsx +1434 -0
  548. package/src/components/modal/index.ts +1 -0
  549. package/src/components/nav-link/NavLink.mdx +196 -0
  550. package/src/components/nav-link/NavLink.stories.tsx +243 -0
  551. package/src/components/nav-link/NavLink.tsx +222 -0
  552. package/src/components/nav-link/index.ts +1 -0
  553. package/src/components/number-field/NumberField.mdx +223 -0
  554. package/src/components/number-field/NumberField.stories.tsx +291 -0
  555. package/src/components/number-field/NumberField.tsx +388 -0
  556. package/src/components/number-field/index.ts +6 -0
  557. package/src/components/pagination/Pagination.mdx +305 -0
  558. package/src/components/pagination/Pagination.stories.tsx +333 -0
  559. package/src/components/pagination/Pagination.tsx +343 -0
  560. package/src/components/pagination/index.ts +8 -0
  561. package/src/components/popover-surface/PopoverSurface.mdx +158 -0
  562. package/src/components/popover-surface/PopoverSurface.stories.tsx +421 -0
  563. package/src/components/popover-surface/index.ts +1 -0
  564. package/src/components/progress-bar/ProgressBar.mdx +802 -0
  565. package/src/components/progress-bar/ProgressBar.stories.tsx +533 -0
  566. package/src/components/progress-bar/ProgressBar.tsx +654 -0
  567. package/src/components/progress-bar/index.ts +9 -0
  568. package/src/components/promo-sticker/PromoSticker.mdx +436 -0
  569. package/src/components/promo-sticker/PromoSticker.stories.tsx +363 -0
  570. package/src/components/promo-sticker/PromoSticker.tsx +313 -0
  571. package/src/components/promo-sticker/index.ts +7 -0
  572. package/src/components/promo-surface/PromoSurface.mdx +399 -0
  573. package/src/components/promo-surface/PromoSurface.stories.tsx +270 -0
  574. package/src/components/promo-surface/PromoSurface.tsx +305 -0
  575. package/src/components/promo-surface/index.ts +7 -0
  576. package/src/components/radio/Radio.mdx +243 -0
  577. package/src/components/radio/Radio.stories.tsx +307 -0
  578. package/src/components/radio/Radio.tsx +288 -0
  579. package/src/components/radio/index.ts +1 -0
  580. package/src/components/radio-group/RadioGroup.mdx +119 -0
  581. package/src/components/radio-group/RadioGroup.stories.tsx +225 -0
  582. package/src/components/radio-group/RadioGroup.tsx +139 -0
  583. package/src/components/radio-group/index.ts +1 -0
  584. package/src/components/select/Select.mdx +241 -0
  585. package/src/components/select/Select.stories.tsx +404 -0
  586. package/src/components/select/Select.tsx +381 -0
  587. package/src/components/select/index.ts +1 -0
  588. package/src/components/select-field/SelectField.mdx +324 -0
  589. package/src/components/select-field/SelectField.stories.tsx +460 -0
  590. package/src/components/select-field/SelectField.tsx +138 -0
  591. package/src/components/select-field/index.ts +1 -0
  592. package/src/components/skeleton/Skeleton.mdx +194 -0
  593. package/src/components/skeleton/Skeleton.stories.tsx +260 -0
  594. package/src/components/skeleton/Skeleton.tsx +107 -0
  595. package/src/components/skeleton/index.ts +1 -0
  596. package/src/components/split-button/SplitButton.mdx +445 -0
  597. package/src/components/split-button/SplitButton.stories.tsx +465 -0
  598. package/src/components/split-button/SplitButton.tsx +361 -0
  599. package/src/components/split-button/index.ts +7 -0
  600. package/src/components/status-summary-bar/StatusSummaryBar.mdx +338 -0
  601. package/src/components/status-summary-bar/StatusSummaryBar.stories.tsx +408 -0
  602. package/src/components/status-summary-bar/StatusSummaryBar.tsx +428 -0
  603. package/src/components/status-summary-bar/index.ts +8 -0
  604. package/src/components/subject-lookup-field/SubjectLookupField.mdx +378 -0
  605. package/src/components/subject-lookup-field/SubjectLookupField.stories.tsx +393 -0
  606. package/src/components/subject-lookup-field/SubjectLookupField.tsx +1079 -0
  607. package/src/components/subject-lookup-field/index.ts +11 -0
  608. package/src/components/switch/Switch.mdx +376 -0
  609. package/src/components/switch/Switch.stories.tsx +296 -0
  610. package/src/components/switch/Switch.tsx +483 -0
  611. package/src/components/switch/index.ts +1 -0
  612. package/src/components/table/Table.mdx +575 -0
  613. package/src/components/table/Table.stories.tsx +1049 -0
  614. package/src/components/table/Table.tsx +745 -0
  615. package/src/components/table/TableConsumers.stories.tsx +195 -0
  616. package/src/components/table/_tableFixtures.ts +1189 -0
  617. package/src/components/table/index.ts +22 -0
  618. package/src/components/text-field/TextField.mdx +479 -0
  619. package/src/components/text-field/TextField.stories.tsx +366 -0
  620. package/src/components/text-field/TextField.tsx +391 -0
  621. package/src/components/text-field/index.ts +8 -0
  622. package/src/components/text-link/TextLink.mdx +353 -0
  623. package/src/components/text-link/TextLink.stories.tsx +458 -0
  624. package/src/components/text-link/TextLink.tsx +504 -0
  625. package/src/components/text-link/index.ts +10 -0
  626. package/src/components/textarea/Textarea.mdx +244 -0
  627. package/src/components/textarea/Textarea.stories.tsx +371 -0
  628. package/src/components/textarea/Textarea.tsx +489 -0
  629. package/src/components/textarea/index.ts +9 -0
  630. package/src/components/tooltip/Tooltip.mdx +462 -0
  631. package/src/components/tooltip/Tooltip.stories.tsx +500 -0
  632. package/src/components/tooltip/Tooltip.tsx +756 -0
  633. package/src/components/tooltip/index.ts +13 -0
  634. package/src/components/unit-field/UnitField.mdx +215 -0
  635. package/src/components/unit-field/UnitField.stories.tsx +291 -0
  636. package/src/components/unit-field/UnitField.tsx +255 -0
  637. package/src/components/unit-field/index.ts +7 -0
  638. package/src/icons/icon-registry.generated.ts +510 -0
  639. package/src/icons/icon-types.generated.ts +256 -0
  640. package/src/index.ts +71 -0
  641. package/src/internal/BottomSheet.tsx +714 -0
  642. package/src/internal/FodsProvider.tsx +36 -0
  643. package/src/internal/MotionCaret.tsx +53 -0
  644. package/src/internal/NumberFormatInput.tsx +276 -0
  645. package/src/internal/SummaryDonut.tsx +359 -0
  646. package/src/internal/buttonSegment.ts +241 -0
  647. package/src/internal/collapseRoom.ts +130 -0
  648. package/src/internal/comboboxKeys.ts +90 -0
  649. package/src/internal/contentPresence.ts +46 -0
  650. package/src/internal/dayCell.ts +274 -0
  651. package/src/internal/dialogPortal.ts +50 -0
  652. package/src/internal/donutSweeps.ts +77 -0
  653. package/src/internal/enterOnViewGeometry.ts +53 -0
  654. package/src/internal/faqItem.ts +104 -0
  655. package/src/internal/floatingLabelMotion.tsx +109 -0
  656. package/src/internal/formBlockContext.ts +27 -0
  657. package/src/internal/heightRoom.ts +135 -0
  658. package/src/internal/numberSeparators.ts +93 -0
  659. package/src/internal/overlayMotion.tsx +32 -0
  660. package/src/internal/paginationItem.ts +106 -0
  661. package/src/internal/popoverSurface.ts +78 -0
  662. package/src/internal/portalContainer.ts +11 -0
  663. package/src/internal/progressBarItem.ts +356 -0
  664. package/src/internal/selectionControlText.ts +42 -0
  665. package/src/internal/statusSummaryParts.tsx +475 -0
  666. package/src/internal/summaryMotion.ts +111 -0
  667. package/src/internal/table/ChildConnector.tsx +57 -0
  668. package/src/internal/table/ChildRowPrefix.tsx +21 -0
  669. package/src/internal/table/ColumnSettings.tsx +194 -0
  670. package/src/internal/table/ScrollRegion.tsx +176 -0
  671. package/src/internal/table/TableEmpty.tsx +99 -0
  672. package/src/internal/table/TableLayout.tsx +29 -0
  673. package/src/internal/table/TableLoadStatus.tsx +60 -0
  674. package/src/internal/table/TableMobile.tsx +582 -0
  675. package/src/internal/table/TruncatedCell.tsx +35 -0
  676. package/src/internal/table/emptyValue.ts +11 -0
  677. package/src/internal/table/features.ts +44 -0
  678. package/src/internal/table/recipes.ts +263 -0
  679. package/src/internal/table/rowClick.ts +8 -0
  680. package/src/internal/table/types.ts +342 -0
  681. package/src/internal/tailwind-variants.ts +65 -0
  682. package/src/internal/tooltipContext.ts +15 -0
  683. package/src/internal/tw-merge-config.generated.ts +275 -0
  684. package/src/internal/useAnchoredPanel.ts +340 -0
  685. package/src/internal/useCountUp.ts +65 -0
  686. package/src/internal/useDateFieldTrigger.tsx +357 -0
  687. package/src/internal/useEChart.ts +88 -0
  688. package/src/internal/useEnterOnView.ts +80 -0
  689. package/src/internal/useFloatingBar.ts +125 -0
  690. package/src/internal/useFormReset.ts +47 -0
  691. package/src/internal/useIsMobile.ts +64 -0
  692. package/src/internal/useNoImplicitSubmit.ts +41 -0
  693. package/src/internal/useOneRowOverflow.ts +103 -0
  694. package/src/internal/usePrefersReducedMotion.ts +27 -0
  695. package/src/internal/useReturnFocus.ts +34 -0
  696. package/src/internal/utils.ts +58 -0
  697. package/src/recipes/EmptyState.stories.tsx +105 -0
  698. package/src/recipes/Form.stories.tsx +355 -0
  699. package/src/recipes/ModalWithForm.stories.tsx +219 -0
  700. package/src/recipes/Recipes.mdx +61 -0
  701. package/src/recipes/TableWithFilters.stories.tsx +278 -0
  702. package/src/storybook/FodsFamily.tsx +39 -0
  703. package/src/storybook/Section.tsx +36 -0
  704. package/src/storybook/a11y.ts +24 -0
  705. package/src/storybook/assets/banner-character-bartender.webp +0 -0
  706. package/src/storybook/assets/banner-invoice-sheet-left.webp +0 -0
  707. package/src/storybook/assets/banner-invoice-sheet-right.webp +0 -0
  708. package/src/storybook/assets/invoice-hero.webp +0 -0
  709. package/src/storybook/assets/invoice.webp +0 -0
  710. package/src/storybook/assets/section-document-info.svg +21 -0
  711. package/src/storybook/assets/section-gear-checklist.svg +11 -0
  712. package/src/storybook/assets/section-person-arrow-in.svg +15 -0
  713. package/src/storybook/assets/section-person-arrow-out.svg +22 -0
  714. package/src/storybook/assets/section-receipt-dollar.svg +23 -0
  715. package/src/storybook/assets/table-empty-folder-empty.png +0 -0
  716. package/src/storybook/assets/table-empty-folder-magnifying-glass.png +0 -0
  717. package/src/storybook/assets/table-empty-funnel.png +0 -0
  718. package/src/storybook/assets/table-empty-load-failed.png +0 -0
  719. package/src/storybook/assets/wallet-spot.png +0 -0
  720. package/src/storybook/assets.d.ts +17 -0
  721. package/src/storybook/componentDoc.ts +41 -0
  722. package/src/storybook/fitFrame.tsx +70 -0
  723. package/src/storybook/forceStates.tsx +647 -0
  724. package/src/storybook/illustrations.tsx +66 -0
  725. package/src/storybook/viewportFrame.tsx +58 -0
  726. package/src/styles/assets/label-brush-1.svg +6 -0
  727. package/src/styles/assets/pattern-dark.svg +113 -0
  728. package/src/styles/base.css +106 -0
  729. package/src/styles/index.css +15 -0
  730. package/src/styles/motion.css +157 -0
  731. package/src/styles/promo-sticker.css +27 -0
  732. package/src/styles/promo-surface.css +49 -0
  733. package/src/styles/shared.css +11 -0
  734. package/src/styles/theme.generated.css +314 -0
  735. package/src/styles/theme.map.json +278 -0
  736. package/src/styles/tracking.generated.css +12 -0
  737. package/src/tokens/index.ts +4 -0
  738. package/src/tokens/tokens.generated.ts +542 -0
@@ -0,0 +1,579 @@
1
+ "use client";
2
+ import * as React from 'react';
3
+ import { motion, useReducedMotion } from 'motion/react';
4
+ import { tv, type VariantProps } from '../../internal/tailwind-variants';
5
+ import { Icon, type IconName, type IconSize } from '../icon/Icon';
6
+ import { TextLink, type TextLinkElement, type TextLinkProps } from '../text-link/TextLink';
7
+ import { cn } from '../../internal/utils';
8
+ import { ROOM_BOTTOM_CLIP, roomVariants } from '../../internal/collapseRoom';
9
+
10
+ /**
11
+ * Alert — the contextual, in-flow notice (upstream spec `04-molecules/alert.md`,
12
+ * manifest 0.8.1, Figma node 6327-61558). A tinted status callout that flags a
13
+ * consequence or heads-up tied to what the user is doing RIGHT NOW, inside a form,
14
+ * step or section: switching VAT mode recalculates every invoice line, changing a
15
+ * customer's NIP needs a special KSeF procedure, a full-invoice storno requires
16
+ * ticking every line.
17
+ *
18
+ * Alert is **static** and **persistent**. The container is not interactive — there
19
+ * is no hover / pressed / selected state on it, no `tabIndex`, no focus ring; only
20
+ * the optional action row carries interaction, through its own Text Link / Button
21
+ * states.
22
+ * There is no dismiss affordance either: a user-dismissible or transient notice is
23
+ * a Status Bar or a Toast, not an Alert. Consequently `axes.state` has exactly one member
24
+ * (`Default`) and this component has NO `disabled` and NO `loading` prop.
25
+ *
26
+ * Scope boundaries (spec § Rationale — holding these apart is what stops Alert from
27
+ * sprawling back into the ad-hoc info boxes it replaces):
28
+ * FODS has no separate Message component — Alert is it, and it lives only inside
29
+ * content (a form, step, section or modal), never as a strip under the Nav Bar.
30
+ * App-level strips are Status Bar, transient action feedback is Toast, field-level
31
+ * validation copy lives on the field.
32
+ *
33
+ * Anatomy:
34
+ * - **Icon** — a leading semantic glyph, decorative (`aria-hidden`). 24px in
35
+ * Stacked, 20px in Inline. Stacked centres it on the content column and flips it
36
+ * to the top once that column is taller than four lines (manifest axis
37
+ * `icon-align`, 0.6.0) — automatic, never a prop; see note 8. Inline always
38
+ * centres it.
39
+ * - **Content** — the message column: an optional **title** (`Body/XS/Semibold`,
40
+ * Stacked only) over the **body** (`Body/XS/Regular`, wraps freely, never
41
+ * clipped).
42
+ * - **Action** — the Action slot, an ACTION ROW (manifest 0.7.0): a Strong Text
43
+ * Link alone (the default — xxs, 12, one step below the Body/XS copy, trailing
44
+ * small caret, manifest 0.6.0), or one or more Buttons (xs by default), or
45
+ * Buttons + one Text Link, or Buttons + one short helper text. One wrapping row,
46
+ * gap `--space-400`, main command first; below the body in Stacked, trailing in
47
+ * Inline — and Inline holds ONE action only (a Text Link or one Button).
48
+ *
49
+ * Two axes:
50
+ * - `status` (manifest `axes.variant`) — `info` · `success` · `warning` · `danger`,
51
+ * each a tinted callout with its own icon and colour set. Violet is reserved for
52
+ * the "Budoucí" invoice status and is NOT an Alert status.
53
+ * - `layout` (manifest `axes.content`) — `stacked` (the comfortable titled block)
54
+ * or `inline` (the compact single row). This is NOT a size axis: manifest
55
+ * `notes[0]` states "Alert has no size axis — its second axis is layout density",
56
+ * which is why the prop is `layout` and its values are not the `xs…xl` vocabulary.
57
+ *
58
+ * Token bindings (manifest `families[].states.default` and `sizes[]`):
59
+ * - fill `--status-X-subtle`, border `--status-X-subtle-border` at
60
+ * `--border-width-100`, radius `--radius-400` in both layouts
61
+ * - TEXT ink (title, body, action link) = `--status-X-active`, NOT
62
+ * `-tint-foreground`: on a light tint `-active` is the dark end of the scale
63
+ * (blue/800 · green/800 · orange/700 · red/900) and clears AA for body text
64
+ * (≈ 6.53 · 6.58 · 5.99 · 8.00 : 1). This is the callout-ink model.
65
+ * - ICON ink = `--status-X-solid` — a deliberate step BRIGHTER than the text ink
66
+ * (blue/600 · green/600 · orange/500 · red/700) so the glyph reads as the status
67
+ * hue. As a decorative non-text graphic it is measured against 3:1 (WCAG 1.4.11),
68
+ * not 4.5:1; Warning sits at 2.1:1 and is carried by the triangle SHAPE plus the
69
+ * adjacent text — a known upstream limitation, not a licence to recolour it.
70
+ * - Stacked: `px-600` / `py-500`, icon↔content gap `--space-500`
71
+ * - Inline: `px-500` / `py-400`, icon↔content gap `--space-400`
72
+ * - title↔body↔action gap `--space-200`; body type `--font-size-xs` in both
73
+ * layouts, action link one step DOWN at `--font-size-xxs` (manifest 0.6.0)
74
+ * - action row gap `--space-400`; helper text `--text-secondary` (manifest
75
+ * `parts.helper` — the one text that does not take the family ink)
76
+ *
77
+ * Deviations and non-obvious choices:
78
+ *
79
+ * 1. `hideIcon` IS A NEGATED BOOLEAN, on purpose. `COMPONENT-CODE-CONVENTIONS` §3
80
+ * forbids negated booleans, but manifest `properties[2].maps` spells the mapping
81
+ * out as «icon visibility (inverse of a hideIcon prop)» — and per the
82
+ * manifest-first authority order `properties[].maps` overrides the general
83
+ * convention when it is filled in. The Figma boolean is `Show icon` (default on);
84
+ * the inverse keeps the React default falsy, so the icon ships by default and a
85
+ * caller has to opt OUT explicitly. Hiding it is a real accessibility decision:
86
+ * with no glyph the status is carried by ink alone unless the copy names it
87
+ * (WCAG 1.4.1), so only hide it where the surrounding text already says which
88
+ * state this is.
89
+ * 2. THE ACTION LINK IS NOT BLUE. Per `text-link.manifest.json` →
90
+ * `delivery.coloredLinks`, a link inside a status container takes the CONTAINER
91
+ * ink: rest = that family's `--status-X-active`, hover / pressed = a `color-mix`
92
+ * wash in oklab toward `--text-primary` at 15% / 30%, underline always on in
93
+ * every state (the WCAG 1.4.1 non-colour signal). No token exists for the mixed
94
+ * step, so hover / pressed are written as arbitrary values — a documented
95
+ * manifest-mandated bypass, flagged with a `fods-lint-disable-next-line` note
96
+ * each, not a token shortcut.
97
+ *
98
+ * They carry an explicit `color:` DATA-TYPE HINT — `text-[color:color-mix(…)]`,
99
+ * not `text-[color-mix(…)]`. Tailwind v4 resolves both to a colour, but
100
+ * tailwind-merge (v2.6) classifies the UNHINTED form into neither `font-size`
101
+ * nor `text-color`, so `TextLink`'s own `hover:!text-text-link-hover` survives
102
+ * the merge instead of being replaced, and two equally-important rules then race
103
+ * on source order — the link renders link-blue on hover roughly at random. With
104
+ * the hint the class lands in `text-color` and the blue is dropped. This is the
105
+ * same class of silent-drop bug the shared `twMergeConfig` exists to prevent.
106
+ * 3. `!` ON THE LINK COLOURS — a consuming app may carry a global
107
+ * `a:not(.button) { color: var(--text-link) }` OUTSIDE any `@layer`, which beats
108
+ * every layered colour utility on an anchor, and `TextLink` itself emits
109
+ * `!text-text-link`. Overriding either needs `!`. Values stay on tokens; only
110
+ * the precedence is forced. See `TextLink` note 5.
111
+ * 4. CANONICAL ICON NAMES. The manifest names the semantic glyphs in the upstream
112
+ * vocabulary (`info` · `check-circle` · `warning` · `warning-circle`), and the
113
+ * map below uses exactly those names. `Icon` accepts canonical names only: the
114
+ * legacy icon-font spellings (`tick`, `danger`, `chevron-right-small`) are not an
115
+ * `IconName` and would render nothing.
116
+ * 5. `layout="inline"` IGNORES `title`. Manifest `intent.rules[2]`: «Layout=Inline
117
+ * forces no title (single message row)». The prop is not rejected — an Alert
118
+ * that switches layout responsively must keep passing the same props — it is
119
+ * simply not rendered, and no `title` part exists in that layout's DOM.
120
+ * 6. TWO SHAPES OF `action`. The manifest makes `action` a rendered node (the
121
+ * action row). The `{ label, href?, onClick? }` object every consumer already
122
+ * passes stays as the shorthand for the default content — one Strong Text Link
123
+ * in the container ink. A row is composed from `AlertActionLink` (the same link,
124
+ * ink read from the enclosing Alert), `Button` (`size="xs"`, own family colours,
125
+ * `showSurface` on Secondary / Tertiary / Danger outline — never recoloured) and
126
+ * `AlertActionHelper`. An external action (`arrow-square-out`) is composed by the
127
+ * caller with `TextLink` directly, which owns the `target` / `rel` contract.
128
+ * Inline must receive ONE node; the component does not police it.
129
+ * 7. THE ACTION PART IS A WRAPPER. `data-fods-part="action"` sits on the row
130
+ * `<div>`, not on a control: `TextLink` and `Button` write their own
131
+ * `data-fods-part="root"` AFTER the prop spread, so the attribute cannot be
132
+ * passed through. The wrapper carries the placement (below the body in Stacked,
133
+ * pushed right in Inline) and inherits the container ink, which is exactly the
134
+ * link's rest ink — so runtime measurement of the part still reads the value the
135
+ * manifest names.
136
+ * 8. ICON ALIGN IS MEASURED, NOT COUNTED. `sizes[Stacked].note` puts the flip at a
137
+ * content column taller than 4 × the line height + 3 × the column gap (95.2 px
138
+ * on today's tokens). Both inputs are read from the column's computed style, so
139
+ * a token change moves the threshold with it; a `ResizeObserver` re-checks on
140
+ * reflow, zoom and translation. The icon is decorative, so the flip is visual
141
+ * only. Changing the icon's alignment never changes the column's height, so the
142
+ * observer cannot oscillate.
143
+ *
144
+ * Semantics / a11y:
145
+ * - **Live region only when inserted after load** (spec § Accessibility, manifest
146
+ * 0.5.2 `delivery.react`): an Alert that appears in response to an input or action passes `live`
147
+ * and becomes a live region — Warning / Danger → `role="alert"` (assertive),
148
+ * Info / Success → `role="status"` (polite). An Alert already present when the
149
+ * page or view loads omits `live` and renders as plain content with no role, so
150
+ * it is not announced on every load. Whether it was inserted later is a fact
151
+ * about the CALLER's flow (a submit, a failed fetch), which the component cannot
152
+ * observe reliably — every mount in a client-rendered view happens "after load"
153
+ * — hence an explicit opt-in boolean rather than detection. The role itself
154
+ * stays DERIVED from `status`, never a prop — the severity and the announcement
155
+ * urgency must not be able to disagree. A live Info / Success Alert mounts its
156
+ * `role="status"` container WITHOUT the message (title + body) and injects it one
157
+ * commit later — a
158
+ * polite region inserted together with its text is often not announced.
159
+ * - The icon is decorative (`Icon` already renders `aria-hidden="true"`); meaning
160
+ * is carried by icon + text together, never colour alone.
161
+ * - The container takes no focus: no `tabIndex`, no `role="button"`, no ring. Every
162
+ * item in the action row that acts is a real Text Link or Button with its own
163
+ * focus ring; DOM order = visual order, main command first. Helper text is plain,
164
+ * unfocusable text.
165
+ *
166
+ * Motion (manifest 0.8.1 `motion`) — only for an Alert added or removed after load,
167
+ * which is exactly what `live` declares:
168
+ * - A `live` Alert mounted by a client render is wrapped in a room that opens on
169
+ * `--spring-gentle` (height) while the Alert fades in over `--duration-slow` +
170
+ * `--easing-enter`. A `live` Alert in the server render or the hydration render of its
171
+ * root shows at once, and every Alert without `live` renders as it always did — no
172
+ * wrapper, no motion.
173
+ * - Removal animates when the caller unmounts the `live` Alert inside
174
+ * `AnimatePresence`: the Alert fades out over `--duration-fast` + `--easing-exit`
175
+ * FIRST, then the room closes on `--spring-gentle`, so the siblings below never chase
176
+ * a still-visible notice. Without `AnimatePresence` it unmounts at once.
177
+ * - The room clips its bottom edge only while it moves (`ROOM_BOTTOM_CLIP`), so the
178
+ * action row's focus rings are never cut.
179
+ * - Reduced motion: no room animation — the room opens and closes at once and the
180
+ * Alert keeps an opacity-only fade (manifest `reducedMotion`).
181
+ */
182
+ const alertVariants = tv({
183
+ slots: {
184
+ root: 'flex border-100 rounded-400 font-inter text-body-xs',
185
+ icon: 'shrink-0',
186
+ // `min-w-0` lets the body wrap instead of forcing the flex row wider than the
187
+ // callout — manifest `text.body.overflow: "wrap"`, never clipped.
188
+ content: 'flex min-w-0 flex-col gap-200',
189
+ title: 'font-semibold',
190
+ body: 'font-normal',
191
+ action: 'flex flex-wrap items-center gap-400',
192
+ actionLink: '',
193
+ helper: 'font-normal text-text-secondary',
194
+ },
195
+ variants: {
196
+ status: {
197
+ info: {
198
+ root: 'bg-status-info-subtle border-status-info-subtle-border text-status-info-active',
199
+ icon: 'text-status-info-solid',
200
+ actionLink: [
201
+ '!text-status-info-active',
202
+ /* fods-lint-disable-next-line arbitrary-value — color-mix wash mandated by text-link.manifest delivery.coloredLinks.colorMix (oklab, toward --text-primary, 15%/30%); no token exists for the mixed step */
203
+ 'hover:!text-[color:color-mix(in_oklab,var(--status-info-active),var(--text-primary)_15%)]',
204
+ 'active:!text-[color:color-mix(in_oklab,var(--status-info-active),var(--text-primary)_30%)]',
205
+ ],
206
+ },
207
+ success: {
208
+ root: 'bg-status-success-subtle border-status-success-subtle-border text-status-success-active',
209
+ icon: 'text-status-success-solid',
210
+ actionLink: [
211
+ '!text-status-success-active',
212
+ /* fods-lint-disable-next-line arbitrary-value — color-mix wash mandated by text-link.manifest delivery.coloredLinks.colorMix (oklab, toward --text-primary, 15%/30%); no token exists for the mixed step */
213
+ 'hover:!text-[color:color-mix(in_oklab,var(--status-success-active),var(--text-primary)_15%)]',
214
+ 'active:!text-[color:color-mix(in_oklab,var(--status-success-active),var(--text-primary)_30%)]',
215
+ ],
216
+ },
217
+ warning: {
218
+ root: 'bg-status-warning-subtle border-status-warning-subtle-border text-status-warning-active',
219
+ icon: 'text-status-warning-solid',
220
+ actionLink: [
221
+ '!text-status-warning-active',
222
+ /* fods-lint-disable-next-line arbitrary-value — color-mix wash mandated by text-link.manifest delivery.coloredLinks.colorMix (oklab, toward --text-primary, 15%/30%); no token exists for the mixed step */
223
+ 'hover:!text-[color:color-mix(in_oklab,var(--status-warning-active),var(--text-primary)_15%)]',
224
+ 'active:!text-[color:color-mix(in_oklab,var(--status-warning-active),var(--text-primary)_30%)]',
225
+ ],
226
+ },
227
+ danger: {
228
+ root: 'bg-status-danger-subtle border-status-danger-subtle-border text-status-danger-active',
229
+ icon: 'text-status-danger-solid',
230
+ actionLink: [
231
+ '!text-status-danger-active',
232
+ /* fods-lint-disable-next-line arbitrary-value — color-mix wash mandated by text-link.manifest delivery.coloredLinks.colorMix (oklab, toward --text-primary, 15%/30%); no token exists for the mixed step */
233
+ 'hover:!text-[color:color-mix(in_oklab,var(--status-danger-active),var(--text-primary)_15%)]',
234
+ 'active:!text-[color:color-mix(in_oklab,var(--status-danger-active),var(--text-primary)_30%)]',
235
+ ],
236
+ },
237
+ },
238
+ layout: {
239
+ /**
240
+ * Titled block: the icon is CENTRED on the content column (manifest 0.6.0;
241
+ * `iconAlign` flips it to the top for tall content), and the action row sits
242
+ * under the body. `self-start` keeps the row hugging its items — a
243
+ * flex-column child would otherwise stretch across the whole callout and give
244
+ * a lone link a full-width hit area.
245
+ */
246
+ stacked: {
247
+ root: 'flex-row items-center gap-500 px-600 py-500',
248
+ action: 'self-start',
249
+ },
250
+ /**
251
+ * Single row: the icon is vertically centred, the body may wrap, and the
252
+ * action is pushed to the trailing edge. `ml-auto` (not `justify-between`)
253
+ * so that with no action the body still sits directly beside the icon.
254
+ */
255
+ inline: {
256
+ root: 'flex-row items-center gap-400 px-500 py-400',
257
+ action: 'ml-auto shrink-0',
258
+ },
259
+ },
260
+ /** Manifest axis `icon-align` — Stacked only, set by measurement (JSDoc note 8). */
261
+ iconAlign: {
262
+ center: {},
263
+ top: { icon: 'self-start' },
264
+ },
265
+ },
266
+ defaultVariants: {
267
+ status: 'info',
268
+ layout: 'stacked',
269
+ iconAlign: 'center',
270
+ },
271
+ });
272
+
273
+ export type AlertStatus = 'info' | 'success' | 'warning' | 'danger';
274
+ export type AlertLayout = 'stacked' | 'inline';
275
+ export type AlertIconAlign = 'center' | 'top';
276
+
277
+ /**
278
+ * The semantic leading glyph per status (manifest `slots.icon.default` + note),
279
+ * in the canonical FODS icon vocabulary — see JSDoc note 4.
280
+ */
281
+ export const ALERT_STATUS_ICONS: Record<AlertStatus, IconName> = {
282
+ info: 'info',
283
+ success: 'check-circle',
284
+ warning: 'warning',
285
+ danger: 'warning-circle',
286
+ };
287
+
288
+ /**
289
+ * Icon box per layout (`sizes[].icon`: 24 Stacked, 20 Inline), as a step of the
290
+ * `--size-icon*` scale: `Icon` sizes width and height from the token.
291
+ */
292
+ const ALERT_ICON_SIZE: Record<AlertLayout, IconSize> = {
293
+ stacked: 'default',
294
+ inline: 'small',
295
+ };
296
+
297
+ /** For a `live` Alert: Warning and Danger interrupt; Info and Success wait their turn. */
298
+ const ALERT_ROLE: Record<AlertStatus, 'alert' | 'status'> = {
299
+ info: 'status',
300
+ success: 'status',
301
+ warning: 'alert',
302
+ danger: 'alert',
303
+ };
304
+
305
+ /** Shorthand for the default Action slot content: one Strong Text Link. */
306
+ export interface AlertAction {
307
+ /** Verb-first label naming its object, no trailing punctuation — the caret is the affordance. */
308
+ label: React.ReactNode;
309
+ /** Navigation target. Omit for an in-page action: `TextLink` then renders a `<button>`. */
310
+ href?: string;
311
+ /**
312
+ * In-page handler. Typed on `HTMLAnchorElement` because that is `TextLink`'s
313
+ * public `onClick` signature; on the no-`href` branch the runtime target is the
314
+ * `<button>` the link renders.
315
+ */
316
+ onClick?: React.MouseEventHandler<HTMLAnchorElement>;
317
+ }
318
+
319
+ export interface AlertProps
320
+ extends Omit<React.HTMLAttributes<HTMLDivElement>, 'title' | 'children' | 'role'>,
321
+ Omit<VariantProps<typeof alertVariants>, 'iconAlign'> {
322
+ /** Colour family + default icon. */
323
+ status?: AlertStatus;
324
+ /**
325
+ * Density arrangement, NOT a size: `stacked` is the titled block, `inline` the
326
+ * compact single row. See JSDoc — Alert has no size axis.
327
+ */
328
+ layout?: AlertLayout;
329
+ /**
330
+ * Drops the leading glyph. Negated on purpose (manifest `properties[2].maps`) —
331
+ * see JSDoc note 1. Only hide it where the copy already names the status.
332
+ */
333
+ hideIcon?: boolean;
334
+ /** Overrides the semantic default from `ALERT_STATUS_ICONS`. */
335
+ icon?: IconName;
336
+ /**
337
+ * Short noun phrase, sentence case, no end period. **Stacked only** — it is
338
+ * ignored in `layout="inline"` (manifest `intent.rules[2]`).
339
+ */
340
+ title?: React.ReactNode;
341
+ /** The message. Wraps freely, never truncated. */
342
+ children: React.ReactNode;
343
+ /**
344
+ * The Action slot. An `AlertAction` object renders the default content — one
345
+ * Strong Text Link in the container ink. A node renders as the action row:
346
+ * `AlertActionLink`, `Button size="xs"` and `AlertActionHelper`, main command
347
+ * first. `layout="inline"` takes ONE action only. See JSDoc note 6.
348
+ */
349
+ action?: AlertAction | React.ReactNode;
350
+ /**
351
+ * The Alert is inserted AFTER page load, in response to an input or action
352
+ * (a validation error on submit, a failed request). Makes it a live region
353
+ * with the role derived from `status` — `alert` for warning / danger, `status`
354
+ * for info / success. Leave it off for an Alert present on load: that one is
355
+ * plain content and is not announced. Spec § Accessibility.
356
+ */
357
+ live?: boolean;
358
+ }
359
+
360
+ /** The enclosing Alert's status, so a composed `AlertActionLink` takes the right ink. */
361
+ const AlertStatusContext = React.createContext<AlertStatus>('info');
362
+
363
+ const isAlertAction = (action: AlertProps['action']): action is AlertAction =>
364
+ typeof action === 'object' &&
365
+ action !== null &&
366
+ !React.isValidElement(action) &&
367
+ 'label' in action;
368
+
369
+ const subscribeNever = () => () => {};
370
+
371
+ /**
372
+ * Whether this Alert mounted after load (manifest `motion.trigger`), per tree: `false` in
373
+ * the server render and in the hydration render of a server-rendered root (React reads the
374
+ * server snapshot there, so the markup agrees), `true` for a mount by a client render.
375
+ * Read once, on the first render — a later re-render never turns a present Alert into an
376
+ * entering one.
377
+ */
378
+ function useMountedAfterLoad(): boolean {
379
+ const clientRender = React.useSyncExternalStore(
380
+ subscribeNever,
381
+ () => true,
382
+ () => false,
383
+ );
384
+ const [afterLoad] = React.useState(clientRender);
385
+ return afterLoad;
386
+ }
387
+
388
+ /** Body/XS line count past which the Stacked icon flips to the top (`sizes[Stacked].note`). */
389
+ const ICON_TOP_LINES = 4;
390
+
391
+ /**
392
+ * Tracks whether the Stacked content column is taller than four lines (JSDoc
393
+ * note 8). Without a `ResizeObserver` (SSR, old engines) the icon stays centred.
394
+ */
395
+ function useIconAlign(content: React.RefObject<HTMLDivElement | null>, enabled: boolean): AlertIconAlign {
396
+ const [align, setAlign] = React.useState<AlertIconAlign>('center');
397
+
398
+ React.useLayoutEffect(() => {
399
+ const el = content.current;
400
+ if (!enabled || el == null) {
401
+ setAlign('center');
402
+ return undefined;
403
+ }
404
+ const measure = () => {
405
+ const style = window.getComputedStyle(el);
406
+ const lineHeight = parseFloat(style.lineHeight);
407
+ const gap = parseFloat(style.rowGap) || 0;
408
+ if (!Number.isFinite(lineHeight)) return;
409
+ const threshold = ICON_TOP_LINES * lineHeight + (ICON_TOP_LINES - 1) * gap;
410
+ // Half-pixel tolerance: sub-pixel rounding must not flip a column that is exactly four lines.
411
+ setAlign(el.getBoundingClientRect().height > threshold + 0.5 ? 'top' : 'center');
412
+ };
413
+ measure();
414
+ if (typeof ResizeObserver === 'undefined') return undefined;
415
+ const observer = new ResizeObserver(measure);
416
+ observer.observe(el);
417
+ return () => observer.disconnect();
418
+ }, [content, enabled]);
419
+
420
+ return align;
421
+ }
422
+
423
+ const Alert = React.forwardRef<HTMLDivElement, AlertProps>(
424
+ (
425
+ {
426
+ className,
427
+ status = 'info',
428
+ layout = 'stacked',
429
+ hideIcon = false,
430
+ icon,
431
+ title,
432
+ action,
433
+ live = false,
434
+ children,
435
+ ...props
436
+ },
437
+ ref,
438
+ ) => {
439
+ const contentRef = React.useRef<HTMLDivElement>(null);
440
+ const iconAlign = useIconAlign(contentRef, layout === 'stacked');
441
+ const slots = alertVariants({ status, layout, iconAlign });
442
+ const showTitle = layout === 'stacked' && title != null;
443
+
444
+ // A polite region inserted together with its text is often not announced, so a
445
+ // live Info / Success Alert commits without its message first (spec §
446
+ // Accessibility). The action row is not withheld: it is a control, not the
447
+ // announcement, and a caller may focus it in its own mount effect.
448
+ const [injected, setInjected] = React.useState(false);
449
+ React.useEffect(() => setInjected(true), []);
450
+ const role = live ? ALERT_ROLE[status] : undefined;
451
+ const withholdMessage = role === 'status' && !injected;
452
+
453
+ const afterLoad = useMountedAfterLoad();
454
+ const reduce = useReducedMotion() === true;
455
+ const roomRef = React.useRef<HTMLDivElement>(null);
456
+
457
+ const actionRow =
458
+ action != null && typeof action !== 'boolean' ? (
459
+ <div data-fods-part="action" className={slots.action()}>
460
+ {isAlertAction(action) ? (
461
+ <AlertActionLink href={action.href} onClick={action.onClick}>
462
+ {action.label}
463
+ </AlertActionLink>
464
+ ) : (
465
+ action
466
+ )}
467
+ </div>
468
+ ) : null;
469
+
470
+ const alert = (
471
+ <AlertStatusContext.Provider value={status}>
472
+ <div
473
+ ref={ref}
474
+ data-fods-component="alert"
475
+ data-fods-part="root"
476
+ data-icon-align={iconAlign}
477
+ {...props}
478
+ role={role}
479
+ className={cn(slots.root(), className)}
480
+ >
481
+ {!hideIcon && (
482
+ <Icon
483
+ name={icon ?? ALERT_STATUS_ICONS[status]}
484
+ size={ALERT_ICON_SIZE[layout]}
485
+ data-fods-part="icon"
486
+ className={slots.icon()}
487
+ />
488
+ )}
489
+ <div ref={contentRef} data-fods-part="content" className={slots.content()}>
490
+ {!withholdMessage && (
491
+ <>
492
+ {showTitle && (
493
+ <div data-fods-part="title" className={slots.title()}>
494
+ {title}
495
+ </div>
496
+ )}
497
+ <div data-fods-part="body" className={slots.body()}>
498
+ {children}
499
+ </div>
500
+ </>
501
+ )}
502
+ {layout === 'stacked' && actionRow}
503
+ </div>
504
+ {layout === 'inline' && actionRow}
505
+ </div>
506
+ </AlertStatusContext.Provider>
507
+ );
508
+
509
+ if (!live) return alert;
510
+
511
+ // The room (height, `--spring-gentle`) and the fade run on one wrapper, the room closing
512
+ // only after the fade (`internal/collapseRoom.ts`). Reduced motion keeps the fade
513
+ // (`motion.reducedMotion`: «opacity-only fade»). The bottom edge is clipped only while
514
+ // the room moves, so the action row's focus ring is never cut at rest.
515
+ return (
516
+ <motion.div
517
+ ref={roomRef}
518
+ data-fods-presence="alert"
519
+ initial={afterLoad ? 'closed' : false}
520
+ animate="open"
521
+ exit="closed"
522
+ variants={roomVariants(reduce, 'keep')}
523
+ onAnimationStart={() => {
524
+ if (roomRef.current) roomRef.current.style.clipPath = ROOM_BOTTOM_CLIP;
525
+ }}
526
+ onAnimationComplete={() => {
527
+ if (roomRef.current) roomRef.current.style.clipPath = '';
528
+ }}
529
+ >
530
+ {alert}
531
+ </motion.div>
532
+ );
533
+ },
534
+ );
535
+ Alert.displayName = 'Alert';
536
+
537
+ export type AlertActionLinkProps = Omit<TextLinkProps, 'variant' | 'size' | 'trailingIcon' | 'surface'>;
538
+
539
+ /**
540
+ * The Strong Text Link of the Action slot — xxs, trailing small caret, in the
541
+ * enclosing Alert's container ink (`text-link.manifest.json` →
542
+ * `delivery.coloredLinks.byFamily[status]`). Use it inside a composed `action` row;
543
+ * the `AlertAction` shorthand renders the same link.
544
+ */
545
+ const AlertActionLink = React.forwardRef<TextLinkElement, AlertActionLinkProps>(
546
+ ({ className, ...props }, ref) => {
547
+ const status = React.useContext(AlertStatusContext);
548
+ return (
549
+ <TextLink
550
+ ref={ref}
551
+ variant="strong"
552
+ size="xxs"
553
+ trailingIcon="caret-right-small"
554
+ {...props}
555
+ className={cn(alertVariants({ status }).actionLink(), className)}
556
+ />
557
+ );
558
+ },
559
+ );
560
+ AlertActionLink.displayName = 'AlertActionLink';
561
+
562
+ /**
563
+ * Short helper text after the Buttons of a Stacked action row — Body/XS in
564
+ * `--text-secondary`, not the status ink (manifest `parts.helper`). Not a link,
565
+ * not focusable.
566
+ */
567
+ const AlertActionHelper = React.forwardRef<HTMLSpanElement, React.HTMLAttributes<HTMLSpanElement>>(
568
+ ({ className, ...props }, ref) => (
569
+ <span
570
+ ref={ref}
571
+ data-fods-part="helper"
572
+ {...props}
573
+ className={cn(alertVariants().helper(), className)}
574
+ />
575
+ ),
576
+ );
577
+ AlertActionHelper.displayName = 'AlertActionHelper';
578
+
579
+ export { Alert, AlertActionLink, AlertActionHelper, alertVariants };
@@ -0,0 +1,13 @@
1
+ export {
2
+ Alert,
3
+ AlertActionLink,
4
+ AlertActionHelper,
5
+ alertVariants,
6
+ ALERT_STATUS_ICONS,
7
+ type AlertProps,
8
+ type AlertAction,
9
+ type AlertActionLinkProps,
10
+ type AlertStatus,
11
+ type AlertLayout,
12
+ type AlertIconAlign,
13
+ } from './Alert';