@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,343 @@
1
+ "use client";
2
+ import * as React from 'react';
3
+ import { tv } from '../../internal/tailwind-variants';
4
+ import { Icon } from '../icon/Icon';
5
+ import { useIsMobile } from '../../internal/useIsMobile';
6
+ import { Button } from '../button/Button';
7
+ import { paginationItemVariants, type PaginationItemState } from '../../internal/paginationItem';
8
+ import { cn } from '../../internal/utils';
9
+
10
+ /**
11
+ * Pagination — the paging footer under a Table or any long, page-broken list
12
+ * (spec 04-molecules/pagination.md, manifest pagination.manifest.json 1.3.1;
13
+ * cell manifest _pagination-item.manifest.json 1.3.3).
14
+ *
15
+ * `[Previous] numbers [Next]`, one 32px-high row. The manifest is
16
+ * `kind: "composite"` with empty `parts` and empty `families` — Pagination owns
17
+ * NO colour of its own. Every visual fact is inherited:
18
+ * - each number / ellipsis cell from `internal/paginationItem.ts`
19
+ * - Previous / Next from the hosted `Button` (Tertiary, S) — manifest `slots`
20
+ * The single token this component binds itself is the row gap,
21
+ * `composition.container.gap` = `--space-400` (8px).
22
+ *
23
+ * The four Figma variants (Default · First page · Last page · Many pages) are
24
+ * authored SNAPSHOTS of runtime situations, not a parametrized variant set the
25
+ * consumer configures — Figma carries them as a `Type` property, the code does not
26
+ * expose one. The real axis is runtime state, computed from `currentPage` /
27
+ * `totalPages` / `siblingCount`.
28
+ *
29
+ * ─── Deviations from the manifest, both approved ──────────────────────────────
30
+ *
31
+ * 1. MOBILE PREVIOUS / NEXT ARE ICON-ONLY. The manifest gives both triggers a
32
+ * fixed text label (`text.prev-label` / `next-label`) and § Do / Don't
33
+ * explicitly forbids swapping them for icon-only buttons. Below `sm` the row
34
+ * would not fit next to the number run, so the label is hidden with
35
+ * `max-sm:sr-only` — never `sr-only sm:not-sr-only`: a host page may ship an
36
+ * unlayered global `.sr-only` that beats Tailwind's
37
+ * layered `sm:not-sr-only` and hides the label on desktop. This is a CSS hide, not a conditional render: the
38
+ * accessible name stays in the DOM at every width, so the "text label is part
39
+ * of the a11y contract" half of the rule still holds and there is no
40
+ * viewport-dependent markup to mismatch on hydration. The button also drops to
41
+ * symmetric `px-300` there, which lands it at exactly 32×32 (6 + 20px glyph + 6)
42
+ * instead of inheriting Button's optical `pl-400 pr-500` around a hidden label.
43
+ *
44
+ * 2. A PAGE CELL BECOMES AN ANCHOR WHEN `pageHref` IS GIVEN. Spec § Accessibility
45
+ * says every page number is a real `<button>`. Without a crawlable `href` the
46
+ * blog's pages 2+ are unreachable and their articles end up orphaned, so the
47
+ * consumer may hand in a URL builder; the cell then renders `<a href>` with the
48
+ * same `aria-label` / `aria-current` and intercepts plain left-clicks for SPA
49
+ * navigation. Modified clicks (new tab, etc.) fall through to the browser.
50
+ *
51
+ * ─── Two rules that are NOT deviations, and must not drift ────────────────────
52
+ *
53
+ * The row carries no border, no divider and no `overflow-hidden`: the cells are
54
+ * NOT fused into one clipped strip the way Button Group's segments are
55
+ * (`composition.builtFrom.note`), and clipping would additionally swallow every
56
+ * cell's OUTWARD offset focus ring.
57
+ *
58
+ * Nothing renders at `totalPages <= 1` — the whole component is absent, never a
59
+ * lone fully-disabled single-page bar (spec § States). Previous / Next go
60
+ * `disabled` at the ends instead of disappearing, so the row's width and tab
61
+ * order stay stable across pages.
62
+ *
63
+ * Ellipsis is inert: no button, no tab stop, no hover, `aria-hidden` glyph plus
64
+ * visually-hidden copy so a screen-reader user gets an equivalent of the skipped
65
+ * run instead of silence.
66
+ */
67
+ const paginationVariants = tv({
68
+ slots: {
69
+ // The landmark row. `composition.container.gap` — the one token Pagination
70
+ // owns. `flex-wrap` is a safety net for a very long run at a narrow width;
71
+ // it is not a manifest fact.
72
+ nav: 'flex flex-wrap items-center justify-center gap-400',
73
+ // Previous / Next. Only the mobile padding correction lives here — the ink,
74
+ // height and radius are Button's own contract (see deviation 1).
75
+ trigger: 'max-sm:px-300',
76
+ },
77
+ });
78
+
79
+ export interface PaginationLabels {
80
+ /**
81
+ * Names the landmark itself — `<nav aria-label>`. Spec § Copy: "Stránkování",
82
+ * matching the pattern other landmark labels use, never a generic "Navigace".
83
+ */
84
+ nav: string;
85
+ /**
86
+ * Fixed nav labels (manifest `text.prev-label` / `next-label`) — always the
87
+ * market's direct equivalent of "Předchozí" / "Další", never a per-screen
88
+ * synonym. `Zpět` / `Vpřed` would break consistency with every other paged
89
+ * list in the product.
90
+ */
91
+ previous: string;
92
+ next: string;
93
+ /**
94
+ * Accessible name PREFIX for a page cell, composed with the number:
95
+ * `"Stránka"` → `aria-label="Stránka 3"`, as `_pagination-item` 1.3.2 `delivery.react`
96
+ * and pagination.md § Accessibility spell it (owner ruling 2026-10-20).
97
+ */
98
+ page: string;
99
+ /** Visually-hidden equivalent of a collapsed run, e.g. "Další stránky". */
100
+ morePages: string;
101
+ }
102
+
103
+ export interface PaginationProps
104
+ extends Omit<React.HTMLAttributes<HTMLElement>, 'children'> {
105
+ /** The active page, 1-based. Drives which cell renders Current. */
106
+ currentPage: number;
107
+ /** Total page count. At `<= 1` the component renders nothing. */
108
+ totalPages: number;
109
+ onPageChange: (page: number) => void;
110
+ /**
111
+ * Optional URL builder. Present → cells render as crawlable anchors
112
+ * (see deviation 2); absent → plain buttons per spec.
113
+ */
114
+ pageHref?: (page: number) => string;
115
+ /**
116
+ * Neighbours of `currentPage` kept visible on each side before collapsing to
117
+ * an ellipsis (manifest `properties[2]`, default 1 — the shape the Many pages
118
+ * Figma example demonstrates). Forced to 0 below `sm`, where a five-cell run
119
+ * plus both triggers does not fit: the row degrades to `1 … 6 … 12`.
120
+ */
121
+ siblingCount?: number;
122
+ /**
123
+ * Copy override. OPTIONAL — every string falls back to the component's own
124
+ * Czech default, so the common case passes nothing at all.
125
+ * Override a single key when a screen (or a non-Czech market) needs different
126
+ * wording; the rest keep their defaults. The defaults are Czech; an app with more
127
+ * language versions passes them from its translations.
128
+ */
129
+ labels?: Partial<PaginationLabels>;
130
+ }
131
+
132
+ /** Inclusive integer range. */
133
+ const range = (start: number, end: number): number[] =>
134
+ Array.from({ length: end - start + 1 }, (_, i) => start + i);
135
+
136
+ const ELLIPSIS = 'ellipsis' as const;
137
+ type PageSlot = number | typeof ELLIPSIS;
138
+
139
+ /**
140
+ * The collapse rule (spec § Variants, manifest `intent.whenToUse`): show every
141
+ * number while the run is short; once it would crowd the row, keep the first
142
+ * page, the last page and `currentPage`'s immediate neighbours, and collapse
143
+ * everything else into ONE ellipsis per side.
144
+ *
145
+ * `1 + 1 + 1 + 2 * siblingCount + 2` = first + last + current + neighbours + the
146
+ * two ellipsis slots, i.e. 7 cells at the default `siblingCount` — which is also
147
+ * where "roughly 7+ pages" in the manifest comes from.
148
+ *
149
+ * The two edge branches deliberately render `3 + 2 * siblingCount` numbers
150
+ * instead of just current's neighbours, so the run keeps the same cell count on
151
+ * page 1 as it has in the middle and the row does not visibly shrink while
152
+ * paging. Reference sequence, `siblingCount=1`, page 6 of 12 (the Many pages
153
+ * example): `1 … 5 [6] 7 … 12`.
154
+ */
155
+ export function paginationRange(
156
+ currentPage: number,
157
+ totalPages: number,
158
+ siblingCount: number,
159
+ ): PageSlot[] {
160
+ const maxCells = 2 * siblingCount + 5;
161
+ if (totalPages <= maxCells) return range(1, totalPages);
162
+
163
+ const leftSibling = Math.max(currentPage - siblingCount, 1);
164
+ const rightSibling = Math.min(currentPage + siblingCount, totalPages);
165
+ const showLeftEllipsis = leftSibling > 2;
166
+ const showRightEllipsis = rightSibling < totalPages - 1;
167
+ const edgeCount = 3 + 2 * siblingCount;
168
+
169
+ if (!showLeftEllipsis && showRightEllipsis) {
170
+ return [...range(1, edgeCount), ELLIPSIS, totalPages];
171
+ }
172
+ if (showLeftEllipsis && !showRightEllipsis) {
173
+ return [1, ELLIPSIS, ...range(totalPages - edgeCount + 1, totalPages)];
174
+ }
175
+ return [1, ELLIPSIS, ...range(leftSibling, rightSibling), ELLIPSIS, totalPages];
176
+ }
177
+
178
+ const Pagination = React.forwardRef<HTMLElement, PaginationProps>(
179
+ (
180
+ {
181
+ className,
182
+ currentPage,
183
+ totalPages,
184
+ onPageChange,
185
+ pageHref,
186
+ siblingCount = 1,
187
+ labels,
188
+ ...props
189
+ },
190
+ ref,
191
+ ) => {
192
+ const slots = paginationVariants();
193
+ // A VIEWPORT measure, read synchronously on the first render (the hook is
194
+ // built on useSyncExternalStore precisely so it does not flash or fight
195
+ // hydration). Called before the early return below — rules of hooks.
196
+ const isMobile = useIsMobile('sm');
197
+
198
+ /**
199
+ * Every string falls back to its Czech default unless the consumer overrode it.
200
+ *
201
+ * `||` and not `??` on purpose. An empty
202
+ * accessible name is never intentional — it would leave `aria-label=" 3"` on
203
+ * a page cell and trip the a11y floor — so an empty override falls back too.
204
+ */
205
+ const copy: PaginationLabels = {
206
+ nav: labels?.nav || 'Stránkování',
207
+ previous: labels?.previous || 'Předchozí',
208
+ next: labels?.next || 'Další',
209
+ page: labels?.page || 'Stránka',
210
+ morePages: labels?.morePages || 'Další stránky',
211
+ };
212
+
213
+ // Never a disabled single-page bar (spec § States) — so a call site does not
214
+ // have to gate on the page count itself.
215
+ if (totalPages <= 1) return null;
216
+
217
+ // Below `sm` the run collapses to first · current · last (`1 … 6 … 12`): five
218
+ // cells plus two triggers do not fit at 375px. This is the one place the
219
+ // component overrides the consumer's `siblingCount`, and it overrides DOWN
220
+ // only — a narrow viewport can never grow the run.
221
+ const effectiveSiblingCount = isMobile ? 0 : siblingCount;
222
+ const slotsToRender = paginationRange(currentPage, totalPages, effectiveSiblingCount);
223
+
224
+ // Plain left-clicks drive SPA navigation; a modified click (new tab, middle
225
+ // button) is left to the browser so the crawlable href stays useful to humans.
226
+ const handleAnchorClick = (page: number) => (event: React.MouseEvent<HTMLAnchorElement>) => {
227
+ if (
228
+ event.defaultPrevented
229
+ || event.button !== 0
230
+ || event.metaKey
231
+ || event.ctrlKey
232
+ || event.shiftKey
233
+ || event.altKey
234
+ ) return;
235
+ event.preventDefault();
236
+ onPageChange(page);
237
+ };
238
+
239
+ const renderPage = (page: number) => {
240
+ const isCurrent = page === currentPage;
241
+ const state: PaginationItemState = isCurrent ? 'current' : 'default';
242
+ const cellClass = paginationItemVariants({ state });
243
+ const label = `${copy.page} ${page}`;
244
+ const href = pageHref?.(page);
245
+
246
+ // `data-page-state` is published for the same reason DatePicker publishes
247
+ // `data-day-state`: the state is computed here and nothing outside could
248
+ // otherwise select a cell by what it shows. It is what lets CSS, tests and
249
+ // the FODS probe tell a Current cell from a Default one in a row that
250
+ // renders both at once — `aria-current` can express "is current" but not
251
+ // "is NOT current".
252
+ if (href) {
253
+ return (
254
+ <a
255
+ key={page}
256
+ href={href}
257
+ onClick={handleAnchorClick(page)}
258
+ aria-label={label}
259
+ aria-current={isCurrent ? 'page' : undefined}
260
+ data-fods-part="item"
261
+ data-page-state={state}
262
+ className={cellClass}
263
+ >
264
+ {page}
265
+ </a>
266
+ );
267
+ }
268
+
269
+ return (
270
+ <button
271
+ key={page}
272
+ type="button"
273
+ onClick={() => onPageChange(page)}
274
+ aria-label={label}
275
+ aria-current={isCurrent ? 'page' : undefined}
276
+ data-fods-part="item"
277
+ data-page-state={state}
278
+ className={cellClass}
279
+ >
280
+ {page}
281
+ </button>
282
+ );
283
+ };
284
+
285
+ return (
286
+ <nav
287
+ ref={ref}
288
+ data-fods-component="pagination"
289
+ data-fods-part="container"
290
+ {...props}
291
+ aria-label={copy.nav}
292
+ className={cn(slots.nav(), className)}
293
+ >
294
+ <Button
295
+ variant="tertiary"
296
+ size="sm"
297
+ leadingIcon={<Icon name="caret-left-small" />}
298
+ disabled={currentPage <= 1}
299
+ onClick={() => onPageChange(currentPage - 1)}
300
+ // Overrides Button's own `root` marker: inside this row the trigger is
301
+ // the `prev` slot the pagination manifest describes.
302
+ data-fods-part="prev"
303
+ className={slots.trigger()}
304
+ >
305
+ <span className="max-sm:sr-only">{copy.previous}</span>
306
+ </Button>
307
+
308
+ {slotsToRender.map((slot, index) => (
309
+ slot === ELLIPSIS
310
+ ? (
311
+ <span
312
+ // Two ellipses can appear in one row; the index disambiguates the
313
+ // left one from the right one.
314
+ key={`ellipsis-${index}`}
315
+ data-fods-part="item"
316
+ data-page-state="ellipsis"
317
+ className={paginationItemVariants({ state: 'ellipsis' })}
318
+ >
319
+ <span aria-hidden="true">…</span>
320
+ <span className="sr-only">{copy.morePages}</span>
321
+ </span>
322
+ )
323
+ : renderPage(slot)
324
+ ))}
325
+
326
+ <Button
327
+ variant="tertiary"
328
+ size="sm"
329
+ trailingIcon={<Icon name="caret-right-small" />}
330
+ disabled={currentPage >= totalPages}
331
+ onClick={() => onPageChange(currentPage + 1)}
332
+ data-fods-part="next"
333
+ className={slots.trigger()}
334
+ >
335
+ <span className="max-sm:sr-only">{copy.next}</span>
336
+ </Button>
337
+ </nav>
338
+ );
339
+ },
340
+ );
341
+ Pagination.displayName = 'Pagination';
342
+
343
+ export { Pagination, paginationVariants };
@@ -0,0 +1,8 @@
1
+ export {
2
+ Pagination,
3
+ paginationVariants,
4
+ paginationRange,
5
+ type PaginationProps,
6
+ type PaginationLabels,
7
+ } from './Pagination';
8
+ export { paginationItemVariants, type PaginationItemState } from '../../internal/paginationItem';
@@ -0,0 +1,158 @@
1
+ import { Meta, Canvas } from '@storybook/addon-docs/blocks';
2
+ import * as PopoverSurfaceStories from './PopoverSurface.stories';
3
+
4
+ <Meta of={PopoverSurfaceStories} tags={['autodocs']} />
5
+
6
+ # Popover Surface
7
+
8
+ ## Metadata
9
+
10
+ - **Layer:** pattern (chrome recipe — **not a component**)
11
+ - **Status:** recipe (retired as an atom 2026-07-01)
12
+ - **Tokens used:** `--bg-primary`, `--border-width-100`, `--font-size-sm`, `--font-weight-semibold`, `--leading-loose`, `--outline-default`, `--radius-500`, `--shadow-overlay`, `--space-100`, `--space-200`, `--space-400`, `--space-600`, `--space-800`, `--text-primary`, `--text-secondary`, `--z-index-dropdown`
13
+
14
+ ## Overview
15
+
16
+ The **Popover surface** is the shared **chrome recipe** every floating dropdown surface applies for itself —
17
+ `Select.Content`, the `Combobox` popup, `Menu`, `Popover`, a multi-select filter, an action menu. It is
18
+ deliberately **NOT a component**: there is no `<PopoverSurface>` wrapper, no Figma component, no slots, and no
19
+ molecule. Instead there is **one shared base style** — [`popoverSurfaceVariants`](?path=/story/design-system-patterns-popover-surface--full-panel) —
20
+ that each `*.Content` extends, and the panel body is composed by dropping real
21
+ [`ListRow`](?path=/docs/design-system-atoms-listrow--docs) + [`Divider`](?path=/docs/design-system-atoms-divider--docs)
22
+ atoms straight in.
23
+
24
+ Why a recipe and not a component: a single token-bound chrome is what prevents drift
25
+ (hardcoded hex values, two menu skins, mismatched sizes). One chrome for **all**
26
+ dropdowns; the **role + keyboard contract come from the organism**, never from the surface.
27
+
28
+ ## Chrome contract
29
+
30
+ Every dropdown surface **MUST** bind exactly (via `popoverSurfaceVariants`):
31
+
32
+ <table>
33
+ <thead>
34
+ <tr><th>Property</th><th>Token</th><th>Tailwind</th></tr>
35
+ </thead>
36
+ <tbody>
37
+ <tr><td>background</td><td><code>--bg-primary</code></td><td><code>bg-background-primary</code></td></tr>
38
+ <tr><td>border</td><td>1px <code>--outline-default</code></td><td><code>border border-outline-default</code></td></tr>
39
+ <tr><td>border-radius</td><td><code>--radius-500</code> (12)</td><td><code>rounded-500</code></td></tr>
40
+ <tr><td>box-shadow</td><td><code>--shadow-overlay</code></td><td><code>shadow-overlay</code></td></tr>
41
+ <tr><td>z-index</td><td><code>--z-index-dropdown</code></td><td><code>z-dropdown</code></td></tr>
42
+ <tr><td>padding</td><td><strong>symmetric</strong> Y, 0 X — flat <code>--space-200</code> (4), Medium and Small alike</td><td><code>py-200</code>, <code>px-0</code></td></tr>
43
+ </tbody>
44
+ </table>
45
+
46
+ **MUST NOT** — hardcode any hex / px; ship a second surface skin; re-derive the chrome per component; or add
47
+ slots / a wrapper molecule. One base style, every `*.Content` extends it.
48
+
49
+ ## Anatomy
50
+
51
+ <Canvas of={PopoverSurfaceStories.FullPanel} />
52
+
53
+ Top to bottom, a filled panel is:
54
+
55
+ 1. **Header** — optional, **sticky OUTSIDE the scroll body**. A frame (title, or title + a
56
+ [`TextLink`](?path=/docs/design-system-atoms-textlink--docs)),
57
+ padding 16 / 8 (`px-600 py-400`) so the title lands on the row content column. Carries a **plain bottom
58
+ `Divider`** (full-bleed). Omit for a bare menu.
59
+ 2. **Body** — required, the **scroll region**, `0` horizontal padding. Holds **groups** interleaved with
60
+ **`Divider` siblings**, on a uniform `--space-200` (4) rhythm. Scrolls past a soft ~8–10-row cap.
61
+ 3. **Group** — rows wrapped in a transparent container with a **4px (`--space-200`) horizontal inset** (holds
62
+ the highlight off the border) and **no vertical padding** — rows are flush. A composition recipe, not a
63
+ component (the drafted `OptionGroup` molecule was retired 2026-07-15).
64
+ 4. **Divider** — placed **between groups** as a **sibling at `0` inset** → full-bleed, edge-to-edge. A plain
65
+ `line` is a peer section break; a **`line-label`** (e.g. "Agendy" above) titles the section that follows.
66
+ 5. **Footer** — optional, sticky, mirror of the header (padding 16 / 8, plain **top** `Divider`).
67
+
68
+ > **A chrome `TextLink` is never a `ListRow`.** A body row lands on the 16px content column as `4 + 12`
69
+ > (group inset + row padding) at min-height 40 with a hover wash; a header / footer frame reaches the same 16
70
+ > via `padL` directly, at `padY 8`. Dropping a row into the chrome breaks that column and adds a wash the frame
71
+ > must not have. `ListRow`'s `link` variant belongs in the **body** (e.g. "Přidat agendu" above) — and per
72
+ > `popover-patterns.md`
73
+ > § Account menu it should *host* a `TextLink` rather than restyle one.
74
+ >
75
+ > The chrome links above are real [`TextLink`](?path=/docs/design-system-atoms-textlink--docs) atoms —
76
+ > `variant="strong"` (the weight a standalone action link takes), `size="sm"` on both densities, and the default
77
+ > `underline="on"` (mandatory whenever no icon sits beside the label — WCAG 1.4.1). "Spravovat tarif" navigates,
78
+ > so it carries an `href` and renders an `<a>`; "Odhlásit se" is an in-page action and renders a `<button>` —
79
+ > *"never a bare clickable `<span>`"*. **Never hand-style a chrome link**; the ink, the weight and the focus
80
+ > ring are all the atom's.
81
+ >
82
+ > A **body row** is different: `ListRow`'s `link` variant renders its label as styled text with Text Link's
83
+ > Strong ink and underline, not a nested `TextLink`. A nested `<a>` inside a `menuitem` / `option` row would put
84
+ > an interactive element inside an interactive element (`list-row.manifest.json` `notes`).
85
+
86
+ > **One density per panel.** Every `ListRow`, header, and footer uses one size, **one step below the trigger**
87
+ > that opened it: trigger Medium 48 → rows Medium 40; trigger Small 40 → rows Small 36. Never mix.
88
+
89
+ ## Bare menu
90
+
91
+ The simplest composition — a single group, no header / footer frames. The chrome is identical.
92
+
93
+ <Canvas of={PopoverSurfaceStories.BareMenu} />
94
+
95
+ ## Matrix
96
+
97
+ Both grids the recipe has. **Chrome × density** is the anatomy matrix — the four ways the two optional
98
+ frames combine, against `size`, the one variant axis `popoverSurfaceVariants` itself takes.
99
+ **Section break × density** is the other body-level choice: a plain `line` between groups, or a titled
100
+ `line-label`. Read the cells against each other and the point of a single shared recipe is the thing
101
+ that does **not** change — same fill, same 1px border, same radius-12 corner, same overlay shadow,
102
+ same symmetric `--space-200` padding in every cell. `size` moves the row height, never the chrome.
103
+
104
+ <Canvas of={PopoverSurfaceStories.Matrix} />
105
+
106
+ The surface has **no interaction states of its own**: Hover / Selected / Disabled belong to
107
+ [`ListRow`](?path=/docs/design-system-atoms-listrow--docs), focus lives on the trigger, and the recipe
108
+ never paints a focus ring — which is why there is no state axis in the grid above. Every knob is live
109
+ on its own in the
110
+ [Playground story](?path=/story/design-system-patterns-popover-surface--playground).
111
+
112
+ ## Do / Don't
113
+
114
+ - ✅ Apply `popoverSurfaceVariants` to the surface — one shared chrome for every dropdown.
115
+ - ✅ Compose the body from real `ListRow` + `Divider` atoms in `popoverGroupClass` groups.
116
+ - ✅ Keep one density per panel, one step below the trigger.
117
+ - ✅ Let the organism inject `role` + keyboard behaviour (`listbox`/`menu`/`combobox`).
118
+ - ✅ Use the `TextLink` atom for header / footer chrome links — `variant="strong"`, underline on.
119
+ - ❌ Don't build a `<PopoverSurface>` wrapper, add slots, or reach for a molecule.
120
+ - ❌ Don't hand-style a chrome link (a coloured `<span>`) — it loses the underline, focus ring and operable semantics.
121
+ - ❌ Don't hardcode hex / px, or ship a second surface skin.
122
+ - ❌ Don't re-derive the chrome per component — extend the one base style.
123
+ - ❌ Don't put horizontal padding on the surface or body — dividers must run full-bleed.
124
+
125
+ ## Usage
126
+
127
+ ```tsx
128
+ import {
129
+ popoverSurfaceVariants,
130
+ popoverBodyClass,
131
+ popoverGroupClass,
132
+ ListRow,
133
+ Divider,
134
+ } from '@invoiceonline/ui-react';
135
+
136
+ // Apply the shared chrome to your own *.Content surface, then compose rows in.
137
+ <div className={popoverSurfaceVariants({ size: 'md' })} role="listbox">
138
+ <div className={popoverBodyClass}>
139
+ <div className={popoverGroupClass}>
140
+ <ListRow role="option" selected>Faktura, s.r.o.</ListRow>
141
+ <ListRow role="option">Nová firma</ListRow>
142
+ </div>
143
+ <Divider variant="line" />
144
+ <div className={popoverGroupClass}>
145
+ <ListRow role="option">Nastavení</ListRow>
146
+ </div>
147
+ </div>
148
+ </div>
149
+ ```
150
+
151
+ ## Related
152
+
153
+ - **[ListRow](?path=/docs/design-system-atoms-listrow--docs)** — the option / menu rows composed into the body.
154
+ - **[Divider](?path=/docs/design-system-atoms-divider--docs)** — the full-bleed section breaks between groups.
155
+ - **[TextLink](?path=/docs/design-system-atoms-textlink--docs)** — the header / footer chrome links.
156
+ - **[SelectField](?path=/docs/design-system-molecules-selectfield--docs)** — a trigger whose panel is composed on this surface.
157
+ - Behaviour (positioning, dismissal, focus, highlight model, live-regions): `spec/06-patterns/overlay-behavior.md`.
158
+ - Spec: `spec/06-patterns/popover-patterns.md`.