@invoiceonline/ui-react 0.0.0-stage → 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (738) hide show
  1. package/AGENTS.md +99 -0
  2. package/CHANGELOG.md +131 -0
  3. package/LICENSE +9 -0
  4. package/README.md +78 -2
  5. package/dist/assets/label-brush-1.svg +6 -0
  6. package/dist/assets/pattern-dark.svg +113 -0
  7. package/dist/components/action-row/ActionRow.d.ts +178 -0
  8. package/dist/components/action-row/ActionRow.js +340 -0
  9. package/dist/components/action-row/index.d.ts +2 -0
  10. package/dist/components/action-row/index.js +1 -0
  11. package/dist/components/alert/Alert.d.ts +314 -0
  12. package/dist/components/alert/Alert.js +446 -0
  13. package/dist/components/alert/index.d.ts +2 -0
  14. package/dist/components/alert/index.js +1 -0
  15. package/dist/components/anchored-panel/AnchoredPanel.d.ts +41 -0
  16. package/dist/components/anchored-panel/AnchoredPanel.js +72 -0
  17. package/dist/components/anchored-panel/index.d.ts +3 -0
  18. package/dist/components/anchored-panel/index.js +3 -0
  19. package/dist/components/badge/Badge.d.ts +146 -0
  20. package/dist/components/badge/Badge.js +258 -0
  21. package/dist/components/badge/index.d.ts +2 -0
  22. package/dist/components/badge/index.js +1 -0
  23. package/dist/components/banner/Banner.d.ts +209 -0
  24. package/dist/components/banner/Banner.js +339 -0
  25. package/dist/components/banner/index.d.ts +2 -0
  26. package/dist/components/banner/index.js +1 -0
  27. package/dist/components/button/Button.d.ts +54 -0
  28. package/dist/components/button/Button.js +312 -0
  29. package/dist/components/button/index.d.ts +2 -0
  30. package/dist/components/button/index.js +1 -0
  31. package/dist/components/button-group/ButtonGroup.d.ts +187 -0
  32. package/dist/components/button-group/ButtonGroup.js +217 -0
  33. package/dist/components/button-group/index.d.ts +2 -0
  34. package/dist/components/button-group/index.js +1 -0
  35. package/dist/components/card-select/CardSelect.d.ts +274 -0
  36. package/dist/components/card-select/CardSelect.js +561 -0
  37. package/dist/components/card-select/CardSelectGroup.d.ts +92 -0
  38. package/dist/components/card-select/CardSelectGroup.js +72 -0
  39. package/dist/components/card-select/index.d.ts +3 -0
  40. package/dist/components/card-select/index.js +3 -0
  41. package/dist/components/checkbox/Checkbox.d.ts +104 -0
  42. package/dist/components/checkbox/Checkbox.js +194 -0
  43. package/dist/components/checkbox/index.d.ts +2 -0
  44. package/dist/components/checkbox/index.js +1 -0
  45. package/dist/components/chip/Chip.d.ts +250 -0
  46. package/dist/components/chip/Chip.js +441 -0
  47. package/dist/components/chip/index.d.ts +2 -0
  48. package/dist/components/chip/index.js +1 -0
  49. package/dist/components/column-header/ColumnHeader.d.ts +144 -0
  50. package/dist/components/column-header/ColumnHeader.js +209 -0
  51. package/dist/components/column-header/index.d.ts +2 -0
  52. package/dist/components/column-header/index.js +1 -0
  53. package/dist/components/combobox-field/Combobox.d.ts +104 -0
  54. package/dist/components/combobox-field/Combobox.js +355 -0
  55. package/dist/components/combobox-field/ComboboxField.d.ts +76 -0
  56. package/dist/components/combobox-field/ComboboxField.js +98 -0
  57. package/dist/components/combobox-field/index.d.ts +3 -0
  58. package/dist/components/combobox-field/index.js +3 -0
  59. package/dist/components/date-field/DateField.d.ts +52 -0
  60. package/dist/components/date-field/DateField.js +45 -0
  61. package/dist/components/date-field/index.d.ts +2 -0
  62. package/dist/components/date-field/index.js +1 -0
  63. package/dist/components/date-picker/DatePicker.d.ts +53 -0
  64. package/dist/components/date-picker/DatePicker.js +329 -0
  65. package/dist/components/date-picker/index.d.ts +2 -0
  66. package/dist/components/date-picker/index.js +1 -0
  67. package/dist/components/divider/Divider.d.ts +81 -0
  68. package/dist/components/divider/Divider.js +93 -0
  69. package/dist/components/divider/index.d.ts +2 -0
  70. package/dist/components/divider/index.js +1 -0
  71. package/dist/components/drawer/Drawer.d.ts +128 -0
  72. package/dist/components/drawer/Drawer.js +367 -0
  73. package/dist/components/drawer/index.d.ts +2 -0
  74. package/dist/components/drawer/index.js +1 -0
  75. package/dist/components/dropdown-button/DropdownButton.d.ts +72 -0
  76. package/dist/components/dropdown-button/DropdownButton.js +122 -0
  77. package/dist/components/dropdown-button/index.d.ts +2 -0
  78. package/dist/components/dropdown-button/index.js +1 -0
  79. package/dist/components/faq/FAQ.d.ts +135 -0
  80. package/dist/components/faq/FAQ.js +258 -0
  81. package/dist/components/faq/index.d.ts +2 -0
  82. package/dist/components/faq/index.js +1 -0
  83. package/dist/components/field/Field.d.ts +118 -0
  84. package/dist/components/field/Field.js +327 -0
  85. package/dist/components/field/index.d.ts +2 -0
  86. package/dist/components/field/index.js +1 -0
  87. package/dist/components/field-pair/FieldPair.d.ts +194 -0
  88. package/dist/components/field-pair/FieldPair.js +321 -0
  89. package/dist/components/field-pair/index.d.ts +2 -0
  90. package/dist/components/field-pair/index.js +1 -0
  91. package/dist/components/file-upload/FileUpload.d.ts +137 -0
  92. package/dist/components/file-upload/FileUpload.js +434 -0
  93. package/dist/components/file-upload/index.d.ts +2 -0
  94. package/dist/components/file-upload/index.js +1 -0
  95. package/dist/components/filter-chip/FilterChip.d.ts +373 -0
  96. package/dist/components/filter-chip/FilterChip.js +517 -0
  97. package/dist/components/filter-chip/index.d.ts +2 -0
  98. package/dist/components/filter-chip/index.js +1 -0
  99. package/dist/components/filter-facet/FilterFacet.d.ts +116 -0
  100. package/dist/components/filter-facet/FilterFacet.js +632 -0
  101. package/dist/components/filter-facet/index.d.ts +2 -0
  102. package/dist/components/filter-facet/index.js +1 -0
  103. package/dist/components/firm-avatar/FirmAvatar.d.ts +75 -0
  104. package/dist/components/firm-avatar/FirmAvatar.js +119 -0
  105. package/dist/components/firm-avatar/index.d.ts +2 -0
  106. package/dist/components/firm-avatar/index.js +1 -0
  107. package/dist/components/form-actions/FormActions.d.ts +123 -0
  108. package/dist/components/form-actions/FormActions.js +195 -0
  109. package/dist/components/form-actions/index.d.ts +2 -0
  110. package/dist/components/form-actions/index.js +1 -0
  111. package/dist/components/form-block/FormBlock.d.ts +252 -0
  112. package/dist/components/form-block/FormBlock.js +420 -0
  113. package/dist/components/form-block/index.d.ts +3 -0
  114. package/dist/components/form-block/index.js +3 -0
  115. package/dist/components/form-section/FormSection.d.ts +130 -0
  116. package/dist/components/form-section/FormSection.js +206 -0
  117. package/dist/components/form-section/index.d.ts +2 -0
  118. package/dist/components/form-section/index.js +1 -0
  119. package/dist/components/heading/Heading.d.ts +69 -0
  120. package/dist/components/heading/Heading.js +79 -0
  121. package/dist/components/heading/index.d.ts +2 -0
  122. package/dist/components/heading/index.js +1 -0
  123. package/dist/components/heading-group/HeadingGroup.d.ts +258 -0
  124. package/dist/components/heading-group/HeadingGroup.js +255 -0
  125. package/dist/components/heading-group/index.d.ts +2 -0
  126. package/dist/components/heading-group/index.js +1 -0
  127. package/dist/components/hero/Hero.d.ts +268 -0
  128. package/dist/components/hero/Hero.js +316 -0
  129. package/dist/components/hero/index.d.ts +2 -0
  130. package/dist/components/hero/index.js +1 -0
  131. package/dist/components/icon/Icon.d.ts +27 -0
  132. package/dist/components/icon/Icon.js +30 -0
  133. package/dist/components/icon/index.d.ts +3 -0
  134. package/dist/components/icon/index.js +3 -0
  135. package/dist/components/icon-button/IconButton.d.ts +75 -0
  136. package/dist/components/icon-button/IconButton.js +151 -0
  137. package/dist/components/icon-button/index.d.ts +2 -0
  138. package/dist/components/icon-button/index.js +1 -0
  139. package/dist/components/item-row/ItemRow.d.ts +253 -0
  140. package/dist/components/item-row/ItemRow.js +496 -0
  141. package/dist/components/item-row/index.d.ts +2 -0
  142. package/dist/components/item-row/index.js +1 -0
  143. package/dist/components/list-row/ListRow.d.ts +165 -0
  144. package/dist/components/list-row/ListRow.js +233 -0
  145. package/dist/components/list-row/index.d.ts +2 -0
  146. package/dist/components/list-row/index.js +1 -0
  147. package/dist/components/menu/Menu.d.ts +64 -0
  148. package/dist/components/menu/Menu.js +186 -0
  149. package/dist/components/menu/index.d.ts +2 -0
  150. package/dist/components/menu/index.js +1 -0
  151. package/dist/components/modal/Modal.d.ts +272 -0
  152. package/dist/components/modal/Modal.js +788 -0
  153. package/dist/components/modal/index.d.ts +2 -0
  154. package/dist/components/modal/index.js +1 -0
  155. package/dist/components/nav-link/NavLink.d.ts +123 -0
  156. package/dist/components/nav-link/NavLink.js +157 -0
  157. package/dist/components/nav-link/index.d.ts +2 -0
  158. package/dist/components/nav-link/index.js +1 -0
  159. package/dist/components/number-field/NumberField.d.ts +62 -0
  160. package/dist/components/number-field/NumberField.js +210 -0
  161. package/dist/components/number-field/index.d.ts +2 -0
  162. package/dist/components/number-field/index.js +1 -0
  163. package/dist/components/pagination/Pagination.d.ts +133 -0
  164. package/dist/components/pagination/Pagination.js +217 -0
  165. package/dist/components/pagination/index.d.ts +3 -0
  166. package/dist/components/pagination/index.js +3 -0
  167. package/dist/components/popover-surface/index.d.ts +2 -0
  168. package/dist/components/popover-surface/index.js +1 -0
  169. package/dist/components/progress-bar/ProgressBar.d.ts +260 -0
  170. package/dist/components/progress-bar/ProgressBar.js +470 -0
  171. package/dist/components/progress-bar/index.d.ts +2 -0
  172. package/dist/components/progress-bar/index.js +1 -0
  173. package/dist/components/promo-sticker/PromoSticker.d.ts +204 -0
  174. package/dist/components/promo-sticker/PromoSticker.js +177 -0
  175. package/dist/components/promo-sticker/index.d.ts +2 -0
  176. package/dist/components/promo-sticker/index.js +1 -0
  177. package/dist/components/promo-surface/PromoSurface.d.ts +94 -0
  178. package/dist/components/promo-surface/PromoSurface.js +119 -0
  179. package/dist/components/promo-surface/index.d.ts +2 -0
  180. package/dist/components/promo-surface/index.js +1 -0
  181. package/dist/components/radio/Radio.d.ts +92 -0
  182. package/dist/components/radio/Radio.js +171 -0
  183. package/dist/components/radio/index.d.ts +2 -0
  184. package/dist/components/radio/index.js +1 -0
  185. package/dist/components/radio-group/RadioGroup.d.ts +61 -0
  186. package/dist/components/radio-group/RadioGroup.js +51 -0
  187. package/dist/components/radio-group/index.d.ts +2 -0
  188. package/dist/components/radio-group/index.js +1 -0
  189. package/dist/components/select/Select.d.ts +65 -0
  190. package/dist/components/select/Select.js +176 -0
  191. package/dist/components/select/index.d.ts +2 -0
  192. package/dist/components/select/index.js +1 -0
  193. package/dist/components/select-field/SelectField.d.ts +16 -0
  194. package/dist/components/select-field/SelectField.js +55 -0
  195. package/dist/components/select-field/index.d.ts +2 -0
  196. package/dist/components/select-field/index.js +1 -0
  197. package/dist/components/skeleton/Skeleton.d.ts +64 -0
  198. package/dist/components/skeleton/Skeleton.js +65 -0
  199. package/dist/components/skeleton/index.d.ts +2 -0
  200. package/dist/components/skeleton/index.js +1 -0
  201. package/dist/components/split-button/SplitButton.d.ts +80 -0
  202. package/dist/components/split-button/SplitButton.js +182 -0
  203. package/dist/components/split-button/index.d.ts +2 -0
  204. package/dist/components/split-button/index.js +1 -0
  205. package/dist/components/status-summary-bar/StatusSummaryBar.d.ts +118 -0
  206. package/dist/components/status-summary-bar/StatusSummaryBar.js +278 -0
  207. package/dist/components/status-summary-bar/index.d.ts +2 -0
  208. package/dist/components/status-summary-bar/index.js +1 -0
  209. package/dist/components/subject-lookup-field/SubjectLookupField.d.ts +157 -0
  210. package/dist/components/subject-lookup-field/SubjectLookupField.js +663 -0
  211. package/dist/components/subject-lookup-field/index.d.ts +2 -0
  212. package/dist/components/subject-lookup-field/index.js +1 -0
  213. package/dist/components/switch/Switch.d.ts +152 -0
  214. package/dist/components/switch/Switch.js +307 -0
  215. package/dist/components/switch/index.d.ts +2 -0
  216. package/dist/components/switch/index.js +1 -0
  217. package/dist/components/table/Table.d.ts +5 -0
  218. package/dist/components/table/Table.js +601 -0
  219. package/dist/components/table/index.d.ts +6 -0
  220. package/dist/components/table/index.js +6 -0
  221. package/dist/components/text-field/TextField.d.ts +65 -0
  222. package/dist/components/text-field/TextField.js +173 -0
  223. package/dist/components/text-field/index.d.ts +2 -0
  224. package/dist/components/text-field/index.js +1 -0
  225. package/dist/components/text-link/TextLink.d.ts +260 -0
  226. package/dist/components/text-link/TextLink.js +303 -0
  227. package/dist/components/text-link/index.d.ts +2 -0
  228. package/dist/components/text-link/index.js +1 -0
  229. package/dist/components/textarea/Textarea.d.ts +93 -0
  230. package/dist/components/textarea/Textarea.js +256 -0
  231. package/dist/components/textarea/index.d.ts +2 -0
  232. package/dist/components/textarea/index.js +1 -0
  233. package/dist/components/tooltip/Tooltip.d.ts +129 -0
  234. package/dist/components/tooltip/Tooltip.js +457 -0
  235. package/dist/components/tooltip/index.d.ts +2 -0
  236. package/dist/components/tooltip/index.js +1 -0
  237. package/dist/components/unit-field/UnitField.d.ts +46 -0
  238. package/dist/components/unit-field/UnitField.js +133 -0
  239. package/dist/components/unit-field/index.d.ts +2 -0
  240. package/dist/components/unit-field/index.js +1 -0
  241. package/dist/icons/icon-registry.generated.js +500 -0
  242. package/dist/icons/icon-types.generated.d.ts +2 -0
  243. package/dist/icons/icon-types.generated.js +126 -0
  244. package/dist/index.d.ts +132 -0
  245. package/dist/index.js +75 -0
  246. package/dist/internal/BottomSheet.js +496 -0
  247. package/dist/internal/FodsProvider.d.ts +25 -0
  248. package/dist/internal/FodsProvider.js +32 -0
  249. package/dist/internal/MotionCaret.js +35 -0
  250. package/dist/internal/NumberFormatInput.d.ts +21 -0
  251. package/dist/internal/NumberFormatInput.js +126 -0
  252. package/dist/internal/SummaryDonut.d.ts +3 -0
  253. package/dist/internal/SummaryDonut.js +300 -0
  254. package/dist/internal/buttonSegment.d.ts +44 -0
  255. package/dist/internal/buttonSegment.js +126 -0
  256. package/dist/internal/collapseRoom.js +128 -0
  257. package/dist/internal/comboboxKeys.js +44 -0
  258. package/dist/internal/contentPresence.js +46 -0
  259. package/dist/internal/dayCell.js +95 -0
  260. package/dist/internal/dialogPortal.d.ts +2 -0
  261. package/dist/internal/dialogPortal.js +21 -0
  262. package/dist/internal/donutSweeps.js +65 -0
  263. package/dist/internal/enterOnViewGeometry.js +46 -0
  264. package/dist/internal/faqItem.js +80 -0
  265. package/dist/internal/floatingLabelMotion.js +68 -0
  266. package/dist/internal/formBlockContext.d.ts +22 -0
  267. package/dist/internal/formBlockContext.js +20 -0
  268. package/dist/internal/heightRoom.js +87 -0
  269. package/dist/internal/numberSeparators.js +62 -0
  270. package/dist/internal/overlayMotion.js +48 -0
  271. package/dist/internal/paginationItem.d.ts +8 -0
  272. package/dist/internal/paginationItem.js +22 -0
  273. package/dist/internal/popoverSurface.d.ts +8 -0
  274. package/dist/internal/popoverSurface.js +23 -0
  275. package/dist/internal/portalContainer.d.ts +1 -0
  276. package/dist/internal/portalContainer.js +6 -0
  277. package/dist/internal/progressBarItem.d.ts +207 -0
  278. package/dist/internal/progressBarItem.js +264 -0
  279. package/dist/internal/selectionControlText.js +12 -0
  280. package/dist/internal/statusSummaryParts.js +371 -0
  281. package/dist/internal/summaryMotion.js +75 -0
  282. package/dist/internal/table/ChildConnector.js +62 -0
  283. package/dist/internal/table/ChildRowPrefix.d.ts +9 -0
  284. package/dist/internal/table/ChildRowPrefix.js +27 -0
  285. package/dist/internal/table/ColumnSettings.js +135 -0
  286. package/dist/internal/table/ScrollRegion.js +114 -0
  287. package/dist/internal/table/TableEmpty.js +93 -0
  288. package/dist/internal/table/TableLayout.d.ts +17 -0
  289. package/dist/internal/table/TableLayout.js +29 -0
  290. package/dist/internal/table/TableLoadStatus.js +56 -0
  291. package/dist/internal/table/TableMobile.js +488 -0
  292. package/dist/internal/table/TruncatedCell.js +33 -0
  293. package/dist/internal/table/emptyValue.js +10 -0
  294. package/dist/internal/table/features.d.ts +41 -0
  295. package/dist/internal/table/features.js +31 -0
  296. package/dist/internal/table/recipes.js +227 -0
  297. package/dist/internal/table/rowClick.js +9 -0
  298. package/dist/internal/table/types.d.ts +325 -0
  299. package/dist/internal/table/types.js +13 -0
  300. package/dist/internal/tailwind-variants.d.ts +3 -0
  301. package/dist/internal/tailwind-variants.js +37 -0
  302. package/dist/internal/tooltipContext.js +5 -0
  303. package/dist/internal/tw-merge-config.generated.js +314 -0
  304. package/dist/internal/useAnchoredPanel.d.ts +87 -0
  305. package/dist/internal/useAnchoredPanel.js +108 -0
  306. package/dist/internal/useCountUp.js +53 -0
  307. package/dist/internal/useDateFieldTrigger.js +183 -0
  308. package/dist/internal/useEChart.js +59 -0
  309. package/dist/internal/useEnterOnView.js +42 -0
  310. package/dist/internal/useFloatingBar.js +100 -0
  311. package/dist/internal/useFormReset.js +37 -0
  312. package/dist/internal/useIsMobile.js +44 -0
  313. package/dist/internal/useOneRowOverflow.js +88 -0
  314. package/dist/internal/usePrefersReducedMotion.js +25 -0
  315. package/dist/internal/useReturnFocus.js +26 -0
  316. package/dist/internal/utils.d.ts +7 -0
  317. package/dist/internal/utils.js +58 -0
  318. package/dist/node_modules/@tanstack/store/dist/store.d.ts +29 -0
  319. package/dist/node_modules/@tanstack/store/dist/types.d.ts +38 -0
  320. package/dist/node_modules/@tanstack/table-core/dist/core/cells/coreCellsFeature.d.ts +6 -0
  321. package/dist/node_modules/@tanstack/table-core/dist/core/cells/coreCellsFeature.types.d.ts +53 -0
  322. package/dist/node_modules/@tanstack/table-core/dist/core/columns/coreColumnsFeature.d.ts +6 -0
  323. package/dist/node_modules/@tanstack/table-core/dist/core/columns/coreColumnsFeature.types.d.ts +90 -0
  324. package/dist/node_modules/@tanstack/table-core/dist/core/coreFeatures.d.ts +17 -0
  325. package/dist/node_modules/@tanstack/table-core/dist/core/headers/coreHeadersFeature.d.ts +6 -0
  326. package/dist/node_modules/@tanstack/table-core/dist/core/headers/coreHeadersFeature.types.d.ts +114 -0
  327. package/dist/node_modules/@tanstack/table-core/dist/core/reactivity/coreReactivityFeature.types.d.ts +51 -0
  328. package/dist/node_modules/@tanstack/table-core/dist/core/row-models/coreRowModelsFeature.d.ts +6 -0
  329. package/dist/node_modules/@tanstack/table-core/dist/core/row-models/coreRowModelsFeature.types.d.ts +29 -0
  330. package/dist/node_modules/@tanstack/table-core/dist/core/rows/coreRowsFeature.d.ts +6 -0
  331. package/dist/node_modules/@tanstack/table-core/dist/core/rows/coreRowsFeature.types.d.ts +129 -0
  332. package/dist/node_modules/@tanstack/table-core/dist/core/table/coreTablesFeature.d.ts +6 -0
  333. package/dist/node_modules/@tanstack/table-core/dist/core/table/coreTablesFeature.types.d.ts +203 -0
  334. package/dist/node_modules/@tanstack/table-core/dist/features/cell-selection/cellSelectionFeature.d.ts +6 -0
  335. package/dist/node_modules/@tanstack/table-core/dist/features/cell-selection/cellSelectionFeature.types.d.ts +294 -0
  336. package/dist/node_modules/@tanstack/table-core/dist/features/cell-spanning/cellSpanningFeature.d.ts +11 -0
  337. package/dist/node_modules/@tanstack/table-core/dist/features/cell-spanning/cellSpanningFeature.types.d.ts +148 -0
  338. package/dist/node_modules/@tanstack/table-core/dist/features/column-faceting/columnFacetingFeature.d.ts +12 -0
  339. package/dist/node_modules/@tanstack/table-core/dist/features/column-faceting/columnFacetingFeature.types.d.ts +63 -0
  340. package/dist/node_modules/@tanstack/table-core/dist/features/column-filtering/columnFilteringFeature.d.ts +6 -0
  341. package/dist/node_modules/@tanstack/table-core/dist/features/column-filtering/columnFilteringFeature.types.d.ts +209 -0
  342. package/dist/node_modules/@tanstack/table-core/dist/features/column-filtering/filterFns.d.ts +35 -0
  343. package/dist/node_modules/@tanstack/table-core/dist/features/column-grouping/columnGroupingFeature.d.ts +6 -0
  344. package/dist/node_modules/@tanstack/table-core/dist/features/column-grouping/columnGroupingFeature.types.d.ts +128 -0
  345. package/dist/node_modules/@tanstack/table-core/dist/features/column-ordering/columnOrderingFeature.d.ts +6 -0
  346. package/dist/node_modules/@tanstack/table-core/dist/features/column-ordering/columnOrderingFeature.types.d.ts +82 -0
  347. package/dist/node_modules/@tanstack/table-core/dist/features/column-pinning/columnPinningFeature.d.ts +11 -0
  348. package/dist/node_modules/@tanstack/table-core/dist/features/column-pinning/columnPinningFeature.types.d.ts +195 -0
  349. package/dist/node_modules/@tanstack/table-core/dist/features/column-resizing/columnResizingFeature.d.ts +6 -0
  350. package/dist/node_modules/@tanstack/table-core/dist/features/column-resizing/columnResizingFeature.types.d.ts +73 -0
  351. package/dist/node_modules/@tanstack/table-core/dist/features/column-sizing/columnSizingFeature.d.ts +6 -0
  352. package/dist/node_modules/@tanstack/table-core/dist/features/column-sizing/columnSizingFeature.types.d.ts +134 -0
  353. package/dist/node_modules/@tanstack/table-core/dist/features/column-visibility/columnVisibilityFeature.d.ts +6 -0
  354. package/dist/node_modules/@tanstack/table-core/dist/features/column-visibility/columnVisibilityFeature.types.d.ts +92 -0
  355. package/dist/node_modules/@tanstack/table-core/dist/features/global-filtering/globalFilteringFeature.d.ts +6 -0
  356. package/dist/node_modules/@tanstack/table-core/dist/features/global-filtering/globalFilteringFeature.types.d.ts +67 -0
  357. package/dist/node_modules/@tanstack/table-core/dist/features/row-aggregation/aggregationFns.d.ts +23 -0
  358. package/dist/node_modules/@tanstack/table-core/dist/features/row-aggregation/rowAggregationFeature.d.ts +6 -0
  359. package/dist/node_modules/@tanstack/table-core/dist/features/row-aggregation/rowAggregationFeature.types.d.ts +183 -0
  360. package/dist/node_modules/@tanstack/table-core/dist/features/row-aggregation/rowAggregationFeature.utils.d.ts +18 -0
  361. package/dist/node_modules/@tanstack/table-core/dist/features/row-expanding/rowExpandingFeature.d.ts +6 -0
  362. package/dist/node_modules/@tanstack/table-core/dist/features/row-expanding/rowExpandingFeature.types.d.ts +125 -0
  363. package/dist/node_modules/@tanstack/table-core/dist/features/row-pagination/rowPaginationFeature.d.ts +6 -0
  364. package/dist/node_modules/@tanstack/table-core/dist/features/row-pagination/rowPaginationFeature.types.d.ts +135 -0
  365. package/dist/node_modules/@tanstack/table-core/dist/features/row-pinning/rowPinningFeature.d.ts +6 -0
  366. package/dist/node_modules/@tanstack/table-core/dist/features/row-pinning/rowPinningFeature.types.d.ts +76 -0
  367. package/dist/node_modules/@tanstack/table-core/dist/features/row-selection/rowSelectionFeature.d.ts +6 -0
  368. package/dist/node_modules/@tanstack/table-core/dist/features/row-selection/rowSelectionFeature.types.d.ts +187 -0
  369. package/dist/node_modules/@tanstack/table-core/dist/features/row-sorting/rowSortingFeature.d.ts +6 -0
  370. package/dist/node_modules/@tanstack/table-core/dist/features/row-sorting/rowSortingFeature.types.d.ts +236 -0
  371. package/dist/node_modules/@tanstack/table-core/dist/features/row-sorting/sortFns.d.ts +23 -0
  372. package/dist/node_modules/@tanstack/table-core/dist/features/stockFeatures.d.ts +37 -0
  373. package/dist/node_modules/@tanstack/table-core/dist/helpers/columnHelper.d.ts +47 -0
  374. package/dist/node_modules/@tanstack/table-core/dist/types/Cell.d.ts +16 -0
  375. package/dist/node_modules/@tanstack/table-core/dist/types/Column.d.ts +30 -0
  376. package/dist/node_modules/@tanstack/table-core/dist/types/ColumnDef.d.ts +123 -0
  377. package/dist/node_modules/@tanstack/table-core/dist/types/Header.d.ts +12 -0
  378. package/dist/node_modules/@tanstack/table-core/dist/types/HeaderGroup.d.ts +6 -0
  379. package/dist/node_modules/@tanstack/table-core/dist/types/Row.d.ts +24 -0
  380. package/dist/node_modules/@tanstack/table-core/dist/types/RowModel.d.ts +19 -0
  381. package/dist/node_modules/@tanstack/table-core/dist/types/RowModelFns.d.ts +11 -0
  382. package/dist/node_modules/@tanstack/table-core/dist/types/Table.d.ts +53 -0
  383. package/dist/node_modules/@tanstack/table-core/dist/types/TableFeatures.d.ts +416 -0
  384. package/dist/node_modules/@tanstack/table-core/dist/types/TableOptions.d.ts +78 -0
  385. package/dist/node_modules/@tanstack/table-core/dist/types/TableState.d.ts +46 -0
  386. package/dist/node_modules/@tanstack/table-core/dist/types/type-utils.d.ts +25 -0
  387. package/dist/shared.css +179 -0
  388. package/dist/styles.css +5467 -0
  389. package/dist/theme.css +314 -0
  390. package/dist/theme.map.json +278 -0
  391. package/dist/tokens/index.d.ts +2 -0
  392. package/dist/tokens/index.js +1 -0
  393. package/dist/tokens/tokens.generated.d.ts +2040 -0
  394. package/dist/tokens/tokens.generated.js +2053 -0
  395. package/dist/tokens.css +484 -0
  396. package/dist/tokens.flat.json +429 -0
  397. package/docs/Consuming.mdx +379 -0
  398. package/docs/Contributing.mdx +78 -0
  399. package/docs/ForAgents.mdx +53 -0
  400. package/docs/Introduction.mdx +54 -0
  401. package/llms.txt +556 -0
  402. package/package.json +357 -4
  403. package/src/components/action-row/ActionRow.mdx +686 -0
  404. package/src/components/action-row/ActionRow.stories.tsx +669 -0
  405. package/src/components/action-row/ActionRow.tsx +632 -0
  406. package/src/components/action-row/index.ts +9 -0
  407. package/src/components/alert/Alert.mdx +377 -0
  408. package/src/components/alert/Alert.stories.tsx +674 -0
  409. package/src/components/alert/Alert.tsx +579 -0
  410. package/src/components/alert/index.ts +13 -0
  411. package/src/components/anchored-panel/AnchoredPanel.mdx +381 -0
  412. package/src/components/anchored-panel/AnchoredPanel.stories.tsx +593 -0
  413. package/src/components/anchored-panel/AnchoredPanel.tsx +176 -0
  414. package/src/components/anchored-panel/index.ts +15 -0
  415. package/src/components/badge/Badge.mdx +487 -0
  416. package/src/components/badge/Badge.stories.tsx +375 -0
  417. package/src/components/badge/Badge.tsx +360 -0
  418. package/src/components/badge/index.ts +10 -0
  419. package/src/components/banner/Banner.mdx +704 -0
  420. package/src/components/banner/Banner.stories.tsx +448 -0
  421. package/src/components/banner/Banner.tsx +602 -0
  422. package/src/components/banner/index.ts +14 -0
  423. package/src/components/button/Button.mdx +286 -0
  424. package/src/components/button/Button.stories.tsx +381 -0
  425. package/src/components/button/Button.tsx +384 -0
  426. package/src/components/button/index.ts +1 -0
  427. package/src/components/button-group/ButtonGroup.mdx +512 -0
  428. package/src/components/button-group/ButtonGroup.stories.tsx +714 -0
  429. package/src/components/button-group/ButtonGroup.tsx +491 -0
  430. package/src/components/button-group/index.ts +10 -0
  431. package/src/components/card-select/CardSelect.mdx +662 -0
  432. package/src/components/card-select/CardSelect.stories.tsx +784 -0
  433. package/src/components/card-select/CardSelect.tsx +783 -0
  434. package/src/components/card-select/CardSelectGroup.tsx +169 -0
  435. package/src/components/card-select/index.ts +18 -0
  436. package/src/components/checkbox/Checkbox.mdx +269 -0
  437. package/src/components/checkbox/Checkbox.stories.tsx +306 -0
  438. package/src/components/checkbox/Checkbox.tsx +343 -0
  439. package/src/components/checkbox/index.ts +1 -0
  440. package/src/components/chip/Chip.mdx +683 -0
  441. package/src/components/chip/Chip.stories.tsx +734 -0
  442. package/src/components/chip/Chip.tsx +732 -0
  443. package/src/components/chip/index.ts +9 -0
  444. package/src/components/column-header/ColumnHeader.mdx +301 -0
  445. package/src/components/column-header/ColumnHeader.stories.tsx +319 -0
  446. package/src/components/column-header/ColumnHeader.tsx +287 -0
  447. package/src/components/column-header/index.ts +7 -0
  448. package/src/components/combobox-field/Combobox.tsx +693 -0
  449. package/src/components/combobox-field/ComboboxField.mdx +525 -0
  450. package/src/components/combobox-field/ComboboxField.stories.tsx +502 -0
  451. package/src/components/combobox-field/ComboboxField.tsx +259 -0
  452. package/src/components/combobox-field/index.ts +12 -0
  453. package/src/components/date-field/DateField.mdx +340 -0
  454. package/src/components/date-field/DateField.stories.tsx +221 -0
  455. package/src/components/date-field/DateField.tsx +176 -0
  456. package/src/components/date-field/index.ts +1 -0
  457. package/src/components/date-picker/DatePicker.mdx +436 -0
  458. package/src/components/date-picker/DatePicker.stories.tsx +458 -0
  459. package/src/components/date-picker/DatePicker.tsx +688 -0
  460. package/src/components/date-picker/index.ts +9 -0
  461. package/src/components/divider/Divider.mdx +256 -0
  462. package/src/components/divider/Divider.stories.tsx +177 -0
  463. package/src/components/divider/Divider.tsx +193 -0
  464. package/src/components/divider/index.ts +1 -0
  465. package/src/components/drawer/Drawer.mdx +518 -0
  466. package/src/components/drawer/Drawer.stories.tsx +392 -0
  467. package/src/components/drawer/Drawer.tsx +683 -0
  468. package/src/components/drawer/index.ts +1 -0
  469. package/src/components/dropdown-button/DropdownButton.mdx +285 -0
  470. package/src/components/dropdown-button/DropdownButton.stories.tsx +398 -0
  471. package/src/components/dropdown-button/DropdownButton.tsx +198 -0
  472. package/src/components/dropdown-button/index.ts +7 -0
  473. package/src/components/faq/FAQ.mdx +364 -0
  474. package/src/components/faq/FAQ.stories.tsx +343 -0
  475. package/src/components/faq/FAQ.tsx +337 -0
  476. package/src/components/faq/index.ts +1 -0
  477. package/src/components/field/Field.mdx +129 -0
  478. package/src/components/field/Field.stories.tsx +461 -0
  479. package/src/components/field/Field.tsx +765 -0
  480. package/src/components/field/index.ts +20 -0
  481. package/src/components/field-pair/FieldPair.mdx +308 -0
  482. package/src/components/field-pair/FieldPair.stories.tsx +530 -0
  483. package/src/components/field-pair/FieldPair.tsx +796 -0
  484. package/src/components/field-pair/index.ts +9 -0
  485. package/src/components/file-upload/FileUpload.mdx +345 -0
  486. package/src/components/file-upload/FileUpload.stories.tsx +698 -0
  487. package/src/components/file-upload/FileUpload.tsx +802 -0
  488. package/src/components/file-upload/index.ts +6 -0
  489. package/src/components/filter-chip/FilterChip.mdx +778 -0
  490. package/src/components/filter-chip/FilterChip.stories.tsx +827 -0
  491. package/src/components/filter-chip/FilterChip.tsx +881 -0
  492. package/src/components/filter-chip/index.ts +11 -0
  493. package/src/components/filter-facet/FilterFacet.mdx +536 -0
  494. package/src/components/filter-facet/FilterFacet.stories.tsx +506 -0
  495. package/src/components/filter-facet/FilterFacet.tsx +1160 -0
  496. package/src/components/filter-facet/index.ts +7 -0
  497. package/src/components/firm-avatar/FirmAvatar.mdx +280 -0
  498. package/src/components/firm-avatar/FirmAvatar.stories.tsx +147 -0
  499. package/src/components/firm-avatar/FirmAvatar.tsx +172 -0
  500. package/src/components/firm-avatar/index.ts +7 -0
  501. package/src/components/form-actions/FormActions.mdx +518 -0
  502. package/src/components/form-actions/FormActions.stories.tsx +621 -0
  503. package/src/components/form-actions/FormActions.tsx +273 -0
  504. package/src/components/form-actions/index.ts +6 -0
  505. package/src/components/form-block/FormBlock.mdx +728 -0
  506. package/src/components/form-block/FormBlock.stories.tsx +813 -0
  507. package/src/components/form-block/FormBlock.tsx +679 -0
  508. package/src/components/form-block/index.ts +13 -0
  509. package/src/components/form-section/FormSection.mdx +436 -0
  510. package/src/components/form-section/FormSection.stories.tsx +407 -0
  511. package/src/components/form-section/FormSection.tsx +290 -0
  512. package/src/components/form-section/index.ts +17 -0
  513. package/src/components/heading/Heading.mdx +206 -0
  514. package/src/components/heading/Heading.stories.tsx +169 -0
  515. package/src/components/heading/Heading.tsx +124 -0
  516. package/src/components/heading/index.ts +8 -0
  517. package/src/components/heading-group/HeadingGroup.mdx +521 -0
  518. package/src/components/heading-group/HeadingGroup.stories.tsx +353 -0
  519. package/src/components/heading-group/HeadingGroup.tsx +396 -0
  520. package/src/components/heading-group/index.ts +7 -0
  521. package/src/components/hero/Hero.mdx +742 -0
  522. package/src/components/hero/Hero.stories.tsx +527 -0
  523. package/src/components/hero/Hero.tsx +807 -0
  524. package/src/components/hero/index.ts +1 -0
  525. package/src/components/icon/Icon.mdx +329 -0
  526. package/src/components/icon/Icon.stories.tsx +398 -0
  527. package/src/components/icon/Icon.tsx +97 -0
  528. package/src/components/icon/index.ts +2 -0
  529. package/src/components/icon-button/IconButton.mdx +206 -0
  530. package/src/components/icon-button/IconButton.stories.tsx +341 -0
  531. package/src/components/icon-button/IconButton.tsx +273 -0
  532. package/src/components/icon-button/index.ts +1 -0
  533. package/src/components/item-row/ItemRow.mdx +533 -0
  534. package/src/components/item-row/ItemRow.stories.tsx +434 -0
  535. package/src/components/item-row/ItemRow.tsx +676 -0
  536. package/src/components/item-row/index.ts +9 -0
  537. package/src/components/list-row/ListRow.mdx +404 -0
  538. package/src/components/list-row/ListRow.stories.tsx +404 -0
  539. package/src/components/list-row/ListRow.tsx +424 -0
  540. package/src/components/list-row/index.ts +1 -0
  541. package/src/components/menu/Menu.mdx +268 -0
  542. package/src/components/menu/Menu.stories.tsx +455 -0
  543. package/src/components/menu/Menu.tsx +452 -0
  544. package/src/components/menu/index.ts +1 -0
  545. package/src/components/modal/Modal.mdx +854 -0
  546. package/src/components/modal/Modal.stories.tsx +881 -0
  547. package/src/components/modal/Modal.tsx +1434 -0
  548. package/src/components/modal/index.ts +1 -0
  549. package/src/components/nav-link/NavLink.mdx +196 -0
  550. package/src/components/nav-link/NavLink.stories.tsx +243 -0
  551. package/src/components/nav-link/NavLink.tsx +222 -0
  552. package/src/components/nav-link/index.ts +1 -0
  553. package/src/components/number-field/NumberField.mdx +223 -0
  554. package/src/components/number-field/NumberField.stories.tsx +291 -0
  555. package/src/components/number-field/NumberField.tsx +388 -0
  556. package/src/components/number-field/index.ts +6 -0
  557. package/src/components/pagination/Pagination.mdx +305 -0
  558. package/src/components/pagination/Pagination.stories.tsx +333 -0
  559. package/src/components/pagination/Pagination.tsx +343 -0
  560. package/src/components/pagination/index.ts +8 -0
  561. package/src/components/popover-surface/PopoverSurface.mdx +158 -0
  562. package/src/components/popover-surface/PopoverSurface.stories.tsx +421 -0
  563. package/src/components/popover-surface/index.ts +1 -0
  564. package/src/components/progress-bar/ProgressBar.mdx +802 -0
  565. package/src/components/progress-bar/ProgressBar.stories.tsx +533 -0
  566. package/src/components/progress-bar/ProgressBar.tsx +654 -0
  567. package/src/components/progress-bar/index.ts +9 -0
  568. package/src/components/promo-sticker/PromoSticker.mdx +436 -0
  569. package/src/components/promo-sticker/PromoSticker.stories.tsx +363 -0
  570. package/src/components/promo-sticker/PromoSticker.tsx +313 -0
  571. package/src/components/promo-sticker/index.ts +7 -0
  572. package/src/components/promo-surface/PromoSurface.mdx +399 -0
  573. package/src/components/promo-surface/PromoSurface.stories.tsx +270 -0
  574. package/src/components/promo-surface/PromoSurface.tsx +305 -0
  575. package/src/components/promo-surface/index.ts +7 -0
  576. package/src/components/radio/Radio.mdx +243 -0
  577. package/src/components/radio/Radio.stories.tsx +307 -0
  578. package/src/components/radio/Radio.tsx +288 -0
  579. package/src/components/radio/index.ts +1 -0
  580. package/src/components/radio-group/RadioGroup.mdx +119 -0
  581. package/src/components/radio-group/RadioGroup.stories.tsx +225 -0
  582. package/src/components/radio-group/RadioGroup.tsx +139 -0
  583. package/src/components/radio-group/index.ts +1 -0
  584. package/src/components/select/Select.mdx +241 -0
  585. package/src/components/select/Select.stories.tsx +404 -0
  586. package/src/components/select/Select.tsx +381 -0
  587. package/src/components/select/index.ts +1 -0
  588. package/src/components/select-field/SelectField.mdx +324 -0
  589. package/src/components/select-field/SelectField.stories.tsx +460 -0
  590. package/src/components/select-field/SelectField.tsx +138 -0
  591. package/src/components/select-field/index.ts +1 -0
  592. package/src/components/skeleton/Skeleton.mdx +194 -0
  593. package/src/components/skeleton/Skeleton.stories.tsx +260 -0
  594. package/src/components/skeleton/Skeleton.tsx +107 -0
  595. package/src/components/skeleton/index.ts +1 -0
  596. package/src/components/split-button/SplitButton.mdx +445 -0
  597. package/src/components/split-button/SplitButton.stories.tsx +465 -0
  598. package/src/components/split-button/SplitButton.tsx +361 -0
  599. package/src/components/split-button/index.ts +7 -0
  600. package/src/components/status-summary-bar/StatusSummaryBar.mdx +338 -0
  601. package/src/components/status-summary-bar/StatusSummaryBar.stories.tsx +408 -0
  602. package/src/components/status-summary-bar/StatusSummaryBar.tsx +428 -0
  603. package/src/components/status-summary-bar/index.ts +8 -0
  604. package/src/components/subject-lookup-field/SubjectLookupField.mdx +378 -0
  605. package/src/components/subject-lookup-field/SubjectLookupField.stories.tsx +393 -0
  606. package/src/components/subject-lookup-field/SubjectLookupField.tsx +1079 -0
  607. package/src/components/subject-lookup-field/index.ts +11 -0
  608. package/src/components/switch/Switch.mdx +376 -0
  609. package/src/components/switch/Switch.stories.tsx +296 -0
  610. package/src/components/switch/Switch.tsx +483 -0
  611. package/src/components/switch/index.ts +1 -0
  612. package/src/components/table/Table.mdx +575 -0
  613. package/src/components/table/Table.stories.tsx +1049 -0
  614. package/src/components/table/Table.tsx +745 -0
  615. package/src/components/table/TableConsumers.stories.tsx +195 -0
  616. package/src/components/table/_tableFixtures.ts +1189 -0
  617. package/src/components/table/index.ts +22 -0
  618. package/src/components/text-field/TextField.mdx +479 -0
  619. package/src/components/text-field/TextField.stories.tsx +366 -0
  620. package/src/components/text-field/TextField.tsx +391 -0
  621. package/src/components/text-field/index.ts +8 -0
  622. package/src/components/text-link/TextLink.mdx +353 -0
  623. package/src/components/text-link/TextLink.stories.tsx +458 -0
  624. package/src/components/text-link/TextLink.tsx +504 -0
  625. package/src/components/text-link/index.ts +10 -0
  626. package/src/components/textarea/Textarea.mdx +244 -0
  627. package/src/components/textarea/Textarea.stories.tsx +371 -0
  628. package/src/components/textarea/Textarea.tsx +489 -0
  629. package/src/components/textarea/index.ts +9 -0
  630. package/src/components/tooltip/Tooltip.mdx +462 -0
  631. package/src/components/tooltip/Tooltip.stories.tsx +500 -0
  632. package/src/components/tooltip/Tooltip.tsx +756 -0
  633. package/src/components/tooltip/index.ts +13 -0
  634. package/src/components/unit-field/UnitField.mdx +215 -0
  635. package/src/components/unit-field/UnitField.stories.tsx +291 -0
  636. package/src/components/unit-field/UnitField.tsx +255 -0
  637. package/src/components/unit-field/index.ts +7 -0
  638. package/src/icons/icon-registry.generated.ts +510 -0
  639. package/src/icons/icon-types.generated.ts +256 -0
  640. package/src/index.ts +71 -0
  641. package/src/internal/BottomSheet.tsx +714 -0
  642. package/src/internal/FodsProvider.tsx +36 -0
  643. package/src/internal/MotionCaret.tsx +53 -0
  644. package/src/internal/NumberFormatInput.tsx +276 -0
  645. package/src/internal/SummaryDonut.tsx +359 -0
  646. package/src/internal/buttonSegment.ts +241 -0
  647. package/src/internal/collapseRoom.ts +130 -0
  648. package/src/internal/comboboxKeys.ts +90 -0
  649. package/src/internal/contentPresence.ts +46 -0
  650. package/src/internal/dayCell.ts +274 -0
  651. package/src/internal/dialogPortal.ts +50 -0
  652. package/src/internal/donutSweeps.ts +77 -0
  653. package/src/internal/enterOnViewGeometry.ts +53 -0
  654. package/src/internal/faqItem.ts +104 -0
  655. package/src/internal/floatingLabelMotion.tsx +109 -0
  656. package/src/internal/formBlockContext.ts +27 -0
  657. package/src/internal/heightRoom.ts +135 -0
  658. package/src/internal/numberSeparators.ts +93 -0
  659. package/src/internal/overlayMotion.tsx +32 -0
  660. package/src/internal/paginationItem.ts +106 -0
  661. package/src/internal/popoverSurface.ts +78 -0
  662. package/src/internal/portalContainer.ts +11 -0
  663. package/src/internal/progressBarItem.ts +356 -0
  664. package/src/internal/selectionControlText.ts +42 -0
  665. package/src/internal/statusSummaryParts.tsx +475 -0
  666. package/src/internal/summaryMotion.ts +111 -0
  667. package/src/internal/table/ChildConnector.tsx +57 -0
  668. package/src/internal/table/ChildRowPrefix.tsx +21 -0
  669. package/src/internal/table/ColumnSettings.tsx +194 -0
  670. package/src/internal/table/ScrollRegion.tsx +176 -0
  671. package/src/internal/table/TableEmpty.tsx +99 -0
  672. package/src/internal/table/TableLayout.tsx +29 -0
  673. package/src/internal/table/TableLoadStatus.tsx +60 -0
  674. package/src/internal/table/TableMobile.tsx +582 -0
  675. package/src/internal/table/TruncatedCell.tsx +35 -0
  676. package/src/internal/table/emptyValue.ts +11 -0
  677. package/src/internal/table/features.ts +44 -0
  678. package/src/internal/table/recipes.ts +263 -0
  679. package/src/internal/table/rowClick.ts +8 -0
  680. package/src/internal/table/types.ts +342 -0
  681. package/src/internal/tailwind-variants.ts +65 -0
  682. package/src/internal/tooltipContext.ts +15 -0
  683. package/src/internal/tw-merge-config.generated.ts +275 -0
  684. package/src/internal/useAnchoredPanel.ts +340 -0
  685. package/src/internal/useCountUp.ts +65 -0
  686. package/src/internal/useDateFieldTrigger.tsx +357 -0
  687. package/src/internal/useEChart.ts +88 -0
  688. package/src/internal/useEnterOnView.ts +80 -0
  689. package/src/internal/useFloatingBar.ts +125 -0
  690. package/src/internal/useFormReset.ts +47 -0
  691. package/src/internal/useIsMobile.ts +64 -0
  692. package/src/internal/useNoImplicitSubmit.ts +41 -0
  693. package/src/internal/useOneRowOverflow.ts +103 -0
  694. package/src/internal/usePrefersReducedMotion.ts +27 -0
  695. package/src/internal/useReturnFocus.ts +34 -0
  696. package/src/internal/utils.ts +58 -0
  697. package/src/recipes/EmptyState.stories.tsx +105 -0
  698. package/src/recipes/Form.stories.tsx +355 -0
  699. package/src/recipes/ModalWithForm.stories.tsx +219 -0
  700. package/src/recipes/Recipes.mdx +61 -0
  701. package/src/recipes/TableWithFilters.stories.tsx +278 -0
  702. package/src/storybook/FodsFamily.tsx +39 -0
  703. package/src/storybook/Section.tsx +36 -0
  704. package/src/storybook/a11y.ts +24 -0
  705. package/src/storybook/assets/banner-character-bartender.webp +0 -0
  706. package/src/storybook/assets/banner-invoice-sheet-left.webp +0 -0
  707. package/src/storybook/assets/banner-invoice-sheet-right.webp +0 -0
  708. package/src/storybook/assets/invoice-hero.webp +0 -0
  709. package/src/storybook/assets/invoice.webp +0 -0
  710. package/src/storybook/assets/section-document-info.svg +21 -0
  711. package/src/storybook/assets/section-gear-checklist.svg +11 -0
  712. package/src/storybook/assets/section-person-arrow-in.svg +15 -0
  713. package/src/storybook/assets/section-person-arrow-out.svg +22 -0
  714. package/src/storybook/assets/section-receipt-dollar.svg +23 -0
  715. package/src/storybook/assets/table-empty-folder-empty.png +0 -0
  716. package/src/storybook/assets/table-empty-folder-magnifying-glass.png +0 -0
  717. package/src/storybook/assets/table-empty-funnel.png +0 -0
  718. package/src/storybook/assets/table-empty-load-failed.png +0 -0
  719. package/src/storybook/assets/wallet-spot.png +0 -0
  720. package/src/storybook/assets.d.ts +17 -0
  721. package/src/storybook/componentDoc.ts +41 -0
  722. package/src/storybook/fitFrame.tsx +70 -0
  723. package/src/storybook/forceStates.tsx +647 -0
  724. package/src/storybook/illustrations.tsx +66 -0
  725. package/src/storybook/viewportFrame.tsx +58 -0
  726. package/src/styles/assets/label-brush-1.svg +6 -0
  727. package/src/styles/assets/pattern-dark.svg +113 -0
  728. package/src/styles/base.css +106 -0
  729. package/src/styles/index.css +15 -0
  730. package/src/styles/motion.css +157 -0
  731. package/src/styles/promo-sticker.css +27 -0
  732. package/src/styles/promo-surface.css +49 -0
  733. package/src/styles/shared.css +11 -0
  734. package/src/styles/theme.generated.css +314 -0
  735. package/src/styles/theme.map.json +278 -0
  736. package/src/styles/tracking.generated.css +12 -0
  737. package/src/tokens/index.ts +4 -0
  738. package/src/tokens/tokens.generated.ts +542 -0
@@ -0,0 +1,377 @@
1
+ import { Meta, Canvas, Controls } from '@storybook/addon-docs/blocks';
2
+ import * as AlertStories from './Alert.stories';
3
+
4
+ <Meta of={AlertStories} tags={['autodocs']} />
5
+
6
+ # Alert
7
+
8
+ ## Metadata
9
+
10
+ - **Layer:** molecule
11
+ - **Status:** draft
12
+ - **Manifest version:** `0.8.1`
13
+ - **Tokens used:** `--border-width-100`, `--font-body`, `--font-size-xs`, `--font-weight-normal`, `--font-weight-semibold`, `--leading-loose`, `--radius-400`, `--space-200`, `--space-400`, `--space-500`, `--space-600`, `--status-danger-active`, `--status-danger-solid`, `--status-danger-subtle`, `--status-danger-subtle-border`, `--status-info-active`, `--status-info-solid`, `--status-info-subtle`, `--status-info-subtle-border`, `--status-success-active`, `--status-success-solid`, `--status-success-subtle`, `--status-success-subtle-border`, `--status-warning-active`, `--status-warning-solid`, `--status-warning-subtle`, `--status-warning-subtle-border`, `--text-primary`, `--text-secondary`
14
+
15
+ The manifest is `spec/04-molecules/alert.manifest.json`; a manifest bump re-opens the component per COMPONENT-CODE-CONVENTIONS § DoD (e).
16
+
17
+ ## Overview
18
+
19
+ Alert is the **contextual, in-flow notice** — a tinted status callout that flags a consequence or heads-up tied to what the user is doing *right now*, inside a form, step or section: switching VAT mode recalculates every invoice line, changing a customer's DIČ is corrected with a credit note and a new invoice, a full-invoice storno requires ticking every line.
20
+
21
+ FODS has no separate Message component — **Alert is it**, and it lives only inside content (a form, step, section or modal), never as a strip under the Nav Bar.
22
+
23
+ **Use it** when the notice belongs next to the control or step it explains, and when it should stay on screen while it is relevant. **Do not use it** as a page-level or app-wide strip, including one under the nav bar (that is Status Bar), as a flash that appears after an action (that is Toast), or as field-level validation copy (that lives on the field itself).
24
+
25
+ Alert is **static** and **persistent**: the container carries no interaction states and there is no close affordance. Everything interactive lives in the optional action row — by default one Text Link, or Buttons with an optional link or helper text.
26
+
27
+ <Canvas of={AlertStories.Playground} />
28
+
29
+ ## Rationale
30
+
31
+ Alert consolidates **contextual** notices into one token-bound molecule (spec § Rationale).
32
+
33
+ The scope boundaries are the point of the component. App-level strips go to Status Bar, action feedback goes to Toast, field-level validation copy goes to the field's own helper / error. Holding those apart is what stops Alert from sprawling.
34
+
35
+ Two structural decisions follow from that:
36
+
37
+ - **No size axis.** Manifest `notes[0]`: „Alert has no size axis — its second axis is layout density.“ The second axis is therefore `layout` (`stacked` / `inline`), and its values are deliberately not the `xs…xl` vocabulary. There is no `size` prop.
38
+ - **`role` is derived, never passed — and only for a `live` Alert.** An Alert inserted after load passes `live`; `ALERT_ROLE` then maps warning / danger to `role="alert"` and info / success to `role="status"`. Without `live` there is no role. `role` is stripped from the props type (`Omit<…, 'role'>`), so severity and announcement urgency cannot disagree. Whether the Alert arrived after load is a fact about the caller's flow (a submit, a failed request) that the component cannot observe — every mount in a client-rendered view happens after the document loaded — so it is an explicit opt-in boolean, not detection.
39
+
40
+ ## Anatomy
41
+
42
+ Seven parts, each carrying a `data-fods-part` attribute (the root additionally carries `data-fods-component="alert"`):
43
+
44
+ - **`root`** — the callout container. Fill <code>--status-X-subtle</code>, border <code>--status-X-subtle-border</code> at `--border-width-100`, radius `--radius-400`, base type `--font-size-xs`. It also owns the **text ink** <code>--status-X-active</code>, which title, body and the action link all inherit (the callout-ink model). Not interactive: no `tabIndex`, no `role="button"`, no focus ring.
45
+ - **`icon`** — the leading semantic glyph, decorative (`Icon` always renders `aria-hidden="true"`). 24px in Stacked, 20px in Inline: `ALERT_ICON_SIZE` passes the `--size-icon` / `--size-icon-small` step to `Icon`, which sets width and height from it. Its ink is <code>--status-X-solid</code> — a deliberate step brighter than the text ink, so the glyph reads as the status hue. It does **not** inherit the text colour.
46
+ - **`content`** — the message column. Pure layout: `min-w-0` (so a long word cannot force the row wider than the callout) and a `--space-200` rhythm between title, body and action.
47
+ - **`title`** — optional short noun phrase at `--font-weight-semibold`. **Stacked only.**
48
+ - **`body`** — the message at `--font-weight-normal`. Required (`children`), wraps freely, never truncated.
49
+ - Icon alignment — Stacked centres the glyph on the content column and moves it to the top once that column runs past four lines (manifest axis `icon-align`, 0.6.0). Not a prop: measured, see Sizes.
50
+ - **`action`** — the Action slot, an **action row** (manifest 0.7.0): a wrapper `<div>` (`flex flex-wrap`, gap `--space-400`) holding, in DOM order = visual order, main command first, one of: a Strong Text Link alone (the default), one or more Buttons (`size="xs"`), Buttons + one Text Link, or Buttons + one helper text. It is a wrapper rather than the control because `TextLink` and `Button` write their own `data-fods-part="root"` after the prop spread. It carries the placement (below the body in Stacked, pushed to the trailing edge in Inline) and inherits the container ink, which is exactly the link's rest ink. Buttons keep their own family colours.
51
+ - **`helper`** — optional helper text after the Buttons of a Stacked row (`AlertActionHelper`): Body/XS in <code>--text-secondary</code>, the one text part that does not take the status ink (manifest `parts.helper`, AA on every tint: 5.60 · 5.83 · 5.71 · 5.62 : 1). Plain text, not focusable.
52
+
53
+ <Canvas of={AlertStories.Composition} />
54
+
55
+ ## Variants
56
+
57
+ The variant axis is `status` — four tinted callouts, each with its own semantic glyph and colour set. A second Figma axis, **Icon align** (`Center` · `Top`, Stacked only), is not a prop: the component picks it from the measured content height (see Sizes).
58
+
59
+ <Canvas of={AlertStories.Statuses} />
60
+
61
+ <table>
62
+ <thead>
63
+ <tr><th>Status</th><th>Role (with <code>live</code>)</th><th>Icon</th><th>When</th><th>Tokens</th></tr>
64
+ </thead>
65
+ <tbody>
66
+ <tr>
67
+ <td><code>info</code> (default)</td>
68
+ <td><code>status</code></td>
69
+ <td><code>info</code></td>
70
+ <td>A heads-up about what a change will do</td>
71
+ <td>fill <code>--status-info-subtle</code>, border <code>--status-info-subtle-border</code>, text <code>--status-info-active</code>, icon <code>--status-info-solid</code></td>
72
+ </tr>
73
+ <tr>
74
+ <td><code>success</code></td>
75
+ <td><code>status</code></td>
76
+ <td><code>check-circle</code></td>
77
+ <td>A confirmation tied to the current step</td>
78
+ <td>fill <code>--status-success-subtle</code>, border <code>--status-success-subtle-border</code>, text <code>--status-success-active</code>, icon <code>--status-success-solid</code></td>
79
+ </tr>
80
+ <tr>
81
+ <td><code>warning</code></td>
82
+ <td><code>alert</code></td>
83
+ <td><code>warning</code> (triangle)</td>
84
+ <td>A procedure the user must follow</td>
85
+ <td>fill <code>--status-warning-subtle</code>, border <code>--status-warning-subtle-border</code>, text <code>--status-warning-active</code>, icon <code>--status-warning-solid</code></td>
86
+ </tr>
87
+ <tr>
88
+ <td><code>danger</code></td>
89
+ <td><code>alert</code></td>
90
+ <td><code>warning-circle</code></td>
91
+ <td>A hard consequence, stated without alarm</td>
92
+ <td>fill <code>--status-danger-subtle</code>, border <code>--status-danger-subtle-border</code>, text <code>--status-danger-active</code>, icon <code>--status-danger-solid</code></td>
93
+ </tr>
94
+ </tbody>
95
+ </table>
96
+
97
+ The icon names above are the canonical FODS names the manifest uses (`info` · `check-circle` · `warning` · `warning-circle`), held in `ALERT_STATUS_ICONS`; the action caret is `caret-right-small`. A legacy icon-font name passed through `icon` is not an `IconName`: TypeScript rejects it, and `<Icon>` would draw nothing.
98
+
99
+ Per the manifest, **violet is reserved for the „Budoucí“ invoice status and is not an Alert status**; a neutral status is available on demand via the tertiary tokens but is not implemented here.
100
+
101
+ The full matrix — four families × (Stacked Center · Stacked Top · Inline), twelve variants. Top is reached with a long body in a narrow harness, never with an argument; the Top row also carries a Buttons + helper action row:
102
+
103
+ <Canvas of={AlertStories.Matrix} />
104
+
105
+ ## Sizes
106
+
107
+ **Alert has no size axis.** The second axis is `layout`, a density arrangement — this table documents that axis, which the manifest states as its two `sizes[]` measurement rows.
108
+
109
+ <Canvas of={AlertStories.Layouts} />
110
+
111
+ <table>
112
+ <thead>
113
+ <tr><th>Layout</th><th>Padding</th><th>Icon</th><th>Icon ↔ content gap</th><th>Radius</th><th>Body type</th><th>Title</th></tr>
114
+ </thead>
115
+ <tbody>
116
+ <tr>
117
+ <td><code>stacked</code> (default)</td>
118
+ <td><code>--space-600</code> / <code>--space-500</code></td>
119
+ <td>24px, centred; top past four lines</td>
120
+ <td><code>--space-500</code></td>
121
+ <td><code>--radius-400</code></td>
122
+ <td><code>--font-size-xs</code></td>
123
+ <td>rendered</td>
124
+ </tr>
125
+ <tr>
126
+ <td><code>inline</code></td>
127
+ <td><code>--space-500</code> / <code>--space-400</code></td>
128
+ <td>20px, vertically centred</td>
129
+ <td><code>--space-400</code></td>
130
+ <td><code>--radius-400</code></td>
131
+ <td><code>--font-size-xs</code></td>
132
+ <td>ignored</td>
133
+ </tr>
134
+ </tbody>
135
+ </table>
136
+
137
+ In **Stacked** the icon is **centred** on the content column (manifest 0.6.0, `Icon align=Center`) and the action row sits below the body. Once the content column (title + body + action) is taller than four lines — 4 × the Body/XS line height + 3 × `--space-200`, 95.2 px on today's tokens (`sizes[Stacked].note`) — the icon moves to the **top** (`Icon align=Top`). The switch is measured with a `ResizeObserver` from the column's computed line height and gap, not counted from the copy, so zoom, narrow reflow and a longer translation flip it too. The root exposes the result as `data-icon-align`. In **Inline** the icon is always vertically centred, the body may wrap to a second line, and the one action is pushed to the trailing edge with `ml-auto` (not `justify-between`), so that with no action the body still sits directly beside the icon. With an xs Button in the slot the Inline row is 44 high.
138
+
139
+ The action Text Link is **xxs (12)** with the `-small` caret (manifest 0.6.0) — one step **below** the `Body/XS` (13) copy again, so the message leads and the link follows; this reverses the 2026-08-20 call that had made it 14. Action Buttons are `size="xs"` (28), larger in Stacked only when the surrounding design asks for it; Inline stays xs. Items in the row sit `--space-400` apart and wrap to a second line when out of width.
140
+
141
+ `layout="inline"` **ignores `title`** (manifest `intent.rules[2]`). The prop is not rejected — an Alert that switches layout responsively must be able to keep passing the same props — the title is simply not rendered, and no `title` part exists in that layout's DOM.
142
+
143
+ ## States
144
+
145
+ <Canvas of={AlertStories.States} />
146
+
147
+ The container has exactly **one** state. Manifest `axes.state` has the single member `Default`; there is no hover, pressed, selected or focus state on the container, **no `disabled` and no `loading` prop**, and no dismiss affordance. All interaction belongs to the action row: the Text Link's states come from `TextLink` (the grid below), a Button's from `Button`.
148
+
149
+ <table>
150
+ <thead>
151
+ <tr><th>Element</th><th>State</th><th>Ink / behaviour</th></tr>
152
+ </thead>
153
+ <tbody>
154
+ <tr>
155
+ <td>Container</td>
156
+ <td>Default (the only one)</td>
157
+ <td>fill <code>--status-X-subtle</code>, border <code>--status-X-subtle-border</code>, text <code>--status-X-active</code>; no <code>tabIndex</code>, no ring</td>
158
+ </tr>
159
+ <tr>
160
+ <td>Action link</td>
161
+ <td>Rest</td>
162
+ <td><code>--status-X-active</code> — the container ink, <strong>not</strong> <code>--text-link</code> blue</td>
163
+ </tr>
164
+ <tr>
165
+ <td>Action link</td>
166
+ <td>Hover</td>
167
+ <td><code>color-mix(in oklab, var(--status-X-active), var(--text-primary) 15%)</code></td>
168
+ </tr>
169
+ <tr>
170
+ <td>Action link</td>
171
+ <td>Pressed</td>
172
+ <td><code>color-mix(in oklab, var(--status-X-active), var(--text-primary) 30%)</code></td>
173
+ </tr>
174
+ <tr>
175
+ <td>Action link</td>
176
+ <td>Focus</td>
177
+ <td><code>TextLink</code>'s own additive <code>--outline-focus</code> ring at <code>--border-width-200</code>, offset 3px, drawn outside the box</td>
178
+ </tr>
179
+ <tr>
180
+ <td>Action Button</td>
181
+ <td>All</td>
182
+ <td>The Button's own family states and focus ring — never recoloured to the status; Secondary / Tertiary / Danger outline carry <code>showSurface</code>, so their ink sits on <code>--bg-primary</code></td>
183
+ </tr>
184
+ </tbody>
185
+ </table>
186
+
187
+ The underline is **on in every state** (`TextLink` default `underline="on"`, which is unconditional) — that is the non-colour signal required by WCAG 1.4.1, since the link is not blue.
188
+
189
+ Two documented deviations sit behind the hover / pressed rows:
190
+
191
+ 1. **The `color-mix` values are arbitrary Tailwind values**, each carrying a `fods-lint-disable-next-line`. This is not a token bypass: `text-link.manifest.json → delivery.coloredLinks.colorMix` prescribes exactly this formula and no token exists for the mixed step.
192
+ 2. **The classes carry an explicit `color:` data-type hint** — `text-[color:color-mix(…)]`, not `text-[color-mix(…)]`. Without the hint tailwind-merge (v2.6) classifies the value into neither `font-size` nor `text-color`, so `TextLink`'s own `hover:!text-text-link-hover` survives the merge and the link renders blue on hover.
193
+
194
+ Hover and Pressed are rendered **statically** in the States grid (a runtime `<style>` mirroring the same formula), never through `parameters.pseudo` — Tailwind v4 wraps `hover:` utilities in `@media (hover:hover)`, which the pseudo-states addon does not rewrite, so a pseudo row would silently look identical to Default.
195
+
196
+ ### Motion
197
+
198
+ Only an Alert **added or removed after load** moves (manifest 0.8.1 `motion`), which is exactly what
199
+ `live` declares. A `live` Alert mounted by a client render (not in its root's server or hydration render) sits in a room that opens on
200
+ `--spring-gentle` (height) while the Alert fades in over `--duration-slow` / `--easing-enter`; the
201
+ content never scales or slides, and the siblings below ride the room. Removal animates when the caller
202
+ unmounts the `live` Alert inside its own `AnimatePresence`: the Alert fades out over `--duration-fast`
203
+ / `--easing-exit` first, and only then does the room close on `--spring-gentle`. Without
204
+ `AnimatePresence` it unmounts at once. A `live` Alert in the server / hydration render, and every
205
+ Alert without `live`, renders as before — no wrapper, no motion. The room clips only while it moves,
206
+ so the action row's focus rings are never cut. Under `prefers-reduced-motion` the room opens and
207
+ closes at once and only the opacity fade remains.
208
+
209
+ <Canvas of={AlertStories.Motion} />
210
+
211
+ ## API
212
+
213
+ <Controls />
214
+
215
+ `role` is deliberately absent from the table: it is stripped from the props type and derived from `status` when `live` is set. There is no `size`, no `disabled`, no `loading`, no `iconAlign` (measured, see Sizes) and no `onClose`/`dismissible` prop — see Rationale and States.
216
+
217
+ `action` takes two shapes:
218
+
219
+ - **`AlertAction`** — `{ label, href?, onClick? }`, the shorthand for the default content: one Strong Text Link (xxs, `caret-right-small`) in the container ink. Every consumer from before 0.7.0 passes this and keeps working unchanged.
220
+ - **A node** — the action row, composed of `Button size="xs"`, **`AlertActionLink`** (the same Text Link; it reads the status of the enclosing Alert for its ink) and **`AlertActionHelper`** (the helper text). Main command first, at most two Buttons, then one link **or** one helper. `layout="inline"` takes one node only — a link or one Button; the component does not police it.
221
+
222
+ ## Do / Don't
223
+
224
+ - ✅ Use it for a consequence or heads-up **local** to the current task — inside the form, step or section it explains.
225
+ - ✅ Lead the action row with the one main command; every label is verb-first, names its object and has no trailing punctuation (on a Text Link the caret is the affordance).
226
+ - ✅ Use a Button for a command that acts in place (Secondary + `showSurface` or Primary, by the surrounding design; Danger outline / Danger only for a destructive command); a link to somewhere else stays a Text Link.
227
+ - ✅ Let the body wrap freely; write short, specific copy. Title = a short noun phrase, sentence case, no end period.
228
+ - ✅ Match tone to status: Danger states the hard consequence without alarm, Success confirms, Warning gives the heads-up plus the way forward.
229
+ - ✅ Pass `live` when the Alert appears after load in response to an input or action (a validation error on submit, a failed request) — and only then.
230
+ - ❌ Don't use it as a page-level or app-wide strip, including a strip under the nav bar (→ Status Bar), nor as a flash that appears after an action (→ Toast), nor as field-level validation text (that belongs on the field).
231
+ - ❌ Don't pass `live` to an Alert that is on the page from the start — it would be announced on every load.
232
+ - ❌ Don't add a close × or an Icon Button, don't put more than two Buttons in the row (that task belongs in a form or a modal), and don't put more than one action in an Inline Alert.
233
+ - ❌ Don't recolour an action Button to the status — it keeps its Button colours.
234
+ - ❌ Don't lean on colour alone to signal severity — icon **and** text must carry it. Pass `hideIcon` only where the copy already names the status.
235
+ - ❌ Don't hardcode the tint / text / border; bind to the status tokens in the manifest.
236
+ - ❌ Don't pass `title` with `layout="inline"` expecting it to show — it is ignored there.
237
+
238
+ ## Accessibility
239
+
240
+ - **Keyboard** — the container takes no focus: no `tabIndex`, no `role="button"`, no ring. Every item in the action row that acts is a real control — a `TextLink` (an `<a>` when `href` is given, a `<button>` when only `onClick` is) or a `Button` — with its own focus ring. Tab reaches the row after the message and moves through it left to right (DOM order = visual order, main command first). Helper text is plain text, not focusable. Inserting an Alert never moves focus.
241
+ - **Target size (2.5.8)** — an xs Button clears the minimum on its own. The xxs Text Link is shorter and passes through the spacing exception: the row gap `--space-400` plus the Alert padding keep every neighbouring target outside its 24px circle. Keep the gap token.
242
+ - **ARIA / role — live region only when inserted after load** (manifest 0.5.2 `delivery.react`). An Alert that appears after page load in response to an input or action passes `live` and becomes a live region, its role derived from `status` via `ALERT_ROLE`: warning / danger → `role="alert"` (assertive), info / success → `role="status"` (polite). An Alert already present on load omits `live` and renders as plain content with no role, so it is not announced on every load. `role` is removed from the props type, so a consumer cannot override it. Consumers pass no ARIA of their own for the notice itself. A live **info / success** Alert mounts its `role="status"` container **without the message** (title + body) and injects it one commit later, because a polite region inserted together with its text is often not announced. The action row is there from the first commit, so a caller can focus it on mount. Warning / danger render the message at once (`role="alert"` is announced on insertion).
243
+ - **Screen reader** — the leading icon is decorative and always `aria-hidden="true"` (`Icon` sets it unconditionally), so a SR user hears the title and body text only; the status must therefore be legible from the copy whenever the visual glyph is the only other carrier. A `live` Alert is announced when it is inserted, and again when its content changes — assertively for warning / danger, politely for info / success; one present on load is read only in the normal reading order.
244
+
245
+ <Canvas of={AlertStories.LiveRegion} />
246
+
247
+ - **Contrast** — text ink is the status `-active` step on the `-subtle` tint (the callout-ink model), which clears AA for body text: manifest figures ≈ 6.53 (Info) · 6.58 (Success) · 5.99 (Warning) · 8.00 (Danger) : 1. The icon is the brighter `-solid` step and is measured as a non-text graphic against 3:1 (WCAG 1.4.11): Info 3.86, Success 3.03, Danger 5.42 pass — **Warning is 2.1 : 1, below the 3:1 minimum**. It is technically exempt because the glyph is decorative and redundant (the triangle shape plus the adjacent text carry the status), but it is a **known upstream limitation** recorded in the manifest, not a licence to recolour it, and it is worth revisiting if the Warning icon ever becomes a sole status carrier.
248
+ - **Icon align is visual only** — the icon is decorative, so the centre → top switch changes nothing for assistive tech; DOM order stays title → body → action.
249
+ - **Non-colour signals (1.4.1)** — the icon shape (a triangle for Warning, a circle for the rest) reinforces the status independently of hue, and the action link stays underlined in every state precisely because it is not blue. `hideIcon` removes the shape signal, which is why the copy must name the status when you use it.
250
+ - **Motion** — only a `live` Alert added or removed after load fades and opens / closes its room
251
+ (see [States](#states) → Motion); under `prefers-reduced-motion` the room change is instant and
252
+ only the fade remains. The Alert is removed from the DOM once its room has closed, so nothing
253
+ hidden stays focusable or announced. An Alert present on load never animates.
254
+
255
+ Accessibility floor for every FODS component: `spec/01-foundations/accessibility.md`.
256
+
257
+ ## Copy
258
+
259
+ Voice: the product tone, impersonal and in-app: plain, specific, calm even for Danger. Match the
260
+ tone to the status: Danger states the hard consequence without alarm, Success confirms, Warning
261
+ gives the heads-up plus the way forward.
262
+
263
+ - **Title** (`title`, Stacked only; ignored in `layout="inline"`): a short **noun phrase** that
264
+ names the situation, sentence case, no end period (*Změna DIČ odběratele*). Wraps, at most 2
265
+ lines, max 48 characters.
266
+ - **Body** (`children`): one or two sentences stating the consequence or the next step in plain
267
+ language (*Celou fakturu lze stornovat, jen když jsou zaškrtnuté všechny položky.*). Impersonal,
268
+ no ty-form; a non-breaking space after one-letter prepositions and conjunctions (v, k, s, z, a,
269
+ i, o, u) and between a number and its unit (*14 dní*). Wraps freely in both layouts, never
270
+ truncated; max 140 characters.
271
+ - **Action** (`action`: the `label` of an `AlertAction`, or each `AlertActionLink` / `Button` in
272
+ the row): every label is **verb-first**, names its object and has no trailing punctuation
273
+ (*Zobrazit položky*, *Doplnit IBAN*, *Poslat upomínku*); a bare *Zobrazit* / *Doplnit* does not
274
+ say where it leads. On a Text Link the caret is the affordance, not text. A command that acts
275
+ in place (*Poslat upomínku*) is a Button and follows the Button copy rules: a destructive one
276
+ names the object and the act (*Smazat položky*). A link to somewhere else stays a Text Link;
277
+ one that opens elsewhere carries a trailing `arrow-square-out` and *(otevře se v novém okně)*
278
+ in its label. One line, truncated past max 22 characters per label.
279
+ - **Helper** (`AlertActionHelper`, Stacked only): one short phrase that says what the command will
280
+ do or when (*Odešle se e-mailem*), sentence case, no end period. Wraps, max 40 characters.
281
+
282
+ ## Usage
283
+
284
+ ```tsx
285
+ // Good — a consequence tied to the control the user is touching, one link (the shorthand)
286
+ <Alert
287
+ status="warning"
288
+ title="Změna DIČ odběratele"
289
+ action={{ label: 'Vystavit dobropis', href: '#' }}
290
+ >
291
+ DIČ na vystavené faktuře nelze přepsat — opravuje se dobropisem a novou fakturou.
292
+ </Alert>
293
+
294
+ // Good — the compact single row beside a field; an in-page action renders a <button>
295
+ <Alert
296
+ status="info"
297
+ layout="inline"
298
+ action={{ label: 'Číst o paušální dani', onClick: openVatHelp }}
299
+ >
300
+ V limitu 1. pásma — doplatek se neočekává.
301
+ </Alert>
302
+
303
+ // Good — Inline with ONE Button instead of a link
304
+ <Alert
305
+ status="danger"
306
+ layout="inline"
307
+ action={
308
+ <Button size="xs" variant="secondary" showSurface leadingIcon={<Icon name="paper-plane-tilt" />}>
309
+ Poslat upomínku
310
+ </Button>
311
+ }
312
+ >
313
+ Faktura je 14 dní po splatnosti.
314
+ </Alert>
315
+
316
+ // Good — a Stacked action row: the main command first, then one link or one helper text
317
+ <Alert
318
+ status="danger"
319
+ title="Faktura po splatnosti"
320
+ action={
321
+ <>
322
+ <Button size="xs" variant="primary" onClick={sendReminder}>Poslat upomínku</Button>
323
+ <AlertActionHelper>Odešle se e‑mailem</AlertActionHelper>
324
+ </>
325
+ }
326
+ >
327
+ Faktura je 14 dní po splatnosti.
328
+ </Alert>
329
+
330
+ // Good — hideIcon only when the copy itself names the status
331
+ <Alert status="warning" hideIcon title="Upozornění: změna DIČ odběratele">
332
+ DIČ na vystavené faktuře nelze přepsat — opravuje se dobropisem a novou fakturou.
333
+ </Alert>
334
+
335
+ // Don't — title is ignored in the inline layout
336
+ <Alert status="info" layout="inline" title="Nezobrazí se">
337
+ V limitu 1. pásma — doplatek se neočekává.
338
+ </Alert>
339
+
340
+ // Don't — a link in the body, or a plain TextLink in the row (blue, not the container ink);
341
+ // compose the row with AlertActionLink instead
342
+ <Alert
343
+ status="danger"
344
+ title="Storno faktury"
345
+ action={<TextLink href="#">Zobrazit položky</TextLink>}
346
+ >
347
+ Celou fakturu lze stornovat, jen když jsou zaškrtnuté všechny položky.
348
+ </Alert>
349
+
350
+ // Good — inserted after a submit: a live region, role="alert" derived from status
351
+ {submitFailed && (
352
+ <Alert live status="danger">Fakturu se nepodařilo uložit.</Alert>
353
+ )}
354
+
355
+ // Don't — role is derived from status and cannot be overridden (TS error)
356
+ <Alert status="info" role="alert">Nelze.</Alert>
357
+ ```
358
+
359
+ Alert in its real habitat — inside a form step, tied to the control whose change it explains:
360
+
361
+ <Canvas of={AlertStories.InContext} />
362
+
363
+ ## Related
364
+
365
+ - [`Button`](?path=/docs/design-system-atoms-button--docs) — the command in the action row (`size="xs"`, own family colours, `showSurface` on the outline families).
366
+ - [`TextLink`](?path=/docs/design-system-atoms-textlink--docs) — the action link atom (`AlertActionLink` wraps it). Its Colored-links model owns the Alert action's ink; an action that opens elsewhere is composed with `TextLink` directly, since it owns the `target` / `rel` contract.
367
+ - `Icon` — the leading glyph; always `aria-hidden`, sized by width and height from a `--size-icon*` token.
368
+ - **No external-action variant ships here**: the manifest mentions a trailing `arrow-square-out` for actions that open elsewhere. The glyph is in the icon set, so this is a scope decision, not a missing-glyph gap — only the internal see-more form (`caret-right-small`) is available. Compose an external action with `TextLink` directly.
369
+ - Out of Alert's scope per the upstream spec, and **not implemented in this package**: Status Bar (the app-level top strip), Toast (action feedback) and Infobar (a deprecated top flash). There is no separate Message component — Alert is it.
370
+ - Spec: `spec/04-molecules/alert.md`
371
+
372
+ ## Migration notes
373
+
374
+ Manifest 0.8.0 / 0.8.1 (2026-11-03): marked stable, then the `motion` block — an Alert added or
375
+ removed after load fades its content and opens or closes its room on `--spring-gentle`. Before 0.8.1
376
+ the React Alert emitted no transition at all; now a `live` Alert animates its arrival, and its
377
+ removal when the consumer wraps it in `AnimatePresence` (`motion/react`). No props changed.