@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,379 @@
1
+ import { Meta } from '@storybook/addon-docs/blocks';
2
+
3
+ <Meta title="Getting Started/Consuming" />
4
+
5
+ # Consuming `@invoiceonline/ui-react`
6
+
7
+ The React components of FODS, the FakturaOnline design system. This page is for the app
8
+ that installs the package: what to import, which CSS to load and in what order, which
9
+ providers to mount, and what the package leaves to you. Every component has its own docs
10
+ page in this Storybook and in the package (`src/components/<folder>/<Name>.mdx`).
11
+
12
+ **For AI agents.** An agent working in the app starts at `AGENTS.md` and `llms.txt` in the
13
+ package root (`node_modules/@invoiceonline/ui-react/`): the rules of this page in short and
14
+ every component with its import. Import `AGENTS.md` into the app's own agent instructions so
15
+ every session reads it; [For AI agents](?path=/docs/getting-started-for-ai-agents--docs) has
16
+ the rest.
17
+
18
+ ## Install
19
+
20
+ ```bash
21
+ npm install @invoiceonline/ui-react
22
+ ```
23
+
24
+ - **Peer dependencies:** `react` and `react-dom` `^19.0.0` and `@tanstack/react-table`
25
+ `^9.3.1` (the types of `Table` props come from it, see below). npm 7 and later installs a
26
+ missing peer dependency itself.
27
+ - **The design tokens ship in the package**, from the same commit as the components and
28
+ their theme: `@invoiceonline/ui-react/tokens.css` (the CSS variables, loaded once per app,
29
+ see Styles), `@invoiceonline/ui-react/tokens` (the same tokens as JS: `primitives`,
30
+ `semantic`, `springs`, `curves`) and `@invoiceonline/ui-react/tokens.flat.json`. Do not
31
+ install `@invoiceonline/ui-system` next to it: a `tokens.css` from another version can lack
32
+ a variable the components refer to, and nothing fails when it does.
33
+ - **ESM only.** There is no CommonJS build. A test runner that loads CommonJS (Jest without
34
+ ESM support) has to transform the package.
35
+ - **Fonts are not shipped.** The tokens name the faces, the app loads them: Inter
36
+ (`--font-body`), Poppins (`--font-heading`) and Caveat (`--font-decorative`, used by the
37
+ pointer label of ProgressBar and the `kicker` of HeadingGroup and Hero).
38
+ - **Dependencies** install with the package: Radix (Dialog, Slot, Tooltip), Floating UI,
39
+ Motion, date-fns, react-day-picker, react-number-format, ECharts, `clsx`,
40
+ `tailwind-merge` and `tailwind-variants`. `sideEffects` in `package.json` names only the
41
+ CSS, so a bundler can leave out the code of the components the app does not import
42
+ (ECharts, for one, is used only by StatusSummaryBar).
43
+ - **Table state types.** The props of `Table` use TanStack types that the package does not
44
+ re-export: `SortingState` (`sorting`), `RowSelectionState` (`selection.state`) and
45
+ `ColumnVisibilityState` (`columnVisibility.state`). `@tanstack/react-table` is a peer
46
+ dependency, so the app and the package share one copy: import the types from there.
47
+ Column definitions come from `createTableColumnHelper`, which the package exports.
48
+
49
+ ## Imports
50
+
51
+ ```tsx
52
+ import { Button, TextField } from '@invoiceonline/ui-react'; // root entry
53
+ import { Button } from '@invoiceonline/ui-react/button'; // one component folder
54
+ ```
55
+
56
+ Each component folder has its own entry, named after the folder (`button-group`,
57
+ `text-field`, `promo-sticker`…). The tokens have theirs: `@invoiceonline/ui-react/tokens`. The root entry re-exports all of them plus `FodsProvider`,
58
+ `cn`, `hasOpenFloatingPanel`, `PortalContainerContext`, `buttonSegmentVariants` and
59
+ `progressBarItemVariants`. Anything not listed in the `exports` of `package.json` is
60
+ private: never import a `dist/…` or `src/…` path.
61
+
62
+ ## Styles
63
+
64
+ The package ships its CSS in two shapes. Pick one; never both.
65
+
66
+ ### An app without Tailwind
67
+
68
+ The order of layers goes in a stylesheet of its own, imported first:
69
+
70
+ ```css
71
+ /* layers.css: nothing but the order. `properties` is Tailwind's fallback layer
72
+ for its --tw-* variables and has to sit below fods; `reset` is yours. */
73
+ @layer properties, reset, fods;
74
+ ```
75
+
76
+ ```css
77
+ /* globals.css */
78
+ @import "./layers.css";
79
+ @import "@invoiceonline/ui-react/tokens.css";
80
+ @import "@invoiceonline/ui-react/styles.css";
81
+ ```
82
+
83
+ Do not write the `@layer` line into the file that holds the two package imports. A bundler
84
+ that inlines imports can emit the imported stylesheets ahead of that line (Next.js 16 with
85
+ Turbopack does). `styles.css` then declares `properties` and `fods` first, `reset` lands
86
+ after `fods`, and a reset of the app in that layer overrides the components. As an import
87
+ of its own the line stays first.
88
+
89
+ `styles.css` holds the scoped reset, the keyframes, the artwork rules (PromoSticker and
90
+ PromoSurface) and every utility class the
91
+ components use.
92
+
93
+ ### An app with Tailwind 4
94
+
95
+ The app's Tailwind generates the utility classes from the package's compiled JS. The
96
+ package adds its theme (the token-to-utility map) and the hand-written rules that class
97
+ scanning cannot produce.
98
+
99
+ ```css
100
+ /* Before every import: fods has to sit below utilities. */
101
+ @layer theme, base, fods, components, utilities;
102
+ @import "tailwindcss";
103
+ @import "@invoiceonline/ui-react/tokens.css" layer(theme);
104
+ @import "@invoiceonline/ui-react/theme.css";
105
+ @import "@invoiceonline/ui-react/shared.css";
106
+ /* The path from this stylesheet to the package's dist/, not src/. */
107
+ @source "../node_modules/@invoiceonline/ui-react/dist";
108
+ ```
109
+
110
+ - Do not import `styles.css` as well: it would add a second copy of the utilities.
111
+ - The first line is required. `@import "tailwindcss"` declares the layers `theme, base,
112
+ components, utilities`; without your own declaration before it, `fods` lands after
113
+ `utilities` and the scoped reset in `fods.base` overrides the component utilities
114
+ (padding, gap, border) that your Tailwind writes into `utilities`.
115
+ - `theme.css` is an `@theme inline reference` block: utilities get the token variable
116
+ itself (`gap: var(--space-200)`) and no theme variable is emitted.
117
+ - **`theme.css` replaces the theme of your Tailwind, it does not add to it.** It starts with
118
+ `--*: initial`, which drops every default of Tailwind for the whole build: after the
119
+ import, `gap-4`, `p-4`, `text-sm` or `bg-red-500` in your own code produce no CSS, only
120
+ the classes of the FODS tokens do (`gap-200`, `text-body-sm`, `bg-primary`). This mode is
121
+ for an app that is styled with the FODS tokens. An app that keeps Tailwind's default scale
122
+ for its own code uses the mode without Tailwind for the package (`styles.css`) instead.
123
+
124
+ ### Cascade layers
125
+
126
+ Every rule of `styles.css` sits in `@layer fods.base` (reset, keyframes, artwork rules) or
127
+ `@layer fods.utilities` (utility classes). In the mode with Tailwind, `shared.css` brings
128
+ `fods.base` and your Tailwind writes the utility classes into its own `utilities` layer.
129
+ Two consequences follow from how the cascade treats layers.
130
+
131
+ **Your unlayered CSS beats the package, whatever its specificity.** A global `button { … }`,
132
+ `a { … }`, `h1, h2, h3 { … }` or a reset like `* { padding: 0; margin: 0 }` that is not in a
133
+ layer overrides the component rules. Some concrete breakages:
134
+
135
+ - `* { padding: 0 }` removes the padding of Button, Badge, ListRow and the fields.
136
+ - A global `input { … }` rule breaks Checkbox, Radio and Switch: each of them lays a
137
+ transparent native `<input>` over its visual control with `absolute`, a size utility and
138
+ `opacity-0`, and an unlayered `input` rule that sets position, size or opacity wins over
139
+ those utilities.
140
+ - `a { … }` takes the underline handling and the colour transition of TextLink;
141
+ `h1, h2, h3 { line-height }` changes the line height of Heading.
142
+
143
+ Put such rules in a layer declared before `fods`, as `reset` in the recipe without
144
+ Tailwind. The order is already declared by the stylesheet imported first, so the app's
145
+ stylesheet only fills the layer:
146
+
147
+ ```css
148
+ @layer reset {
149
+ * { margin: 0; padding: 0; box-sizing: border-box; }
150
+ }
151
+ ```
152
+
153
+ Or keep them off the components with `:not([data-fods-part], [data-fods-part] *)`, the
154
+ selector the package's own reset is scoped by. `:not([data-fods-part])` alone is not enough:
155
+ not every element inside a component carries the attribute (the native `<input>` of
156
+ Checkbox, Radio and Switch does not).
157
+
158
+ **With `!important` the order turns around: an earlier layer wins**, and important
159
+ declarations in any layer win over important unlayered ones. TextLink sets its colours with
160
+ `!important` utilities, so unlayered CSS of the app cannot recolour a TextLink, not even
161
+ with `!important`, and neither can a layer declared after the one the utilities are in;
162
+ use the `variant` and `surface` props instead. Its
163
+ normal (non-important) declarations, such as the transition and `no-underline` on the link,
164
+ still lose to any unlayered `a { … }` rule of the app.
165
+
166
+ ### The `data-fods-*` attributes
167
+
168
+ The components mark their root with `data-fods-component` and their named parts with
169
+ `data-fods-part`. Both are public: select by them to keep your own rules off the
170
+ components, as above, or to find a component in a test. Do not style the components
171
+ through them. The look of a part comes from its props; a rule of the app that targets
172
+ `[data-fods-part]` is an override the package cannot see, and `fods-lint --consumer` fails
173
+ on it. Inside `:not(…)`, as in the selector above, the attribute only excludes and is
174
+ allowed.
175
+
176
+ ### No preflight: what a component sets and what it inherits
177
+
178
+ The package does not ship Tailwind's preflight, which would restyle the whole page. Instead
179
+ `fods.base` holds a reset scoped to `[data-fods-part]` and its descendants, wrapped in
180
+ `:where()` so its specificity is zero: any utility class and any rule of yours wins. It sets
181
+ `box-sizing`, zero margin and padding, `border: 0 solid`, and takes the native look off
182
+ buttons, inputs, links, headings and lists inside a component.
183
+
184
+ - **Set by the component:** the font family (`--font-body`, and the font smoothing) on every
185
+ component root, and the regular weight (`--font-weight-normal`) on the outermost FODS
186
+ element only, so a component nested in another still inherits the weight of the part it
187
+ sits in. Heading, Display and other parts with their own face set it with a utility, which
188
+ wins.
189
+ - **Set by the text styles:** `letter-spacing` on every part that carries a text style.
190
+ Headings and Display carry it in their utility; Body text tracks per weight (Regular
191
+ +0.35 %, Semibold −0.88 % of the font size), written as zero-specificity rules in
192
+ `shared.css`, so a rule of your own on the element still wins.
193
+ - **Inherited from your page:** line height where a part does not set its own,
194
+ `text-transform` and `font-style`. A page with a large `line-height` on `body` makes the
195
+ components that do not set their own taller.
196
+ - **TextLink is left out of both rules on purpose:** a link inside a sentence keeps the
197
+ weight and the font smoothing of that sentence.
198
+
199
+ ## Moving a hand-made button to Button
200
+
201
+ The variant names do not follow the token names. `variant="primary"` of Button and
202
+ IconButton is the blue in-app default, drawn with `--secondary-solid`. The orange fill,
203
+ drawn with `--primary-solid`, is `variant="brand"`. A hand-made orange button therefore maps
204
+ to `brand`, not to `primary`; when each of the two belongs is on the Button docs page.
205
+
206
+ Expect the swap to be visible. Padding, corner radius, border and height of Button come
207
+ from the design tokens and usually differ from a hand-made button: a button can get
208
+ narrower, its corners smaller, a 1 px border can appear. That is the design system's look,
209
+ not a regression; do not restore the old look with CSS. If a size does not fit a layout,
210
+ pick another `size`.
211
+
212
+ ## Providers
213
+
214
+ Mount `FodsProvider` once per React root, around everything that renders a FODS component.
215
+ It is the first and normally the only provider step:
216
+
217
+ ```tsx
218
+ import { FodsProvider } from '@invoiceonline/ui-react';
219
+
220
+ export default function RootLayout({ children }: { children: React.ReactNode }) {
221
+ return (
222
+ <html lang="cs">
223
+ <body>
224
+ <FodsProvider>{children}</FodsProvider>
225
+ </body>
226
+ </html>
227
+ );
228
+ }
229
+ ```
230
+
231
+ Without it:
232
+
233
+ - **These throw** (`` `Tooltip` must be used within `TooltipProvider` ``), because they
234
+ render a Tooltip: `Tooltip` (except its `toggletip` mode) and `TooltipRoot`, `Chip` with `info`, `Switch`
235
+ with `infoIcon`, every `ColumnHeader`, `StatusSummaryBar`, an `ActionRow` whose `badge`
236
+ has a `tooltip` (desktop), a `FilterChip` whose `value` collapses to `+N`, and a
237
+ `FilterFacet` with `multiple` once two or more values are applied (through that
238
+ FilterChip). `Table` mounts its own
239
+ `TooltipProvider` and works without it.
240
+ - **These carets turn even under reduced motion:** the open / closed caret of
241
+ `SplitButton`, `ButtonGroupItem` with `caret`, `DropdownButton`, `SelectField` (and
242
+ `Select`), `ComboboxField` (and `Combobox`), `FilterChip` (and `FilterFacet`), `FAQ`,
243
+ `FormBlock`, `StatusSummaryBar` and the mobile layout of `Table`. The caret does not read
244
+ the setting itself.
245
+
246
+ The provider does nothing else. The other animations follow the user's
247
+ reduced-motion setting on their own: the Motion-driven ones (Modal, Drawer, Alert, Tooltip,
248
+ Switch, CardSelect, FAQ and FormBlock content, the mobile bottom sheets…) read it through
249
+ Motion's `useReducedMotion` or a `prefers-reduced-motion` query, and the CSS ones through
250
+ `prefers-reduced-motion`. Under it each one stops, is reduced or keeps running as the
251
+ `motion` block of its manifest says (the floating label of `Field` stops, Skeleton and
252
+ ProgressBar switch to a reduced form, the spinner of a loading Button keeps turning).
253
+
254
+ What it contains, and when to mount those providers yourself:
255
+
256
+ - **`TooltipProvider`.** `Tooltip` is built on Radix Tooltip, whose root needs the
257
+ provider above it; the `toggletip` mode does not read it. The package's
258
+ `TooltipProvider` sets the shared open delay. It stays exported: mount it yourself, below
259
+ `FodsProvider`, only to pass another `delayDuration` to part of the app; the nearest
260
+ provider wins.
261
+ - **`MotionConfig reducedMotion="user"`** (from `motion`, a dependency of the package)
262
+ drops transform animation under reduced motion, which is what stops the carets above.
263
+ `FodsProvider` imports `motion/react` from the package's own dependency, so the app needs
264
+ no `motion` dependency for it. Mount a `MotionConfig` of your own only for other Motion
265
+ settings; it reaches the components only when the app resolves the same copy of `motion`
266
+ as the package, because Motion's context belongs to the copy that creates it.
267
+
268
+ ## Portals
269
+
270
+ Several components render outside their place in the DOM:
271
+
272
+ - `Modal`, `Drawer` and the mobile bottom sheet of `Menu`, `Select`, `Combobox`,
273
+ `FilterFacet` and `SubjectLookupField` are Radix dialogs portalled to `document.body`.
274
+ - The bubble of `Tooltip` is portalled to `document.body`.
275
+ - The floating panels (`AnchoredPanel`, and the desktop panels of `Menu`, `Select`,
276
+ `Combobox`, `FilterFacet`, `SubjectLookupField`, `DateField`, `FieldPair` and the column
277
+ settings of `Table`) and the `toggletip` bubble portal into the enclosing `Modal` or
278
+ `Drawer` when their trigger sits inside one, and to `document.body` otherwise. Inside a
279
+ dialog they have to, to stay inside its focus trap.
280
+
281
+ To portal into another element than `document.body` (an island whose styles are scoped to
282
+ a class, an element inside a shadow root), provide that element through `PortalContainerContext`. Every
283
+ portal above reads it; the panels inside a `Modal` or `Drawer` still go into the dialog.
284
+
285
+ ```tsx
286
+ import { PortalContainerContext } from '@invoiceonline/ui-react';
287
+
288
+ <PortalContainerContext.Provider value={islandElement}>{children}</PortalContainerContext.Provider>
289
+ ```
290
+
291
+ ## Assets
292
+
293
+ The components ship no illustrations. A component that shows one takes it from the app as a
294
+ React element (`<img src={…} alt="" />` of the app's own file, or an inline SVG) and keeps
295
+ only the box: its size, position and clipping. The box is hidden from screen readers, so an
296
+ `<img>` takes `alt=""`; the component's own text carries the message.
297
+
298
+ | Component | Prop | Picture |
299
+ |---|---|---|
300
+ | FormSection (`header="h3"`), FormBlock | `illustration` | an `Illustration / Section` picture |
301
+ | Banner (`person`, `invoice`) | `character` (person only), `invoiceIllustration` `{ left, right }` | the character and the two invoice sheets |
302
+ | Table | `emptyState.illustration` | an `Illustration / Big` picture for the empty-state kind |
303
+
304
+ Which picture goes where is in the component's docs page and in the spec of the
305
+ illustrations.
306
+
307
+ Two components draw a picture from the stylesheet as part of their look: the component
308
+ carries a class and the `url()` sits in `styles.css` and `shared.css`, pointing at
309
+ `./assets/…`, which the package publishes in `dist/assets/`.
310
+
311
+ - PromoSurface: the pattern tile (`pattern-dark.svg`).
312
+ - PromoSticker: the brush (`label-brush-1.svg`).
313
+
314
+ How to load them:
315
+
316
+ - Import the stylesheet through a bundler that resolves `url()` in imported CSS. Vite does
317
+ it with and without `@tailwindcss/vite`, and so does Next.js 16 in both style modes (with
318
+ `@tailwindcss/postcss` in the mode with Tailwind): the files are copied into the build
319
+ output and the `url()` is rewritten.
320
+ - The Tailwind CLI does not: it leaves `url('./assets/…')` relative to its output file, so
321
+ the files 404 unless `dist/assets/` is copied next to that output. The same happens when
322
+ `styles.css` alone is copied into a public folder.
323
+ - Served from another origin (a CDN or an asset host), the brush needs an
324
+ `Access-Control-Allow-Origin` header: it is a CSS mask, which the browser loads in CORS
325
+ mode, so without the header the brush disappears and the sticker's white text sits on a
326
+ white page. The pattern tile is a background image and is not affected.
327
+
328
+ ## Server components (Next.js App Router)
329
+
330
+ Every component file starts with `"use client"`, and the directive is kept per file in
331
+ `dist/`, so a server component can import and render the components directly; each one
332
+ becomes a client component at that point. What a server component passes to them has to be
333
+ serialisable, so event handlers (`onClick`, `onCheckedChange`…), render functions and the
334
+ `columns` of `Table` (they hold `cell` renderers) live in a client component of your own.
335
+ `FodsProvider` starts with `"use client"` as well, so a server layout renders it directly,
336
+ as in the example. Values that a component file exports next to its component
337
+ (`buttonVariants`, `textLinkVariants`…) are client references in a server component and
338
+ cannot be called or read there.
339
+
340
+ ## Texts and locale
341
+
342
+ The package has no translations: user-facing texts come in through props. The props below
343
+ are optional and default to Czech. **An app with more than one language version passes every one of them from its translations, on
344
+ every use**; otherwise a page in another language shows or announces Czech.
345
+
346
+ | Component | Prop | Czech default | When it renders |
347
+ |---|---|---|---|
348
+ | `Modal` | `closeLabel` | «Zavřít» | name of the close control, whenever it is shown |
349
+ | `Menu`, `Select`, `Combobox`, `FilterFacet`, `SubjectLookupField` | `sheetCloseLabel` | «Zavřít» | visually hidden close button of the mobile bottom sheet, first focus stop |
350
+ | `FilterFacet` (`multiple`) | `doneLabel` | «Hotovo» | the closing button in the footer of the mobile bottom sheet |
351
+ | `Pagination` | every key of `labels` | «Stránkování», «Předchozí», «Další», «Stránka», «Další stránky» | always |
352
+ | `Table` | `loadedLabel` | «Načteno» | announced to screen readers when a `loading` ends |
353
+ | `Table` | `mobile.moreLabel` | «Více» | the more-actions dropdown of the mobile layout |
354
+ | `FileUpload` | `triggerLabel`, `dropHintText` | «Nahrajte svůj soubor», « nebo jej sem přetáhněte» | the prompt sentence of the empty drop-zone |
355
+ | `FileUpload` | `viewLabel`, `removeLabel` | «Zobrazit», «Odebrat» | name prefix of the row actions, composed with the filename |
356
+ | `FileUpload` | `uploadingLabel` | «Nahrávání souboru» | name of the progress bar, announced when an upload starts |
357
+
358
+ Some of them never show in a visual check: `loadedLabel`, Modal `closeLabel`, the
359
+ `nav`, `page` and `morePages` keys of Pagination `labels`, and FileUpload `viewLabel`,
360
+ `removeLabel` and `uploadingLabel` are only announced, and
361
+ `sheetCloseLabel` shows only while it has keyboard focus. Check them in code review.
362
+
363
+ Number and date formatting default to Czech as well: `locale` is `'cs'` on `NumberField`,
364
+ `UnitField`, `FieldPair`, `ItemRow` and `FilterChip`, and the `cs` locale of date-fns on
365
+ `DatePicker`, `DateField` and a `FieldPair` in date mode (there the prop is `dateLocale`):
366
+ weekday names, month caption, week start.
367
+
368
+ ## Known gaps
369
+
370
+ - **SplitButton and Menu.** `Menu` takes its `trigger` (a `ButtonGroupItem` with `caret`
371
+ or an icon-only one, a `DropdownButton` or an `IconButton`) and wires the open state, the keyboard,
372
+ `aria-controls` and the return of focus by cloning it with a `ref`. `SplitButton` cannot
373
+ be that trigger: its `ref` goes to the main half and its other props to the container.
374
+ Its trigger half keeps the open state itself (click toggles, ArrowDown opens, Escape
375
+ closes; `open`, `defaultOpen`, `onOpenChange` to control it) and renders no menu; render
376
+ the panel from `open` / `onOpenChange`. The trigger half takes no `ref` or
377
+ `aria-controls` from you.
378
+ - **Not every FODS component is in the package.** `llms.txt` lists the ones that are; a
379
+ component that is not there (Breadcrumbs, Toast…) is missing.
@@ -0,0 +1,78 @@
1
+ import { Meta } from '@storybook/addon-docs/blocks';
2
+
3
+ <Meta title="Getting Started/Contributing" />
4
+
5
+ # Contributing
6
+
7
+ For a person who changes a component of this package. The package is built in the design
8
+ system repository, in `packages/react`; the full path of a change, with its roles and
9
+ commands, is `docs/react/manifest-to-code.md` there. This page is the short version.
10
+
11
+ ## Where a change starts
12
+
13
+ A component is specified before it is coded. Its manifest
14
+ (`spec/<layer>/<name>.manifest.json`) holds the variants, sizes, states and the token of every
15
+ part; the component `.md` beside it holds the prose. The code follows the manifest, never the
16
+ other way round, and never a Figma frame directly. When the manifest and the code disagree and
17
+ the code is not simply wrong, the question goes back to the spec owner.
18
+
19
+ ## What one component is
20
+
21
+ One folder, `src/components/<folder>/`:
22
+
23
+ - `<Name>.tsx` — the component. Tokens reach it only through the theme-mapped utility classes;
24
+ no colour, spacing, radius, duration or easing is written as a literal.
25
+ - `<Name>.test.tsx` — roles, accessible names and ARIA state, not implementation.
26
+ - `<Name>.stories.tsx` — the stories named in
27
+ [Introduction](?path=/docs/getting-started-introduction--docs).
28
+ - `<Name>.mdx` — the docs page. Every factual sentence is provable in the code, the stories or
29
+ the manifest.
30
+ - `index.ts` — the folder's exports. The package root and the `exports` map are generated
31
+ from it.
32
+
33
+ ## Definition of Done
34
+
35
+ A component is done when all of these hold, not when it renders:
36
+
37
+ 1. **Matrix.** A Matrix story renders every combination of the manifest's axes, and a
38
+ Playground story has a control for every prop.
39
+ 2. **States.** Default, hover, active, focus and disabled (and loading, where the manifest has
40
+ it) are shown or reachable without a cursor.
41
+ 3. **Bindings.** Every colour, border and size on screen resolves to the token the manifest
42
+ names for that part and state.
43
+ 4. **Acceptance in Storybook.** The spec owner has reviewed the component in the Storybook
44
+ preview of the pull request and approved the pull request.
45
+ 5. **Manifest version.** The Metadata block of the docs page states the manifest version the
46
+ component was built against.
47
+ 6. **Migration first.** A migration the manifest requires is applied before any other change.
48
+
49
+ ## Gates
50
+
51
+ Run from the repository root; CI runs the same ones on every pull request.
52
+
53
+ ```bash
54
+ npm run generate:check -w @invoiceonline/ui-react # generated files are up to date
55
+ npm run lint -w @invoiceonline/ui-react
56
+ npm run typecheck -w @invoiceonline/ui-react
57
+ npm run test -w @invoiceonline/ui-react # unit tests
58
+ npm run test:stories -w @invoiceonline/ui-react # every story in headless Chromium, with the a11y checks
59
+ npm run check:manifest-versions -w @invoiceonline/ui-react # a changed component states its manifest version
60
+ npm run build -w @invoiceonline/ui-react
61
+ npm run check:classes -w @invoiceonline/ui-react # every utility class has CSS (after build)
62
+ npm run build-storybook -w @invoiceonline/ui-react
63
+ npm run check:story-ids -w @invoiceonline/ui-react # the Storybook IDs the manifests name exist (after build-storybook)
64
+ npm run check:package -w @invoiceonline/ui-react # package shape, nothing internal in the published files
65
+ ```
66
+
67
+ CI also compares every component with its manifest, from the sources and in the built
68
+ Storybook: the recorded version, the token of every part, the stories against the axes and
69
+ the tokens the docs page lists.
70
+
71
+ ## Before the pull request
72
+
73
+ - A change under `src/` carries a changeset (`.changeset/*.md`): `patch` for a change inside
74
+ the existing API, `minor` for a new variant, size, state, slot or prop, and a breaking change
75
+ with a `### Migration` section in its body.
76
+ - After a change of exports, tokens or the theme: `npm run generate -w @invoiceonline/ui-react`.
77
+ Generated files (`*.generated.*`, `src/index.ts`, `llms.txt`) are never edited by hand.
78
+ - The docs page moves with the code in the same pull request.
@@ -0,0 +1,53 @@
1
+ import { Meta } from '@storybook/addon-docs/blocks';
2
+
3
+ <Meta title="Getting Started/For AI agents" />
4
+
5
+ # For AI agents
6
+
7
+ How an AI agent reads this package, in an app that installs it or from this Storybook.
8
+
9
+ ## Where the docs are in the tarball
10
+
11
+ The published package (`node_modules/@invoiceonline/ui-react/`) ships `dist/`, `src/` without
12
+ the tests, `docs/`, `AGENTS.md`, `llms.txt` and `CHANGELOG.md`.
13
+
14
+ - `llms.txt` — every component with its import, its exports, a one-line summary and its
15
+ Storybook docs ID. Generated with the package; start here.
16
+ - `AGENTS.md` — the rules for an agent working in an app that uses the package (imports,
17
+ styles, providers, portals, texts, missing components). `llms.txt` copies the same bullets.
18
+ - `docs/Consuming.mdx` — the consumer guide; `docs/Introduction.mdx` — how to read this
19
+ Storybook; `docs/Contributing.mdx` — how a component of the package is built and accepted.
20
+ - `src/components/<folder>/<Name>.mdx` — the docs page of one component;
21
+ `<Name>.stories.tsx` the working examples; `<Name>.tsx` the props with their JSDoc. Types
22
+ are in `dist/**/*.d.ts`.
23
+
24
+ ## The MCP server of this Storybook
25
+
26
+ The Storybook runs `@storybook/addon-mcp` with the components manifest switched on
27
+ (`features.componentsManifest`). The dev server (`npm run storybook`) serves an MCP endpoint at
28
+ `/mcp` that lists the components, their props and their stories, so an agent can query the
29
+ manifest instead of reading the sources; a static build carries only the manifest files.
30
+
31
+ ## How a docs ID is derived
32
+
33
+ A component's docs ID is the stories `title` in lowercase with every run of other characters
34
+ replaced by one hyphen, plus `--docs`: `Design System/Atoms/Button` → `design-system-atoms-button--docs`.
35
+ A story ID takes the export name split at its capitals (`FiveStatuses` → `five-statuses`) in place
36
+ of `docs`. The titles are pinned:
37
+ each component's manifest records its docs ID, so a title never changes on its own.
38
+
39
+ ## What on a docs page is evidence-bound
40
+
41
+ Every factual sentence of a component docs page is verifiable against one of three files: the
42
+ component's `<Name>.tsx`, its `<Name>.stories.tsx` or its manifest. Overview and Rationale
43
+ carry intent; Anatomy, Variants, Sizes, States, API, Accessibility and Usage describe the code
44
+ as it is. **Tokens used** is traced by hand from the classes of the component. **Migration
45
+ notes** record manifest version → version changes, never the history of any app.
46
+
47
+ ## How to read Controls
48
+
49
+ The **API** section renders Storybook's Controls table from the TypeScript types and the JSDoc
50
+ of the props (`react-docgen-typescript`, props of dependencies filtered out). A prop marked
51
+ *Story-only* in its description belongs to the story's render, not to the component. The
52
+ default texts are Czech; an app with another language passes every text through the props
53
+ listed in Consuming → Texts and locale.
@@ -0,0 +1,54 @@
1
+ import { Meta } from '@storybook/addon-docs/blocks';
2
+
3
+ <Meta title="Getting Started/Introduction" />
4
+
5
+ # Introduction
6
+
7
+ This Storybook documents `@invoiceonline/ui-react`: the React components of FODS, the
8
+ FakturaOnline design system, built on the design tokens the package ships. It is the
9
+ acceptance point of every component and the reference for the apps that install the package.
10
+
11
+ ## How the sidebar reads
12
+
13
+ - **Getting Started** — this page, [Consuming](?path=/docs/getting-started-consuming--docs)
14
+ (styles, providers, portals, texts and locale) and
15
+ [For AI agents](?path=/docs/getting-started-for-ai-agents--docs).
16
+ - **Foundations** — the tokens: colours, type, spacing, sizes, radius and borders, elevation,
17
+ layout, motion. The tables are generated from the tokens the package ships.
18
+ - **Design System** — the components, one group per spec layer: Atoms, Molecules, Organisms,
19
+ Patterns. Each component has a **Docs** page first, then its stories.
20
+ - **Changelog** — the releases of the package and of the tokens, plus the pending changesets.
21
+
22
+ ## Story conventions
23
+
24
+ A component's stories follow the same names, so the sidebar reads the same everywhere:
25
+
26
+ - **Playground** — the interactive story with a control for every prop.
27
+ - **Matrix** — the full grid of the manifest's axes (variant × size × state), the way the
28
+ Figma labelled grid lays it out.
29
+ - **States** — the interaction states (default, hover, active, focus, disabled, loading) shown
30
+ statically, so a reviewer sees them without a cursor.
31
+ - **Sizes** — one row per size, where the component has a size axis.
32
+ - **Motion** — what animates and how it behaves under reduced motion.
33
+ - **Compositions** and **Recipes** — the component inside the pattern it belongs to, on sample
34
+ data.
35
+ - **Viewport ·** stories render at one real width (a breakpoint band or the 390 mobile
36
+ reference) because a docs canvas always sits in a desktop viewport.
37
+
38
+ Sample texts are Czech, the language of the package defaults, and fictitious: companies,
39
+ addresses, e-mails and links name no real business and no real app. The toolbar backgrounds
40
+ `light`, `secondary` and `dark` are the three page surfaces of the tokens.
41
+
42
+ ## The Metadata block of a docs page
43
+
44
+ Every component docs page opens with the same bullet list:
45
+
46
+ - **Layer** and **Status** — the spec layer and the delivery state of the component.
47
+ - **Tokens used** — the semantic tokens the component binds, traced from its classes by hand.
48
+ - **Manifest version** — the version of the component's manifest the code was built against.
49
+ A later MINOR or MAJOR manifest version re-opens the component until the stories pass against
50
+ it again; a PATCH never does.
51
+
52
+ Everything else on a docs page is provable against the component's source, its stories or its
53
+ manifest; the Migration notes record manifest version → version changes, never the history of any
54
+ app.