@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,704 @@
1
+ import { Meta, Canvas, Controls } from '@storybook/addon-docs/blocks';
2
+ import * as BannerStories from './Banner.stories';
3
+ import { ViewportFrame } from '../../storybook/viewportFrame';
4
+
5
+ <Meta of={BannerStories} tags={['autodocs']} />
6
+
7
+ # Banner
8
+
9
+ ## Metadata
10
+
11
+ - **Layer:** organism (Web layer, `spec/07-web/`)
12
+ - **Kind:** region
13
+ - **Status:** draft
14
+ - **Tokens used:** `--border-width-100`, `--border-width-200`, `--font-body`, `--font-heading`, `--font-size-display-d1`, `--font-size-display-d2`, `--font-size-display-d3`, `--font-size-heading-h1`, `--font-size-heading-h2`, `--font-size-heading-h3`, `--font-size-heading-h4`, `--font-size-heading-h5`, `--font-size-lg`, `--font-weight-bold`, `--font-weight-semibold`, `--leading-compact`, `--leading-relaxed`, `--leading-tight`, `--outline-focus-inverse`, `--radius-800`, `--secondary-tint-foreground`, `--space-1000`, `--space-1100`, `--space-1300`, `--space-400`, `--space-500`, `--space-600`, `--space-800`, `--space-900`, `--text-inverted`, `--text-primary`, `--text-wrap-body`, `--text-wrap-heading`
15
+ - **Manifest version:** `3.0.0`
16
+ - **Storybook:** [design-system-organisms-banner](?path=/docs/design-system-organisms-banner--docs)
17
+
18
+ ## Overview
19
+
20
+ **Banner** is a promotional panel for public pages: one claim, an artwork recipe and a call to
21
+ action on a [PromoSurface](?path=/docs/design-system-atoms-promosurface--docs) plaque. Three
22
+ Compositions set how much room the pitch gets — **Person** (a character over an invoice, beside or
23
+ under the copy), **Invoice** (copy centred over a clipped invoice band) and **Mini** (a one-line
24
+ heading with the actions beside it, no artwork). What the panel asks the visitor to do is not a
25
+ variant: it is whatever goes in the **Actions** slot, passed as `children` — a button, two buttons,
26
+ a button and a link, or a field with its button.
27
+
28
+ The package ships no artwork (manifest 2.2.0 `delivery.react`): the app passes its own pictures as
29
+ React elements — Person takes `character` and `invoiceIllustration` `{ left, right }`, Invoice takes
30
+ `invoiceIllustration` only, Mini takes neither. Banner owns the boxes, their positions and the
31
+ clipping; how an app supplies pictures:
32
+ [Consuming → Assets](?path=/docs/getting-started-consuming--docs#assets).
33
+
34
+ **Do not** use it for the first screen of a page or for copy that needs a kicker, a format icon or a
35
+ sub strip. That is a [Hero](?path=/docs/design-system-organisms-hero--docs) — never a fourth
36
+ `composition` value (`intent.rules[0]`). Like Hero, Banner inherits PromoSurface's public-page-only
37
+ restriction: it is not an in-app card or callout.
38
+
39
+ ## Rationale
40
+
41
+ The artwork and the layout are the expensive, crafted part, so they stay a closed set of three
42
+ recipes on the same PromoSurface plaque Hero uses. The actions are cheap to vary and vary often
43
+ between pages — a sign-up, a search, a second route — so since 2.0.0 they live in one slot with an
44
+ accepted set of controls instead of a Composition value per arrangement.
45
+
46
+ What Banner deliberately does **not** own:
47
+
48
+ - **The page frame.** The width ladder, the side gutter (16 / 24 / 32 / 40 / 40) and the marketing
49
+ container cap are the page container's (spec/07-web → Page frame, `container.note`) — the same
50
+ split Hero documents. The plaque fills the block content with no max-width of its own. In these
51
+ stories a `pageContainer` decorator models the frame. The `--space-800` band above and below the
52
+ plaque **is** Banner's (2.1.0): the `<section>` carries it.
53
+ - **The heading level.** `headingLevel` is required with no default: `1` only where Banner is the
54
+ first screen, a lower level everywhere else; inside an article Mini sits one level below the
55
+ current section heading.
56
+ - **The controls in the slot and their states.** Button, Text Link, Text Field and Subject Lookup
57
+ Field own every interaction state (see States).
58
+
59
+ ## Anatomy
60
+
61
+ Seventeen `data-fods-part` markers across the three compositions. The PromoSurface is **not** a
62
+ wrapper: it is an absolutely positioned sibling layer (`absolute inset-0`) inside the plaque, followed
63
+ in the tree by the visual and then the text column. Paint order is tree order, so the text column
64
+ lands above the visual and the visual above the surface — the layer order of
65
+ `regions.visual.note` — without a single `z-index`.
66
+
67
+ <table>
68
+ <thead>
69
+ <tr><th><code>data-fods-part</code></th><th>Element</th><th>Role</th><th>Chrome / tokens</th></tr>
70
+ </thead>
71
+ <tbody>
72
+ <tr>
73
+ <td><code>root</code></td><td><code>&lt;section&gt;</code></td>
74
+ <td>The region. Carries <code>data-fods-component="banner"</code>; unnamed on purpose (see Accessibility).</td>
75
+ <td><code>w-full</code>, no fill; <code>--space-800</code> above and below (2.1.0) — width and gutter are the page container's</td>
76
+ </tr>
77
+ <tr>
78
+ <td><code>panel</code></td><td><code>&lt;div&gt;</code></td>
79
+ <td>The plaque. <code>relative</code> so the absolute surface and visual resolve against it. Never clips (<code>intent.rules[3]</code>).</td>
80
+ <td><code>--radius-800</code>; ink <code>--text-primary</code> (Brand) / <code>--text-inverted</code> (Solid)</td>
81
+ </tr>
82
+ <tr>
83
+ <td><code>visual</code></td><td><code>&lt;div aria-hidden&gt;</code></td>
84
+ <td>Person and Invoice — the campaign artwork region. Mini renders none.</td>
85
+ <td>Invoice: <code>overflow-hidden</code>. Person: no clip on the box</td>
86
+ </tr>
87
+ <tr>
88
+ <td><code>artwork</code></td><td><code>&lt;div&gt;</code></td>
89
+ <td>Person only — the box holding the invoice graphic and the character.</td>
90
+ <td><code>clip-path: inset(-100% -100% 0)</code> — cuts the bottom edge only</td>
91
+ </tr>
92
+ <tr>
93
+ <td><code>invoice</code></td><td><code>&lt;div&gt;</code></td>
94
+ <td>The invoice graphic: two sheets pinned to opposite edges, so they spread apart as the box widens.</td>
95
+ <td><code>--space-800</code> taller than its box and run <code>--space-800</code> past its bottom edge</td>
96
+ </tr>
97
+ <tr>
98
+ <td><code>invoice-sheet-left</code> / <code>invoice-sheet-right</code></td><td><code>&lt;div&gt;</code></td>
99
+ <td>The two sheet boxes, holding <code>invoiceIllustration.left</code> / <code>.right</code> (<code>slots.invoice-illustration</code>), pinned to the start / end edge. Height = the invoice box, width from the picture's own ratio — a constant authored size at every breakpoint (1.8.0), never scaled with the band.</td>
100
+ <td><code>h-full w-auto max-w-none</code>; the picture <code>block h-full w-auto max-w-none</code></td>
101
+ </tr>
102
+ <tr>
103
+ <td><code>character</code></td><td><code>&lt;div&gt;</code></td>
104
+ <td>Person only — the box holding <code>character</code> (<code>slots.character</code>), bottom-anchored. The picture fills the box's width; its own ratio gives the height.</td>
105
+ <td>Authored px box (see Sizes); the picture <code>block h-auto w-full max-w-none</code></td>
106
+ </tr>
107
+ <tr>
108
+ <td><code>text-column</code></td><td><code>&lt;div&gt;</code></td>
109
+ <td>Copy (or Mini's heading) + actions. <code>relative</code>, so the in-flow column paints above the absolute siblings before it.</td>
110
+ <td>Gap <code>--space-800</code> (Mini <code>--space-600</code> below MD); padding per composition × breakpoint</td>
111
+ </tr>
112
+ <tr>
113
+ <td><code>copy</code></td><td><code>&lt;div&gt;</code></td>
114
+ <td>Person and Invoice — heading + the optional detail line. Mini has no copy frame.</td>
115
+ <td>Gap <code>--space-600</code> (the Heading Group D2 ladder, changelog 2026-08-28)</td>
116
+ </tr>
117
+ <tr>
118
+ <td><code>heading</code></td><td><code>Heading</code> atom</td>
119
+ <td>Person and Invoice — the panel's single claim. Tag from <code>headingLevel</code>, rendered at <code>size="d2"</code>.</td>
120
+ <td>Display/D2 via <code>text-display-d2</code> (<code>--font-size-display-d2</code>, bold, balanced wrapping); ink per <code>surface</code></td>
121
+ </tr>
122
+ <tr>
123
+ <td><code>mini-heading</code></td><td><code>Heading</code> atom</td>
124
+ <td>Mini — the short claim, FILL in the row from MD, at most three lines (<code>text.mini-heading</code>).</td>
125
+ <td>Display/D3 via <code>text-display-d3</code> (<code>--font-size-display-d3</code>); ink per <code>surface</code></td>
126
+ </tr>
127
+ <tr>
128
+ <td><code>body</code></td><td><code>&lt;p&gt;</code></td>
129
+ <td>Person and Invoice — the detail line, rendered only when <code>detail</code> is a non-blank string.</td>
130
+ <td>Inter Body/XL (<code>--font-size-lg</code> + <code>--leading-relaxed</code>) at every breakpoint, <code>--text-wrap-body</code>; ink per <code>surface</code></td>
131
+ </tr>
132
+ <tr>
133
+ <td><code>actions</code></td><td><code>&lt;div&gt;</code> / <code>&lt;form&gt;</code></td>
134
+ <td>The Actions slot (<code>slots.actions</code>) — renders <code>children</code>. A <code>&lt;form&gt;</code> when <code>actionsForm</code> is passed (a field + submit pair).</td>
135
+ <td>Gap <code>--space-400</code> — the adjacent-target minimum (<code>regions.actions.gap</code>); full-width column at Mobile (and SM on Mini), wrapping row above</td>
136
+ </tr>
137
+ <tr>
138
+ <td><code>action</code></td><td>Button → <code>&lt;a&gt;</code></td>
139
+ <td><code>BannerAction</code>, the slot's default content — Button <code>brand</code> rendered <code>asChild</code> as a link, leading icon <code>invoice-new</code>. Person / Invoice: <code>lg</code> at Mobile, <code>xl</code> from SM; Mini: <code>lg</code> everywhere.</td>
140
+ <td>Two instances of the same link, one per size band: the Mobile one full width with <code>sm:hidden</code>, the other with <code>hidden sm:inline-flex</code>. Button stays the only owner of both geometries; <code>display: none</code> keeps the hidden twin out of the tab order and the accessibility tree, and the swap is pure CSS (SSR-safe). <code>pl-500</code> / <code>pl-600</code> restore Button's leading-icon padding per size, which the <code>asChild</code> branch cannot derive. The Mobile label wraps to at most two lines (<code>line-clamp-2</code>); from SM it is a single <code>truncate</code> line</td>
141
+ </tr>
142
+ </tbody>
143
+ </table>
144
+
145
+ The `surface` layer itself is not in the table: it is the PromoSurface atom, measured under that
146
+ component. Banner chooses only its `layout` and `surface` (see Variants). Controls a consumer puts in
147
+ the slot keep their own markers.
148
+
149
+ ## Variants
150
+
151
+ Three axes in the manifest — **Composition** × **Surface** × **Breakpoint** (3 × 2 × 5 = 30 cells).
152
+ Only the first two are props. **Breakpoint is not a prop** (`properties[Breakpoint].maps`): it is
153
+ pure CSS responsiveness, Mobile = unprefixed, SM = `sm:`, MD = `md:`, LG = `lg:`, XL = `xl:`.
154
+
155
+ The Matrix stories show the six Composition × Surface cells at every step of the ladder — XL, LG,
156
+ MD, SM and Mobile.
157
+
158
+ {/* Docs canvases render inline at the column width, where no breakpoint applies — so the
159
+ responsive stories are framed at their real viewport and scaled to fit. */}
160
+ <ViewportFrame storyId="design-system-organisms-banner--matrix" width={1280} label="Matrix · XL — viewport 1280, plaque 1190" />
161
+ <ViewportFrame storyId="design-system-organisms-banner--matrix-lg" width={1024} label="Matrix · LG — viewport 1024, plaque 880" />
162
+ <ViewportFrame storyId="design-system-organisms-banner--matrix-md" width={768} label="Matrix · MD — viewport 768, plaque 656" />
163
+ <ViewportFrame storyId="design-system-organisms-banner--matrix-sm" width={640} label="Matrix · SM — viewport 640, plaque 552" />
164
+ <ViewportFrame storyId="design-system-organisms-banner--matrix-mobile" width={390} label="Matrix · Mobile — viewport 390, plaque 358" />
165
+
166
+ <table>
167
+ <thead>
168
+ <tr><th><code>composition</code></th><th>Holds</th><th>Composition across the ladder</th></tr>
169
+ </thead>
170
+ <tbody>
171
+ <tr>
172
+ <td><code>person</code> (default)</td>
173
+ <td>Heading (Display/D2), optional detail, the Actions slot — over a character-on-invoice visual.</td>
174
+ <td>Copy beside the visual (left) at LG / XL; stacked above it and centred at MD / SM / Mobile.</td>
175
+ </tr>
176
+ <tr>
177
+ <td><code>invoice</code></td>
178
+ <td>The same heading / detail / actions, over an invoice-only band.</td>
179
+ <td>Copy centred in a vertical plaque at every breakpoint, capped at <code>--ds-content-narrow</code> (580).</td>
180
+ </tr>
181
+ <tr>
182
+ <td><code>mini</code></td>
183
+ <td>A short heading (Display/D3) and the Actions slot — no detail line, no artwork.</td>
184
+ <td>Heading (FILL) and actions (HUG) in one row at XL / LG / MD, gap <code>--space-800</code>, padding <code>--space-900</code>; stacked at SM / Mobile, gap <code>--space-600</code>, padding <code>--space-800</code>, left-aligned, the action full width.</td>
185
+ </tr>
186
+ </tbody>
187
+ </table>
188
+
189
+ ### What goes in the Actions slot
190
+
191
+ One or two controls (`slots.actions`, `intent.rules[6]`). Never two Brand buttons, never a field
192
+ without its submit button.
193
+
194
+ <table>
195
+ <thead>
196
+ <tr><th>Filling</th><th>Surface</th><th>In code</th></tr>
197
+ </thead>
198
+ <tbody>
199
+ <tr><td>One Brand Button (default)</td><td>Brand · Solid</td><td><code>&lt;BannerAction href&gt;</code> — sized per Composition × Breakpoint</td></tr>
200
+ <tr><td>Text Field (or Subject Lookup Field) + its submit Brand Button</td><td>Brand · Solid</td><td><code>&lt;TextField size="md" aria-label leadingIcon&gt;</code> + <code>&lt;Button type="submit" size="lg"&gt;</code>, with <code>actionsForm</code> so Enter submits. The button stretches to the field's 48 from SM.</td></tr>
201
+ <tr><td>Brand Button + Secondary Button, Show surface on</td><td>Brand only</td><td><code>&lt;Button variant="secondary" showSurface&gt;</code> at the Brand Button's size</td></tr>
202
+ <tr><td>Brand Button + Text Link, md, underlined</td><td>Brand only</td><td><code>&lt;TextLink size="md" underline="on"&gt;</code> — Banner pads its hit area to 44, in-flow</td></tr>
203
+ </tbody>
204
+ </table>
205
+
206
+ <Canvas of={BannerStories.PersonField} />
207
+ <Canvas of={BannerStories.ActionsWithLink} />
208
+ <Canvas of={BannerStories.ActionsWithSecondary} />
209
+
210
+ ### Mini
211
+
212
+ <Canvas of={BannerStories.MiniBrand} />
213
+ <Canvas of={BannerStories.MiniSolid} />
214
+ <ViewportFrame storyId="design-system-organisms-banner--mini-mobile" width={390} label="Mini · Mobile — stacked, the action full width" />
215
+
216
+ ### Which PromoSurface layout applies where
217
+
218
+ The `layout` follows where the copy actually sits, never the breakpoint (`intent.rules[2]`).
219
+
220
+ <table>
221
+ <thead>
222
+ <tr><th>Cell</th><th>PromoSurface <code>layout</code></th><th>How it is selected</th></tr>
223
+ </thead>
224
+ <tbody>
225
+ <tr><td>Person · XL / LG</td><td><code>side</code></td><td>Instance with <code>hidden lg:block</code></td></tr>
226
+ <tr><td>Person · MD / SM / Mobile</td><td><code>top</code></td><td>Instance with <code>lg:hidden</code></td></tr>
227
+ <tr><td>Mini · XL / LG / MD</td><td><code>side</code></td><td>Instance with <code>hidden md:block</code></td></tr>
228
+ <tr><td>Mini · SM / Mobile</td><td><code>top</code></td><td>Instance with <code>md:hidden</code></td></tr>
229
+ <tr><td>Invoice · every breakpoint</td><td><code>vertical</code></td><td>One instance</td></tr>
230
+ </tbody>
231
+ </table>
232
+
233
+ Person and Mini render **two** PromoSurface instances for the same reason as Hero's `visual="on"`:
234
+ PromoSurface turns `layout` into inline custom properties, and an inline style cannot carry a media
235
+ query.
236
+
237
+ ### Text alignment
238
+
239
+ `regions.text-column.align`: Person is **centred** at MD / SM / Mobile and **left** at LG / XL;
240
+ Invoice is centred everywhere; Mini is left at every breakpoint. The Person rule follows the manifest,
241
+ which records it as an open question (`gaps`).
242
+
243
+ ### Surface tone
244
+
245
+ `surface` passes straight through to PromoSurface, which owns the fill; Banner pairs the ink with it
246
+ and the two never mix (`intent.rules[1]`).
247
+
248
+ <table>
249
+ <thead>
250
+ <tr><th><code>surface</code></th><th>Plaque fill (PromoSurface)</th><th>Heading ink</th><th>Detail ink</th><th>Slot focus ring</th></tr>
251
+ </thead>
252
+ <tbody>
253
+ <tr><td><code>brand</code> (default)</td><td><code>--secondary-subtle</code></td><td><code>--text-primary</code></td><td><code>--secondary-tint-foreground</code> (Person and Invoice)</td><td>Each control's default</td></tr>
254
+ <tr><td><code>solid</code></td><td><code>--secondary-solid</code></td><td><code>--text-inverted</code></td><td><code>--text-inverted</code></td><td><code>--outline-focus-inverse</code> on every slotted control</td></tr>
255
+ </tbody>
256
+ </table>
257
+
258
+ The heading ink is set on the heading part itself, because the Heading atom binds `--text-primary`
259
+ in its own base; the configured tailwind-merge drops the atom's class on Solid.
260
+
261
+ ## Sizes
262
+
263
+ There is no `size` prop — Breakpoint **is** the sizing, and it is a ladder of authored steps, not a
264
+ scale (`intent.sizing`). One story per breakpoint, each pinned to the band-minimum viewport
265
+ (1280 / 1024 / 768 / 640) plus the 390 Mobile artboard; the page-container decorator clamps to the
266
+ marketing container and pads it by the gutter, which gives exactly the block content the plaque
267
+ fills (2.1.0).
268
+
269
+ <table>
270
+ <thead>
271
+ <tr>
272
+ <th>Breakpoint</th>
273
+ <th style={{ textAlign: 'right' }}>Viewport</th>
274
+ <th style={{ textAlign: 'right' }}>Block frame (container)</th>
275
+ <th>Gutter (container)</th>
276
+ <th style={{ textAlign: 'right' }}>Plaque = block content</th>
277
+ <th>Person split (text / visual)</th>
278
+ </tr>
279
+ </thead>
280
+ <tbody>
281
+ <tr><td>XL</td><td style={{ textAlign: 'right' }}>1280</td><td style={{ textAlign: 'right' }}>1270</td><td><code>--space-1000</code> (40)</td><td style={{ textAlign: 'right' }}>1190</td><td>basis 648 / 552, shrunk proportionally</td></tr>
282
+ <tr><td>LG</td><td style={{ textAlign: 'right' }}>1024</td><td style={{ textAlign: 'right' }}>960</td><td><code>--space-1000</code> (40)</td><td style={{ textAlign: 'right' }}>880</td><td>basis 520 / 424, shrunk proportionally</td></tr>
283
+ <tr><td>MD</td><td style={{ textAlign: 'right' }}>768</td><td style={{ textAlign: 'right' }}>720</td><td><code>--space-900</code> (32)</td><td style={{ textAlign: 'right' }}>656</td><td>stacked</td></tr>
284
+ <tr><td>SM</td><td style={{ textAlign: 'right' }}>640</td><td style={{ textAlign: 'right' }}>600</td><td><code>--space-800</code> (24)</td><td style={{ textAlign: 'right' }}>552</td><td>stacked</td></tr>
285
+ <tr><td>Mobile</td><td style={{ textAlign: 'right' }}>390</td><td style={{ textAlign: 'right' }}>fluid</td><td><code>--space-600</code> (16)</td><td style={{ textAlign: 'right' }}>358</td><td>stacked</td></tr>
286
+ </tbody>
287
+ </table>
288
+
289
+ The block frame is `--ds-container-sm` / `-md` / `-lg` / `-xl` (spec/07-web → Page frame). Above and
290
+ below the plaque the section carries `--space-800` (24) at every step — lighter than the page's
291
+ recommended vertical P, a deliberate exception so the plaque sits close to the sections around it.
292
+
293
+ The side-by-side split is a `basis` on **both** children (`lg:shrink lg:grow-0` on the text column,
294
+ `lg:shrink lg:grow` on the visual), so the plaque shares the deficit proportionally instead of
295
+ crushing one side. 2.1.0 narrowed the plaque (1200 → 1190 at XL, 944 → 880 at LG) without restating
296
+ the split; the authored bases stay and shrink to fit.
297
+
298
+ **The default action follows the ladder too** (`slots.actions`): on Person and Invoice Button `xl`
299
+ at XL / LG / MD / SM and `lg` at Mobile, where it runs full width and its label wraps to at most two
300
+ lines instead of truncating; on Mini `lg` at every breakpoint, because an `xl` button would outweigh
301
+ a one-line heading. A wrapped label takes `--space-400` (8) above and below, so the button grows
302
+ 54 → 70 while a one-line button stays 44. No CSS selector can tell a wrapped label from a one-line
303
+ one, so the padding is always there and Button's 44 min-height does the switching: the Mobile
304
+ instance carries `py-[calc(var(--space-400)-var(--border-width-100))]` — one line is 27 + 2 × 7 + 2 × 1
305
+ border = 43, under the floor; two lines are 54 + 14 + 2 = 70. The plaque hugs its content, so the
306
+ heights the manifest records (Person 280 / 332 / 604 / 584 / 598, Invoice 280 / 280 / 504 / 484 / 514,
307
+ Mini 108 / 148 / 190 / 176 / 176) are an outcome, never pinned. See the `Two-line CTA · Mobile` story.
308
+
309
+ <ViewportFrame storyId="design-system-organisms-banner--breakpoint-xl" width={1280} label="XL — viewport 1280, plaque 1190" />
310
+ <ViewportFrame storyId="design-system-organisms-banner--breakpoint-lg" width={1024} label="LG — viewport 1024, plaque 880" />
311
+ <ViewportFrame storyId="design-system-organisms-banner--breakpoint-md" width={768} label="MD — viewport 768, plaque 656" />
312
+ <ViewportFrame storyId="design-system-organisms-banner--breakpoint-sm" width={640} label="SM — viewport 640, plaque 552" />
313
+ <ViewportFrame storyId="design-system-organisms-banner--breakpoint-mobile" width={390} label="Mobile — viewport 390, plaque 358" />
314
+ <ViewportFrame storyId="design-system-organisms-banner--reflow-320" width={320} label="Reflow · 320 — WCAG 1.4.10, below every authored step" />
315
+ <ViewportFrame storyId="design-system-organisms-banner--two-line-cta-mobile" width={390} label="Two-line CTA · Mobile — a wrapped label takes --space-400 above and below" />
316
+
317
+ ### Text column padding
318
+
319
+ <table>
320
+ <thead>
321
+ <tr><th>Breakpoint</th><th>Person</th><th>Invoice</th><th>Mini</th></tr>
322
+ </thead>
323
+ <tbody>
324
+ <tr><td>XL / LG</td><td><code>--space-1100</code> (48) all round</td><td>x <code>--space-800</code> (24), y <code>--space-1100</code> (48); panel adds nothing</td><td rowSpan={2}><code>--space-900</code> (32) all round</td></tr>
325
+ <tr><td>MD</td><td><code>--space-1100</code> (48) all round</td><td rowSpan={3}>x <code>--space-800</code> (24), y <code>--space-1300</code> (80) — plus the panel's own <code>--space-1300</code> (80) above and below, so the copy starts 160 from the plaque edge</td></tr>
326
+ <tr><td>SM</td><td>x <code>--space-1000</code> (40), y <code>--space-1100</code> (48)</td><td rowSpan={2}><code>--space-800</code> (24) all round</td></tr>
327
+ <tr><td>Mobile</td><td>x <code>--space-800</code> (24), y <code>--space-1000</code> (40)</td></tr>
328
+ </tbody>
329
+ </table>
330
+
331
+ ### The visual, per composition
332
+
333
+ - **Person, stacked (MD / SM / Mobile)** — an in-flow band 324 high under the copy, bleeding past
334
+ the plaque by the gutter on both sides (`-mx-600 sm:-mx-800 md:-mx-900`), so the artwork overhangs
335
+ the plaque's sides.
336
+ - **Person, side by side (LG / XL)** — the right-hand column, stretched to the plaque height that the
337
+ text column alone sets. The artwork box starts `--space-1000` (LG) / `--space-800` (XL) inside the
338
+ text column; the invoice graphic is 356 (LG) / 328 (XL) high.
339
+ - **Person, character** — 332 wide and centred while stacked, 362 at `--space-900` from the left at
340
+ LG, 310 at 114 from the left at XL.
341
+ - **Invoice** — an **absolute** band inside the plaque, inset past it by the breakpoint's gutter
342
+ (`-inset-x-600 sm:-inset-x-800 md:-inset-x-900 lg:-inset-x-1000`), bottom flush,
343
+ `overflow-hidden`. 142 high on Mobile, 195 on SM, 215 on MD; from LG it spans the plaque and
344
+ `--space-800` above it. The sheets keep their **authored size** at every breakpoint
345
+ (`regions.visual.note`): from LG the graphic is pinned to its authored 328 and a taller plaque only
346
+ moves it down with the bottom edge — the right sheet never reaches under the text column.
347
+ - **Mini** — no visual at all.
348
+
349
+ The Person artwork is **positioned, not clipped**: the visual carries no `overflow-hidden`, and the
350
+ artwork box cuts only its bottom edge (`clip-path: inset(-100% -100% 0)` — the one primitive that
351
+ cuts a single edge). Invoice is the opposite by design: its band clips, and the sheets run past the
352
+ bottom edge into that clip — the clip is the composition (`intent.rules[3]`).
353
+
354
+ ### Authored px with no token
355
+
356
+ Every raw px in the recipe is Figma artwork or composition geometry with no spacing token, each
357
+ under its own inline `fods-lint-disable-next-line` with the reason: the character boxes (332 / 362 /
358
+ 310) and its XL offset (114), the Person visual band height (324), the Person split bases
359
+ (LG 520 / 424, XL 648 / 552), the Person invoice heights (LG 356, XL 328), the Invoice band heights
360
+ (142 / 195 / 215) and its LG / XL invoice height (328), and the 44 target floor of a Text Link in the
361
+ slot. They are written inline rather than in a shared constant because a static check of the `tv()`
362
+ literal cannot follow a reference.
363
+
364
+ ## States
365
+
366
+ **The shell has no interaction states** (`intent.states`) — no hover, active, focus, disabled or
367
+ loading of its own, and no `state` prop. Every interactive state lives on the controls in the Actions
368
+ slot — [Button](?path=/docs/design-system-atoms-button--docs),
369
+ [TextLink](?path=/docs/design-system-atoms-textlink--docs),
370
+ [TextField](?path=/docs/design-system-atoms-textfield--docs) and Subject Lookup Field; verify them
371
+ in their own stories (`delivery.storybookStates`). There is therefore no `States` story.
372
+
373
+ The one thing Banner overrides is the **focus-ring colour on `surface="solid"`** (see
374
+ Accessibility). What varies at the organism level is compositional, shown statically:
375
+
376
+ - **`detail` presence** — the Figma `Show body` toggle (Person and Invoice). In code it is the
377
+ presence of a non-blank `detail` string, not a second boolean; absent or empty renders no `<p>`.
378
+ - **`headingLevel`** — changes only the tag. The heading renders at Display/D2 (Mini D3).
379
+
380
+ <Canvas of={BannerStories.ShowBody} />
381
+ <Canvas of={BannerStories.ShowBodySolid} />
382
+ <Canvas of={BannerStories.HeadingLevelOne} />
383
+
384
+ ## API
385
+
386
+ <Controls />
387
+
388
+ ```ts
389
+ type BannerProps = BannerPersonProps | BannerInvoiceProps | BannerMiniProps;
390
+ type BannerPitchProps = BannerPersonProps | BannerInvoiceProps;
391
+
392
+ // common: surface?; heading; headingLevel; children (the Actions slot);
393
+ // actionsForm? (renders the slot as a <form> with these attributes)
394
+ // BannerPersonProps: composition?: 'person'; detail?; character: React.ReactElement;
395
+ // invoiceIllustration: BannerInvoiceIllustration
396
+ // BannerInvoiceProps: composition: 'invoice'; detail?; invoiceIllustration; character?: never
397
+ // BannerMiniProps: composition: 'mini'; detail?: undefined — Mini has no body run;
398
+ // character?: never; invoiceIllustration?: never — no visual layer
399
+
400
+ interface BannerInvoiceIllustration {
401
+ left: React.ReactElement; // pinned to the band's start edge
402
+ right: React.ReactElement; // pinned to the band's end edge
403
+ }
404
+
405
+ interface BannerActionProps {
406
+ href: string;
407
+ children: string; // the label, Button maxChars 24
408
+ icon?: IconName; // defaults to invoice-new
409
+ }
410
+ ```
411
+
412
+ `heading` and `headingLevel` are required; `surface` defaults to `brand`, `composition` to
413
+ `person`. The pictures are the app's own elements — an `<img src={…} alt="" />` of its asset: Person
414
+ (the default) requires `character` and `invoiceIllustration`, Invoice requires `invoiceIllustration`,
415
+ and the union rejects both on Mini. The sheet boxes size their picture by height and the character
416
+ box by width, so an `<img>` keeps its own ratio; for an inline SVG see
417
+ [Consuming → Assets](?path=/docs/getting-started-consuming--docs#assets).
418
+ `BannerInvoiceIllustration` is exported. `children` is required — the Actions slot. `BannerAction` reads the enclosing Banner's
419
+ composition and picks its sizes (Person / Invoice lg → xl, Mini lg); use it inside a Banner only. The
420
+ ref forwards to the `<section>`, and the usual `HTMLAttributes` land on it.
421
+
422
+ `actionsForm` takes the form's attributes (`onSubmit`, `role`, `action`, `aria-label` …). Pass it
423
+ with a field + submit pair, so Enter in the field submits — the consumer reads the field value in its
424
+ own `onSubmit`.
425
+
426
+ The Controls panel drives a flat set of story args; the `actions` arg picks a slot filling.
427
+
428
+ ## Do / Don't
429
+
430
+ - ✅ Pick `composition` from the closed set of three by how much room the pitch gets.
431
+ - ✅ Fill the Actions slot with one or two controls from its accepted set; `BannerAction` for the
432
+ default CTA.
433
+ - ✅ Keep `surface="solid"` to one Brand Button or a field with its button.
434
+ - ✅ Pick `surface` from the page family and let Banner pair the ink with it.
435
+ - ✅ Pass `headingLevel={1}` only where Banner is the page's first screen.
436
+ - ✅ Keep the heading one claim with no full stop — around 48 characters (`text.heading`); Mini one
437
+ line at XL, three at most (`text.mini-heading`).
438
+ - ✅ Turn `detail` on only where the extra line earns its space — one concrete fact, around 56
439
+ characters (`text.body`).
440
+ - ✅ Let the Person artwork overhang the plaque and the Invoice band clip — both are the composition.
441
+ - ✅ Give the page container the width ladder, the gutter and the cap; drop Banner into it at full
442
+ width.
443
+ - ❌ Don't add a Composition value to change the actions — fill the slot instead.
444
+ - ❌ Don't put two Brand buttons side by side, or a field without its submit button.
445
+ - ❌ Don't put a Secondary Button or a Text Link on the Solid plaque (1.33:1).
446
+ - ❌ Don't wrap Banner in a fixed-height box or add `overflow-hidden` to an ancestor — the frame hugs
447
+ the plaque, and a clip would crop the Person overhang.
448
+ - ❌ Don't give Banner its own max-width inside a page container — the plaque would collapse below
449
+ the content beside it.
450
+ - ❌ Don't enable `detail` on `surface="solid"` without reading the contrast exception below.
451
+ - ❌ Don't restyle the controls in the slot; their states are theirs.
452
+
453
+ ## Accessibility
454
+
455
+ **Keyboard.** The shell holds no tab stops of its own. Focus lands only on the controls in the
456
+ Actions slot, in DOM order. With a field + submit pair the slot is a `<form>` (`actionsForm`), so
457
+ **Enter in the field submits** exactly like the button (covered in `Banner.test.tsx`). Give a search
458
+ form `role: 'search'` and use **one** per page: the form is an unnamed search landmark, which is fine
459
+ alone but ambiguous next to a second one. In a Subject Lookup Field Enter belongs to the lookup — with
460
+ nothing highlighted it does nothing, so the submit button is the only way to submit.
461
+
462
+ **ARIA / semantics.**
463
+
464
+ - The root is an **unnamed** `<section>` on purpose, like Hero: a named section would add a `region`
465
+ landmark, and the heading already labels the content.
466
+ - The heading level comes from the required `headingLevel` — the page decides, Banner never does.
467
+ - The whole visual carries `aria-hidden="true"`, so the app's pictures inside it are decorative: an
468
+ `<img>` takes `alt=""` and the copy carries the message. Mini has no artwork.
469
+ - A Text Field in the slot has no visible label, and neither its decorative icon nor the placeholder
470
+ names it — it needs an `aria-label` (`gaps`, label-less Text Field). A Subject Lookup Field keeps
471
+ its own floating label.
472
+ - `BannerAction` is a real `<a href>`; a field's action is a `type="submit"` button.
473
+ - A Text Link in the slot gets a hit area at least 44 tall, in-flow, so it never overlaps the
474
+ neighbouring button (`slots.actions` TEXT LINK TARGET).
475
+
476
+ **Contrast.**
477
+
478
+ - **Focus ring on Solid is Banner's job.** `--outline-focus` is the same hex as `--secondary-solid`,
479
+ so the default ring measures 1.00:1 on that plaque (`intent.rules[5]`). On `surface="solid"` the
480
+ `actions` slot swaps the ring of **every** control in it: buttons and links keep their own outline
481
+ geometry and take `--outline-focus-inverse`; a field — whose own focus is a border swap to
482
+ `--outline-focus`, invisible on the plaque — gets an `--outline-focus-inverse` ring outside its
483
+ shell with Button's width and 2px offset. The container owns the swap; the atoms are unchanged.
484
+ `surface="brand"` keeps every control's own default focus. Asserted in `Banner.test.tsx`.
485
+ - **Accepted exception — the detail line on Solid.** Body/XL is 20px Regular, which is not WCAG large
486
+ text, and `--text-inverted` on `--secondary-solid` measures **4.45:1** against the 4.5:1 floor
487
+ (`gaps[0]`). It stands as a scoped brand exception because `detail` is off by default and Mini has
488
+ none; passing `detail` on a Solid banner ships that known run.
489
+ - **Accepted exception — the placeholder of a label-less Text Field.** `--text-placeholder` at
490
+ 2.71:1 stands because the placeholder is a non-load-bearing example; it does not replace the
491
+ `aria-label`.
492
+ - **Inherited exception — the Brand button label.** White on `--primary-solid` measures **2.37:1**
493
+ (hover 3.17:1), below AA and AA-Large. The exception belongs to the token and the Button, not to
494
+ Banner.
495
+ - The heading is bold Display/D2 (Mini D3) at every breakpoint and is unaffected by any exception.
496
+
497
+ **Reflow (1.4.10).** Banner assumes the page container's gutter (16 / 24 / 32 / 40 / 40): the Person
498
+ visual and the Invoice band bleed past the plaque by exactly that gutter. At 320 (and at every Mobile
499
+ width) the `lg` action label wraps to at most two lines and the button grows instead of overflowing
500
+ the fill or losing its last word, and the character scales down to the band instead of scrolling the
501
+ page sideways. See the `Reflow · 320` story.
502
+
503
+ **Motion.** Static (`motion.none`): nothing in Banner animates or transitions. Hover / press motion is
504
+ the slotted controls' own (`motion.inherits`: button, text-link, text-field, subject-lookup-field).
505
+ The scroll-linked parallax on the paper graphic is a **planned** manifest backlog item and
506
+ is not built into Banner.
507
+
508
+ **Windows High Contrast.** Buttons and links keep a visible outline ring in forced colours. A
509
+ field's border swap is overridden there, so on Brand its focus shows only the caret — a TextField
510
+ issue, tracked separately. On Solid the slot's outline ring stays visible.
511
+
512
+ Full checklist: `spec/01-foundations/accessibility.md`.
513
+
514
+ ## Copy
515
+
516
+ Voice: the product tone — impersonal, plain, no exclamation. This section covers only the runs
517
+ Banner owns, the heading and the optional detail line; copy for the controls in the Actions slot is
518
+ canonical in their own pages ([Button](?path=/docs/design-system-atoms-button--docs) for action
519
+ labels, [TextLink](?path=/docs/design-system-atoms-textlink--docs) for link labels,
520
+ [TextField](?path=/docs/design-system-atoms-textfield--docs) for placeholders).
521
+
522
+ - **Heading** (Person, Invoice; `heading`) — one claim, no second sentence, no full stop. Wraps,
523
+ never truncates; at most 48 characters, 2 lines in the manifest. The canonical CZ string fills two
524
+ lines where the copy measure is widest and three at LG and Mobile; a longer market string grows the
525
+ plaque rather than truncating.
526
+ - **Heading** (Mini; `heading`) — one short claim, no full stop, same voice rules. Wraps, never
527
+ truncates; at most 48 characters and 3 lines: one line beside the button at XL, two at LG, three
528
+ at MD (the narrowest row, shared with the button), two at SM and Mobile above it.
529
+ - **Body** (the detail line; `detail`) — one concrete detail that earns the click, never a second
530
+ claim: it states a fact and stops. Wraps; at most 56 characters and 2 lines. Person and Invoice
531
+ only, off unless `detail` is passed; Mini has none. Read the Accessibility note on
532
+ `surface="solid"` before turning it on there.
533
+ - **Action label** (Button in the slot) — Button's 24-character limit still applies. One override
534
+ of Button's mechanics: at Mobile a full-width button's label wraps to two lines rather than
535
+ truncating, so a long market string costs a taller button, never its last word.
536
+
537
+ <table>
538
+ <thead>
539
+ <tr><th>Run</th><th>Write</th><th>✅</th><th>❌</th></tr>
540
+ </thead>
541
+ <tbody>
542
+ <tr><td>Heading (Person, Invoice)</td><td>one claim, no second sentence, no full stop</td><td><code>S námi zvládne fakturovat úplně každý</code></td><td><code>Fakturujte snadno. Vyzkoušejte to ještě dnes!</code></td></tr>
543
+ <tr><td>Heading (Mini)</td><td>one short claim, no full stop</td><td><code>Použijte šablonu pro rychlé vytvoření faktury</code></td><td><code>Chcete fakturovat rychleji? Máme pro vás šablonu.</code></td></tr>
544
+ <tr><td>Body (detail line)</td><td>one concrete detail that earns the click, never a second claim; states a fact and stops</td><td><code>První fakturu vystavíte do 30 vteřin.</code></td><td><code>Ušetříte čas i nervy a zamilujete si každou fakturu.</code></td></tr>
545
+ </tbody>
546
+ </table>
547
+
548
+ ## Usage
549
+
550
+ ```tsx
551
+ import { Banner, BannerAction, type BannerInvoiceIllustration } from '@invoiceonline/ui-react';
552
+ // The app's own copies of the artwork.
553
+ import bartender from './assets/banner-character.webp';
554
+ import sheetLeft from './assets/banner-invoice-sheet-left.webp';
555
+ import sheetRight from './assets/banner-invoice-sheet-right.webp';
556
+
557
+ const character = <img src={bartender} alt="" />;
558
+ const invoiceIllustration: BannerInvoiceIllustration = {
559
+ left: <img src={sheetLeft} alt="" />,
560
+ right: <img src={sheetRight} alt="" />,
561
+ };
562
+
563
+ // Good — the default Person, mid-page, one Brand action.
564
+ <Banner heading="S námi zvládne fakturovat úplně každý" headingLevel={2} character={character} invoiceIllustration={invoiceIllustration}>
565
+ <BannerAction href="#">Vystavit fakturu</BannerAction>
566
+ </Banner>
567
+ ```
568
+
569
+ ```tsx
570
+ // Good — Invoice on the Solid plaque: the sheets, no character.
571
+ <Banner composition="invoice" surface="solid" heading="S námi zvládne fakturovat úplně každý" headingLevel={2} invoiceIllustration={invoiceIllustration}>
572
+ <BannerAction href="#">Vystavit fakturu</BannerAction>
573
+ </Banner>
574
+ ```
575
+
576
+ ```tsx
577
+ // Good — Mini inside an article, one level below the current section heading.
578
+ <Banner composition="mini" heading="Použijte šablonu pro rychlé vytvoření faktury" headingLevel={3}>
579
+ <BannerAction href="#">Vystavit fakturu</BannerAction>
580
+ </Banner>
581
+ ```
582
+
583
+ ```tsx
584
+ // Good — Person with a field + its submit button: named field, Enter submits.
585
+ const inputRef = useRef<HTMLInputElement>(null);
586
+
587
+ <Banner
588
+ heading="S námi zvládne fakturovat úplně každý"
589
+ headingLevel={2}
590
+ character={character}
591
+ invoiceIllustration={invoiceIllustration}
592
+ actionsForm={{
593
+ role: 'search',
594
+ onSubmit: (event) => {
595
+ event.preventDefault();
596
+ search(inputRef.current?.value ?? '');
597
+ },
598
+ }}
599
+ >
600
+ <TextField ref={inputRef} size="md" type="search" leadingIcon="magnifying-glass" aria-label="IČO nebo název firmy" />
601
+ <Button type="submit" variant="brand" size="lg" leadingIcon={<Icon name="magnifying-glass" />}>Vyhledat</Button>
602
+ </Banner>
603
+ ```
604
+
605
+ ```tsx
606
+ // Don't — no headingLevel, no Actions slot, a detail line on Mini: none of them typechecks.
607
+ <Banner heading="…">…</Banner>
608
+ <Banner heading="…" headingLevel={2} />
609
+ <Banner composition="mini" heading="…" headingLevel={3} detail="…">…</Banner>
610
+
611
+ // Don't — Person without its pictures, or a picture on Mini: none of them typechecks either.
612
+ <Banner heading="…" headingLevel={2}>…</Banner>
613
+ <Banner composition="mini" heading="…" headingLevel={3} character={character}>…</Banner>
614
+
615
+ // Don't — a Text Link on the Solid plaque (1.33:1), or a field without its submit button.
616
+ <Banner surface="solid" heading="…" headingLevel={2} character={character} invoiceIllustration={invoiceIllustration}>
617
+ <BannerAction href="#">Vystavit fakturu</BannerAction>
618
+ <TextLink href="#">Zjistit více o fakturaci</TextLink>
619
+ </Banner>
620
+ ```
621
+
622
+ ## Related
623
+
624
+ - [Hero](?path=/docs/design-system-organisms-hero--docs) — the first-screen shell. Anything outside
625
+ Banner's three recipes belongs there.
626
+ - [PromoSurface](?path=/docs/design-system-atoms-promosurface--docs) — the plaque's fill, pattern and
627
+ veil; Banner chooses only its `layout` and `surface`.
628
+ - [Button](?path=/docs/design-system-atoms-button--docs),
629
+ [TextLink](?path=/docs/design-system-atoms-textlink--docs),
630
+ [TextField](?path=/docs/design-system-atoms-textfield--docs) — the controls the Actions slot
631
+ accepts, with every interaction state.
632
+ - [Heading](?path=/docs/design-system-atoms-heading--docs) — the heading atom, rendered at `d2` (Mini
633
+ `d3`).
634
+ - `spec/07-web/banner.md`
635
+ — upstream design spec; `spec/07-web/_README.md`
636
+ — the Web page frame and block rhythm.
637
+ - `spec/06-patterns/focus-ring.md`
638
+ — the container-owns-the-swap rule behind the Solid ring override.
639
+
640
+ ## Migration notes
641
+
642
+ ### 1.x → 2.0.0 (MAJOR, the first step of `delivery.migration`)
643
+
644
+ The fixed `primary-action` / `search-field` / `search-action` slots are gone; the actions are one
645
+ slot, passed as `children`.
646
+
647
+ <table>
648
+ <thead>
649
+ <tr><th>1.x</th><th>2.x</th></tr>
650
+ </thead>
651
+ <tbody>
652
+ <tr><td><code>composition="person-cta"</code> + <code>actionLabel</code> / <code>actionHref</code></td><td><code>composition="person"</code> (default) + <code>&lt;BannerAction href&gt;label&lt;/BannerAction&gt;</code></td></tr>
653
+ <tr><td><code>composition="invoice-cta"</code> + <code>actionLabel</code> / <code>actionHref</code></td><td><code>composition="invoice"</code> + <code>&lt;BannerAction href&gt;label&lt;/BannerAction&gt;</code></td></tr>
654
+ <tr><td><code>composition="person-search"</code> + <code>searchAriaLabel</code> / <code>searchPlaceholder</code> / <code>searchActionLabel</code> / <code>onSearch</code> / <code>defaultSearchValue</code></td><td><code>composition="person"</code> + <code>actionsForm</code> + <code>&lt;TextField aria-label …&gt;</code> and <code>&lt;Button type="submit"&gt;</code> as children; the consumer reads the value in <code>onSubmit</code></td></tr>
655
+ <tr><td>A separate heading-and-action strip, Blue / Light</td><td><code>composition="mini"</code>, <code>surface="solid"</code> / <code>"brand"</code> — not migrated yet (see below)</td></tr>
656
+ <tr><td><code>data-fods-part="primary-action"</code></td><td><code>data-fods-part="action"</code> (on <code>BannerAction</code>)</td></tr>
657
+ <tr><td><code>data-fods-part="search-field"</code> wrapper</td><td>none — the field is a direct child of <code>actions</code>; Banner's Solid ring targets the field shell</td></tr>
658
+ </tbody>
659
+ </table>
660
+
661
+ Not migrated: a separate heading-and-action strip — the manifest maps it to Mini, but it does not
662
+ consume Banner.
663
+
664
+ ### 2.1.0 — the Web block frame
665
+
666
+ The outer frame is the Web block frame, not the viewport; the plaque fills the block content
667
+ (1190 / 880 / 656 / 552 / 358, was 1200 / 944 / 704 / 592 / 358). Code: the `<section>` now carries
668
+ `--space-800` above and below (it used to be bare). Consumers that wrapped Banner in their own
669
+ vertical padding subtract it (`pt-[calc(var(--space-1100)_-_var(--space-800))]` and the MD
670
+ counterpart; the same for `py`), so the gap between blocks stays 1100 / 1300.
671
+
672
+ ### 2.2.0 — the app supplies the artwork
673
+
674
+ `delivery.react`: the illustration is a React element the consumer supplies; the
675
+ component ships no picture and owns only its box. Code: the artwork was a CSS background the
676
+ composition picked; now Person takes `character` and `invoiceIllustration` `{ left, right }`
677
+ (type `BannerInvoiceIllustration`), Invoice takes `invoiceIllustration`, Mini neither. The parts
678
+ `character`, `invoice-sheet-left` and `invoice-sheet-right` are `<div>` boxes holding the element
679
+ instead of empty `<span>`s. Every Person and Invoice banner adds the props with the app's own
680
+ copies of the pictures (see Usage).
681
+
682
+ ### 3.0.0 — the same change, recorded as a major
683
+
684
+ The manifest now records the artwork change of 2.2.0 as a major: it breaks the implementation already built against 1.x in the existing Storybook, and `delivery.migration` (now 1.x → 3.0.0) lists the steps. The code here already takes the elements; nothing else changes.
685
+
686
+ ### Known deviations and open questions
687
+
688
+ - **Person alignment below LG.** The manifest says centred at MD / SM / Mobile; it records this as
689
+ an open question (`gaps`). Code follows the manifest.
690
+ - **Person split at the 2.1.0 plaque widths.** The authored bases (648 / 552, 520 / 424) were
691
+ measured at the 1.x plaque (1200 / 944). 2.1.0 narrowed the plaque without restating them; the
692
+ bases shrink proportionally.
693
+ - **Artwork geometry.** Band heights are structured in `regions.visual`; column splits, character
694
+ boxes and invoice heights are authored geometry and ship as raw px under fods-lint suppressions.
695
+ - **Mini reads flat; Mini copy uses two verbs** (`gaps`, both deferred).
696
+
697
+ ### Open upstream gaps (manifest `gaps`, deferred)
698
+
699
+ - **One tone token for the Solid ink.** Banner binds `--text-inverted` where PromoSurface's pairing
700
+ table names `--secondary-foreground`; both resolve to white. The rebind is a planned backlog item.
701
+ - **No Button size matches TextField `md`'s 48.** Banner stretches a submit button beside a field to
702
+ the field height — a per-consumer workaround for a ladder gap.
703
+ - **Subject Lookup bottom sheet below SM** is not fully specified upstream; Banner adds no behaviour
704
+ of its own.