@invoiceonline/ui-react 0.0.0-stage → 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (738) hide show
  1. package/AGENTS.md +99 -0
  2. package/CHANGELOG.md +131 -0
  3. package/LICENSE +9 -0
  4. package/README.md +78 -2
  5. package/dist/assets/label-brush-1.svg +6 -0
  6. package/dist/assets/pattern-dark.svg +113 -0
  7. package/dist/components/action-row/ActionRow.d.ts +178 -0
  8. package/dist/components/action-row/ActionRow.js +340 -0
  9. package/dist/components/action-row/index.d.ts +2 -0
  10. package/dist/components/action-row/index.js +1 -0
  11. package/dist/components/alert/Alert.d.ts +314 -0
  12. package/dist/components/alert/Alert.js +446 -0
  13. package/dist/components/alert/index.d.ts +2 -0
  14. package/dist/components/alert/index.js +1 -0
  15. package/dist/components/anchored-panel/AnchoredPanel.d.ts +41 -0
  16. package/dist/components/anchored-panel/AnchoredPanel.js +72 -0
  17. package/dist/components/anchored-panel/index.d.ts +3 -0
  18. package/dist/components/anchored-panel/index.js +3 -0
  19. package/dist/components/badge/Badge.d.ts +146 -0
  20. package/dist/components/badge/Badge.js +258 -0
  21. package/dist/components/badge/index.d.ts +2 -0
  22. package/dist/components/badge/index.js +1 -0
  23. package/dist/components/banner/Banner.d.ts +209 -0
  24. package/dist/components/banner/Banner.js +339 -0
  25. package/dist/components/banner/index.d.ts +2 -0
  26. package/dist/components/banner/index.js +1 -0
  27. package/dist/components/button/Button.d.ts +54 -0
  28. package/dist/components/button/Button.js +312 -0
  29. package/dist/components/button/index.d.ts +2 -0
  30. package/dist/components/button/index.js +1 -0
  31. package/dist/components/button-group/ButtonGroup.d.ts +187 -0
  32. package/dist/components/button-group/ButtonGroup.js +217 -0
  33. package/dist/components/button-group/index.d.ts +2 -0
  34. package/dist/components/button-group/index.js +1 -0
  35. package/dist/components/card-select/CardSelect.d.ts +274 -0
  36. package/dist/components/card-select/CardSelect.js +561 -0
  37. package/dist/components/card-select/CardSelectGroup.d.ts +92 -0
  38. package/dist/components/card-select/CardSelectGroup.js +72 -0
  39. package/dist/components/card-select/index.d.ts +3 -0
  40. package/dist/components/card-select/index.js +3 -0
  41. package/dist/components/checkbox/Checkbox.d.ts +104 -0
  42. package/dist/components/checkbox/Checkbox.js +194 -0
  43. package/dist/components/checkbox/index.d.ts +2 -0
  44. package/dist/components/checkbox/index.js +1 -0
  45. package/dist/components/chip/Chip.d.ts +250 -0
  46. package/dist/components/chip/Chip.js +441 -0
  47. package/dist/components/chip/index.d.ts +2 -0
  48. package/dist/components/chip/index.js +1 -0
  49. package/dist/components/column-header/ColumnHeader.d.ts +144 -0
  50. package/dist/components/column-header/ColumnHeader.js +209 -0
  51. package/dist/components/column-header/index.d.ts +2 -0
  52. package/dist/components/column-header/index.js +1 -0
  53. package/dist/components/combobox-field/Combobox.d.ts +104 -0
  54. package/dist/components/combobox-field/Combobox.js +355 -0
  55. package/dist/components/combobox-field/ComboboxField.d.ts +76 -0
  56. package/dist/components/combobox-field/ComboboxField.js +98 -0
  57. package/dist/components/combobox-field/index.d.ts +3 -0
  58. package/dist/components/combobox-field/index.js +3 -0
  59. package/dist/components/date-field/DateField.d.ts +52 -0
  60. package/dist/components/date-field/DateField.js +45 -0
  61. package/dist/components/date-field/index.d.ts +2 -0
  62. package/dist/components/date-field/index.js +1 -0
  63. package/dist/components/date-picker/DatePicker.d.ts +53 -0
  64. package/dist/components/date-picker/DatePicker.js +329 -0
  65. package/dist/components/date-picker/index.d.ts +2 -0
  66. package/dist/components/date-picker/index.js +1 -0
  67. package/dist/components/divider/Divider.d.ts +81 -0
  68. package/dist/components/divider/Divider.js +93 -0
  69. package/dist/components/divider/index.d.ts +2 -0
  70. package/dist/components/divider/index.js +1 -0
  71. package/dist/components/drawer/Drawer.d.ts +128 -0
  72. package/dist/components/drawer/Drawer.js +367 -0
  73. package/dist/components/drawer/index.d.ts +2 -0
  74. package/dist/components/drawer/index.js +1 -0
  75. package/dist/components/dropdown-button/DropdownButton.d.ts +72 -0
  76. package/dist/components/dropdown-button/DropdownButton.js +122 -0
  77. package/dist/components/dropdown-button/index.d.ts +2 -0
  78. package/dist/components/dropdown-button/index.js +1 -0
  79. package/dist/components/faq/FAQ.d.ts +135 -0
  80. package/dist/components/faq/FAQ.js +258 -0
  81. package/dist/components/faq/index.d.ts +2 -0
  82. package/dist/components/faq/index.js +1 -0
  83. package/dist/components/field/Field.d.ts +118 -0
  84. package/dist/components/field/Field.js +327 -0
  85. package/dist/components/field/index.d.ts +2 -0
  86. package/dist/components/field/index.js +1 -0
  87. package/dist/components/field-pair/FieldPair.d.ts +194 -0
  88. package/dist/components/field-pair/FieldPair.js +321 -0
  89. package/dist/components/field-pair/index.d.ts +2 -0
  90. package/dist/components/field-pair/index.js +1 -0
  91. package/dist/components/file-upload/FileUpload.d.ts +137 -0
  92. package/dist/components/file-upload/FileUpload.js +434 -0
  93. package/dist/components/file-upload/index.d.ts +2 -0
  94. package/dist/components/file-upload/index.js +1 -0
  95. package/dist/components/filter-chip/FilterChip.d.ts +373 -0
  96. package/dist/components/filter-chip/FilterChip.js +517 -0
  97. package/dist/components/filter-chip/index.d.ts +2 -0
  98. package/dist/components/filter-chip/index.js +1 -0
  99. package/dist/components/filter-facet/FilterFacet.d.ts +116 -0
  100. package/dist/components/filter-facet/FilterFacet.js +632 -0
  101. package/dist/components/filter-facet/index.d.ts +2 -0
  102. package/dist/components/filter-facet/index.js +1 -0
  103. package/dist/components/firm-avatar/FirmAvatar.d.ts +75 -0
  104. package/dist/components/firm-avatar/FirmAvatar.js +119 -0
  105. package/dist/components/firm-avatar/index.d.ts +2 -0
  106. package/dist/components/firm-avatar/index.js +1 -0
  107. package/dist/components/form-actions/FormActions.d.ts +123 -0
  108. package/dist/components/form-actions/FormActions.js +195 -0
  109. package/dist/components/form-actions/index.d.ts +2 -0
  110. package/dist/components/form-actions/index.js +1 -0
  111. package/dist/components/form-block/FormBlock.d.ts +252 -0
  112. package/dist/components/form-block/FormBlock.js +420 -0
  113. package/dist/components/form-block/index.d.ts +3 -0
  114. package/dist/components/form-block/index.js +3 -0
  115. package/dist/components/form-section/FormSection.d.ts +130 -0
  116. package/dist/components/form-section/FormSection.js +206 -0
  117. package/dist/components/form-section/index.d.ts +2 -0
  118. package/dist/components/form-section/index.js +1 -0
  119. package/dist/components/heading/Heading.d.ts +69 -0
  120. package/dist/components/heading/Heading.js +79 -0
  121. package/dist/components/heading/index.d.ts +2 -0
  122. package/dist/components/heading/index.js +1 -0
  123. package/dist/components/heading-group/HeadingGroup.d.ts +258 -0
  124. package/dist/components/heading-group/HeadingGroup.js +255 -0
  125. package/dist/components/heading-group/index.d.ts +2 -0
  126. package/dist/components/heading-group/index.js +1 -0
  127. package/dist/components/hero/Hero.d.ts +268 -0
  128. package/dist/components/hero/Hero.js +316 -0
  129. package/dist/components/hero/index.d.ts +2 -0
  130. package/dist/components/hero/index.js +1 -0
  131. package/dist/components/icon/Icon.d.ts +27 -0
  132. package/dist/components/icon/Icon.js +30 -0
  133. package/dist/components/icon/index.d.ts +3 -0
  134. package/dist/components/icon/index.js +3 -0
  135. package/dist/components/icon-button/IconButton.d.ts +75 -0
  136. package/dist/components/icon-button/IconButton.js +151 -0
  137. package/dist/components/icon-button/index.d.ts +2 -0
  138. package/dist/components/icon-button/index.js +1 -0
  139. package/dist/components/item-row/ItemRow.d.ts +253 -0
  140. package/dist/components/item-row/ItemRow.js +496 -0
  141. package/dist/components/item-row/index.d.ts +2 -0
  142. package/dist/components/item-row/index.js +1 -0
  143. package/dist/components/list-row/ListRow.d.ts +165 -0
  144. package/dist/components/list-row/ListRow.js +233 -0
  145. package/dist/components/list-row/index.d.ts +2 -0
  146. package/dist/components/list-row/index.js +1 -0
  147. package/dist/components/menu/Menu.d.ts +64 -0
  148. package/dist/components/menu/Menu.js +186 -0
  149. package/dist/components/menu/index.d.ts +2 -0
  150. package/dist/components/menu/index.js +1 -0
  151. package/dist/components/modal/Modal.d.ts +272 -0
  152. package/dist/components/modal/Modal.js +788 -0
  153. package/dist/components/modal/index.d.ts +2 -0
  154. package/dist/components/modal/index.js +1 -0
  155. package/dist/components/nav-link/NavLink.d.ts +123 -0
  156. package/dist/components/nav-link/NavLink.js +157 -0
  157. package/dist/components/nav-link/index.d.ts +2 -0
  158. package/dist/components/nav-link/index.js +1 -0
  159. package/dist/components/number-field/NumberField.d.ts +62 -0
  160. package/dist/components/number-field/NumberField.js +210 -0
  161. package/dist/components/number-field/index.d.ts +2 -0
  162. package/dist/components/number-field/index.js +1 -0
  163. package/dist/components/pagination/Pagination.d.ts +133 -0
  164. package/dist/components/pagination/Pagination.js +217 -0
  165. package/dist/components/pagination/index.d.ts +3 -0
  166. package/dist/components/pagination/index.js +3 -0
  167. package/dist/components/popover-surface/index.d.ts +2 -0
  168. package/dist/components/popover-surface/index.js +1 -0
  169. package/dist/components/progress-bar/ProgressBar.d.ts +260 -0
  170. package/dist/components/progress-bar/ProgressBar.js +470 -0
  171. package/dist/components/progress-bar/index.d.ts +2 -0
  172. package/dist/components/progress-bar/index.js +1 -0
  173. package/dist/components/promo-sticker/PromoSticker.d.ts +204 -0
  174. package/dist/components/promo-sticker/PromoSticker.js +177 -0
  175. package/dist/components/promo-sticker/index.d.ts +2 -0
  176. package/dist/components/promo-sticker/index.js +1 -0
  177. package/dist/components/promo-surface/PromoSurface.d.ts +94 -0
  178. package/dist/components/promo-surface/PromoSurface.js +119 -0
  179. package/dist/components/promo-surface/index.d.ts +2 -0
  180. package/dist/components/promo-surface/index.js +1 -0
  181. package/dist/components/radio/Radio.d.ts +92 -0
  182. package/dist/components/radio/Radio.js +171 -0
  183. package/dist/components/radio/index.d.ts +2 -0
  184. package/dist/components/radio/index.js +1 -0
  185. package/dist/components/radio-group/RadioGroup.d.ts +61 -0
  186. package/dist/components/radio-group/RadioGroup.js +51 -0
  187. package/dist/components/radio-group/index.d.ts +2 -0
  188. package/dist/components/radio-group/index.js +1 -0
  189. package/dist/components/select/Select.d.ts +65 -0
  190. package/dist/components/select/Select.js +176 -0
  191. package/dist/components/select/index.d.ts +2 -0
  192. package/dist/components/select/index.js +1 -0
  193. package/dist/components/select-field/SelectField.d.ts +16 -0
  194. package/dist/components/select-field/SelectField.js +55 -0
  195. package/dist/components/select-field/index.d.ts +2 -0
  196. package/dist/components/select-field/index.js +1 -0
  197. package/dist/components/skeleton/Skeleton.d.ts +64 -0
  198. package/dist/components/skeleton/Skeleton.js +65 -0
  199. package/dist/components/skeleton/index.d.ts +2 -0
  200. package/dist/components/skeleton/index.js +1 -0
  201. package/dist/components/split-button/SplitButton.d.ts +80 -0
  202. package/dist/components/split-button/SplitButton.js +182 -0
  203. package/dist/components/split-button/index.d.ts +2 -0
  204. package/dist/components/split-button/index.js +1 -0
  205. package/dist/components/status-summary-bar/StatusSummaryBar.d.ts +118 -0
  206. package/dist/components/status-summary-bar/StatusSummaryBar.js +278 -0
  207. package/dist/components/status-summary-bar/index.d.ts +2 -0
  208. package/dist/components/status-summary-bar/index.js +1 -0
  209. package/dist/components/subject-lookup-field/SubjectLookupField.d.ts +157 -0
  210. package/dist/components/subject-lookup-field/SubjectLookupField.js +663 -0
  211. package/dist/components/subject-lookup-field/index.d.ts +2 -0
  212. package/dist/components/subject-lookup-field/index.js +1 -0
  213. package/dist/components/switch/Switch.d.ts +152 -0
  214. package/dist/components/switch/Switch.js +307 -0
  215. package/dist/components/switch/index.d.ts +2 -0
  216. package/dist/components/switch/index.js +1 -0
  217. package/dist/components/table/Table.d.ts +5 -0
  218. package/dist/components/table/Table.js +601 -0
  219. package/dist/components/table/index.d.ts +6 -0
  220. package/dist/components/table/index.js +6 -0
  221. package/dist/components/text-field/TextField.d.ts +65 -0
  222. package/dist/components/text-field/TextField.js +173 -0
  223. package/dist/components/text-field/index.d.ts +2 -0
  224. package/dist/components/text-field/index.js +1 -0
  225. package/dist/components/text-link/TextLink.d.ts +260 -0
  226. package/dist/components/text-link/TextLink.js +303 -0
  227. package/dist/components/text-link/index.d.ts +2 -0
  228. package/dist/components/text-link/index.js +1 -0
  229. package/dist/components/textarea/Textarea.d.ts +93 -0
  230. package/dist/components/textarea/Textarea.js +256 -0
  231. package/dist/components/textarea/index.d.ts +2 -0
  232. package/dist/components/textarea/index.js +1 -0
  233. package/dist/components/tooltip/Tooltip.d.ts +129 -0
  234. package/dist/components/tooltip/Tooltip.js +457 -0
  235. package/dist/components/tooltip/index.d.ts +2 -0
  236. package/dist/components/tooltip/index.js +1 -0
  237. package/dist/components/unit-field/UnitField.d.ts +46 -0
  238. package/dist/components/unit-field/UnitField.js +133 -0
  239. package/dist/components/unit-field/index.d.ts +2 -0
  240. package/dist/components/unit-field/index.js +1 -0
  241. package/dist/icons/icon-registry.generated.js +500 -0
  242. package/dist/icons/icon-types.generated.d.ts +2 -0
  243. package/dist/icons/icon-types.generated.js +126 -0
  244. package/dist/index.d.ts +132 -0
  245. package/dist/index.js +75 -0
  246. package/dist/internal/BottomSheet.js +496 -0
  247. package/dist/internal/FodsProvider.d.ts +25 -0
  248. package/dist/internal/FodsProvider.js +32 -0
  249. package/dist/internal/MotionCaret.js +35 -0
  250. package/dist/internal/NumberFormatInput.d.ts +21 -0
  251. package/dist/internal/NumberFormatInput.js +126 -0
  252. package/dist/internal/SummaryDonut.d.ts +3 -0
  253. package/dist/internal/SummaryDonut.js +300 -0
  254. package/dist/internal/buttonSegment.d.ts +44 -0
  255. package/dist/internal/buttonSegment.js +126 -0
  256. package/dist/internal/collapseRoom.js +128 -0
  257. package/dist/internal/comboboxKeys.js +44 -0
  258. package/dist/internal/contentPresence.js +46 -0
  259. package/dist/internal/dayCell.js +95 -0
  260. package/dist/internal/dialogPortal.d.ts +2 -0
  261. package/dist/internal/dialogPortal.js +21 -0
  262. package/dist/internal/donutSweeps.js +65 -0
  263. package/dist/internal/enterOnViewGeometry.js +46 -0
  264. package/dist/internal/faqItem.js +80 -0
  265. package/dist/internal/floatingLabelMotion.js +68 -0
  266. package/dist/internal/formBlockContext.d.ts +22 -0
  267. package/dist/internal/formBlockContext.js +20 -0
  268. package/dist/internal/heightRoom.js +87 -0
  269. package/dist/internal/numberSeparators.js +62 -0
  270. package/dist/internal/overlayMotion.js +48 -0
  271. package/dist/internal/paginationItem.d.ts +8 -0
  272. package/dist/internal/paginationItem.js +22 -0
  273. package/dist/internal/popoverSurface.d.ts +8 -0
  274. package/dist/internal/popoverSurface.js +23 -0
  275. package/dist/internal/portalContainer.d.ts +1 -0
  276. package/dist/internal/portalContainer.js +6 -0
  277. package/dist/internal/progressBarItem.d.ts +207 -0
  278. package/dist/internal/progressBarItem.js +264 -0
  279. package/dist/internal/selectionControlText.js +12 -0
  280. package/dist/internal/statusSummaryParts.js +371 -0
  281. package/dist/internal/summaryMotion.js +75 -0
  282. package/dist/internal/table/ChildConnector.js +62 -0
  283. package/dist/internal/table/ChildRowPrefix.d.ts +9 -0
  284. package/dist/internal/table/ChildRowPrefix.js +27 -0
  285. package/dist/internal/table/ColumnSettings.js +135 -0
  286. package/dist/internal/table/ScrollRegion.js +114 -0
  287. package/dist/internal/table/TableEmpty.js +93 -0
  288. package/dist/internal/table/TableLayout.d.ts +17 -0
  289. package/dist/internal/table/TableLayout.js +29 -0
  290. package/dist/internal/table/TableLoadStatus.js +56 -0
  291. package/dist/internal/table/TableMobile.js +488 -0
  292. package/dist/internal/table/TruncatedCell.js +33 -0
  293. package/dist/internal/table/emptyValue.js +10 -0
  294. package/dist/internal/table/features.d.ts +41 -0
  295. package/dist/internal/table/features.js +31 -0
  296. package/dist/internal/table/recipes.js +227 -0
  297. package/dist/internal/table/rowClick.js +9 -0
  298. package/dist/internal/table/types.d.ts +325 -0
  299. package/dist/internal/table/types.js +13 -0
  300. package/dist/internal/tailwind-variants.d.ts +3 -0
  301. package/dist/internal/tailwind-variants.js +37 -0
  302. package/dist/internal/tooltipContext.js +5 -0
  303. package/dist/internal/tw-merge-config.generated.js +314 -0
  304. package/dist/internal/useAnchoredPanel.d.ts +87 -0
  305. package/dist/internal/useAnchoredPanel.js +108 -0
  306. package/dist/internal/useCountUp.js +53 -0
  307. package/dist/internal/useDateFieldTrigger.js +183 -0
  308. package/dist/internal/useEChart.js +59 -0
  309. package/dist/internal/useEnterOnView.js +42 -0
  310. package/dist/internal/useFloatingBar.js +100 -0
  311. package/dist/internal/useFormReset.js +37 -0
  312. package/dist/internal/useIsMobile.js +44 -0
  313. package/dist/internal/useOneRowOverflow.js +88 -0
  314. package/dist/internal/usePrefersReducedMotion.js +25 -0
  315. package/dist/internal/useReturnFocus.js +26 -0
  316. package/dist/internal/utils.d.ts +7 -0
  317. package/dist/internal/utils.js +58 -0
  318. package/dist/node_modules/@tanstack/store/dist/store.d.ts +29 -0
  319. package/dist/node_modules/@tanstack/store/dist/types.d.ts +38 -0
  320. package/dist/node_modules/@tanstack/table-core/dist/core/cells/coreCellsFeature.d.ts +6 -0
  321. package/dist/node_modules/@tanstack/table-core/dist/core/cells/coreCellsFeature.types.d.ts +53 -0
  322. package/dist/node_modules/@tanstack/table-core/dist/core/columns/coreColumnsFeature.d.ts +6 -0
  323. package/dist/node_modules/@tanstack/table-core/dist/core/columns/coreColumnsFeature.types.d.ts +90 -0
  324. package/dist/node_modules/@tanstack/table-core/dist/core/coreFeatures.d.ts +17 -0
  325. package/dist/node_modules/@tanstack/table-core/dist/core/headers/coreHeadersFeature.d.ts +6 -0
  326. package/dist/node_modules/@tanstack/table-core/dist/core/headers/coreHeadersFeature.types.d.ts +114 -0
  327. package/dist/node_modules/@tanstack/table-core/dist/core/reactivity/coreReactivityFeature.types.d.ts +51 -0
  328. package/dist/node_modules/@tanstack/table-core/dist/core/row-models/coreRowModelsFeature.d.ts +6 -0
  329. package/dist/node_modules/@tanstack/table-core/dist/core/row-models/coreRowModelsFeature.types.d.ts +29 -0
  330. package/dist/node_modules/@tanstack/table-core/dist/core/rows/coreRowsFeature.d.ts +6 -0
  331. package/dist/node_modules/@tanstack/table-core/dist/core/rows/coreRowsFeature.types.d.ts +129 -0
  332. package/dist/node_modules/@tanstack/table-core/dist/core/table/coreTablesFeature.d.ts +6 -0
  333. package/dist/node_modules/@tanstack/table-core/dist/core/table/coreTablesFeature.types.d.ts +203 -0
  334. package/dist/node_modules/@tanstack/table-core/dist/features/cell-selection/cellSelectionFeature.d.ts +6 -0
  335. package/dist/node_modules/@tanstack/table-core/dist/features/cell-selection/cellSelectionFeature.types.d.ts +294 -0
  336. package/dist/node_modules/@tanstack/table-core/dist/features/cell-spanning/cellSpanningFeature.d.ts +11 -0
  337. package/dist/node_modules/@tanstack/table-core/dist/features/cell-spanning/cellSpanningFeature.types.d.ts +148 -0
  338. package/dist/node_modules/@tanstack/table-core/dist/features/column-faceting/columnFacetingFeature.d.ts +12 -0
  339. package/dist/node_modules/@tanstack/table-core/dist/features/column-faceting/columnFacetingFeature.types.d.ts +63 -0
  340. package/dist/node_modules/@tanstack/table-core/dist/features/column-filtering/columnFilteringFeature.d.ts +6 -0
  341. package/dist/node_modules/@tanstack/table-core/dist/features/column-filtering/columnFilteringFeature.types.d.ts +209 -0
  342. package/dist/node_modules/@tanstack/table-core/dist/features/column-filtering/filterFns.d.ts +35 -0
  343. package/dist/node_modules/@tanstack/table-core/dist/features/column-grouping/columnGroupingFeature.d.ts +6 -0
  344. package/dist/node_modules/@tanstack/table-core/dist/features/column-grouping/columnGroupingFeature.types.d.ts +128 -0
  345. package/dist/node_modules/@tanstack/table-core/dist/features/column-ordering/columnOrderingFeature.d.ts +6 -0
  346. package/dist/node_modules/@tanstack/table-core/dist/features/column-ordering/columnOrderingFeature.types.d.ts +82 -0
  347. package/dist/node_modules/@tanstack/table-core/dist/features/column-pinning/columnPinningFeature.d.ts +11 -0
  348. package/dist/node_modules/@tanstack/table-core/dist/features/column-pinning/columnPinningFeature.types.d.ts +195 -0
  349. package/dist/node_modules/@tanstack/table-core/dist/features/column-resizing/columnResizingFeature.d.ts +6 -0
  350. package/dist/node_modules/@tanstack/table-core/dist/features/column-resizing/columnResizingFeature.types.d.ts +73 -0
  351. package/dist/node_modules/@tanstack/table-core/dist/features/column-sizing/columnSizingFeature.d.ts +6 -0
  352. package/dist/node_modules/@tanstack/table-core/dist/features/column-sizing/columnSizingFeature.types.d.ts +134 -0
  353. package/dist/node_modules/@tanstack/table-core/dist/features/column-visibility/columnVisibilityFeature.d.ts +6 -0
  354. package/dist/node_modules/@tanstack/table-core/dist/features/column-visibility/columnVisibilityFeature.types.d.ts +92 -0
  355. package/dist/node_modules/@tanstack/table-core/dist/features/global-filtering/globalFilteringFeature.d.ts +6 -0
  356. package/dist/node_modules/@tanstack/table-core/dist/features/global-filtering/globalFilteringFeature.types.d.ts +67 -0
  357. package/dist/node_modules/@tanstack/table-core/dist/features/row-aggregation/aggregationFns.d.ts +23 -0
  358. package/dist/node_modules/@tanstack/table-core/dist/features/row-aggregation/rowAggregationFeature.d.ts +6 -0
  359. package/dist/node_modules/@tanstack/table-core/dist/features/row-aggregation/rowAggregationFeature.types.d.ts +183 -0
  360. package/dist/node_modules/@tanstack/table-core/dist/features/row-aggregation/rowAggregationFeature.utils.d.ts +18 -0
  361. package/dist/node_modules/@tanstack/table-core/dist/features/row-expanding/rowExpandingFeature.d.ts +6 -0
  362. package/dist/node_modules/@tanstack/table-core/dist/features/row-expanding/rowExpandingFeature.types.d.ts +125 -0
  363. package/dist/node_modules/@tanstack/table-core/dist/features/row-pagination/rowPaginationFeature.d.ts +6 -0
  364. package/dist/node_modules/@tanstack/table-core/dist/features/row-pagination/rowPaginationFeature.types.d.ts +135 -0
  365. package/dist/node_modules/@tanstack/table-core/dist/features/row-pinning/rowPinningFeature.d.ts +6 -0
  366. package/dist/node_modules/@tanstack/table-core/dist/features/row-pinning/rowPinningFeature.types.d.ts +76 -0
  367. package/dist/node_modules/@tanstack/table-core/dist/features/row-selection/rowSelectionFeature.d.ts +6 -0
  368. package/dist/node_modules/@tanstack/table-core/dist/features/row-selection/rowSelectionFeature.types.d.ts +187 -0
  369. package/dist/node_modules/@tanstack/table-core/dist/features/row-sorting/rowSortingFeature.d.ts +6 -0
  370. package/dist/node_modules/@tanstack/table-core/dist/features/row-sorting/rowSortingFeature.types.d.ts +236 -0
  371. package/dist/node_modules/@tanstack/table-core/dist/features/row-sorting/sortFns.d.ts +23 -0
  372. package/dist/node_modules/@tanstack/table-core/dist/features/stockFeatures.d.ts +37 -0
  373. package/dist/node_modules/@tanstack/table-core/dist/helpers/columnHelper.d.ts +47 -0
  374. package/dist/node_modules/@tanstack/table-core/dist/types/Cell.d.ts +16 -0
  375. package/dist/node_modules/@tanstack/table-core/dist/types/Column.d.ts +30 -0
  376. package/dist/node_modules/@tanstack/table-core/dist/types/ColumnDef.d.ts +123 -0
  377. package/dist/node_modules/@tanstack/table-core/dist/types/Header.d.ts +12 -0
  378. package/dist/node_modules/@tanstack/table-core/dist/types/HeaderGroup.d.ts +6 -0
  379. package/dist/node_modules/@tanstack/table-core/dist/types/Row.d.ts +24 -0
  380. package/dist/node_modules/@tanstack/table-core/dist/types/RowModel.d.ts +19 -0
  381. package/dist/node_modules/@tanstack/table-core/dist/types/RowModelFns.d.ts +11 -0
  382. package/dist/node_modules/@tanstack/table-core/dist/types/Table.d.ts +53 -0
  383. package/dist/node_modules/@tanstack/table-core/dist/types/TableFeatures.d.ts +416 -0
  384. package/dist/node_modules/@tanstack/table-core/dist/types/TableOptions.d.ts +78 -0
  385. package/dist/node_modules/@tanstack/table-core/dist/types/TableState.d.ts +46 -0
  386. package/dist/node_modules/@tanstack/table-core/dist/types/type-utils.d.ts +25 -0
  387. package/dist/shared.css +179 -0
  388. package/dist/styles.css +5467 -0
  389. package/dist/theme.css +314 -0
  390. package/dist/theme.map.json +278 -0
  391. package/dist/tokens/index.d.ts +2 -0
  392. package/dist/tokens/index.js +1 -0
  393. package/dist/tokens/tokens.generated.d.ts +2040 -0
  394. package/dist/tokens/tokens.generated.js +2053 -0
  395. package/dist/tokens.css +484 -0
  396. package/dist/tokens.flat.json +429 -0
  397. package/docs/Consuming.mdx +379 -0
  398. package/docs/Contributing.mdx +78 -0
  399. package/docs/ForAgents.mdx +53 -0
  400. package/docs/Introduction.mdx +54 -0
  401. package/llms.txt +556 -0
  402. package/package.json +357 -4
  403. package/src/components/action-row/ActionRow.mdx +686 -0
  404. package/src/components/action-row/ActionRow.stories.tsx +669 -0
  405. package/src/components/action-row/ActionRow.tsx +632 -0
  406. package/src/components/action-row/index.ts +9 -0
  407. package/src/components/alert/Alert.mdx +377 -0
  408. package/src/components/alert/Alert.stories.tsx +674 -0
  409. package/src/components/alert/Alert.tsx +579 -0
  410. package/src/components/alert/index.ts +13 -0
  411. package/src/components/anchored-panel/AnchoredPanel.mdx +381 -0
  412. package/src/components/anchored-panel/AnchoredPanel.stories.tsx +593 -0
  413. package/src/components/anchored-panel/AnchoredPanel.tsx +176 -0
  414. package/src/components/anchored-panel/index.ts +15 -0
  415. package/src/components/badge/Badge.mdx +487 -0
  416. package/src/components/badge/Badge.stories.tsx +375 -0
  417. package/src/components/badge/Badge.tsx +360 -0
  418. package/src/components/badge/index.ts +10 -0
  419. package/src/components/banner/Banner.mdx +704 -0
  420. package/src/components/banner/Banner.stories.tsx +448 -0
  421. package/src/components/banner/Banner.tsx +602 -0
  422. package/src/components/banner/index.ts +14 -0
  423. package/src/components/button/Button.mdx +286 -0
  424. package/src/components/button/Button.stories.tsx +381 -0
  425. package/src/components/button/Button.tsx +384 -0
  426. package/src/components/button/index.ts +1 -0
  427. package/src/components/button-group/ButtonGroup.mdx +512 -0
  428. package/src/components/button-group/ButtonGroup.stories.tsx +714 -0
  429. package/src/components/button-group/ButtonGroup.tsx +491 -0
  430. package/src/components/button-group/index.ts +10 -0
  431. package/src/components/card-select/CardSelect.mdx +662 -0
  432. package/src/components/card-select/CardSelect.stories.tsx +784 -0
  433. package/src/components/card-select/CardSelect.tsx +783 -0
  434. package/src/components/card-select/CardSelectGroup.tsx +169 -0
  435. package/src/components/card-select/index.ts +18 -0
  436. package/src/components/checkbox/Checkbox.mdx +269 -0
  437. package/src/components/checkbox/Checkbox.stories.tsx +306 -0
  438. package/src/components/checkbox/Checkbox.tsx +343 -0
  439. package/src/components/checkbox/index.ts +1 -0
  440. package/src/components/chip/Chip.mdx +683 -0
  441. package/src/components/chip/Chip.stories.tsx +734 -0
  442. package/src/components/chip/Chip.tsx +732 -0
  443. package/src/components/chip/index.ts +9 -0
  444. package/src/components/column-header/ColumnHeader.mdx +301 -0
  445. package/src/components/column-header/ColumnHeader.stories.tsx +319 -0
  446. package/src/components/column-header/ColumnHeader.tsx +287 -0
  447. package/src/components/column-header/index.ts +7 -0
  448. package/src/components/combobox-field/Combobox.tsx +693 -0
  449. package/src/components/combobox-field/ComboboxField.mdx +525 -0
  450. package/src/components/combobox-field/ComboboxField.stories.tsx +502 -0
  451. package/src/components/combobox-field/ComboboxField.tsx +259 -0
  452. package/src/components/combobox-field/index.ts +12 -0
  453. package/src/components/date-field/DateField.mdx +340 -0
  454. package/src/components/date-field/DateField.stories.tsx +221 -0
  455. package/src/components/date-field/DateField.tsx +176 -0
  456. package/src/components/date-field/index.ts +1 -0
  457. package/src/components/date-picker/DatePicker.mdx +436 -0
  458. package/src/components/date-picker/DatePicker.stories.tsx +458 -0
  459. package/src/components/date-picker/DatePicker.tsx +688 -0
  460. package/src/components/date-picker/index.ts +9 -0
  461. package/src/components/divider/Divider.mdx +256 -0
  462. package/src/components/divider/Divider.stories.tsx +177 -0
  463. package/src/components/divider/Divider.tsx +193 -0
  464. package/src/components/divider/index.ts +1 -0
  465. package/src/components/drawer/Drawer.mdx +518 -0
  466. package/src/components/drawer/Drawer.stories.tsx +392 -0
  467. package/src/components/drawer/Drawer.tsx +683 -0
  468. package/src/components/drawer/index.ts +1 -0
  469. package/src/components/dropdown-button/DropdownButton.mdx +285 -0
  470. package/src/components/dropdown-button/DropdownButton.stories.tsx +398 -0
  471. package/src/components/dropdown-button/DropdownButton.tsx +198 -0
  472. package/src/components/dropdown-button/index.ts +7 -0
  473. package/src/components/faq/FAQ.mdx +364 -0
  474. package/src/components/faq/FAQ.stories.tsx +343 -0
  475. package/src/components/faq/FAQ.tsx +337 -0
  476. package/src/components/faq/index.ts +1 -0
  477. package/src/components/field/Field.mdx +129 -0
  478. package/src/components/field/Field.stories.tsx +461 -0
  479. package/src/components/field/Field.tsx +765 -0
  480. package/src/components/field/index.ts +20 -0
  481. package/src/components/field-pair/FieldPair.mdx +308 -0
  482. package/src/components/field-pair/FieldPair.stories.tsx +530 -0
  483. package/src/components/field-pair/FieldPair.tsx +796 -0
  484. package/src/components/field-pair/index.ts +9 -0
  485. package/src/components/file-upload/FileUpload.mdx +345 -0
  486. package/src/components/file-upload/FileUpload.stories.tsx +698 -0
  487. package/src/components/file-upload/FileUpload.tsx +802 -0
  488. package/src/components/file-upload/index.ts +6 -0
  489. package/src/components/filter-chip/FilterChip.mdx +778 -0
  490. package/src/components/filter-chip/FilterChip.stories.tsx +827 -0
  491. package/src/components/filter-chip/FilterChip.tsx +881 -0
  492. package/src/components/filter-chip/index.ts +11 -0
  493. package/src/components/filter-facet/FilterFacet.mdx +536 -0
  494. package/src/components/filter-facet/FilterFacet.stories.tsx +506 -0
  495. package/src/components/filter-facet/FilterFacet.tsx +1160 -0
  496. package/src/components/filter-facet/index.ts +7 -0
  497. package/src/components/firm-avatar/FirmAvatar.mdx +280 -0
  498. package/src/components/firm-avatar/FirmAvatar.stories.tsx +147 -0
  499. package/src/components/firm-avatar/FirmAvatar.tsx +172 -0
  500. package/src/components/firm-avatar/index.ts +7 -0
  501. package/src/components/form-actions/FormActions.mdx +518 -0
  502. package/src/components/form-actions/FormActions.stories.tsx +621 -0
  503. package/src/components/form-actions/FormActions.tsx +273 -0
  504. package/src/components/form-actions/index.ts +6 -0
  505. package/src/components/form-block/FormBlock.mdx +728 -0
  506. package/src/components/form-block/FormBlock.stories.tsx +813 -0
  507. package/src/components/form-block/FormBlock.tsx +679 -0
  508. package/src/components/form-block/index.ts +13 -0
  509. package/src/components/form-section/FormSection.mdx +436 -0
  510. package/src/components/form-section/FormSection.stories.tsx +407 -0
  511. package/src/components/form-section/FormSection.tsx +290 -0
  512. package/src/components/form-section/index.ts +17 -0
  513. package/src/components/heading/Heading.mdx +206 -0
  514. package/src/components/heading/Heading.stories.tsx +169 -0
  515. package/src/components/heading/Heading.tsx +124 -0
  516. package/src/components/heading/index.ts +8 -0
  517. package/src/components/heading-group/HeadingGroup.mdx +521 -0
  518. package/src/components/heading-group/HeadingGroup.stories.tsx +353 -0
  519. package/src/components/heading-group/HeadingGroup.tsx +396 -0
  520. package/src/components/heading-group/index.ts +7 -0
  521. package/src/components/hero/Hero.mdx +742 -0
  522. package/src/components/hero/Hero.stories.tsx +527 -0
  523. package/src/components/hero/Hero.tsx +807 -0
  524. package/src/components/hero/index.ts +1 -0
  525. package/src/components/icon/Icon.mdx +329 -0
  526. package/src/components/icon/Icon.stories.tsx +398 -0
  527. package/src/components/icon/Icon.tsx +97 -0
  528. package/src/components/icon/index.ts +2 -0
  529. package/src/components/icon-button/IconButton.mdx +206 -0
  530. package/src/components/icon-button/IconButton.stories.tsx +341 -0
  531. package/src/components/icon-button/IconButton.tsx +273 -0
  532. package/src/components/icon-button/index.ts +1 -0
  533. package/src/components/item-row/ItemRow.mdx +533 -0
  534. package/src/components/item-row/ItemRow.stories.tsx +434 -0
  535. package/src/components/item-row/ItemRow.tsx +676 -0
  536. package/src/components/item-row/index.ts +9 -0
  537. package/src/components/list-row/ListRow.mdx +404 -0
  538. package/src/components/list-row/ListRow.stories.tsx +404 -0
  539. package/src/components/list-row/ListRow.tsx +424 -0
  540. package/src/components/list-row/index.ts +1 -0
  541. package/src/components/menu/Menu.mdx +268 -0
  542. package/src/components/menu/Menu.stories.tsx +455 -0
  543. package/src/components/menu/Menu.tsx +452 -0
  544. package/src/components/menu/index.ts +1 -0
  545. package/src/components/modal/Modal.mdx +854 -0
  546. package/src/components/modal/Modal.stories.tsx +881 -0
  547. package/src/components/modal/Modal.tsx +1434 -0
  548. package/src/components/modal/index.ts +1 -0
  549. package/src/components/nav-link/NavLink.mdx +196 -0
  550. package/src/components/nav-link/NavLink.stories.tsx +243 -0
  551. package/src/components/nav-link/NavLink.tsx +222 -0
  552. package/src/components/nav-link/index.ts +1 -0
  553. package/src/components/number-field/NumberField.mdx +223 -0
  554. package/src/components/number-field/NumberField.stories.tsx +291 -0
  555. package/src/components/number-field/NumberField.tsx +388 -0
  556. package/src/components/number-field/index.ts +6 -0
  557. package/src/components/pagination/Pagination.mdx +305 -0
  558. package/src/components/pagination/Pagination.stories.tsx +333 -0
  559. package/src/components/pagination/Pagination.tsx +343 -0
  560. package/src/components/pagination/index.ts +8 -0
  561. package/src/components/popover-surface/PopoverSurface.mdx +158 -0
  562. package/src/components/popover-surface/PopoverSurface.stories.tsx +421 -0
  563. package/src/components/popover-surface/index.ts +1 -0
  564. package/src/components/progress-bar/ProgressBar.mdx +802 -0
  565. package/src/components/progress-bar/ProgressBar.stories.tsx +533 -0
  566. package/src/components/progress-bar/ProgressBar.tsx +654 -0
  567. package/src/components/progress-bar/index.ts +9 -0
  568. package/src/components/promo-sticker/PromoSticker.mdx +436 -0
  569. package/src/components/promo-sticker/PromoSticker.stories.tsx +363 -0
  570. package/src/components/promo-sticker/PromoSticker.tsx +313 -0
  571. package/src/components/promo-sticker/index.ts +7 -0
  572. package/src/components/promo-surface/PromoSurface.mdx +399 -0
  573. package/src/components/promo-surface/PromoSurface.stories.tsx +270 -0
  574. package/src/components/promo-surface/PromoSurface.tsx +305 -0
  575. package/src/components/promo-surface/index.ts +7 -0
  576. package/src/components/radio/Radio.mdx +243 -0
  577. package/src/components/radio/Radio.stories.tsx +307 -0
  578. package/src/components/radio/Radio.tsx +288 -0
  579. package/src/components/radio/index.ts +1 -0
  580. package/src/components/radio-group/RadioGroup.mdx +119 -0
  581. package/src/components/radio-group/RadioGroup.stories.tsx +225 -0
  582. package/src/components/radio-group/RadioGroup.tsx +139 -0
  583. package/src/components/radio-group/index.ts +1 -0
  584. package/src/components/select/Select.mdx +241 -0
  585. package/src/components/select/Select.stories.tsx +404 -0
  586. package/src/components/select/Select.tsx +381 -0
  587. package/src/components/select/index.ts +1 -0
  588. package/src/components/select-field/SelectField.mdx +324 -0
  589. package/src/components/select-field/SelectField.stories.tsx +460 -0
  590. package/src/components/select-field/SelectField.tsx +138 -0
  591. package/src/components/select-field/index.ts +1 -0
  592. package/src/components/skeleton/Skeleton.mdx +194 -0
  593. package/src/components/skeleton/Skeleton.stories.tsx +260 -0
  594. package/src/components/skeleton/Skeleton.tsx +107 -0
  595. package/src/components/skeleton/index.ts +1 -0
  596. package/src/components/split-button/SplitButton.mdx +445 -0
  597. package/src/components/split-button/SplitButton.stories.tsx +465 -0
  598. package/src/components/split-button/SplitButton.tsx +361 -0
  599. package/src/components/split-button/index.ts +7 -0
  600. package/src/components/status-summary-bar/StatusSummaryBar.mdx +338 -0
  601. package/src/components/status-summary-bar/StatusSummaryBar.stories.tsx +408 -0
  602. package/src/components/status-summary-bar/StatusSummaryBar.tsx +428 -0
  603. package/src/components/status-summary-bar/index.ts +8 -0
  604. package/src/components/subject-lookup-field/SubjectLookupField.mdx +378 -0
  605. package/src/components/subject-lookup-field/SubjectLookupField.stories.tsx +393 -0
  606. package/src/components/subject-lookup-field/SubjectLookupField.tsx +1079 -0
  607. package/src/components/subject-lookup-field/index.ts +11 -0
  608. package/src/components/switch/Switch.mdx +376 -0
  609. package/src/components/switch/Switch.stories.tsx +296 -0
  610. package/src/components/switch/Switch.tsx +483 -0
  611. package/src/components/switch/index.ts +1 -0
  612. package/src/components/table/Table.mdx +575 -0
  613. package/src/components/table/Table.stories.tsx +1049 -0
  614. package/src/components/table/Table.tsx +745 -0
  615. package/src/components/table/TableConsumers.stories.tsx +195 -0
  616. package/src/components/table/_tableFixtures.ts +1189 -0
  617. package/src/components/table/index.ts +22 -0
  618. package/src/components/text-field/TextField.mdx +479 -0
  619. package/src/components/text-field/TextField.stories.tsx +366 -0
  620. package/src/components/text-field/TextField.tsx +391 -0
  621. package/src/components/text-field/index.ts +8 -0
  622. package/src/components/text-link/TextLink.mdx +353 -0
  623. package/src/components/text-link/TextLink.stories.tsx +458 -0
  624. package/src/components/text-link/TextLink.tsx +504 -0
  625. package/src/components/text-link/index.ts +10 -0
  626. package/src/components/textarea/Textarea.mdx +244 -0
  627. package/src/components/textarea/Textarea.stories.tsx +371 -0
  628. package/src/components/textarea/Textarea.tsx +489 -0
  629. package/src/components/textarea/index.ts +9 -0
  630. package/src/components/tooltip/Tooltip.mdx +462 -0
  631. package/src/components/tooltip/Tooltip.stories.tsx +500 -0
  632. package/src/components/tooltip/Tooltip.tsx +756 -0
  633. package/src/components/tooltip/index.ts +13 -0
  634. package/src/components/unit-field/UnitField.mdx +215 -0
  635. package/src/components/unit-field/UnitField.stories.tsx +291 -0
  636. package/src/components/unit-field/UnitField.tsx +255 -0
  637. package/src/components/unit-field/index.ts +7 -0
  638. package/src/icons/icon-registry.generated.ts +510 -0
  639. package/src/icons/icon-types.generated.ts +256 -0
  640. package/src/index.ts +71 -0
  641. package/src/internal/BottomSheet.tsx +714 -0
  642. package/src/internal/FodsProvider.tsx +36 -0
  643. package/src/internal/MotionCaret.tsx +53 -0
  644. package/src/internal/NumberFormatInput.tsx +276 -0
  645. package/src/internal/SummaryDonut.tsx +359 -0
  646. package/src/internal/buttonSegment.ts +241 -0
  647. package/src/internal/collapseRoom.ts +130 -0
  648. package/src/internal/comboboxKeys.ts +90 -0
  649. package/src/internal/contentPresence.ts +46 -0
  650. package/src/internal/dayCell.ts +274 -0
  651. package/src/internal/dialogPortal.ts +50 -0
  652. package/src/internal/donutSweeps.ts +77 -0
  653. package/src/internal/enterOnViewGeometry.ts +53 -0
  654. package/src/internal/faqItem.ts +104 -0
  655. package/src/internal/floatingLabelMotion.tsx +109 -0
  656. package/src/internal/formBlockContext.ts +27 -0
  657. package/src/internal/heightRoom.ts +135 -0
  658. package/src/internal/numberSeparators.ts +93 -0
  659. package/src/internal/overlayMotion.tsx +32 -0
  660. package/src/internal/paginationItem.ts +106 -0
  661. package/src/internal/popoverSurface.ts +78 -0
  662. package/src/internal/portalContainer.ts +11 -0
  663. package/src/internal/progressBarItem.ts +356 -0
  664. package/src/internal/selectionControlText.ts +42 -0
  665. package/src/internal/statusSummaryParts.tsx +475 -0
  666. package/src/internal/summaryMotion.ts +111 -0
  667. package/src/internal/table/ChildConnector.tsx +57 -0
  668. package/src/internal/table/ChildRowPrefix.tsx +21 -0
  669. package/src/internal/table/ColumnSettings.tsx +194 -0
  670. package/src/internal/table/ScrollRegion.tsx +176 -0
  671. package/src/internal/table/TableEmpty.tsx +99 -0
  672. package/src/internal/table/TableLayout.tsx +29 -0
  673. package/src/internal/table/TableLoadStatus.tsx +60 -0
  674. package/src/internal/table/TableMobile.tsx +582 -0
  675. package/src/internal/table/TruncatedCell.tsx +35 -0
  676. package/src/internal/table/emptyValue.ts +11 -0
  677. package/src/internal/table/features.ts +44 -0
  678. package/src/internal/table/recipes.ts +263 -0
  679. package/src/internal/table/rowClick.ts +8 -0
  680. package/src/internal/table/types.ts +342 -0
  681. package/src/internal/tailwind-variants.ts +65 -0
  682. package/src/internal/tooltipContext.ts +15 -0
  683. package/src/internal/tw-merge-config.generated.ts +275 -0
  684. package/src/internal/useAnchoredPanel.ts +340 -0
  685. package/src/internal/useCountUp.ts +65 -0
  686. package/src/internal/useDateFieldTrigger.tsx +357 -0
  687. package/src/internal/useEChart.ts +88 -0
  688. package/src/internal/useEnterOnView.ts +80 -0
  689. package/src/internal/useFloatingBar.ts +125 -0
  690. package/src/internal/useFormReset.ts +47 -0
  691. package/src/internal/useIsMobile.ts +64 -0
  692. package/src/internal/useNoImplicitSubmit.ts +41 -0
  693. package/src/internal/useOneRowOverflow.ts +103 -0
  694. package/src/internal/usePrefersReducedMotion.ts +27 -0
  695. package/src/internal/useReturnFocus.ts +34 -0
  696. package/src/internal/utils.ts +58 -0
  697. package/src/recipes/EmptyState.stories.tsx +105 -0
  698. package/src/recipes/Form.stories.tsx +355 -0
  699. package/src/recipes/ModalWithForm.stories.tsx +219 -0
  700. package/src/recipes/Recipes.mdx +61 -0
  701. package/src/recipes/TableWithFilters.stories.tsx +278 -0
  702. package/src/storybook/FodsFamily.tsx +39 -0
  703. package/src/storybook/Section.tsx +36 -0
  704. package/src/storybook/a11y.ts +24 -0
  705. package/src/storybook/assets/banner-character-bartender.webp +0 -0
  706. package/src/storybook/assets/banner-invoice-sheet-left.webp +0 -0
  707. package/src/storybook/assets/banner-invoice-sheet-right.webp +0 -0
  708. package/src/storybook/assets/invoice-hero.webp +0 -0
  709. package/src/storybook/assets/invoice.webp +0 -0
  710. package/src/storybook/assets/section-document-info.svg +21 -0
  711. package/src/storybook/assets/section-gear-checklist.svg +11 -0
  712. package/src/storybook/assets/section-person-arrow-in.svg +15 -0
  713. package/src/storybook/assets/section-person-arrow-out.svg +22 -0
  714. package/src/storybook/assets/section-receipt-dollar.svg +23 -0
  715. package/src/storybook/assets/table-empty-folder-empty.png +0 -0
  716. package/src/storybook/assets/table-empty-folder-magnifying-glass.png +0 -0
  717. package/src/storybook/assets/table-empty-funnel.png +0 -0
  718. package/src/storybook/assets/table-empty-load-failed.png +0 -0
  719. package/src/storybook/assets/wallet-spot.png +0 -0
  720. package/src/storybook/assets.d.ts +17 -0
  721. package/src/storybook/componentDoc.ts +41 -0
  722. package/src/storybook/fitFrame.tsx +70 -0
  723. package/src/storybook/forceStates.tsx +647 -0
  724. package/src/storybook/illustrations.tsx +66 -0
  725. package/src/storybook/viewportFrame.tsx +58 -0
  726. package/src/styles/assets/label-brush-1.svg +6 -0
  727. package/src/styles/assets/pattern-dark.svg +113 -0
  728. package/src/styles/base.css +106 -0
  729. package/src/styles/index.css +15 -0
  730. package/src/styles/motion.css +157 -0
  731. package/src/styles/promo-sticker.css +27 -0
  732. package/src/styles/promo-surface.css +49 -0
  733. package/src/styles/shared.css +11 -0
  734. package/src/styles/theme.generated.css +314 -0
  735. package/src/styles/theme.map.json +278 -0
  736. package/src/styles/tracking.generated.css +12 -0
  737. package/src/tokens/index.ts +4 -0
  738. package/src/tokens/tokens.generated.ts +542 -0
@@ -0,0 +1,355 @@
1
+ import * as React from 'react';
2
+ import type { Meta, StoryObj } from '@storybook/react-vite';
3
+ import { expect, fn, userEvent, waitFor, within } from 'storybook/test';
4
+ import { Button } from '../components/button';
5
+ import { Field } from '../components/field';
6
+ import { FieldPair } from '../components/field-pair';
7
+ import { FormActions } from '../components/form-actions';
8
+ import { FormBlock } from '../components/form-block';
9
+ import { FormSection } from '../components/form-section';
10
+ import { HeadingGroup } from '../components/heading-group';
11
+ import { Icon } from '../components/icon';
12
+ import { Select, type SelectOption } from '../components/select';
13
+ import { TextField } from '../components/text-field';
14
+ import { Textarea } from '../components/textarea';
15
+ import { componentDoc } from '../storybook/componentDoc';
16
+ import { sectionIllustration } from '../storybook/illustrations';
17
+
18
+ /**
19
+ * A form page assembled the way spec/06-patterns/form-layout.md describes it: page frame →
20
+ * H1 zone → Form Blocks → Form Sections → field grid → Form Actions. Nothing here is a
21
+ * component; the recipe only owns the page background, the gutter and the gaps between the
22
+ * pieces, every other value comes from the composed components.
23
+ */
24
+
25
+ const CURRENCIES: SelectOption[] = [
26
+ { value: 'czk', label: 'CZK' },
27
+ { value: 'eur', label: 'EUR' },
28
+ ];
29
+
30
+ const PANEL_LABEL = 'Kalendář';
31
+ const NAV_LABELS = {
32
+ previousMonth: 'Předchozí měsíc',
33
+ nextMonth: 'Další měsíc',
34
+ previousYear: 'Předchozí rok',
35
+ nextYear: 'Další rok',
36
+ };
37
+
38
+ // A loose shape check: the form only has to tell a typo from an address; the server decides.
39
+ const EMAIL_SHAPE = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
40
+
41
+ // Input types on which Enter is the browser's implicit submission (form-actions
42
+ // `delivery.react`: Enter in a text field never commits, only an action button does).
43
+ const IMPLICIT_SUBMIT_TYPES = new Set(['text', 'search', 'url', 'tel', 'email', 'password', 'number']);
44
+
45
+ interface ContactDraft {
46
+ name: string;
47
+ ico: string;
48
+ email: string;
49
+ phone: string;
50
+ currency: string;
51
+ validFrom?: Date;
52
+ validTo?: Date;
53
+ note: string;
54
+ }
55
+
56
+ type RequiredField = 'name' | 'email';
57
+ type FormErrors = Partial<Record<RequiredField, string>>;
58
+
59
+ const EMPTY_DRAFT: ContactDraft = { name: '', ico: '', email: '', phone: '', currency: 'czk', note: '' };
60
+
61
+ /** Problem + fix, impersonal (text-field.md § Copy → Error). */
62
+ function validate(draft: ContactDraft): FormErrors {
63
+ const errors: FormErrors = {};
64
+ if (!draft.name.trim()) errors.name = 'Chybí název firmy';
65
+ if (!draft.email.trim()) errors.email = 'Chybí e‑mail';
66
+ else if (!EMAIL_SHAPE.test(draft.email.trim())) errors.email = 'E‑mail musí mít tvar jmeno@priklad.cz';
67
+ return errors;
68
+ }
69
+
70
+ /** Reading order of the required fields: the first invalid one takes focus on a failed submit. */
71
+ const FIELD_ORDER: RequiredField[] = ['name', 'email'];
72
+
73
+ interface ContactFormProps {
74
+ onSubmit: (draft: ContactDraft) => void;
75
+ }
76
+
77
+ function ContactForm({ onSubmit }: ContactFormProps) {
78
+ const ids = {
79
+ name: React.useId(),
80
+ ico: React.useId(),
81
+ email: React.useId(),
82
+ phone: React.useId(),
83
+ currency: React.useId(),
84
+ note: React.useId(),
85
+ title: React.useId(),
86
+ // FieldPair cells take no ref; a cell `id` lands on its input, so the range is focused by id.
87
+ validFrom: React.useId(),
88
+ };
89
+ const inputs = {
90
+ name: React.useRef<HTMLInputElement>(null),
91
+ email: React.useRef<HTMLInputElement>(null),
92
+ };
93
+ const [draft, setDraft] = React.useState<ContactDraft>(EMPTY_DRAFT);
94
+ // Errors show only after the first submit; from then on they follow the typing.
95
+ const [submitted, setSubmitted] = React.useState(false);
96
+ const errors = submitted ? validate(draft) : {};
97
+
98
+ const update = <K extends keyof ContactDraft>(key: K, value: ContactDraft[K]) =>
99
+ setDraft(current => ({ ...current, [key]: value }));
100
+
101
+ // «Zrušit» clears the errors too: they must not re-appear on the cleared form.
102
+ const reset = () => {
103
+ setDraft(EMPTY_DRAFT);
104
+ setSubmitted(false);
105
+ };
106
+
107
+ const rangeInvalid = Boolean(draft.validFrom && draft.validTo && draft.validTo < draft.validFrom);
108
+
109
+ const handleSubmit = (event: React.FormEvent<HTMLFormElement>) => {
110
+ event.preventDefault();
111
+ setSubmitted(true);
112
+ const found = validate(draft);
113
+ const firstInvalid = FIELD_ORDER.find(key => found[key]);
114
+ if (firstInvalid || rangeInvalid) {
115
+ // form-layout.md § Build checklist 7: a failed submit focuses the first invalid field.
116
+ // The required fields come first in reading order; the range is the last candidate.
117
+ if (firstInvalid) inputs[firstInvalid].current?.focus();
118
+ else document.getElementById(ids.validFrom)?.focus();
119
+ return;
120
+ }
121
+ onSubmit(draft);
122
+ };
123
+
124
+ // The package keeps its implicit-submission guard private, so the page form cancels Enter
125
+ // itself. A field that handled Enter (a picker opening) has already prevented it.
126
+ const handleKeyDown = (event: React.KeyboardEvent<HTMLFormElement>) => {
127
+ const target = event.target;
128
+ if (event.key !== 'Enter' || event.defaultPrevented || event.nativeEvent.isComposing) return;
129
+ if (target instanceof HTMLInputElement && IMPLICIT_SUBMIT_TYPES.has(target.type)) event.preventDefault();
130
+ };
131
+
132
+ return (
133
+ // Page frame (form-layout.md § Page frame): --bg-secondary, side gutter 32 at MD and 40
134
+ // at LG/XL, none below MD, where the tiles run full-bleed and carry it themselves.
135
+ <div className="w-full bg-background-secondary py-800 md:px-900 lg:px-1000">
136
+ {/* The one page column, capped at --ds-content-wide; H1 zone → first block --space-900. */}
137
+ <div className="mx-auto flex w-full max-w-content-wide flex-col gap-900">
138
+ {/* H1 zone: Heading Group Size=H2 rendered as h1. Below MD it takes the page gutter
139
+ as its own inline padding (24 at SM, 16 at Mobile), lining up with the tiles. */}
140
+ <HeadingGroup
141
+ level={1}
142
+ size="h2"
143
+ heading="Nový kontakt"
144
+ headingId={ids.title}
145
+ className="px-600 sm:px-800 md:px-0"
146
+ />
147
+ <form
148
+ noValidate
149
+ aria-labelledby={ids.title}
150
+ onSubmit={handleSubmit}
151
+ onKeyDown={handleKeyDown}
152
+ // Block ↔ block gap: --space-800 below MD, --space-900 from MD (form-layout.md).
153
+ className="flex flex-col gap-800 md:gap-900"
154
+ >
155
+ <FormBlock title="Kontaktní údaje" illustration={sectionIllustration('person-arrow-in')}>
156
+ <FormSection>
157
+ <Field label="Název firmy" error={errors.name}>
158
+ <TextField
159
+ ref={inputs.name}
160
+ id={ids.name}
161
+ required
162
+ autoComplete="organization"
163
+ value={draft.name}
164
+ onChange={event => update('name', event.target.value)}
165
+ />
166
+ </Field>
167
+ <Field label="IČO" optionalLabel="Volitelný">
168
+ <TextField
169
+ id={ids.ico}
170
+ inputMode="numeric"
171
+ placeholder="12345678"
172
+ value={draft.ico}
173
+ onChange={event => update('ico', event.target.value)}
174
+ />
175
+ </Field>
176
+ <Field label="E‑mail" error={errors.email}>
177
+ <TextField
178
+ ref={inputs.email}
179
+ id={ids.email}
180
+ required
181
+ type="email"
182
+ autoComplete="email"
183
+ value={draft.email}
184
+ onChange={event => update('email', event.target.value)}
185
+ />
186
+ </Field>
187
+ <Field label="Telefon" optionalLabel="Volitelný">
188
+ <TextField
189
+ id={ids.phone}
190
+ type="tel"
191
+ autoComplete="tel"
192
+ value={draft.phone}
193
+ onChange={event => update('phone', event.target.value)}
194
+ />
195
+ </Field>
196
+ </FormSection>
197
+ </FormBlock>
198
+
199
+ <FormBlock title="Smlouva" illustration={sectionIllustration('document-info')}>
200
+ <FormSection>
201
+ <Field label="Měna">
202
+ <Select
203
+ id={ids.currency}
204
+ options={CURRENCIES}
205
+ value={draft.currency}
206
+ onValueChange={value => update('currency', value)}
207
+ />
208
+ </Field>
209
+ <FieldPair
210
+ format="date"
211
+ showUnit={false}
212
+ label="Platnost"
213
+ panelLabel={PANEL_LABEL}
214
+ navLabels={NAV_LABELS}
215
+ from={{
216
+ id: ids.validFrom,
217
+ label: 'od',
218
+ value: draft.validFrom,
219
+ onValueChange: value => update('validFrom', value),
220
+ error: rangeInvalid,
221
+ }}
222
+ to={{
223
+ label: 'do',
224
+ value: draft.validTo,
225
+ onValueChange: value => update('validTo', value),
226
+ error: rangeInvalid,
227
+ }}
228
+ error={rangeInvalid ? '„Od“ musí být před „Do“' : undefined}
229
+ />
230
+ <FormSection.Cell span="full">
231
+ <Field label="Poznámka" optionalLabel="Volitelný">
232
+ <Textarea
233
+ id={ids.note}
234
+ minRows={3}
235
+ value={draft.note}
236
+ onChange={event => update('note', event.target.value)}
237
+ />
238
+ </Field>
239
+ </FormSection.Cell>
240
+ </FormSection>
241
+ </FormBlock>
242
+
243
+ {/* One bar, directly after the last block; the Brand primary last. */}
244
+ <FormActions>
245
+ <Button type="button" variant="secondary" size="lg" onClick={reset}>
246
+ Zrušit
247
+ </Button>
248
+ <FormActions.Spacer />
249
+ <Button type="submit" variant="brand" size="lg" leadingIcon={<Icon name="floppy-disk" />}>
250
+ Uložit kontakt
251
+ </Button>
252
+ </FormActions>
253
+ </form>
254
+ </div>
255
+ </div>
256
+ );
257
+ }
258
+
259
+ const meta = {
260
+ title: 'Recipes/Form',
261
+ component: ContactForm,
262
+ args: { onSubmit: fn() },
263
+ parameters: {
264
+ layout: 'fullscreen',
265
+ controls: { disable: true },
266
+ docs: {
267
+ description: {
268
+ component: componentDoc({
269
+ summary:
270
+ 'A form page built from FormBlock, FormSection, Field with TextField / Select / Textarea, FieldPair and FormActions, laid out per the Form layout pattern. A recipe, not a component: nothing here is exported from the package.',
271
+ docsLink: { label: 'spec/06-patterns/form-layout.md' },
272
+ }),
273
+ },
274
+ },
275
+ },
276
+ } satisfies Meta<typeof ContactForm>;
277
+
278
+ export default meta;
279
+
280
+ type Story = StoryObj<typeof meta>;
281
+
282
+ /**
283
+ * Enter in a text field does not submit; submitting the empty form shows the field errors,
284
+ * focuses the first invalid field and does not submit; «Zrušit» clears the form and its
285
+ * errors; the filled form goes through from the keyboard.
286
+ */
287
+ export const SubmitWithErrors: Story = {
288
+ name: 'Submit with errors',
289
+ play: async ({ canvasElement, args }) => {
290
+ const canvas = within(canvasElement);
291
+ const name = canvas.getByRole('textbox', { name: 'Název firmy' });
292
+ const email = canvas.getByRole('textbox', { name: 'E‑mail' });
293
+ const submit = canvas.getByRole('button', { name: 'Uložit kontakt' });
294
+
295
+ // The first Tab lands on the first field; Enter there is not an implicit submission.
296
+ await userEvent.tab();
297
+ await expect(name).toHaveFocus();
298
+ await userEvent.keyboard('{Enter}');
299
+ await expect(args.onSubmit).not.toHaveBeenCalled();
300
+ await expect(name).not.toHaveAttribute('aria-invalid');
301
+
302
+ await userEvent.click(submit);
303
+ await expect(name).toHaveAttribute('aria-invalid', 'true');
304
+ await expect(name).toHaveAccessibleDescription('Chybí název firmy');
305
+ await expect(name).toHaveFocus();
306
+ await expect(email).toHaveAccessibleDescription('Chybí e‑mail');
307
+ await expect(args.onSubmit).not.toHaveBeenCalled();
308
+
309
+ // Fixing a field clears its error live.
310
+ await userEvent.type(name, 'Acme s.r.o.');
311
+ await expect(name).not.toHaveAttribute('aria-invalid');
312
+ await expect(email).toHaveAttribute('aria-invalid', 'true');
313
+
314
+ // «Zrušit» empties the form and the errors do not come back on it.
315
+ await userEvent.click(canvas.getByRole('button', { name: 'Zrušit' }));
316
+ await expect(name).toHaveValue('');
317
+ await expect(name).not.toHaveAttribute('aria-invalid');
318
+ await expect(email).not.toHaveAttribute('aria-invalid');
319
+
320
+ // Fill the form, then reach the submit by Tab from the last field and press it with Space.
321
+ await userEvent.type(name, 'Acme s.r.o.');
322
+ await userEvent.type(email, 'firma@priklad.cz');
323
+ await userEvent.click(canvas.getByRole('textbox', { name: /Poznámka/ }));
324
+ await userEvent.tab();
325
+ await userEvent.tab();
326
+ await expect(submit).toHaveFocus();
327
+ await userEvent.keyboard(' ');
328
+ await expect(args.onSubmit).toHaveBeenCalledTimes(1);
329
+ },
330
+ };
331
+
332
+ /** A range whose «do» is before its «od» blocks the submit and takes focus to the range. */
333
+ export const RangeError: Story = {
334
+ name: 'Range error',
335
+ play: async ({ canvasElement, args }) => {
336
+ const canvas = within(canvasElement);
337
+ await userEvent.type(canvas.getByRole('textbox', { name: 'Název firmy' }), 'Acme s.r.o.');
338
+ await userEvent.type(canvas.getByRole('textbox', { name: 'E‑mail' }), 'firma@priklad.cz');
339
+
340
+ // Typing into the cells keeps the calendar shut (a click would open it); Tab commits.
341
+ const from = canvas.getByRole('combobox', { name: 'Platnost od' });
342
+ const to = canvas.getByRole('combobox', { name: 'Platnost do' });
343
+ from.focus();
344
+ await userEvent.type(from, '15. 04. 2026', { skipClick: true });
345
+ await userEvent.tab();
346
+ to.focus();
347
+ await userEvent.type(to, '01. 04. 2026', { skipClick: true });
348
+ await userEvent.tab();
349
+ await waitFor(() => expect(from).toHaveAttribute('aria-invalid', 'true'));
350
+
351
+ await userEvent.click(canvas.getByRole('button', { name: 'Uložit kontakt' }));
352
+ await expect(from).toHaveFocus();
353
+ await expect(args.onSubmit).not.toHaveBeenCalled();
354
+ },
355
+ };
@@ -0,0 +1,219 @@
1
+ import * as React from 'react';
2
+ import type { Meta, StoryObj } from '@storybook/react-vite';
3
+ import { expect, fn, userEvent, waitFor, within } from 'storybook/test';
4
+ import { Button } from '../components/button';
5
+ import { Field } from '../components/field';
6
+ import { FormBlock } from '../components/form-block';
7
+ import { FormSection } from '../components/form-section';
8
+ import { Icon } from '../components/icon';
9
+ import { Modal } from '../components/modal';
10
+ import { TextField } from '../components/text-field';
11
+ import { componentDoc } from '../storybook/componentDoc';
12
+
13
+ /**
14
+ * A short form in a Modal: the body holds one `<form>` with a Form Block in its modal-host
15
+ * configuration (form-block `chrome.modal-host`: `surface="none"`, header off, named by the
16
+ * modal title), and the Modal's own footer carries the actions. The footer sits outside the
17
+ * `<form>` element, so the submit Button reaches it through the `form` attribute.
18
+ */
19
+
20
+ const EMAIL_SHAPE = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
21
+
22
+ interface NewContactModalProps {
23
+ onCreate: (contact: { name: string; email: string }) => void;
24
+ }
25
+
26
+ function NewContactModal({ onCreate }: NewContactModalProps) {
27
+ const formId = React.useId();
28
+ const nameId = React.useId();
29
+ const emailId = React.useId();
30
+ const [open, setOpen] = React.useState(false);
31
+ const [name, setName] = React.useState('');
32
+ const [email, setEmail] = React.useState('');
33
+ const [submitted, setSubmitted] = React.useState(false);
34
+ const nameRef = React.useRef<HTMLInputElement>(null);
35
+ const emailRef = React.useRef<HTMLInputElement>(null);
36
+
37
+ const nameError = submitted && !name.trim() ? 'Chybí název firmy' : undefined;
38
+ const emailError = !submitted
39
+ ? undefined
40
+ : !email.trim()
41
+ ? 'Chybí e‑mail'
42
+ : !EMAIL_SHAPE.test(email.trim())
43
+ ? 'E‑mail musí mít tvar jmeno@priklad.cz'
44
+ : undefined;
45
+
46
+ const close = () => {
47
+ setOpen(false);
48
+ setName('');
49
+ setEmail('');
50
+ setSubmitted(false);
51
+ };
52
+
53
+ const handleSubmit = (event: React.FormEvent<HTMLFormElement>) => {
54
+ event.preventDefault();
55
+ setSubmitted(true);
56
+ // A failed submit focuses the first invalid field (form-layout.md § Build checklist 7).
57
+ if (!name.trim()) {
58
+ nameRef.current?.focus();
59
+ return;
60
+ }
61
+ if (!email.trim() || !EMAIL_SHAPE.test(email.trim())) {
62
+ emailRef.current?.focus();
63
+ return;
64
+ }
65
+ onCreate({ name: name.trim(), email: email.trim() });
66
+ close();
67
+ };
68
+
69
+ return (
70
+ <>
71
+ <Button variant="primary" leadingIcon={<Icon name="user-plus" />} onClick={() => setOpen(true)}>
72
+ Vytvořit kontakt
73
+ </Button>
74
+ <Modal
75
+ open={open}
76
+ onClose={close}
77
+ type="center"
78
+ // The Form pattern's size (Modal.mdx, "Good — a Form"); lg footer Buttons to match.
79
+ size="lg"
80
+ title="Nový kontakt"
81
+ actions={
82
+ <>
83
+ <Button variant="tertiary" size="lg" onClick={close}>
84
+ Zrušit
85
+ </Button>
86
+ {/* The footer is outside the <form>: `form` ties the submit to it. */}
87
+ <Button type="submit" form={formId} variant="primary" size="lg">
88
+ Vytvořit kontakt
89
+ </Button>
90
+ </>
91
+ }
92
+ >
93
+ <form id={formId} noValidate onSubmit={handleSubmit}>
94
+ <FormBlock showHeader={false} surface="none" title="Nový kontakt">
95
+ <FormSection>
96
+ <Field label="Název firmy" error={nameError}>
97
+ <TextField
98
+ ref={nameRef}
99
+ id={nameId}
100
+ required
101
+ autoComplete="organization"
102
+ value={name}
103
+ onChange={event => setName(event.target.value)}
104
+ />
105
+ </Field>
106
+ <Field label="E‑mail" error={emailError}>
107
+ <TextField
108
+ ref={emailRef}
109
+ id={emailId}
110
+ required
111
+ type="email"
112
+ autoComplete="email"
113
+ value={email}
114
+ onChange={event => setEmail(event.target.value)}
115
+ />
116
+ </Field>
117
+ </FormSection>
118
+ </FormBlock>
119
+ </form>
120
+ </Modal>
121
+ </>
122
+ );
123
+ }
124
+
125
+ const meta = {
126
+ title: 'Recipes/Modal with form',
127
+ component: NewContactModal,
128
+ args: { onCreate: fn() },
129
+ parameters: {
130
+ layout: 'centered',
131
+ controls: { disable: true },
132
+ docs: {
133
+ description: {
134
+ component: componentDoc({
135
+ summary:
136
+ 'A Modal (Center) whose body is a short form: a Form Block with `surface="none"` and the header off, named by the modal title, and the Modal’s own «Zrušit» / «Vytvořit kontakt» actions, both `lg` in an `lg` Modal. A recipe, not a component: nothing here is exported from the package.',
137
+ docsLink: { label: 'spec/05-organisms/form-block.md' },
138
+ }),
139
+ },
140
+ },
141
+ },
142
+ } satisfies Meta<typeof NewContactModal>;
143
+
144
+ export default meta;
145
+
146
+ type Story = StoryObj<typeof meta>;
147
+
148
+ /**
149
+ * The trigger opens the dialog from the keyboard, focus moves inside it, «Zrušit» closes it
150
+ * and focus returns to the trigger; Escape does the same.
151
+ */
152
+ export const OpenAndCancel: Story = {
153
+ name: 'Open and cancel',
154
+ play: async ({ canvasElement, args }) => {
155
+ const canvas = within(canvasElement);
156
+ // The Modal portals to <body>, outside the canvas.
157
+ const page = within(canvasElement.ownerDocument.body);
158
+ const trigger = canvas.getByRole('button', { name: 'Vytvořit kontakt' });
159
+ await userEvent.tab();
160
+ await expect(trigger).toHaveFocus();
161
+ await userEvent.keyboard('{Enter}');
162
+
163
+ const dialog = await page.findByRole('dialog', { name: 'Nový kontakt' });
164
+ await waitFor(() => expect(dialog).toContainElement(canvasElement.ownerDocument.activeElement as HTMLElement));
165
+ await expect(within(dialog).getByRole('textbox', { name: 'Název firmy' })).toBeVisible();
166
+
167
+ await userEvent.click(within(dialog).getByRole('button', { name: 'Zrušit' }));
168
+ await waitFor(() => expect(page.queryByRole('dialog')).not.toBeInTheDocument());
169
+ await expect(trigger).toHaveFocus();
170
+
171
+ // Escape closes it the same way.
172
+ await userEvent.click(trigger);
173
+ await page.findByRole('dialog', { name: 'Nový kontakt' });
174
+ await userEvent.keyboard('{Escape}');
175
+ await waitFor(() => expect(page.queryByRole('dialog')).not.toBeInTheDocument());
176
+ await expect(trigger).toHaveFocus();
177
+ await expect(args.onCreate).not.toHaveBeenCalled();
178
+ },
179
+ };
180
+
181
+ /**
182
+ * Submitting the empty dialog marks the fields invalid, focuses the first one and creates
183
+ * nothing; with valid values the contact is created once and the dialog closes.
184
+ */
185
+ export const SubmitWithErrors: Story = {
186
+ name: 'Submit with errors',
187
+ play: async ({ canvasElement, args }) => {
188
+ const canvas = within(canvasElement);
189
+ const page = within(canvasElement.ownerDocument.body);
190
+ const trigger = canvas.getByRole('button', { name: 'Vytvořit kontakt' });
191
+ await userEvent.click(trigger);
192
+
193
+ const dialog = await page.findByRole('dialog', { name: 'Nový kontakt' });
194
+ const inDialog = within(dialog);
195
+ // The trigger and the footer primary share a label: the query stays inside the dialog.
196
+ const submit = inDialog.getByRole('button', { name: 'Vytvořit kontakt' });
197
+ const name = inDialog.getByRole('textbox', { name: 'Název firmy' });
198
+ const email = inDialog.getByRole('textbox', { name: 'E‑mail' });
199
+
200
+ await userEvent.click(submit);
201
+ await expect(name).toHaveAttribute('aria-invalid', 'true');
202
+ await expect(email).toHaveAttribute('aria-invalid', 'true');
203
+ await expect(name).toHaveAccessibleDescription('Chybí název firmy');
204
+ await expect(email).toHaveAccessibleDescription('Chybí e‑mail');
205
+ await expect(name).toHaveFocus();
206
+ await expect(args.onCreate).not.toHaveBeenCalled();
207
+
208
+ await userEvent.type(name, 'Acme s.r.o.');
209
+ await userEvent.type(email, 'firma@priklad.cz');
210
+ // Submit from the keyboard: Tab past «Zrušit» to the footer primary and press Enter.
211
+ await userEvent.tab();
212
+ await userEvent.tab();
213
+ await expect(submit).toHaveFocus();
214
+ await userEvent.keyboard('{Enter}');
215
+ await expect(args.onCreate).toHaveBeenCalledTimes(1);
216
+ await expect(args.onCreate).toHaveBeenCalledWith({ name: 'Acme s.r.o.', email: 'firma@priklad.cz' });
217
+ await waitFor(() => expect(page.queryByRole('dialog')).not.toBeInTheDocument());
218
+ },
219
+ };
@@ -0,0 +1,61 @@
1
+ import { Meta } from '@storybook/addon-docs/blocks';
2
+
3
+ <Meta title="Recipes/Overview" />
4
+
5
+ # Recipes
6
+
7
+ A recipe is a screen-sized example put together from the components of this package. It shows
8
+ which components go together, in what order, and which props connect them. A recipe is a story,
9
+ not a component: nothing on these pages is exported from `@invoiceonline/ui-react`. Open the
10
+ story, read its source, and copy the part you need. In your code the imports come from
11
+ `@invoiceonline/ui-react`, not from the relative paths of the stories, and every illustration
12
+ is your own image: the pictures in these stories are sample assets the package does not ship.
13
+
14
+ Every recipe uses only components of the package and semantic tokens. The sample data is Czech
15
+ and domain-neutral.
16
+
17
+ ## The four recipes
18
+
19
+ | Recipe | Built from | What it shows |
20
+ |---|---|---|
21
+ | **Form** | `HeadingGroup`, `FormBlock`, `FormSection`, `Field` with `TextField` / `Select` / `Textarea`, `FieldPair`, `FormActions`, `Button` | A form page: blocks, a two-column grid, one action bar after the last block. Submitting with errors focuses the first invalid field. |
22
+ | **Table with filters** | `HeadingGroup`, `FilterFacet`, `FilterChip`, `Button`, `Table` | A list page: a filter row above the table, and the table's own no-results state when the filters match nothing. |
23
+ | **Modal with form** | `Modal`, `FormBlock`, `FormSection`, `Field`, `TextField`, `Button` | A short form in a dialog: the footer's primary button submits the form in the body, «Zrušit» closes without submitting. |
24
+ | **Empty state** | `HeadingGroup`, `Table` | The first-use state of a list: the table keeps its header and puts the one create action where the rows would be. |
25
+
26
+ ## What a recipe does not decide
27
+
28
+ Three spacings in these recipes have no value in the design system yet. The recipes use a
29
+ stand-in step, and the value may change once the design system sets one:
30
+
31
+ - the gap between the filter chips, and between the filter row and the table;
32
+ - the gap between the page title and the list below it;
33
+ - the padding above and below the form page.
34
+
35
+ There is no recipe for the layout of a list page or of the app shell (page width, columns,
36
+ breakpoints) and none for the
37
+ whole-page empty state with a large illustration. Both wait for a decision in the design system.
38
+
39
+ ## Accessibility
40
+
41
+ The components carry their own semantics. These parts are yours when you compose a screen:
42
+
43
+ - **Required fields.** Pass `required` to the control of every required field. The
44
+ «Volitelný» tag on the other fields is a visual cue only.
45
+ - **Failed submit.** Move focus to the first invalid field, in a modal form as well.
46
+ - **Names.** Give the filter row a group name (`role="group"` with `aria-label`), the table a
47
+ `caption`, and the page one `h1`.
48
+ - **Filtering.** The table does not announce a result set that changes without a load. The
49
+ recipe carries a visually hidden `role="status"` line with the result count.
50
+ - **Reset.** A reset button that disappears after the click takes the focus with it. Move
51
+ focus to the first filter.
52
+
53
+ ## Things to know before you copy
54
+
55
+ - **Modal with a form.** The form lives in the modal body and the submit button in the footer.
56
+ The button reaches the form through its `form` attribute, which takes the form's `id`.
57
+ - **Table.** `sorting` and `onSortingChange` are required even when no column sorts; pass an
58
+ empty array and a no-op handler.
59
+ - **Empty list.** The package has no separate empty-state component. Pass `emptyState` to the
60
+ `Table`, and leave the create action out of the page header, so the screen has one button for
61
+ one action.