@invoiceonline/ui-react 0.0.0 → 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 +77 -1
  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 +351 -3
  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
package/llms.txt ADDED
@@ -0,0 +1,556 @@
1
+ # @invoiceonline/ui-react
2
+
3
+ > React components of FODS, the FakturaOnline design system, with the design tokens they are built on. ESM only, React 19.
4
+
5
+ Generated by scripts/sync-exports.mjs. Do not edit: run `npm run generate -w @invoiceonline/ui-react`.
6
+
7
+ ## Docs in this package
8
+
9
+ - `README.md`: install, styles, a first component.
10
+ - `docs/Introduction.mdx`: how to read the Storybook of the package (sidebar, story conventions, the Metadata block of a docs page).
11
+ - `docs/Consuming.mdx`: the consumer guide (styles, cascade layers, providers, portals, assets, server components, texts and locale, known gaps). Read it before wiring the package into an app.
12
+ - `docs/ForAgents.mdx`: where the agent docs are in the tarball, the MCP addon of the Storybook, how a docs ID is derived.
13
+ - `AGENTS.md`: rules for an AI agent working in an app that uses the package.
14
+ - `src/components/<folder>/`: per component the MDX docs page, the stories and the source with its JSDoc. Types: `dist/**/*.d.ts`.
15
+
16
+ ## Rules
17
+
18
+ Copied from `AGENTS.md` → Rules, the single source; a change goes there.
19
+
20
+ - **Imports:** only `@invoiceonline/ui-react`, `@invoiceonline/ui-react/<folder>`,
21
+ `@invoiceonline/ui-react/tokens` (the tokens as JS: `primitives`, `semantic`, `springs`,
22
+ `curves`) and the CSS entries `tokens.css`, `styles.css`, `theme.css`, `shared.css`. Never
23
+ import a `dist/…` or `src/…` path, or anything else not in the `exports` of
24
+ `package.json`: it is private and may move in any release.
25
+ - **Tokens come from this package only.** Do not add `@invoiceonline/ui-system` to the app:
26
+ its `tokens.css` can be from another commit than the components and their theme.
27
+ - **Styles:** one mode only, as in `docs/Consuming.mdx`. Without Tailwind: `tokens.css`
28
+ then `styles.css`. With Tailwind 4: `theme.css`, `shared.css` and `@source` on the
29
+ package `dist/`, never `styles.css` as well. The `@layer` declaration goes first; without
30
+ Tailwind it sits in a stylesheet of its own, imported before the package imports (in the
31
+ same file a bundler can emit the imports ahead of it and the app's reset then wins).
32
+ `theme.css` replaces the app's Tailwind theme (`--*: initial`): after it `gap-4` or
33
+ `text-sm` produce no CSS anywhere in the app, so do not add it to an app that uses
34
+ Tailwind's default scale.
35
+ - **Do not restyle components from global CSS.** The package's rules are in
36
+ `@layer fods.base` and `@layer fods.utilities`; any unlayered rule of the app beats them
37
+ whatever its specificity. Put a global reset (`* { padding: 0 }`, `input { … }`,
38
+ `a { … }`) in a layer declared before `fods`, or scope it with
39
+ `:not([data-fods-part], [data-fods-part] *)`. Change a component through its props
40
+ (`variant`, `size`…), not by overriding its classes.
41
+ - **No preflight is shipped.** A component sets its font family and the regular weight on
42
+ its outermost element; line height, letter spacing, text transform and font style come
43
+ from the page. TextLink keeps the weight and font smoothing of its sentence.
44
+ - **Fonts are not shipped:** the app loads Inter (`--font-body`), Poppins (`--font-heading`)
45
+ and Caveat (`--font-decorative`, the pointer label of ProgressBar and the `kicker` of
46
+ HeadingGroup and Hero).
47
+ - **Button colours:** `variant="primary"` of Button and IconButton is the blue in-app
48
+ default; the orange fill is `variant="brand"`. A hand-made button on `--primary-solid`
49
+ maps to `brand`, not `primary`. When to use which: the Button docs page.
50
+ - **Providers:** `FodsProvider` once per React root, in every app, around everything that
51
+ renders a FODS component. Without it every component that renders a Tooltip throws (Table
52
+ mounts its own provider) and the open / closed carets turn even under reduced motion; both
53
+ lists are in `docs/Consuming.mdx` → Providers. The app needs no `motion` dependency for it.
54
+ Mount `TooltipProvider` (exported here) or `MotionConfig` (from `motion/react`) yourself only
55
+ for other settings, below `FodsProvider`; the nearest provider wins. A `MotionConfig` of the
56
+ app's own needs `motion` in the app's dependencies and reaches the components only when it
57
+ resolves the same copy of `motion` as the package.
58
+ - **Portals:** Modal, Drawer, the mobile bottom sheets and the Tooltip bubble portal to
59
+ `document.body`; the desktop floating panels (AnchoredPanel, Menu, Select, Combobox,
60
+ DateField…) and the toggletip bubble go into the enclosing Modal or Drawer, else
61
+ `document.body`. To portal elsewhere, provide the element through `PortalContainerContext`.
62
+ - **Assets:** `dist/assets/` travels with `styles.css` / `shared.css` (`url()` relative to
63
+ the stylesheet); only PromoSurface (a background image) and PromoSticker (a CSS mask, CORS
64
+ header needed from another origin) draw from it. The components ship no pictures: the app
65
+ passes its own as React elements (`<img src={…} alt="" />` or an inline SVG) to
66
+ `illustration` of FormSection (`header="h3"`) and FormBlock, `character` and
67
+ `invoiceIllustration` `{ left, right }` of Banner, and `emptyState.illustration` of Table.
68
+ The component owns the box and hides it from assistive technology.
69
+ - **Server components:** every component file starts with `"use client"`; import components
70
+ into Next.js server components as leaf client components. Props must be serialisable
71
+ there: handlers and the `columns` of Table belong in a client component. Non-component
72
+ exports of component files (`buttonVariants`…) cannot be called in a server component.
73
+ - **Texts:** the package has no translations. Texts come through props; some have a Czech
74
+ default (Modal `closeLabel`, Pagination `labels`, Table `loadedLabel` and
75
+ `mobile.moreLabel`, FilterFacet `doneLabel`, FileUpload `triggerLabel`, `dropHintText`,
76
+ `viewLabel`, `removeLabel` and `uploadingLabel`), and number and date formatting defaults
77
+ to Czech (`locale` of NumberField, UnitField, FieldPair, ItemRow, FilterChip, DatePicker,
78
+ DateField; `dateLocale` of a date FieldPair). The hidden close button of the mobile bottom
79
+ sheets defaults to «Zavřít»; Menu, Select, Combobox, FilterFacet and SubjectLookupField
80
+ take its name in `sheetCloseLabel`. An app with more than one language version passes
81
+ every one of these from its translations on every use, including the screen-reader-only
82
+ `loadedLabel`, `sheetCloseLabel` and the FileUpload action and progress names. Full table:
83
+ `docs/Consuming.mdx` → Texts and locale.
84
+ - **Table:** `SortingState`, `RowSelectionState` and `ColumnVisibilityState` come from
85
+ `@tanstack/react-table`, a peer dependency the package does not re-export: keep it in
86
+ the app's dependencies in the package's range and import the types from there.
87
+ - **Missing components:** `llms.txt` lists every component of the package; a FODS
88
+ component that is not there (Breadcrumbs, Toast…) is missing. Do not build a look-alike
89
+ from FODS parts and do not copy one from another library: tell the user the component is
90
+ missing. Menu wires a ButtonGroupItem with `caret` or an icon-only one, a DropdownButton
91
+ or an IconButton as its `trigger`; it cannot take a SplitButton, whose menu panel the app
92
+ renders from `open` / `onOpenChange`.
93
+ - **No hardcoded values** for colour, spacing, radius or type next to the components: use
94
+ the CSS variables of `@invoiceonline/ui-react/tokens.css` (in JS:
95
+ `@invoiceonline/ui-react/tokens`).
96
+
97
+ ## Components
98
+
99
+ ### ActionRow
100
+
101
+ - Import: `import { ActionRow } from '@invoiceonline/ui-react'` or `from '@invoiceonline/ui-react/action-row'`
102
+ - Exports: `ActionRow`, `actionRowVariants`
103
+ - Summary: Firm row in the account menu — one row per firm; selecting a row switches the active firm.
104
+ - When to use: Use inside the account menu to list and switch firms — one row per firm, selecting a row switches the active firm (Show avatar on: Firm Avatar Size=sm, Fill follows State — Solid on Selected, Subtle otherwise). Also used for manageable-entity rows (bank accounts, units) on a management surface — there use Show leading with an entity glyph instead of the avatar. NOT a listbox option and NOT a ListRow — its inner button (a real <button>, not the row element) holds real DOM focus via roving tabindex, with the action icons as its siblings, so reach for it only where a row must both navigate and be acted on.
105
+ - Docs: `src/components/action-row/ActionRow.mdx`, examples in `ActionRow.stories.tsx`, props in `ActionRow.tsx`; Storybook docs ID `design-system-atoms-actionrow--docs`
106
+
107
+ ### Alert
108
+
109
+ - Import: `import { Alert } from '@invoiceonline/ui-react'` or `from '@invoiceonline/ui-react/alert'`
110
+ - Exports: `Alert`, `AlertActionLink`, `AlertActionHelper`, `alertVariants`, `ALERT_STATUS_ICONS`
111
+ - Summary: Contextual in-flow notice — a tinted status callout with icon, message and an optional action row (link, buttons, helper text).
112
+ - When to use: Reach for it to flag a consequence or heads-up tied to what the user is doing right now — inside a form, step or section (invoice storno, NIP change, VAT-mode switch). Lives only inside content — never as a strip under the nav bar. FODS has no separate Message component: Alert is it. NOT for global/app-level strips (Status Bar), transient action feedback (Toast), or field-level validation text (lives on the field). Persistent — it stays while relevant and is never user-dismissible (no close affordance). Not in this release: Status Bar, Toast.
113
+ - Docs: `src/components/alert/Alert.mdx`, examples in `Alert.stories.tsx`, props in `Alert.tsx`; Storybook docs ID `design-system-molecules-alert--docs`
114
+
115
+ ### AnchoredPanel
116
+
117
+ - Import: `import { AnchoredPanel } from '@invoiceonline/ui-react'` or `from '@invoiceonline/ui-react/anchored-panel'`
118
+ - Exports: `AnchoredPanel`, `AnchoredPanelGroup`, `useAnchoredPanel`
119
+ - Summary: No manifest in the FODS spec; the MDX page and the source are the reference.
120
+ - Docs: `src/components/anchored-panel/AnchoredPanel.mdx`, examples in `AnchoredPanel.stories.tsx`, props in `AnchoredPanel.tsx`; Storybook docs ID `design-system-patterns-anchored-panel--docs`
121
+
122
+ ### Badge
123
+
124
+ - Import: `import { Badge } from '@invoiceonline/ui-react'` or `from '@invoiceonline/ui-react/badge'`
125
+ - Exports: `Badge`, `badgeVariants`, `BADGE_STATUS_ICONS`
126
+ - Summary: Read-only status indicator — a soft or solid pill with an optional leading icon.
127
+ - When to use: Show the read-only status or category of a record — invoice state, payment status, plan tier. NOT for actions or selection (use Button / Chip). A count (a number on a tab, a filter, a menu item) takes Shape = Round; a bare number outside such a host is plain text.
128
+ - Docs: `src/components/badge/Badge.mdx`, examples in `Badge.stories.tsx`, props in `Badge.tsx`; Storybook docs ID `design-system-atoms-badge--docs`
129
+
130
+ ### Banner
131
+
132
+ - Import: `import { Banner } from '@invoiceonline/ui-react'` or `from '@invoiceonline/ui-react/banner'`
133
+ - Exports: `Banner`, `BannerAction`, `bannerVariants`
134
+ - Summary: Promotional panel for FO public pages — Person, Invoice or Mini artwork on a Promo Surface, with an Actions slot.
135
+ - When to use: Reach for Banner when a public page needs a promotional panel: a pitch beside a character (Person), a pitch over an invoice (Invoice), or a one-line call to action inside an article or between sections (Mini). Pick the Composition by how much room the pitch gets, the Surface by the page family, the Breakpoint by the viewport, and fill the Actions slot with the controls the pitch needs. Use Hero instead for the first screen of a page or when the copy needs a kicker, a format icon or a sub strip — Banner only varies its artwork and its actions.
136
+ - Docs: `src/components/banner/Banner.mdx`, examples in `Banner.stories.tsx`, props in `Banner.tsx`; Storybook docs ID `design-system-organisms-banner--docs`
137
+
138
+ ### Button
139
+
140
+ - Import: `import { Button } from '@invoiceonline/ui-react'` or `from '@invoiceonline/ui-react/button'`
141
+ - Exports: `Button`, `buttonVariants`
142
+ - Summary: The primary control for triggering an action — always labelled; icon-only actions use the Icon Button.
143
+ - When to use: Use to trigger an action (submit, save, cancel, delete). Always carries a label — for an icon-only action use the Icon Button, for a label + menu the Dropdown / Split Button. Pick the family by intent, the size by density, and let state follow interaction.
144
+ - Docs: `src/components/button/Button.mdx`, examples in `Button.stories.tsx`, props in `Button.tsx`; Storybook docs ID `design-system-atoms-button--docs`
145
+
146
+ ### ButtonGroup
147
+
148
+ - Import: `import { ButtonGroup } from '@invoiceonline/ui-react'` or `from '@invoiceonline/ui-react/button-group'`
149
+ - Exports: `ButtonGroup`, `ButtonGroupItem`, `buttonGroupContainerVariants`, `buttonGroupItemVariants`
150
+ - Summary: A row of related actions fused into one control — N segments divided by 1px gaps.
151
+ - When to use: Use for a small set of peer or mutually-related actions (a toolbar cluster, a segmented action bar). Any cell can be a Label, an Icon, or a menu-opening dropdown segment. Built from Button Segment — colour + metrics inherit from the segment.
152
+ - Docs: `src/components/button-group/ButtonGroup.mdx`, examples in `ButtonGroup.stories.tsx`, props in `ButtonGroup.tsx`; Storybook docs ID `design-system-molecules-buttongroup--docs`
153
+
154
+ ### CardSelect
155
+
156
+ - Import: `import { CardSelect } from '@invoiceonline/ui-react'` or `from '@invoiceonline/ui-react/card-select'`
157
+ - Exports: `CardSelect`, `cardSelectVariants`, `CardSelectGroup`, `CardSelectGroupContext`
158
+ - Summary: A whole-card single-select control — label + subtitle picked by a corner check or a leading radio.
159
+ - When to use: Reach for it when a choice needs more than a bare label to decide — a leading icon or illustration + a one-line description — inside a dialog or wizard step (auth method, 2FA, obrat mode, invoice-correction type, which firm a schránka connects to). For a plain option list use Radio / Checkbox; past ~6 options use a Select; for a choice whose card carries its own action button + benefit list, that is the KSeF comparison-card, a different pattern.
160
+ - Docs: `src/components/card-select/CardSelect.mdx`, examples in `CardSelect.stories.tsx`, props in `CardSelect.tsx`; Storybook docs ID `design-system-atoms-cardselect--docs`
161
+
162
+ ### Checkbox
163
+
164
+ - Import: `import { Checkbox } from '@invoiceonline/ui-react'` or `from '@invoiceonline/ui-react/checkbox'`
165
+ - Exports: `Checkbox`, `checkboxVariants`
166
+ - Summary: Selection control for zero-or-more options — standalone in forms, or the leading indicator in a multi-select row.
167
+ - When to use: Use for choosing zero or more independent options. Standalone (box + inline label) in forms; label-less it drops into a ListRow leading slot for multi-select / filter lists. For a single either/or choice use Radio — a lone checkbox is not a toggle for mutually-exclusive options.
168
+ - Docs: `src/components/checkbox/Checkbox.mdx`, examples in `Checkbox.stories.tsx`, props in `Checkbox.tsx`; Storybook docs ID `design-system-atoms-checkbox--docs`
169
+
170
+ ### Chip
171
+
172
+ - Import: `import { Chip } from '@invoiceonline/ui-react'` or `from '@invoiceonline/ui-react/chip'`
173
+ - Exports: `Chip`, `chipVariants`
174
+ - Summary: Interactive tag — a Basic filter, a Selectable checkbox filter, or a Deleteable × tag, on the status palette.
175
+ - When to use: Reach for it when a tag is INTERACTIVE — a plain filter tag (Basic, e.g. above a table), a status filter the user toggles (Selectable, leading checkbox), or a tag the user dismisses (Deleteable, trailing ×). For read-only status use Badge; for a primary action use Button; for a bare count use a number.
176
+ - Docs: `src/components/chip/Chip.mdx`, examples in `Chip.stories.tsx`, props in `Chip.tsx`; Storybook docs ID `design-system-atoms-chip--docs`
177
+
178
+ ### ColumnHeader
179
+
180
+ - Import: `import { ColumnHeader } from '@invoiceonline/ui-react'` or `from '@invoiceonline/ui-react/column-header'`
181
+ - Exports: `ColumnHeader`, `columnHeaderVariants`
182
+ - Summary: The sortable column header cell that tops every table — a label, an optional description line, and a state-driven sort glyph.
183
+ - When to use: Use as the header cell for each column of a Table. One instance per column: toggle Show sort off for a non-sortable column, toggle Show description on for a secondary clarifying line under the label (e.g. Celkem s DPH / (Celková cena)). It is the only sortable-header affordance — not a general label, not a filter control.
184
+ - Docs: `src/components/column-header/ColumnHeader.mdx`, examples in `ColumnHeader.stories.tsx`, props in `ColumnHeader.tsx`; Storybook docs ID `design-system-atoms-columnheader--docs`
185
+
186
+ ### ComboboxField
187
+
188
+ - Import: `import { ComboboxField } from '@invoiceonline/ui-react'` or `from '@invoiceonline/ui-react/combobox-field'`
189
+ - Exports: `ComboboxField`, `Combobox`
190
+ - Summary: The generic Combobox trigger field on the Text Field shell — type to narrow a set too large to scan, pick to commit one value.
191
+ - When to use: Use as the GENERIC TRIGGER for a type-to-narrow picker over a set too large to scan, where picking commits one plain value into the field. It opens the Combobox / Search or Combobox / Inline overlay. NOT for the ARES subject lookup — the customer (Odběratel) and supplier (Dodavatel) search that queries saved contacts and the registry at once, autofills the identity block and collapses to a summary card is its own molecule (→ Subject Lookup Field). NOT for a scannable fixed set (→ Select Field), free-form text (→ Text Field), or dates (→ Date Picker).
192
+ - Docs: `src/components/combobox-field/ComboboxField.mdx`, examples in `ComboboxField.stories.tsx`, props in `ComboboxField.tsx`; Storybook docs ID `design-system-molecules-comboboxfield--docs`
193
+
194
+ ### DateField
195
+
196
+ - Import: `import { DateField } from '@invoiceonline/ui-react'` or `from '@invoiceonline/ui-react/date-field'`
197
+ - Exports: `DateField`
198
+ - Summary: No manifest in the FODS spec; the MDX page and the source are the reference.
199
+ - Docs: `src/components/date-field/DateField.mdx`, examples in `DateField.stories.tsx`, props in `DateField.tsx`; Storybook docs ID `design-system-molecules-datefield--docs`
200
+
201
+ ### DatePicker
202
+
203
+ - Import: `import { DatePicker } from '@invoiceonline/ui-react'` or `from '@invoiceonline/ui-react/date-picker'`
204
+ - Exports: `DatePicker`
205
+ - Summary: Calendar content for picking a date — single month for one day, dual month for a range; a popover, sheet or drawer hosts it.
206
+ - When to use: Reach for it wherever a date or a date range is picked: the panel a date field opens (invoice issue/due date, expense date), the custom period of a filter, a report window. It is calendar CONTENT, not a container — place it inside a host surface (Popover surface for an anchored panel, a bottom sheet or drawer on mobile); never give it its own border or shadow. NOT an inline always-visible calendar and NOT a month/year jump-list. Two LAYOUT MODES: Single month for one day in a form, Dual month for a range so a range spanning a month boundary is selectable without paging. Selection mode (single date vs start/end range) is the caller's, not the layout's: Single month also hosts a RANGE when a dual panel cannot fit — the narrow/mobile Date range composition (popover-patterns.md § Pattern — Date range).
207
+ - Docs: `src/components/date-picker/DatePicker.mdx`, examples in `DatePicker.stories.tsx`, props in `DatePicker.tsx`; Storybook docs ID `design-system-molecules-datepicker--docs`
208
+
209
+ ### Divider
210
+
211
+ - Import: `import { Divider } from '@invoiceonline/ui-react'` or `from '@invoiceonline/ui-react/divider'`
212
+ - Exports: `Divider`, `dividerVariants`
213
+ - Summary: The system's structural hairline — a full-width 1px rule, optionally carrying a section label.
214
+ - When to use: Reach for it wherever the separator is *one full-bleed 1px rule between two peers*. Two hosts today: a Popover surface — breaking a dropdown panel into sections (plain rule) or titling one (labelled) — and a Table, where the Line variant is every row boundary, the header's closing hairline and the mobile row rules. In a panel it is placed full-width (0 inset) as a sibling of the row groups in the body, breaking out of the 4px group inset; in a table it is a full-width sibling of the rows. The label sits in an opaque --bg-primary mask that notches the rule behind it. Not a spacing device, and not for separators that are not that shape (a card edge, a vertical rule).
215
+ - Docs: `src/components/divider/Divider.mdx`, examples in `Divider.stories.tsx`, props in `Divider.tsx`; Storybook docs ID `design-system-atoms-divider--docs`
216
+
217
+ ### Drawer
218
+
219
+ - Import: `import { Drawer } from '@invoiceonline/ui-react'` or `from '@invoiceonline/ui-react/drawer'`
220
+ - Exports: `Drawer`, `drawerVariants`
221
+ - Summary: Mobile menu chrome — the full-screen open state of the Nav Bar's Menu button; rows mount into Body and Footer.
222
+ - When to use: Use the Drawer Surface for the mobile menu — the full-screen panel the Nav Bar's Menu button opens at every breakpoint where that button renders (LG–Mobile), and the drill-in levels inside it (overlay-behavior.md § Mobile). It is the chrome only: rows mount into the Body slot. Don't use it for list pickers, selects, or filters (on mobile those open as a bottom sheet), and don't put the page's primary CTA inside it — that action lives in the Sticky Context Bar outside the drawer. Not in this release: Nav Bar, Sticky Context Bar.
223
+ - Docs: `src/components/drawer/Drawer.mdx`, examples in `Drawer.stories.tsx`, props in `Drawer.tsx`; Storybook docs ID `design-system-organisms-drawer--docs`
224
+
225
+ ### DropdownButton
226
+
227
+ - Import: `import { DropdownButton } from '@invoiceonline/ui-react'` or `from '@invoiceonline/ui-react/dropdown-button'`
228
+ - Exports: `DropdownButton`, `dropdownButtonVariants`
229
+ - Summary: A label + trailing caret control that opens a menu — the standalone dropdown affordance.
230
+ - When to use: Use as a standalone menu trigger (label + caret). For an icon-only menu trigger use the Icon Button + aria-haspopup; for a primary action joined to a menu use the Split Button.
231
+ - Docs: `src/components/dropdown-button/DropdownButton.mdx`, examples in `DropdownButton.stories.tsx`, props in `DropdownButton.tsx`; Storybook docs ID `design-system-atoms-dropdownbutton--docs`
232
+
233
+ ### FAQ
234
+
235
+ - Import: `import { FAQ } from '@invoiceonline/ui-react'` or `from '@invoiceonline/ui-react/faq'`
236
+ - Exports: `FAQ`, `faqVariants`
237
+ - Summary: The question-and-answer section of a public page — a heading rail beside an accordion of answers, with an optional support contact card.
238
+ - When to use: Place near the foot of a public page — a landing page, the homepage — where the remaining objections are answered before the closing call to action. Reach for it when the answers are short enough to read at a glance; a page whose answers run several paragraphs each wants the standalone FAQ page, not this section. Never in-app: this is public-page furniture, not contextual help (that is Tooltip) and not a notice (that is Alert).
239
+ - Docs: `src/components/faq/FAQ.mdx`, examples in `FAQ.stories.tsx`, props in `FAQ.tsx`; Storybook docs ID `design-system-organisms-faq--docs`
240
+
241
+ ### Field
242
+
243
+ - Import: `import { Field } from '@invoiceonline/ui-react'` or `from '@invoiceonline/ui-react/field'`
244
+ - Exports: `FieldGroup`, `FieldSet`, `FieldLegend`, `FieldSeparator`, `Field`, `fieldGroupVariants`, `fieldSetVariants`, `fieldLegendVariants`, `fieldSeparatorVariants`, `floatingLabelVariants`, `optionalLabelVariants`, `helperTextVariants`
245
+ - Summary: No manifest in the FODS spec; the MDX page and the source are the reference.
246
+ - Docs: `src/components/field/Field.mdx`, examples in `Field.stories.tsx`, props in `Field.tsx`; Storybook docs ID `design-system-atoms-field--docs`
247
+
248
+ ### FieldPair
249
+
250
+ - Import: `import { FieldPair } from '@invoiceonline/ui-react'` or `from '@invoiceonline/ui-react/field-pair'`
251
+ - Exports: `FieldPair`, `fieldPairContainerVariants`, `fieldSegmentVariants`
252
+ - Summary: Two fused fields read as one bounded range (od–do) — a date range or a min–max amount.
253
+ - When to use: Use for a single bounded range — a date range (the invoice-list Od/Do filter) or a min–max amount / number range. NOT for two unrelated fields (use two Text Fields), 3+ inputs (that is a form), or mixed cell types. Built in the Button Group scheme — one container + a single 1px divider + two borderless Field Segment cells.
254
+ - Docs: `src/components/field-pair/FieldPair.mdx`, examples in `FieldPair.stories.tsx`, props in `FieldPair.tsx`; Storybook docs ID `design-system-molecules-fieldpair--docs`
255
+
256
+ ### FileUpload
257
+
258
+ - Import: `import { FileUpload } from '@invoiceonline/ui-react'` or `from '@invoiceonline/ui-react/file-upload'`
259
+ - Exports: `FileUpload`, `fileUploadVariants`
260
+ - Summary: Drop-zone field for attaching a file or image inside a form — reuses the Text Field shell with an upload prompt and per-file rows.
261
+ - When to use: Use to attach a file or image inside a form (company logo, invoice attachments). Reach for it when the value IS a file, not free text or a link-out. The trigger 'Nahrajte svůj soubor' opens the OS file picker; the whole field is also a drag-and-drop target. NOT for choosing from a fixed set (→ Select) or plain text (→ Text Field).
262
+ - Docs: `src/components/file-upload/FileUpload.mdx`, examples in `FileUpload.stories.tsx`, props in `FileUpload.tsx`; Storybook docs ID `design-system-atoms-fileupload--docs`
263
+
264
+ ### FilterChip
265
+
266
+ - Import: `import { FilterChip } from '@invoiceonline/ui-react'` or `from '@invoiceonline/ui-react/filter-chip'`
267
+ - Exports: `FilterChip`, `filterChipVariants`
268
+ - Summary: The filter-bar control — a Facet trigger that morphs into its applied value, and a Toggle flag, both with live result counts.
269
+ - When to use: Reach for it when a control IS the filter state in a filter bar: a Facet (opens an options panel, then morphs in place into the chosen value with a clearing ×) or a Toggle (a binary flag, instant on/off). For a removable tag or a checkbox filter row use Chip; for an action-menu trigger use Dropdown Button; for read-only status use Badge.
270
+ - Docs: `src/components/filter-chip/FilterChip.mdx`, examples in `FilterChip.stories.tsx`, props in `FilterChip.tsx`; Storybook docs ID `design-system-atoms-filterchip--docs`
271
+
272
+ ### FilterFacet
273
+
274
+ - Import: `import { FilterFacet } from '@invoiceonline/ui-react'` or `from '@invoiceonline/ui-react/filter-facet'`
275
+ - Exports: `FilterFacet`
276
+ - Summary: No manifest in the FODS spec; the MDX page and the source are the reference.
277
+ - Docs: `src/components/filter-facet/FilterFacet.mdx`, examples in `FilterFacet.stories.tsx`, props in `FilterFacet.tsx`; Storybook docs ID `design-system-organisms-filterfacet--docs`
278
+
279
+ ### FirmAvatar
280
+
281
+ - Import: `import { FirmAvatar } from '@invoiceonline/ui-react'` or `from '@invoiceonline/ui-react/firm-avatar'`
282
+ - Exports: `FirmAvatar`, `firmAvatarVariants`, `firmInitials`
283
+ - Summary: Firm identity chip — initials of the firm name on a tinted square; Solid marks the active firm.
284
+ - When to use: The visual identity of a firm wherever firms are listed or switched: the leading element of an Action Row in the account menu (Size sm) and the account card at the top of the account menu (Size md). Not a person avatar and not a status carrier — for a non-firm entity row use Action Row's Show leading with an entity glyph instead.
285
+ - Docs: `src/components/firm-avatar/FirmAvatar.mdx`, examples in `FirmAvatar.stories.tsx`, props in `FirmAvatar.tsx`; Storybook docs ID `design-system-atoms-firmavatar--docs`
286
+
287
+ ### FormActions
288
+
289
+ - Import: `import { FormActions } from '@invoiceonline/ui-react'` or `from '@invoiceonline/ui-react/form-actions'`
290
+ - Exports: `FormActions`, `formActionsVariants`
291
+ - Summary: The sticky actions bar that closes a form page — one slot for the form's actions, laid out in one or two rows per breakpoint.
292
+ - When to use: Use once per form page, as the last element after the last Form Block, to hold the page's commit actions. The form fills the one `actions` slot with its own buttons; the bar owns sticking, padding, gaps and the one-row / two-row layout. Not a Sticky Context Bar, not a generic toolbar, and not a Form Block. Not in this release: Sticky Context Bar.
293
+ - Docs: `src/components/form-actions/FormActions.mdx`, examples in `FormActions.stories.tsx`, props in `FormActions.tsx`; Storybook docs ID `design-system-organisms-form-actions--docs`
294
+
295
+ ### FormBlock
296
+
297
+ - Import: `import { FormBlock } from '@invoiceonline/ui-react'` or `from '@invoiceonline/ui-react/form-block'`
298
+ - Exports: `FormBlock`, `useFormBlockCloseMs`, `useFormBlock`, `formBlockVariants`
299
+ - Summary: The white tile of a form page — a pictured H3 header with a trailing control over a grid of Form Sections or a one-column stack.
300
+ - When to use: Use for every top-level tile of a form page (invoice, expense, contact): one block per part of the form, on the --bg-secondary page. Layout=Stacked for a part with several fields or the line items; Layout=Inline for a part that is one lookup or a short summary (Informace o vás, Váš zákazník). Not for cards or panels outside a form, and not for the sticky actions bar (Form Actions).
301
+ - Docs: `src/components/form-block/FormBlock.mdx`, examples in `FormBlock.stories.tsx`, props in `FormBlock.tsx`; Storybook docs ID `design-system-organisms-form-block--docs`
302
+
303
+ ### FormSection
304
+
305
+ - Import: `import { FormSection } from '@invoiceonline/ui-react'` or `from '@invoiceonline/ui-react/form-section'`
306
+ - Exports: `FormSection`, `FormSectionCell`, `FormSectionTrio`, `FormSectionPair`, `formSectionVariants`, `resolveCellSpanClasses`
307
+ - Summary: One group of fields inside a Form Block — an optional H4 heading over a responsive grid of halves and trio rows.
308
+ - When to use: Use for every group of fields inside a Form Block: the block's only group (Header=None — the block header names it) or one of two or more sub-groups under the block header (Header=H4). Header=H3 is deprecated — the legacy parties tile only. Not for a set of radios or checkboxes answering one question (that is the control-group pattern, placed inside a section) and not for the line items (a Form Block content="stack" composition).
309
+ - Docs: `src/components/form-section/FormSection.mdx`, examples in `FormSection.stories.tsx`, props in `FormSection.tsx`; Storybook docs ID `design-system-organisms-form-section--docs`
310
+
311
+ ### Heading
312
+
313
+ - Import: `import { Heading } from '@invoiceonline/ui-react'` or `from '@invoiceonline/ui-react/heading'`
314
+ - Exports: `Heading`, `headingVariants`, `HEADING_SIZE_BY_LEVEL`
315
+ - Summary: The typed heading run — semantic level and visual size are decided separately; Size steps the type ramp from Display down to H5.
316
+ - When to use: Reach for it any time a screen needs a heading run — page title, section opener, card title. Size is chosen by the visual weight the spot needs, independent of the semantic `level` (h1–h6) that carries the document outline; an h2 may render at H1 size and vice versa. Display sizes (D1–D3) are marketing/hero surfaces only — never an in-app screen heading.
317
+ - Docs: `src/components/heading/Heading.mdx`, examples in `Heading.stories.tsx`, props in `Heading.tsx`; Storybook docs ID `design-system-atoms-heading--docs`
318
+
319
+ ### HeadingGroup
320
+
321
+ - Import: `import { HeadingGroup } from '@invoiceonline/ui-react'` or `from '@invoiceonline/ui-react/heading-group'`
322
+ - Exports: `HeadingGroup`, `headingGroupVariants`
323
+ - Summary: Kicker + heading + description as one block, with the gap between them keyed to the heading's size.
324
+ - When to use: Reach for it wherever a heading needs a supporting description line below it — page/section openers, empty states, FAQ items, marketing blocks — or a leading illustration: the page title of a list page (H1) or a form page (H2) and the block heading inside a form tile (H3) — or a leading icon on a small section heading (H4, H5). For a bare heading — no description, no illustration, no icon — use the Heading atom directly, not this molecule with Description off.
325
+ - Docs: `src/components/heading-group/HeadingGroup.mdx`, examples in `HeadingGroup.stories.tsx`, props in `HeadingGroup.tsx`; Storybook docs ID `design-system-molecules-headinggroup--docs`
326
+
327
+ ### Hero
328
+
329
+ - Import: `import { Hero } from '@invoiceonline/ui-react'` or `from '@invoiceonline/ui-react/hero'`
330
+ - Exports: `Hero`, `heroVariants`
331
+ - Summary: The first-screen panel for public pages — a promo plaque with a claim, up to two actions, and an optional image.
332
+ - When to use: Place at the top of a public page — a landing page, the homepage, the news index, or the register search — to carry the page's single claim, at most two actions, and (where the page has one) one image. Never for in-app cards, sections or callouts — the plaque comes from Promo Surface, a public-page-only atom. Use Visual=Off when the page has no image; that is not a fallback state, it is the centred-hero composition.
333
+ - Docs: `src/components/hero/Hero.mdx`, examples in `Hero.stories.tsx`, props in `Hero.tsx`; Storybook docs ID `design-system-organisms-hero--docs`
334
+
335
+ ### Icon
336
+
337
+ - Import: `import { Icon } from '@invoiceonline/ui-react'` or `from '@invoiceonline/ui-react/icon'`
338
+ - Exports: `Icon`, `AVAILABLE_ICONS`
339
+ - Summary: The manifest (spec/03-atoms/icon.manifest.json) has no summary; see the MDX page.
340
+ - Docs: `src/components/icon/Icon.mdx`, examples in `Icon.stories.tsx`, props in `Icon.tsx`; Storybook docs ID `design-system-atoms-icon--docs`
341
+
342
+ ### IconButton
343
+
344
+ - Import: `import { IconButton } from '@invoiceonline/ui-react'` or `from '@invoiceonline/ui-react/icon-button'`
345
+ - Exports: `IconButton`, `iconButtonVariants`
346
+ - Summary: A square, label-less control for a single icon-carried action — toolbars, dense rows, close / expand.
347
+ - When to use: Use where an action is carried entirely by an icon (toolbars, dense table rows, close / expand). Requires an aria-label. An icon-only menu trigger is this + aria-haspopup="menu".
348
+ - Docs: `src/components/icon-button/IconButton.mdx`, examples in `IconButton.stories.tsx`, props in `IconButton.tsx`; Storybook docs ID `design-system-atoms-iconbutton--docs`
349
+
350
+ ### ItemRow
351
+
352
+ - Import: `import { ItemRow } from '@invoiceonline/ui-react'` or `from '@invoiceonline/ui-react/item-row'`
353
+ - Exports: `ItemRow`, `itemRowVariants`
354
+ - Summary: One editable document line — the invoice or the expense row — reflowing from a single row to a stacked card.
355
+ - When to use: Only in the rows zone of the line items — a Form Block content="stack" composition — one instance per document line. It is not a table row (there is no cell grid and no column header to align to) and not a generic form row: every column is a live input the user edits in place, and the row's widths follow its Breakpoint (both rows read it from their own container width — the Faktura row against its floors, the Výdaje row at the frame widths). Pick the Document value by the form: the three Faktura values on the invoice form and the Mini Form, the three Výdaje values on the expense form. Not in this release: Mini Form.
356
+ - Docs: `src/components/item-row/ItemRow.mdx`, examples in `ItemRow.stories.tsx`, props in `ItemRow.tsx`; Storybook docs ID `design-system-organisms-item-row--docs`
357
+
358
+ ### ListRow
359
+
360
+ - Import: `import { ListRow } from '@invoiceonline/ui-react'` or `from '@invoiceonline/ui-react/list-row'`
361
+ - Exports: `ListRow`, `listRowVariants`
362
+ - Summary: The single row every dropdown surface — Menu, Select, Combobox, Popover — is filled with.
363
+ - When to use: Use as the shared row inside any dropdown surface. ListRow carries NO role of its own — the consuming organism injects menuitem / option / link. Leading + trailing are colour-safe instance-swap slots (icon, checkbox or checkmark), each toggled by a Show boolean.
364
+ - Docs: `src/components/list-row/ListRow.mdx`, examples in `ListRow.stories.tsx`, props in `ListRow.tsx`; Storybook docs ID `design-system-atoms-listrow--docs`
365
+
366
+ ### Menu
367
+
368
+ - Import: `import { Menu } from '@invoiceonline/ui-react'` or `from '@invoiceonline/ui-react/menu'`
369
+ - Exports: `Menu`
370
+ - Summary: No manifest in the FODS spec; the MDX page and the source are the reference.
371
+ - Docs: `src/components/menu/Menu.mdx`, examples in `Menu.stories.tsx`, props in `Menu.tsx`; Storybook docs ID `design-system-organisms-menu--docs`
372
+
373
+ ### Modal
374
+
375
+ - Import: `import { Modal } from '@invoiceonline/ui-react'` or `from '@invoiceonline/ui-react/modal'`
376
+ - Exports: `Modal`, `ModalTitle`, `modalVariants`
377
+ - Summary: One chrome shell for interruptive overlays — five Types at Mobile/sm/md/lg/xl; content is a doc pattern, not a variant.
378
+ - When to use: Use a Modal for an interruptive, focus-demanding task that must block the page until resolved: confirm an irreversible action, complete a short focused form (one block → Compact 'Settings' transitional shape; anything that scans/scrolls/sections → Corner), pick from a list when the user must SEE and compare options, read an important notice, or step through a short wizard. Don't use it for inline field validation, transient feedback (toast), easily-reversible one-click actions, or long multi-section forms (full page). Pick the CONTENT pattern first (`## Patterns`, cross-ref `popover-patterns.md#choosing-the-pattern`), then the chrome Type follows from the pattern's job — not the other way round. Not in this release: Toast.
379
+ - Docs: `src/components/modal/Modal.mdx`, examples in `Modal.stories.tsx`, props in `Modal.tsx`; Storybook docs ID `design-system-organisms-modal--docs`
380
+
381
+ ### NavLink
382
+
383
+ - Import: `import { NavLink } from '@invoiceonline/ui-react'` or `from '@invoiceonline/ui-react/nav-link'`
384
+ - Exports: `NavLink`, `navLinkVariants`
385
+ - Summary: Nav Bar navigation item — ghost styling, zero side padding; the current tab is marked by a 2px bottom indicator bar.
386
+ - When to use: Use for top-level wayfinding in the header nav. Distinct from Text Link (in-prose / action links) and Button (action with chrome). Spacing comes from the parent menu gap, not the item.
387
+ - Docs: `src/components/nav-link/NavLink.mdx`, examples in `NavLink.stories.tsx`, props in `NavLink.tsx`; Storybook docs ID `design-system-atoms-navlink--docs`
388
+
389
+ ### NumberField
390
+
391
+ - Import: `import { NumberField } from '@invoiceonline/ui-react'` or `from '@invoiceonline/ui-react/number-field'`
392
+ - Exports: `NumberField`, `numberFieldShellVariants`
393
+ - Summary: Text Field shell with a stepper − / + on either side of a centered numeric value — for small, boundable counts like item quantity.
394
+ - When to use: Use for small, boundable NUMERIC quantities the user adjusts by small increments as much as by typing — item-row Počet (quantity) is the reference case. NOT for currency / measured amounts with a unit (→ Unit Field), free numeric entry with no natural stepping (→ TextField type=numeric), or a fixed set of choices (→ Select). The stepper is the differentiator: if ± doesn't make sense for the value, it isn't a Number Field.
395
+ - Docs: `src/components/number-field/NumberField.mdx`, examples in `NumberField.stories.tsx`, props in `NumberField.tsx`; Storybook docs ID `design-system-atoms-numberfield--docs`
396
+
397
+ ### Pagination
398
+
399
+ - Import: `import { Pagination } from '@invoiceonline/ui-react'` or `from '@invoiceonline/ui-react/pagination'`
400
+ - Exports: `Pagination`, `paginationVariants`, `paginationRange`, `paginationItemVariants`
401
+ - Summary: A page-number row with text Previous/Next buttons — the paging footer under a Table or any long list.
402
+ - When to use: Use under any paginated table/list once content spans more than one page. Show ALL page numbers while the count is small; once there are enough pages that they would crowd the row (roughly 7+), collapse the run into a single non-interactive ellipsis, always keeping the first page, the last page, and Current's immediate neighbours visible (the shadcn PaginationEllipsis pattern). Hide the whole component when there is only one page — never render a disabled single-page bar. It is NOT a page-size selector (see Rules) and NOT a general Button Group.
403
+ - Docs: `src/components/pagination/Pagination.mdx`, examples in `Pagination.stories.tsx`, props in `Pagination.tsx`; Storybook docs ID `design-system-molecules-pagination--docs`
404
+
405
+ ### PopoverSurface
406
+
407
+ - Import: `import { popoverSurfaceVariants } from '@invoiceonline/ui-react'` or `from '@invoiceonline/ui-react/popover-surface'`
408
+ - Exports: `popoverSurfaceVariants`, `popoverBodyClass`, `popoverGroupClass`
409
+ - Summary: No manifest in the FODS spec; the MDX page and the source are the reference.
410
+ - Docs: `src/components/popover-surface/PopoverSurface.mdx`, examples in `PopoverSurface.stories.tsx` (no component file: the folder exports recipes only); Storybook docs ID `design-system-patterns-popover-surface--docs`
411
+
412
+ ### ProgressBar
413
+
414
+ - Import: `import { ProgressBar } from '@invoiceonline/ui-react'` or `from '@invoiceonline/ui-react/progress-bar'`
415
+ - Exports: `ProgressBar`, `progressBarVariants`
416
+ - Summary: A multi-step progress indicator — one continuous track behind self-describing step markers, filled up to the current step.
417
+ - When to use: A fixed, ordered sequence whose position must be visible at a glance: a product wizard's step band (sm) or a marketing rollout/timeline narrative (lg). Not for paging a result set (→ Pagination), not for a percentage/indeterminate load (→ future linear progress), not for independent actions (→ Button Group).
418
+ - Docs: `src/components/progress-bar/ProgressBar.mdx`, examples in `ProgressBar.stories.tsx`, props in `ProgressBar.tsx`; Storybook docs ID `design-system-molecules-progressbar--docs`
419
+
420
+ ### PromoSticker
421
+
422
+ - Import: `import { PromoSticker } from '@invoiceonline/ui-react'` or `from '@invoiceonline/ui-react/promo-sticker'`
423
+ - Exports: `PromoSticker`, `promoStickerVariants`
424
+ - Summary: Hand-brushed promo smear with white text — clings to a carrier's edge with a slight tilt; Label marker or two-line Tile.
425
+ - When to use: Reach for it when FO itself is speaking ON TOP of content — a recommendation marker on a card corner (Doporučené on the Novinky featured card) or a readiness claim on a marketing surface (KSeF / EET / E-Rechnung tiles). It sits on the carrier's EDGE, half outside, slightly tilted. For read-only status inside content flow use Badge; for interactive tags use Chip.
426
+ - Docs: `src/components/promo-sticker/PromoSticker.mdx`, examples in `PromoSticker.stories.tsx`, props in `PromoSticker.tsx`; Storybook docs ID `design-system-atoms-promosticker--docs`
427
+
428
+ ### PromoSurface
429
+
430
+ - Import: `import { PromoSurface } from '@invoiceonline/ui-react'` or `from '@invoiceonline/ui-react/promo-surface'`
431
+ - Exports: `PromoSurface`, `promoSurfaceVariants`
432
+ - Summary: The promo plaque — fill, pattern and veil behind a hero or banner, swapped independently of what the panel holds.
433
+ - When to use: Render as the bottom layer of a promotional panel on a public page — the plaque that carries the fill and the decorative pattern. Two components consume it: Hero, the first-screen panel, and Banner. It is chrome only: nothing lives inside it. The consumer composes its text column and visual ABOVE the surface and swaps this instance to change tone, so a new surface never multiplies the consumer's own variant matrix. Not for in-app cards, sections or callouts — those take a plain --bg-* fill with no pattern.
434
+ - Docs: `src/components/promo-surface/PromoSurface.mdx`, examples in `PromoSurface.stories.tsx`, props in `PromoSurface.tsx`; Storybook docs ID `design-system-atoms-promosurface--docs`
435
+
436
+ ### Radio
437
+
438
+ - Import: `import { Radio } from '@invoiceonline/ui-react'` or `from '@invoiceonline/ui-react/radio'`
439
+ - Exports: `Radio`, `radioVariants`
440
+ - Summary: Selection control for choosing exactly one option within a group (radiogroup).
441
+ - When to use: Use for choosing exactly one option within a group. For zero-or-more independent options use Checkbox. No indeterminate — the group validates, not the individual control.
442
+ - Docs: `src/components/radio/Radio.mdx`, examples in `Radio.stories.tsx`, props in `Radio.tsx`; Storybook docs ID `design-system-atoms-radio--docs`
443
+
444
+ ### RadioGroup
445
+
446
+ - Import: `import { RadioGroup } from '@invoiceonline/ui-react'` or `from '@invoiceonline/ui-react/radio-group'`
447
+ - Exports: `RadioGroup`, `RadioGroupContext`
448
+ - Summary: No manifest in the FODS spec; the MDX page and the source are the reference.
449
+ - Docs: `src/components/radio-group/RadioGroup.mdx`, examples in `RadioGroup.stories.tsx`, props in `RadioGroup.tsx`; Storybook docs ID `design-system-atoms-radiogroup--docs`
450
+
451
+ ### Select
452
+
453
+ - Import: `import { Select } from '@invoiceonline/ui-react'` or `from '@invoiceonline/ui-react/select'`
454
+ - Exports: `Select`
455
+ - Summary: No manifest in the FODS spec; the MDX page and the source are the reference.
456
+ - Docs: `src/components/select/Select.mdx`, examples in `Select.stories.tsx`, props in `Select.tsx`; Storybook docs ID `design-system-organisms-select--docs`
457
+
458
+ ### SelectField
459
+
460
+ - Import: `import { SelectField } from '@invoiceonline/ui-react'` or `from '@invoiceonline/ui-react/select-field'`
461
+ - Exports: `SelectField`
462
+ - Summary: The closed trigger of a single-select dropdown — a Text Field shell with a caret; opens a listbox panel of options.
463
+ - When to use: Use to pick ONE value from a fixed, known set (currency, country, VAT rate, payment method). NOT for free-form text (→ Text Field), a searchable/typed set (→ Combobox Field), multi-select or toggles (→ a Popover + checkbox list), or navigation/commands (→ Menu). This component is the TRIGGER only; the option panel is composed separately (Popover surface + List Row) — see rules.
464
+ - Docs: `src/components/select-field/SelectField.mdx`, examples in `SelectField.stories.tsx`, props in `SelectField.tsx`; Storybook docs ID `design-system-molecules-selectfield--docs`
465
+
466
+ ### Skeleton
467
+
468
+ - Import: `import { Skeleton } from '@invoiceonline/ui-react'` or `from '@invoiceonline/ui-react/skeleton'`
469
+ - Exports: `Skeleton`, `skeletonVariants`
470
+ - Summary: A loading placeholder — the block that stands in for content that has not arrived yet.
471
+ - When to use: Render while real content is being fetched, in the shape and roughly the size of what will replace it, so the layout does not jump when it lands. Not a spinner: a skeleton says WHERE content will be, a spinner only says that something is happening. Not an empty state: an empty state is a final answer, a skeleton is a wait. Reach for it when the wait is long enough to notice and the shape of the result is known in advance.
472
+ - Docs: `src/components/skeleton/Skeleton.mdx`, examples in `Skeleton.stories.tsx`, props in `Skeleton.tsx`; Storybook docs ID `design-system-atoms-skeleton--docs`
473
+
474
+ ### SplitButton
475
+
476
+ - Import: `import { SplitButton } from '@invoiceonline/ui-react'` or `from '@invoiceonline/ui-react/split-button'`
477
+ - Exports: `SplitButton`, `splitButtonContainerVariants`
478
+ - Summary: A primary action joined to a menu trigger — a label half + a square icon-trigger half.
479
+ - When to use: Use when a primary action has a related menu of alternatives. For a standalone menu (no primary action) use the Dropdown Button; for a cluster of peer actions the Button Group. Built from two Button Segment cells.
480
+ - Docs: `src/components/split-button/SplitButton.mdx`, examples in `SplitButton.stories.tsx`, props in `SplitButton.tsx`; Storybook docs ID `design-system-molecules-splitbutton--docs`
481
+
482
+ ### StatusSummaryBar
483
+
484
+ - Import: `import { StatusSummaryBar } from '@invoiceonline/ui-react'` or `from '@invoiceonline/ui-react/status-summary-bar'`
485
+ - Exports: `StatusSummaryBar`, `statusSummaryBarVariants`
486
+ - Summary: The filter-and-summary strip above a record list — a bordered total card with a donut, then one filtering cell per document status.
487
+ - When to use: Use above a Table on a record list whose rows carry a STATUS, when the list is long enough that the reader needs the shape of the whole set before reading any row (invoices, expenses). It answers two questions at once: how the total splits by status, and which statuses are currently in the table. Do not use it as a general KPI/metric strip — every cell here is a filter control bound to a status family, not a free-standing figure. A dashboard tile that only reports has no checkbox and is not this organism.
488
+ - Docs: `src/components/status-summary-bar/StatusSummaryBar.mdx`, examples in `StatusSummaryBar.stories.tsx`, props in `StatusSummaryBar.tsx`; Storybook docs ID `design-system-organisms-status-summary-bar--docs`
489
+
490
+ ### SubjectLookupField
491
+
492
+ - Import: `import { SubjectLookupField } from '@invoiceonline/ui-react'` or `from '@invoiceonline/ui-react/subject-lookup-field'`
493
+ - Exports: `SubjectLookupField`, `subjectLookupGlyphVariants`, `subjectLookupButtonVariants`
494
+ - Summary: The ARES subject-lookup trigger — type a name or IČO, the trailing reports the search, picking a result autofills the identity.
495
+ - When to use: Identify a Czech business subject and have its identity filled in — the customer (Odběratel) of an invoice and the supplier (Dodavatel) of an expense. One query searches saved contacts and the ARES registry at once; picking a result autofills name · IČO · DIČ · address. NOT for a type-to-narrow pick without registry autofill (→ Combobox Field), a scannable fixed set (→ Select Field), or free-form text (→ Text Field).
496
+ - Docs: `src/components/subject-lookup-field/SubjectLookupField.mdx`, examples in `SubjectLookupField.stories.tsx`, props in `SubjectLookupField.tsx`; Storybook docs ID `design-system-molecules-subjectlookupfield--docs`
497
+
498
+ ### Switch
499
+
500
+ - Import: `import { Switch } from '@invoiceonline/ui-react'` or `from '@invoiceonline/ui-react/switch'`
501
+ - Exports: `Switch`, `switchVariants`
502
+ - Summary: An instant-apply on/off control for a single setting — flipping it IS the action, with no Save to follow.
503
+ - When to use: A setting that takes effect the moment it is flipped, with no Save — a preference row, a capability that turns on. NOT a form value submitted with the rest (→ Checkbox: "Jsem plátce DPH" is a checkbox), not one-of-several (→ Radio), and not a choice between two NAMED alternatives that must both stay readable (→ Button Segment: «s DPH / bez DPH»). The test: a label that reads as a statement you agree to is a Checkbox; one that reads as a capability being enabled is a Switch.
504
+ - Docs: `src/components/switch/Switch.mdx`, examples in `Switch.stories.tsx`, props in `Switch.tsx`; Storybook docs ID `design-system-atoms-switch--docs`
505
+
506
+ ### Table
507
+
508
+ - Import: `import { Table } from '@invoiceonline/ui-react'` or `from '@invoiceonline/ui-react/table'`
509
+ - Exports: `Table`, `TABLE_DEFAULT_PAGE_SIZE`, `TABLE_PAGE_SIZE_OPTIONS`, `createTableColumnHelper`, `tableFeatureSet`, `TableChildRowPrefix`, `useTableLayout`
510
+ - Summary: The tabular list organism for invoices/expenses/contacts — a fixed column grid built as chrome + filling rules, not a componentized row.
511
+ - When to use: Use for any record list that reads as columns of comparable values across many rows (invoices, expenses, contacts, exports) — where a person scans down a column (amount, date, status) as much as across a row. Not for a single free-flowing list of dissimilar items (→ List Row inside a Popover/page list) and not for card-style summaries. The organism is deliberately NOT componentized row-by-row: rows and cells are a documented RECIPE built from atoms (Checkbox, Column Header, Chip, Badge, Text Link, Icon, Icon Button, Divider) plus one dedicated subcomponent (_Table Child Connector) for parent/child branches — see the Rationale of the Table spec for why List Row is scope-fenced OUT of tables.
512
+ - Docs: `src/components/table/Table.mdx`, examples in `Table.stories.tsx`, props in `Table.tsx`; Storybook docs ID `design-system-organisms-table--docs`
513
+
514
+ ### TextField
515
+
516
+ - Import: `import { TextField } from '@invoiceonline/ui-react'` or `from '@invoiceonline/ui-react/text-field'`
517
+ - Exports: `TextField`, `textFieldShellVariants`, `textFieldValueVariants`
518
+ - Summary: Single-line text input with a floating label — short free-form values like name, IČO, e-mail, amount.
519
+ - When to use: Use for short free-form values (name, IČO/DIČ, e-mail, phone, web, amounts, search / filter). NOT for multi-line (→ Textarea) or a fixed set (→ Select). The type prop (text · email · tel · url · search · password · numeric · date) is non-visual: password adds a reveal, search a leading icon, numeric right-aligns, date adds the leading calendar-dots and opens a Single month Date Picker on tap (the picker is the panel this field opens, not a competing field).
520
+ - Docs: `src/components/text-field/TextField.mdx`, examples in `TextField.stories.tsx`, props in `TextField.tsx`; Storybook docs ID `design-system-atoms-textfield--docs`
521
+
522
+ ### TextLink
523
+
524
+ - Import: `import { TextLink } from '@invoiceonline/ui-react'` or `from '@invoiceonline/ui-react/text-link'`
525
+ - Exports: `TextLink`, `textLinkVariants`
526
+ - Summary: Inline or standalone text link — link-blue, optional icon; distinct from Nav Link and Button.
527
+ - When to use: Use for in-prose links and standalone action links. Distinct from Nav Link (header wayfinding, underline = current) and Button (action with chrome). Never icon-only — that is an Icon Button.
528
+ - Docs: `src/components/text-link/TextLink.mdx`, examples in `TextLink.stories.tsx`, props in `TextLink.tsx`; Storybook docs ID `design-system-atoms-textlink--docs`
529
+
530
+ ### Textarea
531
+
532
+ - Import: `import { Textarea } from '@invoiceonline/ui-react'` or `from '@invoiceonline/ui-react/textarea'`
533
+ - Exports: `Textarea`, `textareaShellVariants`, `textareaValueVariants`, `textareaCounterVariants`
534
+ - Summary: Multi-line text input with a floating label — longer free-form values like notes, descriptions, invoice remarks.
535
+ - When to use: Use for longer, multi-line free-form text: notes, descriptions, invoice remarks, messages, addresses that run long. NOT for single-line values (→ Text Field), a fixed set of options (→ Select), or dates (→ Date Picker). The field auto-grows with content; the corner grip lets the user drag to resize vertically.
536
+ - Docs: `src/components/textarea/Textarea.mdx`, examples in `Textarea.stories.tsx`, props in `Textarea.tsx`; Storybook docs ID `design-system-atoms-textarea--docs`
537
+
538
+ ### Tooltip
539
+
540
+ - Import: `import { Tooltip } from '@invoiceonline/ui-react'` or `from '@invoiceonline/ui-react/tooltip'`
541
+ - Exports: `Tooltip`, `TooltipRoot`, `TooltipTrigger`, `TooltipContent`, `TooltipPortal`, `TooltipProvider`, `TooltipArrow`, `tooltipVariants`
542
+ - Summary: Transient dark overlay bubble giving supplementary hover/focus help, anchored to a trigger with a caret.
543
+ - When to use: Reach for it to explain a term, field, or status on hover/focus. The copy may carry one inline link (the tooltip then works as a toggletip). NOT for essential instructions, validation errors, buttons, or form fields (those go in visible helper text / an error region / a Popover).
544
+ - Docs: `src/components/tooltip/Tooltip.mdx`, examples in `Tooltip.stories.tsx`, props in `Tooltip.tsx`; Storybook docs ID `design-system-atoms-tooltip--docs`
545
+
546
+ ### UnitField
547
+
548
+ - Import: `import { UnitField } from '@invoiceonline/ui-react'` or `from '@invoiceonline/ui-react/unit-field'`
549
+ - Exports: `UnitField`, `unitFieldShellVariants`
550
+ - Summary: Text Field shell with a right-aligned unit suffix (Kč, %, …) — for amounts, rates, and computed read-only values that carry a unit.
551
+ - When to use: Use for a numeric value that always carries a UNIT — a currency amount (Kč), a rate (%), a piece count with a unit label (ks). Covers both EDITABLE amounts (item-row Cena, Sazba DPH %) and DERIVED read-only amounts the user can see but not edit (Výše DPH computed from Cena × Sazba). NOT for a plain quantity with no unit (→ Number Field) or a free string (→ TextField).
552
+ - Docs: `src/components/unit-field/UnitField.mdx`, examples in `UnitField.stories.tsx`, props in `UnitField.tsx`; Storybook docs ID `design-system-atoms-unitfield--docs`
553
+
554
+ ## Other exports of the root entry
555
+
556
+ `cn`, `hasOpenFloatingPanel`, `PortalContainerContext`, `FodsProvider`, `buttonSegmentVariants`, `progressBarItemVariants`.