@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,305 @@
1
+ import { Meta, Canvas, Controls } from '@storybook/addon-docs/blocks';
2
+ import * as PaginationStories from './Pagination.stories';
3
+
4
+ <Meta of={PaginationStories} tags={['autodocs']} />
5
+
6
+ # Pagination
7
+
8
+ ## Metadata
9
+
10
+ - **Layer:** molecule
11
+ - **Status:** draft
12
+ - **Manifest version:** `1.3.1`
13
+ - **Cell manifest:** `_pagination-item` version `1.3.3` — the shared 32×32 cell recipe every number and ellipsis is built from
14
+ - **Tokens used:** `--bg-hover`, `--border-width-200`, `--font-body`, `--font-size-sm`, `--font-weight-normal`, `--font-weight-semibold`, `--leading-loose`, `--outline-focus`, `--radius-200`, `--space-100`, `--space-300`, `--space-400`, `--space-900`, `--text-link`, `--text-link-hover`, `--text-secondary`
15
+
16
+ The manifests are `spec/04-molecules/pagination.manifest.json` and `spec/04-molecules/_pagination-item.manifest.json`; a bump of either one re-opens the component per Definition of Done (e).
17
+
18
+ ## Overview
19
+
20
+ Pagination is the **paging footer** under a Table or any long, page-broken list: Previous, a run of page-number cells, Next — one 32px row with a `--space-400` gap between every child. It tells the user which page they are on and lets them step one page or jump to a nearby one.
21
+
22
+ **Use it** once a paginated list spans more than one page. **Do not use it** as a page-size selector — "Položek na stránku" plus a compact Select is a Table-organism composition rule that sits *beside* Pagination and is never folded into it (spec § Purpose, manifest `intent.rules[2]`) — and do not reach for it as a general-purpose Button Group.
23
+
24
+ Two behaviours the component owns so the call site does not have to:
25
+
26
+ - At `totalPages <= 1` it renders **nothing** — never a lone, fully disabled single-page bar.
27
+ - Previous and Next go `disabled` at the ends instead of disappearing, so the row keeps its width and its tab order across pages.
28
+
29
+ ## Rationale
30
+
31
+ FODS Pagination always ships both triggers as real hosted Buttons (Tertiary, S), never a numbers-only run, because a keyboard or low-vision user relying on a predictable "next" should not have to hunt for a bare page number.
32
+
33
+ The component owns **no colour of its own.** The manifest is `kind: "composite"` with empty `parts` and no `families` at all — every visual fact is inherited:
34
+
35
+ - each number / ellipsis cell from the shared recipe `src/internal/paginationItem.ts` (`_pagination-item` 1.3.3),
36
+ - Previous / Next from the hosted `Button` (manifest `slots`, both `ref: "button"`).
37
+
38
+ The single token Pagination binds itself is the row gap, `composition.container.gap`. Splitting the cell out as a `tv()` recipe rather than a `<PaginationItem>` component mirrors `internal/dayCell.ts` and `internal/buttonSegment.ts`: `_Pagination Item` is an upstream Figma-only subcomponent (the leading underscore marks it, like `_button-segment` / `_field-segment`) with exactly one consumer.
39
+
40
+ ## Anatomy
41
+
42
+ A single `<nav>` row — `flex flex-wrap items-center justify-center gap-400` — carrying `data-fods-component="pagination"` and three part markers:
43
+
44
+ - **Container** (`data-fods-part="container"`) — the landmark itself, named by `labels.nav`. Gap `--space-400`. It deliberately has **no** border, no divider and no `overflow-hidden`: the cells are not fused into one clipped strip the way Button Group's segments are, and a clip would additionally swallow every cell's outward offset focus ring. `flex-wrap` is a narrow-viewport safety net, not a manifest fact. Your `className` and the forwarded `ref` land here.
45
+ - **Previous** (`data-fods-part="prev"`) — hosted `Button`, `variant="tertiary"`, `size="sm"`, leading `caret-left-small` icon, label `labels.previous`. `disabled` when `currentPage <= 1`.
46
+ - **Item run** (`data-fods-part="item"`, repeated) — one cell per visible page (a `<button>`, or an `<a href>` when `pageHref` is given) plus a non-interactive ellipsis `<span>` wherever a run is collapsed. Each cell publishes `data-page-state` with the value `default`, `current` or `ellipsis`, the same way DatePicker publishes `data-day-state` — it is what lets CSS, tests and the FODS probe tell a Current cell from a Default one in a row that renders both at once.
47
+ - **Next** (`data-fods-part="next"`) — the mirror of Previous: trailing `caret-right-small` icon, label `labels.next`, `disabled` when `currentPage >= totalPages`.
48
+
49
+ The row gap is the token `--space-400` (8px). A 4px/8px mismatch used to be flagged here; upstream corrected `notes[3]` on 2026-08-20, so the manifest and `pagination.md` § Anatomy now agree.
50
+
51
+ ## Variants
52
+
53
+ <Canvas of={PaginationStories.Matrix} />
54
+
55
+ There is **no variant axis in code.** Figma does carry a `Type` property with four values, but each is an authored snapshot of a runtime situation, not a knob a consumer turns — the manifest records them as `axes.content`. In code the real axis is runtime state, computed from `currentPage`, `totalPages` and `siblingCount`.
56
+
57
+ <table>
58
+ <thead>
59
+ <tr><th>Composition</th><th>Args</th><th>What it demonstrates</th></tr>
60
+ </thead>
61
+ <tbody>
62
+ <tr>
63
+ <td>Default</td>
64
+ <td><code>currentPage 2</code>, <code>totalPages 5</code></td>
65
+ <td>Short run — every page number is shown, no ellipsis</td>
66
+ </tr>
67
+ <tr>
68
+ <td>First page</td>
69
+ <td><code>currentPage 1</code>, <code>totalPages 5</code></td>
70
+ <td>Previous is <code>disabled</code>, not removed; cell 1 is Current</td>
71
+ </tr>
72
+ <tr>
73
+ <td>Last page</td>
74
+ <td><code>currentPage 5</code>, <code>totalPages 5</code></td>
75
+ <td>The mirror image — Next is <code>disabled</code>; the last cell is Current</td>
76
+ </tr>
77
+ <tr>
78
+ <td>Many pages</td>
79
+ <td><code>currentPage 6</code>, <code>totalPages 12</code></td>
80
+ <td>The collapse rule at the default <code>siblingCount</code> of 1: 1 … 5 [6] 7 … 12</td>
81
+ </tr>
82
+ </tbody>
83
+ </table>
84
+
85
+ ### The collapse rule
86
+
87
+ <Canvas of={PaginationStories.ManyPages} />
88
+
89
+ `paginationRange` shows every number while the run is short, and once it would crowd the row it keeps the first page, the last page and Current's immediate neighbours, collapsing everything else into **one** ellipsis per side. The threshold is `2 * siblingCount + 5` cells — first + last + current + neighbours + the two ellipsis slots, i.e. 7 cells at the default, which is where the manifest's "roughly 7+ pages" comes from.
90
+
91
+ The two edge branches render `3 + 2 * siblingCount` numbers rather than only Current's neighbours, so the run keeps the same cell count on page 1 as it has in the middle and the row does not visibly shrink while the user pages.
92
+
93
+ <Canvas of={PaginationStories.FirstPage} />
94
+
95
+ <Canvas of={PaginationStories.LastPage} />
96
+
97
+ <Canvas of={PaginationStories.SinglePage} />
98
+
99
+ ## Sizes
100
+
101
+ No size axis. Pagination always renders at the one density the manifest declares, independent of the Table's own row height — there is no `size` prop to pass.
102
+
103
+ <table>
104
+ <thead>
105
+ <tr><th>Size</th><th style={{ textAlign: 'right' }}>Height</th><th>Applies to</th><th>Tokens</th></tr>
106
+ </thead>
107
+ <tbody>
108
+ <tr>
109
+ <td><code>S</code> (the only one)</td>
110
+ <td style={{ textAlign: 'right' }}>32px</td>
111
+ <td>Both triggers (hosted Button Tertiary, <code>size="sm"</code>) and every cell</td>
112
+ <td>cell box <code>--space-900</code> (32×32 square), radius <code>--radius-200</code>, type <code>--font-size-sm</code> + <code>--leading-loose</code> (Body/S), row gap <code>--space-400</code></td>
113
+ </tr>
114
+ </tbody>
115
+ </table>
116
+
117
+ 32px is the dense-control floor from `accessibility.md`, so the whole bar reads as one row with no alternating heights. Below `sm` the triggers switch to a symmetric `--space-300` horizontal padding, which lands them at the same 32×32 as a cell instead of inheriting Button's optical asymmetric padding around a hidden label.
118
+
119
+ The recipe does not spell the leading out: the theme's `text-body-sm` tuple pairs `--font-size-sm` with `--leading-loose`, which is exactly the Body/S style.
120
+
121
+ ## States
122
+
123
+ <Canvas of={PaginationStories.States} />
124
+
125
+ State lives entirely on the children — the container has none (its parts map lists every state other than `default` as not applicable).
126
+
127
+ <table>
128
+ <thead>
129
+ <tr><th>Cell state</th><th>Rendered as</th><th>Tokens / treatment</th></tr>
130
+ </thead>
131
+ <tbody>
132
+ <tr>
133
+ <td>Default</td>
134
+ <td><code>&lt;button&gt;</code> (or <code>&lt;a href&gt;</code>)</td>
135
+ <td>text <code>--text-link</code>, <code>--font-weight-normal</code>, no substrate</td>
136
+ </tr>
137
+ <tr>
138
+ <td>Hover</td>
139
+ <td>a <code>hover:</code> pseudo-class, never a prop</td>
140
+ <td>fill <code>--bg-hover</code> wash (rounded by the ever-present <code>--radius-200</code>) + text <code>--text-link-hover</code></td>
141
+ </tr>
142
+ <tr>
143
+ <td>Current</td>
144
+ <td>the same <code>&lt;button&gt;</code>, plus <code>aria-current="page"</code></td>
145
+ <td>text stays <code>--text-link</code>; <code>--font-weight-semibold</code> + <code>underline</code>, held 2 px off the baseline and drawn 2 px thick, both bound to tokens (<code>--space-100</code> / <code>--border-width-200</code>). <strong>No wash, no border, no fill</strong> — the manifest says so twice, because a filled pill is the first thing an implementer reaches for here</td>
146
+ </tr>
147
+ <tr>
148
+ <td>Ellipsis</td>
149
+ <td>a non-interactive <code>&lt;span&gt;</code></td>
150
+ <td>text <code>--text-secondary</code>, <code>cursor-default select-none</code>; no wash ever, no focus ring, no <code>aria-current</code></td>
151
+ </tr>
152
+ <tr>
153
+ <td>Focus</td>
154
+ <td>every interactive child</td>
155
+ <td>additive <strong>offset</strong> ring on <code>:focus-visible</code> — <code>--outline-focus</code> at <code>--border-width-200</code>, 2px outside the box</td>
156
+ </tr>
157
+ </tbody>
158
+ </table>
159
+
160
+ Two more state facts that belong to the row rather than to a cell:
161
+
162
+ - **Previous / Next** carry the hosted Button's own state model; Pagination only decides *when* — `disabled` at `currentPage <= 1` and at `currentPage >= totalPages`. The Button renders a native disabled `<button>` with `aria-disabled`, so the disabled ink is Button's contract, not this component's.
163
+ - **Nothing at all** at `totalPages <= 1`.
164
+
165
+ Current has no hover wash: the cell matrix is flat (there is no `currentHover` row the way `dayCell` has `selectedToday`) and the manifest states that Current adds no wash and no border, only the Semibold step. It stays a real button — it simply does not light up, because it is the page you are already on.
166
+
167
+ The underline's geometry is explicit rather than left to the browser: on `auto` the browser draws a roughly 1 px rule about a pixel under the baseline, which reads as if it were touching the numeral. The manifest binds **both** numbers — `decorationOffset: --space-100` and `decorationThickness: --border-width-200`, i.e. a 2 px rule sitting 2 px clear of the glyph, which is where the Figma `item-current` node puts it. They are bound as arbitrary properties rather than `underline-offset-2` / `decoration-2`, because those utilities sit on a fixed numeric scale with no theme namespace: they would pin today's pixels instead of the tokens.
168
+
169
+ The line also carries `!`. A host stylesheet may declare a global `a:not(.button)` rule **outside every** `@layer`, and an unlayered declaration beats any layered utility whatever its specificity — so on the `pageHref` branch a plain `underline` renders no line at all, leaving Current with only the Semibold step. Its `text-decoration: none` is a shorthand and resets the thickness to `auto` as well, so that one is forced too; `text-underline-offset` is not part of the shorthand and stays plain. The same workaround appears in `TextLink`, `Alert` and `Button`, and every one of them can drop it once that global rule moves into a layer.
170
+
171
+ **Motion.** The row adds none of its own — manifest 1.3.1 `motion.none` („the items and the arrow buttons carry the motion“) with `inherits: [_pagination-item, button]`. The cell follows `_pagination-item` 1.3.3 `motion.states`: the hover wash and ink change over `--duration-hover`, and a cell becoming Current over `--duration-toggle`, both on `--easing-standard`, over `background-color` / `color` / `text-decoration-color` — the focus outline is not in the list and is never eased. The underline *line* itself appears at once: `text-decoration-line` does not interpolate, and drawing a transparent underline on every Default cell so that its colour could fade in would surface under forced colors, where every cell would show a line and Current would lose its non-colour cue. Previous / Next bring Button's own motion (hover `--duration-hover`, press `--duration-press`). Colour only, so there is no reduced-motion override.
172
+
173
+ In the States story, Hover and Focus are rendered with **bare classes**, not `parameters.pseudo`: Tailwind wraps every `hover:` utility in a `@media (hover: hover)` query that the pseudo-states addon does not rewrite, so a forced row would come out byte-identical to Default. The measured hover lives in the Matrix story, under a real pointer.
174
+
175
+ ## API
176
+
177
+ <Controls />
178
+
179
+ `labels` is **optional** — an override, not a requirement. Every string falls back to the component's own Czech default (`nav` «Stránkování», `previous` «Předchozí», `next` «Další», `page` «Stránka», `morePages` «Další stránky»), so a Czech call site passes nothing. The exception is a page with more than one Pagination: each `nav` landmark needs its own name, so each one passes a distinct `labels.nav` (e.g. «Stránkování faktur»). Pass a partial object to reword a single key, or the market's strings on a non-Czech market; the other keys keep their defaults. An empty-string override falls back too — an empty accessible name is never intentional. An app with more than one language version passes every key of `labels` from its translations on every use; the full list of such props is in [Consuming → Texts and locale](?path=/docs/getting-started-consuming--docs#texts-and-locale).
180
+
181
+ <Canvas of={PaginationStories.CustomLabels} />
182
+
183
+ ## Do / Don't
184
+
185
+ - ✅ Show every page number while the count is small; collapse only once the row would crowd (roughly 7+ pages)
186
+ - ✅ Keep Previous / Next visible and `disabled` at the ends, so the row's width and tab order stay stable
187
+ - ✅ Let the component hide itself at `totalPages <= 1` instead of gating on the page count at the call site
188
+ - ✅ Pair Pagination with a separate page-size label plus Select at the Table-organism level
189
+ - ✅ Let the defaults supply the copy on a Czech-only call site — pass `labels` to reword a key, and every key from the translations in an app with more than one language version
190
+ - ✅ Pass `pageHref` wherever a crawler must reach page 2 and beyond (a blog, a search result list)
191
+ - ❌ Collapse to an ellipsis on a short list "just in case" — the rule saves space, it does not hide structure
192
+ - ❌ Remove or hide Previous / Next when there is no page in that direction
193
+ - ❌ Render a fully disabled single-page bar
194
+ - ❌ Fold a "rows per page" control into Pagination itself
195
+ - ❌ Mark the current page with a fill, a border or a bottom-border bar — Current is a weight step plus an underline on the same ink
196
+ - ❌ Put a border, a divider or `overflow-hidden` on the row: that turns Pagination into a Button Group strip and clips away every cell's outward focus ring
197
+
198
+ ## Accessibility
199
+
200
+ - **Keyboard** — Previous, every page cell and Next are each their own tab stop, in visual order. The ellipsis is a `<span>`, so it holds no tab stop. A disabled trigger is a native disabled `<button>` and is skipped.
201
+ - **ARIA** — the row is a `<nav>` named by `labels.nav` ("Stránkování"), never a generic "Navigace". Each page cell carries `aria-label` composed from `labels.page` plus the number, and `aria-current="page"` sits on exactly one cell — the current page — and nowhere else.
202
+ - **Screen reader** — the ellipsis glyph is `aria-hidden="true"` and is immediately followed by visually hidden copy (`labels.morePages`, e.g. "Další stránky"), so a screen-reader user gets an equivalent of the skipped run instead of silence.
203
+ - **Focus** — each interactive child carries its own independent additive **offset** ring: `--outline-focus` at `--border-width-200`, 2px outside the box. Not the inset / fused treatment Button Group uses, because the cells are never clipped into one bordered strip. This is why the row must never carry `overflow-hidden`.
204
+ - **Target size** — every cell is a 32×32 square and both triggers are 32px high (the dense-control floor), with the `--space-400` gap keeping adjacent tappable elements apart.
205
+ - **Contrast & motion** — page numbers clear AA on their own: `--text-link` moved to blue/700, so the cells measure **5.93:1** on white and **5.61:1** over the hover wash. The 4.45:1 exception that used to cover them was **retired 2026-07-31** (`accessibility.md` § Retired exception — pagination number cells). Current keeps its Semibold + underline as the non-colour cue for WCAG 1.4.1, not as a contrast mitigation. The only motion is a colour transition on motion tokens (see [States](#states) → Motion); nothing moves or transforms.
206
+
207
+ Accessibility floor for every FODS component: `spec/01-foundations/accessibility.md`.
208
+
209
+ ### Approved deviations
210
+
211
+ Both are deliberate departures from the manifest / spec, signed off, and documented here so they are not "fixed" by accident.
212
+
213
+ 1. **Below `sm` the Previous / Next label is hidden, so the triggers read as icon-only.** The manifest gives both triggers a fixed text label (`text.prev-label` / `next-label`) and § Do / Don't forbids swapping them for icon-only buttons. At 375px the row does not fit next to the number run, so the label is hidden with `max-sm:sr-only` (never `sr-only sm:not-sr-only`: an unlayered global `.sr-only` on a host page beats Tailwind's layered override and hides the label on desktop) — a **CSS hide, not a conditional render**: the accessible name stays in the DOM at every width, so the "text label is part of the a11y contract" half of the rule still holds and there is no viewport-dependent markup to mismatch on hydration. Below `sm` the run additionally drops to `siblingCount` 0 (first · current · last), because five cells plus two triggers do not fit; the override only ever goes **down** — a narrow viewport can never grow the run.
214
+
215
+ <Canvas of={PaginationStories.Mobile} />
216
+
217
+ 2. **A page cell becomes an anchor when `pageHref` is given.** Spec § Accessibility says every page number is a real `<button>`. Without a crawlable `href` the pages 2 and beyond of a public list such as a blog are unreachable and their articles end up orphaned, so the consumer may hand in a URL builder; the cell then renders `<a href>` with an **identical** `aria-label`, `aria-current` and cell class string, and intercepts plain left-clicks for SPA navigation. Modified clicks (new tab, middle button) fall through to the browser. The ellipsis never becomes a link. The visual parity is not free: the global unlayered anchor rule erases the Current underline unless the recipe forces it, which is why the cell carries `!underline` (see States above).
218
+
219
+ <Canvas of={PaginationStories.WithLinks} />
220
+
221
+ ### Known limitations
222
+
223
+ - The manifest pins the **small** caret tier (`caret-left-small` / `caret-right-small`) on Previous / Next, and 1.2.2 finished saying so: the two region `role` strings had still named the plain `caret-left` / `caret-right` while the prose, the Figma set and this component had carried the small tier all along (aligned on the small names now that the plain carets are deprecated — icon 1.8.0, 2026-09-14). **Nothing moved in code**, and the names match too: the component renders the canonical `caret-left-small` / `caret-right-small` (the legacy `chevron-*-small` spellings are not an `IconName` in React).
224
+
225
+ ## Copy
226
+
227
+ Voice: Previous / Next follow the Button action-label rules — sentence case, impersonal in-app voice. They are fixed navigation labels, not per-instance content.
228
+
229
+ - **Previous label** (`labels.previous`) — always «Předchozí» (or the market's direct equivalent), never a synonym swapped in per screen. Single line, max 12 characters, truncated on overflow.
230
+ - **Next label** (`labels.next`) — always «Další». Single line, max 12 characters, truncated on overflow.
231
+ - **Page numbers and the ellipsis** are generated, not authored: locale-formatted numerals and a literal «…». The only copy around them is the cell's accessible name, «Stránka» plus the number (`labels.page`).
232
+ - **Landmark name** (`labels.nav`) — «Stránkování» names the control itself, never a generic «Navigace».
233
+
234
+ <table>
235
+ <thead>
236
+ <tr><th>Text</th><th>Canonical (CZ)</th><th>Never</th></tr>
237
+ </thead>
238
+ <tbody>
239
+ <tr><td>Previous</td><td><code>Předchozí</code></td><td><code>Zpět</code>, an icon-only <code>←</code> with no text equivalent</td></tr>
240
+ <tr><td>Next</td><td><code>Další</code></td><td><code>Vpřed</code>, an icon-only <code>→</code> with no text equivalent</td></tr>
241
+ <tr><td>Page cell name</td><td><code>{'Stránka {n}'}</code></td><td>—</td></tr>
242
+ <tr><td>Landmark name</td><td><code>Stránkování</code></td><td><code>Navigace</code></td></tr>
243
+ </tbody>
244
+ </table>
245
+
246
+ ## Usage
247
+
248
+ <Canvas of={PaginationStories.Playground} />
249
+
250
+ ```tsx
251
+ // Good — the whole call site. Copy falls back to the Czech defaults, and there is no gate
252
+ // on the page count: Pagination renders nothing when there is only one page.
253
+ <Pagination
254
+ currentPage={page}
255
+ totalPages={totalPages}
256
+ onPageChange={setPage}
257
+ />
258
+
259
+ // Good — a crawlable list (blog, search results): every cell is a real anchor.
260
+ <Pagination
261
+ currentPage={page}
262
+ totalPages={12}
263
+ onPageChange={setPage}
264
+ pageHref={p => `/blog?page=${p}`}
265
+ />
266
+
267
+ // Good — one screen needs different wording for the cell's accessible name.
268
+ // The other four strings keep their defaults.
269
+ <Pagination
270
+ currentPage={page}
271
+ totalPages={totalPages}
272
+ onPageChange={setPage}
273
+ labels={{ page: 'Stránka výsledků' }}
274
+ />
275
+ ```
276
+
277
+ ```tsx
278
+ // Don't — gating on the page count at the call site duplicates logic the
279
+ // component already owns (it renders nothing at totalPages <= 1).
280
+ {totalPages > 1 && <Pagination currentPage={page} totalPages={totalPages} … />}
281
+
282
+ // Don't — blanking a label to hide a trigger. It does not hide anything (an empty
283
+ // override falls back to the default) and hiding them at the ends would make the row
284
+ // change width and reshuffle the tab order as the user pages.
285
+ <Pagination … labels={{ previous: page === 1 ? '' : 'Předchozí' }} />
286
+
287
+ // Don't — restating the defaults at the call site. That is the default path;
288
+ // pass `labels` only for the key you are actually changing.
289
+ <Pagination … labels={{ nav: 'Stránkování', previous: … }} />
290
+
291
+ // Don't — a page-size selector is not part of this molecule; place the label
292
+ // and the Select beside Pagination at the Table level.
293
+ ```
294
+
295
+ ## Related
296
+
297
+ - [`Button`](?path=/docs/design-system-atoms-button--docs) — the hosted Tertiary S trigger Previous / Next are built from, and the canonical source for action-label copy.
298
+ - [`ButtonGroup`](?path=/docs/design-system-molecules-buttongroup--docs) — the fused, clipped sibling; Pagination is deliberately **not** built that way (independent corners, visible air, outward focus rings).
299
+ - [`DatePicker`](?path=/docs/design-system-molecules-datepicker--docs) — the `src/internal/dayCell.ts` precedent for a small, single-size, state-recolouring cell shipped as a recipe rather than a component.
300
+ - Spec: `spec/04-molecules/pagination.md` — the cell's prose lives in the same file, § "Pagination Item — the shared cell"; accessibility floor `spec/01-foundations/accessibility.md`.
301
+
302
+ ## Migration notes
303
+
304
+ **1.2.3 → 1.3.1 / `_pagination-item` 1.3.3 (2026-11-03).** 1.3.0 marks the component stable (no design, token or measurement change); 1.3.1 records the motion audit — the row is static and inherits the cell's and Button's motion. The cell's raw `transition-colors duration-150` became `transition-[background-color,color,text-decoration-color] duration-hover ease-standard`, with `duration-toggle` on Current (see [States](#states) → Motion). `_pagination-item` 1.3.1 / 1.3.2 changed no rendering (the dropped `icon: 0` size field; the «Stránka 2» style of label this build already used).
305
+
@@ -0,0 +1,333 @@
1
+ import React from 'react';
2
+ import type { Meta, StoryObj } from '@storybook/react-vite';
3
+ import { Pagination, type PaginationLabels } from './Pagination';
4
+ import { paginationItemVariants } from '../../internal/paginationItem';
5
+ import { cn } from '../../internal/utils';
6
+ import { Section, Showcase } from '../../storybook/Section';
7
+ import { componentDoc } from '../../storybook/componentDoc';
8
+ import { PAGINATION_ITEM_FORCE_HOVER, PAGINATION_ITEM_FORCE_RING } from '../../storybook/forceStates';
9
+
10
+ /**
11
+ * The manifest's `axes.content` — four authored snapshots, not a parametrized
12
+ * variant set. Figma carries them as a `Type` property; the code does not expose
13
+ * one, because each is a different runtime state of `currentPage` / `totalPages`.
14
+ */
15
+ const CONTENTS = ['Default', 'First page', 'Last page', 'Many pages'] as const;
16
+
17
+ /**
18
+ * The Matrix stacks four `<nav>` landmarks on one page, so each one gets the name a
19
+ * screen with several paged lists would give it — never four times "Stránkování".
20
+ */
21
+ const MATRIX_NAV_LABEL: Record<(typeof CONTENTS)[number], string> = {
22
+ Default: 'Stránkování faktur',
23
+ 'First page': 'Stránkování výdajů',
24
+ 'Last page': 'Stránkování kontaktů',
25
+ 'Many pages': 'Stránkování dokladů',
26
+ };
27
+
28
+ /** `_pagination-item.axes.state` — the cell's own four-row matrix. */
29
+ const STATES = ['Default', 'Hover', 'Current', 'Ellipsis'] as const;
30
+
31
+ /**
32
+ * Every string falls back to the component's Czech default, with two exceptions.
33
+ * The object below is for the override story — a screen that needs different wording
34
+ * for ONE key, with the rest keeping their defaults. And the Matrix names each of its
35
+ * four landmarks after the list it pages (MATRIX_NAV_LABEL).
36
+ */
37
+ const LABEL_OVERRIDE: Partial<PaginationLabels> = {
38
+ page: 'Stránka výsledků',
39
+ };
40
+
41
+ /** The four compositions, keyed by the manifest's own axis labels. */
42
+ const CONTENT_ARGS: Record<(typeof CONTENTS)[number], { currentPage: number; totalPages: number }> = {
43
+ Default: { currentPage: 2, totalPages: 5 },
44
+ 'First page': { currentPage: 1, totalPages: 5 },
45
+ 'Last page': { currentPage: 5, totalPages: 5 },
46
+ 'Many pages': { currentPage: 6, totalPages: 12 },
47
+ };
48
+
49
+ const noop = () => {};
50
+
51
+ const meta = {
52
+ title: 'Design System/Molecules/Pagination',
53
+ component: Pagination,
54
+ parameters: {
55
+ layout: 'padded',
56
+ docs: {
57
+ description: {
58
+ component: componentDoc({
59
+ summary:
60
+ 'The paging footer under a Table or any long, page-broken list: `[Předchozí] numbers [Další]` on one 32px row with a --space-400 gap. Pagination owns no colour of its own — every number/ellipsis cell comes from the shared _pagination-item recipe and both triggers are a hosted Button (Tertiary, S). One density, no size axis; the only axis is runtime state computed from currentPage / totalPages / siblingCount.',
61
+ useCases: [
62
+ 'Under a paginated table or list, once the content spans more than one page',
63
+ 'Short run — show every page number (up to ~7)',
64
+ 'Long run — collapse to first · ellipsis · current\'s neighbours · ellipsis · last',
65
+ 'Crawlable pagination — pass `pageHref` and each cell renders a real anchor',
66
+ ],
67
+ bestPractices: [
68
+ 'Show every page number while the count is small; collapse only once the row would crowd (~7+)',
69
+ 'Keep Previous/Next visible and disabled at the ends — never remove them, so the row width and tab order stay stable',
70
+ 'Let the component hide itself at totalPages <= 1 instead of gating on it at the call site',
71
+ 'Pair a page-size selector with Pagination at the Table level — never fold "rows per page" into this molecule',
72
+ 'Pass `pageHref` wherever a crawler must reach page 2+, e.g. a blog or a search result list',
73
+ ],
74
+ knownIssues: [
75
+ 'Below `sm` the Previous/Next label is hidden with sr-only and the triggers read as icon-only — an approved deviation from the manifest text slots. The label stays in the DOM, so the accessible name is unaffected.',
76
+ 'A cell renders as <a href> when the consumer passes `pageHref`, where the spec says <button>. Approved: without a crawlable href the pages 2+ of a public list such as a blog are unreachable.',
77
+ 'The manifest pins the SMALL caret tier (caret-left-small / caret-right-small) on Previous/Next and 1.2.2 aligned the region roles on those names. Code renders that tier under the same canonical names.',
78
+ 'Page numbers clear AA unaided since --text-link moved to blue/700: 5.93:1 on white, 5.61:1 over the hover wash. The old 4.45:1 exception was retired 2026-07-31.',
79
+ ],
80
+ docsLink: {
81
+ label: 'spec/04-molecules/pagination.md',
82
+ },
83
+ }),
84
+ },
85
+ },
86
+ },
87
+ // The baseline the render-only stories (Matrix, States) inherit so they satisfy
88
+ // the required props without restating them; Playground re-states it explicitly
89
+ // because a sweep that reads its `args` flags any key it has to default for
90
+ // itself.
91
+ args: {
92
+ currentPage: 3,
93
+ totalPages: 5,
94
+ siblingCount: 1,
95
+ onPageChange: noop,
96
+ },
97
+ } satisfies Meta<typeof Pagination>;
98
+
99
+ export default meta;
100
+ type Story = StoryObj<typeof meta>;
101
+
102
+ export const Playground: Story = {
103
+ args: {
104
+ currentPage: 3,
105
+ totalPages: 5,
106
+ siblingCount: 1,
107
+ onPageChange: noop,
108
+ },
109
+ argTypes: {
110
+ currentPage: { control: { type: 'number', min: 1 } },
111
+ totalPages: { control: { type: 'number', min: 1 } },
112
+ siblingCount: { control: { type: 'number', min: 0, max: 3 } },
113
+ pageHref: { control: false },
114
+ labels: { control: 'object' },
115
+ className: { control: 'text' },
116
+ },
117
+ };
118
+
119
+ /**
120
+ * Rows = the manifest's `axes.content`, the four compositions Figma ships. There
121
+ * is no size axis to put on the column axis — Pagination always renders at the
122
+ * one 32px density, independent of the table's own row height.
123
+ *
124
+ * This is also the story an interaction pass drives: a real pointer
125
+ * crosses every cell here and a real Tab walks every trigger, which is the only
126
+ * way hover and `:focus-visible` get measured rather than asserted.
127
+ */
128
+ export const Matrix: Story = {
129
+ parameters: {
130
+ docs: {
131
+ description: {
132
+ story:
133
+ 'The full content axis. Note what does NOT change between rows: the row keeps its width and its tab order, because Previous/Next go disabled at the ends instead of disappearing.',
134
+ },
135
+ },
136
+ },
137
+ render: () => (
138
+ <div className="flex flex-col gap-600">
139
+ {CONTENTS.map(content => (
140
+ <div key={content} className="flex flex-col gap-200">
141
+ <span className="text-body-sm font-semibold text-text-secondary">{content}</span>
142
+ <Pagination
143
+ {...CONTENT_ARGS[content]}
144
+ siblingCount={1}
145
+ labels={{ nav: MATRIX_NAV_LABEL[content] }}
146
+ onPageChange={noop}
147
+ />
148
+ </div>
149
+ ))}
150
+ </div>
151
+ ),
152
+ };
153
+
154
+ /**
155
+ * The cell matrix, rendered from the recipe directly rather than through
156
+ * Pagination — the same shape `DayCellStates` uses for the Date Picker's grid
157
+ * unit, and for the same reason: a docs grid has to show four states at once,
158
+ * which no single `<Pagination>` instance can do.
159
+ *
160
+ * Hover and focus are BARE classes here, not `parameters.pseudo`. Tailwind wraps
161
+ * every `hover:` utility in `@media (hover: hover)` and the addon does not rewrite
162
+ * rules inside a media query, so the Hover row would come out byte-identical to
163
+ * Default while a live mouse showed the real thing. The measured hover lives in
164
+ * `Matrix` above, under a real pointer.
165
+ */
166
+ export const States: Story = {
167
+ parameters: {
168
+ docs: {
169
+ description: {
170
+ story:
171
+ 'Default / Hover / Current / Ellipsis. Current is a weight step plus an underline on the SAME --text-link ink — never a fill, never a border, so it cannot be mistaken for a filled button. Ellipsis is the one non-interactive state: --text-secondary, no wash on hover because it has no hover.',
172
+ },
173
+ },
174
+ },
175
+ render: () => (
176
+ <Showcase>
177
+ <Section title="Cell states" description="_pagination-item 1.3.3 — one family, four states.">
178
+ <div className="grid grid-cols-[auto_auto] items-center gap-x-800 gap-y-300">
179
+ {STATES.map(state => (
180
+ <React.Fragment key={state}>
181
+ <span className="text-body-sm font-medium">{state}</span>
182
+ {state === 'Default' && (
183
+ <button type="button" className={paginationItemVariants({ state: 'default' })}>
184
+ 5
185
+ </button>
186
+ )}
187
+ {state === 'Hover' && (
188
+ <button
189
+ type="button"
190
+ // `cn()`, not a template literal: raw concatenation leaves both
191
+ // `text-text-link` and `text-text-link-hover` in the attribute and
192
+ // lets CSS source order pick the winner. It happens to pick the
193
+ // forced one today — that is luck, not a rule.
194
+ className={cn(paginationItemVariants({ state: 'default' }), PAGINATION_ITEM_FORCE_HOVER)}
195
+ >
196
+ 5
197
+ </button>
198
+ )}
199
+ {state === 'Current' && (
200
+ <button
201
+ type="button"
202
+ aria-current="page"
203
+ className={paginationItemVariants({ state: 'current' })}
204
+ >
205
+ 5
206
+ </button>
207
+ )}
208
+ {state === 'Ellipsis' && (
209
+ <span className={paginationItemVariants({ state: 'ellipsis' })}>
210
+ <span aria-hidden="true">…</span>
211
+ </span>
212
+ )}
213
+ </React.Fragment>
214
+ ))}
215
+ </div>
216
+ </Section>
217
+
218
+ <Section
219
+ title="Focus"
220
+ description="Every interactive child carries its OWN additive offset ring — 2 px --outline-focus outside the box. The cells are never clipped into one strip, so the standard outward ring applies."
221
+ >
222
+ <button
223
+ type="button"
224
+ className={`${paginationItemVariants({ state: 'default' })} ${PAGINATION_ITEM_FORCE_RING}`}
225
+ >
226
+ 5
227
+ </button>
228
+ <button
229
+ type="button"
230
+ aria-current="page"
231
+ className={`${paginationItemVariants({ state: 'current' })} ${PAGINATION_ITEM_FORCE_RING}`}
232
+ >
233
+ 6
234
+ </button>
235
+ </Section>
236
+ </Showcase>
237
+ ),
238
+ };
239
+
240
+ export const FirstPage: Story = {
241
+ args: { ...CONTENT_ARGS['First page'], siblingCount: 1, onPageChange: noop },
242
+ parameters: {
243
+ docs: {
244
+ description: {
245
+ story: 'Previous is disabled, not removed — the row keeps its width and its tab order.',
246
+ },
247
+ },
248
+ },
249
+ };
250
+
251
+ export const LastPage: Story = {
252
+ args: { ...CONTENT_ARGS['Last page'], siblingCount: 1, onPageChange: noop },
253
+ parameters: {
254
+ docs: { description: { story: 'The mirror image: Next goes disabled at the far end.' } },
255
+ },
256
+ };
257
+
258
+ export const ManyPages: Story = {
259
+ args: { ...CONTENT_ARGS['Many pages'], siblingCount: 1, onPageChange: noop },
260
+ parameters: {
261
+ docs: {
262
+ description: {
263
+ story:
264
+ 'The collapse rule at siblingCount 1: `1 … 5 [6] 7 … 12` — first page pinned, an ellipsis, both immediate neighbours of Current, Current, an ellipsis, last page pinned. Exactly the Figma "Many pages" sequence, and never more than one ellipsis per side.',
265
+ },
266
+ },
267
+ },
268
+ };
269
+
270
+ export const SinglePage: Story = {
271
+ args: { currentPage: 1, totalPages: 1, onPageChange: noop },
272
+ parameters: {
273
+ docs: {
274
+ description: {
275
+ story:
276
+ 'Renders NOTHING. A one-page list gets no bar at all, never a fully disabled one — so a call site does not have to gate on the page count itself.',
277
+ },
278
+ },
279
+ },
280
+ };
281
+
282
+ export const WithLinks: Story = {
283
+ args: {
284
+ ...CONTENT_ARGS['Many pages'],
285
+ siblingCount: 1,
286
+ onPageChange: noop,
287
+ pageHref: (page: number) => `?page=${page}`,
288
+ },
289
+ parameters: {
290
+ docs: {
291
+ description: {
292
+ story:
293
+ 'With `pageHref` every number cell is a real anchor, so a crawler can reach page 2+ instead of leaving those articles orphaned. The ARIA is identical to the button branch; a plain left click is intercepted for SPA navigation while a cmd/ctrl click opens a new tab. The ellipsis never becomes a link.',
294
+ },
295
+ },
296
+ },
297
+ };
298
+
299
+ /**
300
+ * `labels` is an OVERRIDE, not a requirement: pass only the key that needs
301
+ * different wording and the other four keep their Czech defaults. Here the
302
+ * page cells announce "Stránka výsledků 6" while Previous / Next / the ellipsis
303
+ * are untouched.
304
+ */
305
+ export const CustomLabels: Story = {
306
+ args: { ...CONTENT_ARGS['Many pages'], siblingCount: 1, onPageChange: noop, labels: LABEL_OVERRIDE },
307
+ parameters: {
308
+ docs: {
309
+ description: {
310
+ story:
311
+ 'A partial override. Nothing else in this file passes `labels` at all — the default path renders the Czech defaults «Stránkování», «Předchozí», «Další», «Stránka» and «Další stránky»; a non-Czech market passes its own strings through `labels`.',
312
+ },
313
+ },
314
+ },
315
+ };
316
+
317
+ /**
318
+ * Below `sm` two things change, and only these two: the Previous/Next label is
319
+ * hidden (the trigger reads as icon-only at a symmetric 32x32) and the run drops
320
+ * to siblingCount 0, i.e. first · current · last.
321
+ */
322
+ export const Mobile: Story = {
323
+ args: { ...CONTENT_ARGS['Many pages'], siblingCount: 1, onPageChange: noop },
324
+ globals: { viewport: { value: 'mobile' } },
325
+ parameters: {
326
+ docs: {
327
+ description: {
328
+ story:
329
+ 'The same args as Many pages at 375 px: `1 … 6 … 12` with icon-only triggers. The label is hidden in CSS, not dropped from the DOM, so the accessible name is unchanged at every width.',
330
+ },
331
+ },
332
+ },
333
+ };