@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,343 @@
1
+ import type { Meta, StoryObj } from '@storybook/react-vite';
2
+ import { FAQ, type FAQContact, type FAQItemData } from './FAQ';
3
+ import { Heading } from '../heading/Heading';
4
+ import { TextLink } from '../text-link/TextLink';
5
+ import { Icon } from '../icon/Icon';
6
+ import { faqItemVariants } from '../../internal/faqItem';
7
+ import { componentDoc } from '../../storybook/componentDoc';
8
+
9
+ /** `axes.variant` — Default (rail beside the cards at LG/XL) · Compact (one centred column). */
10
+ const VARIANTS = ['default', 'compact'] as const;
11
+
12
+ /**
13
+ * `axes.breakpoint` — the sizing axis (`intent.sizing`: "No size axis — Breakpoint IS the
14
+ * sizing"). Pure CSS, never a prop. The widths are the band MINIMUMS (layout-tokens.md
15
+ * `layout/breakpoint/min-width`), not the Figma artboard widths: a 600px viewport is below
16
+ * Tailwind's `sm:` (640) and would render the Mobile composition.
17
+ */
18
+ const BREAKPOINTS = ['XL', 'LG', 'MD', 'SM', 'Mobile'] as const;
19
+
20
+ const BREAKPOINT_MIN: Record<(typeof BREAKPOINTS)[number], number> = {
21
+ XL: 1280,
22
+ LG: 1024,
23
+ MD: 768,
24
+ SM: 640,
25
+ Mobile: 390,
26
+ };
27
+
28
+ /** Storybook viewport frame height — tall enough for the open-card stories, not a design value. */
29
+ const VIEWPORT_HEIGHT = 1100;
30
+
31
+ const FAQ_VIEWPORTS = Object.fromEntries(
32
+ BREAKPOINTS.map(bp => [
33
+ bp,
34
+ { name: `${bp} · ${BREAKPOINT_MIN[bp]}`, styles: { width: `${BREAKPOINT_MIN[bp]}px`, height: `${VIEWPORT_HEIGHT}px` } },
35
+ ]),
36
+ );
37
+
38
+ /** `_faq-item` axes.state × axes.open — rendered statically in the States story. */
39
+ const STATES = ['default', 'hover', 'active', 'focus'] as const;
40
+ const OPEN = [false, true] as const;
41
+
42
+ /**
43
+ * Bare twins of the card's `hover:` / `active:` / `:focus-visible` bindings
44
+ * (`_faq-item` families[0].states + focus). `parameters.pseudo` cannot force them —
45
+ * Tailwind v4 wraps `hover:` in `@media (hover: hover)`, which the addon does not
46
+ * rewrite — so each row passes the resting recipe these classes instead.
47
+ */
48
+ const FORCE_STATE: Record<(typeof STATES)[number], string> = {
49
+ default: '',
50
+ hover: 'border-outline-strong before:bg-background-hover',
51
+ active: 'border-outline-strong before:bg-background-active',
52
+ focus: 'outline outline-200 outline-outline-focus outline-offset-2',
53
+ };
54
+
55
+ /** The default copy from the manifests' `properties[]`, verbatim where one exists. */
56
+ const COPY = {
57
+ heading: 'Časté dotazy',
58
+ description: 'Nejčastější otázky před založením účtu. Odpověď na vše ostatní najdete v nápovědě.',
59
+ } as const;
60
+
61
+ const ITEMS: FAQItemData[] = [
62
+ {
63
+ id: 'price',
64
+ question: 'Kolik stojí fakturační program?',
65
+ answer: 'Prvních 5 týdnů máte Premium zdarma. Potom si vyberete Mini za 468 Kč, nebo Premium za 948 Kč ročně.',
66
+ },
67
+ {
68
+ id: 'install',
69
+ question: 'Musím něco instalovat?',
70
+ answer: 'Nemusíte. Fakturujete v prohlížeči na počítači i v telefonu.',
71
+ },
72
+ {
73
+ id: 'import',
74
+ question: 'Mohu převést kontakty z jiného programu?',
75
+ answer: (
76
+ <p>
77
+ Ano — kontakty nahrajete ze souboru CSV. Postup popisuje{' '}
78
+ <TextLink href="#napoveda" size="inherit">
79
+ nápověda
80
+ </TextLink>
81
+ .
82
+ </p>
83
+ ),
84
+ },
85
+ ];
86
+
87
+ /** `slots.link` (2.6.1): a guide or the help centre, leading `book` — never support. */
88
+ const helpLink = (
89
+ <TextLink href="#napoveda" size="md" leadingIcon="book">
90
+ Nápověda
91
+ </TextLink>
92
+ );
93
+
94
+ /**
95
+ * `regions[contact-card]` copy from the manifest (`slots.contact-heading`, `text.contact-*`).
96
+ * The address and number are a story FIXTURE — a page fills them from the market's contact
97
+ * data (`intent.rules[5]`).
98
+ */
99
+ const CONTACT: FAQContact = {
100
+ heading: 'Nenašli jste odpověď?',
101
+ description: 'Napište nebo zavolejte, odpovídá člověk, ne robot.',
102
+ email: 'podpora@priklad.cz',
103
+ phone: '+420 123 456 789',
104
+ };
105
+
106
+ /** Show contact phone off: no phone row, and the line offers only writing (`text.contact-description`). */
107
+ const CONTACT_WITHOUT_PHONE: FAQContact = {
108
+ heading: CONTACT.heading,
109
+ description: 'Napište nám, odpovídá člověk, ne robot.',
110
+ email: CONTACT.email,
111
+ };
112
+
113
+ /**
114
+ * One `_faq-item` card painted from its recipe, so a docs row can show a forced state.
115
+ * Mirrors the markup of the card inside FAQ.tsx; the live cards are in every other story.
116
+ */
117
+ function StaticCard({ state, open }: { state: (typeof STATES)[number]; open: boolean }) {
118
+ const { item, content, question, trigger, panel, answer, chevron } = faqItemVariants();
119
+ return (
120
+ <div className={item({ class: FORCE_STATE[state] })}>
121
+ <div className={content()}>
122
+ <Heading level={3} size="h4" className={question()}>
123
+ <button type="button" className={trigger()} aria-expanded={open} tabIndex={-1}>
124
+ {ITEMS[0].question}
125
+ </button>
126
+ </Heading>
127
+ {open && (
128
+ <div className={panel()}>
129
+ <div className={answer()}>
130
+ <p>{ITEMS[0].answer}</p>
131
+ </div>
132
+ </div>
133
+ )}
134
+ </div>
135
+ {/* The open pose of the one turning caret (motion.states.open). */}
136
+ <span className={chevron({ class: open ? '[transform:rotate(180deg)]' : undefined })} aria-hidden="true">
137
+ <Icon name="caret-down-small" />
138
+ </span>
139
+ </div>
140
+ );
141
+ }
142
+
143
+ const meta = {
144
+ title: 'Design System/Organisms/FAQ',
145
+ component: FAQ,
146
+ parameters: {
147
+ layout: 'fullscreen',
148
+ viewport: { options: FAQ_VIEWPORTS },
149
+ docs: {
150
+ description: {
151
+ component: componentDoc({
152
+ summary:
153
+ 'The question-and-answer section of a public page — a heading rail beside an accordion of question cards, on a full-width `--bg-secondary` band that carries its own side and vertical padding.',
154
+ useCases: [
155
+ 'Near the foot of a landing page or the homepage, answering the remaining objections before the closing call to action.',
156
+ '`variant="default"` for a full-width marketing page (rail beside the cards at LG/XL); `variant="compact"` where the page runs in one medium column.',
157
+ 'Omit `link` on single-path pages (landing pages with one goal); omit `description` to turn the lead off.',
158
+ ],
159
+ bestPractices: [
160
+ 'Three to six questions, answers short enough to read at a glance (max 200 characters).',
161
+ 'Point `link` at a guide or the help centre (`<TextLink size="md" leadingIcon="book">Nápověda</TextLink>`) — never at support, never an anchor on the same page.',
162
+ 'Send the reader to a person with `showContact` + `contact` from the market\'s contact data, and turn `link` off while the card is on.',
163
+ 'Ship FAQPage JSON-LD from the same data as `items`; the component does not emit it.',
164
+ 'Drop the section onto the page with no padded wrapper — its own padding is the section rhythm.',
165
+ ],
166
+ knownIssues: [
167
+ 'Every card loads closed and opening one never closes another — there is no single-open mode by design.',
168
+ ],
169
+ docsLink: { label: 'spec/07-web/faq.md' },
170
+ }),
171
+ },
172
+ },
173
+ },
174
+ argTypes: {
175
+ variant: {
176
+ control: 'inline-radio',
177
+ options: VARIANTS,
178
+ description: 'Default: rail beside the cards at LG/XL. Compact: one centred column at every breakpoint.',
179
+ },
180
+ heading: { control: 'text' },
181
+ description: { control: 'text' },
182
+ link: { control: false },
183
+ items: { control: false },
184
+ showContact: {
185
+ control: 'boolean',
186
+ description:
187
+ 'Show contact card (`showContactCard`): the support card — rail foot in Default LG/XL, under the register in Default MD down and in Compact. Needs `contact`.',
188
+ },
189
+ contact: { control: false },
190
+ footer: { control: false },
191
+ },
192
+ globals: { viewport: { value: 'XL' } },
193
+ args: {
194
+ variant: 'default',
195
+ ...COPY,
196
+ link: helpLink,
197
+ items: ITEMS,
198
+ },
199
+ } satisfies Meta<typeof FAQ>;
200
+
201
+ export default meta;
202
+ type Story = StoryObj<typeof meta>;
203
+
204
+ export const Playground: Story = {};
205
+
206
+ /** Rows = `axes.variant`. Breakpoint is CSS — see the Breakpoint stories. */
207
+ export const Matrix: Story = {
208
+ parameters: { controls: { disable: true } },
209
+ render: args => (
210
+ <div className="flex flex-col gap-1200 py-800">
211
+ {VARIANTS.map(variant => (
212
+ <div key={variant} className="flex flex-col gap-400">
213
+ <p className="px-800 text-body-xs text-text-secondary">variant = {variant}</p>
214
+ {/* Each FAQ is a `section` landmark named by its heading, so the two instances
215
+ need two headings — one page never holds two landmarks of the same name. */}
216
+ <FAQ
217
+ {...args}
218
+ variant={variant}
219
+ heading={variant === 'compact' ? 'Dotazy k fakturaci' : args.heading}
220
+ />
221
+ </div>
222
+ ))}
223
+ </div>
224
+ ),
225
+ };
226
+
227
+ /** Show description off + Show link off — the single-path landing page configuration. */
228
+ export const WithoutDescriptionAndLink: Story = {
229
+ args: { description: undefined, link: undefined },
230
+ };
231
+
232
+ /**
233
+ * Show contact card on (faq 2.6.0), Show link off: the card closes the rail at LG/XL. Also
234
+ * carries the register footer (`footer`).
235
+ */
236
+ export const WithContact: Story = {
237
+ args: {
238
+ link: undefined,
239
+ showContact: true,
240
+ contact: CONTACT,
241
+ footer: (
242
+ <nav aria-label="Více v článcích" className="flex flex-col gap-400">
243
+ <p className="font-inter text-body-base text-text-secondary">Více v článcích</p>
244
+ <ul role="list" className="flex flex-wrap gap-x-800 gap-y-400">
245
+ <li>
246
+ <TextLink href="#clanek-1" size="md">Jak vystavit první fakturu</TextLink>
247
+ </li>
248
+ <li>
249
+ <TextLink href="#clanek-2" size="md">Fakturace pro neplátce DPH</TextLink>
250
+ </li>
251
+ </ul>
252
+ </nav>
253
+ ),
254
+ },
255
+ };
256
+
257
+ /** Show contact phone off — the e-mail row only, write-only line. */
258
+ export const WithContactWithoutPhone: Story = {
259
+ args: { link: undefined, showContact: true, contact: CONTACT_WITHOUT_PHONE },
260
+ };
261
+
262
+ /** Default from MD down: one column, so the card moves under the register (after the last card). */
263
+ export const WithContactBreakpointMD: Story = {
264
+ name: 'With contact · MD',
265
+ args: { link: undefined, showContact: true, contact: CONTACT },
266
+ globals: { viewport: { value: 'MD' } },
267
+ };
268
+
269
+ export const Compact: Story = {
270
+ args: { variant: 'compact' },
271
+ };
272
+
273
+ /** Compact: the card under the register, as wide as the register, content left-aligned. */
274
+ export const CompactWithContact: Story = {
275
+ args: { variant: 'compact', link: undefined, showContact: true, contact: CONTACT },
276
+ };
277
+
278
+ export const CompactWithContactWithoutPhone: Story = {
279
+ args: { variant: 'compact', link: undefined, showContact: true, contact: CONTACT_WITHOUT_PHONE },
280
+ };
281
+
282
+ /**
283
+ * `_faq-item` motion (2.4.0) on live cards — enter, exit, the cards below reflowing, and
284
+ * the interrupt.
285
+ */
286
+ export const Motion: Story = {
287
+ parameters: {
288
+ controls: { disable: true },
289
+ docs: {
290
+ description: {
291
+ story:
292
+ 'Open a card: its caret turns 180° on `--spring-standard` at the moment of the click, the answer\'s room opens on `--spring-gentle` while the answer fades in over `--duration-slow` + `--easing-enter`, and the cards below move down with it. Close it: the answer fades out over `--duration-fast` + `--easing-exit` first, and only then does the room close and the cards below rise. Click again while it is still moving (the interrupt): the caret turns around mid-turn and the room and the fade reverse from where they are. Nothing in the answer slides or scales. Under `prefers-reduced-motion: reduce` (emulate it in DevTools → Rendering) the caret jumps, the room opens and closes at once and the fade shortens to `--duration-instant`; `aria-expanded` still flips.',
293
+ },
294
+ },
295
+ },
296
+ args: { variant: 'compact', link: undefined },
297
+ };
298
+
299
+ /**
300
+ * `_faq-item` State × Open, painted statically (bare classes, see FORCE_STATE). Every
301
+ * row differs from Default: Hover = 3% wash + strong outline, Active = 6% wash + strong
302
+ * outline, Focus = the offset ring around the whole card.
303
+ */
304
+ export const States: Story = {
305
+ parameters: { controls: { disable: true } },
306
+ render: () => (
307
+ <div className="flex flex-col gap-800 bg-background-secondary p-1000">
308
+ {STATES.map(state => (
309
+ <div key={state} className="grid grid-cols-[calc(var(--space-1200)*2)_1fr_1fr] items-start gap-800">
310
+ <p className="text-body-xs text-text-secondary">{state}</p>
311
+ {OPEN.map(open => (
312
+ <StaticCard key={String(open)} state={state} open={open} />
313
+ ))}
314
+ </div>
315
+ ))}
316
+ </div>
317
+ ),
318
+ };
319
+
320
+ export const BreakpointMobile: Story = {
321
+ name: 'Breakpoint · Mobile',
322
+ globals: { viewport: { value: 'Mobile' } },
323
+ };
324
+
325
+ export const BreakpointSM: Story = {
326
+ name: 'Breakpoint · SM',
327
+ globals: { viewport: { value: 'SM' } },
328
+ };
329
+
330
+ export const BreakpointMD: Story = {
331
+ name: 'Breakpoint · MD',
332
+ globals: { viewport: { value: 'MD' } },
333
+ };
334
+
335
+ export const BreakpointLG: Story = {
336
+ name: 'Breakpoint · LG',
337
+ globals: { viewport: { value: 'LG' } },
338
+ };
339
+
340
+ export const BreakpointXL: Story = {
341
+ name: 'Breakpoint · XL',
342
+ globals: { viewport: { value: 'XL' } },
343
+ };
@@ -0,0 +1,337 @@
1
+ "use client";
2
+ import * as React from 'react';
3
+ import { motion } from 'motion/react';
4
+ import { tv } from '../../internal/tailwind-variants';
5
+ import { Icon } from '../icon/Icon';
6
+ import { Heading } from '../heading/Heading';
7
+ import { HeadingGroup } from '../heading-group/HeadingGroup';
8
+ import { TextLink } from '../text-link/TextLink';
9
+ import { faqItemVariants } from '../../internal/faqItem';
10
+ import { roomVariants, useRoomPresence } from '../../internal/collapseRoom';
11
+ import { MotionCaret } from '../../internal/MotionCaret';
12
+ import { cn } from '../../internal/utils';
13
+
14
+ /**
15
+ * FAQ — the question-and-answer section of a public page (`faq.manifest.json`,
16
+ * Web layer, `kind: "region"`), with its accordion card `_faq-item` (2.4.1). Built against
17
+ * faq 2.6.3.
18
+ *
19
+ * A heading rail beside (or above) a register of question cards. Public-page
20
+ * furniture only — never in-app (`intent.whenToUse`).
21
+ *
22
+ * ## Self-bleeding band
23
+ *
24
+ * `container.note`: the root is a full-width `--bg-secondary` band with no radius or
25
+ * border, and it carries the page's own side padding (16 / 24 / 32 / 40 / 40) and
26
+ * the section's vertical padding (48 / 48 / 64 / 80 / 80) — dropped onto a page with
27
+ * no wrapper. Inside it, `content` caps at `--ds-content-wide` and centres (2.2.0).
28
+ *
29
+ * ## Variant is a prop, Breakpoint is CSS
30
+ *
31
+ * `delivery.react`: "Breakpoint is CSS, not a prop". Figma breakpoint -> Tailwind
32
+ * prefix: Mobile = unprefixed, SM = `sm:`, MD = `md:`, LG = `lg:`, XL = `xl:`.
33
+ * Default puts the rail beside the register on the published 12-column grid
34
+ * (gutter --space-800): LG 4 · 8, XL 4 · one empty column · 7, and stacks the two
35
+ * from MD down with --space-900 between them. Compact is one centred column at
36
+ * every breakpoint, capped at `--ds-content-medium`.
37
+ *
38
+ * ## No states, no single-open coordination
39
+ *
40
+ * The section has no states (`intent.states`). Each card keeps its own open state;
41
+ * all load closed and any number may be open at once (`intent.rules[1]`).
42
+ *
43
+ * ## Contact card (2.6.0)
44
+ *
45
+ * `regions[contact-card]` moves with the column count: Default closes the rail at LG/XL
46
+ * and sits under the register from MD down; Compact always sits under the register. The
47
+ * card is ONE node, the last child of `content` — DOM order = visual order wherever the
48
+ * section is one column. At LG/XL Default places it in the rail's grid column, row 2 (the
49
+ * register spans both rows), so its links follow the cards in the tab order there, not
50
+ * precede them as `delivery.react` describes — the price of one node and no duplicated
51
+ * markup, recorded in FAQ.mdx § Migration notes.
52
+ *
53
+ * ## Structured data is the consumer's job
54
+ *
55
+ * `delivery.react` asks for FAQPage JSON-LD wherever the section is indexable,
56
+ * generated from the same source as the visible cards. The component does not emit
57
+ * it — the page does, so one page never ships it twice.
58
+ */
59
+ const faqVariants = tv({
60
+ slots: {
61
+ root: [
62
+ 'w-full bg-background-secondary',
63
+ // Side padding ladder (intent.sizing): Mobile 16 · SM 24 · MD 32 · LG/XL 40.
64
+ 'px-600 sm:px-800 md:px-900 lg:px-1000',
65
+ // Vertical padding (container.note): SM/Mobile --space-1100 · MD --space-1200 ·
66
+ // LG/XL --space-1300, top and bottom.
67
+ 'py-1100 md:py-1200 lg:py-1300',
68
+ ],
69
+ // The `content` wrapper (2.2.0) — rail and register, centred in the root.
70
+ content: 'mx-auto flex w-full flex-col gap-900',
71
+ // regions.rail: heading, optional lead, optional link; gap --space-600, no padding.
72
+ rail: 'flex flex-col gap-600',
73
+ // The rail lead caps at --ds-content-narrow (intent.rules[2]).
74
+ description: 'max-w-content-narrow font-inter text-body-base text-text-secondary [text-wrap:var(--text-wrap-body)]',
75
+ link: 'flex',
76
+ // regions[contact-card]: column, padding --space-600, gap --space-500, fill
77
+ // --secondary-subtle (parts.contact-card), --radius-600, no border or shadow; width FILL.
78
+ contactCard: 'flex flex-col gap-500 rounded-600 bg-secondary-subtle p-600',
79
+ // regions[contact-card].note: "The link stack inside it is a column gapped --space-200";
80
+ // the links hug their label, left-aligned in both variants.
81
+ contactLinks: 'flex flex-col items-start gap-200',
82
+ // regions.register: the cards, gap --space-600, no rule or fill of its own.
83
+ register: 'flex flex-col gap-600',
84
+ // Package extension (outside the manifest): content under the cards, no rule or fill (the register carries none).
85
+ footer: 'flex flex-col gap-400 pt-400',
86
+ },
87
+ variants: {
88
+ variant: {
89
+ default: {
90
+ content: [
91
+ 'max-w-content-wide',
92
+ // LG/XL: the published 12-column grid, gutter 24 (--space-800).
93
+ 'lg:grid lg:grid-cols-12 lg:items-start lg:gap-x-800',
94
+ ],
95
+ rail: 'lg:col-span-4',
96
+ // XL: one empty column between rail and register (4 · empty · 7).
97
+ register: 'lg:col-span-8 xl:col-span-7 xl:col-start-6',
98
+ },
99
+ compact: {
100
+ content: 'max-w-content-medium',
101
+ rail: 'items-center text-center',
102
+ link: 'justify-center',
103
+ },
104
+ },
105
+ /** Show contact card — keys the Default LG/XL grid placement only. */
106
+ hasContact: {
107
+ true: {},
108
+ false: {},
109
+ },
110
+ },
111
+ compoundVariants: [
112
+ // Default LG/XL with the card: rail row 1, card row 2 of the rail column, the register
113
+ // spanning both. Row 2 is `1fr` so a taller register never opens the rail→card gap,
114
+ // which is the rail's own --space-600 (`regions[contact-card].note`).
115
+ {
116
+ variant: 'default',
117
+ hasContact: true,
118
+ class: {
119
+ content: 'lg:grid-rows-[auto_1fr] lg:gap-y-600',
120
+ register: 'lg:row-span-2',
121
+ contactCard: 'lg:col-span-4 lg:col-start-1 lg:row-start-2',
122
+ },
123
+ },
124
+ ],
125
+ defaultVariants: {
126
+ variant: 'default',
127
+ hasContact: false,
128
+ },
129
+ });
130
+
131
+ export type FAQVariant = 'default' | 'compact';
132
+
133
+ export interface FAQItemData {
134
+ /** Stable key for the card. */
135
+ id: string;
136
+ /** The question copy — rendered as the `<h3>`. Max 50 characters (`text.question`). */
137
+ question: string;
138
+ /**
139
+ * The answer — rich text. A string is wrapped in a `<p>`; a node renders as given,
140
+ * so it may carry one inline Text Link (it never toggles the card). Max 200 characters.
141
+ */
142
+ answer: React.ReactNode;
143
+ }
144
+
145
+ /**
146
+ * The support contact card (`regions[contact-card]`, faq 2.6.0). Fill it from the market's
147
+ * contact data, never a hard-coded address (`intent.rules[5]`).
148
+ */
149
+ export interface FAQContact {
150
+ /**
151
+ * The card title — the reader's own question, e.g. "Nenašli jste odpověď?". Heading Group
152
+ * H5, rendered as an `<h3>`. Max 30 characters (`text.contact-title`).
153
+ */
154
+ heading: React.ReactNode;
155
+ /**
156
+ * The one line under the title (Heading Group description). Max 60 characters. Without
157
+ * `phone` it offers only writing — it never invites a call the card has no number for
158
+ * (`text.contact-description`).
159
+ */
160
+ description?: React.ReactNode;
161
+ /** The support address — the label and the `mailto:` target. */
162
+ email?: string;
163
+ /**
164
+ * The support number in the market's own format. Omit on markets without a support line
165
+ * (Show contact phone off). The label never wraps; the `tel:` href drops the spaces.
166
+ */
167
+ phone?: string;
168
+ }
169
+
170
+ export interface FAQProps extends Omit<React.HTMLAttributes<HTMLElement>, 'children'> {
171
+ /** Default: rail beside the cards at LG/XL. Compact: one centred column everywhere. */
172
+ variant?: FAQVariant;
173
+ /** The section heading — the page's `<h2>`. Two or three words, max 30 characters. */
174
+ heading: React.ReactNode;
175
+ /** One line of orientation under the heading. Omit to turn Show description off. */
176
+ description?: React.ReactNode;
177
+ /**
178
+ * The rail's link out to a guide or the help centre ("Nápověda") — a
179
+ * `<TextLink size="md" leadingIcon="book">`, never support (that is the contact card).
180
+ * Omit to turn Show link off (single-path landing pages, and whenever the contact card is on).
181
+ */
182
+ link?: React.ReactNode;
183
+ /** The `items` slot: one card per question, in reading order — three to six. */
184
+ items: FAQItemData[];
185
+ /** Show contact card (`showContactCard`, default off) — renders the card from `contact`. */
186
+ showContact?: boolean;
187
+ /** Copy and channels of the support contact card. Show contact phone = `phone` present. */
188
+ contact?: FAQContact;
189
+ /** Content under the cards inside the register, e.g. links to articles. Package extension (outside the manifest). */
190
+ footer?: React.ReactNode;
191
+ }
192
+
193
+ interface FAQItemProps {
194
+ question: string;
195
+ answer: React.ReactNode;
196
+ }
197
+
198
+ /**
199
+ * One `_faq-item` card. Its open state is its own (`delivery.react`: "Open state is
200
+ * per card and independent").
201
+ *
202
+ * Motion (`motion`, 2.4.0): opening un-hides the answer, its room opens on
203
+ * `springs.gentle` while it fades in (`--duration-slow` + `--easing-enter`); closing fades
204
+ * it out (`--duration-fast` + `--easing-exit`) first, then the room closes. A re-toggle
205
+ * reverses from where it is. The answer is `inert` from the moment of activation and
206
+ * takes `hidden` once the close ends (`motion.collapsed`), so it leaves the tab order and
207
+ * the accessibility tree and keeps no gap. Reduced motion: the room switches at once and
208
+ * the fade shortens to `--duration-instant`; the caret (a transform) jumps through the
209
+ * `MotionConfig` that `FodsProvider` mounts.
210
+ */
211
+ function FAQItem({ question, answer }: FAQItemProps) {
212
+ const [open, setOpen] = React.useState(false);
213
+ const room = useRoomPresence(open);
214
+ const baseId = React.useId();
215
+ const triggerId = `${baseId}-trigger`;
216
+ const answerId = `${baseId}-answer`;
217
+ const { item, content, question: questionSlot, trigger, panel, answer: answerSlot, chevron } = faqItemVariants();
218
+
219
+ return (
220
+ <div className={item()} data-fods-part="item" data-state={open ? 'open' : 'closed'}>
221
+ <div className={content()}>
222
+ <Heading level={3} size="h4" className={questionSlot()} data-fods-part="question">
223
+ <button
224
+ type="button"
225
+ id={triggerId}
226
+ className={trigger()}
227
+ aria-expanded={open}
228
+ aria-controls={answerId}
229
+ onClick={() => setOpen(!open)}
230
+ data-fods-part="trigger"
231
+ >
232
+ {question}
233
+ </button>
234
+ </Heading>
235
+ <motion.div
236
+ id={answerId}
237
+ role="region"
238
+ aria-labelledby={triggerId}
239
+ className={panel()}
240
+ hidden={room.gone}
241
+ inert={!open}
242
+ initial={false}
243
+ animate={open ? 'open' : 'closed'}
244
+ variants={roomVariants(room.reduce, 'instant')}
245
+ onAnimationComplete={room.onAnimationComplete}
246
+ >
247
+ <div className={answerSlot()} data-fods-part="answer">
248
+ {typeof answer === 'string' ? <p>{answer}</p> : answer}
249
+ </div>
250
+ </motion.div>
251
+ </div>
252
+ {/* slots.chevron (`motion.states.open`): one caret-down-small turning 180° on
253
+ --spring-standard, starting at the moment of activation. */}
254
+ <MotionCaret open={open} className={chevron()} data-fods-part="chevron">
255
+ <Icon name="caret-down-small" />
256
+ </MotionCaret>
257
+ </div>
258
+ );
259
+ }
260
+
261
+ const FAQ = React.forwardRef<HTMLElement, FAQProps>(
262
+ ({ variant = 'default', heading, description, link, items, showContact = false, contact, footer, className, ...props }, ref) => {
263
+ const hasContact = showContact && contact != null;
264
+ const slots = faqVariants({ variant, hasContact });
265
+ const headingId = React.useId();
266
+
267
+ return (
268
+ <section
269
+ ref={ref}
270
+ aria-labelledby={headingId}
271
+ className={cn(slots.root(), className)}
272
+ data-fods-component="faq"
273
+ data-fods-part="root"
274
+ {...props}
275
+ >
276
+ <div className={slots.content()} data-fods-part="content">
277
+ <div className={slots.rail()} data-fods-part="rail">
278
+ <Heading level={2} size="d3" id={headingId} data-fods-part="heading">
279
+ {heading}
280
+ </Heading>
281
+ {description != null && (
282
+ <p className={slots.description()} data-fods-part="description">
283
+ {description}
284
+ </p>
285
+ )}
286
+ {link != null && (
287
+ <div className={slots.link()} data-fods-part="link">
288
+ {link}
289
+ </div>
290
+ )}
291
+ </div>
292
+ <div className={slots.register()} data-fods-part="register">
293
+ {items.map(entry => (
294
+ <FAQItem key={entry.id} question={entry.question} answer={entry.answer} />
295
+ ))}
296
+ {footer != null && (
297
+ <div className={slots.footer()} data-fods-part="register-footer">
298
+ {footer}
299
+ </div>
300
+ )}
301
+ </div>
302
+ {/* regions[contact-card]: the last child of the content band (see the header note). */}
303
+ {hasContact && contact && (
304
+ <div className={slots.contactCard()} data-fods-part="contact-card">
305
+ <HeadingGroup level={3} size="h5" heading={contact.heading} description={contact.description} />
306
+ {(contact.email || contact.phone) && (
307
+ <div className={slots.contactLinks()} data-fods-part="contact-links">
308
+ {contact.email && (
309
+ <TextLink href={`mailto:${contact.email}`} size="sm" leadingIcon="envelope">
310
+ {contact.email}
311
+ </TextLink>
312
+ )}
313
+ {contact.phone && (
314
+ // slots.phone-link: the number never wraps between its digit groups. `nowrap`
315
+ // instead of rewriting the label to no-break spaces keeps the accessible
316
+ // name exactly the string the market data passes.
317
+ <TextLink
318
+ href={`tel:${contact.phone.replace(/\s+/g, '')}`}
319
+ size="sm"
320
+ leadingIcon="phone"
321
+ className="whitespace-nowrap"
322
+ >
323
+ {contact.phone}
324
+ </TextLink>
325
+ )}
326
+ </div>
327
+ )}
328
+ </div>
329
+ )}
330
+ </div>
331
+ </section>
332
+ );
333
+ },
334
+ );
335
+ FAQ.displayName = 'FAQ';
336
+
337
+ export { FAQ, faqVariants };
@@ -0,0 +1 @@
1
+ export { FAQ, faqVariants, type FAQProps, type FAQVariant, type FAQItemData, type FAQContact } from './FAQ';