prime-ui-kit 0.2.5 → 0.3.2

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 (870) hide show
  1. package/README.md +165 -35
  2. package/dist/components/accordion/Accordion.d.ts +70 -0
  3. package/dist/components/accordion/Accordion.d.ts.map +1 -0
  4. package/dist/components/accordion/examples/01-faq-marketing.d.ts +5 -0
  5. package/dist/components/accordion/examples/01-faq-marketing.d.ts.map +1 -0
  6. package/dist/components/accordion/examples/02-settings-panels.d.ts +6 -0
  7. package/dist/components/accordion/examples/02-settings-panels.d.ts.map +1 -0
  8. package/dist/components/accordion/examples/03-checkout-order-summary.d.ts +5 -0
  9. package/dist/components/accordion/examples/03-checkout-order-summary.d.ts.map +1 -0
  10. package/dist/components/accordion/examples/04-api-docs-sections.d.ts +6 -0
  11. package/dist/components/accordion/examples/04-api-docs-sections.d.ts.map +1 -0
  12. package/dist/components/accordion/examples/05-knowledge-base-categories.d.ts +6 -0
  13. package/dist/components/accordion/examples/05-knowledge-base-categories.d.ts.map +1 -0
  14. package/dist/components/avatar/Avatar.d.ts +58 -0
  15. package/dist/components/avatar/Avatar.d.ts.map +1 -0
  16. package/dist/components/avatar/examples/app-header-nav.d.ts +5 -0
  17. package/dist/components/avatar/examples/app-header-nav.d.ts.map +1 -0
  18. package/dist/components/avatar/examples/comment-thread.d.ts +5 -0
  19. package/dist/components/avatar/examples/comment-thread.d.ts.map +1 -0
  20. package/dist/components/avatar/examples/fallback-variants.d.ts +5 -0
  21. package/dist/components/avatar/examples/fallback-variants.d.ts.map +1 -0
  22. package/dist/components/avatar/examples/group-overflow.d.ts +5 -0
  23. package/dist/components/avatar/examples/group-overflow.d.ts.map +1 -0
  24. package/dist/components/avatar/examples/team-list.d.ts +5 -0
  25. package/dist/components/avatar/examples/team-list.d.ts.map +1 -0
  26. package/dist/components/badge/Badge.d.ts +51 -0
  27. package/dist/components/badge/Badge.d.ts.map +1 -0
  28. package/dist/components/badge/examples/admin-tags.d.ts +3 -0
  29. package/dist/components/badge/examples/admin-tags.d.ts.map +1 -0
  30. package/dist/components/badge/examples/canonical.d.ts +3 -0
  31. package/dist/components/badge/examples/canonical.d.ts.map +1 -0
  32. package/dist/components/badge/examples/ecommerce-inventory.d.ts +3 -0
  33. package/dist/components/badge/examples/ecommerce-inventory.d.ts.map +1 -0
  34. package/dist/components/badge/examples/inbox-labels.d.ts +3 -0
  35. package/dist/components/badge/examples/inbox-labels.d.ts.map +1 -0
  36. package/dist/components/badge/examples/status-presence.d.ts +6 -0
  37. package/dist/components/badge/examples/status-presence.d.ts.map +1 -0
  38. package/dist/components/banner/Banner.d.ts +78 -0
  39. package/dist/components/banner/Banner.d.ts.map +1 -0
  40. package/dist/components/banner/examples/billing-alert.d.ts +3 -0
  41. package/dist/components/banner/examples/billing-alert.d.ts.map +1 -0
  42. package/dist/components/banner/examples/cookie-consent-row.d.ts +3 -0
  43. package/dist/components/banner/examples/cookie-consent-row.d.ts.map +1 -0
  44. package/dist/components/banner/examples/feature-promo.d.ts +3 -0
  45. package/dist/components/banner/examples/feature-promo.d.ts.map +1 -0
  46. package/dist/components/banner/examples/maintenance.d.ts +3 -0
  47. package/dist/components/banner/examples/maintenance.d.ts.map +1 -0
  48. package/dist/components/breadcrumb/Breadcrumb.d.ts +47 -0
  49. package/dist/components/breadcrumb/Breadcrumb.d.ts.map +1 -0
  50. package/dist/components/breadcrumb/examples/canonical.d.ts +3 -0
  51. package/dist/components/breadcrumb/examples/canonical.d.ts.map +1 -0
  52. package/dist/components/breadcrumb/examples/deep-documentation.d.ts +3 -0
  53. package/dist/components/breadcrumb/examples/deep-documentation.d.ts.map +1 -0
  54. package/dist/components/breadcrumb/examples/ecommerce-product.d.ts +3 -0
  55. package/dist/components/breadcrumb/examples/ecommerce-product.d.ts.map +1 -0
  56. package/dist/components/breadcrumb/examples/long-path-ellipsis.d.ts +6 -0
  57. package/dist/components/breadcrumb/examples/long-path-ellipsis.d.ts.map +1 -0
  58. package/dist/components/breadcrumb/examples/saas-settings.d.ts +3 -0
  59. package/dist/components/breadcrumb/examples/saas-settings.d.ts.map +1 -0
  60. package/dist/components/button/Button.d.ts +57 -0
  61. package/dist/components/button/Button.d.ts.map +1 -0
  62. package/dist/components/button/examples/canonical-composition.d.ts +5 -0
  63. package/dist/components/button/examples/canonical-composition.d.ts.map +1 -0
  64. package/dist/components/button/examples/destructive-confirm.d.ts +5 -0
  65. package/dist/components/button/examples/destructive-confirm.d.ts.map +1 -0
  66. package/dist/components/button/examples/form-submit-row.d.ts +5 -0
  67. package/dist/components/button/examples/form-submit-row.d.ts.map +1 -0
  68. package/dist/components/button/examples/marketing-cta.d.ts +5 -0
  69. package/dist/components/button/examples/marketing-cta.d.ts.map +1 -0
  70. package/dist/components/button/examples/toolbar.d.ts +5 -0
  71. package/dist/components/button/examples/toolbar.d.ts.map +1 -0
  72. package/dist/components/button-group/ButtonGroup.d.ts +34 -0
  73. package/dist/components/button-group/ButtonGroup.d.ts.map +1 -0
  74. package/dist/components/button-group/examples/editor-toolbar.d.ts +6 -0
  75. package/dist/components/button-group/examples/editor-toolbar.d.ts.map +1 -0
  76. package/dist/components/button-group/examples/form-footer.d.ts +5 -0
  77. package/dist/components/button-group/examples/form-footer.d.ts.map +1 -0
  78. package/dist/components/button-group/examples/view-switcher.d.ts +5 -0
  79. package/dist/components/button-group/examples/view-switcher.d.ts.map +1 -0
  80. package/dist/components/button-group/examples/wizard-actions.d.ts +5 -0
  81. package/dist/components/button-group/examples/wizard-actions.d.ts.map +1 -0
  82. package/dist/components/card/Card.d.ts +234 -0
  83. package/dist/components/card/Card.d.ts.map +1 -0
  84. package/dist/components/card/examples/cta-cover.d.ts +5 -0
  85. package/dist/components/card/examples/cta-cover.d.ts.map +1 -0
  86. package/dist/components/card/examples/list-card.d.ts +3 -0
  87. package/dist/components/card/examples/list-card.d.ts.map +1 -0
  88. package/dist/components/card/examples/media-mini.d.ts +3 -0
  89. package/dist/components/card/examples/media-mini.d.ts.map +1 -0
  90. package/dist/components/card/examples/metric-dashboard.d.ts +3 -0
  91. package/dist/components/card/examples/metric-dashboard.d.ts.map +1 -0
  92. package/dist/components/card/examples/split-layout.d.ts +3 -0
  93. package/dist/components/card/examples/split-layout.d.ts.map +1 -0
  94. package/dist/components/checkbox/Checkbox.d.ts +42 -0
  95. package/dist/components/checkbox/Checkbox.d.ts.map +1 -0
  96. package/dist/components/checkbox/examples/bulk-select-rows.d.ts +5 -0
  97. package/dist/components/checkbox/examples/bulk-select-rows.d.ts.map +1 -0
  98. package/dist/components/checkbox/examples/feature-flags-list.d.ts +5 -0
  99. package/dist/components/checkbox/examples/feature-flags-list.d.ts.map +1 -0
  100. package/dist/components/checkbox/examples/settings-panel.d.ts +5 -0
  101. package/dist/components/checkbox/examples/settings-panel.d.ts.map +1 -0
  102. package/dist/components/checkbox/examples/terms-acceptance.d.ts +5 -0
  103. package/dist/components/checkbox/examples/terms-acceptance.d.ts.map +1 -0
  104. package/dist/components/code-block/CodeBlock.d.ts +17 -0
  105. package/dist/components/code-block/CodeBlock.d.ts.map +1 -0
  106. package/dist/components/code-block/examples/api-response-preview.d.ts +3 -0
  107. package/dist/components/code-block/examples/api-response-preview.d.ts.map +1 -0
  108. package/dist/components/code-block/examples/config-snippet.d.ts +3 -0
  109. package/dist/components/code-block/examples/config-snippet.d.ts.map +1 -0
  110. package/dist/components/code-block/examples/error-stack.d.ts +3 -0
  111. package/dist/components/code-block/examples/error-stack.d.ts.map +1 -0
  112. package/dist/components/code-block/examples/minimal.d.ts +3 -0
  113. package/dist/components/code-block/examples/minimal.d.ts.map +1 -0
  114. package/dist/components/code-block/examples/tutorial-step.d.ts +3 -0
  115. package/dist/components/code-block/examples/tutorial-step.d.ts.map +1 -0
  116. package/dist/components/color-picker/ColorPicker.d.ts +76 -0
  117. package/dist/components/color-picker/ColorPicker.d.ts.map +1 -0
  118. package/dist/components/color-picker/ColorPickerRac.d.ts +76 -0
  119. package/dist/components/color-picker/ColorPickerRac.d.ts.map +1 -0
  120. package/dist/components/color-picker/examples/brand-kit.d.ts +3 -0
  121. package/dist/components/color-picker/examples/brand-kit.d.ts.map +1 -0
  122. package/dist/components/color-picker/examples/controlled-form-field.d.ts +3 -0
  123. package/dist/components/color-picker/examples/controlled-form-field.d.ts.map +1 -0
  124. package/dist/components/color-picker/examples/minimal-popover.d.ts +3 -0
  125. package/dist/components/color-picker/examples/minimal-popover.d.ts.map +1 -0
  126. package/dist/components/color-picker/examples/product-variant-swatch.d.ts +3 -0
  127. package/dist/components/color-picker/examples/product-variant-swatch.d.ts.map +1 -0
  128. package/dist/components/color-picker/examples/theme-accent.d.ts +3 -0
  129. package/dist/components/color-picker/examples/theme-accent.d.ts.map +1 -0
  130. package/dist/components/command-menu/CommandMenu.d.ts +74 -0
  131. package/dist/components/command-menu/CommandMenu.d.ts.map +1 -0
  132. package/dist/components/command-menu/examples/app-palette.d.ts +5 -0
  133. package/dist/components/command-menu/examples/app-palette.d.ts.map +1 -0
  134. package/dist/components/command-menu/examples/disabled-items.d.ts +6 -0
  135. package/dist/components/command-menu/examples/disabled-items.d.ts.map +1 -0
  136. package/dist/components/command-menu/examples/file-search.d.ts +5 -0
  137. package/dist/components/command-menu/examples/file-search.d.ts.map +1 -0
  138. package/dist/components/command-menu/examples/quick-actions.d.ts +5 -0
  139. package/dist/components/command-menu/examples/quick-actions.d.ts.map +1 -0
  140. package/dist/components/data-table/DataTable.d.ts +78 -0
  141. package/dist/components/data-table/DataTable.d.ts.map +1 -0
  142. package/dist/components/data-table/examples/canonical-orders.d.ts +6 -0
  143. package/dist/components/data-table/examples/canonical-orders.d.ts.map +1 -0
  144. package/dist/components/data-table/examples/controlled-sort-and-page.d.ts +5 -0
  145. package/dist/components/data-table/examples/controlled-sort-and-page.d.ts.map +1 -0
  146. package/dist/components/data-table/examples/infinite-scroll-load-more.d.ts +6 -0
  147. package/dist/components/data-table/examples/infinite-scroll-load-more.d.ts.map +1 -0
  148. package/dist/components/data-table/examples/row-selection.d.ts +6 -0
  149. package/dist/components/data-table/examples/row-selection.d.ts.map +1 -0
  150. package/dist/components/data-table/examples/sticky-header-first-column.d.ts +6 -0
  151. package/dist/components/data-table/examples/sticky-header-first-column.d.ts.map +1 -0
  152. package/dist/components/datepicker/Datepicker.d.ts +104 -0
  153. package/dist/components/datepicker/Datepicker.d.ts.map +1 -0
  154. package/dist/components/datepicker/examples/birthdate.d.ts +5 -0
  155. package/dist/components/datepicker/examples/birthdate.d.ts.map +1 -0
  156. package/dist/components/datepicker/examples/booking.d.ts +5 -0
  157. package/dist/components/datepicker/examples/booking.d.ts.map +1 -0
  158. package/dist/components/datepicker/examples/full-width-form.d.ts +5 -0
  159. package/dist/components/datepicker/examples/full-width-form.d.ts.map +1 -0
  160. package/dist/components/datepicker/examples/range-report.d.ts +5 -0
  161. package/dist/components/datepicker/examples/range-report.d.ts.map +1 -0
  162. package/dist/components/digit-input/DigitInput.d.ts +21 -0
  163. package/dist/components/digit-input/DigitInput.d.ts.map +1 -0
  164. package/dist/components/digit-input/examples/error-state.d.ts +3 -0
  165. package/dist/components/digit-input/examples/error-state.d.ts.map +1 -0
  166. package/dist/components/digit-input/examples/otp-login.d.ts +3 -0
  167. package/dist/components/digit-input/examples/otp-login.d.ts.map +1 -0
  168. package/dist/components/digit-input/examples/pin.d.ts +3 -0
  169. package/dist/components/digit-input/examples/pin.d.ts.map +1 -0
  170. package/dist/components/digit-input/examples/resend-and-clear.d.ts +3 -0
  171. package/dist/components/digit-input/examples/resend-and-clear.d.ts.map +1 -0
  172. package/dist/components/digit-input/examples/verification-step.d.ts +3 -0
  173. package/dist/components/digit-input/examples/verification-step.d.ts.map +1 -0
  174. package/dist/components/divider/Divider.d.ts +26 -0
  175. package/dist/components/divider/Divider.d.ts.map +1 -0
  176. package/dist/components/divider/examples/card-splits.d.ts +3 -0
  177. package/dist/components/divider/examples/card-splits.d.ts.map +1 -0
  178. package/dist/components/divider/examples/inset-stack.d.ts +6 -0
  179. package/dist/components/divider/examples/inset-stack.d.ts.map +1 -0
  180. package/dist/components/divider/examples/line-spacing-column.d.ts +6 -0
  181. package/dist/components/divider/examples/line-spacing-column.d.ts.map +1 -0
  182. package/dist/components/divider/examples/list-separators.d.ts +3 -0
  183. package/dist/components/divider/examples/list-separators.d.ts.map +1 -0
  184. package/dist/components/divider/examples/section-breaks.d.ts +3 -0
  185. package/dist/components/divider/examples/section-breaks.d.ts.map +1 -0
  186. package/dist/components/drawer/Drawer.d.ts +71 -0
  187. package/dist/components/drawer/Drawer.d.ts.map +1 -0
  188. package/dist/components/drawer/examples/cart-preview.d.ts +5 -0
  189. package/dist/components/drawer/examples/cart-preview.d.ts.map +1 -0
  190. package/dist/components/drawer/examples/explicit-panel.d.ts +5 -0
  191. package/dist/components/drawer/examples/explicit-panel.d.ts.map +1 -0
  192. package/dist/components/drawer/examples/filters-panel.d.ts +5 -0
  193. package/dist/components/drawer/examples/filters-panel.d.ts.map +1 -0
  194. package/dist/components/drawer/examples/mobile-nav-sheet.d.ts +5 -0
  195. package/dist/components/drawer/examples/mobile-nav-sheet.d.ts.map +1 -0
  196. package/dist/components/drawer/examples/settings-side.d.ts +5 -0
  197. package/dist/components/drawer/examples/settings-side.d.ts.map +1 -0
  198. package/dist/components/dropdown/Dropdown.d.ts +147 -0
  199. package/dist/components/dropdown/Dropdown.d.ts.map +1 -0
  200. package/dist/components/dropdown/dropdownGeometry.d.ts +10 -0
  201. package/dist/components/dropdown/dropdownGeometry.d.ts.map +1 -0
  202. package/dist/components/dropdown/examples/account-menu.d.ts +3 -0
  203. package/dist/components/dropdown/examples/account-menu.d.ts.map +1 -0
  204. package/dist/components/dropdown/examples/actions-menu.d.ts +3 -0
  205. package/dist/components/dropdown/examples/actions-menu.d.ts.map +1 -0
  206. package/dist/components/dropdown/examples/placement-demo.d.ts +3 -0
  207. package/dist/components/dropdown/examples/placement-demo.d.ts.map +1 -0
  208. package/dist/components/dropdown/examples/select-like-list.d.ts +7 -0
  209. package/dist/components/dropdown/examples/select-like-list.d.ts.map +1 -0
  210. package/dist/components/dropdown/menuKeyboard.d.ts +4 -0
  211. package/dist/components/dropdown/menuKeyboard.d.ts.map +1 -0
  212. package/dist/components/dropdown/useDropdownPosition.d.ts +18 -0
  213. package/dist/components/dropdown/useDropdownPosition.d.ts.map +1 -0
  214. package/dist/components/example-frame/ExampleFrame.d.ts +53 -0
  215. package/dist/components/example-frame/ExampleFrame.d.ts.map +1 -0
  216. package/dist/components/file-upload/FileUpload.d.ts +176 -0
  217. package/dist/components/file-upload/FileUpload.d.ts.map +1 -0
  218. package/dist/components/file-upload/examples/avatar-upload.d.ts +6 -0
  219. package/dist/components/file-upload/examples/avatar-upload.d.ts.map +1 -0
  220. package/dist/components/file-upload/examples/controlled-list.d.ts +5 -0
  221. package/dist/components/file-upload/examples/controlled-list.d.ts.map +1 -0
  222. package/dist/components/file-upload/examples/document-attach.d.ts +5 -0
  223. package/dist/components/file-upload/examples/document-attach.d.ts.map +1 -0
  224. package/dist/components/file-upload/examples/drag-area.d.ts +5 -0
  225. package/dist/components/file-upload/examples/drag-area.d.ts.map +1 -0
  226. package/dist/components/hint/Hint.d.ts +27 -0
  227. package/dist/components/hint/Hint.d.ts.map +1 -0
  228. package/dist/components/hint/examples/error-hint.d.ts +3 -0
  229. package/dist/components/hint/examples/error-hint.d.ts.map +1 -0
  230. package/dist/components/hint/examples/field-help.d.ts +3 -0
  231. package/dist/components/hint/examples/field-help.d.ts.map +1 -0
  232. package/dist/components/hint/examples/inline-tip-form.d.ts +3 -0
  233. package/dist/components/hint/examples/inline-tip-form.d.ts.map +1 -0
  234. package/dist/components/hint/examples/success-confirmation.d.ts +6 -0
  235. package/dist/components/hint/examples/success-confirmation.d.ts.map +1 -0
  236. package/dist/components/hint/examples/with-icon.d.ts +3 -0
  237. package/dist/components/hint/examples/with-icon.d.ts.map +1 -0
  238. package/dist/components/index.css +6101 -5759
  239. package/dist/components/index.css.map +4 -4
  240. package/dist/components/index.d.ts +95 -2679
  241. package/dist/components/index.d.ts.map +1 -0
  242. package/dist/components/index.js +8510 -7659
  243. package/dist/components/index.js.map +4 -4
  244. package/dist/components/input/Input.d.ts +73 -0
  245. package/dist/components/input/Input.d.ts.map +1 -0
  246. package/dist/components/input/examples/checkout-full-width.d.ts +5 -0
  247. package/dist/components/input/examples/checkout-full-width.d.ts.map +1 -0
  248. package/dist/components/input/examples/login-email.d.ts +5 -0
  249. package/dist/components/input/examples/login-email.d.ts.map +1 -0
  250. package/dist/components/input/examples/password-with-hint.d.ts +5 -0
  251. package/dist/components/input/examples/password-with-hint.d.ts.map +1 -0
  252. package/dist/components/input/examples/search.d.ts +5 -0
  253. package/dist/components/input/examples/search.d.ts.map +1 -0
  254. package/dist/components/kbd/Kbd.d.ts +15 -0
  255. package/dist/components/kbd/Kbd.d.ts.map +1 -0
  256. package/dist/components/kbd/examples/combination-keys.d.ts +3 -0
  257. package/dist/components/kbd/examples/combination-keys.d.ts.map +1 -0
  258. package/dist/components/kbd/examples/docs-legend.d.ts +3 -0
  259. package/dist/components/kbd/examples/docs-legend.d.ts.map +1 -0
  260. package/dist/components/kbd/examples/inline-doc-hint.d.ts +3 -0
  261. package/dist/components/kbd/examples/inline-doc-hint.d.ts.map +1 -0
  262. package/dist/components/kbd/examples/shortcut-row.d.ts +3 -0
  263. package/dist/components/kbd/examples/shortcut-row.d.ts.map +1 -0
  264. package/dist/components/kbd/examples/toolbar-hints.d.ts +3 -0
  265. package/dist/components/kbd/examples/toolbar-hints.d.ts.map +1 -0
  266. package/dist/components/label/Label.d.ts +29 -0
  267. package/dist/components/label/Label.d.ts.map +1 -0
  268. package/dist/components/label/examples/accessibility-pattern.d.ts +6 -0
  269. package/dist/components/label/examples/accessibility-pattern.d.ts.map +1 -0
  270. package/dist/components/label/examples/grouped-labels.d.ts +6 -0
  271. package/dist/components/label/examples/grouped-labels.d.ts.map +1 -0
  272. package/dist/components/label/examples/optional-field.d.ts +3 -0
  273. package/dist/components/label/examples/optional-field.d.ts.map +1 -0
  274. package/dist/components/label/examples/required-field.d.ts +3 -0
  275. package/dist/components/label/examples/required-field.d.ts.map +1 -0
  276. package/dist/components/label/examples/with-icon.d.ts +3 -0
  277. package/dist/components/label/examples/with-icon.d.ts.map +1 -0
  278. package/dist/components/link-button/LinkButton.d.ts +18 -0
  279. package/dist/components/link-button/LinkButton.d.ts.map +1 -0
  280. package/dist/components/link-button/examples/disabled.d.ts +6 -0
  281. package/dist/components/link-button/examples/disabled.d.ts.map +1 -0
  282. package/dist/components/link-button/examples/external.d.ts +3 -0
  283. package/dist/components/link-button/examples/external.d.ts.map +1 -0
  284. package/dist/components/link-button/examples/footer-legal.d.ts +3 -0
  285. package/dist/components/link-button/examples/footer-legal.d.ts.map +1 -0
  286. package/dist/components/link-button/examples/inline-text-link.d.ts +3 -0
  287. package/dist/components/link-button/examples/inline-text-link.d.ts.map +1 -0
  288. package/dist/components/link-button/examples/navigation-cluster.d.ts +3 -0
  289. package/dist/components/link-button/examples/navigation-cluster.d.ts.map +1 -0
  290. package/dist/components/modal/Modal.d.ts +58 -0
  291. package/dist/components/modal/Modal.d.ts.map +1 -0
  292. package/dist/components/modal/examples/canonical-maximal.d.ts +6 -0
  293. package/dist/components/modal/examples/canonical-maximal.d.ts.map +1 -0
  294. package/dist/components/modal/examples/scenario-confirm-delete.d.ts +3 -0
  295. package/dist/components/modal/examples/scenario-confirm-delete.d.ts.map +1 -0
  296. package/dist/components/modal/examples/scenario-edit-entity.d.ts +3 -0
  297. package/dist/components/modal/examples/scenario-edit-entity.d.ts.map +1 -0
  298. package/dist/components/modal/examples/scenario-legal-consent.d.ts +3 -0
  299. package/dist/components/modal/examples/scenario-legal-consent.d.ts.map +1 -0
  300. package/dist/components/modal/examples/scenario-multi-field-form.d.ts +3 -0
  301. package/dist/components/modal/examples/scenario-multi-field-form.d.ts.map +1 -0
  302. package/dist/components/notification/Notification.d.ts +42 -0
  303. package/dist/components/notification/Notification.d.ts.map +1 -0
  304. package/dist/components/notification/NotificationStore.d.ts +18 -0
  305. package/dist/components/notification/NotificationStore.d.ts.map +1 -0
  306. package/dist/components/notification/examples/action-toast.d.ts +2 -0
  307. package/dist/components/notification/examples/action-toast.d.ts.map +1 -0
  308. package/dist/components/notification/examples/error-success.d.ts +2 -0
  309. package/dist/components/notification/examples/error-success.d.ts.map +1 -0
  310. package/dist/components/notification/examples/notification-store.d.ts +2 -0
  311. package/dist/components/notification/examples/notification-store.d.ts.map +1 -0
  312. package/dist/components/notification/examples/positions.d.ts +2 -0
  313. package/dist/components/notification/examples/positions.d.ts.map +1 -0
  314. package/dist/components/notification/examples/toast-queue.d.ts +2 -0
  315. package/dist/components/notification/examples/toast-queue.d.ts.map +1 -0
  316. package/dist/components/page-content/PageContent.d.ts +51 -0
  317. package/dist/components/page-content/PageContent.d.ts.map +1 -0
  318. package/dist/components/pagination/Pagination.d.ts +19 -0
  319. package/dist/components/pagination/Pagination.d.ts.map +1 -0
  320. package/dist/components/pagination/examples/canonical-composition.d.ts +5 -0
  321. package/dist/components/pagination/examples/canonical-composition.d.ts.map +1 -0
  322. package/dist/components/pagination/examples/compact.d.ts +3 -0
  323. package/dist/components/pagination/examples/compact.d.ts.map +1 -0
  324. package/dist/components/pagination/examples/controlled-page.d.ts +3 -0
  325. package/dist/components/pagination/examples/controlled-page.d.ts.map +1 -0
  326. package/dist/components/pagination/examples/full-width-list.d.ts +3 -0
  327. package/dist/components/pagination/examples/full-width-list.d.ts.map +1 -0
  328. package/dist/components/pagination/examples/table-footer.d.ts +3 -0
  329. package/dist/components/pagination/examples/table-footer.d.ts.map +1 -0
  330. package/dist/components/popover/Popover.d.ts +48 -0
  331. package/dist/components/popover/Popover.d.ts.map +1 -0
  332. package/dist/components/popover/examples/canonical-panel.d.ts +5 -0
  333. package/dist/components/popover/examples/canonical-panel.d.ts.map +1 -0
  334. package/dist/components/popover/examples/date-trigger.d.ts +5 -0
  335. package/dist/components/popover/examples/date-trigger.d.ts.map +1 -0
  336. package/dist/components/popover/examples/form-in-popover.d.ts +5 -0
  337. package/dist/components/popover/examples/form-in-popover.d.ts.map +1 -0
  338. package/dist/components/popover/examples/placement.d.ts +5 -0
  339. package/dist/components/popover/examples/placement.d.ts.map +1 -0
  340. package/dist/components/popover/examples/rich-content.d.ts +5 -0
  341. package/dist/components/popover/examples/rich-content.d.ts.map +1 -0
  342. package/dist/components/popover/popoverGeometry.d.ts +6 -0
  343. package/dist/components/popover/popoverGeometry.d.ts.map +1 -0
  344. package/dist/components/popover/usePopoverPosition.d.ts +18 -0
  345. package/dist/components/popover/usePopoverPosition.d.ts.map +1 -0
  346. package/dist/components/progress-bar/ProgressBar.d.ts +14 -0
  347. package/dist/components/progress-bar/ProgressBar.d.ts.map +1 -0
  348. package/dist/components/progress-bar/examples/indeterminate-busy-state.d.ts +6 -0
  349. package/dist/components/progress-bar/examples/indeterminate-busy-state.d.ts.map +1 -0
  350. package/dist/components/progress-bar/examples/labeled.d.ts +3 -0
  351. package/dist/components/progress-bar/examples/labeled.d.ts.map +1 -0
  352. package/dist/components/progress-bar/examples/step-progress.d.ts +3 -0
  353. package/dist/components/progress-bar/examples/step-progress.d.ts.map +1 -0
  354. package/dist/components/progress-bar/examples/upload-progress.d.ts +3 -0
  355. package/dist/components/progress-bar/examples/upload-progress.d.ts.map +1 -0
  356. package/dist/components/progress-bar/examples/wizard-composition.d.ts +3 -0
  357. package/dist/components/progress-bar/examples/wizard-composition.d.ts.map +1 -0
  358. package/dist/components/progress-circle/ProgressCircle.d.ts +33 -0
  359. package/dist/components/progress-circle/ProgressCircle.d.ts.map +1 -0
  360. package/dist/components/progress-circle/examples/a11y-label.d.ts +6 -0
  361. package/dist/components/progress-circle/examples/a11y-label.d.ts.map +1 -0
  362. package/dist/components/progress-circle/examples/composition.d.ts +3 -0
  363. package/dist/components/progress-circle/examples/composition.d.ts.map +1 -0
  364. package/dist/components/progress-circle/examples/controlled.d.ts +3 -0
  365. package/dist/components/progress-circle/examples/controlled.d.ts.map +1 -0
  366. package/dist/components/progress-circle/examples/dashboard-ring.d.ts +3 -0
  367. package/dist/components/progress-circle/examples/dashboard-ring.d.ts.map +1 -0
  368. package/dist/components/progress-circle/examples/max-scale.d.ts +3 -0
  369. package/dist/components/progress-circle/examples/max-scale.d.ts.map +1 -0
  370. package/dist/components/radio/Radio.d.ts +40 -0
  371. package/dist/components/radio/Radio.d.ts.map +1 -0
  372. package/dist/components/radio/examples/notification-channel.d.ts +3 -0
  373. package/dist/components/radio/examples/notification-channel.d.ts.map +1 -0
  374. package/dist/components/radio/examples/plan-picker.d.ts +3 -0
  375. package/dist/components/radio/examples/plan-picker.d.ts.map +1 -0
  376. package/dist/components/radio/examples/settings-group.d.ts +3 -0
  377. package/dist/components/radio/examples/settings-group.d.ts.map +1 -0
  378. package/dist/components/radio/examples/shipping-method.d.ts +3 -0
  379. package/dist/components/radio/examples/shipping-method.d.ts.map +1 -0
  380. package/dist/components/scroll-container/ScrollContainer.d.ts +42 -0
  381. package/dist/components/scroll-container/ScrollContainer.d.ts.map +1 -0
  382. package/dist/components/segmented-control/SegmentedControl.d.ts +40 -0
  383. package/dist/components/segmented-control/SegmentedControl.d.ts.map +1 -0
  384. package/dist/components/segmented-control/examples/canonical-composition.d.ts +5 -0
  385. package/dist/components/segmented-control/examples/canonical-composition.d.ts.map +1 -0
  386. package/dist/components/segmented-control/examples/catalog-filters.d.ts +5 -0
  387. package/dist/components/segmented-control/examples/catalog-filters.d.ts.map +1 -0
  388. package/dist/components/segmented-control/examples/pricing-toggle.d.ts +5 -0
  389. package/dist/components/segmented-control/examples/pricing-toggle.d.ts.map +1 -0
  390. package/dist/components/segmented-control/examples/view-mode.d.ts +5 -0
  391. package/dist/components/segmented-control/examples/view-mode.d.ts.map +1 -0
  392. package/dist/components/segmented-progress-bar/SegmentedProgressBar.d.ts +22 -0
  393. package/dist/components/segmented-progress-bar/SegmentedProgressBar.d.ts.map +1 -0
  394. package/dist/components/segmented-progress-bar/examples/distribution-breakdown.d.ts +3 -0
  395. package/dist/components/segmented-progress-bar/examples/distribution-breakdown.d.ts.map +1 -0
  396. package/dist/components/segmented-progress-bar/examples/multi-phase-rollout.d.ts +3 -0
  397. package/dist/components/segmented-progress-bar/examples/multi-phase-rollout.d.ts.map +1 -0
  398. package/dist/components/segmented-progress-bar/examples/segment-gaps.d.ts +3 -0
  399. package/dist/components/segmented-progress-bar/examples/segment-gaps.d.ts.map +1 -0
  400. package/dist/components/segmented-progress-bar/examples/size-ladder.d.ts +3 -0
  401. package/dist/components/segmented-progress-bar/examples/size-ladder.d.ts.map +1 -0
  402. package/dist/components/segmented-progress-bar/examples/storage-mix.d.ts +3 -0
  403. package/dist/components/segmented-progress-bar/examples/storage-mix.d.ts.map +1 -0
  404. package/dist/components/select/Select.d.ts +84 -0
  405. package/dist/components/select/Select.d.ts.map +1 -0
  406. package/dist/components/select/examples/01-country.d.ts +6 -0
  407. package/dist/components/select/examples/01-country.d.ts.map +1 -0
  408. package/dist/components/select/examples/02-controlled.d.ts +5 -0
  409. package/dist/components/select/examples/02-controlled.d.ts.map +1 -0
  410. package/dist/components/select/examples/03-groups.d.ts +5 -0
  411. package/dist/components/select/examples/03-groups.d.ts.map +1 -0
  412. package/dist/components/select/examples/04-full-width-form.d.ts +6 -0
  413. package/dist/components/select/examples/04-full-width-form.d.ts.map +1 -0
  414. package/dist/components/select/selectListbox.d.ts +13 -0
  415. package/dist/components/select/selectListbox.d.ts.map +1 -0
  416. package/dist/components/slider/Slider.d.ts +23 -0
  417. package/dist/components/slider/Slider.d.ts.map +1 -0
  418. package/dist/components/slider/examples/01-volume.d.ts +5 -0
  419. package/dist/components/slider/examples/01-volume.d.ts.map +1 -0
  420. package/dist/components/slider/examples/02-price-range.d.ts +5 -0
  421. package/dist/components/slider/examples/02-price-range.d.ts.map +1 -0
  422. package/dist/components/slider/examples/03-controlled.d.ts +5 -0
  423. package/dist/components/slider/examples/03-controlled.d.ts.map +1 -0
  424. package/dist/components/slider/examples/04-disabled.d.ts +5 -0
  425. package/dist/components/slider/examples/04-disabled.d.ts.map +1 -0
  426. package/dist/components/stepper/HorizontalStepper.d.ts +41 -0
  427. package/dist/components/stepper/HorizontalStepper.d.ts.map +1 -0
  428. package/dist/components/stepper/Stepper.d.ts +77 -0
  429. package/dist/components/stepper/Stepper.d.ts.map +1 -0
  430. package/dist/components/stepper/VerticalStepper.d.ts +41 -0
  431. package/dist/components/stepper/VerticalStepper.d.ts.map +1 -0
  432. package/dist/components/stepper/examples/01-checkout-horizontal.d.ts +5 -0
  433. package/dist/components/stepper/examples/01-checkout-horizontal.d.ts.map +1 -0
  434. package/dist/components/stepper/examples/02-onboarding-vertical.d.ts +5 -0
  435. package/dist/components/stepper/examples/02-onboarding-vertical.d.ts.map +1 -0
  436. package/dist/components/stepper/examples/03-vertical-primitive-rail.d.ts +5 -0
  437. package/dist/components/stepper/examples/03-vertical-primitive-rail.d.ts.map +1 -0
  438. package/dist/components/stepper/examples/04-checkout-step-error.d.ts +6 -0
  439. package/dist/components/stepper/examples/04-checkout-step-error.d.ts.map +1 -0
  440. package/dist/components/stepper/examples/05-horizontal-primitive.d.ts +5 -0
  441. package/dist/components/stepper/examples/05-horizontal-primitive.d.ts.map +1 -0
  442. package/dist/components/stepper/stepperAlignContext.d.ts +11 -0
  443. package/dist/components/stepper/stepperAlignContext.d.ts.map +1 -0
  444. package/dist/components/switch/Switch.d.ts +48 -0
  445. package/dist/components/switch/Switch.d.ts.map +1 -0
  446. package/dist/components/switch/examples/canonical-maximal.d.ts +5 -0
  447. package/dist/components/switch/examples/canonical-maximal.d.ts.map +1 -0
  448. package/dist/components/switch/examples/scenario-billing-annual.d.ts +5 -0
  449. package/dist/components/switch/examples/scenario-billing-annual.d.ts.map +1 -0
  450. package/dist/components/switch/examples/scenario-feature-flag.d.ts +5 -0
  451. package/dist/components/switch/examples/scenario-feature-flag.d.ts.map +1 -0
  452. package/dist/components/switch/examples/scenario-form-consent.d.ts +5 -0
  453. package/dist/components/switch/examples/scenario-form-consent.d.ts.map +1 -0
  454. package/dist/components/switch/examples/scenario-settings-toggle.d.ts +5 -0
  455. package/dist/components/switch/examples/scenario-settings-toggle.d.ts.map +1 -0
  456. package/dist/components/tabs/Tabs.d.ts +69 -0
  457. package/dist/components/tabs/Tabs.d.ts.map +1 -0
  458. package/dist/components/tabs/examples/01-settings-vertical-rail.d.ts +6 -0
  459. package/dist/components/tabs/examples/01-settings-vertical-rail.d.ts.map +1 -0
  460. package/dist/components/tabs/examples/02-dashboard-subviews.d.ts +6 -0
  461. package/dist/components/tabs/examples/02-dashboard-subviews.d.ts.map +1 -0
  462. package/dist/components/tabs/examples/03-tab-triggers-with-icons.d.ts +6 -0
  463. package/dist/components/tabs/examples/03-tab-triggers-with-icons.d.ts.map +1 -0
  464. package/dist/components/tabs/examples/04-long-labels-narrow.d.ts +6 -0
  465. package/dist/components/tabs/examples/04-long-labels-narrow.d.ts.map +1 -0
  466. package/dist/components/tabs/examples/05-controlled-active-tab.d.ts +6 -0
  467. package/dist/components/tabs/examples/05-controlled-active-tab.d.ts.map +1 -0
  468. package/dist/components/tag/Tag.d.ts +29 -0
  469. package/dist/components/tag/Tag.d.ts.map +1 -0
  470. package/dist/components/tag/examples/01-filter-chips.d.ts +5 -0
  471. package/dist/components/tag/examples/01-filter-chips.d.ts.map +1 -0
  472. package/dist/components/tag/examples/02-removable-selected-values.d.ts +6 -0
  473. package/dist/components/tag/examples/02-removable-selected-values.d.ts.map +1 -0
  474. package/dist/components/tag/examples/03-status-metadata.d.ts +5 -0
  475. package/dist/components/tag/examples/03-status-metadata.d.ts.map +1 -0
  476. package/dist/components/tag/examples/04-tag-sizes.d.ts +3 -0
  477. package/dist/components/tag/examples/04-tag-sizes.d.ts.map +1 -0
  478. package/dist/components/textarea/Textarea.d.ts +43 -0
  479. package/dist/components/textarea/Textarea.d.ts.map +1 -0
  480. package/dist/components/textarea/examples/01-support-ticket.d.ts +5 -0
  481. package/dist/components/textarea/examples/01-support-ticket.d.ts.map +1 -0
  482. package/dist/components/textarea/examples/02-comment.d.ts +5 -0
  483. package/dist/components/textarea/examples/02-comment.d.ts.map +1 -0
  484. package/dist/components/textarea/examples/03-controlled.d.ts +5 -0
  485. package/dist/components/textarea/examples/03-controlled.d.ts.map +1 -0
  486. package/dist/components/textarea/examples/04-full-width.d.ts +5 -0
  487. package/dist/components/textarea/examples/04-full-width.d.ts.map +1 -0
  488. package/dist/components/tooltip/Tooltip.d.ts +47 -0
  489. package/dist/components/tooltip/Tooltip.d.ts.map +1 -0
  490. package/dist/components/tooltip/examples/canonical-icon-hint.d.ts +5 -0
  491. package/dist/components/tooltip/examples/canonical-icon-hint.d.ts.map +1 -0
  492. package/dist/components/tooltip/examples/scenario-controlled-programmatic.d.ts +5 -0
  493. package/dist/components/tooltip/examples/scenario-controlled-programmatic.d.ts.map +1 -0
  494. package/dist/components/tooltip/examples/scenario-delay-provider.d.ts +5 -0
  495. package/dist/components/tooltip/examples/scenario-delay-provider.d.ts.map +1 -0
  496. package/dist/components/tooltip/examples/scenario-long-content.d.ts +5 -0
  497. package/dist/components/tooltip/examples/scenario-long-content.d.ts.map +1 -0
  498. package/dist/components/tooltip/examples/scenario-side-bottom.d.ts +5 -0
  499. package/dist/components/tooltip/examples/scenario-side-bottom.d.ts.map +1 -0
  500. package/dist/components/typography/Typography.d.ts +30 -0
  501. package/dist/components/typography/Typography.d.ts.map +1 -0
  502. package/dist/components/typography/examples/01-article.d.ts +5 -0
  503. package/dist/components/typography/examples/01-article.d.ts.map +1 -0
  504. package/dist/components/typography/examples/02-form-labels-contrast.d.ts +6 -0
  505. package/dist/components/typography/examples/02-form-labels-contrast.d.ts.map +1 -0
  506. package/dist/components/typography/examples/03-marketing-hero.d.ts +3 -0
  507. package/dist/components/typography/examples/03-marketing-hero.d.ts.map +1 -0
  508. package/dist/components/typography/examples/04-reading-scale.d.ts +3 -0
  509. package/dist/components/typography/examples/04-reading-scale.d.ts.map +1 -0
  510. package/dist/components/typography/examples/05-inline-emphasis.d.ts +3 -0
  511. package/dist/components/typography/examples/05-inline-emphasis.d.ts.map +1 -0
  512. package/dist/hooks/useControllableState.d.ts +8 -0
  513. package/dist/hooks/useControllableState.d.ts.map +1 -0
  514. package/dist/hooks/useEscapeKey.d.ts +7 -0
  515. package/dist/hooks/useEscapeKey.d.ts.map +1 -0
  516. package/dist/hooks/useFieldIds.d.ts +17 -0
  517. package/dist/hooks/useFieldIds.d.ts.map +1 -0
  518. package/dist/hooks/useFocusTrap.d.ts +16 -0
  519. package/dist/hooks/useFocusTrap.d.ts.map +1 -0
  520. package/dist/hooks/useMergedRefs.d.ts +3 -0
  521. package/dist/hooks/useMergedRefs.d.ts.map +1 -0
  522. package/dist/hooks/useOutsideClick.d.ts +16 -0
  523. package/dist/hooks/useOutsideClick.d.ts.map +1 -0
  524. package/dist/hooks/useOverlayModal.d.ts +7 -0
  525. package/dist/hooks/useOverlayModal.d.ts.map +1 -0
  526. package/dist/hooks/usePosition.d.ts +41 -0
  527. package/dist/hooks/usePosition.d.ts.map +1 -0
  528. package/dist/hooks/useResponsiveMonths.d.ts +18 -0
  529. package/dist/hooks/useResponsiveMonths.d.ts.map +1 -0
  530. package/dist/hooks/useScrollLock.d.ts +8 -0
  531. package/dist/hooks/useScrollLock.d.ts.map +1 -0
  532. package/dist/icons/Icon.d.ts +13 -0
  533. package/dist/icons/Icon.d.ts.map +1 -0
  534. package/dist/icons/index.d.ts +40 -0
  535. package/dist/icons/index.d.ts.map +1 -0
  536. package/dist/index.css +6101 -5759
  537. package/dist/index.css.map +4 -4
  538. package/dist/index.d.ts +4 -8
  539. package/dist/index.d.ts.map +1 -0
  540. package/dist/index.js +8509 -7660
  541. package/dist/index.js.map +4 -4
  542. package/dist/internal/ControlSizeContext.d.ts +17 -0
  543. package/dist/internal/ControlSizeContext.d.ts.map +1 -0
  544. package/dist/internal/DividerContentContext.d.ts +4 -0
  545. package/dist/internal/DividerContentContext.d.ts.map +1 -0
  546. package/dist/internal/OverlayPortalLayerContext.d.ts +13 -0
  547. package/dist/internal/OverlayPortalLayerContext.d.ts.map +1 -0
  548. package/dist/internal/Portal.d.ts +8 -0
  549. package/dist/internal/Portal.d.ts.map +1 -0
  550. package/dist/internal/context.d.ts +11 -0
  551. package/dist/internal/context.d.ts.map +1 -0
  552. package/dist/internal/cx.d.ts +2 -0
  553. package/dist/internal/cx.d.ts.map +1 -0
  554. package/dist/internal/data-attributes.d.ts +6 -0
  555. package/dist/internal/data-attributes.d.ts.map +1 -0
  556. package/dist/internal/highlightTsxHtml.d.ts +3 -0
  557. package/dist/internal/highlightTsxHtml.d.ts.map +1 -0
  558. package/dist/internal/layoutPxFromPrimitives.d.ts +13 -0
  559. package/dist/internal/layoutPxFromPrimitives.d.ts.map +1 -0
  560. package/dist/internal/mergeRefs.d.ts +4 -0
  561. package/dist/internal/mergeRefs.d.ts.map +1 -0
  562. package/dist/internal/runtimeUnits.d.ts +3 -0
  563. package/dist/internal/runtimeUnits.d.ts.map +1 -0
  564. package/dist/internal/scrollAncestors.d.ts +3 -0
  565. package/dist/internal/scrollAncestors.d.ts.map +1 -0
  566. package/dist/internal/slot.d.ts +19 -0
  567. package/dist/internal/slot.d.ts.map +1 -0
  568. package/dist/internal/states.d.ts +87 -0
  569. package/dist/internal/states.d.ts.map +1 -0
  570. package/dist/layout/app-shell/AppShell.d.ts +54 -0
  571. package/dist/layout/app-shell/AppShell.d.ts.map +1 -0
  572. package/dist/layout/index.d.ts +7 -0
  573. package/dist/layout/index.d.ts.map +1 -0
  574. package/dist/layout/sidebar/Sidebar.d.ts +241 -0
  575. package/dist/layout/sidebar/Sidebar.d.ts.map +1 -0
  576. package/dist/layout/sidebar/SidebarRoot.d.ts +51 -0
  577. package/dist/layout/sidebar/SidebarRoot.d.ts.map +1 -0
  578. package/dist/layout/sidebar/examples/01-app-shell-nav.d.ts +5 -0
  579. package/dist/layout/sidebar/examples/01-app-shell-nav.d.ts.map +1 -0
  580. package/dist/layout/sidebar/examples/02-collapsible-desktop.d.ts +6 -0
  581. package/dist/layout/sidebar/examples/02-collapsible-desktop.d.ts.map +1 -0
  582. package/dist/layout/sidebar/examples/03-controlled-state.d.ts +5 -0
  583. package/dist/layout/sidebar/examples/03-controlled-state.d.ts.map +1 -0
  584. package/dist/layout/sidebar/examples/04-router-navigation.d.ts +6 -0
  585. package/dist/layout/sidebar/examples/04-router-navigation.d.ts.map +1 -0
  586. package/dist/layout/sidebar/examples/05-responsive-behavior.d.ts +7 -0
  587. package/dist/layout/sidebar/examples/05-responsive-behavior.d.ts.map +1 -0
  588. package/dist/layout/sidebar/sidebar-context.d.ts +19 -0
  589. package/dist/layout/sidebar/sidebar-context.d.ts.map +1 -0
  590. package/dist/layout/sidebar/sidebarLayout.d.ts +12 -0
  591. package/dist/layout/sidebar/sidebarLayout.d.ts.map +1 -0
  592. package/dist/tokens/primitives.d.ts +390 -0
  593. package/dist/tokens/primitives.d.ts.map +1 -0
  594. package/dist/tokens/semantic.d.ts +732 -0
  595. package/dist/tokens/semantic.d.ts.map +1 -0
  596. package/dist/tokens/themes/dark.d.ts +143 -0
  597. package/dist/tokens/themes/dark.d.ts.map +1 -0
  598. package/dist/tokens/themes/light.d.ts +16 -0
  599. package/dist/tokens/themes/light.d.ts.map +1 -0
  600. package/package.json +12 -4
  601. package/src/components/accordion/COMPONENT.md +190 -0
  602. package/src/components/accordion/examples/01-faq-marketing.tsx +62 -0
  603. package/src/components/accordion/examples/02-settings-panels.tsx +67 -0
  604. package/src/components/accordion/examples/03-checkout-order-summary.tsx +87 -0
  605. package/src/components/accordion/examples/04-api-docs-sections.tsx +86 -0
  606. package/src/components/accordion/examples/05-knowledge-base-categories.tsx +65 -0
  607. package/src/components/accordion/examples/examples.module.css +30 -0
  608. package/src/components/avatar/COMPONENT.md +152 -0
  609. package/src/components/avatar/examples/app-header-nav.tsx +41 -0
  610. package/src/components/avatar/examples/comment-thread.tsx +57 -0
  611. package/src/components/avatar/examples/examples.module.css +72 -0
  612. package/src/components/avatar/examples/fallback-variants.tsx +33 -0
  613. package/src/components/avatar/examples/group-overflow.tsx +32 -0
  614. package/src/components/avatar/examples/team-list.tsx +45 -0
  615. package/src/components/badge/COMPONENT.md +101 -0
  616. package/src/components/badge/examples/admin-tags.tsx +35 -0
  617. package/src/components/badge/examples/canonical.tsx +6 -0
  618. package/src/components/badge/examples/ecommerce-inventory.tsx +35 -0
  619. package/src/components/badge/examples/inbox-labels.tsx +36 -0
  620. package/src/components/badge/examples/status-presence.tsx +32 -0
  621. package/src/components/banner/COMPONENT.md +145 -0
  622. package/src/components/banner/examples/billing-alert.tsx +35 -0
  623. package/src/components/banner/examples/cookie-consent-row.tsx +36 -0
  624. package/src/components/banner/examples/feature-promo.tsx +36 -0
  625. package/src/components/banner/examples/maintenance.tsx +23 -0
  626. package/src/components/breadcrumb/COMPONENT.md +127 -0
  627. package/src/components/breadcrumb/examples/canonical.tsx +12 -0
  628. package/src/components/breadcrumb/examples/deep-documentation.tsx +16 -0
  629. package/src/components/breadcrumb/examples/ecommerce-product.tsx +18 -0
  630. package/src/components/breadcrumb/examples/long-path-ellipsis.tsx +21 -0
  631. package/src/components/breadcrumb/examples/saas-settings.tsx +16 -0
  632. package/src/components/button/COMPONENT.md +101 -0
  633. package/src/components/button/examples/canonical-composition.tsx +46 -0
  634. package/src/components/button/examples/destructive-confirm.tsx +36 -0
  635. package/src/components/button/examples/form-submit-row.tsx +33 -0
  636. package/src/components/button/examples/marketing-cta.tsx +26 -0
  637. package/src/components/button/examples/toolbar.tsx +38 -0
  638. package/src/components/button-group/COMPONENT.md +131 -0
  639. package/src/components/button-group/examples/editor-toolbar.tsx +46 -0
  640. package/src/components/button-group/examples/form-footer.tsx +19 -0
  641. package/src/components/button-group/examples/view-switcher.tsx +25 -0
  642. package/src/components/button-group/examples/wizard-actions.tsx +30 -0
  643. package/src/components/card/COMPONENT.md +307 -0
  644. package/src/components/card/examples/cover-banner.module.css +8 -0
  645. package/src/components/card/examples/cta-cover.tsx +44 -0
  646. package/src/components/card/examples/layout.module.css +7 -0
  647. package/src/components/card/examples/list-card.tsx +20 -0
  648. package/src/components/card/examples/media-mini.tsx +55 -0
  649. package/src/components/card/examples/metric-dashboard.tsx +60 -0
  650. package/src/components/card/examples/sparkline.module.css +10 -0
  651. package/src/components/card/examples/split-layout.tsx +29 -0
  652. package/src/components/checkbox/COMPONENT.md +129 -0
  653. package/src/components/checkbox/examples/bulk-select-rows.tsx +54 -0
  654. package/src/components/checkbox/examples/feature-flags-list.tsx +43 -0
  655. package/src/components/checkbox/examples/settings-panel.tsx +50 -0
  656. package/src/components/checkbox/examples/terms-acceptance.tsx +42 -0
  657. package/src/components/code-block/COMPONENT.md +88 -0
  658. package/src/components/code-block/examples/api-response-preview.tsx +21 -0
  659. package/src/components/code-block/examples/config-snippet.tsx +17 -0
  660. package/src/components/code-block/examples/error-stack.tsx +19 -0
  661. package/src/components/code-block/examples/minimal.tsx +6 -0
  662. package/src/components/code-block/examples/tutorial-step.tsx +28 -0
  663. package/src/components/color-picker/COMPONENT.md +171 -0
  664. package/src/components/color-picker/examples/brand-kit.tsx +48 -0
  665. package/src/components/color-picker/examples/controlled-form-field.tsx +40 -0
  666. package/src/components/color-picker/examples/minimal-popover.tsx +26 -0
  667. package/src/components/color-picker/examples/product-variant-swatch.tsx +42 -0
  668. package/src/components/color-picker/examples/theme-accent.tsx +46 -0
  669. package/src/components/command-menu/COMPONENT.md +195 -0
  670. package/src/components/command-menu/examples/app-palette.tsx +129 -0
  671. package/src/components/command-menu/examples/disabled-items.tsx +73 -0
  672. package/src/components/command-menu/examples/file-search.tsx +98 -0
  673. package/src/components/command-menu/examples/quick-actions.tsx +74 -0
  674. package/src/components/data-table/COMPONENT.md +114 -0
  675. package/src/components/data-table/examples/canonical-orders.tsx +107 -0
  676. package/src/components/data-table/examples/controlled-sort-and-page.tsx +66 -0
  677. package/src/components/data-table/examples/infinite-scroll-load-more.tsx +63 -0
  678. package/src/components/data-table/examples/row-selection.tsx +90 -0
  679. package/src/components/data-table/examples/sticky-header-first-column.tsx +55 -0
  680. package/src/components/datepicker/COMPONENT.md +169 -0
  681. package/src/components/datepicker/examples/birthdate.tsx +43 -0
  682. package/src/components/datepicker/examples/booking.tsx +71 -0
  683. package/src/components/datepicker/examples/full-width-form.tsx +59 -0
  684. package/src/components/datepicker/examples/range-report.tsx +54 -0
  685. package/src/components/digit-input/COMPONENT.md +100 -0
  686. package/src/components/digit-input/examples/error-state.tsx +14 -0
  687. package/src/components/digit-input/examples/otp-login.tsx +17 -0
  688. package/src/components/digit-input/examples/pin.tsx +11 -0
  689. package/src/components/digit-input/examples/resend-and-clear.tsx +23 -0
  690. package/src/components/digit-input/examples/verification-step.tsx +21 -0
  691. package/src/components/divider/COMPONENT.md +98 -0
  692. package/src/components/divider/examples/card-splits.tsx +27 -0
  693. package/src/components/divider/examples/divider-examples.module.css +137 -0
  694. package/src/components/divider/examples/inset-stack.tsx +33 -0
  695. package/src/components/divider/examples/line-spacing-column.tsx +27 -0
  696. package/src/components/divider/examples/list-separators.tsx +20 -0
  697. package/src/components/divider/examples/section-breaks.tsx +27 -0
  698. package/src/components/drawer/COMPONENT.md +149 -0
  699. package/src/components/drawer/examples/cart-preview.tsx +55 -0
  700. package/src/components/drawer/examples/examples-scenarios.module.css +79 -0
  701. package/src/components/drawer/examples/explicit-panel.tsx +40 -0
  702. package/src/components/drawer/examples/filters-panel.tsx +53 -0
  703. package/src/components/drawer/examples/mobile-nav-sheet.tsx +43 -0
  704. package/src/components/drawer/examples/settings-side.tsx +54 -0
  705. package/src/components/dropdown/COMPONENT.md +231 -0
  706. package/src/components/dropdown/examples/account-menu.tsx +52 -0
  707. package/src/components/dropdown/examples/actions-menu.tsx +37 -0
  708. package/src/components/dropdown/examples/placement-demo.tsx +59 -0
  709. package/src/components/dropdown/examples/select-like-list.tsx +31 -0
  710. package/src/components/file-upload/COMPONENT.md +229 -0
  711. package/src/components/file-upload/examples/avatar-upload.tsx +54 -0
  712. package/src/components/file-upload/examples/controlled-list.tsx +103 -0
  713. package/src/components/file-upload/examples/document-attach.tsx +70 -0
  714. package/src/components/file-upload/examples/drag-area.tsx +49 -0
  715. package/src/components/hint/COMPONENT.md +99 -0
  716. package/src/components/hint/examples/error-hint.tsx +22 -0
  717. package/src/components/hint/examples/field-help.tsx +27 -0
  718. package/src/components/hint/examples/inline-tip-form.tsx +44 -0
  719. package/src/components/hint/examples/success-confirmation.tsx +30 -0
  720. package/src/components/hint/examples/with-icon.tsx +13 -0
  721. package/src/components/input/COMPONENT.md +139 -0
  722. package/src/components/input/examples/checkout-full-width.module.css +8 -0
  723. package/src/components/input/examples/checkout-full-width.tsx +39 -0
  724. package/src/components/input/examples/login-email.tsx +33 -0
  725. package/src/components/input/examples/password-with-hint.tsx +28 -0
  726. package/src/components/input/examples/search.tsx +30 -0
  727. package/src/components/kbd/COMPONENT.md +87 -0
  728. package/src/components/kbd/examples/combination-keys.tsx +22 -0
  729. package/src/components/kbd/examples/docs-legend.tsx +44 -0
  730. package/src/components/kbd/examples/inline-doc-hint.tsx +18 -0
  731. package/src/components/kbd/examples/shortcut-row.tsx +21 -0
  732. package/src/components/kbd/examples/toolbar-hints.tsx +31 -0
  733. package/src/components/label/COMPONENT.md +125 -0
  734. package/src/components/label/examples/accessibility-pattern.tsx +28 -0
  735. package/src/components/label/examples/grouped-labels.tsx +30 -0
  736. package/src/components/label/examples/optional-field.tsx +14 -0
  737. package/src/components/label/examples/required-field.tsx +20 -0
  738. package/src/components/label/examples/with-icon.tsx +16 -0
  739. package/src/components/link-button/COMPONENT.md +79 -0
  740. package/src/components/link-button/examples/disabled.tsx +18 -0
  741. package/src/components/link-button/examples/external.tsx +18 -0
  742. package/src/components/link-button/examples/footer-legal.tsx +22 -0
  743. package/src/components/link-button/examples/inline-text-link.tsx +14 -0
  744. package/src/components/link-button/examples/navigation-cluster.tsx +24 -0
  745. package/src/components/modal/COMPONENT.md +176 -0
  746. package/src/components/modal/examples/canonical-maximal.tsx +43 -0
  747. package/src/components/modal/examples/examples.module.css +13 -0
  748. package/src/components/modal/examples/scenario-confirm-delete.tsx +38 -0
  749. package/src/components/modal/examples/scenario-edit-entity.tsx +50 -0
  750. package/src/components/modal/examples/scenario-legal-consent.tsx +36 -0
  751. package/src/components/modal/examples/scenario-multi-field-form.tsx +75 -0
  752. package/src/components/notification/COMPONENT.md +150 -0
  753. package/src/components/notification/examples/action-toast.tsx +84 -0
  754. package/src/components/notification/examples/error-success.tsx +70 -0
  755. package/src/components/notification/examples/notification-store.tsx +58 -0
  756. package/src/components/notification/examples/positions.tsx +73 -0
  757. package/src/components/notification/examples/toast-queue.tsx +63 -0
  758. package/src/components/pagination/COMPONENT.md +101 -0
  759. package/src/components/pagination/examples/canonical-composition.tsx +20 -0
  760. package/src/components/pagination/examples/compact.tsx +32 -0
  761. package/src/components/pagination/examples/controlled-page.tsx +57 -0
  762. package/src/components/pagination/examples/full-width-list.tsx +37 -0
  763. package/src/components/pagination/examples/table-footer.tsx +74 -0
  764. package/src/components/popover/COMPONENT.md +157 -0
  765. package/src/components/popover/examples/canonical-panel.tsx +24 -0
  766. package/src/components/popover/examples/date-trigger.tsx +33 -0
  767. package/src/components/popover/examples/form-in-popover.tsx +79 -0
  768. package/src/components/popover/examples/placement.tsx +42 -0
  769. package/src/components/popover/examples/rich-content.tsx +39 -0
  770. package/src/components/progress-bar/COMPONENT.md +84 -0
  771. package/src/components/progress-bar/examples/indeterminate-busy-state.tsx +21 -0
  772. package/src/components/progress-bar/examples/labeled.tsx +6 -0
  773. package/src/components/progress-bar/examples/progress-bar-examples.module.css +22 -0
  774. package/src/components/progress-bar/examples/step-progress.tsx +23 -0
  775. package/src/components/progress-bar/examples/upload-progress.tsx +27 -0
  776. package/src/components/progress-bar/examples/wizard-composition.tsx +18 -0
  777. package/src/components/progress-circle/COMPONENT.md +93 -0
  778. package/src/components/progress-circle/examples/a11y-label.tsx +32 -0
  779. package/src/components/progress-circle/examples/composition.tsx +66 -0
  780. package/src/components/progress-circle/examples/controlled.tsx +58 -0
  781. package/src/components/progress-circle/examples/dashboard-ring.tsx +36 -0
  782. package/src/components/progress-circle/examples/max-scale.tsx +61 -0
  783. package/src/components/radio/COMPONENT.md +123 -0
  784. package/src/components/radio/examples/notification-channel.tsx +29 -0
  785. package/src/components/radio/examples/plan-picker.tsx +53 -0
  786. package/src/components/radio/examples/radio-examples.module.css +31 -0
  787. package/src/components/radio/examples/settings-group.tsx +30 -0
  788. package/src/components/radio/examples/shipping-method.tsx +26 -0
  789. package/src/components/segmented-control/COMPONENT.md +108 -0
  790. package/src/components/segmented-control/examples/canonical-composition.tsx +70 -0
  791. package/src/components/segmented-control/examples/catalog-filters.tsx +41 -0
  792. package/src/components/segmented-control/examples/pricing-toggle.tsx +40 -0
  793. package/src/components/segmented-control/examples/segmented-examples.module.css +12 -0
  794. package/src/components/segmented-control/examples/view-mode.tsx +53 -0
  795. package/src/components/segmented-progress-bar/COMPONENT.md +104 -0
  796. package/src/components/segmented-progress-bar/examples/distribution-breakdown.tsx +16 -0
  797. package/src/components/segmented-progress-bar/examples/multi-phase-rollout.tsx +15 -0
  798. package/src/components/segmented-progress-bar/examples/segment-gaps.tsx +23 -0
  799. package/src/components/segmented-progress-bar/examples/size-ladder.tsx +19 -0
  800. package/src/components/segmented-progress-bar/examples/storage-mix.tsx +16 -0
  801. package/src/components/select/COMPONENT.md +202 -0
  802. package/src/components/select/examples/01-country.tsx +37 -0
  803. package/src/components/select/examples/02-controlled.tsx +35 -0
  804. package/src/components/select/examples/03-groups.tsx +45 -0
  805. package/src/components/select/examples/04-full-width-form.tsx +51 -0
  806. package/src/components/select/examples/examples.module.css +37 -0
  807. package/src/components/slider/COMPONENT.md +78 -0
  808. package/src/components/slider/examples/01-volume.tsx +17 -0
  809. package/src/components/slider/examples/02-price-range.tsx +18 -0
  810. package/src/components/slider/examples/03-controlled.tsx +30 -0
  811. package/src/components/slider/examples/04-disabled.tsx +25 -0
  812. package/src/components/slider/examples/examples.module.css +17 -0
  813. package/src/components/stepper/COMPONENT.md +211 -0
  814. package/src/components/stepper/examples/01-checkout-horizontal.tsx +32 -0
  815. package/src/components/stepper/examples/02-onboarding-vertical.tsx +51 -0
  816. package/src/components/stepper/examples/03-vertical-primitive-rail.tsx +36 -0
  817. package/src/components/stepper/examples/04-checkout-step-error.tsx +30 -0
  818. package/src/components/stepper/examples/05-horizontal-primitive.tsx +37 -0
  819. package/src/components/stepper/examples/examples.module.css +16 -0
  820. package/src/components/switch/COMPONENT.md +144 -0
  821. package/src/components/switch/examples/canonical-maximal.tsx +19 -0
  822. package/src/components/switch/examples/examples.module.css +56 -0
  823. package/src/components/switch/examples/scenario-billing-annual.tsx +27 -0
  824. package/src/components/switch/examples/scenario-feature-flag.tsx +30 -0
  825. package/src/components/switch/examples/scenario-form-consent.tsx +34 -0
  826. package/src/components/switch/examples/scenario-settings-toggle.tsx +26 -0
  827. package/src/components/tabs/COMPONENT.md +141 -0
  828. package/src/components/tabs/examples/01-settings-vertical-rail.tsx +49 -0
  829. package/src/components/tabs/examples/02-dashboard-subviews.tsx +42 -0
  830. package/src/components/tabs/examples/03-tab-triggers-with-icons.tsx +49 -0
  831. package/src/components/tabs/examples/04-long-labels-narrow.tsx +35 -0
  832. package/src/components/tabs/examples/05-controlled-active-tab.tsx +48 -0
  833. package/src/components/tabs/examples/examples.module.css +58 -0
  834. package/src/components/tag/COMPONENT.md +82 -0
  835. package/src/components/tag/examples/01-filter-chips.tsx +36 -0
  836. package/src/components/tag/examples/02-removable-selected-values.tsx +33 -0
  837. package/src/components/tag/examples/03-status-metadata.tsx +24 -0
  838. package/src/components/tag/examples/04-tag-sizes.tsx +18 -0
  839. package/src/components/tag/examples/examples.module.css +20 -0
  840. package/src/components/textarea/COMPONENT.md +120 -0
  841. package/src/components/textarea/examples/01-support-ticket.tsx +35 -0
  842. package/src/components/textarea/examples/02-comment.tsx +35 -0
  843. package/src/components/textarea/examples/03-controlled.tsx +27 -0
  844. package/src/components/textarea/examples/04-full-width.tsx +23 -0
  845. package/src/components/textarea/examples/examples.module.css +21 -0
  846. package/src/components/tooltip/COMPONENT.md +144 -0
  847. package/src/components/tooltip/examples/canonical-icon-hint.tsx +19 -0
  848. package/src/components/tooltip/examples/examples.module.css +6 -0
  849. package/src/components/tooltip/examples/scenario-controlled-programmatic.tsx +32 -0
  850. package/src/components/tooltip/examples/scenario-delay-provider.tsx +19 -0
  851. package/src/components/tooltip/examples/scenario-long-content.tsx +22 -0
  852. package/src/components/tooltip/examples/scenario-side-bottom.tsx +21 -0
  853. package/src/components/typography/COMPONENT.md +113 -0
  854. package/src/components/typography/examples/01-article.tsx +45 -0
  855. package/src/components/typography/examples/02-form-labels-contrast.tsx +61 -0
  856. package/src/components/typography/examples/03-marketing-hero.tsx +25 -0
  857. package/src/components/typography/examples/04-reading-scale.tsx +47 -0
  858. package/src/components/typography/examples/05-inline-emphasis.tsx +30 -0
  859. package/src/components/typography/examples/examples.module.css +30 -0
  860. package/src/layout/sidebar/COMPONENT.md +138 -0
  861. package/src/layout/sidebar/examples/01-app-shell-nav.tsx +79 -0
  862. package/src/layout/sidebar/examples/02-collapsible-desktop.tsx +64 -0
  863. package/src/layout/sidebar/examples/03-controlled-state.tsx +72 -0
  864. package/src/layout/sidebar/examples/04-router-navigation.tsx +70 -0
  865. package/src/layout/sidebar/examples/05-responsive-behavior.tsx +46 -0
  866. package/src/layout/sidebar/examples/examples.module.css +67 -0
  867. package/src/styles/theme-dark.css +43 -0
  868. package/src/styles/theme-light.css +43 -0
  869. package/src/styles/tokens.css +23 -4
  870. package/src/styles/tokens.test.ts +0 -27
@@ -0,0 +1,86 @@
1
+ import { BookOpen, Code2, Webhook } from "lucide-react";
2
+ import { Accordion, Typography } from "prime-ui-kit";
3
+ import * as React from "react";
4
+
5
+ import styles from "./examples.module.css";
6
+
7
+ /**
8
+ * Long-form API reference: controlled `value` / `onValueChange` so another part of the page (or
9
+ * deep link) can sync which section is open.
10
+ */
11
+ export default function AccordionExampleApiDocsSections() {
12
+ const [open, setOpen] = React.useState<string>("auth");
13
+
14
+ return (
15
+ <Accordion.Root
16
+ type="single"
17
+ size="m"
18
+ layout="grouped"
19
+ value={open}
20
+ onValueChange={(value) => setOpen(typeof value === "string" ? value : (value[0] ?? ""))}
21
+ >
22
+ <Accordion.Item value="auth">
23
+ <Accordion.Header>
24
+ <Accordion.Trigger>
25
+ <Accordion.Icon as={BookOpen} />
26
+ <span>Authentication</span>
27
+ <Accordion.Arrow />
28
+ </Accordion.Trigger>
29
+ </Accordion.Header>
30
+ <Accordion.Content>
31
+ <div className={styles.bodyStack}>
32
+ <Typography.Root as="p" variant="body-default" className={styles.lead}>
33
+ Send a bearer token in the{" "}
34
+ <Typography.Root as="span" variant="caption" weight="medium">
35
+ Authorization
36
+ </Typography.Root>{" "}
37
+ header. Tokens expire after twelve hours; refresh using the endpoint described in the
38
+ session guide.
39
+ </Typography.Root>
40
+ </div>
41
+ </Accordion.Content>
42
+ </Accordion.Item>
43
+ <Accordion.Item value="webhooks">
44
+ <Accordion.Header>
45
+ <Accordion.Trigger>
46
+ <Accordion.Icon as={Webhook} />
47
+ <span>Webhooks</span>
48
+ <Accordion.Arrow />
49
+ </Accordion.Trigger>
50
+ </Accordion.Header>
51
+ <Accordion.Content>
52
+ <Typography.Root as="p" variant="body-default" className={styles.lead}>
53
+ Register HTTPS endpoints to receive signed event payloads. Retry policy uses exponential
54
+ backoff for non-2xx responses up to three days.
55
+ </Typography.Root>
56
+ </Accordion.Content>
57
+ </Accordion.Item>
58
+ <Accordion.Item value="errors">
59
+ <Accordion.Header>
60
+ <Accordion.Trigger>
61
+ <Accordion.Icon as={Code2} />
62
+ <span>Error format</span>
63
+ <Accordion.Arrow />
64
+ </Accordion.Trigger>
65
+ </Accordion.Header>
66
+ <Accordion.Content>
67
+ <Typography.Root as="p" variant="body-default" className={styles.lead}>
68
+ Errors return JSON with{" "}
69
+ <Typography.Root as="span" variant="caption" weight="medium">
70
+ code
71
+ </Typography.Root>
72
+ ,{" "}
73
+ <Typography.Root as="span" variant="caption" weight="medium">
74
+ message
75
+ </Typography.Root>
76
+ , and optional{" "}
77
+ <Typography.Root as="span" variant="caption" weight="medium">
78
+ details
79
+ </Typography.Root>{" "}
80
+ for validation issues.
81
+ </Typography.Root>
82
+ </Accordion.Content>
83
+ </Accordion.Item>
84
+ </Accordion.Root>
85
+ );
86
+ }
@@ -0,0 +1,65 @@
1
+ import { FileQuestion, LifeBuoy, ShieldCheck } from "lucide-react";
2
+ import { Accordion, Typography } from "prime-ui-kit";
3
+
4
+ import styles from "./examples.module.css";
5
+
6
+ /**
7
+ * Support hub: `collapsible={false}` keeps one section pinned open once chosen, and a disabled item
8
+ * marks content that is not yet available for the user’s plan.
9
+ */
10
+ export default function AccordionExampleKnowledgeBaseCategories() {
11
+ return (
12
+ <Accordion.Root
13
+ type="single"
14
+ size="m"
15
+ layout="separate"
16
+ defaultValue="basics"
17
+ collapsible={false}
18
+ >
19
+ <Accordion.Item value="basics">
20
+ <Accordion.Header>
21
+ <Accordion.Trigger>
22
+ <Accordion.Icon as={LifeBuoy} />
23
+ <span>Getting started</span>
24
+ <Accordion.Arrow />
25
+ </Accordion.Trigger>
26
+ </Accordion.Header>
27
+ <Accordion.Content>
28
+ <Typography.Root as="p" variant="body-default" className={styles.lead}>
29
+ New here? Complete the workspace checklist, invite teammates, and connect your first
30
+ data source from the integrations directory.
31
+ </Typography.Root>
32
+ </Accordion.Content>
33
+ </Accordion.Item>
34
+ <Accordion.Item value="billing" disabled>
35
+ <Accordion.Header>
36
+ <Accordion.Trigger>
37
+ <Accordion.Icon as={ShieldCheck} />
38
+ <span>Billing &amp; contracts (Enterprise)</span>
39
+ <Accordion.Arrow />
40
+ </Accordion.Trigger>
41
+ </Accordion.Header>
42
+ <Accordion.Content>
43
+ <Typography.Root as="p" variant="body-default" className={styles.lead}>
44
+ Contract terms and invoice history appear here when your organization upgrades.
45
+ </Typography.Root>
46
+ </Accordion.Content>
47
+ </Accordion.Item>
48
+ <Accordion.Item value="troubleshoot">
49
+ <Accordion.Header>
50
+ <Accordion.Trigger>
51
+ <Accordion.Icon as={FileQuestion} />
52
+ <span>Troubleshooting</span>
53
+ <Accordion.Arrow />
54
+ </Accordion.Trigger>
55
+ </Accordion.Header>
56
+ <Accordion.Content>
57
+ <Typography.Root as="p" variant="body-default" className={styles.lead}>
58
+ Common fixes: clear the local cache, verify outbound firewall rules for our API hosts,
59
+ and confirm your SDK is on a supported major version.
60
+ </Typography.Root>
61
+ </Accordion.Content>
62
+ </Accordion.Item>
63
+ </Accordion.Root>
64
+ );
65
+ }
@@ -0,0 +1,30 @@
1
+ .stack {
2
+ display: flex;
3
+ flex-direction: column;
4
+ gap: var(--prime-sys-spacing-s);
5
+ }
6
+
7
+ .bodyStack {
8
+ display: flex;
9
+ flex-direction: column;
10
+ gap: var(--prime-sys-spacing-m);
11
+ }
12
+
13
+ .lead {
14
+ margin: 0;
15
+ color: var(--prime-sys-color-content-secondary);
16
+ }
17
+
18
+ .actions {
19
+ display: flex;
20
+ flex-wrap: wrap;
21
+ gap: var(--prime-sys-spacing-m);
22
+ margin-top: var(--prime-sys-spacing-s);
23
+ }
24
+
25
+ .row {
26
+ display: flex;
27
+ justify-content: space-between;
28
+ align-items: baseline;
29
+ gap: var(--prime-sys-spacing-m);
30
+ }
@@ -0,0 +1,152 @@
1
+ # Avatar
2
+
3
+ **Проектирование по умолчанию:** при проектировании экранов и примеров изначально выбирай **`m`** для `size` (где есть ось размера), если явно не оговорено иное.
4
+
5
+ ## About
6
+
7
+ Circular avatar with an optional photo (`Avatar.Image`), a fallback layer (`Avatar.Fallback`), and an optional horizontal stack (`Avatar.Group`) with an overflow cell.
8
+
9
+ - **Use** for profile pictures, participant lists, assignees in tables, and compact identity in headers or comments when a face or initials aid recognition.
10
+ - **Use** `Avatar.Group` when several avatars should overlap in one row and you may show a “+N” overflow.
11
+ - **Do not use** as the only focusable control without a wrapping `button` or `link` when the avatar itself must be actionable.
12
+ - **Do not use** for non-circular crops or rich media cards; keep this primitive for round avatars and short fallback content.
13
+ - **Do not use** expecting an external “controlled” image load state; status lives inside `Avatar.Root` and resets when `src` changes (see Rules).
14
+
15
+ ## Composition
16
+
17
+ - **`Avatar.Root`** — outer `div` with `data-size`, provides context (`size`, internal image status). Place **`Avatar.Image`** (optional) and **`Avatar.Fallback`** inside; image is painted above the fallback in the layout.
18
+ - **`Avatar.Image`** — `img` with `data-status` (`loading` \| `loaded` \| `error`). Requires **`src`**; the implementation remounts when **`src`** changes, which restarts loading and context status.
19
+ - **`Avatar.Fallback`** — `span` shown when the image is absent, loading, or in error; when the image has loaded successfully, the fallback gets **`aria-hidden`**.
20
+ - **`Avatar.Group.Root`** — horizontal flex row; passes its **`size`** into child **`Avatar.Root`** and **`Avatar.Group.Overflow`** that omit their own **`size`** (including through **`React.Fragment`** children).
21
+ - **`Avatar.Group.Overflow`** — cell matching avatar dimensions for text such as `+3`.
22
+
23
+ ### Canonical example
24
+
25
+ Один фрагмент разметки: одиночный аватар (**`Image`** + **`Fallback`**), группа с **`Overflow`**, плюс **`Fallback`** с иконкой и подписи через **[Typography](../typography/COMPONENT.md)**. Импорт только из **`prime-ui-kit`**.
26
+
27
+ ```tsx
28
+ import { Avatar, Icon, Typography } from "prime-ui-kit";
29
+
30
+ const sampleSrc =
31
+ "https://images.unsplash.com/photo-1535713875002-d1d0cf377fde?w=128&h=128&fit=crop";
32
+
33
+ export function CanonicalAvatarDemo() {
34
+ return (
35
+ <>
36
+ <Typography as="p" variant="body-small" tone="muted">
37
+ Profile cell
38
+ </Typography>
39
+ <Avatar.Root size="l" aria-label="Jamie Chen, online">
40
+ <Avatar.Image src={sampleSrc} alt="" />
41
+ <Avatar.Fallback>JC</Avatar.Fallback>
42
+ </Avatar.Root>
43
+
44
+ <Typography as="p" variant="body-small" tone="muted">
45
+ Overlapping group + overflow
46
+ </Typography>
47
+ <Avatar.Group.Root size="m" aria-label="Reviewers: three faces, two not shown">
48
+ <Avatar.Root>
49
+ <Avatar.Image src={sampleSrc} alt="" />
50
+ <Avatar.Fallback>A</Avatar.Fallback>
51
+ </Avatar.Root>
52
+ <Avatar.Root>
53
+ <Avatar.Fallback>B</Avatar.Fallback>
54
+ </Avatar.Root>
55
+ <Avatar.Root>
56
+ <Avatar.Fallback>C</Avatar.Fallback>
57
+ </Avatar.Root>
58
+ <Avatar.Group.Overflow aria-label="Two additional reviewers">+2</Avatar.Group.Overflow>
59
+ </Avatar.Group.Root>
60
+
61
+ <Typography as="p" variant="body-small" tone="muted">
62
+ Icon-only fallback
63
+ </Typography>
64
+ <Avatar.Root size="m" aria-label="Invitee, no photo yet">
65
+ <Avatar.Fallback>
66
+ <Icon name="field.email" size="l" tone="subtle" />
67
+ </Avatar.Fallback>
68
+ </Avatar.Root>
69
+ </>
70
+ );
71
+ }
72
+ ```
73
+
74
+ ### Extended examples
75
+
76
+ Готовые сценарии с раскладкой на **`--prime-sys-`* (см. [`examples/examples.module.css`](./examples/examples.module.css)):
77
+
78
+ | Файл | Сценарий |
79
+ |------|----------|
80
+ | [`examples/team-list.tsx`](./examples/team-list.tsx) | Список команды: аватар + имя + роль |
81
+ | [`examples/comment-thread.tsx`](./examples/comment-thread.tsx) | Ветка комментариев с аватаром у каждого сообщения |
82
+ | [`examples/app-header-nav.tsx`](./examples/app-header-nav.tsx) | Шапка: навигация **[LinkButton](../link-button/COMPONENT.md)** и блок «аккаунт» с аватаром |
83
+ | [`examples/group-overflow.tsx`](./examples/group-overflow.tsx) | **`Avatar.Group`** с **`Overflow`** (`+N`) |
84
+ | [`examples/fallback-variants.tsx`](./examples/fallback-variants.tsx) | Фото, инициалы и иконка в **`Fallback`** в одном ряду |
85
+
86
+ ### Note for LLMs
87
+
88
+ При генерации экранов опирайся на публичный API выше и на **исходники** в `src/components/avatar/examples/*.tsx`: там полные импорты **`prime-ui-kit`**, типичная композиция с **[Typography](../typography/COMPONENT.md)** / **[LinkButton](../link-button/COMPONENT.md)** / **`Icon`** (экспорт пакета) и семантическая вёрстка без обхода стилей кита. Не дублируй длинные листинги в ответе — укажи путь к файлу примера.
89
+
90
+ ## Rules
91
+
92
+ - Image lifecycle is **internal**: context status is `idle` \| `loading` \| `loaded` \| `error`; there is no prop to control it from outside—change **`src`** (or remove **`Avatar.Image`**) to reset behavior.
93
+ - Put **`Avatar.Image`** and **`Avatar.Fallback`** only under **`Avatar.Root`**; **`Avatar.Fallback`** does not accept a **`src`**—photos go through **`Avatar.Image`** only.
94
+ - Give **`Avatar.Root`** or a wrapper a clear name for assistive tech (**`aria-label`**, **`aria-labelledby`**, or nearby visible text). On **`Avatar.Image`**, use a non-empty **`alt`** when the photo conveys meaning; use **`alt=""`** when it duplicates a visible name.
95
+ - After a successful load, **`Avatar.Fallback`** is **`aria-hidden`** so screen readers do not double-announce initials and alt text.
96
+ - For **`Avatar.Group.Root`** and **`Avatar.Group.Overflow`**, prefer summary labels (**`aria-label`**) when the stack or “+N” needs context.
97
+ - There is no **`disabled`** prop; mute or disable via the parent (e.g. button **`disabled`**, link **`aria-disabled`**, reduced opacity).
98
+ - **`Avatar.Group`** is laid out as a **horizontal** row only; nesting **`Avatar.Root`** inside another **`Avatar.Root`** is not a supported pattern.
99
+
100
+ ## API
101
+
102
+ ### Avatar.Root
103
+
104
+ | Prop | Type | Default | Required | Description |
105
+ |------|------|---------|----------|-------------|
106
+ | size | `"s" \| "m" \| "l" \| "xl" \| "2xl" \| "3xl" \| "4xl" \| "5xl" \| "6xl"` | `"m"` | No | Diameter, radius, and fallback typography scale |
107
+ | children | `React.ReactNode` | — | No | Typically `Avatar.Image` and `Avatar.Fallback` |
108
+ | className | `string` | — | No | Additional class on the root |
109
+ | …rest | `React.HTMLAttributes<HTMLDivElement>` | — | No | Other root attributes |
110
+
111
+ ### Avatar.Image
112
+
113
+ | Prop | Type | Default | Required | Description |
114
+ |------|------|---------|----------|-------------|
115
+ | src | `string` | — | Yes | Image URL; changing `src` remounts the image and resets status |
116
+ | alt | `string` | `""` | No | Alternative text for the image |
117
+ | className | `string` | — | No | Class on the `img` |
118
+ | …rest | `Omit<React.ImgHTMLAttributes<HTMLImageElement>, "src" \| "alt">` | — | No | e.g. `loading`, `decoding`, event handlers |
119
+
120
+ ### Avatar.Fallback
121
+
122
+ | Prop | Type | Default | Required | Description |
123
+ |------|------|---------|----------|-------------|
124
+ | children | `React.ReactNode` | — | No | Initials, icon, or placeholder |
125
+ | className | `string` | — | No | Class on the `span` |
126
+ | …rest | `React.HTMLAttributes<HTMLSpanElement>` | — | No | Other attributes |
127
+
128
+ ### Avatar.Group.Root
129
+
130
+ | Prop | Type | Default | Required | Description |
131
+ |------|------|---------|----------|-------------|
132
+ | size | same as `Avatar.Root` | `"m"` | No | Size applied to child `Avatar.Root` and `Avatar.Group.Overflow` without their own `size` |
133
+ | children | `React.ReactNode` | — | No | `Avatar.Root` nodes and optional `Avatar.Group.Overflow` |
134
+ | className | `string` | — | No | Class on the group container |
135
+ | …rest | `React.HTMLAttributes<HTMLDivElement>` | — | No | Other attributes |
136
+
137
+ ### Avatar.Group.Overflow
138
+
139
+ | Prop | Type | Default | Required | Description |
140
+ |------|------|---------|----------|-------------|
141
+ | size | same as `Avatar.Root` | `"m"` | No | Local size when not inherited from the group |
142
+ | children | `React.ReactNode` | — | No | e.g. `+3` |
143
+ | className | `string` | — | No | Class on the overflow cell |
144
+ | …rest | `React.HTMLAttributes<HTMLDivElement>` | — | No | Other attributes |
145
+
146
+ ## Related
147
+
148
+ - [Button](../button/COMPONENT.md)
149
+ - [Dropdown](../dropdown/COMPONENT.md)
150
+ - [Label](../label/COMPONENT.md)
151
+ - [Tooltip](../tooltip/COMPONENT.md)
152
+ - [Typography](../typography/COMPONENT.md)
@@ -0,0 +1,41 @@
1
+ import { Avatar, LinkButton, Typography } from "prime-ui-kit";
2
+
3
+ import styles from "./examples.module.css";
4
+
5
+ const portrait =
6
+ "https://images.unsplash.com/photo-1535713875002-d1d0cf377fde?w=128&h=128&fit=crop";
7
+
8
+ /**
9
+ * App chrome: product title, nav links, and a signed-in identity cluster (avatar + account link).
10
+ */
11
+ export default function AvatarAppHeaderNavExample() {
12
+ return (
13
+ <header className={styles.navBar}>
14
+ <div className={styles.navCluster}>
15
+ <Typography.Root as="span" variant="heading-subsection" weight="semibold">
16
+ Prime Console
17
+ </Typography.Root>
18
+ <nav className={styles.row} aria-label="Primary">
19
+ <LinkButton.Root href="#overview" size="m">
20
+ Overview
21
+ </LinkButton.Root>
22
+ <LinkButton.Root href="#projects" size="m">
23
+ Projects
24
+ </LinkButton.Root>
25
+ <LinkButton.Root href="#settings" size="m">
26
+ Settings
27
+ </LinkButton.Root>
28
+ </nav>
29
+ </div>
30
+ <div className={styles.navUser}>
31
+ <Avatar.Root size="m" aria-label="Signed in as Jamie Chen">
32
+ <Avatar.Image src={portrait} alt="" />
33
+ <Avatar.Fallback>JC</Avatar.Fallback>
34
+ </Avatar.Root>
35
+ <LinkButton.Root href="#account" size="m">
36
+ Account
37
+ </LinkButton.Root>
38
+ </div>
39
+ </header>
40
+ );
41
+ }
@@ -0,0 +1,57 @@
1
+ import { Avatar, Typography } from "prime-ui-kit";
2
+
3
+ import styles from "./examples.module.css";
4
+
5
+ const portrait =
6
+ "https://images.unsplash.com/photo-1527980965255-d3b416303d12?w=128&h=128&fit=crop";
7
+
8
+ type Comment = { id: string; author: string; initials: string; body: string; src?: string };
9
+
10
+ const comments: Comment[] = [
11
+ {
12
+ id: "c1",
13
+ author: "Casey Ng",
14
+ initials: "CN",
15
+ body: "Shipped the first cut of filters. Can you sanity-check the empty state?",
16
+ src: portrait,
17
+ },
18
+ {
19
+ id: "c2",
20
+ author: "Riley Park",
21
+ initials: "RP",
22
+ body: "Looks good. Let’s add a single-line skeleton for slow networks.",
23
+ },
24
+ {
25
+ id: "c3",
26
+ author: "Morgan Blake",
27
+ initials: "MB",
28
+ body: "+1 on skeleton. I’ll wire it in the list cell tomorrow.",
29
+ src: portrait,
30
+ },
31
+ ];
32
+
33
+ /**
34
+ * Comment thread: avatar + stacked author line and body copy.
35
+ */
36
+ export default function AvatarCommentThreadExample() {
37
+ return (
38
+ <ul className={styles.list} aria-label="Discussion">
39
+ {comments.map((c) => (
40
+ <li key={c.id} className={styles.rowStretch}>
41
+ <Avatar.Root size="m" aria-label={c.author}>
42
+ {c.src ? <Avatar.Image src={c.src} alt="" /> : null}
43
+ <Avatar.Fallback>{c.initials}</Avatar.Fallback>
44
+ </Avatar.Root>
45
+ <div className={styles.stack}>
46
+ <Typography.Root as="span" variant="body-small" weight="semibold">
47
+ {c.author}
48
+ </Typography.Root>
49
+ <Typography.Root as="p" variant="body-default" tone="muted">
50
+ {c.body}
51
+ </Typography.Root>
52
+ </div>
53
+ </li>
54
+ ))}
55
+ </ul>
56
+ );
57
+ }
@@ -0,0 +1,72 @@
1
+ .stack {
2
+ display: flex;
3
+ flex-direction: column;
4
+ gap: var(--prime-sys-spacing-m);
5
+ }
6
+
7
+ .row {
8
+ display: flex;
9
+ flex-direction: row;
10
+ flex-wrap: wrap;
11
+ align-items: center;
12
+ gap: var(--prime-sys-spacing-m);
13
+ }
14
+
15
+ .rowStretch {
16
+ display: flex;
17
+ flex-direction: row;
18
+ align-items: flex-start;
19
+ gap: var(--prime-sys-spacing-m);
20
+ }
21
+
22
+ .list {
23
+ display: flex;
24
+ flex-direction: column;
25
+ gap: var(--prime-sys-spacing-l);
26
+ margin: 0;
27
+ padding: 0;
28
+ list-style: none;
29
+ }
30
+
31
+ .listItem {
32
+ display: flex;
33
+ flex-direction: row;
34
+ align-items: center;
35
+ gap: var(--prime-sys-spacing-m);
36
+ min-width: 0;
37
+ }
38
+
39
+ .listItemBody {
40
+ display: flex;
41
+ flex-direction: column;
42
+ gap: var(--prime-sys-spacing-x1);
43
+ min-width: 0;
44
+ }
45
+
46
+ .navBar {
47
+ display: flex;
48
+ flex-direction: row;
49
+ flex-wrap: wrap;
50
+ align-items: center;
51
+ justify-content: space-between;
52
+ gap: var(--prime-sys-spacing-m);
53
+ padding: var(--prime-sys-spacing-m) var(--prime-sys-spacing-l);
54
+ border-radius: var(--prime-sys-shape-radius-m);
55
+ background: var(--prime-sys-color-surface-raised);
56
+ border: 1px solid var(--prime-sys-color-border-subtle);
57
+ }
58
+
59
+ .navCluster {
60
+ display: flex;
61
+ flex-direction: row;
62
+ flex-wrap: wrap;
63
+ align-items: center;
64
+ gap: var(--prime-sys-spacing-l);
65
+ }
66
+
67
+ .navUser {
68
+ display: flex;
69
+ flex-direction: row;
70
+ align-items: center;
71
+ gap: var(--prime-sys-spacing-s);
72
+ }
@@ -0,0 +1,33 @@
1
+ import { Avatar, Icon, Typography } from "prime-ui-kit";
2
+
3
+ import styles from "./examples.module.css";
4
+
5
+ const portrait =
6
+ "https://images.unsplash.com/photo-1535713875002-d1d0cf377fde?w=128&h=128&fit=crop";
7
+
8
+ /**
9
+ * Side-by-side: loaded image, initials-only fallback, and icon-only fallback.
10
+ */
11
+ export default function AvatarFallbackVariantsExample() {
12
+ return (
13
+ <div className={styles.stack}>
14
+ <Typography.Root as="p" variant="caption" tone="muted">
15
+ Same size tier; different fallback strategies
16
+ </Typography.Root>
17
+ <div className={styles.row}>
18
+ <Avatar.Root size="xl" aria-label="User with photo">
19
+ <Avatar.Image src={portrait} alt="" />
20
+ <Avatar.Fallback>PH</Avatar.Fallback>
21
+ </Avatar.Root>
22
+ <Avatar.Root size="xl" aria-label="User with initials only">
23
+ <Avatar.Fallback>IN</Avatar.Fallback>
24
+ </Avatar.Root>
25
+ <Avatar.Root size="xl" aria-label="Placeholder account">
26
+ <Avatar.Fallback>
27
+ <Icon name="field.email" size="xl" tone="subtle" />
28
+ </Avatar.Fallback>
29
+ </Avatar.Root>
30
+ </div>
31
+ </div>
32
+ );
33
+ }
@@ -0,0 +1,32 @@
1
+ import { Avatar, Typography } from "prime-ui-kit";
2
+
3
+ import styles from "./examples.module.css";
4
+
5
+ const portrait =
6
+ "https://images.unsplash.com/photo-1535713875002-d1d0cf377fde?w=128&h=128&fit=crop";
7
+
8
+ /**
9
+ * Overlapping group with an overflow cell for hidden participants.
10
+ */
11
+ export default function AvatarGroupOverflowExample() {
12
+ return (
13
+ <div className={styles.stack}>
14
+ <Typography.Root as="p" variant="body-small" tone="muted">
15
+ Design review — 5 invited, 2 faces shown
16
+ </Typography.Root>
17
+ <Avatar.Group.Root
18
+ size="l"
19
+ aria-label="Participants: two avatars visible, three more not shown"
20
+ >
21
+ <Avatar.Root>
22
+ <Avatar.Image src={portrait} alt="" />
23
+ <Avatar.Fallback>A</Avatar.Fallback>
24
+ </Avatar.Root>
25
+ <Avatar.Root>
26
+ <Avatar.Fallback>B</Avatar.Fallback>
27
+ </Avatar.Root>
28
+ <Avatar.Group.Overflow aria-label="Three additional participants">+3</Avatar.Group.Overflow>
29
+ </Avatar.Group.Root>
30
+ </div>
31
+ );
32
+ }
@@ -0,0 +1,45 @@
1
+ import { Avatar, Typography } from "prime-ui-kit";
2
+
3
+ import styles from "./examples.module.css";
4
+
5
+ const portrait =
6
+ "https://images.unsplash.com/photo-1535713875002-d1d0cf377fde?w=128&h=128&fit=crop";
7
+
8
+ type Member = { id: string; name: string; role: string; src?: string };
9
+
10
+ const members: Member[] = [
11
+ { id: "1", name: "Alex Morgan", role: "Design lead", src: portrait },
12
+ { id: "2", name: "Jordan Lee", role: "Engineer" },
13
+ { id: "3", name: "Sam Rivera", role: "PM", src: portrait },
14
+ ];
15
+
16
+ /**
17
+ * Team roster: each row pairs Avatar with Typography; missing photo falls back to initials.
18
+ */
19
+ export default function AvatarTeamListExample() {
20
+ return (
21
+ <ul className={styles.list} aria-label="Team members">
22
+ {members.map((m) => (
23
+ <li key={m.id} className={styles.listItem}>
24
+ <Avatar.Root size="l" aria-label={m.name}>
25
+ {m.src ? <Avatar.Image src={m.src} alt="" /> : null}
26
+ <Avatar.Fallback>
27
+ {m.name
28
+ .split(" ")
29
+ .map((p) => p[0])
30
+ .join("")}
31
+ </Avatar.Fallback>
32
+ </Avatar.Root>
33
+ <div className={styles.listItemBody}>
34
+ <Typography.Root as="span" variant="body-default" weight="medium">
35
+ {m.name}
36
+ </Typography.Root>
37
+ <Typography.Root as="span" variant="caption" tone="muted">
38
+ {m.role}
39
+ </Typography.Root>
40
+ </div>
41
+ </li>
42
+ ))}
43
+ </ul>
44
+ );
45
+ }