@invoiceonline/ui-react 0.0.0 → 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (738) hide show
  1. package/AGENTS.md +99 -0
  2. package/CHANGELOG.md +131 -0
  3. package/LICENSE +9 -0
  4. package/README.md +77 -1
  5. package/dist/assets/label-brush-1.svg +6 -0
  6. package/dist/assets/pattern-dark.svg +113 -0
  7. package/dist/components/action-row/ActionRow.d.ts +178 -0
  8. package/dist/components/action-row/ActionRow.js +340 -0
  9. package/dist/components/action-row/index.d.ts +2 -0
  10. package/dist/components/action-row/index.js +1 -0
  11. package/dist/components/alert/Alert.d.ts +314 -0
  12. package/dist/components/alert/Alert.js +446 -0
  13. package/dist/components/alert/index.d.ts +2 -0
  14. package/dist/components/alert/index.js +1 -0
  15. package/dist/components/anchored-panel/AnchoredPanel.d.ts +41 -0
  16. package/dist/components/anchored-panel/AnchoredPanel.js +72 -0
  17. package/dist/components/anchored-panel/index.d.ts +3 -0
  18. package/dist/components/anchored-panel/index.js +3 -0
  19. package/dist/components/badge/Badge.d.ts +146 -0
  20. package/dist/components/badge/Badge.js +258 -0
  21. package/dist/components/badge/index.d.ts +2 -0
  22. package/dist/components/badge/index.js +1 -0
  23. package/dist/components/banner/Banner.d.ts +209 -0
  24. package/dist/components/banner/Banner.js +339 -0
  25. package/dist/components/banner/index.d.ts +2 -0
  26. package/dist/components/banner/index.js +1 -0
  27. package/dist/components/button/Button.d.ts +54 -0
  28. package/dist/components/button/Button.js +312 -0
  29. package/dist/components/button/index.d.ts +2 -0
  30. package/dist/components/button/index.js +1 -0
  31. package/dist/components/button-group/ButtonGroup.d.ts +187 -0
  32. package/dist/components/button-group/ButtonGroup.js +217 -0
  33. package/dist/components/button-group/index.d.ts +2 -0
  34. package/dist/components/button-group/index.js +1 -0
  35. package/dist/components/card-select/CardSelect.d.ts +274 -0
  36. package/dist/components/card-select/CardSelect.js +561 -0
  37. package/dist/components/card-select/CardSelectGroup.d.ts +92 -0
  38. package/dist/components/card-select/CardSelectGroup.js +72 -0
  39. package/dist/components/card-select/index.d.ts +3 -0
  40. package/dist/components/card-select/index.js +3 -0
  41. package/dist/components/checkbox/Checkbox.d.ts +104 -0
  42. package/dist/components/checkbox/Checkbox.js +194 -0
  43. package/dist/components/checkbox/index.d.ts +2 -0
  44. package/dist/components/checkbox/index.js +1 -0
  45. package/dist/components/chip/Chip.d.ts +250 -0
  46. package/dist/components/chip/Chip.js +441 -0
  47. package/dist/components/chip/index.d.ts +2 -0
  48. package/dist/components/chip/index.js +1 -0
  49. package/dist/components/column-header/ColumnHeader.d.ts +144 -0
  50. package/dist/components/column-header/ColumnHeader.js +209 -0
  51. package/dist/components/column-header/index.d.ts +2 -0
  52. package/dist/components/column-header/index.js +1 -0
  53. package/dist/components/combobox-field/Combobox.d.ts +104 -0
  54. package/dist/components/combobox-field/Combobox.js +355 -0
  55. package/dist/components/combobox-field/ComboboxField.d.ts +76 -0
  56. package/dist/components/combobox-field/ComboboxField.js +98 -0
  57. package/dist/components/combobox-field/index.d.ts +3 -0
  58. package/dist/components/combobox-field/index.js +3 -0
  59. package/dist/components/date-field/DateField.d.ts +52 -0
  60. package/dist/components/date-field/DateField.js +45 -0
  61. package/dist/components/date-field/index.d.ts +2 -0
  62. package/dist/components/date-field/index.js +1 -0
  63. package/dist/components/date-picker/DatePicker.d.ts +53 -0
  64. package/dist/components/date-picker/DatePicker.js +329 -0
  65. package/dist/components/date-picker/index.d.ts +2 -0
  66. package/dist/components/date-picker/index.js +1 -0
  67. package/dist/components/divider/Divider.d.ts +81 -0
  68. package/dist/components/divider/Divider.js +93 -0
  69. package/dist/components/divider/index.d.ts +2 -0
  70. package/dist/components/divider/index.js +1 -0
  71. package/dist/components/drawer/Drawer.d.ts +128 -0
  72. package/dist/components/drawer/Drawer.js +367 -0
  73. package/dist/components/drawer/index.d.ts +2 -0
  74. package/dist/components/drawer/index.js +1 -0
  75. package/dist/components/dropdown-button/DropdownButton.d.ts +72 -0
  76. package/dist/components/dropdown-button/DropdownButton.js +122 -0
  77. package/dist/components/dropdown-button/index.d.ts +2 -0
  78. package/dist/components/dropdown-button/index.js +1 -0
  79. package/dist/components/faq/FAQ.d.ts +135 -0
  80. package/dist/components/faq/FAQ.js +258 -0
  81. package/dist/components/faq/index.d.ts +2 -0
  82. package/dist/components/faq/index.js +1 -0
  83. package/dist/components/field/Field.d.ts +118 -0
  84. package/dist/components/field/Field.js +327 -0
  85. package/dist/components/field/index.d.ts +2 -0
  86. package/dist/components/field/index.js +1 -0
  87. package/dist/components/field-pair/FieldPair.d.ts +194 -0
  88. package/dist/components/field-pair/FieldPair.js +321 -0
  89. package/dist/components/field-pair/index.d.ts +2 -0
  90. package/dist/components/field-pair/index.js +1 -0
  91. package/dist/components/file-upload/FileUpload.d.ts +137 -0
  92. package/dist/components/file-upload/FileUpload.js +434 -0
  93. package/dist/components/file-upload/index.d.ts +2 -0
  94. package/dist/components/file-upload/index.js +1 -0
  95. package/dist/components/filter-chip/FilterChip.d.ts +373 -0
  96. package/dist/components/filter-chip/FilterChip.js +517 -0
  97. package/dist/components/filter-chip/index.d.ts +2 -0
  98. package/dist/components/filter-chip/index.js +1 -0
  99. package/dist/components/filter-facet/FilterFacet.d.ts +116 -0
  100. package/dist/components/filter-facet/FilterFacet.js +632 -0
  101. package/dist/components/filter-facet/index.d.ts +2 -0
  102. package/dist/components/filter-facet/index.js +1 -0
  103. package/dist/components/firm-avatar/FirmAvatar.d.ts +75 -0
  104. package/dist/components/firm-avatar/FirmAvatar.js +119 -0
  105. package/dist/components/firm-avatar/index.d.ts +2 -0
  106. package/dist/components/firm-avatar/index.js +1 -0
  107. package/dist/components/form-actions/FormActions.d.ts +123 -0
  108. package/dist/components/form-actions/FormActions.js +195 -0
  109. package/dist/components/form-actions/index.d.ts +2 -0
  110. package/dist/components/form-actions/index.js +1 -0
  111. package/dist/components/form-block/FormBlock.d.ts +252 -0
  112. package/dist/components/form-block/FormBlock.js +420 -0
  113. package/dist/components/form-block/index.d.ts +3 -0
  114. package/dist/components/form-block/index.js +3 -0
  115. package/dist/components/form-section/FormSection.d.ts +130 -0
  116. package/dist/components/form-section/FormSection.js +206 -0
  117. package/dist/components/form-section/index.d.ts +2 -0
  118. package/dist/components/form-section/index.js +1 -0
  119. package/dist/components/heading/Heading.d.ts +69 -0
  120. package/dist/components/heading/Heading.js +79 -0
  121. package/dist/components/heading/index.d.ts +2 -0
  122. package/dist/components/heading/index.js +1 -0
  123. package/dist/components/heading-group/HeadingGroup.d.ts +258 -0
  124. package/dist/components/heading-group/HeadingGroup.js +255 -0
  125. package/dist/components/heading-group/index.d.ts +2 -0
  126. package/dist/components/heading-group/index.js +1 -0
  127. package/dist/components/hero/Hero.d.ts +268 -0
  128. package/dist/components/hero/Hero.js +316 -0
  129. package/dist/components/hero/index.d.ts +2 -0
  130. package/dist/components/hero/index.js +1 -0
  131. package/dist/components/icon/Icon.d.ts +27 -0
  132. package/dist/components/icon/Icon.js +30 -0
  133. package/dist/components/icon/index.d.ts +3 -0
  134. package/dist/components/icon/index.js +3 -0
  135. package/dist/components/icon-button/IconButton.d.ts +75 -0
  136. package/dist/components/icon-button/IconButton.js +151 -0
  137. package/dist/components/icon-button/index.d.ts +2 -0
  138. package/dist/components/icon-button/index.js +1 -0
  139. package/dist/components/item-row/ItemRow.d.ts +253 -0
  140. package/dist/components/item-row/ItemRow.js +496 -0
  141. package/dist/components/item-row/index.d.ts +2 -0
  142. package/dist/components/item-row/index.js +1 -0
  143. package/dist/components/list-row/ListRow.d.ts +165 -0
  144. package/dist/components/list-row/ListRow.js +233 -0
  145. package/dist/components/list-row/index.d.ts +2 -0
  146. package/dist/components/list-row/index.js +1 -0
  147. package/dist/components/menu/Menu.d.ts +64 -0
  148. package/dist/components/menu/Menu.js +186 -0
  149. package/dist/components/menu/index.d.ts +2 -0
  150. package/dist/components/menu/index.js +1 -0
  151. package/dist/components/modal/Modal.d.ts +272 -0
  152. package/dist/components/modal/Modal.js +788 -0
  153. package/dist/components/modal/index.d.ts +2 -0
  154. package/dist/components/modal/index.js +1 -0
  155. package/dist/components/nav-link/NavLink.d.ts +123 -0
  156. package/dist/components/nav-link/NavLink.js +157 -0
  157. package/dist/components/nav-link/index.d.ts +2 -0
  158. package/dist/components/nav-link/index.js +1 -0
  159. package/dist/components/number-field/NumberField.d.ts +62 -0
  160. package/dist/components/number-field/NumberField.js +210 -0
  161. package/dist/components/number-field/index.d.ts +2 -0
  162. package/dist/components/number-field/index.js +1 -0
  163. package/dist/components/pagination/Pagination.d.ts +133 -0
  164. package/dist/components/pagination/Pagination.js +217 -0
  165. package/dist/components/pagination/index.d.ts +3 -0
  166. package/dist/components/pagination/index.js +3 -0
  167. package/dist/components/popover-surface/index.d.ts +2 -0
  168. package/dist/components/popover-surface/index.js +1 -0
  169. package/dist/components/progress-bar/ProgressBar.d.ts +260 -0
  170. package/dist/components/progress-bar/ProgressBar.js +470 -0
  171. package/dist/components/progress-bar/index.d.ts +2 -0
  172. package/dist/components/progress-bar/index.js +1 -0
  173. package/dist/components/promo-sticker/PromoSticker.d.ts +204 -0
  174. package/dist/components/promo-sticker/PromoSticker.js +177 -0
  175. package/dist/components/promo-sticker/index.d.ts +2 -0
  176. package/dist/components/promo-sticker/index.js +1 -0
  177. package/dist/components/promo-surface/PromoSurface.d.ts +94 -0
  178. package/dist/components/promo-surface/PromoSurface.js +119 -0
  179. package/dist/components/promo-surface/index.d.ts +2 -0
  180. package/dist/components/promo-surface/index.js +1 -0
  181. package/dist/components/radio/Radio.d.ts +92 -0
  182. package/dist/components/radio/Radio.js +171 -0
  183. package/dist/components/radio/index.d.ts +2 -0
  184. package/dist/components/radio/index.js +1 -0
  185. package/dist/components/radio-group/RadioGroup.d.ts +61 -0
  186. package/dist/components/radio-group/RadioGroup.js +51 -0
  187. package/dist/components/radio-group/index.d.ts +2 -0
  188. package/dist/components/radio-group/index.js +1 -0
  189. package/dist/components/select/Select.d.ts +65 -0
  190. package/dist/components/select/Select.js +176 -0
  191. package/dist/components/select/index.d.ts +2 -0
  192. package/dist/components/select/index.js +1 -0
  193. package/dist/components/select-field/SelectField.d.ts +16 -0
  194. package/dist/components/select-field/SelectField.js +55 -0
  195. package/dist/components/select-field/index.d.ts +2 -0
  196. package/dist/components/select-field/index.js +1 -0
  197. package/dist/components/skeleton/Skeleton.d.ts +64 -0
  198. package/dist/components/skeleton/Skeleton.js +65 -0
  199. package/dist/components/skeleton/index.d.ts +2 -0
  200. package/dist/components/skeleton/index.js +1 -0
  201. package/dist/components/split-button/SplitButton.d.ts +80 -0
  202. package/dist/components/split-button/SplitButton.js +182 -0
  203. package/dist/components/split-button/index.d.ts +2 -0
  204. package/dist/components/split-button/index.js +1 -0
  205. package/dist/components/status-summary-bar/StatusSummaryBar.d.ts +118 -0
  206. package/dist/components/status-summary-bar/StatusSummaryBar.js +278 -0
  207. package/dist/components/status-summary-bar/index.d.ts +2 -0
  208. package/dist/components/status-summary-bar/index.js +1 -0
  209. package/dist/components/subject-lookup-field/SubjectLookupField.d.ts +157 -0
  210. package/dist/components/subject-lookup-field/SubjectLookupField.js +663 -0
  211. package/dist/components/subject-lookup-field/index.d.ts +2 -0
  212. package/dist/components/subject-lookup-field/index.js +1 -0
  213. package/dist/components/switch/Switch.d.ts +152 -0
  214. package/dist/components/switch/Switch.js +307 -0
  215. package/dist/components/switch/index.d.ts +2 -0
  216. package/dist/components/switch/index.js +1 -0
  217. package/dist/components/table/Table.d.ts +5 -0
  218. package/dist/components/table/Table.js +601 -0
  219. package/dist/components/table/index.d.ts +6 -0
  220. package/dist/components/table/index.js +6 -0
  221. package/dist/components/text-field/TextField.d.ts +65 -0
  222. package/dist/components/text-field/TextField.js +173 -0
  223. package/dist/components/text-field/index.d.ts +2 -0
  224. package/dist/components/text-field/index.js +1 -0
  225. package/dist/components/text-link/TextLink.d.ts +260 -0
  226. package/dist/components/text-link/TextLink.js +303 -0
  227. package/dist/components/text-link/index.d.ts +2 -0
  228. package/dist/components/text-link/index.js +1 -0
  229. package/dist/components/textarea/Textarea.d.ts +93 -0
  230. package/dist/components/textarea/Textarea.js +256 -0
  231. package/dist/components/textarea/index.d.ts +2 -0
  232. package/dist/components/textarea/index.js +1 -0
  233. package/dist/components/tooltip/Tooltip.d.ts +129 -0
  234. package/dist/components/tooltip/Tooltip.js +457 -0
  235. package/dist/components/tooltip/index.d.ts +2 -0
  236. package/dist/components/tooltip/index.js +1 -0
  237. package/dist/components/unit-field/UnitField.d.ts +46 -0
  238. package/dist/components/unit-field/UnitField.js +133 -0
  239. package/dist/components/unit-field/index.d.ts +2 -0
  240. package/dist/components/unit-field/index.js +1 -0
  241. package/dist/icons/icon-registry.generated.js +500 -0
  242. package/dist/icons/icon-types.generated.d.ts +2 -0
  243. package/dist/icons/icon-types.generated.js +126 -0
  244. package/dist/index.d.ts +132 -0
  245. package/dist/index.js +75 -0
  246. package/dist/internal/BottomSheet.js +496 -0
  247. package/dist/internal/FodsProvider.d.ts +25 -0
  248. package/dist/internal/FodsProvider.js +32 -0
  249. package/dist/internal/MotionCaret.js +35 -0
  250. package/dist/internal/NumberFormatInput.d.ts +21 -0
  251. package/dist/internal/NumberFormatInput.js +126 -0
  252. package/dist/internal/SummaryDonut.d.ts +3 -0
  253. package/dist/internal/SummaryDonut.js +300 -0
  254. package/dist/internal/buttonSegment.d.ts +44 -0
  255. package/dist/internal/buttonSegment.js +126 -0
  256. package/dist/internal/collapseRoom.js +128 -0
  257. package/dist/internal/comboboxKeys.js +44 -0
  258. package/dist/internal/contentPresence.js +46 -0
  259. package/dist/internal/dayCell.js +95 -0
  260. package/dist/internal/dialogPortal.d.ts +2 -0
  261. package/dist/internal/dialogPortal.js +21 -0
  262. package/dist/internal/donutSweeps.js +65 -0
  263. package/dist/internal/enterOnViewGeometry.js +46 -0
  264. package/dist/internal/faqItem.js +80 -0
  265. package/dist/internal/floatingLabelMotion.js +68 -0
  266. package/dist/internal/formBlockContext.d.ts +22 -0
  267. package/dist/internal/formBlockContext.js +20 -0
  268. package/dist/internal/heightRoom.js +87 -0
  269. package/dist/internal/numberSeparators.js +62 -0
  270. package/dist/internal/overlayMotion.js +48 -0
  271. package/dist/internal/paginationItem.d.ts +8 -0
  272. package/dist/internal/paginationItem.js +22 -0
  273. package/dist/internal/popoverSurface.d.ts +8 -0
  274. package/dist/internal/popoverSurface.js +23 -0
  275. package/dist/internal/portalContainer.d.ts +1 -0
  276. package/dist/internal/portalContainer.js +6 -0
  277. package/dist/internal/progressBarItem.d.ts +207 -0
  278. package/dist/internal/progressBarItem.js +264 -0
  279. package/dist/internal/selectionControlText.js +12 -0
  280. package/dist/internal/statusSummaryParts.js +371 -0
  281. package/dist/internal/summaryMotion.js +75 -0
  282. package/dist/internal/table/ChildConnector.js +62 -0
  283. package/dist/internal/table/ChildRowPrefix.d.ts +9 -0
  284. package/dist/internal/table/ChildRowPrefix.js +27 -0
  285. package/dist/internal/table/ColumnSettings.js +135 -0
  286. package/dist/internal/table/ScrollRegion.js +114 -0
  287. package/dist/internal/table/TableEmpty.js +93 -0
  288. package/dist/internal/table/TableLayout.d.ts +17 -0
  289. package/dist/internal/table/TableLayout.js +29 -0
  290. package/dist/internal/table/TableLoadStatus.js +56 -0
  291. package/dist/internal/table/TableMobile.js +488 -0
  292. package/dist/internal/table/TruncatedCell.js +33 -0
  293. package/dist/internal/table/emptyValue.js +10 -0
  294. package/dist/internal/table/features.d.ts +41 -0
  295. package/dist/internal/table/features.js +31 -0
  296. package/dist/internal/table/recipes.js +227 -0
  297. package/dist/internal/table/rowClick.js +9 -0
  298. package/dist/internal/table/types.d.ts +325 -0
  299. package/dist/internal/table/types.js +13 -0
  300. package/dist/internal/tailwind-variants.d.ts +3 -0
  301. package/dist/internal/tailwind-variants.js +37 -0
  302. package/dist/internal/tooltipContext.js +5 -0
  303. package/dist/internal/tw-merge-config.generated.js +314 -0
  304. package/dist/internal/useAnchoredPanel.d.ts +87 -0
  305. package/dist/internal/useAnchoredPanel.js +108 -0
  306. package/dist/internal/useCountUp.js +53 -0
  307. package/dist/internal/useDateFieldTrigger.js +183 -0
  308. package/dist/internal/useEChart.js +59 -0
  309. package/dist/internal/useEnterOnView.js +42 -0
  310. package/dist/internal/useFloatingBar.js +100 -0
  311. package/dist/internal/useFormReset.js +37 -0
  312. package/dist/internal/useIsMobile.js +44 -0
  313. package/dist/internal/useOneRowOverflow.js +88 -0
  314. package/dist/internal/usePrefersReducedMotion.js +25 -0
  315. package/dist/internal/useReturnFocus.js +26 -0
  316. package/dist/internal/utils.d.ts +7 -0
  317. package/dist/internal/utils.js +58 -0
  318. package/dist/node_modules/@tanstack/store/dist/store.d.ts +29 -0
  319. package/dist/node_modules/@tanstack/store/dist/types.d.ts +38 -0
  320. package/dist/node_modules/@tanstack/table-core/dist/core/cells/coreCellsFeature.d.ts +6 -0
  321. package/dist/node_modules/@tanstack/table-core/dist/core/cells/coreCellsFeature.types.d.ts +53 -0
  322. package/dist/node_modules/@tanstack/table-core/dist/core/columns/coreColumnsFeature.d.ts +6 -0
  323. package/dist/node_modules/@tanstack/table-core/dist/core/columns/coreColumnsFeature.types.d.ts +90 -0
  324. package/dist/node_modules/@tanstack/table-core/dist/core/coreFeatures.d.ts +17 -0
  325. package/dist/node_modules/@tanstack/table-core/dist/core/headers/coreHeadersFeature.d.ts +6 -0
  326. package/dist/node_modules/@tanstack/table-core/dist/core/headers/coreHeadersFeature.types.d.ts +114 -0
  327. package/dist/node_modules/@tanstack/table-core/dist/core/reactivity/coreReactivityFeature.types.d.ts +51 -0
  328. package/dist/node_modules/@tanstack/table-core/dist/core/row-models/coreRowModelsFeature.d.ts +6 -0
  329. package/dist/node_modules/@tanstack/table-core/dist/core/row-models/coreRowModelsFeature.types.d.ts +29 -0
  330. package/dist/node_modules/@tanstack/table-core/dist/core/rows/coreRowsFeature.d.ts +6 -0
  331. package/dist/node_modules/@tanstack/table-core/dist/core/rows/coreRowsFeature.types.d.ts +129 -0
  332. package/dist/node_modules/@tanstack/table-core/dist/core/table/coreTablesFeature.d.ts +6 -0
  333. package/dist/node_modules/@tanstack/table-core/dist/core/table/coreTablesFeature.types.d.ts +203 -0
  334. package/dist/node_modules/@tanstack/table-core/dist/features/cell-selection/cellSelectionFeature.d.ts +6 -0
  335. package/dist/node_modules/@tanstack/table-core/dist/features/cell-selection/cellSelectionFeature.types.d.ts +294 -0
  336. package/dist/node_modules/@tanstack/table-core/dist/features/cell-spanning/cellSpanningFeature.d.ts +11 -0
  337. package/dist/node_modules/@tanstack/table-core/dist/features/cell-spanning/cellSpanningFeature.types.d.ts +148 -0
  338. package/dist/node_modules/@tanstack/table-core/dist/features/column-faceting/columnFacetingFeature.d.ts +12 -0
  339. package/dist/node_modules/@tanstack/table-core/dist/features/column-faceting/columnFacetingFeature.types.d.ts +63 -0
  340. package/dist/node_modules/@tanstack/table-core/dist/features/column-filtering/columnFilteringFeature.d.ts +6 -0
  341. package/dist/node_modules/@tanstack/table-core/dist/features/column-filtering/columnFilteringFeature.types.d.ts +209 -0
  342. package/dist/node_modules/@tanstack/table-core/dist/features/column-filtering/filterFns.d.ts +35 -0
  343. package/dist/node_modules/@tanstack/table-core/dist/features/column-grouping/columnGroupingFeature.d.ts +6 -0
  344. package/dist/node_modules/@tanstack/table-core/dist/features/column-grouping/columnGroupingFeature.types.d.ts +128 -0
  345. package/dist/node_modules/@tanstack/table-core/dist/features/column-ordering/columnOrderingFeature.d.ts +6 -0
  346. package/dist/node_modules/@tanstack/table-core/dist/features/column-ordering/columnOrderingFeature.types.d.ts +82 -0
  347. package/dist/node_modules/@tanstack/table-core/dist/features/column-pinning/columnPinningFeature.d.ts +11 -0
  348. package/dist/node_modules/@tanstack/table-core/dist/features/column-pinning/columnPinningFeature.types.d.ts +195 -0
  349. package/dist/node_modules/@tanstack/table-core/dist/features/column-resizing/columnResizingFeature.d.ts +6 -0
  350. package/dist/node_modules/@tanstack/table-core/dist/features/column-resizing/columnResizingFeature.types.d.ts +73 -0
  351. package/dist/node_modules/@tanstack/table-core/dist/features/column-sizing/columnSizingFeature.d.ts +6 -0
  352. package/dist/node_modules/@tanstack/table-core/dist/features/column-sizing/columnSizingFeature.types.d.ts +134 -0
  353. package/dist/node_modules/@tanstack/table-core/dist/features/column-visibility/columnVisibilityFeature.d.ts +6 -0
  354. package/dist/node_modules/@tanstack/table-core/dist/features/column-visibility/columnVisibilityFeature.types.d.ts +92 -0
  355. package/dist/node_modules/@tanstack/table-core/dist/features/global-filtering/globalFilteringFeature.d.ts +6 -0
  356. package/dist/node_modules/@tanstack/table-core/dist/features/global-filtering/globalFilteringFeature.types.d.ts +67 -0
  357. package/dist/node_modules/@tanstack/table-core/dist/features/row-aggregation/aggregationFns.d.ts +23 -0
  358. package/dist/node_modules/@tanstack/table-core/dist/features/row-aggregation/rowAggregationFeature.d.ts +6 -0
  359. package/dist/node_modules/@tanstack/table-core/dist/features/row-aggregation/rowAggregationFeature.types.d.ts +183 -0
  360. package/dist/node_modules/@tanstack/table-core/dist/features/row-aggregation/rowAggregationFeature.utils.d.ts +18 -0
  361. package/dist/node_modules/@tanstack/table-core/dist/features/row-expanding/rowExpandingFeature.d.ts +6 -0
  362. package/dist/node_modules/@tanstack/table-core/dist/features/row-expanding/rowExpandingFeature.types.d.ts +125 -0
  363. package/dist/node_modules/@tanstack/table-core/dist/features/row-pagination/rowPaginationFeature.d.ts +6 -0
  364. package/dist/node_modules/@tanstack/table-core/dist/features/row-pagination/rowPaginationFeature.types.d.ts +135 -0
  365. package/dist/node_modules/@tanstack/table-core/dist/features/row-pinning/rowPinningFeature.d.ts +6 -0
  366. package/dist/node_modules/@tanstack/table-core/dist/features/row-pinning/rowPinningFeature.types.d.ts +76 -0
  367. package/dist/node_modules/@tanstack/table-core/dist/features/row-selection/rowSelectionFeature.d.ts +6 -0
  368. package/dist/node_modules/@tanstack/table-core/dist/features/row-selection/rowSelectionFeature.types.d.ts +187 -0
  369. package/dist/node_modules/@tanstack/table-core/dist/features/row-sorting/rowSortingFeature.d.ts +6 -0
  370. package/dist/node_modules/@tanstack/table-core/dist/features/row-sorting/rowSortingFeature.types.d.ts +236 -0
  371. package/dist/node_modules/@tanstack/table-core/dist/features/row-sorting/sortFns.d.ts +23 -0
  372. package/dist/node_modules/@tanstack/table-core/dist/features/stockFeatures.d.ts +37 -0
  373. package/dist/node_modules/@tanstack/table-core/dist/helpers/columnHelper.d.ts +47 -0
  374. package/dist/node_modules/@tanstack/table-core/dist/types/Cell.d.ts +16 -0
  375. package/dist/node_modules/@tanstack/table-core/dist/types/Column.d.ts +30 -0
  376. package/dist/node_modules/@tanstack/table-core/dist/types/ColumnDef.d.ts +123 -0
  377. package/dist/node_modules/@tanstack/table-core/dist/types/Header.d.ts +12 -0
  378. package/dist/node_modules/@tanstack/table-core/dist/types/HeaderGroup.d.ts +6 -0
  379. package/dist/node_modules/@tanstack/table-core/dist/types/Row.d.ts +24 -0
  380. package/dist/node_modules/@tanstack/table-core/dist/types/RowModel.d.ts +19 -0
  381. package/dist/node_modules/@tanstack/table-core/dist/types/RowModelFns.d.ts +11 -0
  382. package/dist/node_modules/@tanstack/table-core/dist/types/Table.d.ts +53 -0
  383. package/dist/node_modules/@tanstack/table-core/dist/types/TableFeatures.d.ts +416 -0
  384. package/dist/node_modules/@tanstack/table-core/dist/types/TableOptions.d.ts +78 -0
  385. package/dist/node_modules/@tanstack/table-core/dist/types/TableState.d.ts +46 -0
  386. package/dist/node_modules/@tanstack/table-core/dist/types/type-utils.d.ts +25 -0
  387. package/dist/shared.css +179 -0
  388. package/dist/styles.css +5467 -0
  389. package/dist/theme.css +314 -0
  390. package/dist/theme.map.json +278 -0
  391. package/dist/tokens/index.d.ts +2 -0
  392. package/dist/tokens/index.js +1 -0
  393. package/dist/tokens/tokens.generated.d.ts +2040 -0
  394. package/dist/tokens/tokens.generated.js +2053 -0
  395. package/dist/tokens.css +484 -0
  396. package/dist/tokens.flat.json +429 -0
  397. package/docs/Consuming.mdx +379 -0
  398. package/docs/Contributing.mdx +78 -0
  399. package/docs/ForAgents.mdx +53 -0
  400. package/docs/Introduction.mdx +54 -0
  401. package/llms.txt +556 -0
  402. package/package.json +351 -3
  403. package/src/components/action-row/ActionRow.mdx +686 -0
  404. package/src/components/action-row/ActionRow.stories.tsx +669 -0
  405. package/src/components/action-row/ActionRow.tsx +632 -0
  406. package/src/components/action-row/index.ts +9 -0
  407. package/src/components/alert/Alert.mdx +377 -0
  408. package/src/components/alert/Alert.stories.tsx +674 -0
  409. package/src/components/alert/Alert.tsx +579 -0
  410. package/src/components/alert/index.ts +13 -0
  411. package/src/components/anchored-panel/AnchoredPanel.mdx +381 -0
  412. package/src/components/anchored-panel/AnchoredPanel.stories.tsx +593 -0
  413. package/src/components/anchored-panel/AnchoredPanel.tsx +176 -0
  414. package/src/components/anchored-panel/index.ts +15 -0
  415. package/src/components/badge/Badge.mdx +487 -0
  416. package/src/components/badge/Badge.stories.tsx +375 -0
  417. package/src/components/badge/Badge.tsx +360 -0
  418. package/src/components/badge/index.ts +10 -0
  419. package/src/components/banner/Banner.mdx +704 -0
  420. package/src/components/banner/Banner.stories.tsx +448 -0
  421. package/src/components/banner/Banner.tsx +602 -0
  422. package/src/components/banner/index.ts +14 -0
  423. package/src/components/button/Button.mdx +286 -0
  424. package/src/components/button/Button.stories.tsx +381 -0
  425. package/src/components/button/Button.tsx +384 -0
  426. package/src/components/button/index.ts +1 -0
  427. package/src/components/button-group/ButtonGroup.mdx +512 -0
  428. package/src/components/button-group/ButtonGroup.stories.tsx +714 -0
  429. package/src/components/button-group/ButtonGroup.tsx +491 -0
  430. package/src/components/button-group/index.ts +10 -0
  431. package/src/components/card-select/CardSelect.mdx +662 -0
  432. package/src/components/card-select/CardSelect.stories.tsx +784 -0
  433. package/src/components/card-select/CardSelect.tsx +783 -0
  434. package/src/components/card-select/CardSelectGroup.tsx +169 -0
  435. package/src/components/card-select/index.ts +18 -0
  436. package/src/components/checkbox/Checkbox.mdx +269 -0
  437. package/src/components/checkbox/Checkbox.stories.tsx +306 -0
  438. package/src/components/checkbox/Checkbox.tsx +343 -0
  439. package/src/components/checkbox/index.ts +1 -0
  440. package/src/components/chip/Chip.mdx +683 -0
  441. package/src/components/chip/Chip.stories.tsx +734 -0
  442. package/src/components/chip/Chip.tsx +732 -0
  443. package/src/components/chip/index.ts +9 -0
  444. package/src/components/column-header/ColumnHeader.mdx +301 -0
  445. package/src/components/column-header/ColumnHeader.stories.tsx +319 -0
  446. package/src/components/column-header/ColumnHeader.tsx +287 -0
  447. package/src/components/column-header/index.ts +7 -0
  448. package/src/components/combobox-field/Combobox.tsx +693 -0
  449. package/src/components/combobox-field/ComboboxField.mdx +525 -0
  450. package/src/components/combobox-field/ComboboxField.stories.tsx +502 -0
  451. package/src/components/combobox-field/ComboboxField.tsx +259 -0
  452. package/src/components/combobox-field/index.ts +12 -0
  453. package/src/components/date-field/DateField.mdx +340 -0
  454. package/src/components/date-field/DateField.stories.tsx +221 -0
  455. package/src/components/date-field/DateField.tsx +176 -0
  456. package/src/components/date-field/index.ts +1 -0
  457. package/src/components/date-picker/DatePicker.mdx +436 -0
  458. package/src/components/date-picker/DatePicker.stories.tsx +458 -0
  459. package/src/components/date-picker/DatePicker.tsx +688 -0
  460. package/src/components/date-picker/index.ts +9 -0
  461. package/src/components/divider/Divider.mdx +256 -0
  462. package/src/components/divider/Divider.stories.tsx +177 -0
  463. package/src/components/divider/Divider.tsx +193 -0
  464. package/src/components/divider/index.ts +1 -0
  465. package/src/components/drawer/Drawer.mdx +518 -0
  466. package/src/components/drawer/Drawer.stories.tsx +392 -0
  467. package/src/components/drawer/Drawer.tsx +683 -0
  468. package/src/components/drawer/index.ts +1 -0
  469. package/src/components/dropdown-button/DropdownButton.mdx +285 -0
  470. package/src/components/dropdown-button/DropdownButton.stories.tsx +398 -0
  471. package/src/components/dropdown-button/DropdownButton.tsx +198 -0
  472. package/src/components/dropdown-button/index.ts +7 -0
  473. package/src/components/faq/FAQ.mdx +364 -0
  474. package/src/components/faq/FAQ.stories.tsx +343 -0
  475. package/src/components/faq/FAQ.tsx +337 -0
  476. package/src/components/faq/index.ts +1 -0
  477. package/src/components/field/Field.mdx +129 -0
  478. package/src/components/field/Field.stories.tsx +461 -0
  479. package/src/components/field/Field.tsx +765 -0
  480. package/src/components/field/index.ts +20 -0
  481. package/src/components/field-pair/FieldPair.mdx +308 -0
  482. package/src/components/field-pair/FieldPair.stories.tsx +530 -0
  483. package/src/components/field-pair/FieldPair.tsx +796 -0
  484. package/src/components/field-pair/index.ts +9 -0
  485. package/src/components/file-upload/FileUpload.mdx +345 -0
  486. package/src/components/file-upload/FileUpload.stories.tsx +698 -0
  487. package/src/components/file-upload/FileUpload.tsx +802 -0
  488. package/src/components/file-upload/index.ts +6 -0
  489. package/src/components/filter-chip/FilterChip.mdx +778 -0
  490. package/src/components/filter-chip/FilterChip.stories.tsx +827 -0
  491. package/src/components/filter-chip/FilterChip.tsx +881 -0
  492. package/src/components/filter-chip/index.ts +11 -0
  493. package/src/components/filter-facet/FilterFacet.mdx +536 -0
  494. package/src/components/filter-facet/FilterFacet.stories.tsx +506 -0
  495. package/src/components/filter-facet/FilterFacet.tsx +1160 -0
  496. package/src/components/filter-facet/index.ts +7 -0
  497. package/src/components/firm-avatar/FirmAvatar.mdx +280 -0
  498. package/src/components/firm-avatar/FirmAvatar.stories.tsx +147 -0
  499. package/src/components/firm-avatar/FirmAvatar.tsx +172 -0
  500. package/src/components/firm-avatar/index.ts +7 -0
  501. package/src/components/form-actions/FormActions.mdx +518 -0
  502. package/src/components/form-actions/FormActions.stories.tsx +621 -0
  503. package/src/components/form-actions/FormActions.tsx +273 -0
  504. package/src/components/form-actions/index.ts +6 -0
  505. package/src/components/form-block/FormBlock.mdx +728 -0
  506. package/src/components/form-block/FormBlock.stories.tsx +813 -0
  507. package/src/components/form-block/FormBlock.tsx +679 -0
  508. package/src/components/form-block/index.ts +13 -0
  509. package/src/components/form-section/FormSection.mdx +436 -0
  510. package/src/components/form-section/FormSection.stories.tsx +407 -0
  511. package/src/components/form-section/FormSection.tsx +290 -0
  512. package/src/components/form-section/index.ts +17 -0
  513. package/src/components/heading/Heading.mdx +206 -0
  514. package/src/components/heading/Heading.stories.tsx +169 -0
  515. package/src/components/heading/Heading.tsx +124 -0
  516. package/src/components/heading/index.ts +8 -0
  517. package/src/components/heading-group/HeadingGroup.mdx +521 -0
  518. package/src/components/heading-group/HeadingGroup.stories.tsx +353 -0
  519. package/src/components/heading-group/HeadingGroup.tsx +396 -0
  520. package/src/components/heading-group/index.ts +7 -0
  521. package/src/components/hero/Hero.mdx +742 -0
  522. package/src/components/hero/Hero.stories.tsx +527 -0
  523. package/src/components/hero/Hero.tsx +807 -0
  524. package/src/components/hero/index.ts +1 -0
  525. package/src/components/icon/Icon.mdx +329 -0
  526. package/src/components/icon/Icon.stories.tsx +398 -0
  527. package/src/components/icon/Icon.tsx +97 -0
  528. package/src/components/icon/index.ts +2 -0
  529. package/src/components/icon-button/IconButton.mdx +206 -0
  530. package/src/components/icon-button/IconButton.stories.tsx +341 -0
  531. package/src/components/icon-button/IconButton.tsx +273 -0
  532. package/src/components/icon-button/index.ts +1 -0
  533. package/src/components/item-row/ItemRow.mdx +533 -0
  534. package/src/components/item-row/ItemRow.stories.tsx +434 -0
  535. package/src/components/item-row/ItemRow.tsx +676 -0
  536. package/src/components/item-row/index.ts +9 -0
  537. package/src/components/list-row/ListRow.mdx +404 -0
  538. package/src/components/list-row/ListRow.stories.tsx +404 -0
  539. package/src/components/list-row/ListRow.tsx +424 -0
  540. package/src/components/list-row/index.ts +1 -0
  541. package/src/components/menu/Menu.mdx +268 -0
  542. package/src/components/menu/Menu.stories.tsx +455 -0
  543. package/src/components/menu/Menu.tsx +452 -0
  544. package/src/components/menu/index.ts +1 -0
  545. package/src/components/modal/Modal.mdx +854 -0
  546. package/src/components/modal/Modal.stories.tsx +881 -0
  547. package/src/components/modal/Modal.tsx +1434 -0
  548. package/src/components/modal/index.ts +1 -0
  549. package/src/components/nav-link/NavLink.mdx +196 -0
  550. package/src/components/nav-link/NavLink.stories.tsx +243 -0
  551. package/src/components/nav-link/NavLink.tsx +222 -0
  552. package/src/components/nav-link/index.ts +1 -0
  553. package/src/components/number-field/NumberField.mdx +223 -0
  554. package/src/components/number-field/NumberField.stories.tsx +291 -0
  555. package/src/components/number-field/NumberField.tsx +388 -0
  556. package/src/components/number-field/index.ts +6 -0
  557. package/src/components/pagination/Pagination.mdx +305 -0
  558. package/src/components/pagination/Pagination.stories.tsx +333 -0
  559. package/src/components/pagination/Pagination.tsx +343 -0
  560. package/src/components/pagination/index.ts +8 -0
  561. package/src/components/popover-surface/PopoverSurface.mdx +158 -0
  562. package/src/components/popover-surface/PopoverSurface.stories.tsx +421 -0
  563. package/src/components/popover-surface/index.ts +1 -0
  564. package/src/components/progress-bar/ProgressBar.mdx +802 -0
  565. package/src/components/progress-bar/ProgressBar.stories.tsx +533 -0
  566. package/src/components/progress-bar/ProgressBar.tsx +654 -0
  567. package/src/components/progress-bar/index.ts +9 -0
  568. package/src/components/promo-sticker/PromoSticker.mdx +436 -0
  569. package/src/components/promo-sticker/PromoSticker.stories.tsx +363 -0
  570. package/src/components/promo-sticker/PromoSticker.tsx +313 -0
  571. package/src/components/promo-sticker/index.ts +7 -0
  572. package/src/components/promo-surface/PromoSurface.mdx +399 -0
  573. package/src/components/promo-surface/PromoSurface.stories.tsx +270 -0
  574. package/src/components/promo-surface/PromoSurface.tsx +305 -0
  575. package/src/components/promo-surface/index.ts +7 -0
  576. package/src/components/radio/Radio.mdx +243 -0
  577. package/src/components/radio/Radio.stories.tsx +307 -0
  578. package/src/components/radio/Radio.tsx +288 -0
  579. package/src/components/radio/index.ts +1 -0
  580. package/src/components/radio-group/RadioGroup.mdx +119 -0
  581. package/src/components/radio-group/RadioGroup.stories.tsx +225 -0
  582. package/src/components/radio-group/RadioGroup.tsx +139 -0
  583. package/src/components/radio-group/index.ts +1 -0
  584. package/src/components/select/Select.mdx +241 -0
  585. package/src/components/select/Select.stories.tsx +404 -0
  586. package/src/components/select/Select.tsx +381 -0
  587. package/src/components/select/index.ts +1 -0
  588. package/src/components/select-field/SelectField.mdx +324 -0
  589. package/src/components/select-field/SelectField.stories.tsx +460 -0
  590. package/src/components/select-field/SelectField.tsx +138 -0
  591. package/src/components/select-field/index.ts +1 -0
  592. package/src/components/skeleton/Skeleton.mdx +194 -0
  593. package/src/components/skeleton/Skeleton.stories.tsx +260 -0
  594. package/src/components/skeleton/Skeleton.tsx +107 -0
  595. package/src/components/skeleton/index.ts +1 -0
  596. package/src/components/split-button/SplitButton.mdx +445 -0
  597. package/src/components/split-button/SplitButton.stories.tsx +465 -0
  598. package/src/components/split-button/SplitButton.tsx +361 -0
  599. package/src/components/split-button/index.ts +7 -0
  600. package/src/components/status-summary-bar/StatusSummaryBar.mdx +338 -0
  601. package/src/components/status-summary-bar/StatusSummaryBar.stories.tsx +408 -0
  602. package/src/components/status-summary-bar/StatusSummaryBar.tsx +428 -0
  603. package/src/components/status-summary-bar/index.ts +8 -0
  604. package/src/components/subject-lookup-field/SubjectLookupField.mdx +378 -0
  605. package/src/components/subject-lookup-field/SubjectLookupField.stories.tsx +393 -0
  606. package/src/components/subject-lookup-field/SubjectLookupField.tsx +1079 -0
  607. package/src/components/subject-lookup-field/index.ts +11 -0
  608. package/src/components/switch/Switch.mdx +376 -0
  609. package/src/components/switch/Switch.stories.tsx +296 -0
  610. package/src/components/switch/Switch.tsx +483 -0
  611. package/src/components/switch/index.ts +1 -0
  612. package/src/components/table/Table.mdx +575 -0
  613. package/src/components/table/Table.stories.tsx +1049 -0
  614. package/src/components/table/Table.tsx +745 -0
  615. package/src/components/table/TableConsumers.stories.tsx +195 -0
  616. package/src/components/table/_tableFixtures.ts +1189 -0
  617. package/src/components/table/index.ts +22 -0
  618. package/src/components/text-field/TextField.mdx +479 -0
  619. package/src/components/text-field/TextField.stories.tsx +366 -0
  620. package/src/components/text-field/TextField.tsx +391 -0
  621. package/src/components/text-field/index.ts +8 -0
  622. package/src/components/text-link/TextLink.mdx +353 -0
  623. package/src/components/text-link/TextLink.stories.tsx +458 -0
  624. package/src/components/text-link/TextLink.tsx +504 -0
  625. package/src/components/text-link/index.ts +10 -0
  626. package/src/components/textarea/Textarea.mdx +244 -0
  627. package/src/components/textarea/Textarea.stories.tsx +371 -0
  628. package/src/components/textarea/Textarea.tsx +489 -0
  629. package/src/components/textarea/index.ts +9 -0
  630. package/src/components/tooltip/Tooltip.mdx +462 -0
  631. package/src/components/tooltip/Tooltip.stories.tsx +500 -0
  632. package/src/components/tooltip/Tooltip.tsx +756 -0
  633. package/src/components/tooltip/index.ts +13 -0
  634. package/src/components/unit-field/UnitField.mdx +215 -0
  635. package/src/components/unit-field/UnitField.stories.tsx +291 -0
  636. package/src/components/unit-field/UnitField.tsx +255 -0
  637. package/src/components/unit-field/index.ts +7 -0
  638. package/src/icons/icon-registry.generated.ts +510 -0
  639. package/src/icons/icon-types.generated.ts +256 -0
  640. package/src/index.ts +71 -0
  641. package/src/internal/BottomSheet.tsx +714 -0
  642. package/src/internal/FodsProvider.tsx +36 -0
  643. package/src/internal/MotionCaret.tsx +53 -0
  644. package/src/internal/NumberFormatInput.tsx +276 -0
  645. package/src/internal/SummaryDonut.tsx +359 -0
  646. package/src/internal/buttonSegment.ts +241 -0
  647. package/src/internal/collapseRoom.ts +130 -0
  648. package/src/internal/comboboxKeys.ts +90 -0
  649. package/src/internal/contentPresence.ts +46 -0
  650. package/src/internal/dayCell.ts +274 -0
  651. package/src/internal/dialogPortal.ts +50 -0
  652. package/src/internal/donutSweeps.ts +77 -0
  653. package/src/internal/enterOnViewGeometry.ts +53 -0
  654. package/src/internal/faqItem.ts +104 -0
  655. package/src/internal/floatingLabelMotion.tsx +109 -0
  656. package/src/internal/formBlockContext.ts +27 -0
  657. package/src/internal/heightRoom.ts +135 -0
  658. package/src/internal/numberSeparators.ts +93 -0
  659. package/src/internal/overlayMotion.tsx +32 -0
  660. package/src/internal/paginationItem.ts +106 -0
  661. package/src/internal/popoverSurface.ts +78 -0
  662. package/src/internal/portalContainer.ts +11 -0
  663. package/src/internal/progressBarItem.ts +356 -0
  664. package/src/internal/selectionControlText.ts +42 -0
  665. package/src/internal/statusSummaryParts.tsx +475 -0
  666. package/src/internal/summaryMotion.ts +111 -0
  667. package/src/internal/table/ChildConnector.tsx +57 -0
  668. package/src/internal/table/ChildRowPrefix.tsx +21 -0
  669. package/src/internal/table/ColumnSettings.tsx +194 -0
  670. package/src/internal/table/ScrollRegion.tsx +176 -0
  671. package/src/internal/table/TableEmpty.tsx +99 -0
  672. package/src/internal/table/TableLayout.tsx +29 -0
  673. package/src/internal/table/TableLoadStatus.tsx +60 -0
  674. package/src/internal/table/TableMobile.tsx +582 -0
  675. package/src/internal/table/TruncatedCell.tsx +35 -0
  676. package/src/internal/table/emptyValue.ts +11 -0
  677. package/src/internal/table/features.ts +44 -0
  678. package/src/internal/table/recipes.ts +263 -0
  679. package/src/internal/table/rowClick.ts +8 -0
  680. package/src/internal/table/types.ts +342 -0
  681. package/src/internal/tailwind-variants.ts +65 -0
  682. package/src/internal/tooltipContext.ts +15 -0
  683. package/src/internal/tw-merge-config.generated.ts +275 -0
  684. package/src/internal/useAnchoredPanel.ts +340 -0
  685. package/src/internal/useCountUp.ts +65 -0
  686. package/src/internal/useDateFieldTrigger.tsx +357 -0
  687. package/src/internal/useEChart.ts +88 -0
  688. package/src/internal/useEnterOnView.ts +80 -0
  689. package/src/internal/useFloatingBar.ts +125 -0
  690. package/src/internal/useFormReset.ts +47 -0
  691. package/src/internal/useIsMobile.ts +64 -0
  692. package/src/internal/useNoImplicitSubmit.ts +41 -0
  693. package/src/internal/useOneRowOverflow.ts +103 -0
  694. package/src/internal/usePrefersReducedMotion.ts +27 -0
  695. package/src/internal/useReturnFocus.ts +34 -0
  696. package/src/internal/utils.ts +58 -0
  697. package/src/recipes/EmptyState.stories.tsx +105 -0
  698. package/src/recipes/Form.stories.tsx +355 -0
  699. package/src/recipes/ModalWithForm.stories.tsx +219 -0
  700. package/src/recipes/Recipes.mdx +61 -0
  701. package/src/recipes/TableWithFilters.stories.tsx +278 -0
  702. package/src/storybook/FodsFamily.tsx +39 -0
  703. package/src/storybook/Section.tsx +36 -0
  704. package/src/storybook/a11y.ts +24 -0
  705. package/src/storybook/assets/banner-character-bartender.webp +0 -0
  706. package/src/storybook/assets/banner-invoice-sheet-left.webp +0 -0
  707. package/src/storybook/assets/banner-invoice-sheet-right.webp +0 -0
  708. package/src/storybook/assets/invoice-hero.webp +0 -0
  709. package/src/storybook/assets/invoice.webp +0 -0
  710. package/src/storybook/assets/section-document-info.svg +21 -0
  711. package/src/storybook/assets/section-gear-checklist.svg +11 -0
  712. package/src/storybook/assets/section-person-arrow-in.svg +15 -0
  713. package/src/storybook/assets/section-person-arrow-out.svg +22 -0
  714. package/src/storybook/assets/section-receipt-dollar.svg +23 -0
  715. package/src/storybook/assets/table-empty-folder-empty.png +0 -0
  716. package/src/storybook/assets/table-empty-folder-magnifying-glass.png +0 -0
  717. package/src/storybook/assets/table-empty-funnel.png +0 -0
  718. package/src/storybook/assets/table-empty-load-failed.png +0 -0
  719. package/src/storybook/assets/wallet-spot.png +0 -0
  720. package/src/storybook/assets.d.ts +17 -0
  721. package/src/storybook/componentDoc.ts +41 -0
  722. package/src/storybook/fitFrame.tsx +70 -0
  723. package/src/storybook/forceStates.tsx +647 -0
  724. package/src/storybook/illustrations.tsx +66 -0
  725. package/src/storybook/viewportFrame.tsx +58 -0
  726. package/src/styles/assets/label-brush-1.svg +6 -0
  727. package/src/styles/assets/pattern-dark.svg +113 -0
  728. package/src/styles/base.css +106 -0
  729. package/src/styles/index.css +15 -0
  730. package/src/styles/motion.css +157 -0
  731. package/src/styles/promo-sticker.css +27 -0
  732. package/src/styles/promo-surface.css +49 -0
  733. package/src/styles/shared.css +11 -0
  734. package/src/styles/theme.generated.css +314 -0
  735. package/src/styles/theme.map.json +278 -0
  736. package/src/styles/tracking.generated.css +12 -0
  737. package/src/tokens/index.ts +4 -0
  738. package/src/tokens/tokens.generated.ts +542 -0
@@ -0,0 +1,364 @@
1
+ import { Meta, Canvas, Controls } from '@storybook/addon-docs/blocks';
2
+ import * as FAQStories from './FAQ.stories';
3
+ import { ViewportFrame } from '../../storybook/viewportFrame';
4
+
5
+ <Meta of={FAQStories} tags={['autodocs']} />
6
+
7
+ # FAQ
8
+
9
+ ## Metadata
10
+
11
+ - **Layer:** organism
12
+ - **Kind:** region
13
+ - **Status:** draft
14
+ - **Storybook:** [design-system-organisms-faq](?path=/docs/design-system-organisms-faq--docs)
15
+ - **Tokens used:** `--bg-active`, `--bg-hover`, `--bg-primary`, `--bg-secondary`, `--border-width-100`, `--border-width-200`, `--font-body`, `--font-heading`, `--font-size-base`, `--font-size-display-d1`, `--font-size-display-d2`, `--font-size-display-d3`, `--font-size-heading-h1`, `--font-size-heading-h2`, `--font-size-heading-h3`, `--font-size-heading-h4`, `--font-size-heading-h5`, `--font-weight-bold`, `--font-weight-semibold`, `--leading-compact`, `--leading-relaxed`, `--leading-tight`, `--outline-default`, `--outline-focus`, `--outline-strong`, `--radius-600`, `--secondary-subtle`, `--size-icon`, `--space-1000`, `--space-1100`, `--space-1200`, `--space-1300`, `--space-200`, `--space-500`, `--space-600`, `--space-700`, `--space-800`, `--space-900`, `--text-primary`, `--text-secondary`, `--text-wrap-body`, `--text-wrap-heading`
16
+ - **Manifest version:** `2.6.3`
17
+ - **Card manifest:** `_faq-item` `2.4.1`
18
+
19
+ ## Overview
20
+
21
+ **FAQ** is the question-and-answer section of a public page: a heading rail beside (or above) a
22
+ register of question cards, on a full-width `--bg-secondary` band, with an optional support
23
+ contact card. Place it near the foot of a
24
+ landing page or the homepage, where the remaining objections are answered before the closing call
25
+ to action, and only when every answer is short enough to read at a glance.
26
+
27
+ **Do not** use it in-app. It is public-page furniture — not contextual help (that is
28
+ [Tooltip](?path=/docs/design-system-atoms-tooltip--docs)) and not a notice (that is Alert). The card
29
+ `_faq-item` is not a generic disclosure either: it exists only inside this section.
30
+
31
+ ## Rationale
32
+
33
+ FAQ exists so every public page answers its last objections in the same section instead of
34
+ hand-building a question list from paragraph text. The section is self-bleeding: the root carries
35
+ the page's side padding (16 / 24 / 32 / 40 / 40) and the section's vertical padding
36
+ (48 / 48 / 64 / 80 / 80), so it drops onto a page flush with Hero and the rest of the marketing
37
+ stack, with no wrapper.
38
+
39
+ The card is a full-card toggle, not a chevron button: the whole card is the hit area, and the
40
+ question is a real `<h3>`, so a screen-reader user can jump between questions by heading.
41
+
42
+ Structured data is deliberately **not** in the component. `delivery.react` asks for FAQPage JSON-LD
43
+ wherever the section is indexable, generated from the same source as the visible cards — that is the
44
+ consumer page's job, so one page never ships it twice.
45
+
46
+ ## Anatomy
47
+
48
+ <table>
49
+ <thead>
50
+ <tr><th>Part</th><th><code>data-fods-part</code></th><th>What it is</th><th>Tokens</th></tr>
51
+ </thead>
52
+ <tbody>
53
+ <tr><td>Root</td><td><code>root</code></td><td><code>&lt;section aria-labelledby&gt;</code> — the full-width band; carries the side and vertical padding ladders</td><td>fill <code>--bg-secondary</code>; padding <code>--space-600</code> / <code>--space-800</code> / <code>--space-900</code> / <code>--space-1000</code> × <code>--space-1100</code> / <code>--space-1200</code> / <code>--space-1300</code></td></tr>
54
+ <tr><td>Content</td><td><code>content</code></td><td>Rail + register, capped and centred in the root</td><td>Default <code>--ds-content-wide</code>, Compact <code>--ds-content-medium</code>; stacked gap <code>--space-900</code>; LG/XL gutter <code>--space-800</code></td></tr>
55
+ <tr><td>Rail</td><td><code>rail</code></td><td>Heading, optional description, optional link</td><td>gap <code>--space-600</code></td></tr>
56
+ <tr><td>Heading</td><td><code>heading</code></td><td>The section's <code>&lt;h2&gt;</code> (DS <code>Heading</code>, size <code>d3</code>)</td><td><code>--font-size-display-d3</code>, <code>--font-heading</code>, <code>--text-primary</code></td></tr>
57
+ <tr><td>Description</td><td><code>description</code></td><td>Optional one-line lead, capped at <code>--ds-content-narrow</code></td><td><code>--font-size-base</code>, <code>--text-secondary</code></td></tr>
58
+ <tr><td>Link</td><td><code>link</code></td><td>Optional slot for the Text Link to a guide or the help centre («Nápověda», leading <code>book</code>) — never support</td><td>—</td></tr>
59
+ <tr><td>Register</td><td><code>register</code></td><td>The cards, in reading order</td><td>gap <code>--space-600</code></td></tr>
60
+ <tr><td>Contact card</td><td><code>contact-card</code></td><td>Optional support card (<code>showContact</code> + <code>contact</code>): Heading Group H5 (<code>&lt;h3&gt;</code> title + one line), then the e-mail / phone links. Default: foot of the rail at LG/XL, under the register from MD down; Compact: under the register. Content left-aligned</td><td>fill <code>--secondary-subtle</code>, radius <code>--radius-600</code>, padding <code>--space-600</code>, gap <code>--space-500</code>; no border, no shadow</td></tr>
61
+ <tr><td>Contact links</td><td><code>contact-links</code></td><td>Text Link sm rows — <code>envelope</code> + <code>mailto:</code>, <code>phone</code> + <code>tel:</code> (no-wrap label, href without spaces). The phone row is absent without <code>contact.phone</code></td><td>gap <code>--space-200</code></td></tr>
62
+ <tr><td>Item (card)</td><td><code>item</code></td><td>One <code>_faq-item</code>: content column + chevron column</td><td>fill <code>--bg-primary</code>, outline <code>--border-width-100</code> <code>--outline-default</code>, radius <code>--radius-600</code>, padding <code>--space-800</code>, column gap <code>--space-700</code></td></tr>
63
+ <tr><td>Question</td><td><code>question</code></td><td><code>&lt;h3&gt;</code> (DS <code>Heading</code>, size <code>h4</code>) wrapping the toggle</td><td><code>--font-size-heading-h4</code>, <code>--text-primary</code></td></tr>
64
+ <tr><td>Trigger</td><td><code>trigger</code></td><td><code>&lt;button aria-expanded aria-controls&gt;</code>; its <code>::after</code> stretches over the whole card</td><td>—</td></tr>
65
+ <tr><td>Answer</td><td><code>answer</code></td><td>Rich text inside <code>role="region"</code>; a string is wrapped in <code>&lt;p&gt;</code></td><td><code>--font-size-base</code>, <code>--text-secondary</code>, top padding <code>--space-500</code></td></tr>
66
+ <tr><td>Chevron</td><td><code>chevron</code></td><td>Decorative <code>caret-down-small</code>, turned 180° while open, <code>aria-hidden</code></td><td><code>--size-icon</code>, <code>--text-primary</code></td></tr>
67
+ </tbody>
68
+ </table>
69
+
70
+ ## Variants
71
+
72
+ <Canvas of={FAQStories.Matrix} />
73
+
74
+ <table>
75
+ <thead>
76
+ <tr><th>Variant</th><th>When</th><th>Layout</th></tr>
77
+ </thead>
78
+ <tbody>
79
+ <tr><td><code>default</code></td><td>Full-width sections — marketing pages and the FAQ after a blog or help article, which sits on the block-content line</td><td>LG: rail 4 columns · register 8. XL: rail 4 · one empty column · register 7. From MD down the rail stacks above the cards (gap <code>--space-900</code>).</td></tr>
80
+ <tr><td><code>compact</code></td><td>Pages whose content runs in one medium column (a template page)</td><td>One column at every breakpoint, capped at <code>--ds-content-medium</code> and centred; heading, description and link centre-aligned.</td></tr>
81
+ </tbody>
82
+ </table>
83
+
84
+ <Canvas of={FAQStories.Compact} />
85
+
86
+ Show description and Show link are content properties: omit `description` / `link` to turn them
87
+ off — the single-path landing-page configuration.
88
+
89
+ <Canvas of={FAQStories.WithoutDescriptionAndLink} />
90
+
91
+ ### Contact card
92
+
93
+ Show contact card (`showContact` + `contact`) adds the route to a person; turn `link` off while it
94
+ is on — one route to support is enough. Show contact phone is derived from `contact.phone`: without
95
+ it the phone row disappears and the line should offer only writing.
96
+
97
+ <Canvas of={FAQStories.WithContact} />
98
+ <Canvas of={FAQStories.WithContactWithoutPhone} />
99
+
100
+ From MD down Default runs in one column and the card moves under the register:
101
+
102
+ <ViewportFrame storyId="design-system-organisms-faq--with-contact-breakpoint-md" width={768} label="With contact · MD · 768" />
103
+
104
+ Compact always sets it under the register, as wide as the register:
105
+
106
+ <Canvas of={FAQStories.CompactWithContact} />
107
+ <Canvas of={FAQStories.CompactWithContactWithoutPhone} />
108
+
109
+ ## Sizes
110
+
111
+ There is no `size` prop — the breakpoint *is* the size, and it is pure CSS (Mobile unprefixed,
112
+ then `sm:`, `md:`, `lg:`, `xl:`). The previews below are real iframes at each band's minimum width,
113
+ scaled to fit the column.
114
+
115
+ <table>
116
+ <thead>
117
+ <tr>
118
+ <th>Breakpoint</th><th>Prefix</th>
119
+ <th>Side padding</th><th>Vertical padding</th><th>Default layout</th>
120
+ </tr>
121
+ </thead>
122
+ <tbody>
123
+ <tr><td>XL</td><td><code>xl:</code></td><td><code>--space-1000</code> (40)</td><td><code>--space-1300</code> (80)</td><td>4 · empty · 7</td></tr>
124
+ <tr><td>LG</td><td><code>lg:</code></td><td><code>--space-1000</code> (40)</td><td><code>--space-1300</code> (80)</td><td>4 · 8</td></tr>
125
+ <tr><td>MD</td><td><code>md:</code></td><td><code>--space-900</code> (32)</td><td><code>--space-1200</code> (64)</td><td>stacked</td></tr>
126
+ <tr><td>SM</td><td><code>sm:</code></td><td><code>--space-800</code> (24)</td><td><code>--space-1100</code> (48)</td><td>stacked</td></tr>
127
+ <tr><td>Mobile</td><td>—</td><td><code>--space-600</code> (16)</td><td><code>--space-1100</code> (48)</td><td>stacked</td></tr>
128
+ </tbody>
129
+ </table>
130
+
131
+ The card has a single size: it fills the register column and its height hugs the copy — it never
132
+ clips or scrolls.
133
+
134
+ <ViewportFrame storyId="design-system-organisms-faq--breakpoint-xl" width={1280} label="XL · 1280" />
135
+ <ViewportFrame storyId="design-system-organisms-faq--breakpoint-lg" width={1024} label="LG · 1024" />
136
+ <ViewportFrame storyId="design-system-organisms-faq--breakpoint-md" width={768} label="MD · 768" />
137
+ <ViewportFrame storyId="design-system-organisms-faq--breakpoint-sm" width={640} label="SM · 640" />
138
+ <ViewportFrame storyId="design-system-organisms-faq--breakpoint-mobile" width={390} label="Mobile · 390" />
139
+
140
+ ## States
141
+
142
+ The section has no states. Each card has State × Open; the grid below paints them statically
143
+ (rows = state, columns = closed / open).
144
+
145
+ <Canvas of={FAQStories.States} />
146
+
147
+ - **Default** — fill `--bg-primary`, outline `--outline-default`.
148
+ - **Hover** — outline `--outline-strong`, plus a `--bg-hover` wash layered on a `::before` over the
149
+ fill; outline and wash ease in on `--duration-hover` / `--easing-standard`.
150
+ - **Active** — outline `--outline-strong`, plus a `--bg-active` wash, on `--duration-press` /
151
+ `--easing-standard`.
152
+ - **Focus** — not a variant: the system focus ring (`--outline-focus`, `--border-width-200`, 2px
153
+ offset) drawn around the **whole card** while its trigger has `:focus-visible`.
154
+ - **Open** (`_faq-item` 2.4.0 `motion`, run by Motion) — the caret, one `caret-down-small`, starts
155
+ its 180° turn on `--spring-standard` at the moment of activation. Opening: the answer leaves
156
+ `hidden`, its room opens on `--spring-gentle` while it fades in over `--duration-slow` +
157
+ `--easing-enter`, and the cards below move down with it. Closing: the answer is `inert` at once,
158
+ fades out over `--duration-fast` + `--easing-exit` first, and only then does its room close; it
159
+ takes `hidden` when the close ends (`motion.collapsed`), so it leaves no gap, the tab order or the
160
+ accessibility tree. A second click mid-way reverses the caret, the room and the fade from where
161
+ they are. Under `prefers-reduced-motion` the caret jumps, the room switches at once and the fade
162
+ shortens to `--duration-instant`; `aria-expanded` still flips.
163
+
164
+ <Canvas of={FAQStories.Motion} />
165
+
166
+ Every card loads closed, and opening one never closes another.
167
+
168
+ ## API
169
+
170
+ <Controls />
171
+
172
+ `items` is an array of `FAQItemData`: `id` (stable key), `question` (string, the `<h3>` text) and
173
+ `answer` (a string, wrapped in a `<p>`, or any node — e.g. a paragraph with one inline
174
+ `TextLink`). `link` is a node slot; pass `<TextLink size="md" leadingIcon="book">Nápověda</TextLink>`.
175
+
176
+ The contact card (faq 2.6.0):
177
+
178
+ <table>
179
+ <thead>
180
+ <tr><th>Manifest property</th><th>Prop</th><th>Notes</th></tr>
181
+ </thead>
182
+ <tbody>
183
+ <tr><td>Show contact card (<code>showContactCard</code>)</td><td><code>showContact</code> (boolean, default <code>false</code>)</td><td>Nothing renders without <code>contact</code>. The prop keeps its pre-2.6.0 name so existing pages compile unchanged.</td></tr>
184
+ <tr><td>contact-heading — title / line</td><td><code>contact.heading</code> / <code>contact.description</code></td><td>Heading Group H5, title rendered as <code>&lt;h3&gt;</code>. Title max 30 characters, line max 60 (<code>text.contact-title</code> / <code>text.contact-description</code>).</td></tr>
185
+ <tr><td>email-link</td><td><code>contact.email</code></td><td>Label and <code>mailto:</code> target — the market's support address from market data, never hard-coded.</td></tr>
186
+ <tr><td>Show contact phone / phone-link</td><td><code>contact.phone</code> (optional)</td><td>Present = row shown. Label is the number in the market's format and never wraps; the <code>tel:</code> href drops the spaces.</td></tr>
187
+ </tbody>
188
+ </table>
189
+
190
+ One package extension outside `faq.manifest.json`:
191
+
192
+ - `footer` — a node rendered inside the register, under the cards (e.g. a `<nav>` with links to
193
+ articles). It carries no rule or fill.
194
+
195
+ ## Do / Don't
196
+
197
+ - ✅ Three to six questions; answers short enough to read at a glance.
198
+ - ✅ Point `link` at a guide or the help centre («Nápověda», leading `book`).
199
+ - ✅ Send the reader to a person with the contact card, filled from the market's contact data; turn `link` off while it is on.
200
+ - ✅ Omit `contact.phone` on markets without a support line, and word the line for writing only.
201
+ - ✅ Emit FAQPage JSON-LD on the page from the same data as `items`.
202
+ - ✅ Drop the section onto the page with no padded wrapper — its own padding is the section rhythm.
203
+ - ❌ Don't number the questions or label the chevron.
204
+ - ❌ Don't use it in-app or as a generic disclosure — use ListRow or the Responsive Collapse pattern.
205
+ - ❌ Don't put long, multi-paragraph answers here; those belong in the help centre.
206
+ - ❌ Don't wrap it in another `--bg-secondary` panel or add side padding around it.
207
+ - ❌ Don't point `link` at support, or show a support link and the contact card together.
208
+ - ❌ Don't give the contact card a white plate or an outline — that is a question card.
209
+
210
+ ## Accessibility
211
+
212
+ - **Keyboard** — every card's trigger is a native `<button>` in the tab order; Enter and Space
213
+ toggle it. A closed answer is `hidden` and `inert`, so its links are out of the tab order until
214
+ the card opens.
215
+ - **ARIA** — the root is a `<section>` labelled by its `<h2>`. Each trigger carries
216
+ `aria-expanded` (always `true` or `false`) and `aria-controls` pointing at the answer, which is a
217
+ `role="region"` labelled by the trigger. The chevron is `aria-hidden`.
218
+ - **Screen reader** — questions are announced as level-3 headings containing a collapsed/expanded
219
+ button; an open answer is announced as a region named by its question. The contact card is a
220
+ plain `<div>` (no landmark); its title is an `<h3>` among the question `<h3>`s by design, and its
221
+ links are real `mailto:` / `tel:` links named by the address and the number.
222
+ - **Tab order** — rail link, the cards in reading order (plus any link in an open answer), then the
223
+ contact card's links. That matches `delivery.react` in Compact and in Default from MD down; at
224
+ Default LG/XL the spec puts the card's links before the cards — see Migration notes.
225
+ - **Pointer** — the trigger's `::after` stretches over the whole card, so a click anywhere on the
226
+ card toggles it; links and buttons inside the answer sit above that layer and never toggle.
227
+ - **Contrast & motion** — question `--text-primary`, answer `--text-secondary` on `--bg-primary`;
228
+ on the contact card's `--secondary-subtle` the link is 5.14:1 and the line 5.6:1 (manifest);
229
+ the focus ring is offset outside the card. Under `prefers-reduced-motion: reduce` the room opens and
230
+ closes at once and the caret jumps (see [States](#states)).
231
+
232
+ Accessibility floor for every FODS component: `spec/01-foundations/accessibility.md`.
233
+
234
+ ## Copy
235
+
236
+ Voice: impersonal, plain, no exclamation marks, no salesy adjectives.
237
+
238
+ - **Heading** (`heading`) — two or three plain words naming the section; never a question
239
+ itself. Wraps rather than truncating, max 30 characters; at Display/D3 in the LG rail it takes
240
+ two lines, which is expected.
241
+ - **Description** (`description`, optional) — one line saying what this particular set of
242
+ questions covers; never repeats the heading. Wraps, max 100 characters.
243
+ - **Contact card title** (`contact.heading`) — the reader's own question. Wraps, max 30
244
+ characters.
245
+ - **Contact card line** (`contact.description`) — one line saying how to reach a person. Wraps,
246
+ max 60 characters. Its one negation answers the fear of talking to a bot. Without
247
+ `contact.phone` the line offers only writing — never an invitation to call with no number
248
+ under it.
249
+ - **Questions** (`items[].question`) — written the way a reader would ask them, second person
250
+ plural or impersonal; never a feature name or a marketing headline dressed up with a question
251
+ mark. Wraps, never truncates, max 50 characters. Example: "Kolik stojí fakturační program?"
252
+ - **Answers** (`items[].answer`) — lead with the answer itself ("Ne." or "Ano —"), the caveat
253
+ after it. They say what is and what the reader can do; a negation stays only where it answers
254
+ the fear in the question ("Musím něco instalovat?" → "Nemusíte."), at most one per answer.
255
+ Recommended 100–150 characters, max 200 — past that, split the question or move the detail to
256
+ the help centre. Plain prose only, no lists; at most one inline Text Link.
257
+ - **Czech typesetting** applies to every question and answer: a non-breaking space between a
258
+ numeral and its unit ("468 Kč") and after a single-letter preposition.
259
+ - **Rail link** (`link`) — points at a guide or the help centre with a leading `book` icon and a
260
+ destination noun such as "Nápověda"; never at support, never an anchor inside the same page.
261
+ - **Contact links** carry the value itself — the market's support e-mail and phone number in the
262
+ market's own format — never "Napište nám" or "Klikněte zde", and no label above the value.
263
+
264
+ Canonical contact-card copy:
265
+
266
+ <table>
267
+ <thead>
268
+ <tr><th>Run</th><th>CZ</th><th>SK</th></tr>
269
+ </thead>
270
+ <tbody>
271
+ <tr><td>Title</td><td>Nenašli jste odpověď?</td><td>Nenašli ste odpoveď?</td></tr>
272
+ <tr><td>Line (with phone)</td><td>Napište nebo zavolejte, odpovídá člověk, ne robot.</td><td>Napíšte alebo zavolajte, odpovedá človek, nie robot.</td></tr>
273
+ <tr><td>Line (without phone)</td><td>Napište nám, odpovídá člověk, ne robot.</td><td>—</td></tr>
274
+ </tbody>
275
+ </table>
276
+
277
+ ## Usage
278
+
279
+ ```tsx
280
+ import { FAQ, TextLink } from '@invoiceonline/ui-react';
281
+
282
+ <FAQ
283
+ heading="Časté dotazy"
284
+ description="Nejčastější otázky před založením účtu."
285
+ link={<TextLink href="#" size="md" leadingIcon="book">Nápověda</TextLink>}
286
+ items={[
287
+ { id: 'install', question: 'Musím něco instalovat?', answer: 'Nemusíte.' },
288
+ {
289
+ id: 'import',
290
+ question: 'Mohu převést kontakty?',
291
+ answer: (
292
+ <p>
293
+ Ano — postup popisuje <TextLink href="#" size="inherit">nápověda</TextLink>.
294
+ </p>
295
+ ),
296
+ },
297
+ ]}
298
+ />
299
+
300
+ // Single-path landing page: no description, no link
301
+ <FAQ heading="Časté dotazy" items={items} />
302
+
303
+ // One medium column (a template page); an article page uses Default
304
+ <FAQ variant="compact" heading="Časté dotazy" items={items} />
305
+
306
+ // Contact card instead of the rail link; email / phone come from the market's contact data.
307
+ <FAQ
308
+ heading="Časté dotazy"
309
+ items={items}
310
+ showContact
311
+ contact={{
312
+ heading: 'Nenašli jste odpověď?',
313
+ description: 'Napište nebo zavolejte, odpovídá člověk, ne robot.',
314
+ email: market.supportEmail,
315
+ phone: market.supportPhone, // omit where the market has no support line
316
+ }}
317
+ />
318
+ ```
319
+
320
+ ## Related
321
+
322
+ - [Heading](?path=/docs/design-system-atoms-heading--docs) — the `<h2>` and the card questions
323
+ - [TextLink](?path=/docs/design-system-atoms-textlink--docs) — the rail link, the contact links and inline answer links
324
+ - [HeadingGroup](?path=/docs/design-system-molecules-headinggroup--docs) — the contact card title + line
325
+ - [Hero](?path=/docs/design-system-organisms-hero--docs) — the same breakpoint-is-sizing model
326
+ - Specs: `spec/07-web/faq.md`, `spec/07-web/_faq-item.manifest.json`
327
+
328
+ ## Migration notes
329
+
330
+ FAQ has no predecessor in the system (spec `## Migration`). Manifest updates since the `2.4.2` stamp:
331
+
332
+ **Adopted**
333
+
334
+ - faq 2.5.0–2.5.2 — status READY upstream, motion declared static (`motion.none`), spec moved to
335
+ `spec/07-web/`. No code change; the Status line here stays `draft` while the card motion below is open.
336
+ - faq 2.6.0–2.6.2 — the contact card. The pre-2.6.0 card (white `--bg-primary` plate,
337
+ `--radius-500`, a `<p>` lead, always in the rail)
338
+ became the manifest card: `--secondary-subtle`, `--radius-600`, padding `--space-600`, gap
339
+ `--space-500`, link stack `--space-200`, Heading Group H5 with an `<h3>` title, placed under the
340
+ register from MD down and in Compact. The API (`showContact`, `contact`) is unchanged, so
341
+ consumer pages compile as they were.
342
+ - faq 2.6.1 — the rail link points at a guide or the help centre («Nápověda», leading `book`); the
343
+ stories and docs no longer show «Kontaktovat podporu».
344
+ - faq 2.6.3 — documentation only: an article page uses **Default** (the FAQ follows the article on
345
+ the block-content line); Compact is for template pages. The Variants table and Usage say so. No code
346
+ change.
347
+ - `_faq-item` 2.4.0 `motion.states.hover` / `press` — border and wash ease on `--duration-hover` /
348
+ `--duration-press`, `--easing-standard`.
349
+
350
+ - `_faq-item` 2.3.0 — the answer's room opens and closes on `--spring-gentle` while the answer fades
351
+ `--duration-slow` / `--easing-enter` in and `--duration-fast` / `--easing-exit` out; closing waits
352
+ for the fade. Replaces the 2.2.2 `grid-template-rows` 0fr ↔ 1fr transition.
353
+ - `_faq-item` 2.4.0 `motion.states.open` — one `caret-down-small` turning 180° on `--spring-standard`
354
+ instead of the caret-down ↔ caret-up swap. 2.4.1 — spec moved to `spec/07-web/`, no code change.
355
+
356
+ **Known deviation — the room is the answer's height.** `motion.layout.note` asks for Motion's
357
+ `layout` (size through transforms, never height). A transform-scaled card would stretch its hairline,
358
+ its corners and the focus ring during the turn, and content after the section would jump; the answer
359
+ row's `height` therefore runs on the same `--spring-gentle` and everything below follows it.
360
+
361
+ **Known deviation — tab order at Default LG/XL.** `delivery.react` puts the contact card's links
362
+ before the cards there. The card is one node after the register (so DOM order matches the visual
363
+ order in every one-column layout) and the LG/XL grid moves it into the rail column, so at LG/XL its
364
+ links come after the cards.