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