@cloudflare/kumo 2.7.0 → 2.9.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 (1130) hide show
  1. package/CHANGELOG.md +107 -0
  2. package/README.md +3 -39
  3. package/ai/USAGE.md +89 -80
  4. package/ai/component-registry.json +1319 -194
  5. package/ai/component-registry.md +1799 -198
  6. package/ai/schemas.ts +139 -8
  7. package/bin/kumo.js +1 -1
  8. package/dist/.build-complete +1 -1
  9. package/dist/ai/schemas.d.ts +2040 -1791
  10. package/dist/ai/schemas.js +5550 -3868
  11. package/dist/blocks-source/delete-resource/delete-resource.tsx +5 -5
  12. package/dist/blocks-source/resource-list/resource-list.test.tsx +1 -1
  13. package/dist/blocks-source/resource-list/resource-list.tsx +1 -4
  14. package/dist/button-Bbi7gFL7.d.ts +227 -0
  15. package/dist/catalog.d.ts +377 -0
  16. package/dist/catalog.js +347 -215
  17. package/dist/chunks/AlertDialogTrigger-fn9yjykev9h5l12q.js +24 -0
  18. package/dist/chunks/AutocompleteItem-clgm7u7zzgjy1hvb.js +82 -0
  19. package/dist/chunks/Button-oczevl8g75m85ew9.js +27 -0
  20. package/dist/chunks/CSPContext-guqghj8kxoukvlky.js +17 -0
  21. package/dist/chunks/CSPProvider-ogozggb4nr6evned.js +24 -0
  22. package/dist/chunks/CheckboxGroup-h9w1c6bo2nlcc4uj.js +177 -0
  23. package/dist/chunks/CheckboxGroupContext-f9wox07n2u5moq4h.js +12 -0
  24. package/dist/chunks/CheckboxIndicator-gz18hapnzraxyz9a.js +49 -0
  25. package/dist/chunks/CheckboxRoot-g6fb44xqgc0qxusf.js +361 -0
  26. package/dist/chunks/CollapsiblePanel-mnjlf99v79k3yabx.js +177 -0
  27. package/dist/chunks/ComboboxChipRemove-opf1zyu9yyp98dqd.js +302 -0
  28. package/dist/chunks/ComboboxClear-fi4op1n12c99ktca.js +302 -0
  29. package/dist/chunks/ComboboxEmpty-dr78bn7zilhqbkgc.js +1882 -0
  30. package/dist/chunks/ComboboxPopup-bugeajuqjattk1n7.js +205 -0
  31. package/dist/chunks/CompositeItem-l7zee38lq5m224d5.js +23 -0
  32. package/dist/chunks/CompositeList-bek8pmx9o8cu36ig.js +129 -0
  33. package/dist/chunks/CompositeListContext-oetjj2x8li8678as.js +18 -0
  34. package/dist/chunks/CompositeRoot-jm9n0rrea12rfny1.js +225 -0
  35. package/dist/chunks/CompositeRootContext-ofhzmevv7hadjhyy.js +12 -0
  36. package/dist/chunks/DialogHandle-o964gplvp59qqv23.js +139 -0
  37. package/dist/chunks/DialogPopup-cz73mkiyi9c33mhn.js +174 -0
  38. package/dist/chunks/DialogRoot-kfhbouiouenljp3q.js +15 -0
  39. package/dist/chunks/DialogTrigger-gzxvssie7e5e1iba.js +139 -0
  40. package/dist/chunks/DirectionContext-jc1g0w645603sd6p.js +13 -0
  41. package/dist/chunks/DirectionProvider-gdktkteyrlpnokak.js +21 -0
  42. package/dist/chunks/FieldControl-oz007qbkl6ejp7di.js +104 -0
  43. package/dist/chunks/FieldDescription-go88jdymmj9o0ugi.js +121 -0
  44. package/dist/chunks/FieldItemContext-j85dc0ihramj5ezs.js +10 -0
  45. package/dist/chunks/FieldLabel-junk2aczkvogpv5d.js +558 -0
  46. package/dist/chunks/FieldsetLegend-ch85hugankjah152.js +68 -0
  47. package/dist/chunks/FieldsetRootContext-b633e9uzilttuyfi.js +12 -0
  48. package/dist/chunks/FloatingPortalLite-ld4o97z16w23x6za.js +25 -0
  49. package/dist/chunks/FloatingTree-jdm71b3m43e34hk7.js +115 -0
  50. package/dist/chunks/Form-f1ibju5npd1qqowg.js +102 -0
  51. package/dist/chunks/FormContext-xz0b4h7ue30fkkn1.js +17 -0
  52. package/dist/chunks/Input-opaph7rt3w2vx3c0.js +20 -0
  53. package/dist/chunks/LabelableContext-hetas2e4y0kywfas.js +131 -0
  54. package/dist/chunks/MenuBackdrop-m0tfcr6sg50f9sn5.js +78 -0
  55. package/dist/chunks/MenuSubmenuTrigger-n281iqpstcnacsk6.js +1532 -0
  56. package/dist/chunks/MenuTrigger-dwh2ewyxp5j3ml02.js +266 -0
  57. package/dist/chunks/Menubar-m8euwx8biy1qpo44.js +117 -0
  58. package/dist/chunks/MenubarContext-ei2r6vu6lmsspozo.js +12 -0
  59. package/dist/chunks/MeterLabel-efe4koezlgg05cv8.js +151 -0
  60. package/dist/chunks/PopoverClose-inm8xliypc51murq.js +666 -0
  61. package/dist/chunks/RadioGroup-h25jrjmet0gxrvex.js +165 -0
  62. package/dist/chunks/RadioGroupContext-ft0nndmzqynjz8a2.js +10 -0
  63. package/dist/chunks/RadioIndicator-lvpixnzpkxpq7rp1.js +296 -0
  64. package/dist/chunks/ScrollAreaThumb-jydo7azxxwjn1cqf.js +944 -0
  65. package/dist/chunks/SelectGroupLabel-mug19qcz2k67qule.js +1600 -0
  66. package/dist/chunks/Separator-b8wf5rea6m1cei8k.js +24 -0
  67. package/dist/chunks/SwitchRoot-gumgk7356eqv7dve.js +237 -0
  68. package/dist/chunks/TabsList-obzldrvfzo50uqr4.js +617 -0
  69. package/dist/chunks/Toggle-hlf7recxsq6mxvax.js +89 -0
  70. package/dist/chunks/ToggleGroup-l8tfcwe33tlqqm8a.js +106 -0
  71. package/dist/chunks/ToggleGroupContext-cdk2zo6ciddpockn.js +12 -0
  72. package/dist/chunks/ToolbarGroupContext-nriz3632ymugfj6h.js +12 -0
  73. package/dist/chunks/ToolbarInput-oy7o682hhn2jdjen.js +152 -0
  74. package/dist/chunks/ToolbarRootContext-lvi96r1vvs93rhde.js +12 -0
  75. package/dist/chunks/TooltipPopup-ehusafczcky9jvae.js +868 -0
  76. package/dist/chunks/TooltipProvider-iq6hgymrn3b68h50.js +64 -0
  77. package/dist/chunks/addEventListener-lhqvk2ahlzjsanyg.js +13 -0
  78. package/dist/chunks/areArraysEqual-nlbeaqlzf4274zr3.js +7 -0
  79. package/dist/chunks/autocomplete-m8n1c775n0iilomf.js +152 -0
  80. package/dist/chunks/badge-e16yhhe9xibra5k7.js +148 -0
  81. package/dist/chunks/banner-cu2mip76zfx0gf27.js +258 -0
  82. package/dist/chunks/bash-jpzh6zbf5237424t.js +3 -0
  83. package/dist/chunks/breadcrumbs-hxibrxjtvudy0ir9.js +164 -0
  84. package/dist/chunks/button-eikucjpgqbsn5m5m.js +260 -0
  85. package/dist/chunks/chart-bxxlck50zlsbj3kl.js +3083 -0
  86. package/dist/chunks/checkbox-fovnhs7f1sekaxrh.js +158 -0
  87. package/dist/chunks/clamp-kvu4wtr1dw6b3pnd.js +7 -0
  88. package/dist/chunks/clipboard-text-fuyj4apm2xry4hkk.js +198 -0
  89. package/dist/chunks/cloudflare-logo-g0aimzpllornl0rc.js +186 -0
  90. package/dist/chunks/code-eu8kzwqnlhoyin24.js +96 -0
  91. package/dist/chunks/collapsible-lj0glxe1hezap65x.js +178 -0
  92. package/dist/chunks/combobox-m2nvbt0b1stb2syc.js +301 -0
  93. package/dist/chunks/command-palette-jjrbvylvvbj0qusg.js +507 -0
  94. package/dist/chunks/composite-o65hjzwwzb4kvl4w.js +102 -0
  95. package/dist/chunks/constants-j09lrtg73n4vlx5x.js +5 -0
  96. package/dist/chunks/core-kjfqbvgicl9i3abf.js +7163 -0
  97. package/dist/chunks/createBaseUIEventDetails-ddivuhl74gni72qn.js +86 -0
  98. package/dist/chunks/createToastManager-kjd838m8jog8pddj.js +1233 -0
  99. package/dist/chunks/css-d3t41yfupsmz7l1a.js +4 -0
  100. package/dist/chunks/date-picker-njfirc1m165k6yax.js +6786 -0
  101. package/dist/chunks/date-range-picker-g6sje1ua7n7jerkq.js +335 -0
  102. package/dist/chunks/dialog-b4r3dv8uvgl2pqem.js +170 -0
  103. package/dist/chunks/diff-g2re0kj6fh27rgg5.js +4 -0
  104. package/dist/chunks/dropdown-k0y5j6iuad7tvqgx.js +279 -0
  105. package/dist/chunks/empty-hmu7x39lnp0z2qm6.js +89 -0
  106. package/dist/chunks/engine-io35xsj9fgfxtihg.js +10 -0
  107. package/dist/chunks/engine-javascript-d795u677f1802oaf.js +3103 -0
  108. package/dist/chunks/engine-oniguruma-xjlw46ay321yj1av.js +388 -0
  109. package/dist/chunks/error-mm98alb8acdy93vq.js +15 -0
  110. package/dist/chunks/field-dxe9ne8fqy5whws2.js +70 -0
  111. package/dist/chunks/flow-fbsv3yek3w7v5a6p.js +10270 -0
  112. package/dist/chunks/formatNumber-hjijm58g645q6a0n.js +26 -0
  113. package/dist/chunks/getCssDimensions-mi941fe1jvztqm6b.js +21 -0
  114. package/dist/chunks/getEmptyRootContext-2utawetz04dqkzyn.js +18 -0
  115. package/dist/chunks/getPseudoElementBounds-jg72lmrlwgbqhmjh.js +28 -0
  116. package/dist/chunks/github-light-kb466scjoy42qxpu.js +5 -0
  117. package/dist/chunks/graphql-gtqr4wytdf0qjybo.js +16 -0
  118. package/dist/chunks/grid-d43q1qme6ffbbcl1.js +118 -0
  119. package/dist/chunks/hcl-ohpfnrffs96hzyj5.js +4 -0
  120. package/dist/chunks/html-ijyj3f9k0foag15c.js +12 -0
  121. package/dist/chunks/index.parts-9xtishx4m3j6sbg9.js +1429 -0
  122. package/dist/chunks/index.parts-bsarfaby0ttw67bb.js +206 -0
  123. package/dist/chunks/index.parts-buqjmx1pfsd225r7.js +30 -0
  124. package/dist/chunks/index.parts-bzlq2foymrigspiz.js +81 -0
  125. package/dist/chunks/index.parts-c4kz48uuogge3k9g.js +1462 -0
  126. package/dist/chunks/index.parts-cou5w8shwfwuk6wo.js +128 -0
  127. package/dist/chunks/index.parts-etb66t5m85rhhipe.js +11 -0
  128. package/dist/chunks/index.parts-f3xvfc67ai7txeru.js +127 -0
  129. package/dist/chunks/index.parts-g0wrrbkxyh0oo730.js +171 -0
  130. package/dist/chunks/index.parts-g27bw668q8dtcjz8.js +1229 -0
  131. package/dist/chunks/index.parts-gcwd6ds0od2n1i0p.js +10 -0
  132. package/dist/chunks/index.parts-ghwrm31fyo614381.js +23 -0
  133. package/dist/chunks/index.parts-giu46tgp0ypgfq6a.js +88 -0
  134. package/dist/chunks/index.parts-hi0bbzsnswj74v28.js +11 -0
  135. package/dist/chunks/index.parts-ixizrcasario34jo.js +213 -0
  136. package/dist/chunks/index.parts-j775zfdbhcd9ypeb.js +41 -0
  137. package/dist/chunks/index.parts-jmkwypigix07dit1.js +119 -0
  138. package/dist/chunks/index.parts-kdoulw17e9zk96yw.js +156 -0
  139. package/dist/chunks/index.parts-kh9waplhfwlszcyp.js +245 -0
  140. package/dist/chunks/index.parts-kwqb2nzc7u2zzxqs.js +2464 -0
  141. package/dist/chunks/index.parts-kwx43zlomuu96clc.js +46 -0
  142. package/dist/chunks/index.parts-lojnx790s6z0mi1f.js +388 -0
  143. package/dist/chunks/index.parts-n6t1aj932fytioz8.js +692 -0
  144. package/dist/chunks/index.parts-ngc39crwuz80oiij.js +13 -0
  145. package/dist/chunks/index.parts-nq06i1gji6fjnmln.js +192 -0
  146. package/dist/chunks/index.parts-omt7bu8mbte48ulb.js +73 -0
  147. package/dist/chunks/index.parts-pb65142mbin4hpc7.js +564 -0
  148. package/dist/chunks/index2.parts-k2au6nzued1wgy6t.js +95 -0
  149. package/dist/chunks/index2.parts-noiw2eweufmplfsp.js +10 -0
  150. package/dist/chunks/inertValue-f9pgp32jxnm88df3.js +9 -0
  151. package/dist/chunks/input-dwl9oy1f1ufah0bx.js +145 -0
  152. package/dist/chunks/input-group-otq3m9lach1jyxl0.js +452 -0
  153. package/dist/chunks/input-o3mtvvtqf69j5k10.js +85 -0
  154. package/dist/chunks/isElementDisabled-ffsy1y4adxocmexb.js +7 -0
  155. package/dist/chunks/javascript-b6fq9bl50fdj6813.js +4 -0
  156. package/dist/chunks/json-h2g0z143t3cs13d7.js +4 -0
  157. package/dist/chunks/jsonc-jxlzvingck161eej.js +4 -0
  158. package/dist/chunks/jsx-jp7a33937sef92sn.js +4 -0
  159. package/dist/chunks/label-opyibemromjwmd0s.js +72 -0
  160. package/dist/chunks/layer-card-nah241sxhj6i7i03.js +72 -0
  161. package/dist/chunks/link-1b3jda6cdzl4lkeo.js +112 -0
  162. package/dist/chunks/link-provider-l9ohtet4pj559eg0.js +60 -0
  163. package/dist/chunks/loader-j2v6fab8iucuxz1z.js +91 -0
  164. package/dist/chunks/markdown-eybeqjr58vfygtz1.js +4 -0
  165. package/dist/chunks/menubar-m0h31eymts6exeke.js +103 -0
  166. package/dist/chunks/mergeCleanups-pexn3wul6a4zn873.js +15 -0
  167. package/dist/chunks/meter-iauic8ww87xxqf74.js +35 -0
  168. package/dist/chunks/pagination-k0yll9ynbi8flc3b.js +290 -0
  169. package/dist/chunks/popover-l0xg7b854w7txyoz.js +152 -0
  170. package/dist/chunks/popupStateMapping-jpzw7eyzl8ghiv8s.js +868 -0
  171. package/dist/chunks/popupStoreUtils-fpjh6veok5pa2hd1.js +367 -0
  172. package/dist/chunks/portal-provider-langu3fqwfr9tlhm.js +59 -0
  173. package/dist/chunks/python-nrpnmxq4r6yp6fcd.js +4 -0
  174. package/dist/chunks/radio-igpo6t2t2tpe08d5.js +173 -0
  175. package/dist/chunks/resolve-variant-l6x5ksfrjtu4m66l.js +35 -0
  176. package/dist/chunks/resolveAriaLabelledBy-h9qwvo10ftlj6t9k.js +10 -0
  177. package/dist/chunks/resolveValueLabel-i36fqhi09ki67hx5.js +89 -0
  178. package/dist/chunks/rolldown-runtime-hi7ti5xiuxsegr96.js +18 -0
  179. package/dist/chunks/safePolygon-flrfpyc6fpidq4fb.js +659 -0
  180. package/dist/chunks/safeReact-bavzz23j5tex60z2.js +18 -0
  181. package/dist/chunks/select-ln6ibqbbs0n4tiig.js +262 -0
  182. package/dist/chunks/sensitive-input-karaei12un7z7nep.js +256 -0
  183. package/dist/chunks/serializeValue-ci3kihruew64i36f.js +13 -0
  184. package/dist/chunks/shellscript-i4m7lo8wi0f5bl8b.js +4 -0
  185. package/dist/chunks/sidebar-kvjzu0ya0b2z6eec.js +1297 -0
  186. package/dist/chunks/skeleton-line-f6sju1dxawm8h9tg.js +40 -0
  187. package/dist/chunks/sql-do9h6435gka97c4c.js +4 -0
  188. package/dist/chunks/store-i9l3lkcl6auhkpfl.js +88 -0
  189. package/dist/chunks/stringifyLocale-cl8et9xf6zon4qbs.js +9 -0
  190. package/dist/chunks/styles-dbhgpd8fm76fdfo3.js +35 -0
  191. package/dist/chunks/surface-jwwh5xl06kv9tp7b.js +30 -0
  192. package/dist/chunks/switch-cusffup6w3tan5ot.js +202 -0
  193. package/dist/chunks/table-ds3nzcffm3pu9o0l.js +238 -0
  194. package/dist/chunks/table-of-contents-l66abisn473qzd07.js +231 -0
  195. package/dist/chunks/tabs-dz3fsnkrznrggilz.js +255 -0
  196. package/dist/chunks/text-e1ko7r96hsoz2tor.js +109 -0
  197. package/dist/chunks/toast-itl6qo5oy1vy6d36.js +324 -0
  198. package/dist/chunks/toml-oyqrgosuct25x413.js +4 -0
  199. package/dist/chunks/toolbar-gwd1orc8yl7lzaou.js +127 -0
  200. package/dist/chunks/tooltip-maelyxs1y7a78vje.js +90 -0
  201. package/dist/chunks/tsx-pem8x69upvmibv6l.js +4 -0
  202. package/dist/chunks/typescript-pe5y016phdwbgws7.js +4 -0
  203. package/dist/chunks/useAnchoredPopupScrollLock-bx8vvwcdp25ix0kj.js +31 -0
  204. package/dist/chunks/useAnimationFrame-ssgc72hyq6sg3yit.js +86 -0
  205. package/dist/chunks/useAriaLabelledBy-bvw56m1d7czf0w3f.js +38 -0
  206. package/dist/chunks/useBaseUiId-gqkl5ep5pn6hd0rw.js +13 -0
  207. package/dist/chunks/useButton-cpo6u2idqcnou6vy.js +149 -0
  208. package/dist/chunks/useClick-fvwb39qgead2jyft.js +86 -0
  209. package/dist/chunks/useCollapsiblePanel-bw63vwvq9a3sj73q.js +379 -0
  210. package/dist/chunks/useCompositeItem-esr3n4pmlssiuxuy.js +31 -0
  211. package/dist/chunks/useCompositeListItem-0exfww37ospqz69b.js +75 -0
  212. package/dist/chunks/useControlled-nlx0kk1ksgk0auvi.js +52 -0
  213. package/dist/chunks/useDismiss-l2gbj4cain4zqtne.js +353 -0
  214. package/dist/chunks/useFilteredItems-ckor5h4rcmztfgt1.js +183 -0
  215. package/dist/chunks/useFloatingRootContext-jo582qzez5k9gbgk.js +51 -0
  216. package/dist/chunks/useFocus-e8drzpkl9flxq1o1.js +122 -0
  217. package/dist/chunks/useForcedRerendering-el1fbg3ib5yo0v7k.js +14 -0
  218. package/dist/chunks/useId-l9soitgw3e4jk5ie.js +32 -0
  219. package/dist/chunks/useIsHydrating-b6whcsimonagru6u.js +22 -0
  220. package/dist/chunks/useLabel-nh9hf8h7o6oquqn5.js +47 -0
  221. package/dist/chunks/useLabelableId-b1kwq9st3rjrtakn.js +60 -0
  222. package/dist/chunks/useListNavigation-iyo9r9vug2g1clmc.js +447 -0
  223. package/dist/chunks/useOnMount-j4wobeq47l3u9olo.js +12 -0
  224. package/dist/chunks/useOpenChangeComplete-dpkex2e23s1evpol.js +117 -0
  225. package/dist/chunks/usePopupViewport-at3zpph46apa78a3.js +343 -0
  226. package/dist/chunks/usePositioner-h1n5q86am1sjo5hn.js +602 -0
  227. package/dist/chunks/usePreviousValue-le0grv8f43vmunn1.js +21 -0
  228. package/dist/chunks/useRegisterFieldControl-m1rxsuvtpau2341n.js +34 -0
  229. package/dist/chunks/useRegisteredLabelId-dh83mybmzy75waje.js +16 -0
  230. package/dist/chunks/useRender-gtnbrp1ityffi4xf.js +13 -0
  231. package/dist/chunks/useRenderDialogRoot-ecyv072j7yj8q0w3.js +262 -0
  232. package/dist/chunks/useRenderElement-m8kc7jyuczp71mq8.js +433 -0
  233. package/dist/chunks/useScrollLock-lj0spjth12xjeap0.js +854 -0
  234. package/dist/chunks/useStableCallback-ninxmksdjvwl6ejj.js +38 -0
  235. package/dist/chunks/useSwipeDismiss-bpbyw2ihsw3fw6y9.js +818 -0
  236. package/dist/chunks/useTimeout-oqptmu2xmyv5ccic.js +43 -0
  237. package/dist/chunks/useTransitionStatus-ig4waxl2kervpyw4.js +66 -0
  238. package/dist/chunks/useTriggerFocusGuards-j8nano0pqu9dscrz.js +49 -0
  239. package/dist/chunks/useTypeahead-onenwjyhgw955ygx.js +114 -0
  240. package/dist/chunks/useValueAsRef-lrn42zari17368c9.js +27 -0
  241. package/dist/chunks/useValueChanged-kthmz4wk7ywnjwtx.js +18 -0
  242. package/dist/chunks/utils-0i7gujfv3f3e9dqh.js +19 -0
  243. package/dist/chunks/valueToPercent-henpkkj3juy3ukeu.js +7 -0
  244. package/dist/chunks/vendor-floating-ui-dsysdmve7iazaaes.js +1558 -0
  245. package/dist/chunks/vendor-styling-da1xibnxfkjmtglr.js +3631 -0
  246. package/dist/chunks/vendor-utils-luqsvbyuig727bnr.js +512 -0
  247. package/dist/chunks/vesper-ho3j3gt6ilwfuc1g.js +5 -0
  248. package/dist/chunks/visuallyHidden-n14xllazfozg55ox.js +24 -0
  249. package/dist/chunks/wasm-nfbosyhilcq70atf.js +8 -0
  250. package/dist/chunks/yaml-kzk5ddyekbyha04v.js +4 -0
  251. package/dist/cn-DCSItmT-.d.ts +5 -0
  252. package/dist/code/server.d.ts +97 -0
  253. package/dist/code/server.js +146 -84
  254. package/dist/code.d.ts +82 -0
  255. package/dist/code.js +348 -248
  256. package/dist/components/autocomplete.d.ts +2 -0
  257. package/dist/components/autocomplete.js +2 -8
  258. package/dist/components/badge.d.ts +2 -0
  259. package/dist/components/badge.js +2 -6
  260. package/dist/components/banner.d.ts +2 -0
  261. package/dist/components/banner.js +2 -6
  262. package/dist/components/breadcrumbs.d.ts +2 -0
  263. package/dist/components/breadcrumbs.js +2 -8
  264. package/dist/components/button.d.ts +3 -0
  265. package/dist/components/button.js +2 -8
  266. package/dist/components/chart.d.ts +2 -0
  267. package/dist/components/chart.js +2 -11
  268. package/dist/components/checkbox.d.ts +2 -0
  269. package/dist/components/checkbox.js +2 -7
  270. package/dist/components/clipboard-text.d.ts +2 -0
  271. package/dist/components/clipboard-text.js +2 -5
  272. package/dist/components/cloudflare-logo.d.ts +2 -0
  273. package/dist/components/cloudflare-logo.js +2 -9
  274. package/dist/components/code.d.ts +2 -0
  275. package/dist/components/code.js +2 -6
  276. package/dist/components/collapsible.d.ts +2 -0
  277. package/dist/components/collapsible.js +2 -5
  278. package/dist/components/combobox.d.ts +2 -0
  279. package/dist/components/combobox.js +2 -5
  280. package/dist/components/command-palette.d.ts +2 -0
  281. package/dist/components/command-palette.js +2 -7
  282. package/dist/components/date-picker.d.ts +2 -0
  283. package/dist/components/date-picker.js +2 -5
  284. package/dist/components/date-range-picker.d.ts +2 -0
  285. package/dist/components/date-range-picker.js +2 -5
  286. package/dist/components/dialog.d.ts +2 -0
  287. package/dist/components/dialog.js +2 -10
  288. package/dist/components/dropdown.d.ts +2 -0
  289. package/dist/components/dropdown.js +2 -5
  290. package/dist/components/empty.d.ts +2 -0
  291. package/dist/components/empty.js +2 -8
  292. package/dist/components/field.d.ts +2 -0
  293. package/dist/components/field.js +2 -9
  294. package/dist/components/flow.d.ts +2 -0
  295. package/dist/components/flow.js +2 -5839
  296. package/dist/components/grid.d.ts +2 -0
  297. package/dist/components/grid.js +2 -10
  298. package/dist/components/input-group.d.ts +2 -0
  299. package/dist/components/input-group.js +2 -7
  300. package/dist/components/input.d.ts +4 -0
  301. package/dist/components/input.js +4 -13
  302. package/dist/components/label.d.ts +2 -0
  303. package/dist/components/label.js +2 -9
  304. package/dist/components/layer-card.d.ts +2 -0
  305. package/dist/components/layer-card.js +2 -5
  306. package/dist/components/link.d.ts +68 -0
  307. package/dist/components/link.js +2 -8
  308. package/dist/components/loader.d.ts +2 -0
  309. package/dist/components/loader.js +3 -7
  310. package/dist/components/menubar.d.ts +2 -0
  311. package/dist/components/menubar.js +2 -6
  312. package/dist/components/meter.d.ts +2 -0
  313. package/dist/components/meter.js +2 -5
  314. package/dist/components/pagination.d.ts +2 -0
  315. package/dist/components/pagination.js +2 -5
  316. package/dist/components/popover.d.ts +2 -0
  317. package/dist/components/popover.js +2 -13
  318. package/dist/components/radio.d.ts +2 -0
  319. package/dist/components/radio.js +2 -9
  320. package/dist/components/select.d.ts +2 -0
  321. package/dist/components/select.js +2 -5
  322. package/dist/components/sensitive-input.d.ts +2 -0
  323. package/dist/components/sensitive-input.js +2 -7
  324. package/dist/components/sidebar.d.ts +2 -0
  325. package/dist/components/sidebar.js +2 -33
  326. package/dist/components/surface.d.ts +2 -0
  327. package/dist/components/surface.js +2 -5
  328. package/dist/components/switch.d.ts +2 -0
  329. package/dist/components/switch.js +2 -7
  330. package/dist/components/table-of-contents.d.ts +2 -0
  331. package/dist/components/table-of-contents.js +2 -7
  332. package/dist/components/table.d.ts +2 -0
  333. package/dist/components/table.js +2 -7
  334. package/dist/components/tabs.d.ts +2 -0
  335. package/dist/components/tabs.js +2 -5
  336. package/dist/components/text.d.ts +2 -0
  337. package/dist/components/text.js +2 -5
  338. package/dist/components/toast.d.ts +2 -0
  339. package/dist/components/toast.js +3 -10
  340. package/dist/components/toolbar.d.ts +2 -0
  341. package/dist/components/toolbar.js +2 -7
  342. package/dist/components/tooltip.d.ts +2 -0
  343. package/dist/components/tooltip.js +2 -6
  344. package/dist/field-DIjlHM8W.d.ts +91 -0
  345. package/dist/index-AMEc1MEg2.d.ts +180 -0
  346. package/dist/index-B-hCpI5K.d.ts +1 -0
  347. package/dist/index-B6LJIy7_2.d.ts +52 -0
  348. package/dist/index-B9niVl3r.d.ts +140 -0
  349. package/dist/index-BAQwS4mL.d.ts +70 -0
  350. package/dist/index-BD-gTiEv.d.ts +71 -0
  351. package/dist/index-BVgXnR1V.d.ts +137 -0
  352. package/dist/index-Bgl_czT12.d.ts +140 -0
  353. package/dist/index-BkyMHk632.d.ts +110 -0
  354. package/dist/index-BlEUcijd.d.ts +795 -0
  355. package/dist/index-BoPqM1Ia2.d.ts +179 -0
  356. package/dist/index-BzE0aNpx.d.ts +143 -0
  357. package/dist/index-C3iraF8M2.d.ts +100 -0
  358. package/dist/index-CGbkysYW2.d.ts +161 -0
  359. package/dist/index-CLsBWiaS.d.ts +79 -0
  360. package/dist/index-CSWbPhke.d.ts +126 -0
  361. package/dist/index-CYoiniZ4.d.ts +135 -0
  362. package/dist/index-CeBzVJP8.d.ts +426 -0
  363. package/dist/index-ClS-eFxE.d.ts +104 -0
  364. package/dist/index-Cp0aQngm.d.ts +182 -0
  365. package/dist/index-CzIWigmH.d.ts +62 -0
  366. package/dist/index-CzTgKPh-.d.ts +105 -0
  367. package/dist/index-D-y1ktn-.d.ts +68 -0
  368. package/dist/index-D2Gvly0i2.d.ts +96 -0
  369. package/dist/index-DBlw3E9m.d.ts +166 -0
  370. package/dist/index-DCA5tjHa.d.ts +68 -0
  371. package/dist/index-DIV3riUd2.d.ts +148 -0
  372. package/dist/index-DJIRVD5B.d.ts +85 -0
  373. package/dist/index-DUCaDjfd.d.ts +240 -0
  374. package/dist/index-Di3sC6UF.d.ts +91 -0
  375. package/dist/index-DnbdiagK.d.ts +171 -0
  376. package/dist/index-DpzpArsi2.d.ts +614 -0
  377. package/dist/index-Dsn2VLZv.d.ts +238 -0
  378. package/dist/index-FZvrMcIo2.d.ts +158 -0
  379. package/dist/index-J1qdw9mL.d.ts +188 -0
  380. package/dist/index-Vj9ZzRh0.d.ts +66 -0
  381. package/dist/index-bAud6rG22.d.ts +278 -0
  382. package/dist/index-lOWfpkxK.d.ts +118 -0
  383. package/dist/index-yK3Hayg_.d.ts +40 -0
  384. package/dist/index.d.ts +102 -0
  385. package/dist/index.js +195 -348
  386. package/dist/input-BeWEb-jD.d.ts +122 -0
  387. package/dist/input-group-DpGSsAZy.d.ts +100 -0
  388. package/dist/layer-card-BNIn9pqy.d.ts +56 -0
  389. package/dist/link-provider-tz-NJp9x.d.ts +67 -0
  390. package/dist/portal-provider-4AHCxYE6.d.ts +51 -0
  391. package/dist/primitives/accordion.d.ts +1 -0
  392. package/dist/primitives/accordion.js +2 -5
  393. package/dist/primitives/alert-dialog.d.ts +1 -0
  394. package/dist/primitives/alert-dialog.js +2 -5
  395. package/dist/primitives/autocomplete.d.ts +1 -0
  396. package/dist/primitives/autocomplete.js +2 -5
  397. package/dist/primitives/avatar.d.ts +1 -0
  398. package/dist/primitives/avatar.js +2 -5
  399. package/dist/primitives/button.d.ts +1 -0
  400. package/dist/primitives/button.js +2 -5
  401. package/dist/primitives/checkbox-group.d.ts +1 -0
  402. package/dist/primitives/checkbox-group.js +2 -5
  403. package/dist/primitives/checkbox.d.ts +1 -0
  404. package/dist/primitives/checkbox.js +2 -5
  405. package/dist/primitives/collapsible.d.ts +1 -0
  406. package/dist/primitives/collapsible.js +2 -5
  407. package/dist/primitives/combobox.d.ts +1 -0
  408. package/dist/primitives/combobox.js +2 -5
  409. package/dist/primitives/context-menu.d.ts +1 -0
  410. package/dist/primitives/context-menu.js +2 -5
  411. package/dist/primitives/csp-provider.d.ts +1 -0
  412. package/dist/primitives/csp-provider.js +2 -5
  413. package/dist/primitives/dialog.d.ts +1 -0
  414. package/dist/primitives/dialog.js +2 -5
  415. package/dist/primitives/direction-provider.d.ts +1 -0
  416. package/dist/primitives/direction-provider.js +3 -6
  417. package/dist/primitives/drawer.d.ts +1 -0
  418. package/dist/primitives/drawer.js +2 -5
  419. package/dist/primitives/field.d.ts +1 -0
  420. package/dist/primitives/field.js +2 -5
  421. package/dist/primitives/fieldset.d.ts +1 -0
  422. package/dist/primitives/fieldset.js +2 -5
  423. package/dist/primitives/form.d.ts +1 -0
  424. package/dist/primitives/form.js +2 -5
  425. package/dist/primitives/input.d.ts +1 -0
  426. package/dist/primitives/input.js +2 -5
  427. package/dist/primitives/menu.d.ts +1 -0
  428. package/dist/primitives/menu.js +2 -5
  429. package/dist/primitives/menubar.d.ts +1 -0
  430. package/dist/primitives/menubar.js +2 -5
  431. package/dist/primitives/meter.d.ts +1 -0
  432. package/dist/primitives/meter.js +2 -5
  433. package/dist/primitives/navigation-menu.d.ts +1 -0
  434. package/dist/primitives/navigation-menu.js +2 -5
  435. package/dist/primitives/number-field.d.ts +1 -0
  436. package/dist/primitives/number-field.js +2 -5
  437. package/dist/primitives/otp-field.d.ts +3 -0
  438. package/dist/primitives/otp-field.js +2 -6
  439. package/dist/primitives/popover.d.ts +1 -0
  440. package/dist/primitives/popover.js +2 -5
  441. package/dist/primitives/preview-card.d.ts +1 -0
  442. package/dist/primitives/preview-card.js +2 -5
  443. package/dist/primitives/progress.d.ts +1 -0
  444. package/dist/primitives/progress.js +2 -5
  445. package/dist/primitives/radio-group.d.ts +1 -0
  446. package/dist/primitives/radio-group.js +2 -5
  447. package/dist/primitives/radio.d.ts +1 -0
  448. package/dist/primitives/radio.js +2 -5
  449. package/dist/primitives/scroll-area.d.ts +1 -0
  450. package/dist/primitives/scroll-area.js +2 -5
  451. package/dist/primitives/select.d.ts +1 -0
  452. package/dist/primitives/select.js +2 -5
  453. package/dist/primitives/separator.d.ts +1 -0
  454. package/dist/primitives/separator.js +2 -5
  455. package/dist/primitives/slider.d.ts +1 -0
  456. package/dist/primitives/slider.js +2 -5
  457. package/dist/primitives/switch.d.ts +1 -0
  458. package/dist/primitives/switch.js +2 -5
  459. package/dist/primitives/tabs.d.ts +1 -0
  460. package/dist/primitives/tabs.js +2 -5
  461. package/dist/primitives/toast.d.ts +1 -0
  462. package/dist/primitives/toast.js +2 -5
  463. package/dist/primitives/toggle-group.d.ts +1 -0
  464. package/dist/primitives/toggle-group.js +2 -5
  465. package/dist/primitives/toggle.d.ts +1 -0
  466. package/dist/primitives/toggle.js +2 -5
  467. package/dist/primitives/toolbar.d.ts +1 -0
  468. package/dist/primitives/toolbar.js +2 -5
  469. package/dist/primitives/tooltip.d.ts +1 -0
  470. package/dist/primitives/tooltip.js +2 -5
  471. package/dist/primitives.d.ts +42 -0
  472. package/dist/primitives.js +42 -46
  473. package/dist/registry.d.ts +2 -0
  474. package/dist/registry.js +0 -1
  475. package/dist/scripts/theme-generator/config.d.ts +7 -5
  476. package/dist/scripts/theme-generator/config.js +475 -627
  477. package/dist/scripts/theme-generator/types.d.ts +51 -49
  478. package/dist/scripts/theme-generator/types.js +0 -1
  479. package/dist/styles/kumo-binding.css +35 -8
  480. package/dist/styles/kumo-standalone.css +1 -1
  481. package/dist/styles/kumo.css +3 -5
  482. package/dist/styles/theme-fedramp.css +7 -15
  483. package/dist/styles/theme-kumo.css +101 -56
  484. package/dist/tooltip-BuCo6Ki4.d.ts +105 -0
  485. package/dist/types-C402rKiz.d.ts +132 -0
  486. package/dist/types-CdzJnnIl.d.ts +193 -0
  487. package/dist/utils.d.ts +4 -0
  488. package/dist/utils.js +5 -12
  489. package/package.json +231 -232
  490. package/scripts/component-registry/discovery.ts +87 -0
  491. package/scripts/component-registry/index.test.ts +90 -2
  492. package/scripts/component-registry/index.ts +27 -2
  493. package/scripts/component-registry/metadata.ts +3 -4
  494. package/scripts/component-registry/props-filter.ts +3 -1
  495. package/scripts/component-registry/sub-components.ts +34 -21
  496. package/scripts/component-registry/variant-parser.ts +1 -0
  497. package/scripts/generate-primitives.ts +1 -1
  498. package/scripts/theme-generator/config.ts +21 -22
  499. package/scripts/theme-generator/generate-css.test.ts +1 -1
  500. package/dist/ai/schemas.d.ts.map +0 -1
  501. package/dist/ai/schemas.js.map +0 -1
  502. package/dist/catalog.js.map +0 -1
  503. package/dist/chunks/Maps-fkiyllhs5w0qzw1y.js +0 -2155
  504. package/dist/chunks/Maps-fkiyllhs5w0qzw1y.js.map +0 -1
  505. package/dist/chunks/autocomplete-a4gvspveibfuod24.js +0 -193
  506. package/dist/chunks/autocomplete-a4gvspveibfuod24.js.map +0 -1
  507. package/dist/chunks/badge-dfc1r37osagi3rs4.js +0 -163
  508. package/dist/chunks/badge-dfc1r37osagi3rs4.js.map +0 -1
  509. package/dist/chunks/banner-j52y8l13puk7dybi.js +0 -120
  510. package/dist/chunks/banner-j52y8l13puk7dybi.js.map +0 -1
  511. package/dist/chunks/bash-g5z23u7me5rx7bzt.js +0 -15
  512. package/dist/chunks/bash-g5z23u7me5rx7bzt.js.map +0 -1
  513. package/dist/chunks/breadcrumbs-js59m7m57bdsveew.js +0 -169
  514. package/dist/chunks/breadcrumbs-js59m7m57bdsveew.js.map +0 -1
  515. package/dist/chunks/button-ebfdg9mkhojue36n.js +0 -237
  516. package/dist/chunks/button-ebfdg9mkhojue36n.js.map +0 -1
  517. package/dist/chunks/checkbox-k355pnfisqt0h4eg.js +0 -216
  518. package/dist/chunks/checkbox-k355pnfisqt0h4eg.js.map +0 -1
  519. package/dist/chunks/clipboard-text-isb05zkg2aox0tp6.js +0 -191
  520. package/dist/chunks/clipboard-text-isb05zkg2aox0tp6.js.map +0 -1
  521. package/dist/chunks/cloudflare-logo-fiuocxdxqrxawjfv.js +0 -175
  522. package/dist/chunks/cloudflare-logo-fiuocxdxqrxawjfv.js.map +0 -1
  523. package/dist/chunks/cn-bo7ya7641lkickbt.js +0 -22
  524. package/dist/chunks/cn-bo7ya7641lkickbt.js.map +0 -1
  525. package/dist/chunks/code-pbkfdfat0yilg6dx.js +0 -61
  526. package/dist/chunks/code-pbkfdfat0yilg6dx.js.map +0 -1
  527. package/dist/chunks/collapsible-f9hgtc1u6xvqrgt8.js +0 -76
  528. package/dist/chunks/collapsible-f9hgtc1u6xvqrgt8.js.map +0 -1
  529. package/dist/chunks/combobox-hc9wi9nwsyyli8ur.js +0 -408
  530. package/dist/chunks/combobox-hc9wi9nwsyyli8ur.js.map +0 -1
  531. package/dist/chunks/command-palette-c03zze4ayuytwxjg.js +0 -403
  532. package/dist/chunks/command-palette-c03zze4ayuytwxjg.js.map +0 -1
  533. package/dist/chunks/core-dyku7qctyc40nnhh.js +0 -5464
  534. package/dist/chunks/core-dyku7qctyc40nnhh.js.map +0 -1
  535. package/dist/chunks/css-d1mi3wy1sl3fzekh.js +0 -8
  536. package/dist/chunks/css-d1mi3wy1sl3fzekh.js.map +0 -1
  537. package/dist/chunks/date-picker-bffp889exjixmgz3.js +0 -2921
  538. package/dist/chunks/date-picker-bffp889exjixmgz3.js.map +0 -1
  539. package/dist/chunks/date-range-picker-oks2r14lbbukd545.js +0 -408
  540. package/dist/chunks/date-range-picker-oks2r14lbbukd545.js.map +0 -1
  541. package/dist/chunks/dialog-ovhmzfuppr5xix0e.js +0 -134
  542. package/dist/chunks/dialog-ovhmzfuppr5xix0e.js.map +0 -1
  543. package/dist/chunks/diff-cpj1h9lg0bw716mj.js +0 -8
  544. package/dist/chunks/diff-cpj1h9lg0bw716mj.js.map +0 -1
  545. package/dist/chunks/dropdown-iey8f344rd5dgahz.js +0 -321
  546. package/dist/chunks/dropdown-iey8f344rd5dgahz.js.map +0 -1
  547. package/dist/chunks/empty-k83r53jh5utqvv7w.js +0 -94
  548. package/dist/chunks/empty-k83r53jh5utqvv7w.js.map +0 -1
  549. package/dist/chunks/engine-javascript-hi1kqifa6nkcridk.js +0 -2638
  550. package/dist/chunks/engine-javascript-hi1kqifa6nkcridk.js.map +0 -1
  551. package/dist/chunks/engine-oniguruma-g75h8oxao68cjmhg.js +0 -295
  552. package/dist/chunks/engine-oniguruma-g75h8oxao68cjmhg.js.map +0 -1
  553. package/dist/chunks/field-bmglk138wa8bf3ei.js +0 -77
  554. package/dist/chunks/field-bmglk138wa8bf3ei.js.map +0 -1
  555. package/dist/chunks/github-light-ulev8flhimfg79ob.js +0 -6
  556. package/dist/chunks/github-light-ulev8flhimfg79ob.js.map +0 -1
  557. package/dist/chunks/graphql-ft2h47erta7isqn4.js +0 -16
  558. package/dist/chunks/graphql-ft2h47erta7isqn4.js.map +0 -1
  559. package/dist/chunks/grid-jze04557ljywg3uc.js +0 -128
  560. package/dist/chunks/grid-jze04557ljywg3uc.js.map +0 -1
  561. package/dist/chunks/hcl-hcu7d6ja6t540ijn.js +0 -8
  562. package/dist/chunks/hcl-hcu7d6ja6t540ijn.js.map +0 -1
  563. package/dist/chunks/html-kl304jmqj4jxj777.js +0 -12
  564. package/dist/chunks/html-kl304jmqj4jxj777.js.map +0 -1
  565. package/dist/chunks/input-area-ixtj4e8eny58nbf9.js +0 -78
  566. package/dist/chunks/input-area-ixtj4e8eny58nbf9.js.map +0 -1
  567. package/dist/chunks/input-ckl5misj0jd9cu5r.js +0 -130
  568. package/dist/chunks/input-ckl5misj0jd9cu5r.js.map +0 -1
  569. package/dist/chunks/input-group-bflx1m6ki55e99vf.js +0 -505
  570. package/dist/chunks/input-group-bflx1m6ki55e99vf.js.map +0 -1
  571. package/dist/chunks/javascript-hhx3avh9uv2o27ay.js +0 -8
  572. package/dist/chunks/javascript-hhx3avh9uv2o27ay.js.map +0 -1
  573. package/dist/chunks/json-jovp9qemdkp5cziz.js +0 -8
  574. package/dist/chunks/json-jovp9qemdkp5cziz.js.map +0 -1
  575. package/dist/chunks/jsonc-jbkkgjer6ispw2u3.js +0 -8
  576. package/dist/chunks/jsonc-jbkkgjer6ispw2u3.js.map +0 -1
  577. package/dist/chunks/jsx-ij885l2li2lzfoss.js +0 -8
  578. package/dist/chunks/jsx-ij885l2li2lzfoss.js.map +0 -1
  579. package/dist/chunks/label-i1xbmg8y1n0tbtkx.js +0 -68
  580. package/dist/chunks/label-i1xbmg8y1n0tbtkx.js.map +0 -1
  581. package/dist/chunks/layer-card-m6h85dpadvee39h2.js +0 -47
  582. package/dist/chunks/layer-card-m6h85dpadvee39h2.js.map +0 -1
  583. package/dist/chunks/link-j93fl5m8zrcfivsr.js +0 -95
  584. package/dist/chunks/link-j93fl5m8zrcfivsr.js.map +0 -1
  585. package/dist/chunks/link-provider-mn2voeohon7cj9o4.js +0 -22
  586. package/dist/chunks/link-provider-mn2voeohon7cj9o4.js.map +0 -1
  587. package/dist/chunks/loader-g8a6j76ue5nq0lr8.js +0 -109
  588. package/dist/chunks/loader-g8a6j76ue5nq0lr8.js.map +0 -1
  589. package/dist/chunks/markdown-n2vyyq7l68fy32wc.js +0 -8
  590. package/dist/chunks/markdown-n2vyyq7l68fy32wc.js.map +0 -1
  591. package/dist/chunks/menubar-opzxfzylaatfz4nv.js +0 -98
  592. package/dist/chunks/menubar-opzxfzylaatfz4nv.js.map +0 -1
  593. package/dist/chunks/meter-6br6z5ekw41trxeh.js +0 -51
  594. package/dist/chunks/meter-6br6z5ekw41trxeh.js.map +0 -1
  595. package/dist/chunks/pagination-j33ntwqmm9qskfgv.js +0 -266
  596. package/dist/chunks/pagination-j33ntwqmm9qskfgv.js.map +0 -1
  597. package/dist/chunks/popover-cqdmpp8i4hg8gzzx.js +0 -181
  598. package/dist/chunks/popover-cqdmpp8i4hg8gzzx.js.map +0 -1
  599. package/dist/chunks/portal-provider-hwmkdmkpvct0cb76.js +0 -18
  600. package/dist/chunks/portal-provider-hwmkdmkpvct0cb76.js.map +0 -1
  601. package/dist/chunks/python-gg755pb8oe9ra1d1.js +0 -8
  602. package/dist/chunks/python-gg755pb8oe9ra1d1.js.map +0 -1
  603. package/dist/chunks/radio-ejey7i6r4tq314av.js +0 -226
  604. package/dist/chunks/radio-ejey7i6r4tq314av.js.map +0 -1
  605. package/dist/chunks/resolve-variant-gw6eh7fa4st8ej7m.js +0 -11
  606. package/dist/chunks/resolve-variant-gw6eh7fa4st8ej7m.js.map +0 -1
  607. package/dist/chunks/select-p8adn2tnpom25hpl.js +0 -237
  608. package/dist/chunks/select-p8adn2tnpom25hpl.js.map +0 -1
  609. package/dist/chunks/sensitive-input-it1hsswlccq3u7g6.js +0 -273
  610. package/dist/chunks/sensitive-input-it1hsswlccq3u7g6.js.map +0 -1
  611. package/dist/chunks/sidebar-ctd980heycmxsux1.js +0 -1144
  612. package/dist/chunks/sidebar-ctd980heycmxsux1.js.map +0 -1
  613. package/dist/chunks/skeleton-line-omxgxia23vpav94x.js +0 -33
  614. package/dist/chunks/skeleton-line-omxgxia23vpav94x.js.map +0 -1
  615. package/dist/chunks/sql-ovukp5mrfunfk5tv.js +0 -8
  616. package/dist/chunks/sql-ovukp5mrfunfk5tv.js.map +0 -1
  617. package/dist/chunks/surface-gc2gblserrxcb1eg.js +0 -29
  618. package/dist/chunks/surface-gc2gblserrxcb1eg.js.map +0 -1
  619. package/dist/chunks/switch-ljsq915e0l1a5mjd.js +0 -256
  620. package/dist/chunks/switch-ljsq915e0l1a5mjd.js.map +0 -1
  621. package/dist/chunks/table-of-contents-cghjqyk43nj5zmlw.js +0 -106
  622. package/dist/chunks/table-of-contents-cghjqyk43nj5zmlw.js.map +0 -1
  623. package/dist/chunks/table-ojjjeqszmt9jgnug.js +0 -208
  624. package/dist/chunks/table-ojjjeqszmt9jgnug.js.map +0 -1
  625. package/dist/chunks/tabs-kemdy19kfesj2xjr.js +0 -177
  626. package/dist/chunks/tabs-kemdy19kfesj2xjr.js.map +0 -1
  627. package/dist/chunks/text-oqp48b9m5u6t62b4.js +0 -103
  628. package/dist/chunks/text-oqp48b9m5u6t62b4.js.map +0 -1
  629. package/dist/chunks/toast-ldj9zi940w83ub90.js +0 -386
  630. package/dist/chunks/toast-ldj9zi940w83ub90.js.map +0 -1
  631. package/dist/chunks/toml-nczb2z9n0o23o3ci.js +0 -8
  632. package/dist/chunks/toml-nczb2z9n0o23o3ci.js.map +0 -1
  633. package/dist/chunks/toolbar-lmylyrod70sn0q4i.js +0 -172
  634. package/dist/chunks/toolbar-lmylyrod70sn0q4i.js.map +0 -1
  635. package/dist/chunks/tooltip-mooldq78tg77ekvv.js +0 -103
  636. package/dist/chunks/tooltip-mooldq78tg77ekvv.js.map +0 -1
  637. package/dist/chunks/tsx-ehy8lrzet6v54zur.js +0 -8
  638. package/dist/chunks/tsx-ehy8lrzet6v54zur.js.map +0 -1
  639. package/dist/chunks/typescript-k4ggjrxhrhcdni6u.js +0 -8
  640. package/dist/chunks/typescript-k4ggjrxhrhcdni6u.js.map +0 -1
  641. package/dist/chunks/vendor-base-ui-elpbzr8xeffrz4h2.js +0 -25027
  642. package/dist/chunks/vendor-base-ui-elpbzr8xeffrz4h2.js.map +0 -1
  643. package/dist/chunks/vendor-floating-ui-k1zjlb8fkwtcw4k5.js +0 -1310
  644. package/dist/chunks/vendor-floating-ui-k1zjlb8fkwtcw4k5.js.map +0 -1
  645. package/dist/chunks/vendor-styling-ofvnbcuht98q88oo.js +0 -3252
  646. package/dist/chunks/vendor-styling-ofvnbcuht98q88oo.js.map +0 -1
  647. package/dist/chunks/vendor-utils-m5h2xu7s2rs3pgk5.js +0 -217
  648. package/dist/chunks/vendor-utils-m5h2xu7s2rs3pgk5.js.map +0 -1
  649. package/dist/chunks/vesper-ebfu9ns65f2v830s.js +0 -6
  650. package/dist/chunks/vesper-ebfu9ns65f2v830s.js.map +0 -1
  651. package/dist/chunks/wasm-oj22f8usru9h7dzg.js +0 -9
  652. package/dist/chunks/wasm-oj22f8usru9h7dzg.js.map +0 -1
  653. package/dist/chunks/yaml-e2v22lr79tss2brj.js +0 -8
  654. package/dist/chunks/yaml-e2v22lr79tss2brj.js.map +0 -1
  655. package/dist/code/server.js.map +0 -1
  656. package/dist/code.js.map +0 -1
  657. package/dist/components/autocomplete.js.map +0 -1
  658. package/dist/components/badge.js.map +0 -1
  659. package/dist/components/banner.js.map +0 -1
  660. package/dist/components/breadcrumbs.js.map +0 -1
  661. package/dist/components/button.js.map +0 -1
  662. package/dist/components/chart.js.map +0 -1
  663. package/dist/components/checkbox.js.map +0 -1
  664. package/dist/components/clipboard-text.js.map +0 -1
  665. package/dist/components/cloudflare-logo.js.map +0 -1
  666. package/dist/components/code.js.map +0 -1
  667. package/dist/components/collapsible.js.map +0 -1
  668. package/dist/components/combobox.js.map +0 -1
  669. package/dist/components/command-palette.js.map +0 -1
  670. package/dist/components/date-picker.js.map +0 -1
  671. package/dist/components/date-range-picker.js.map +0 -1
  672. package/dist/components/dialog.js.map +0 -1
  673. package/dist/components/dropdown.js.map +0 -1
  674. package/dist/components/empty.js.map +0 -1
  675. package/dist/components/field.js.map +0 -1
  676. package/dist/components/flow.js.map +0 -1
  677. package/dist/components/grid.js.map +0 -1
  678. package/dist/components/input-group.js.map +0 -1
  679. package/dist/components/input.js.map +0 -1
  680. package/dist/components/label.js.map +0 -1
  681. package/dist/components/layer-card.js.map +0 -1
  682. package/dist/components/link.js.map +0 -1
  683. package/dist/components/loader.js.map +0 -1
  684. package/dist/components/menubar.js.map +0 -1
  685. package/dist/components/meter.js.map +0 -1
  686. package/dist/components/pagination.js.map +0 -1
  687. package/dist/components/popover.js.map +0 -1
  688. package/dist/components/radio.js.map +0 -1
  689. package/dist/components/select.js.map +0 -1
  690. package/dist/components/sensitive-input.js.map +0 -1
  691. package/dist/components/sidebar.js.map +0 -1
  692. package/dist/components/surface.js.map +0 -1
  693. package/dist/components/switch.js.map +0 -1
  694. package/dist/components/table-of-contents.js.map +0 -1
  695. package/dist/components/table.js.map +0 -1
  696. package/dist/components/tabs.js.map +0 -1
  697. package/dist/components/text.js.map +0 -1
  698. package/dist/components/toast.js.map +0 -1
  699. package/dist/components/toolbar.js.map +0 -1
  700. package/dist/components/tooltip.js.map +0 -1
  701. package/dist/index.js.map +0 -1
  702. package/dist/primitives/accordion.js.map +0 -1
  703. package/dist/primitives/alert-dialog.js.map +0 -1
  704. package/dist/primitives/autocomplete.js.map +0 -1
  705. package/dist/primitives/avatar.js.map +0 -1
  706. package/dist/primitives/button.js.map +0 -1
  707. package/dist/primitives/checkbox-group.js.map +0 -1
  708. package/dist/primitives/checkbox.js.map +0 -1
  709. package/dist/primitives/collapsible.js.map +0 -1
  710. package/dist/primitives/combobox.js.map +0 -1
  711. package/dist/primitives/context-menu.js.map +0 -1
  712. package/dist/primitives/csp-provider.js.map +0 -1
  713. package/dist/primitives/dialog.js.map +0 -1
  714. package/dist/primitives/direction-provider.js.map +0 -1
  715. package/dist/primitives/drawer.js.map +0 -1
  716. package/dist/primitives/field.js.map +0 -1
  717. package/dist/primitives/fieldset.js.map +0 -1
  718. package/dist/primitives/form.js.map +0 -1
  719. package/dist/primitives/input.js.map +0 -1
  720. package/dist/primitives/menu.js.map +0 -1
  721. package/dist/primitives/menubar.js.map +0 -1
  722. package/dist/primitives/meter.js.map +0 -1
  723. package/dist/primitives/navigation-menu.js.map +0 -1
  724. package/dist/primitives/number-field.js.map +0 -1
  725. package/dist/primitives/otp-field.js.map +0 -1
  726. package/dist/primitives/popover.js.map +0 -1
  727. package/dist/primitives/preview-card.js.map +0 -1
  728. package/dist/primitives/progress.js.map +0 -1
  729. package/dist/primitives/radio-group.js.map +0 -1
  730. package/dist/primitives/radio.js.map +0 -1
  731. package/dist/primitives/scroll-area.js.map +0 -1
  732. package/dist/primitives/select.js.map +0 -1
  733. package/dist/primitives/separator.js.map +0 -1
  734. package/dist/primitives/slider.js.map +0 -1
  735. package/dist/primitives/switch.js.map +0 -1
  736. package/dist/primitives/tabs.js.map +0 -1
  737. package/dist/primitives/toast.js.map +0 -1
  738. package/dist/primitives/toggle-group.js.map +0 -1
  739. package/dist/primitives/toggle.js.map +0 -1
  740. package/dist/primitives/toolbar.js.map +0 -1
  741. package/dist/primitives/tooltip.js.map +0 -1
  742. package/dist/primitives.js.map +0 -1
  743. package/dist/registry.js.map +0 -1
  744. package/dist/scripts/theme-generator/config.d.ts.map +0 -1
  745. package/dist/scripts/theme-generator/config.js.map +0 -1
  746. package/dist/scripts/theme-generator/generate-css.d.ts +0 -31
  747. package/dist/scripts/theme-generator/generate-css.d.ts.map +0 -1
  748. package/dist/scripts/theme-generator/index.d.ts +0 -13
  749. package/dist/scripts/theme-generator/index.d.ts.map +0 -1
  750. package/dist/scripts/theme-generator/migrate.d.ts +0 -56
  751. package/dist/scripts/theme-generator/migrate.d.ts.map +0 -1
  752. package/dist/scripts/theme-generator/types.d.ts.map +0 -1
  753. package/dist/scripts/theme-generator/types.js.map +0 -1
  754. package/dist/src/blocks/delete-resource/delete-resource.d.ts +0 -46
  755. package/dist/src/blocks/delete-resource/delete-resource.d.ts.map +0 -1
  756. package/dist/src/blocks/delete-resource/index.d.ts +0 -2
  757. package/dist/src/blocks/delete-resource/index.d.ts.map +0 -1
  758. package/dist/src/blocks/page-header/index.d.ts +0 -2
  759. package/dist/src/blocks/page-header/index.d.ts.map +0 -1
  760. package/dist/src/blocks/page-header/page-header.d.ts +0 -38
  761. package/dist/src/blocks/page-header/page-header.d.ts.map +0 -1
  762. package/dist/src/blocks/resource-list/index.d.ts +0 -2
  763. package/dist/src/blocks/resource-list/index.d.ts.map +0 -1
  764. package/dist/src/blocks/resource-list/resource-list.d.ts +0 -18
  765. package/dist/src/blocks/resource-list/resource-list.d.ts.map +0 -1
  766. package/dist/src/catalog/catalog.d.ts +0 -75
  767. package/dist/src/catalog/catalog.d.ts.map +0 -1
  768. package/dist/src/catalog/data.d.ts +0 -44
  769. package/dist/src/catalog/data.d.ts.map +0 -1
  770. package/dist/src/catalog/index.d.ts +0 -39
  771. package/dist/src/catalog/index.d.ts.map +0 -1
  772. package/dist/src/catalog/types.d.ts +0 -226
  773. package/dist/src/catalog/types.d.ts.map +0 -1
  774. package/dist/src/catalog/visibility.d.ts +0 -37
  775. package/dist/src/catalog/visibility.d.ts.map +0 -1
  776. package/dist/src/code/code-highlighted.d.ts +0 -32
  777. package/dist/src/code/code-highlighted.d.ts.map +0 -1
  778. package/dist/src/code/context.d.ts +0 -16
  779. package/dist/src/code/context.d.ts.map +0 -1
  780. package/dist/src/code/index.d.ts +0 -32
  781. package/dist/src/code/index.d.ts.map +0 -1
  782. package/dist/src/code/provider.d.ts +0 -13
  783. package/dist/src/code/provider.d.ts.map +0 -1
  784. package/dist/src/code/server.d.ts +0 -95
  785. package/dist/src/code/server.d.ts.map +0 -1
  786. package/dist/src/code/types.d.ts +0 -130
  787. package/dist/src/code/types.d.ts.map +0 -1
  788. package/dist/src/code/use-shiki-highlighter.d.ts +0 -36
  789. package/dist/src/code/use-shiki-highlighter.d.ts.map +0 -1
  790. package/dist/src/command-line/build-cli.d.ts +0 -7
  791. package/dist/src/command-line/build-cli.d.ts.map +0 -1
  792. package/dist/src/command-line/cli.d.ts +0 -13
  793. package/dist/src/command-line/cli.d.ts.map +0 -1
  794. package/dist/src/command-line/commands/add.d.ts +0 -10
  795. package/dist/src/command-line/commands/add.d.ts.map +0 -1
  796. package/dist/src/command-line/commands/ai.d.ts +0 -10
  797. package/dist/src/command-line/commands/ai.d.ts.map +0 -1
  798. package/dist/src/command-line/commands/blocks.d.ts +0 -10
  799. package/dist/src/command-line/commands/blocks.d.ts.map +0 -1
  800. package/dist/src/command-line/commands/doc.d.ts +0 -14
  801. package/dist/src/command-line/commands/doc.d.ts.map +0 -1
  802. package/dist/src/command-line/commands/init.d.ts +0 -18
  803. package/dist/src/command-line/commands/init.d.ts.map +0 -1
  804. package/dist/src/command-line/commands/ls.d.ts +0 -10
  805. package/dist/src/command-line/commands/ls.d.ts.map +0 -1
  806. package/dist/src/command-line/commands/migrate.d.ts +0 -10
  807. package/dist/src/command-line/commands/migrate.d.ts.map +0 -1
  808. package/dist/src/command-line/utils/config.d.ts +0 -42
  809. package/dist/src/command-line/utils/config.d.ts.map +0 -1
  810. package/dist/src/command-line/utils/transformer.d.ts +0 -21
  811. package/dist/src/command-line/utils/transformer.d.ts.map +0 -1
  812. package/dist/src/components/autocomplete/autocomplete.d.ts +0 -181
  813. package/dist/src/components/autocomplete/autocomplete.d.ts.map +0 -1
  814. package/dist/src/components/autocomplete/index.d.ts +0 -3
  815. package/dist/src/components/autocomplete/index.d.ts.map +0 -1
  816. package/dist/src/components/badge/badge.d.ts +0 -180
  817. package/dist/src/components/badge/badge.d.ts.map +0 -1
  818. package/dist/src/components/badge/index.d.ts +0 -2
  819. package/dist/src/components/badge/index.d.ts.map +0 -1
  820. package/dist/src/components/banner/banner.d.ts +0 -106
  821. package/dist/src/components/banner/banner.d.ts.map +0 -1
  822. package/dist/src/components/banner/index.d.ts +0 -2
  823. package/dist/src/components/banner/index.d.ts.map +0 -1
  824. package/dist/src/components/breadcrumbs/breadcrumbs.d.ts +0 -78
  825. package/dist/src/components/breadcrumbs/breadcrumbs.d.ts.map +0 -1
  826. package/dist/src/components/breadcrumbs/index.d.ts +0 -2
  827. package/dist/src/components/breadcrumbs/index.d.ts.map +0 -1
  828. package/dist/src/components/button/button.d.ts +0 -214
  829. package/dist/src/components/button/button.d.ts.map +0 -1
  830. package/dist/src/components/button/index.d.ts +0 -2
  831. package/dist/src/components/button/index.d.ts.map +0 -1
  832. package/dist/src/components/chart/Color.d.ts +0 -107
  833. package/dist/src/components/chart/Color.d.ts.map +0 -1
  834. package/dist/src/components/chart/EChart.d.ts +0 -166
  835. package/dist/src/components/chart/EChart.d.ts.map +0 -1
  836. package/dist/src/components/chart/Legend.d.ts +0 -51
  837. package/dist/src/components/chart/Legend.d.ts.map +0 -1
  838. package/dist/src/components/chart/Maps.d.ts +0 -211
  839. package/dist/src/components/chart/Maps.d.ts.map +0 -1
  840. package/dist/src/components/chart/SankeyChart.d.ts +0 -98
  841. package/dist/src/components/chart/SankeyChart.d.ts.map +0 -1
  842. package/dist/src/components/chart/TimeseriesChart.d.ts +0 -181
  843. package/dist/src/components/chart/TimeseriesChart.d.ts.map +0 -1
  844. package/dist/src/components/chart/index.d.ts +0 -7
  845. package/dist/src/components/chart/index.d.ts.map +0 -1
  846. package/dist/src/components/chart/tooltip-utils.d.ts +0 -4
  847. package/dist/src/components/chart/tooltip-utils.d.ts.map +0 -1
  848. package/dist/src/components/checkbox/checkbox.d.ts +0 -197
  849. package/dist/src/components/checkbox/checkbox.d.ts.map +0 -1
  850. package/dist/src/components/checkbox/index.d.ts +0 -2
  851. package/dist/src/components/checkbox/index.d.ts.map +0 -1
  852. package/dist/src/components/clipboard-text/clipboard-text.d.ts +0 -88
  853. package/dist/src/components/clipboard-text/clipboard-text.d.ts.map +0 -1
  854. package/dist/src/components/clipboard-text/index.d.ts +0 -2
  855. package/dist/src/components/clipboard-text/index.d.ts.map +0 -1
  856. package/dist/src/components/cloudflare-logo/cloudflare-logo.d.ts +0 -133
  857. package/dist/src/components/cloudflare-logo/cloudflare-logo.d.ts.map +0 -1
  858. package/dist/src/components/cloudflare-logo/index.d.ts +0 -2
  859. package/dist/src/components/cloudflare-logo/index.d.ts.map +0 -1
  860. package/dist/src/components/code/code.d.ts +0 -189
  861. package/dist/src/components/code/code.d.ts.map +0 -1
  862. package/dist/src/components/code/index.d.ts +0 -4
  863. package/dist/src/components/code/index.d.ts.map +0 -1
  864. package/dist/src/components/collapsible/collapsible.d.ts +0 -109
  865. package/dist/src/components/collapsible/collapsible.d.ts.map +0 -1
  866. package/dist/src/components/collapsible/index.d.ts +0 -2
  867. package/dist/src/components/collapsible/index.d.ts.map +0 -1
  868. package/dist/src/components/combobox/combobox.d.ts +0 -246
  869. package/dist/src/components/combobox/combobox.d.ts.map +0 -1
  870. package/dist/src/components/combobox/index.d.ts +0 -3
  871. package/dist/src/components/combobox/index.d.ts.map +0 -1
  872. package/dist/src/components/command-palette/command-palette.d.ts +0 -258
  873. package/dist/src/components/command-palette/command-palette.d.ts.map +0 -1
  874. package/dist/src/components/command-palette/index.d.ts +0 -3
  875. package/dist/src/components/command-palette/index.d.ts.map +0 -1
  876. package/dist/src/components/command-palette/types.d.ts +0 -168
  877. package/dist/src/components/command-palette/types.d.ts.map +0 -1
  878. package/dist/src/components/date-picker/date-picker.d.ts +0 -65
  879. package/dist/src/components/date-picker/date-picker.d.ts.map +0 -1
  880. package/dist/src/components/date-picker/index.d.ts +0 -4
  881. package/dist/src/components/date-picker/index.d.ts.map +0 -1
  882. package/dist/src/components/date-range-picker/date-range-picker.d.ts +0 -125
  883. package/dist/src/components/date-range-picker/date-range-picker.d.ts.map +0 -1
  884. package/dist/src/components/date-range-picker/index.d.ts +0 -5
  885. package/dist/src/components/date-range-picker/index.d.ts.map +0 -1
  886. package/dist/src/components/dialog/dialog.d.ts +0 -242
  887. package/dist/src/components/dialog/dialog.d.ts.map +0 -1
  888. package/dist/src/components/dialog/index.d.ts +0 -2
  889. package/dist/src/components/dialog/index.d.ts.map +0 -1
  890. package/dist/src/components/dropdown/dropdown.d.ts +0 -116
  891. package/dist/src/components/dropdown/dropdown.d.ts.map +0 -1
  892. package/dist/src/components/dropdown/index.d.ts +0 -2
  893. package/dist/src/components/dropdown/index.d.ts.map +0 -1
  894. package/dist/src/components/empty/empty.d.ts +0 -69
  895. package/dist/src/components/empty/empty.d.ts.map +0 -1
  896. package/dist/src/components/empty/index.d.ts +0 -2
  897. package/dist/src/components/empty/index.d.ts.map +0 -1
  898. package/dist/src/components/field/field.d.ts +0 -89
  899. package/dist/src/components/field/field.d.ts.map +0 -1
  900. package/dist/src/components/field/index.d.ts +0 -2
  901. package/dist/src/components/field/index.d.ts.map +0 -1
  902. package/dist/src/components/flow/connectors.d.ts +0 -41
  903. package/dist/src/components/flow/connectors.d.ts.map +0 -1
  904. package/dist/src/components/flow/diagram.d.ts +0 -98
  905. package/dist/src/components/flow/diagram.d.ts.map +0 -1
  906. package/dist/src/components/flow/index.d.ts +0 -26
  907. package/dist/src/components/flow/index.d.ts.map +0 -1
  908. package/dist/src/components/flow/node.d.ts +0 -61
  909. package/dist/src/components/flow/node.d.ts.map +0 -1
  910. package/dist/src/components/flow/parallel.d.ts +0 -13
  911. package/dist/src/components/flow/parallel.d.ts.map +0 -1
  912. package/dist/src/components/flow/use-children.d.ts +0 -87
  913. package/dist/src/components/flow/use-children.d.ts.map +0 -1
  914. package/dist/src/components/grid/grid.d.ts +0 -135
  915. package/dist/src/components/grid/grid.d.ts.map +0 -1
  916. package/dist/src/components/grid/index.d.ts +0 -2
  917. package/dist/src/components/grid/index.d.ts.map +0 -1
  918. package/dist/src/components/input/index.d.ts +0 -19
  919. package/dist/src/components/input/index.d.ts.map +0 -1
  920. package/dist/src/components/input/input-area.d.ts +0 -65
  921. package/dist/src/components/input/input-area.d.ts.map +0 -1
  922. package/dist/src/components/input/input.d.ts +0 -175
  923. package/dist/src/components/input/input.d.ts.map +0 -1
  924. package/dist/src/components/input-group/context.d.ts +0 -96
  925. package/dist/src/components/input-group/context.d.ts.map +0 -1
  926. package/dist/src/components/input-group/index.d.ts +0 -2
  927. package/dist/src/components/input-group/index.d.ts.map +0 -1
  928. package/dist/src/components/input-group/input-group-addon.d.ts +0 -15
  929. package/dist/src/components/input-group/input-group-addon.d.ts.map +0 -1
  930. package/dist/src/components/input-group/input-group-button.d.ts +0 -36
  931. package/dist/src/components/input-group/input-group-button.d.ts.map +0 -1
  932. package/dist/src/components/input-group/input-group-input.d.ts +0 -9
  933. package/dist/src/components/input-group/input-group-input.d.ts.map +0 -1
  934. package/dist/src/components/input-group/input-group-suffix.d.ts +0 -13
  935. package/dist/src/components/input-group/input-group-suffix.d.ts.map +0 -1
  936. package/dist/src/components/input-group/input-group.d.ts +0 -43
  937. package/dist/src/components/input-group/input-group.d.ts.map +0 -1
  938. package/dist/src/components/label/index.d.ts +0 -2
  939. package/dist/src/components/label/index.d.ts.map +0 -1
  940. package/dist/src/components/label/label.d.ts +0 -67
  941. package/dist/src/components/label/label.d.ts.map +0 -1
  942. package/dist/src/components/layer-card/index.d.ts +0 -2
  943. package/dist/src/components/layer-card/index.d.ts.map +0 -1
  944. package/dist/src/components/layer-card/layer-card.d.ts +0 -60
  945. package/dist/src/components/layer-card/layer-card.d.ts.map +0 -1
  946. package/dist/src/components/link/index.d.ts +0 -2
  947. package/dist/src/components/link/index.d.ts.map +0 -1
  948. package/dist/src/components/link/link.d.ts +0 -66
  949. package/dist/src/components/link/link.d.ts.map +0 -1
  950. package/dist/src/components/loader/index.d.ts +0 -3
  951. package/dist/src/components/loader/index.d.ts.map +0 -1
  952. package/dist/src/components/loader/loader.d.ts +0 -70
  953. package/dist/src/components/loader/loader.d.ts.map +0 -1
  954. package/dist/src/components/loader/skeleton-line.d.ts +0 -11
  955. package/dist/src/components/loader/skeleton-line.d.ts.map +0 -1
  956. package/dist/src/components/menubar/index.d.ts +0 -3
  957. package/dist/src/components/menubar/index.d.ts.map +0 -1
  958. package/dist/src/components/menubar/menubar.d.ts +0 -66
  959. package/dist/src/components/menubar/menubar.d.ts.map +0 -1
  960. package/dist/src/components/menubar/use-menu-navigation.d.ts +0 -8
  961. package/dist/src/components/menubar/use-menu-navigation.d.ts.map +0 -1
  962. package/dist/src/components/meter/index.d.ts +0 -2
  963. package/dist/src/components/meter/index.d.ts.map +0 -1
  964. package/dist/src/components/meter/meter.d.ts +0 -44
  965. package/dist/src/components/meter/meter.d.ts.map +0 -1
  966. package/dist/src/components/pagination/index.d.ts +0 -2
  967. package/dist/src/components/pagination/index.d.ts.map +0 -1
  968. package/dist/src/components/pagination/pagination.d.ts +0 -241
  969. package/dist/src/components/pagination/pagination.d.ts.map +0 -1
  970. package/dist/src/components/popover/index.d.ts +0 -3
  971. package/dist/src/components/popover/index.d.ts.map +0 -1
  972. package/dist/src/components/popover/popover.d.ts +0 -178
  973. package/dist/src/components/popover/popover.d.ts.map +0 -1
  974. package/dist/src/components/radio/index.d.ts +0 -2
  975. package/dist/src/components/radio/index.d.ts.map +0 -1
  976. package/dist/src/components/radio/radio.d.ts +0 -277
  977. package/dist/src/components/radio/radio.d.ts.map +0 -1
  978. package/dist/src/components/radio/radio.type-spec.d.ts +0 -12
  979. package/dist/src/components/radio/radio.type-spec.d.ts.map +0 -1
  980. package/dist/src/components/select/index.d.ts +0 -2
  981. package/dist/src/components/select/index.d.ts.map +0 -1
  982. package/dist/src/components/select/select.d.ts +0 -288
  983. package/dist/src/components/select/select.d.ts.map +0 -1
  984. package/dist/src/components/sensitive-input/index.d.ts +0 -2
  985. package/dist/src/components/sensitive-input/index.d.ts.map +0 -1
  986. package/dist/src/components/sensitive-input/sensitive-input.d.ts +0 -94
  987. package/dist/src/components/sensitive-input/sensitive-input.d.ts.map +0 -1
  988. package/dist/src/components/sidebar/index.d.ts +0 -2
  989. package/dist/src/components/sidebar/index.d.ts.map +0 -1
  990. package/dist/src/components/sidebar/sidebar.d.ts +0 -581
  991. package/dist/src/components/sidebar/sidebar.d.ts.map +0 -1
  992. package/dist/src/components/surface/index.d.ts +0 -5
  993. package/dist/src/components/surface/index.d.ts.map +0 -1
  994. package/dist/src/components/surface/surface.d.ts +0 -64
  995. package/dist/src/components/surface/surface.d.ts.map +0 -1
  996. package/dist/src/components/switch/index.d.ts +0 -2
  997. package/dist/src/components/switch/index.d.ts.map +0 -1
  998. package/dist/src/components/switch/switch.d.ts +0 -197
  999. package/dist/src/components/switch/switch.d.ts.map +0 -1
  1000. package/dist/src/components/table/index.d.ts +0 -2
  1001. package/dist/src/components/table/index.d.ts.map +0 -1
  1002. package/dist/src/components/table/table.d.ts +0 -138
  1003. package/dist/src/components/table/table.d.ts.map +0 -1
  1004. package/dist/src/components/table-of-contents/index.d.ts +0 -2
  1005. package/dist/src/components/table-of-contents/index.d.ts.map +0 -1
  1006. package/dist/src/components/table-of-contents/table-of-contents.d.ts +0 -72
  1007. package/dist/src/components/table-of-contents/table-of-contents.d.ts.map +0 -1
  1008. package/dist/src/components/tabs/index.d.ts +0 -3
  1009. package/dist/src/components/tabs/index.d.ts.map +0 -1
  1010. package/dist/src/components/tabs/tabs.d.ts +0 -116
  1011. package/dist/src/components/tabs/tabs.d.ts.map +0 -1
  1012. package/dist/src/components/text/index.d.ts +0 -2
  1013. package/dist/src/components/text/index.d.ts.map +0 -1
  1014. package/dist/src/components/text/text.d.ts +0 -214
  1015. package/dist/src/components/text/text.d.ts.map +0 -1
  1016. package/dist/src/components/text/text.type-spec.d.ts +0 -44
  1017. package/dist/src/components/text/text.type-spec.d.ts.map +0 -1
  1018. package/dist/src/components/toast/index.d.ts +0 -5
  1019. package/dist/src/components/toast/index.d.ts.map +0 -1
  1020. package/dist/src/components/toast/toast.d.ts +0 -197
  1021. package/dist/src/components/toast/toast.d.ts.map +0 -1
  1022. package/dist/src/components/toolbar/index.d.ts +0 -2
  1023. package/dist/src/components/toolbar/index.d.ts.map +0 -1
  1024. package/dist/src/components/toolbar/toolbar.d.ts +0 -50
  1025. package/dist/src/components/toolbar/toolbar.d.ts.map +0 -1
  1026. package/dist/src/components/tooltip/index.d.ts +0 -2
  1027. package/dist/src/components/tooltip/index.d.ts.map +0 -1
  1028. package/dist/src/components/tooltip/tooltip.d.ts +0 -108
  1029. package/dist/src/components/tooltip/tooltip.d.ts.map +0 -1
  1030. package/dist/src/index.d.ts +0 -85
  1031. package/dist/src/index.d.ts.map +0 -1
  1032. package/dist/src/primitives/accordion.d.ts +0 -13
  1033. package/dist/src/primitives/accordion.d.ts.map +0 -1
  1034. package/dist/src/primitives/alert-dialog.d.ts +0 -13
  1035. package/dist/src/primitives/alert-dialog.d.ts.map +0 -1
  1036. package/dist/src/primitives/autocomplete.d.ts +0 -13
  1037. package/dist/src/primitives/autocomplete.d.ts.map +0 -1
  1038. package/dist/src/primitives/avatar.d.ts +0 -13
  1039. package/dist/src/primitives/avatar.d.ts.map +0 -1
  1040. package/dist/src/primitives/button.d.ts +0 -13
  1041. package/dist/src/primitives/button.d.ts.map +0 -1
  1042. package/dist/src/primitives/checkbox-group.d.ts +0 -13
  1043. package/dist/src/primitives/checkbox-group.d.ts.map +0 -1
  1044. package/dist/src/primitives/checkbox.d.ts +0 -13
  1045. package/dist/src/primitives/checkbox.d.ts.map +0 -1
  1046. package/dist/src/primitives/collapsible.d.ts +0 -13
  1047. package/dist/src/primitives/collapsible.d.ts.map +0 -1
  1048. package/dist/src/primitives/combobox.d.ts +0 -13
  1049. package/dist/src/primitives/combobox.d.ts.map +0 -1
  1050. package/dist/src/primitives/context-menu.d.ts +0 -13
  1051. package/dist/src/primitives/context-menu.d.ts.map +0 -1
  1052. package/dist/src/primitives/csp-provider.d.ts +0 -13
  1053. package/dist/src/primitives/csp-provider.d.ts.map +0 -1
  1054. package/dist/src/primitives/dialog.d.ts +0 -13
  1055. package/dist/src/primitives/dialog.d.ts.map +0 -1
  1056. package/dist/src/primitives/direction-provider.d.ts +0 -13
  1057. package/dist/src/primitives/direction-provider.d.ts.map +0 -1
  1058. package/dist/src/primitives/drawer.d.ts +0 -13
  1059. package/dist/src/primitives/drawer.d.ts.map +0 -1
  1060. package/dist/src/primitives/field.d.ts +0 -13
  1061. package/dist/src/primitives/field.d.ts.map +0 -1
  1062. package/dist/src/primitives/fieldset.d.ts +0 -13
  1063. package/dist/src/primitives/fieldset.d.ts.map +0 -1
  1064. package/dist/src/primitives/form.d.ts +0 -13
  1065. package/dist/src/primitives/form.d.ts.map +0 -1
  1066. package/dist/src/primitives/index.d.ts +0 -56
  1067. package/dist/src/primitives/index.d.ts.map +0 -1
  1068. package/dist/src/primitives/input.d.ts +0 -13
  1069. package/dist/src/primitives/input.d.ts.map +0 -1
  1070. package/dist/src/primitives/menu.d.ts +0 -13
  1071. package/dist/src/primitives/menu.d.ts.map +0 -1
  1072. package/dist/src/primitives/menubar.d.ts +0 -13
  1073. package/dist/src/primitives/menubar.d.ts.map +0 -1
  1074. package/dist/src/primitives/meter.d.ts +0 -13
  1075. package/dist/src/primitives/meter.d.ts.map +0 -1
  1076. package/dist/src/primitives/navigation-menu.d.ts +0 -13
  1077. package/dist/src/primitives/navigation-menu.d.ts.map +0 -1
  1078. package/dist/src/primitives/number-field.d.ts +0 -13
  1079. package/dist/src/primitives/number-field.d.ts.map +0 -1
  1080. package/dist/src/primitives/otp-field.d.ts +0 -14
  1081. package/dist/src/primitives/otp-field.d.ts.map +0 -1
  1082. package/dist/src/primitives/popover.d.ts +0 -13
  1083. package/dist/src/primitives/popover.d.ts.map +0 -1
  1084. package/dist/src/primitives/preview-card.d.ts +0 -13
  1085. package/dist/src/primitives/preview-card.d.ts.map +0 -1
  1086. package/dist/src/primitives/progress.d.ts +0 -13
  1087. package/dist/src/primitives/progress.d.ts.map +0 -1
  1088. package/dist/src/primitives/radio-group.d.ts +0 -13
  1089. package/dist/src/primitives/radio-group.d.ts.map +0 -1
  1090. package/dist/src/primitives/radio.d.ts +0 -13
  1091. package/dist/src/primitives/radio.d.ts.map +0 -1
  1092. package/dist/src/primitives/scroll-area.d.ts +0 -13
  1093. package/dist/src/primitives/scroll-area.d.ts.map +0 -1
  1094. package/dist/src/primitives/select.d.ts +0 -13
  1095. package/dist/src/primitives/select.d.ts.map +0 -1
  1096. package/dist/src/primitives/separator.d.ts +0 -13
  1097. package/dist/src/primitives/separator.d.ts.map +0 -1
  1098. package/dist/src/primitives/slider.d.ts +0 -13
  1099. package/dist/src/primitives/slider.d.ts.map +0 -1
  1100. package/dist/src/primitives/switch.d.ts +0 -13
  1101. package/dist/src/primitives/switch.d.ts.map +0 -1
  1102. package/dist/src/primitives/tabs.d.ts +0 -13
  1103. package/dist/src/primitives/tabs.d.ts.map +0 -1
  1104. package/dist/src/primitives/toast.d.ts +0 -13
  1105. package/dist/src/primitives/toast.d.ts.map +0 -1
  1106. package/dist/src/primitives/toggle-group.d.ts +0 -13
  1107. package/dist/src/primitives/toggle-group.d.ts.map +0 -1
  1108. package/dist/src/primitives/toggle.d.ts +0 -13
  1109. package/dist/src/primitives/toggle.d.ts.map +0 -1
  1110. package/dist/src/primitives/toolbar.d.ts +0 -13
  1111. package/dist/src/primitives/toolbar.d.ts.map +0 -1
  1112. package/dist/src/primitives/tooltip.d.ts +0 -13
  1113. package/dist/src/primitives/tooltip.d.ts.map +0 -1
  1114. package/dist/src/registry/index.d.ts +0 -8
  1115. package/dist/src/registry/index.d.ts.map +0 -1
  1116. package/dist/src/registry/types.d.ts +0 -191
  1117. package/dist/src/registry/types.d.ts.map +0 -1
  1118. package/dist/src/utils/cn.d.ts +0 -3
  1119. package/dist/src/utils/cn.d.ts.map +0 -1
  1120. package/dist/src/utils/index.d.ts +0 -4
  1121. package/dist/src/utils/index.d.ts.map +0 -1
  1122. package/dist/src/utils/link-provider.d.ts +0 -66
  1123. package/dist/src/utils/link-provider.d.ts.map +0 -1
  1124. package/dist/src/utils/portal-provider.d.ts +0 -56
  1125. package/dist/src/utils/portal-provider.d.ts.map +0 -1
  1126. package/dist/src/utils/prop-examples.d.ts +0 -36
  1127. package/dist/src/utils/prop-examples.d.ts.map +0 -1
  1128. package/dist/src/utils/resolve-variant.d.ts +0 -27
  1129. package/dist/src/utils/resolve-variant.d.ts.map +0 -1
  1130. package/dist/utils.js.map +0 -1
@@ -65,7 +65,7 @@
65
65
  "<div className=\"w-80\">\n <Autocomplete\n items={countries}\n label=\"Country\"\n error={{ message: \"Please enter a valid country\", match: true }}\n filter={filter}\n >\n <Autocomplete.InputGroup placeholder=\"Search countries…\" />\n <Autocomplete.Content>\n <Autocomplete.List>\n {(item: Country) => (\n <Autocomplete.Item key={item.code} value={item}>\n {item.label}\n </Autocomplete.Item>\n )}\n </Autocomplete.List>\n </Autocomplete.Content>\n </Autocomplete>\n </div>",
66
66
  "<Autocomplete items={servers}>\n <Autocomplete.InputGroup placeholder=\"Select region…\" />\n <Autocomplete.Content>\n <Autocomplete.List>\n {(group: ServerGroup) => (\n <Autocomplete.Group key={group.value} items={group.items}>\n <Autocomplete.GroupLabel>{group.value}</Autocomplete.GroupLabel>\n <Autocomplete.Collection>\n {(item: ServerLocation) => (\n <Autocomplete.Item key={item.value} value={item}>\n {item.label}\n </Autocomplete.Item>\n )}\n </Autocomplete.Collection>\n </Autocomplete.Group>\n )}\n </Autocomplete.List>\n </Autocomplete.Content>\n </Autocomplete>",
67
67
  "<div className=\"flex flex-wrap items-center gap-4\">\n <Autocomplete items={fruits.slice(0, 10)}>\n <Autocomplete.InputGroup size=\"xs\" placeholder=\"xs\" />\n <Autocomplete.Content>\n <Autocomplete.List>\n {(item: string) => (\n <Autocomplete.Item key={item} value={item}>\n {item}\n </Autocomplete.Item>\n )}\n </Autocomplete.List>\n </Autocomplete.Content>\n </Autocomplete>\n <Autocomplete items={fruits.slice(0, 10)}>\n <Autocomplete.InputGroup size=\"sm\" placeholder=\"sm\" />\n <Autocomplete.Content>\n <Autocomplete.List>\n {(item: string) => (\n <Autocomplete.Item key={item} value={item}>\n {item}\n </Autocomplete.Item>\n )}\n </Autocomplete.List>\n </Autocomplete.Content>\n </Autocomplete>\n <Autocomplete items={fruits.slice(0, 10)}>\n <Autocomplete.InputGroup size=\"base\" placeholder=\"base (default)\" />\n <Autocomplete.Content>\n <Autocomplete.List>\n {(item: string) => (\n <Autocomplete.Item key={item} value={item}>\n {item}\n </Autocomplete.Item>\n )}\n </Autocomplete.List>\n </Autocomplete.Content>\n </Autocomplete>\n <Autocomplete items={fruits.slice(0, 10)}>\n <Autocomplete.InputGroup size=\"lg\" placeholder=\"lg\" />\n <Autocomplete.Content>\n <Autocomplete.List>\n {(item: string) => (\n <Autocomplete.Item key={item} value={item}>\n {item}\n </Autocomplete.Item>\n )}\n </Autocomplete.List>\n </Autocomplete.Content>\n </Autocomplete>\n </div>",
68
- "<div className=\"flex flex-col gap-3 w-80\">\n <Autocomplete\n items={fruits}\n value={value}\n onValueChange={(v) => setValue(v)}\n >\n <Autocomplete.InputGroup placeholder=\"Type a fruit…\" />\n <Autocomplete.Content>\n <Autocomplete.List>\n {(item: string) => (\n <Autocomplete.Item key={item} value={item}>\n {item}\n </Autocomplete.Item>\n )}\n </Autocomplete.List>\n </Autocomplete.Content>\n </Autocomplete>\n {value && (\n <p className=\"text-sm text-kumo-subtle\">\n Value: <span className=\"text-kumo-default font-medium\">{value}</span>\n </p>\n )}\n </div>"
68
+ "<div className=\"flex w-80 flex-col gap-3\">\n <Autocomplete\n items={fruits}\n value={value}\n onValueChange={(v) => setValue(v)}\n >\n <Autocomplete.InputGroup placeholder=\"Type a fruit…\" />\n <Autocomplete.Content>\n <Autocomplete.List>\n {(item: string) => (\n <Autocomplete.Item key={item} value={item}>\n {item}\n </Autocomplete.Item>\n )}\n </Autocomplete.List>\n </Autocomplete.Content>\n </Autocomplete>\n {value && (\n <p className=\"text-sm text-kumo-subtle\">\n Value: <span className=\"font-medium text-kumo-default\">{value}</span>\n </p>\n )}\n </div>"
69
69
  ],
70
70
  "colors": [
71
71
  "bg-kumo-control",
@@ -218,11 +218,11 @@
218
218
  "classes": {
219
219
  "primary": "bg-kumo-badge-inverted text-kumo-badge-inverted",
220
220
  "secondary": "bg-kumo-fill text-kumo-badge-neutral-subtle",
221
- "error": "bg-kumo-danger-tint/60 text-kumo-danger",
222
- "warning": "bg-kumo-warning-tint/70 text-kumo-warning",
223
- "success": "bg-kumo-success-tint/70 text-kumo-success",
221
+ "error": "bg-kumo-danger-tint text-kumo-danger",
222
+ "warning": "bg-kumo-warning-tint text-kumo-warning",
223
+ "success": "bg-kumo-success-tint text-kumo-success",
224
224
  "destructive": "bg-kumo-badge-red text-white",
225
- "info": "bg-kumo-info-tint/70 text-kumo-info",
225
+ "info": "bg-kumo-info-tint text-kumo-info",
226
226
  "beta": "border border-dashed border-kumo-brand bg-transparent text-kumo-link",
227
227
  "outline": "border border-kumo-fill bg-transparent text-kumo-default",
228
228
  "red": "bg-kumo-badge-red text-white",
@@ -268,7 +268,7 @@
268
268
  "<div className=\"flex flex-wrap items-center gap-2\">\n <Badge variant=\"primary\">Primary</Badge>\n <Badge variant=\"secondary\">Secondary</Badge>\n <Badge variant=\"error\">Error</Badge>\n <Badge variant=\"success\">Success</Badge>\n <Badge variant=\"warning\">Warning</Badge>\n <Badge variant=\"info\">Info</Badge>\n <Badge variant=\"outline\">Outline</Badge>\n <Badge variant=\"beta\">Beta</Badge>\n </div>",
269
269
  "<div className=\"flex flex-wrap items-center gap-2\">\n <Badge variant=\"neutral\">Neutral</Badge>\n <Badge variant=\"red\">Red</Badge>\n <Badge variant=\"green\">Green</Badge>\n <Badge variant=\"orange\">Orange</Badge>\n <Badge variant=\"teal\">Teal</Badge>\n <Badge variant=\"blue\">Blue</Badge>\n <Badge variant=\"purple\">Purple</Badge>\n </div>",
270
270
  "<p className=\"flex items-center gap-2\">\n Workers\n <Badge variant=\"secondary\">New</Badge>\n </p>",
271
- "<div className=\"flex flex-wrap items-center gap-2\">\n <Badge variant=\"success\" appearance=\"dot\">Healthy</Badge>\n <Badge variant=\"warning\" appearance=\"dot\">Warning</Badge>\n <Badge variant=\"error\" appearance=\"dot\">Error</Badge>\n <Badge variant=\"neutral\" appearance=\"dot\">Neutral</Badge>\n </div>"
271
+ "<div className=\"flex flex-wrap items-center gap-2\">\n <Badge variant=\"success\" appearance=\"dot\">\n Healthy\n </Badge>\n <Badge variant=\"warning\" appearance=\"dot\">\n Warning\n </Badge>\n <Badge variant=\"error\" appearance=\"dot\">\n Error\n </Badge>\n <Badge variant=\"neutral\" appearance=\"dot\">\n Neutral\n </Badge>\n </div>"
272
272
  ],
273
273
  "colors": [
274
274
  "bg-kumo-badge-blue",
@@ -304,7 +304,7 @@
304
304
  "Banner": {
305
305
  "name": "Banner",
306
306
  "type": "component",
307
- "description": "Full-width message bar for informational, warning, or error notices. Supports structured title/description for i18n, or simple children for basic usage.",
307
+ "description": "Full-width message bar with an optional trailing CTA slot.",
308
308
  "importPath": "@cloudflare/kumo",
309
309
  "category": "Feedback",
310
310
  "props": {
@@ -339,7 +339,7 @@
339
339
  "action": {
340
340
  "type": "ReactNode",
341
341
  "optional": true,
342
- "description": "Action slot rendered at the trailing end of the banner (e.g. a CTA button or link). Only used in structured mode (with `title` or `description`)."
342
+ "description": "Action slot for a CTA button or link. Compact banners render a Kumo `Link` inline with the description; CTAs render at the trailing end. Use `Banner.Action` for accent-aware CTAs that self-style to the banner variant; other nodes are rendered as-is. Multiple actions can be passed in a Fragment. Only used in structured mode (with `title` or `description`)."
343
343
  },
344
344
  "text": {
345
345
  "type": "string",
@@ -366,12 +366,30 @@
366
366
  "secondary": "Neutral banner for secondary messages"
367
367
  },
368
368
  "classes": {
369
- "default": "bg-kumo-banner-info text-kumo-info",
370
- "alert": "bg-kumo-banner-warning text-kumo-warning",
371
- "error": "bg-kumo-danger-tint/60 text-kumo-danger",
372
- "secondary": "bg-kumo-contrast/5 text-kumo-subtle"
369
+ "default": "bg-kumo-info-tint text-kumo-info",
370
+ "alert": "bg-kumo-warning-tint text-kumo-warning",
371
+ "error": "bg-kumo-danger-tint text-kumo-danger",
372
+ "secondary": "bg-kumo-contrast/5 text-kumo-default/70"
373
373
  },
374
374
  "default": "default"
375
+ },
376
+ "size": {
377
+ "type": "enum",
378
+ "optional": true,
379
+ "description": "Size of the banner. A `\"sm\"` banner uses tighter spacing and `text-sm`, renders a Kumo `Link` action inline with the description, and sets its `Banner.Action` children to the `\"xs\"` size — suited to dialogs and other tight spaces.",
380
+ "values": [
381
+ "base",
382
+ "sm"
383
+ ],
384
+ "descriptions": {
385
+ "base": "Default banner size",
386
+ "sm": "Compact banner for dialogs and tight spaces"
387
+ },
388
+ "classes": {
389
+ "base": "items-start gap-3 rounded-lg px-4 py-3 text-base",
390
+ "sm": "items-center gap-2 rounded-md px-3 py-2 text-sm"
391
+ },
392
+ "default": "base"
375
393
  }
376
394
  },
377
395
  "examples": [
@@ -383,21 +401,36 @@
383
401
  "<Banner\n icon={<Info weight=\"fill\" />}\n title=\"Your changes have been saved.\"\n />",
384
402
  "<Banner\n icon={<Warning weight=\"fill\" />}\n variant=\"alert\"\n title=\"Review required\"\n description=\"Please review your billing information before proceeding.\"\n />",
385
403
  "<Banner\n icon={<Info weight=\"fill\" />}\n title=\"Custom content supported\"\n description={\n <Text DANGEROUS_className=\"text-inherit\">\n This banner supports <strong>custom content</strong> with Text.\n </Text>\n }\n />",
386
- "<div className=\"w-full space-y-3\">\n <Banner\n icon={<Info weight=\"fill\" />}\n title=\"Update available\"\n description=\"A new version is ready to install.\"\n action={<Button size=\"sm\">Update now</Button>}\n />\n <Banner\n icon={<Info weight=\"fill\" />}\n title=\"Update available\"\n description=\"A new version is ready to install.\"\n action={\n <Button\n size=\"sm\"\n variant=\"ghost\"\n shape=\"square\"\n icon={X}\n aria-label=\"Dismiss\"\n />\n }\n />\n </div>",
387
- "<Banner\n icon={<Warning weight=\"fill\" />}\n variant=\"alert\"\n title=\"Session expiring\"\n description=\"Your session will expire in 5 minutes.\"\n action={\n <>\n <Button size=\"sm\" variant=\"secondary\">\n Dismiss\n </Button>\n <Button size=\"sm\">Extend session</Button>\n </>\n }\n />",
404
+ "<div className=\"w-full space-y-3\">\n <Banner\n icon={<Info weight=\"fill\" />}\n title=\"Update available\"\n description=\"A new version is ready to install.\"\n action={\n <>\n <Banner.Action>Update</Banner.Action>\n <Banner.Action variant=\"ghost\" icon={<X />} aria-label=\"Dismiss\" />\n </>\n }\n />\n <Banner\n variant=\"error\"\n icon={<WarningCircle weight=\"fill\" />}\n title=\"Save failed\"\n description=\"We couldn't save your changes. Please try again.\"\n action={\n <>\n <Banner.Action>Retry</Banner.Action>\n <Banner.Action variant=\"ghost\" icon={<X />} aria-label=\"Dismiss\" />\n </>\n }\n />\n <Banner\n variant=\"alert\"\n icon={<WarningCircle weight=\"fill\" />}\n title=\"Save failed\"\n description=\"We couldn't save your changes. Please try again.\"\n action={\n <>\n <Banner.Action>Retry</Banner.Action>\n <Banner.Action variant=\"ghost\" icon={<X />} aria-label=\"Dismiss\" />\n </>\n }\n />\n <Banner\n variant=\"secondary\"\n icon={<WarningCircle weight=\"fill\" />}\n title=\"Save failed\"\n description=\"We couldn't save your changes. Please try again.\"\n action={\n <>\n <Banner.Action>Retry</Banner.Action>\n <Banner.Action variant=\"ghost\" icon={<X />} aria-label=\"Dismiss\" />\n </>\n }\n />\n </div>",
405
+ "<div className=\"w-full space-y-3\">\n <Banner\n icon={<Warning weight=\"fill\" />}\n variant=\"error\"\n title=\"Your account is 90 days past due.\"\n description=\"Pay now to avoid interruption.\"\n action={\n <>\n <Banner.Action>Pay now</Banner.Action>\n <Banner.Action variant=\"secondary\">Go to billing</Banner.Action>\n </>\n }\n />\n </div>",
406
+ "<div className=\"w-full space-y-3\">\n <Banner\n icon={<Info weight=\"fill\" />}\n title=\"Update available\"\n description=\"A new version is ready to install.\"\n action={\n <>\n <Banner.Action>Update</Banner.Action>\n <Banner.Action variant=\"ghost\" icon={<X />} aria-label=\"Dismiss\" />\n </>\n }\n />\n <Banner\n variant=\"alert\"\n icon={<Warning weight=\"fill\" />}\n title=\"Session expiring\"\n description=\"Your session will expire in 5 minutes.\"\n action={\n <>\n <Banner.Action>Extend</Banner.Action>\n <Banner.Action variant=\"ghost\" icon={<X />} aria-label=\"Dismiss\" />\n </>\n }\n />\n <Banner\n variant=\"error\"\n icon={<WarningCircle weight=\"fill\" />}\n title=\"Save failed\"\n description=\"We couldn't save your changes. Please try again.\"\n action={\n <>\n <Banner.Action>Retry</Banner.Action>\n <Banner.Action variant=\"ghost\" icon={<X />} aria-label=\"Dismiss\" />\n </>\n }\n />\n <Banner\n variant=\"secondary\"\n icon={<Info weight=\"fill\" />}\n title=\"Heads up\"\n description=\"This is a secondary informational banner.\"\n action={\n <>\n <Banner.Action>Got it</Banner.Action>\n <Banner.Action variant=\"ghost\" icon={<X />} aria-label=\"Dismiss\" />\n </>\n }\n />\n </div>",
407
+ "<Banner\n size=\"sm\"\n description=\"A DNS record for puppies.cloudflare.dev already exists in this zone.\"\n action={<Link href=\"#\">Manage DNS for puppies.cloudflare.dev</Link>}\n />",
408
+ "<Banner\n size=\"sm\"\n description=\"A DNS record for puppies.cloudflare.dev already exists in this zone.\"\n action={\n <>\n <Banner.Action>Manage DNS</Banner.Action>\n <Banner.Action variant=\"ghost\">\n <X />\n </Banner.Action>\n </>\n }\n />",
409
+ "<Banner\n size=\"sm\"\n description=\"A DNS record for puppies.cloudflare.dev already exists in this zone.\"\n />",
388
410
  "<Banner icon={<Info />}>This is a simple banner using children.</Banner>"
389
411
  ],
390
412
  "colors": [
391
- "bg-kumo-banner-info",
392
- "bg-kumo-banner-warning",
393
413
  "bg-kumo-contrast",
394
414
  "bg-kumo-danger-tint",
415
+ "bg-kumo-info-tint",
416
+ "bg-kumo-warning-tint",
417
+ "fill-kumo-danger",
418
+ "fill-kumo-info",
419
+ "fill-kumo-interact",
420
+ "fill-kumo-warning",
395
421
  "text-kumo-danger",
422
+ "text-kumo-default",
396
423
  "text-kumo-info",
397
- "text-kumo-subtle",
398
424
  "text-kumo-warning"
399
425
  ],
400
- "baseStyles": "flex w-full items-start gap-3 rounded-lg px-4 py-3 text-base"
426
+ "baseStyles": "flex w-full",
427
+ "subComponents": {
428
+ "Action": {
429
+ "name": "Action",
430
+ "description": "Action sub-component",
431
+ "props": {}
432
+ }
433
+ }
401
434
  },
402
435
  "Breadcrumbs": {
403
436
  "name": "Breadcrumbs",
@@ -492,6 +525,144 @@
492
525
  }
493
526
  }
494
527
  },
528
+ "BubbleMap": {
529
+ "name": "BubbleMap",
530
+ "type": "component",
531
+ "description": "BubbleMap component",
532
+ "importPath": "@cloudflare/kumo",
533
+ "category": "Data Visualization",
534
+ "props": {
535
+ "echarts": {
536
+ "type": "typeof echarts",
537
+ "required": true,
538
+ "description": "The ECharts core instance imported by the consumer (passed in for tree-shaking). Requires `MapChart`, `ScatterChart`, `TooltipComponent`, and a renderer registered via `echarts.use([...])`."
539
+ },
540
+ "geoJson": {
541
+ "type": "MapGeoJson",
542
+ "required": true,
543
+ "description": "GeoJSON `FeatureCollection` for the land base."
544
+ },
545
+ "mapName": {
546
+ "type": "string",
547
+ "optional": true,
548
+ "description": "Optional stable ECharts map registry name. Set this when the same GeoJSON is parsed into new object instances across mounts and should reuse one global ECharts registration."
549
+ },
550
+ "data": {
551
+ "type": "T[]",
552
+ "required": true,
553
+ "description": "Raw data rows. Coordinates/value/name are read via the accessors below."
554
+ },
555
+ "lng": {
556
+ "type": "MapAccessor<T, number>",
557
+ "required": true,
558
+ "description": "Longitude accessor (key of `T` or `(row) => number`)."
559
+ },
560
+ "lat": {
561
+ "type": "MapAccessor<T, number>",
562
+ "required": true,
563
+ "description": "Latitude accessor (key of `T` or `(row) => number`)."
564
+ },
565
+ "value": {
566
+ "type": "MapAccessor<T, number>",
567
+ "required": true,
568
+ "description": "Value accessor — drives bubble size."
569
+ },
570
+ "name": {
571
+ "type": "MapAccessor<T, string>",
572
+ "optional": true,
573
+ "description": "Optional name accessor — used by the default tooltip."
574
+ },
575
+ "minRadius": {
576
+ "type": "number",
577
+ "optional": true,
578
+ "description": "Smallest bubble radius in px. Default: `6`."
579
+ },
580
+ "maxRadius": {
581
+ "type": "number",
582
+ "optional": true,
583
+ "description": "Largest bubble radius in px. Default: `26`."
584
+ },
585
+ "bubbleSize": {
586
+ "type": "(value: number) => number",
587
+ "optional": true,
588
+ "description": "Explicit bubble radius `(value) => px`. Overrides the default `minRadius`/`maxRadius` scaling."
589
+ },
590
+ "bubbleColor": {
591
+ "type": "MapStyle<T, string>",
592
+ "optional": true,
593
+ "description": "Bubble fill colour — constant or `(row) => color`. Defaults to the chart blue."
594
+ },
595
+ "bubbleBorderColor": {
596
+ "type": "MapStyle<T, string>",
597
+ "optional": true,
598
+ "description": "Bubble border colour — constant or `(row) => color`. Default: `transparent`."
599
+ },
600
+ "bubbleBorderWidth": {
601
+ "type": "MapStyle<T, number>",
602
+ "optional": true,
603
+ "description": "Bubble border width — constant or `(row) => px`. Default: `0`."
604
+ },
605
+ "center": {
606
+ "type": "[number, number]",
607
+ "optional": true,
608
+ "description": "Map center as `[longitude, latitude]`. Defaults to auto-fit."
609
+ },
610
+ "zoom": {
611
+ "type": "number",
612
+ "optional": true,
613
+ "description": "Zoom level — multiplies the auto-fit scale. Default: `1.25`."
614
+ },
615
+ "roam": {
616
+ "type": "boolean",
617
+ "optional": true,
618
+ "description": "Enable drag-to-pan and scroll-to-zoom. Default: `false`."
619
+ },
620
+ "projection": {
621
+ "type": "MapProjection | null",
622
+ "optional": true,
623
+ "description": "Geographic projection. Defaults to a latitude-clamped Mercator (flat 2D web-map look). Pass another d3-geo projection to override, or `null` for ECharts' raw equirectangular plotting. Use a stable reference (module-level or memoised): a new object each render rebuilds the view and resets a roamed/zoomed map."
624
+ },
625
+ "showTooltip": {
626
+ "type": "boolean",
627
+ "optional": true,
628
+ "description": "Show the tooltip. Default: `true`."
629
+ },
630
+ "valueFormat": {
631
+ "type": "(value: number) => string",
632
+ "optional": true,
633
+ "description": "Format the value for the default tooltip. Default: `toLocaleString()`."
634
+ },
635
+ "tooltipFormatter": {
636
+ "type": "(row: T) => string",
637
+ "optional": true,
638
+ "description": "Override the tooltip content for a row. Returns an HTML string rendered by ECharts' own tooltip. USE WITH CAUTION: the return value is injected as HTML. Escape any user-provided strings to avoid XSS."
639
+ },
640
+ "aspectRatio": {
641
+ "type": "number | string",
642
+ "optional": true,
643
+ "description": "Container aspect ratio as `width / height` (e.g. `1.7` or `\"16 / 9\"`). The height derives from the rendered width so the map fills the frame with no letterboxing. Defaults to the projected aspect of the displayed window, so the land fits edge-to-edge. Pass `height` to fix a pixel height instead."
644
+ },
645
+ "height": {
646
+ "type": "number",
647
+ "optional": true,
648
+ "description": "Fixed chart height in pixels. Overrides `aspectRatio` when set. Leave unset to size by aspect ratio (the default) so the map fills the container."
649
+ },
650
+ "className": {
651
+ "type": "string",
652
+ "optional": true
653
+ },
654
+ "isDarkMode": {
655
+ "type": "boolean",
656
+ "optional": true
657
+ }
658
+ },
659
+ "examples": [
660
+ "<BubbleMap<CfLocation>\n echarts={echarts}\n geoJson={geoJson}\n data={cloudflareLocations}\n lng=\"lon\"\n lat=\"lat\"\n name=\"city\"\n value={() => 1}\n bubbleColor=\"#F6821F\"\n minRadius={8}\n maxRadius={8}\n tooltipFormatter={(row) =>\n `<span style=\"font-size:12px\"><strong>${row.city}</strong><span style=\"color:var(--text-color-kumo-subtle);margin-left:8px\">${row.iata}</span></span>`\n }\n isDarkMode={isDarkMode}\n />",
661
+ "<BubbleMap<Colo>\n echarts={echarts}\n geoJson={geoJson}\n data={colos}\n lng=\"lon\"\n lat=\"lat\"\n name=\"city\"\n value=\"requests\"\n valueFormat={fmt}\n minRadius={8}\n isDarkMode={isDarkMode}\n />",
662
+ "<BubbleMap<Colo>\n echarts={echarts}\n geoJson={geoJson}\n data={colos2}\n lng=\"lon\"\n lat=\"lat\"\n name=\"city\"\n value=\"requests\"\n valueFormat={fmt}\n isDarkMode={isDarkMode}\n />"
663
+ ],
664
+ "colors": []
665
+ },
495
666
  "Button": {
496
667
  "name": "Button",
497
668
  "type": "component",
@@ -664,8 +835,10 @@
664
835
  "<Button variant=\"primary\" loading>\n Loading...\n </Button>",
665
836
  "<Button variant=\"secondary\" disabled>\n Disabled\n </Button>",
666
837
  "<Button variant=\"secondary\">Click me</Button>",
667
- "<div className=\"flex flex-wrap items-center gap-3\">\n <Button variant=\"secondary\" title=\"Create a new Worker\">\n Create Worker\n </Button>\n <Button\n variant=\"secondary\"\n shape=\"square\"\n icon={PlusIcon}\n aria-label=\"Add item\"\n title=\"Add item\"\n />\n </div>",
668
- "<div className=\"flex flex-wrap items-center gap-3\">\n <LinkButton href=\"/components/link\" variant=\"secondary\">\n Read Link docs\n </LinkButton>\n <LinkButton\n href=\"https://developers.cloudflare.com\"\n variant=\"ghost\"\n icon={ArrowSquareOutIcon}\n external\n >\n Cloudflare Docs\n </LinkButton>\n </div>"
838
+ "<div className=\"flex flex-wrap items-center gap-3\">\n <Button variant=\"secondary\" title=\"Create a new Worker\">\n Create Worker\n </Button>\n <Button\n variant=\"secondary\"\n shape=\"square\"\n icon={PlusIcon}\n aria-label=\"Add item\"\n title=\"Add item\"\n />\n <Button\n variant=\"secondary\"\n title=\"You need edit access to create a Worker\"\n disabled\n >\n Create Worker\n </Button>\n </div>",
839
+ "<div className=\"flex flex-wrap items-center gap-3\">\n <LinkButton href=\"/components/link\" variant=\"secondary\">\n Read Link docs\n </LinkButton>\n <LinkButton\n href=\"https://developers.cloudflare.com\"\n variant=\"ghost\"\n icon={ArrowSquareOutIcon}\n external\n >\n Cloudflare Docs\n </LinkButton>\n </div>",
840
+ "<LinkButton\n href=\"/components/link\"\n variant=\"secondary\"\n title=\"Opens the Link component docs\"\n >\n Read Link docs\n </LinkButton>",
841
+ "<div className=\"flex flex-wrap items-center gap-3\">\n <LinkButton href=\"/components/link\" variant=\"secondary\" disabled>\n Disabled link\n </LinkButton>\n <LinkButton\n href=\"/components/link\"\n variant=\"secondary\"\n disabled\n title=\"You need edit access to continue\"\n >\n Disabled with tooltip\n </LinkButton>\n </div>"
669
842
  ],
670
843
  "colors": [
671
844
  "bg-kumo-base",
@@ -680,6 +853,75 @@
680
853
  "text-kumo-subtle"
681
854
  ]
682
855
  },
856
+ "Chart": {
857
+ "name": "Chart",
858
+ "type": "component",
859
+ "description": "Chart — a low-level wrapper around [Apache ECharts](https://echarts.apache.org).",
860
+ "importPath": "@cloudflare/kumo",
861
+ "category": "Data Visualization",
862
+ "props": {
863
+ "echarts": {
864
+ "type": "typeof echarts",
865
+ "required": true,
866
+ "description": "The ECharts core instance imported by the consumer. Passed in rather than imported directly so the consumer controls which ECharts modules are bundled (tree-shaking)."
867
+ },
868
+ "options": {
869
+ "type": "KumoChartOption",
870
+ "required": true,
871
+ "description": "ECharts option object — passed through to `chart.setOption()`"
872
+ },
873
+ "optionUpdateBehavior": {
874
+ "type": "SetOptionOpts",
875
+ "optional": true,
876
+ "description": "Additional options passed as the second argument to `chart.setOption()`. Defaults to `{ notMerge: false, lazyUpdate: true }`."
877
+ },
878
+ "className": {
879
+ "type": "string",
880
+ "optional": true,
881
+ "description": "Additional CSS classes applied to the chart container `<div>`"
882
+ },
883
+ "isDarkMode": {
884
+ "type": "boolean",
885
+ "optional": true,
886
+ "description": "When `true`, initialises ECharts with its built-in dark theme. Changing this value after mount destroys and re-creates the chart instance."
887
+ },
888
+ "height": {
889
+ "type": "number",
890
+ "optional": true,
891
+ "description": "Height of the chart container in pixels. Defaults to `350`."
892
+ },
893
+ "aspectRatio": {
894
+ "type": "number | string",
895
+ "optional": true,
896
+ "description": "Container aspect ratio as `width / height` (e.g. `1.7` or `\"16 / 9\"`). When set, the height derives from the rendered width via CSS `aspect-ratio` and the `height` prop is ignored — useful for maps so the canvas matches the map's shape and fills the frame with no letterboxing."
897
+ }
898
+ },
899
+ "examples": [
900
+ "<Chart\n echarts={echarts}\n options={options}\n height={400}\n isDarkMode={isDarkMode}\n />",
901
+ "<TimeseriesChart\n echarts={echarts}\n isDarkMode={isDarkMode}\n data={data}\n xAxisName=\"Time (UTC)\"\n yAxisName=\"Count\"\n />",
902
+ "<TimeseriesChart\n echarts={echarts}\n isDarkMode={isDarkMode}\n data={data}\n markers={markers}\n xAxisName=\"Time (UTC)\"\n yAxisName=\"Count\"\n />",
903
+ "<TimeseriesChart\n echarts={echarts}\n isDarkMode={isDarkMode}\n data={data}\n thresholds={[\n {\n value: 55,\n label: \"Memory limit\",\n color: ChartPalette.semantic(\"Attention\", isDarkMode),\n },\n ]}\n xAxisName=\"Time (UTC)\"\n yAxisName=\"Memory (MB)\"\n />",
904
+ "<TimeseriesChart\n echarts={echarts}\n isDarkMode={isDarkMode}\n data={data}\n xAxisName=\"Time (UTC)\"\n yAxisName=\"Requests\"\n xAxisTickFormat={(ts) => {\n const d = new Date(ts);\n return `${d.getHours().toString().padStart(2, \"0\")}:${d.getMinutes().toString().padStart(2, \"0\")}`;\n }}\n yAxisTickFormat={(value) => {\n if (value >= 1000) return `${value / 1000}k`;\n return value.toString();\n }}\n tooltipValueFormat={(value) => `${(value / 1000).toFixed(1)}k requests`}\n />",
905
+ "<TimeseriesChart\n yAxisTickCount={2}\n echarts={echarts}\n isDarkMode={isDarkMode}\n data={data}\n height={160}\n />",
906
+ "<TimeseriesChart\n echarts={echarts}\n isDarkMode={isDarkMode}\n data={data}\n xAxisName=\"Time (UTC)\"\n yAxisName=\"Count\"\n gradient\n />",
907
+ "<TimeseriesChart\n echarts={echarts}\n isDarkMode={isDarkMode}\n data={data}\n xAxisName=\"Time (UTC)\"\n yAxisName=\"Mbps\"\n incomplete={{ after: incompleteTimestamp }}\n />",
908
+ "<TimeseriesChart\n echarts={echarts}\n isDarkMode={isDarkMode}\n data={data}\n xAxisName=\"Time (UTC)\"\n yAxisName=\"%\"\n onTimeRangeChange={(from, to) => {\n alert(\n `Selected range:\\nFrom: ${new Date(from).toLocaleString()}\\nTo: ${new Date(to).toLocaleString()}`,\n );\n }}\n />",
909
+ "<Chart\n echarts={echarts}\n options={options}\n height={160}\n isDarkMode={isDarkMode}\n />",
910
+ "<div className=\"space-y-4\">\n <h3 className=\"text-sm font-medium\">Active State</h3>\n\n <div className=\"flex flex-wrap gap-4 divide-x divide-kumo-hairline\">\n <ChartLegend.LargeItem\n name=\"Requests\"\n color={ChartPalette.semantic(\"Neutral\", isDarkMode)}\n value=\"1,234\"\n unit=\"req/s\"\n />\n <ChartLegend.LargeItem\n name=\"Storage\"\n color={ChartPalette.semantic(\"Attention\", isDarkMode)}\n value=\"56\"\n unit=\"GB\"\n />\n <ChartLegend.LargeItem\n name=\"Warnings\"\n color={ChartPalette.semantic(\"Warning\", isDarkMode)}\n value=\"128\"\n />\n </div>\n\n <h3 className=\"mt-12 text-sm font-medium\">Inactive State</h3>\n\n <div className=\"flex flex-wrap gap-4 divide-x divide-kumo-hairline\">\n <ChartLegend.LargeItem\n name=\"Requests\"\n color={ChartPalette.semantic(\"Neutral\", isDarkMode)}\n value=\"1,234\"\n unit=\"req/s\"\n inactive\n />\n <ChartLegend.LargeItem\n name=\"Storage\"\n color={ChartPalette.semantic(\"Attention\", isDarkMode)}\n value=\"56\"\n unit=\"GB\"\n inactive\n />\n <ChartLegend.LargeItem\n name=\"Warnings\"\n color={ChartPalette.semantic(\"Warning\", isDarkMode)}\n value=\"128\"\n inactive\n />\n </div>\n\n <h3 className=\"mt-12 text-sm font-medium\">Loading state</h3>\n\n <div className=\"flex flex-wrap gap-4 divide-x divide-kumo-hairline\">\n <ChartLegend.LargeItem loading />\n </div>\n </div>",
911
+ "<div className=\"space-y-4\">\n <h3 className=\"text-sm font-medium\">Active State</h3>\n <div className=\"flex flex-wrap gap-4\">\n <ChartLegend.SmallItem\n name=\"Requests\"\n color={ChartPalette.semantic(\"Neutral\", isDarkMode)}\n value=\"1,234\"\n unit=\"req/s\"\n />\n <ChartLegend.SmallItem\n name=\"Storage\"\n color={ChartPalette.semantic(\"Attention\", isDarkMode)}\n value=\"56\"\n unit=\"GB\"\n />\n <ChartLegend.SmallItem\n name=\"Warnings\"\n color={ChartPalette.semantic(\"Warning\", isDarkMode)}\n value=\"128\"\n />\n </div>\n\n <h3 className=\"mt-12 text-sm font-medium\">Inactive State</h3>\n <div className=\"flex flex-wrap gap-4\">\n <ChartLegend.SmallItem\n name=\"Requests\"\n color={ChartPalette.semantic(\"Neutral\", isDarkMode)}\n value=\"1,234\"\n unit=\"req/s\"\n inactive\n />\n <ChartLegend.SmallItem\n name=\"Storage\"\n color={ChartPalette.semantic(\"Attention\", isDarkMode)}\n value=\"56\"\n unit=\"GB\"\n inactive\n />\n <ChartLegend.SmallItem\n name=\"Warnings\"\n color={ChartPalette.semantic(\"Warning\", isDarkMode)}\n value=\"128\"\n inactive\n />\n </div>\n\n <h3 className=\"mt-12 text-sm font-medium\">Loading state</h3>\n\n <div className=\"flex flex-wrap gap-4\">\n <ChartLegend.SmallItem loading />\n </div>\n </div>",
912
+ "<TimeseriesChart\n echarts={echarts}\n isDarkMode={isDarkMode}\n type=\"bar\"\n data={data}\n xAxisName=\"Time (UTC)\"\n yAxisName=\"Count\"\n tooltipValueFormat={(r) => r.toFixed(2)}\n />",
913
+ "<div className=\"flex w-full flex-1 flex-col\">\n <TimeseriesChart\n echarts={echarts}\n isDarkMode={isDarkMode}\n xAxisName=\"Time (UTC)\"\n yAxisName=\"Count\"\n data={[]}\n loading\n />\n </div>",
914
+ "<div className=\"flex w-full flex-1 flex-col\">\n <TimeseriesChart\n echarts={echarts}\n isDarkMode={isDarkMode}\n type=\"bar\"\n xAxisName=\"Time (UTC)\"\n yAxisName=\"Count\"\n data={[]}\n loading\n />\n </div>",
915
+ "<div className=\"flex w-full flex-1 flex-col gap-3\">\n <div className=\"flex items-center justify-between\">\n <div className=\"flex flex-wrap gap-4\">\n {data.map((series) => (\n <ChartLegend.SmallItem\n loading={loading}\n key={series.name}\n name={series.name}\n color={series.color}\n value={Math.round(series.data.at(-1)?.[1] ?? 0).toLocaleString()}\n />\n ))}\n </div>\n <Switch\n label=\"Loading\"\n checked={loading}\n onCheckedChange={setLoading}\n />\n </div>\n <TimeseriesChart\n echarts={echarts}\n isDarkMode={isDarkMode}\n xAxisName=\"Time (UTC)\"\n yAxisName=\"Count\"\n data={loading ? [] : data}\n loading={loading}\n />\n </div>",
916
+ "<LayerCard>\n <LayerCard.Secondary>Read latency</LayerCard.Secondary>\n <LayerCard.Primary>\n <div className=\"mb-2 flex gap-4 divide-x divide-kumo-hairline px-2\">\n <ChartLegend.LargeItem\n name=\"P99\"\n color={ChartPalette.semantic(\"Attention\", isDarkMode)}\n value=\"124\"\n unit=\"ms\"\n />\n <ChartLegend.LargeItem\n name=\"P95\"\n color={ChartPalette.semantic(\"Warning\", isDarkMode)}\n value=\"76\"\n unit=\"ms\"\n />\n <ChartLegend.LargeItem\n name=\"P75\"\n color={ChartPalette.semantic(\"Neutral\", isDarkMode)}\n value=\"32\"\n unit=\"ms\"\n />\n <ChartLegend.LargeItem\n name=\"P50\"\n color={ChartPalette.semantic(\"Neutral\", isDarkMode)}\n value=\"10\"\n unit=\"ms\"\n />\n </div>\n <TimeseriesChart\n xAxisName=\"Time (UTC)\"\n echarts={echarts}\n isDarkMode={isDarkMode}\n data={data}\n height={300}\n />\n </LayerCard.Primary>\n </LayerCard>",
917
+ "<LayerCard>\n <LayerCard.Secondary>Read latency</LayerCard.Secondary>\n <LayerCard.Primary>\n <div className=\"mb-2 flex divide-x divide-kumo-line px-2\">\n {series.map((s) => (\n <ChartLegend.LargeItem\n key={s.name}\n name={s.name}\n color={s.color}\n value={s.value}\n unit={s.unit}\n inactive={hoveredSeries !== null && hoveredSeries !== s.name}\n onPointerEnter={() => {\n setHoveredSeries(s.name);\n chartRef.current?.dispatchAction({\n type: \"highlight\",\n seriesName: s.name,\n });\n }}\n onPointerLeave={() => {\n setHoveredSeries(null);\n chartRef.current?.dispatchAction({\n type: \"downplay\",\n seriesName: s.name,\n });\n }}\n className=\"not-first:pl-4\"\n />\n ))}\n </div>\n <TimeseriesChart\n ref={chartRef}\n xAxisName=\"Time (UTC)\"\n echarts={echarts}\n isDarkMode={isDarkMode}\n data={data}\n height={300}\n />\n </LayerCard.Primary>\n </LayerCard>",
918
+ "<LayerCard>\n <LayerCard.Secondary>Read latency</LayerCard.Secondary>\n <LayerCard.Primary>\n <div className=\"mb-2 flex divide-x divide-kumo-line px-2\">\n {series.map((s) => (\n <ChartLegend.LargeItem\n key={s.name}\n name={s.name}\n color={s.color}\n value={s.value}\n unit={s.unit}\n inactive={hiddenSeries[s.name] ?? false}\n onClick={() => handleClick(s.name)}\n className=\"not-first:pl-4\"\n />\n ))}\n </div>\n <TimeseriesChart\n ref={chartRef}\n xAxisName=\"Time (UTC)\"\n echarts={echarts}\n isDarkMode={isDarkMode}\n data={data}\n height={300}\n enableLegendSelection\n />\n </LayerCard.Primary>\n </LayerCard>",
919
+ "<Chart\n echarts={echarts}\n options={options}\n height={400}\n isDarkMode={isDarkMode}\n />",
920
+ "<div className=\"flex w-full flex-col gap-4\">\n <Select\n label=\"Tooltip follow cursor\"\n value={selected}\n onValueChange={(v) => {\n if (v) setSelected(v);\n }}\n renderValue={(v) => v.label}\n >\n {FOLLOW_CURSOR_OPTIONS.map((opt) => (\n <Select.Option key={opt.value} value={opt}>\n {opt.label}\n </Select.Option>\n ))}\n </Select>\n <TimeseriesChart\n echarts={echarts}\n isDarkMode={isDarkMode}\n data={data}\n xAxisName=\"Time (UTC)\"\n yAxisName=\"Latency (ms)\"\n tooltipFollowCursor={selected.value}\n />\n </div>",
921
+ "<div\n ref={boundaryRef}\n className=\"w-full overflow-auto rounded-lg border border-kumo-line\"\n style={{ height: 300 }}\n >\n <TimeseriesChart\n echarts={echarts}\n isDarkMode={isDarkMode}\n data={data}\n xAxisName=\"Time (UTC)\"\n yAxisName=\"Count\"\n height={280}\n tooltipBoundary={boundary ?? undefined}\n />\n </div>"
922
+ ],
923
+ "colors": []
924
+ },
683
925
  "Checkbox": {
684
926
  "name": "Checkbox",
685
927
  "type": "component",
@@ -795,39 +1037,48 @@
795
1037
  "props": {
796
1038
  "legend": {
797
1039
  "type": "string",
798
- "optional": true
1040
+ "optional": true,
1041
+ "description": "Legend text for the group. For more control over legend styling, omit this prop and use `<Checkbox.Legend>` as a child instead."
799
1042
  },
800
1043
  "children": {
801
1044
  "type": "ReactNode",
802
- "required": true
1045
+ "required": true,
1046
+ "description": "Child Checkbox.Item components (and optionally a Checkbox.Legend)"
803
1047
  },
804
1048
  "error": {
805
1049
  "type": "string",
806
- "optional": true
1050
+ "optional": true,
1051
+ "description": "Error message for the group (only appears in groups, not single checkboxes)"
807
1052
  },
808
1053
  "description": {
809
1054
  "type": "ReactNode",
810
- "optional": true
1055
+ "optional": true,
1056
+ "description": "Helper text for the group"
811
1057
  },
812
1058
  "value": {
813
1059
  "type": "string[]",
814
- "optional": true
1060
+ "optional": true,
1061
+ "description": "Values of checkboxes that should be checked (controlled)"
815
1062
  },
816
1063
  "allValues": {
817
1064
  "type": "string[]",
818
- "optional": true
1065
+ "optional": true,
1066
+ "description": "All possible checkbox values (required for parent checkbox pattern)"
819
1067
  },
820
1068
  "disabled": {
821
1069
  "type": "boolean",
822
- "optional": true
1070
+ "optional": true,
1071
+ "description": "Whether all checkboxes in the group are disabled"
823
1072
  },
824
1073
  "controlFirst": {
825
1074
  "type": "boolean",
826
- "optional": true
1075
+ "optional": true,
1076
+ "description": "When true (default), checkbox appears before label. When false, label appears before checkbox."
827
1077
  },
828
1078
  "className": {
829
1079
  "type": "string",
830
- "optional": true
1080
+ "optional": true,
1081
+ "description": "Additional CSS classes"
831
1082
  }
832
1083
  }
833
1084
  },
@@ -837,11 +1088,13 @@
837
1088
  "props": {
838
1089
  "children": {
839
1090
  "type": "ReactNode",
840
- "required": true
1091
+ "required": true,
1092
+ "description": "Legend content"
841
1093
  },
842
1094
  "className": {
843
1095
  "type": "string",
844
- "optional": true
1096
+ "optional": true,
1097
+ "description": "Additional CSS classes (e.g. \"sr-only\" to visually hide the legend)"
845
1098
  }
846
1099
  }
847
1100
  }
@@ -890,6 +1143,122 @@
890
1143
  ]
891
1144
  }
892
1145
  },
1146
+ "ChoroplethMap": {
1147
+ "name": "ChoroplethMap",
1148
+ "type": "component",
1149
+ "description": "ChoroplethMap component",
1150
+ "importPath": "@cloudflare/kumo",
1151
+ "category": "Data Visualization",
1152
+ "props": {
1153
+ "echarts": {
1154
+ "type": "typeof echarts",
1155
+ "required": true,
1156
+ "description": "The ECharts core instance imported by the consumer (passed in for tree-shaking). Requires `MapChart`, `VisualMapComponent`, `TooltipComponent`, and a renderer registered via `echarts.use([...])`."
1157
+ },
1158
+ "geoJson": {
1159
+ "type": "MapGeoJson",
1160
+ "required": true,
1161
+ "description": "GeoJSON `FeatureCollection` whose regions are shaded by value."
1162
+ },
1163
+ "mapName": {
1164
+ "type": "string",
1165
+ "optional": true,
1166
+ "description": "Optional stable ECharts map registry name. Set this when the same GeoJSON is parsed into new object instances across mounts and should reuse one global ECharts registration."
1167
+ },
1168
+ "data": {
1169
+ "type": "T[]",
1170
+ "required": true,
1171
+ "description": "Raw data rows. The region key and value are read via the accessors below."
1172
+ },
1173
+ "name": {
1174
+ "type": "MapAccessor<T, string>",
1175
+ "required": true,
1176
+ "description": "Region-key accessor (key of `T` or `(row) => string`). Each row is joined to a GeoJSON feature whose `nameProperty` equals this value."
1177
+ },
1178
+ "value": {
1179
+ "type": "MapAccessor<T, number>",
1180
+ "required": true,
1181
+ "description": "Value accessor — drives the region's fill colour."
1182
+ },
1183
+ "nameProperty": {
1184
+ "type": "string",
1185
+ "optional": true,
1186
+ "description": "GeoJSON feature property to join on. Default: `\"name\"`. Real-world data is often more reliably matched on an ISO-code property (e.g. `\"iso_a2\"`)."
1187
+ },
1188
+ "colorRange": {
1189
+ "type": "string[]",
1190
+ "optional": true,
1191
+ "description": "Sequential colour ramp (low → high). Defaults to the Kumo choropleth blues, tuned to stay distinct from the no-data fill. Distributed across the continuous gradient."
1192
+ },
1193
+ "noDataColor": {
1194
+ "type": "string",
1195
+ "optional": true,
1196
+ "description": "Fill for regions with no matching data row. Defaults to the neutral land grey."
1197
+ },
1198
+ "showLegend": {
1199
+ "type": "boolean",
1200
+ "optional": true,
1201
+ "description": "Show the visualMap colour legend. Default: `false`."
1202
+ },
1203
+ "showTooltip": {
1204
+ "type": "boolean",
1205
+ "optional": true,
1206
+ "description": "Show the tooltip. Default: `true`."
1207
+ },
1208
+ "valueFormat": {
1209
+ "type": "(value: number) => string",
1210
+ "optional": true,
1211
+ "description": "Format the value for the default tooltip. Default: `toLocaleString()`."
1212
+ },
1213
+ "tooltipFormatter": {
1214
+ "type": "(row: T) => string",
1215
+ "optional": true,
1216
+ "description": "Override the tooltip content for a row. Returns an HTML string rendered by ECharts' own tooltip. USE WITH CAUTION: the return value is injected as HTML. Escape any user-provided strings to avoid XSS."
1217
+ },
1218
+ "center": {
1219
+ "type": "[number, number]",
1220
+ "optional": true,
1221
+ "description": "Map center as `[longitude, latitude]`. Defaults to auto-fit."
1222
+ },
1223
+ "zoom": {
1224
+ "type": "number",
1225
+ "optional": true,
1226
+ "description": "Zoom level — multiplies the auto-fit scale. Default: `1.25`."
1227
+ },
1228
+ "roam": {
1229
+ "type": "boolean",
1230
+ "optional": true,
1231
+ "description": "Enable drag-to-pan and scroll-to-zoom. Default: `false`."
1232
+ },
1233
+ "projection": {
1234
+ "type": "MapProjection | null",
1235
+ "optional": true,
1236
+ "description": "Geographic projection. Defaults to a latitude-clamped Mercator (flat 2D web-map look). Pass another d3-geo projection to override, or `null` for ECharts' raw equirectangular plotting. Use a stable reference (module-level or memoised): a new object each render rebuilds the view and resets a roamed/zoomed map."
1237
+ },
1238
+ "aspectRatio": {
1239
+ "type": "number | string",
1240
+ "optional": true,
1241
+ "description": "Container aspect ratio as `width / height` (e.g. `1.7` or `\"16 / 9\"`). The height derives from the rendered width so the map fills the frame with no letterboxing. Defaults to the projected aspect of the displayed window, so the regions fit edge-to-edge. Pass `height` to fix a pixel height instead."
1242
+ },
1243
+ "height": {
1244
+ "type": "number",
1245
+ "optional": true,
1246
+ "description": "Fixed chart height in pixels. Overrides `aspectRatio` when set. Leave unset to size by aspect ratio (the default) so the map fills the container."
1247
+ },
1248
+ "className": {
1249
+ "type": "string",
1250
+ "optional": true
1251
+ },
1252
+ "isDarkMode": {
1253
+ "type": "boolean",
1254
+ "optional": true
1255
+ }
1256
+ },
1257
+ "examples": [
1258
+ "<ChoroplethMap<CountryTraffic>\n echarts={echarts}\n geoJson={geoJson}\n data={countries}\n name=\"country\"\n value=\"requests\"\n valueFormat={fmt}\n isDarkMode={isDarkMode}\n />"
1259
+ ],
1260
+ "colors": []
1261
+ },
893
1262
  "ClipboardText": {
894
1263
  "name": "ClipboardText",
895
1264
  "type": "component",
@@ -2223,11 +2592,13 @@
2223
2592
  "props": {
2224
2593
  "code": {
2225
2594
  "type": "string",
2226
- "required": true
2595
+ "required": true,
2596
+ "description": "The code string to display."
2227
2597
  },
2228
2598
  "lang": {
2229
2599
  "type": "CodeLang",
2230
- "optional": true
2600
+ "optional": true,
2601
+ "description": "Language hint for the code content."
2231
2602
  }
2232
2603
  }
2233
2604
  }
@@ -2273,8 +2644,8 @@
2273
2644
  "examples": [
2274
2645
  "<div className=\"w-full\">\n <Collapsible.Root open={isOpen} onOpenChange={setIsOpen}>\n <Collapsible.DefaultTrigger>What is Kumo?</Collapsible.DefaultTrigger>\n <Collapsible.DefaultPanel>\n <Text>Kumo is Cloudflare's new design system.</Text>\n </Collapsible.DefaultPanel>\n </Collapsible.Root>\n </div>",
2275
2646
  "<div className=\"w-full\">\n <Collapsible.Root open={isOpen} onOpenChange={setIsOpen}>\n <Collapsible.DefaultTrigger>What is Kumo?</Collapsible.DefaultTrigger>\n <Collapsible.DefaultPanel>\n <Text>Kumo is Cloudflare's new design system.</Text>\n </Collapsible.DefaultPanel>\n </Collapsible.Root>\n </div>",
2276
- "<div className=\"w-full space-y-2\">\n <Collapsible.Root open={open1} onOpenChange={setOpen1}>\n <Collapsible.DefaultTrigger>What is Kumo?</Collapsible.DefaultTrigger>\n <Collapsible.DefaultPanel>\n <Text>Kumo is Cloudflare's new design system.</Text>\n </Collapsible.DefaultPanel>\n </Collapsible.Root>\n <Collapsible.Root open={open2} onOpenChange={setOpen2}>\n <Collapsible.DefaultTrigger>How do I use it?</Collapsible.DefaultTrigger>\n <Collapsible.DefaultPanel>\n <Text>Install the components and import them into your project.</Text>\n </Collapsible.DefaultPanel>\n </Collapsible.Root>\n <Collapsible.Root open={open3} onOpenChange={setOpen3}>\n <Collapsible.DefaultTrigger>Is it open source?</Collapsible.DefaultTrigger>\n <Collapsible.DefaultPanel>\n <Text>Check the repository for license information.</Text>\n </Collapsible.DefaultPanel>\n </Collapsible.Root>\n </div>",
2277
- "<div className=\"w-full\">\n <Collapsible.Root open={isOpen} onOpenChange={setIsOpen}>\n <Collapsible.Trigger\n render={<Button variant=\"secondary\" size=\"sm\" />}\n >\n {isOpen ? \"Hide details\" : \"Show details\"}\n </Collapsible.Trigger>\n <Collapsible.Panel className=\"mt-3 rounded-lg bg-kumo-tint p-4\">\n <Text>\n This panel uses custom styling instead of the default border-left accent.\n </Text>\n </Collapsible.Panel>\n </Collapsible.Root>\n </div>",
2647
+ "<div className=\"w-full space-y-2\">\n <Collapsible.Root open={open1} onOpenChange={setOpen1}>\n <Collapsible.DefaultTrigger>What is Kumo?</Collapsible.DefaultTrigger>\n <Collapsible.DefaultPanel>\n <Text>Kumo is Cloudflare's new design system.</Text>\n </Collapsible.DefaultPanel>\n </Collapsible.Root>\n <Collapsible.Root open={open2} onOpenChange={setOpen2}>\n <Collapsible.DefaultTrigger>\n How do I use it?\n </Collapsible.DefaultTrigger>\n <Collapsible.DefaultPanel>\n <Text>Install the components and import them into your project.</Text>\n </Collapsible.DefaultPanel>\n </Collapsible.Root>\n <Collapsible.Root open={open3} onOpenChange={setOpen3}>\n <Collapsible.DefaultTrigger>\n Is it open source?\n </Collapsible.DefaultTrigger>\n <Collapsible.DefaultPanel>\n <Text>Check the repository for license information.</Text>\n </Collapsible.DefaultPanel>\n </Collapsible.Root>\n </div>",
2648
+ "<div className=\"w-full\">\n <Collapsible.Root open={isOpen} onOpenChange={setIsOpen}>\n <Collapsible.Trigger render={<Button variant=\"secondary\" size=\"sm\" />}>\n {isOpen ? \"Hide details\" : \"Show details\"}\n </Collapsible.Trigger>\n <Collapsible.Panel className=\"mt-3 rounded-lg bg-kumo-tint p-4\">\n <Text>\n This panel uses custom styling instead of the default border-left\n accent.\n </Text>\n </Collapsible.Panel>\n </Collapsible.Root>\n </div>",
2278
2649
  "<div className=\"w-full space-y-4\">\n <Collapsible.Root open={isOpen} onOpenChange={setIsOpen}>\n <Collapsible.DefaultTrigger>Edit details</Collapsible.DefaultTrigger>\n <Collapsible.DefaultPanel keepMounted>\n <Text>\n Type something below, then collapse and re-open — your input is\n preserved because the panel stays mounted.\n </Text>\n <Input label=\"Name\" placeholder=\"Type here…\" />\n </Collapsible.DefaultPanel>\n </Collapsible.Root>\n </div>",
2279
2650
  "<div className=\"w-full space-y-2\">\n {items.map((item, i) => (\n <Collapsible.Root\n key={i}\n open={activeIndex === i}\n onOpenChange={(open) => setActiveIndex(open ? i : null)}\n >\n <Collapsible.DefaultTrigger>{item.title}</Collapsible.DefaultTrigger>\n <Collapsible.DefaultPanel>\n <Text>{item.content}</Text>\n </Collapsible.DefaultPanel>\n </Collapsible.Root>\n ))}\n </div>"
2280
2651
  ],
@@ -2289,7 +2660,8 @@
2289
2660
  "props": {
2290
2661
  "className": {
2291
2662
  "type": "string",
2292
- "optional": true
2663
+ "optional": true,
2664
+ "description": "Additional CSS classes"
2293
2665
  }
2294
2666
  }
2295
2667
  },
@@ -2299,7 +2671,8 @@
2299
2671
  "props": {
2300
2672
  "className": {
2301
2673
  "type": "string",
2302
- "optional": true
2674
+ "optional": true,
2675
+ "description": "Additional CSS classes"
2303
2676
  }
2304
2677
  }
2305
2678
  },
@@ -2309,7 +2682,8 @@
2309
2682
  "props": {
2310
2683
  "className": {
2311
2684
  "type": "string",
2312
- "optional": true
2685
+ "optional": true,
2686
+ "description": "Additional CSS classes"
2313
2687
  }
2314
2688
  }
2315
2689
  },
@@ -2319,11 +2693,13 @@
2319
2693
  "props": {
2320
2694
  "children": {
2321
2695
  "type": "ReactNode",
2322
- "required": true
2696
+ "required": true,
2697
+ "description": "Label text displayed in the trigger"
2323
2698
  },
2324
2699
  "className": {
2325
2700
  "type": "string",
2326
- "optional": true
2701
+ "optional": true,
2702
+ "description": "Additional CSS classes"
2327
2703
  }
2328
2704
  }
2329
2705
  },
@@ -2333,11 +2709,13 @@
2333
2709
  "props": {
2334
2710
  "children": {
2335
2711
  "type": "ReactNode",
2336
- "required": true
2712
+ "required": true,
2713
+ "description": "Panel content"
2337
2714
  },
2338
2715
  "className": {
2339
2716
  "type": "string",
2340
- "optional": true
2717
+ "optional": true,
2718
+ "description": "Additional CSS classes"
2341
2719
  }
2342
2720
  }
2343
2721
  }
@@ -2441,12 +2819,12 @@
2441
2819
  "<Combobox\n value={value}\n onValueChange={(v) => setValue(v as ServerLocation | null)}\n items={servers}\n >\n <Combobox.TriggerInput\n className=\"w-[200px]\"\n placeholder=\"Select server\"\n />\n <Combobox.Content>\n <Combobox.Empty />\n <Combobox.List>\n {(group: ServerLocationGroup) => (\n <Combobox.Group key={group.value} items={group.items}>\n <Combobox.GroupLabel>{group.value}</Combobox.GroupLabel>\n <Combobox.Collection>\n {(item: ServerLocation) => (\n <Combobox.Item key={item.value} value={item}>\n {item.label}\n </Combobox.Item>\n )}\n </Combobox.Collection>\n </Combobox.Group>\n )}\n </Combobox.List>\n </Combobox.Content>\n </Combobox>",
2442
2820
  "<div className=\"flex gap-2\">\n <Combobox\n value={value}\n onValueChange={setValue}\n items={bots}\n isItemEqualToValue={(bot: BotItem, selected: BotItem) =>\n bot.value === selected.value\n }\n multiple\n >\n <Combobox.TriggerMultipleWithInput\n className=\"w-[400px]\"\n placeholder=\"Select bots\"\n renderItem={(selected: BotItem) => (\n <Combobox.Chip key={selected.value}>{selected.label}</Combobox.Chip>\n )}\n inputSide=\"right\"\n />\n <Combobox.Content className=\"max-h-[200px] min-w-auto overflow-y-auto\">\n <Combobox.Empty />\n <Combobox.List>\n {(item: BotItem) => (\n <Combobox.Item key={item.value} value={item}>\n <div className=\"flex gap-2\">\n <Text>{item.label}</Text>\n <Text variant=\"secondary\">{item.author}</Text>\n </div>\n </Combobox.Item>\n )}\n </Combobox.List>\n </Combobox.Content>\n </Combobox>\n <Button variant=\"primary\">Submit</Button>\n </div>",
2443
2821
  "<div className=\"w-80\">\n <Combobox\n items={databases}\n value={value}\n onValueChange={setValue}\n label=\"Database\"\n description=\"Select your preferred database\"\n >\n <Combobox.TriggerInput placeholder=\"Select database\" />\n <Combobox.Content>\n <Combobox.Empty />\n <Combobox.List>\n {(item: DatabaseItem) => (\n <Combobox.Item key={item.value} value={item}>\n {item.label}\n </Combobox.Item>\n )}\n </Combobox.List>\n </Combobox.Content>\n </Combobox>\n </div>",
2444
- "<div className=\"flex flex-wrap gap-4 items-start\">\n <Combobox value=\"Apple\" items={fruits} disabled>\n <Combobox.TriggerInput\n className=\"w-[200px]\"\n placeholder=\"Select fruit\"\n />\n <Combobox.Content>\n <Combobox.Empty />\n <Combobox.List>\n {(item: string) => (\n <Combobox.Item key={item} value={item}>\n {item}\n </Combobox.Item>\n )}\n </Combobox.List>\n </Combobox.Content>\n </Combobox>\n\n <Combobox value={languages[0]} items={languages} disabled>\n <Combobox.TriggerValue className=\"w-[200px]\" />\n <Combobox.Content>\n <Combobox.Input placeholder=\"Search\" />\n <Combobox.Empty />\n <Combobox.List>\n {(item: Language) => (\n <Combobox.Item key={item.value} value={item}>\n {item.emoji} {item.label}\n </Combobox.Item>\n )}\n </Combobox.List>\n </Combobox.Content>\n </Combobox>\n </div>",
2822
+ "<div className=\"flex flex-wrap items-start gap-4\">\n <Combobox value=\"Apple\" items={fruits} disabled>\n <Combobox.TriggerInput\n className=\"w-[200px]\"\n placeholder=\"Select fruit\"\n />\n <Combobox.Content>\n <Combobox.Empty />\n <Combobox.List>\n {(item: string) => (\n <Combobox.Item key={item} value={item}>\n {item}\n </Combobox.Item>\n )}\n </Combobox.List>\n </Combobox.Content>\n </Combobox>\n\n <Combobox value={languages[0]} items={languages} disabled>\n <Combobox.TriggerValue className=\"w-[200px]\" />\n <Combobox.Content>\n <Combobox.Input placeholder=\"Search\" />\n <Combobox.Empty />\n <Combobox.List>\n {(item: Language) => (\n <Combobox.Item key={item.value} value={item}>\n {item.emoji} {item.label}\n </Combobox.Item>\n )}\n </Combobox.List>\n </Combobox.Content>\n </Combobox>\n </div>",
2445
2823
  "<div className=\"w-80\">\n <Combobox value={value} onValueChange={setValue} items={items}>\n <Combobox.TriggerInput placeholder=\"Select database\" />\n <Combobox.Content>\n <Combobox.Empty />\n <Combobox.List>\n {(item: DatabaseItemWithDisabled) => (\n <Combobox.Item\n key={item.value}\n value={item}\n disabled={item.disabled}\n >\n <span>\n {item.label}\n {item.reason && (\n <Text variant=\"secondary\" size=\"xs\" as=\"span\">\n {\" — \"}\n {item.reason}\n </Text>\n )}\n </span>\n </Combobox.Item>\n )}\n </Combobox.List>\n </Combobox.Content>\n </Combobox>\n </div>",
2446
2824
  "<div className=\"w-80\">\n <Combobox\n items={databases}\n value={value}\n onValueChange={setValue}\n label=\"Database\"\n error={{ message: \"Please select a database\", match: true }}\n >\n <Combobox.TriggerInput placeholder=\"Select database\" />\n <Combobox.Content>\n <Combobox.Empty />\n <Combobox.List>\n {(item: DatabaseItem) => (\n <Combobox.Item key={item.value} value={item}>\n {item.label}\n </Combobox.Item>\n )}\n </Combobox.List>\n </Combobox.Content>\n </Combobox>\n </div>",
2447
2825
  "<div className=\"flex flex-wrap items-center gap-4\">\n <Combobox\n size=\"sm\"\n value={smValue}\n onValueChange={(v) => setSmValue(v as string | null)}\n items={fruits.slice(0, 8)}\n >\n <Combobox.TriggerInput placeholder=\"Small (sm)\" />\n <Combobox.Content>\n <Combobox.Empty />\n <Combobox.List>\n {(item: string) => (\n <Combobox.Item key={item} value={item}>\n {item}\n </Combobox.Item>\n )}\n </Combobox.List>\n </Combobox.Content>\n </Combobox>\n <Combobox\n size=\"base\"\n value={baseValue}\n onValueChange={(v) => setBaseValue(v as string | null)}\n items={fruits.slice(0, 8)}\n >\n <Combobox.TriggerInput placeholder=\"Base (default)\" />\n <Combobox.Content>\n <Combobox.Empty />\n <Combobox.List>\n {(item: string) => (\n <Combobox.Item key={item} value={item}>\n {item}\n </Combobox.Item>\n )}\n </Combobox.List>\n </Combobox.Content>\n </Combobox>\n </div>",
2448
2826
  "<div className=\"flex flex-wrap items-center gap-4\">\n <Combobox\n size=\"sm\"\n value={smValue}\n onValueChange={(v) => setSmValue(v as Language)}\n items={languages}\n >\n <Combobox.TriggerValue className=\"w-[160px]\" />\n <Combobox.Content>\n <Combobox.Input placeholder=\"Search\" />\n <Combobox.Empty />\n <Combobox.List>\n {(item: Language) => (\n <Combobox.Item key={item.value} value={item}>\n {item.emoji} {item.label}\n </Combobox.Item>\n )}\n </Combobox.List>\n </Combobox.Content>\n </Combobox>\n <Combobox\n size=\"base\"\n value={baseValue}\n onValueChange={(v) => setBaseValue(v as Language)}\n items={languages}\n >\n <Combobox.TriggerValue className=\"w-[180px]\" />\n <Combobox.Content>\n <Combobox.Input placeholder=\"Search\" />\n <Combobox.Empty />\n <Combobox.List>\n {(item: Language) => (\n <Combobox.Item key={item.value} value={item}>\n {item.emoji} {item.label}\n </Combobox.Item>\n )}\n </Combobox.List>\n </Combobox.Content>\n </Combobox>\n </div>",
2449
- "<Combobox\n value={value}\n onValueChange={(v) => setValue(v as Language)}\n items={languages}\n >\n <Combobox.Trigger\n render={\n <Button variant=\"ghost\" size=\"sm\" />\n }\n >\n <Combobox.Value>\n <span className=\"truncate\">\n {value.emoji} {value.label}\n </span>\n </Combobox.Value>\n <CaretUpDownIcon size={14} className=\"text-kumo-subtle shrink-0\" />\n </Combobox.Trigger>\n <Combobox.Content>\n <Combobox.Input placeholder=\"Search languages\" />\n <Combobox.Empty />\n <Combobox.List>\n {(item: Language) => (\n <Combobox.Item key={item.value} value={item}>\n {item.emoji} {item.label}\n </Combobox.Item>\n )}\n </Combobox.List>\n </Combobox.Content>\n </Combobox>"
2827
+ "<Combobox\n value={value}\n onValueChange={(v) => setValue(v as Language)}\n items={languages}\n >\n <Combobox.Trigger render={<Button variant=\"ghost\" size=\"sm\" />}>\n <Combobox.Value>\n <span className=\"truncate\">\n {value.emoji} {value.label}\n </span>\n </Combobox.Value>\n <CaretUpDownIcon size={14} className=\"shrink-0 text-kumo-subtle\" />\n </Combobox.Trigger>\n <Combobox.Content>\n <Combobox.Input placeholder=\"Search languages\" />\n <Combobox.Empty />\n <Combobox.List>\n {(item: Language) => (\n <Combobox.Item key={item.value} value={item}>\n {item.emoji} {item.label}\n </Combobox.Item>\n )}\n </Combobox.List>\n </Combobox.Content>\n </Combobox>"
2450
2828
  ],
2451
2829
  "colors": [
2452
2830
  "bg-kumo-base",
@@ -2645,7 +3023,7 @@
2645
3023
  "<Popover>\n <Popover.Trigger\n render={<Button variant=\"outline\" icon={CalendarDotsIcon} />}\n >\n {date ? date.toLocaleDateString() : \"Pick a date\"}\n </Popover.Trigger>\n <Popover.Content className=\"p-3\">\n <DatePicker mode=\"single\" selected={date} onChange={setDate} />\n </Popover.Content>\n </Popover>",
2646
3024
  "<Popover>\n <Popover.Trigger\n render={<Button variant=\"outline\" icon={CalendarDotsIcon} />}\n >\n {formatRange()}\n </Popover.Trigger>\n <Popover.Content className=\"p-3\">\n <DatePicker\n mode=\"range\"\n selected={range}\n onChange={setRange}\n numberOfMonths={2}\n />\n </Popover.Content>\n </Popover>",
2647
3025
  "<Popover>\n <Popover.Trigger\n render={<Button variant=\"outline\" icon={CalendarDotsIcon} />}\n >\n {formatRange()}\n </Popover.Trigger>\n <Popover.Content className=\"p-0\">\n <div className=\"flex\">\n <div className=\"flex flex-col gap-1 border-r border-kumo-hairline p-2 text-sm\">\n {presets.map((preset) => {\n const isActive = isPresetActive(preset);\n return (\n <button\n key={preset.label}\n type=\"button\"\n onClick={() => handlePresetClick(preset)}\n className={`rounded-md px-3 py-1.5 text-left whitespace-nowrap ${\n isActive\n ? \"bg-kumo-bg-inverse text-kumo-text-inverse\"\n : \"text-kumo-subtle hover:bg-kumo-control\"\n }`}\n >\n {preset.label}\n </button>\n );\n })}\n </div>\n <div className=\"p-3\">\n <DatePicker\n mode=\"range\"\n selected={range}\n onChange={setRange}\n month={month}\n onMonthChange={setMonth}\n numberOfMonths={2}\n />\n </div>\n </div>\n </Popover.Content>\n </Popover>",
2648
- "<DatePicker\n mode=\"multiple\"\n selected={dates}\n onChange={setDates}\n max={maxDays}\n disabled={unavailableDates}\n fixedWeeks\n footer={\n <p className=\"text-xs text-kumo-subtle pt-2 w-full\">\n {selectedCount}/{maxDays} days selected. Grayed dates are unavailable.\n </p>\n }\n />"
3026
+ "<DatePicker\n mode=\"multiple\"\n selected={dates}\n onChange={setDates}\n max={maxDays}\n disabled={unavailableDates}\n fixedWeeks\n footer={\n <p className=\"w-full pt-2 text-xs text-kumo-subtle\">\n {selectedCount}/{maxDays} days selected. Grayed dates are unavailable.\n </p>\n }\n />"
2649
3027
  ],
2650
3028
  "colors": [
2651
3029
  "bg-kumo-base"
@@ -2822,10 +3200,10 @@
2822
3200
  "examples": [
2823
3201
  "<Dialog.Root>\n <Dialog.Trigger render={(p) => <Button {...p}>Click me</Button>} />\n <Dialog className=\"p-8\">\n <div className=\"mb-4 flex items-start justify-between gap-4\">\n <Dialog.Title className=\"text-2xl font-semibold\">\n Modal Title\n </Dialog.Title>\n <Dialog.Close\n aria-label=\"Close\"\n render={(props) => (\n <Button\n {...props}\n variant=\"secondary\"\n shape=\"square\"\n icon={<X />}\n aria-label=\"Close\"\n />\n )}\n />\n </div>\n <Dialog.Description className=\"text-kumo-subtle\">\n Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do\n eiusmod tempor incididunt ut labore et dolore magna aliqua.\n </Dialog.Description>\n </Dialog>\n </Dialog.Root>",
2824
3202
  "<Dialog.Root>\n <Dialog.Trigger render={(p) => <Button {...p}>Delete</Button>} />\n <Dialog className=\"p-8\">\n <div className=\"mb-4 flex items-start justify-between gap-4\">\n <Dialog.Title className=\"text-2xl font-semibold\">\n Modal Title\n </Dialog.Title>\n <Dialog.Close\n aria-label=\"Close\"\n render={(props) => (\n <Button\n {...props}\n variant=\"secondary\"\n shape=\"square\"\n icon={<X />}\n aria-label=\"Close\"\n />\n )}\n />\n </div>\n <Dialog.Description className=\"text-kumo-subtle\">\n Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do\n eiusmod tempor incididunt ut labore et dolore magna aliqua.\n </Dialog.Description>\n <div className=\"mt-8 flex justify-end gap-2\">\n <Dialog.Close\n render={(props) => (\n <Button variant=\"secondary\" {...props}>\n Cancel\n </Button>\n )}\n />\n <Dialog.Close\n render={(props) => (\n <Button variant=\"destructive\" {...props}>\n Delete\n </Button>\n )}\n />\n </div>\n </Dialog>\n </Dialog.Root>",
2825
- "<Dialog.Root>\n <Dialog.Trigger render={(p) => <Button {...p}>Open capped dialog</Button>} />\n <Dialog className=\"max-w-lg p-8\">\n <div className=\"mb-4 flex items-start justify-between gap-4\">\n <Dialog.Title className=\"text-2xl font-semibold\">\n Max width override\n </Dialog.Title>\n <Dialog.Close\n aria-label=\"Close\"\n render={(props) => (\n <Button\n {...props}\n variant=\"secondary\"\n shape=\"square\"\n icon={<X />}\n aria-label=\"Close\"\n />\n )}\n />\n </div>\n <Dialog.Description className=\"text-kumo-subtle\">\n This dialog uses <code>className=\"max-w-lg\"</code> and should stay\n capped around 512px on desktop.\n </Dialog.Description>\n <div className=\"mt-4 truncate rounded-md border border-kumo-line bg-kumo-recessed p-3 font-mono text-sm\">\n abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789\n </div>\n </Dialog>\n </Dialog.Root>",
3203
+ "<Dialog.Root>\n <Dialog.Trigger\n render={(p) => <Button {...p}>Open capped dialog</Button>}\n />\n <Dialog className=\"max-w-lg p-8\">\n <div className=\"mb-4 flex items-start justify-between gap-4\">\n <Dialog.Title className=\"text-2xl font-semibold\">\n Max width override\n </Dialog.Title>\n <Dialog.Close\n aria-label=\"Close\"\n render={(props) => (\n <Button\n {...props}\n variant=\"secondary\"\n shape=\"square\"\n icon={<X />}\n aria-label=\"Close\"\n />\n )}\n />\n </div>\n <Dialog.Description className=\"text-kumo-subtle\">\n This dialog uses <code>className=\"max-w-lg\"</code> and should stay\n capped around 512px on desktop.\n </Dialog.Description>\n <div className=\"mt-4 truncate rounded-md border border-kumo-line bg-kumo-recessed p-3 font-mono text-sm\">\n abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789\n </div>\n </Dialog>\n </Dialog.Root>",
2826
3204
  "<Dialog.Root disablePointerDismissal>\n <Dialog.Trigger\n render={(p) => (\n <Button {...p} variant=\"destructive\">\n Delete Project\n </Button>\n )}\n />\n <Dialog className=\"p-8\">\n <div className=\"mb-4 flex items-center gap-3\">\n <div className=\"flex h-10 w-10 items-center justify-center rounded-full bg-kumo-danger/20\">\n <Warning size={20} className=\"text-kumo-danger\" />\n </div>\n <Dialog.Title className=\"text-xl font-semibold\">\n Delete Project?\n </Dialog.Title>\n </div>\n <Dialog.Description className=\"text-kumo-subtle\">\n This action cannot be undone. This will permanently delete the project\n and all associated data.\n </Dialog.Description>\n <div className=\"mt-8 flex justify-end gap-2\">\n <Dialog.Close\n render={(props) => (\n <Button variant=\"secondary\" {...props}>\n Cancel\n </Button>\n )}\n />\n <Dialog.Close\n render={(props) => (\n <Button variant=\"destructive\" {...props}>\n Delete\n </Button>\n )}\n />\n </div>\n </Dialog>\n </Dialog.Root>",
2827
3205
  "<Dialog.Root role=\"alertdialog\">\n <Dialog.Trigger\n render={(p) => (\n <Button {...p} variant=\"destructive\">\n Delete Account\n </Button>\n )}\n />\n <Dialog className=\"p-8\">\n <div className=\"mb-4 flex items-center gap-3\">\n <div className=\"flex h-10 w-10 items-center justify-center rounded-full bg-kumo-danger/20\">\n <Warning size={20} className=\"text-kumo-danger\" weight=\"fill\" />\n </div>\n <Dialog.Title className=\"text-xl font-semibold\">\n Delete Account?\n </Dialog.Title>\n </div>\n <Dialog.Description className=\"text-kumo-subtle\">\n This action cannot be undone. All your data will be permanently\n removed from our servers. Are you sure you want to proceed?\n </Dialog.Description>\n <div className=\"mt-8 flex justify-end gap-2\">\n <Dialog.Close\n render={(props) => (\n <Button variant=\"secondary\" {...props}>\n Cancel\n </Button>\n )}\n />\n <Dialog.Close\n render={(props) => (\n <Button variant=\"destructive\" {...props}>\n Delete Account\n </Button>\n )}\n />\n </div>\n </Dialog>\n </Dialog.Root>",
2828
- "<Dialog.Root>\n <Dialog.Trigger render={(p) => <Button {...p}>Open Form</Button>} />\n <Dialog className=\"p-8\">\n <div className=\"mb-4 flex items-start justify-between gap-4\">\n <Dialog.Title className=\"text-2xl font-semibold\">\n Create Resource\n </Dialog.Title>\n <Dialog.Close\n aria-label=\"Close\"\n render={(props) => (\n <Button\n {...props}\n variant=\"secondary\"\n shape=\"square\"\n icon={<X />}\n aria-label=\"Close\"\n />\n )}\n />\n </div>\n <Dialog.Description className=\"mb-4 text-kumo-subtle\">\n Select a region for your new resource.\n </Dialog.Description>\n <Select\n className=\"w-full\"\n placeholder=\"Select region...\"\n renderValue={(v) =>\n regions.find((r) => r.value === v)?.label\n }\n >\n {regions.map((region) => (\n <Select.Option key={region.value} value={region.value}>\n {region.label}\n </Select.Option>\n ))}\n </Select>\n <div className=\"mt-8 flex justify-end gap-2\">\n <Dialog.Close\n render={(props) => (\n <Button variant=\"secondary\" {...props}>\n Cancel\n </Button>\n )}\n />\n <Button variant=\"primary\">Create</Button>\n </div>\n </Dialog>\n </Dialog.Root>",
3206
+ "<Dialog.Root>\n <Dialog.Trigger render={(p) => <Button {...p}>Open Form</Button>} />\n <Dialog className=\"p-8\">\n <div className=\"mb-4 flex items-start justify-between gap-4\">\n <Dialog.Title className=\"text-2xl font-semibold\">\n Create Resource\n </Dialog.Title>\n <Dialog.Close\n aria-label=\"Close\"\n render={(props) => (\n <Button\n {...props}\n variant=\"secondary\"\n shape=\"square\"\n icon={<X />}\n aria-label=\"Close\"\n />\n )}\n />\n </div>\n <Dialog.Description className=\"mb-4 text-kumo-subtle\">\n Select a region for your new resource.\n </Dialog.Description>\n <Select\n className=\"w-full\"\n placeholder=\"Select region...\"\n renderValue={(v) => regions.find((r) => r.value === v)?.label}\n >\n {regions.map((region) => (\n <Select.Option key={region.value} value={region.value}>\n {region.label}\n </Select.Option>\n ))}\n </Select>\n <div className=\"mt-8 flex justify-end gap-2\">\n <Dialog.Close\n render={(props) => (\n <Button variant=\"secondary\" {...props}>\n Cancel\n </Button>\n )}\n />\n <Button variant=\"primary\">Create</Button>\n </div>\n </Dialog>\n </Dialog.Root>",
2829
3207
  "<Dialog.Root>\n <Dialog.Trigger render={(p) => <Button {...p}>Open Form</Button>} />\n <Dialog className=\"p-8\">\n <div className=\"mb-4 flex items-start justify-between gap-4\">\n <Dialog.Title className=\"text-2xl font-semibold\">\n Create Resource\n </Dialog.Title>\n <Dialog.Close\n aria-label=\"Close\"\n render={(props) => (\n <Button\n {...props}\n variant=\"secondary\"\n shape=\"square\"\n icon={<X />}\n aria-label=\"Close\"\n />\n )}\n />\n </div>\n <Dialog.Description className=\"mb-4 text-kumo-subtle\">\n Search and select a region for your new resource.\n </Dialog.Description>\n <Combobox value={value} onValueChange={setValue} items={regions}>\n <Combobox.TriggerInput\n className=\"w-full\"\n placeholder=\"Search regions...\"\n />\n <Combobox.Content>\n <Combobox.Empty>No regions found</Combobox.Empty>\n <Combobox.List>\n {(item: { value: string; label: string }) => (\n <Combobox.Item key={item.value} value={item}>\n {item.label}\n </Combobox.Item>\n )}\n </Combobox.List>\n </Combobox.Content>\n </Combobox>\n <div className=\"mt-8 flex justify-end gap-2\">\n <Dialog.Close\n render={(props) => (\n <Button variant=\"secondary\" {...props}>\n Cancel\n </Button>\n )}\n />\n <Button variant=\"primary\">Create</Button>\n </div>\n </Dialog>\n </Dialog.Root>",
2830
3208
  "<Dialog.Root>\n <Dialog.Trigger render={(p) => <Button {...p}>Open Form</Button>} />\n <Dialog className=\"p-8\">\n <div className=\"mb-4 flex items-start justify-between gap-4\">\n <Dialog.Title className=\"text-2xl font-semibold\">\n Resource Actions\n </Dialog.Title>\n <Dialog.Close\n aria-label=\"Close\"\n render={(props) => (\n <Button\n {...props}\n variant=\"secondary\"\n shape=\"square\"\n icon={<X />}\n aria-label=\"Close\"\n />\n )}\n />\n </div>\n <Dialog.Description className=\"mb-4 text-kumo-subtle\">\n Choose an action for the selected resource.\n </Dialog.Description>\n <DropdownMenu>\n <DropdownMenu.Trigger render={<Button>Actions</Button>} />\n <DropdownMenu.Content>\n <DropdownMenu.Item>Edit</DropdownMenu.Item>\n <DropdownMenu.Item>Duplicate</DropdownMenu.Item>\n <DropdownMenu.Separator />\n <DropdownMenu.Item variant=\"danger\">Delete</DropdownMenu.Item>\n </DropdownMenu.Content>\n </DropdownMenu>\n <div className=\"mt-8 flex justify-end\">\n <Dialog.Close\n render={(props) => (\n <Button variant=\"secondary\" {...props}>\n Close\n </Button>\n )}\n />\n </div>\n </Dialog>\n </Dialog.Root>",
2831
3209
  "<div className=\"flex flex-wrap gap-2\">\n {sizes.map(({ size, label, width }) => (\n <Dialog.Root key={size}>\n <Dialog.Trigger\n render={(p) => (\n <Button variant=\"secondary\" {...p}>\n {label} ({width})\n </Button>\n )}\n />\n <Dialog size={size} className=\"p-8\">\n <div className=\"mb-4 flex items-start justify-between gap-4\">\n <Dialog.Title className=\"text-2xl font-semibold\">\n {label} Dialog\n </Dialog.Title>\n <Dialog.Close\n aria-label=\"Close\"\n render={(props) => (\n <Button\n {...props}\n variant=\"secondary\"\n shape=\"square\"\n icon={<X />}\n aria-label=\"Close\"\n />\n )}\n />\n </div>\n <Dialog.Description className=\"text-kumo-subtle\">\n This <code>size=\"{size}\"</code> dialog should stay at {width} wide\n regardless of the content below.\n </Dialog.Description>\n <div className=\"mt-4 overflow-auto rounded-md border border-kumo-line\">\n <table className=\"w-max text-sm\">\n <thead className=\"bg-kumo-elevated text-left\">\n <tr>\n <th className=\"px-3 py-2\">Resource</th>\n <th className=\"px-3 py-2\">Region</th>\n <th className=\"px-3 py-2\">Status</th>\n <th className=\"px-3 py-2\">Latency</th>\n <th className=\"px-3 py-2\">Requests</th>\n <th className=\"px-3 py-2\">Last Deployed</th>\n </tr>\n </thead>\n <tbody className=\"divide-y divide-kumo-hairline\">\n <tr>\n <td className=\"px-3 py-2\">api-gateway-prod</td>\n <td className=\"px-3 py-2\">us-east-1</td>\n <td className=\"px-3 py-2 text-kumo-success\">Healthy</td>\n <td className=\"px-3 py-2\">12ms</td>\n <td className=\"px-3 py-2\">1,234,567</td>\n <td className=\"px-3 py-2\">2026-06-23</td>\n </tr>\n <tr>\n <td className=\"px-3 py-2\">worker-analytics</td>\n <td className=\"px-3 py-2\">eu-west-1</td>\n <td className=\"px-3 py-2 text-kumo-warning\">Degraded</td>\n <td className=\"px-3 py-2\">89ms</td>\n <td className=\"px-3 py-2\">456,789</td>\n <td className=\"px-3 py-2\">2026-06-22</td>\n </tr>\n </tbody>\n </table>\n </div>\n <div className=\"mt-6 flex justify-end gap-2\">\n <Dialog.Close\n render={(props) => (\n <Button variant=\"secondary\" {...props}>\n Close\n </Button>\n )}\n />\n </div>\n </Dialog>\n </Dialog.Root>\n ))}\n </div>"
@@ -3703,7 +4081,7 @@
3703
4081
  "<div className=\"flex flex-col gap-4\">\n <InputGroup className=\"w-full max-w-3xs\">\n <InputGroup.Addon>@</InputGroup.Addon>\n <InputGroup.Input placeholder=\"username\" aria-label=\"Username\" />\n </InputGroup>\n\n <InputGroup className=\"w-full max-w-3xs\">\n <InputGroup.Input placeholder=\"email\" aria-label=\"Email\" />\n <InputGroup.Addon align=\"end\">@example.com</InputGroup.Addon>\n </InputGroup>\n\n <InputGroup className=\"w-full max-w-3xs\">\n <InputGroup.Addon>/api/</InputGroup.Addon>\n <InputGroup.Input placeholder=\"endpoint\" aria-label=\"API path\" />\n <InputGroup.Addon align=\"end\">.json</InputGroup.Addon>\n </InputGroup>\n </div>",
3704
4082
  "<div className=\"flex flex-col gap-4\">\n <InputGroup className=\"w-full max-w-3xs\">\n <InputGroup.Input\n type={show ? \"text\" : \"password\"}\n defaultValue=\"password\"\n aria-label=\"Password\"\n />\n <InputGroup.Addon align=\"end\">\n <InputGroup.Button\n shape=\"square\"\n className=\"text-kumo-subtle\"\n icon={show ? EyeSlashIcon : EyeIcon}\n aria-label={show ? \"Hide password\" : \"Show password\"}\n onClick={() => setShow(!show)}\n />\n </InputGroup.Addon>\n </InputGroup>\n\n <InputGroup className=\"w-full max-w-3xs\">\n <InputGroup.Addon>\n <MagnifyingGlassIcon />\n </InputGroup.Addon>\n <InputGroup.Input\n value={searchValue}\n placeholder=\"Search\"\n aria-label=\"Search\"\n onChange={(e) => setSearchValue(e.target.value)}\n />\n {searchValue && (\n <InputGroup.Addon align=\"end\" className=\"pr-1\">\n <InputGroup.Button\n shape=\"square\"\n icon={XIcon}\n aria-label=\"Clear search\"\n onClick={() => setSearchValue(\"\")}\n />\n </InputGroup.Addon>\n )}\n <InputGroup.Button variant=\"secondary\" onClick={() => {}}>\n Search\n </InputGroup.Button>\n </InputGroup>\n </div>",
3705
4083
  "<InputGroup className=\"w-full max-w-2xs\">\n <InputGroup.Addon>\n <MagnifyingGlassIcon />\n </InputGroup.Addon>\n <InputGroup.Input\n placeholder=\"Search with query language...\"\n aria-label=\"Search\"\n />\n <InputGroup.Addon align=\"end\">\n <InputGroup.Button\n shape=\"square\"\n className=\"text-kumo-subtle\"\n icon={QuestionIcon}\n aria-label=\"Query language help\"\n tooltip=\"Query language help\"\n onClick={() => {}}\n />\n </InputGroup.Addon>\n </InputGroup>",
3706
- "<InputGroup className=\"w-full max-w-3xs\">\n <InputGroup.Addon>\n <MagnifyingGlassIcon />\n </InputGroup.Addon>\n <InputGroup.Input placeholder=\"Search...\" aria-label=\"Search\" />\n <InputGroup.Addon align=\"end\">\n <kbd className=\"bg-none! border-none!\">⌘K</kbd>\n </InputGroup.Addon>\n </InputGroup>",
4084
+ "<InputGroup className=\"w-full max-w-3xs\">\n <InputGroup.Addon>\n <MagnifyingGlassIcon />\n </InputGroup.Addon>\n <InputGroup.Input placeholder=\"Search...\" aria-label=\"Search\" />\n <InputGroup.Addon align=\"end\">\n <kbd className=\"border-none! bg-none!\">⌘K</kbd>\n </InputGroup.Addon>\n </InputGroup>",
3707
4085
  "<InputGroup className=\"w-full max-w-3xs\">\n <InputGroup.Input defaultValue=\"kumo\" aria-label=\"kumo\" />\n <InputGroup.Addon align=\"end\">\n <Loader />\n </InputGroup.Addon>\n </InputGroup>",
3708
4086
  "<div className=\"flex w-full max-w-2xs flex-col gap-4\">\n <InputGroup label=\"Subdomain\">\n <InputGroup.Input\n aria-label=\"Subdomain\"\n defaultValue=\"kumo\"\n maxLength={20}\n />\n <InputGroup.Suffix>.workers.dev</InputGroup.Suffix>\n <InputGroup.Addon align=\"end\">\n <CheckCircleIcon weight=\"duotone\" className=\"text-kumo-success\" />\n </InputGroup.Addon>\n </InputGroup>\n\n <InputGroup\n label=\"Subdomain\"\n error={{ message: \"This subdomain is unavailable\", match: true }}\n >\n <InputGroup.Input\n aria-label=\"Subdomain\"\n defaultValue=\"kumo\"\n maxLength={20}\n />\n <InputGroup.Suffix>.workers.dev</InputGroup.Suffix>\n <InputGroup.Addon align=\"end\">\n <XCircleIcon weight=\"duotone\" className=\"text-kumo-danger\" />\n </InputGroup.Addon>\n </InputGroup>\n </div>",
3709
4087
  "<div className=\"flex w-full max-w-3xs flex-col gap-4\">\n <InputGroup size=\"xs\" label=\"Extra Small\">\n <InputGroup.Addon>\n <MagnifyingGlassIcon />\n </InputGroup.Addon>\n <InputGroup.Input placeholder=\"Extra small input\" />\n <InputGroup.Addon align=\"end\">\n <InputGroup.Button\n className=\"text-kumo-subtle\"\n icon={QuestionIcon}\n shape=\"square\"\n aria-label=\"Help\"\n />\n </InputGroup.Addon>\n </InputGroup>\n\n <InputGroup size=\"sm\" label=\"Small\">\n <InputGroup.Addon>\n <MagnifyingGlassIcon />\n </InputGroup.Addon>\n <InputGroup.Input placeholder=\"Small input\" />\n <InputGroup.Addon align=\"end\">\n <InputGroup.Button\n className=\"text-kumo-subtle\"\n icon={QuestionIcon}\n shape=\"square\"\n aria-label=\"Help\"\n />\n </InputGroup.Addon>\n </InputGroup>\n\n <InputGroup label=\"Base (default)\">\n <InputGroup.Addon>\n <MagnifyingGlassIcon />\n </InputGroup.Addon>\n <InputGroup.Input placeholder=\"Base input\" />\n <InputGroup.Addon align=\"end\">\n <InputGroup.Button\n className=\"text-kumo-subtle\"\n icon={QuestionIcon}\n shape=\"square\"\n aria-label=\"Help\"\n />\n </InputGroup.Addon>\n </InputGroup>\n\n <InputGroup size=\"lg\" label=\"Large\">\n <InputGroup.Addon>\n <MagnifyingGlassIcon />\n </InputGroup.Addon>\n <InputGroup.Input placeholder=\"Large input\" />\n <InputGroup.Addon align=\"end\">\n <InputGroup.Button\n className=\"text-kumo-subtle\"\n icon={QuestionIcon}\n shape=\"square\"\n aria-label=\"Help\"\n />\n </InputGroup.Addon>\n </InputGroup>\n </div>",
@@ -3871,7 +4249,7 @@
3871
4249
  "examples": [
3872
4250
  "<LayerCard>\n <LayerCard.Secondary className=\"flex items-center justify-between\">\n <div>Next Steps</div>\n <Button\n variant=\"ghost\"\n size=\"sm\"\n shape=\"square\"\n aria-label=\"Go to next steps\"\n >\n <ArrowRightIcon size={16} />\n </Button>\n </LayerCard.Secondary>\n\n <LayerCard.Primary>Get started with Kumo</LayerCard.Primary>\n </LayerCard>",
3873
4251
  "<LayerCard className=\"w-[250px]\">\n <LayerCard.Secondary>Getting Started</LayerCard.Secondary>\n <LayerCard.Primary>\n <p className=\"text-sm text-kumo-subtle\">\n Quick start guide for new users\n </p>\n </LayerCard.Primary>\n </LayerCard>",
3874
- "<LayerCard className=\"w-[250px] p-4\">\n <p className=\"text-sm text-kumo-subtle\">Quick start guide for new users</p>\n </LayerCard>",
4252
+ "<LayerCard className=\"w-[250px] p-4\">\n <p className=\"text-sm text-kumo-subtle\">\n Quick start guide for new users\n </p>\n </LayerCard>",
3875
4253
  "<LayerCard className=\"w-[250px]\">\n <LayerCard.Secondary data-testid=\"card-header\">\n Getting Started\n </LayerCard.Secondary>\n <LayerCard.Primary data-testid=\"card-body\">\n <p className=\"text-sm text-kumo-subtle\">\n Quick start guide for new users\n </p>\n </LayerCard.Primary>\n </LayerCard>",
3876
4254
  "<div className=\"flex gap-4\">\n <LayerCard className=\"w-[200px]\">\n <LayerCard.Secondary>Components</LayerCard.Secondary>\n <LayerCard.Primary>\n <p className=\"text-sm\">Browse all components</p>\n </LayerCard.Primary>\n </LayerCard>\n <LayerCard className=\"w-[200px]\">\n <LayerCard.Secondary>Examples</LayerCard.Secondary>\n <LayerCard.Primary>\n <p className=\"text-sm\">View code examples</p>\n </LayerCard.Primary>\n </LayerCard>\n </div>"
3877
4255
  ],
@@ -4271,24 +4649,14 @@
4271
4649
  "description": "Info sub-component",
4272
4650
  "props": {
4273
4651
  "children": {
4274
- "type": "(props: {",
4275
- "optional": true
4276
- },
4277
- "page": {
4278
- "type": "number",
4279
- "required": true
4280
- },
4281
- "perPage": {
4282
- "type": "number",
4283
- "optional": true
4284
- },
4285
- "totalCount": {
4286
- "type": "number",
4287
- "optional": true
4652
+ "type": "(props: {\n page: number;\n perPage?: number;\n totalCount?: number;\n pageShowingRange: string;\n }) => ReactNode",
4653
+ "optional": true,
4654
+ "description": "Custom render function for the info text"
4288
4655
  },
4289
- "pageShowingRange": {
4656
+ "className": {
4290
4657
  "type": "string",
4291
- "required": true
4658
+ "optional": true,
4659
+ "description": "Additional CSS classes"
4292
4660
  }
4293
4661
  }
4294
4662
  },
@@ -4298,23 +4666,23 @@
4298
4666
  "props": {
4299
4667
  "value": {
4300
4668
  "type": "number",
4301
- "required": true
4669
+ "required": true,
4670
+ "description": "Current page size value"
4302
4671
  },
4303
4672
  "options": {
4304
4673
  "type": "number[]",
4305
- "optional": true
4306
- },
4307
- "page": {
4308
- "type": "\"",
4309
- "required": true
4674
+ "optional": true,
4675
+ "description": "Available page size options"
4310
4676
  },
4311
4677
  "label": {
4312
4678
  "type": "ReactNode",
4313
- "optional": true
4679
+ "optional": true,
4680
+ "description": "Label text shown before the selector."
4314
4681
  },
4315
4682
  "className": {
4316
4683
  "type": "string",
4317
- "optional": true
4684
+ "optional": true,
4685
+ "description": "Additional CSS classes"
4318
4686
  }
4319
4687
  }
4320
4688
  },
@@ -4322,17 +4690,15 @@
4322
4690
  "name": "Controls",
4323
4691
  "description": "Controls sub-component",
4324
4692
  "props": {
4325
- "Note": {
4326
- "type": "** `\"dropdown\"` renders an option for every page",
4327
- "required": true
4328
- },
4329
4693
  "pageSelector": {
4330
4694
  "type": "\"input\" | \"dropdown\"",
4331
- "optional": true
4695
+ "optional": true,
4696
+ "description": "How the page number selector is rendered in \"full\" controls mode. - `\"input\"` (default): A text input where users type a page number. - `\"dropdown\"`: A dropdown select with all page numbers as options. **Note:** `\"dropdown\"` renders an option for every page, so it is best suited for small page counts. For large datasets (hundreds of pages or more) prefer `\"input\"` to avoid rendering performance overhead."
4332
4697
  },
4333
4698
  "className": {
4334
4699
  "type": "string",
4335
- "optional": true
4700
+ "optional": true,
4701
+ "description": "Additional CSS classes"
4336
4702
  }
4337
4703
  }
4338
4704
  },
@@ -4342,7 +4708,8 @@
4342
4708
  "props": {
4343
4709
  "className": {
4344
4710
  "type": "string",
4345
- "optional": true
4711
+ "optional": true,
4712
+ "description": "Additional CSS classes"
4346
4713
  }
4347
4714
  }
4348
4715
  }
@@ -4454,37 +4821,60 @@
4454
4821
  }
4455
4822
  },
4456
4823
  "appearance": {
4457
- "type": "enum",
4458
- "values": [
4459
- "default",
4460
- "card"
4461
- ],
4462
- "default": "default",
4463
- "descriptions": {
4464
- "default": "Standard inline radio item",
4465
- "card": "Choice card appearance with border, padding, and highlighted selection state"
4466
- },
4467
- "classes": {
4468
- "card": "rounded-lg border border-kumo-hairline bg-kumo-base p-3 transition-colors hover:bg-kumo-tint has-[[data-checked]]:border-kumo-interact has-[[data-checked]]:bg-kumo-tint"
4469
- },
4470
- "stateClasses": {
4471
- "card": {
4472
- "hover": "hover:bg-kumo-tint"
4473
- }
4474
- }
4824
+ "type": "KumoRadioAppearance",
4825
+ "optional": true,
4826
+ "description": "Visual appearance applied to all Radio.Item children. - `\"default\"` — Standard inline radio items - `\"card\"` — Choice card with border, padding, and highlighted selection state Individual items can override this with their own `appearance` prop."
4475
4827
  },
4476
- "className": {
4828
+ "legend": {
4477
4829
  "type": "string",
4478
- "description": "Additional CSS classes"
4830
+ "optional": true,
4831
+ "description": "Legend text for the group (required for accessibility). For more control over legend styling, omit this prop and use `<Radio.Legend>` as a child instead."
4479
4832
  },
4480
4833
  "children": {
4481
4834
  "type": "ReactNode",
4482
- "description": "Child elements"
4835
+ "required": true,
4836
+ "description": "Child Radio.Item components (and optionally a Radio.Legend)"
4837
+ },
4838
+ "orientation": {
4839
+ "type": "\"vertical\" | \"horizontal\"",
4840
+ "optional": true,
4841
+ "description": "Layout direction of the radio items"
4842
+ },
4843
+ "error": {
4844
+ "type": "string",
4845
+ "optional": true,
4846
+ "description": "Error message for the group"
4847
+ },
4848
+ "description": {
4849
+ "type": "ReactNode",
4850
+ "optional": true,
4851
+ "description": "Helper text for the group"
4483
4852
  },
4484
4853
  "value": {
4485
4854
  "type": "T",
4855
+ "optional": true,
4486
4856
  "description": "The controlled value of the selected radio item."
4487
4857
  },
4858
+ "disabled": {
4859
+ "type": "boolean",
4860
+ "optional": true,
4861
+ "description": "Whether all radios in the group are disabled"
4862
+ },
4863
+ "controlPosition": {
4864
+ "type": "RadioControlPosition",
4865
+ "optional": true,
4866
+ "description": "Position of radio control relative to label: \"start\" puts radio before label, \"end\" puts label before radio. Defaults to \"start\" for default appearance and \"end\" for card appearance."
4867
+ },
4868
+ "name": {
4869
+ "type": "string",
4870
+ "optional": true,
4871
+ "description": "Form submission name for the radio group"
4872
+ },
4873
+ "className": {
4874
+ "type": "string",
4875
+ "optional": true,
4876
+ "description": "Additional CSS classes"
4877
+ },
4488
4878
  "defaultValue": {
4489
4879
  "type": "T",
4490
4880
  "description": "The uncontrolled initial value of the selected radio item."
@@ -4536,10 +4926,61 @@
4536
4926
  "name": "Group",
4537
4927
  "description": "Group sub-component",
4538
4928
  "props": {
4929
+ "legend": {
4930
+ "type": "string",
4931
+ "optional": true,
4932
+ "description": "Legend text for the group (required for accessibility). For more control over legend styling, omit this prop and use `<Radio.Legend>` as a child instead."
4933
+ },
4934
+ "children": {
4935
+ "type": "ReactNode",
4936
+ "required": true,
4937
+ "description": "Child Radio.Item components (and optionally a Radio.Legend)"
4938
+ },
4939
+ "orientation": {
4940
+ "type": "\"vertical\" | \"horizontal\"",
4941
+ "optional": true,
4942
+ "description": "Layout direction of the radio items"
4943
+ },
4944
+ "appearance": {
4945
+ "type": "KumoRadioAppearance",
4946
+ "optional": true,
4947
+ "description": "Visual appearance applied to all Radio.Item children. - `\"default\"` — Standard inline radio items - `\"card\"` — Choice card with border, padding, and highlighted selection state Individual items can override this with their own `appearance` prop."
4948
+ },
4949
+ "error": {
4950
+ "type": "string",
4951
+ "optional": true,
4952
+ "description": "Error message for the group"
4953
+ },
4954
+ "description": {
4955
+ "type": "ReactNode",
4956
+ "optional": true,
4957
+ "description": "Helper text for the group"
4958
+ },
4539
4959
  "value": {
4540
4960
  "type": "T",
4961
+ "optional": true,
4541
4962
  "description": "The controlled value of the selected radio item."
4542
4963
  },
4964
+ "disabled": {
4965
+ "type": "boolean",
4966
+ "optional": true,
4967
+ "description": "Whether all radios in the group are disabled"
4968
+ },
4969
+ "controlPosition": {
4970
+ "type": "RadioControlPosition",
4971
+ "optional": true,
4972
+ "description": "Position of radio control relative to label: \"start\" puts radio before label, \"end\" puts label before radio. Defaults to \"start\" for default appearance and \"end\" for card appearance."
4973
+ },
4974
+ "name": {
4975
+ "type": "string",
4976
+ "optional": true,
4977
+ "description": "Form submission name for the radio group"
4978
+ },
4979
+ "className": {
4980
+ "type": "string",
4981
+ "optional": true,
4982
+ "description": "Additional CSS classes"
4983
+ },
4543
4984
  "defaultValue": {
4544
4985
  "type": "T",
4545
4986
  "description": "The uncontrolled initial value of the selected radio item."
@@ -4556,16 +4997,123 @@
4556
4997
  "props": {
4557
4998
  "children": {
4558
4999
  "type": "ReactNode",
4559
- "required": true
5000
+ "required": true,
5001
+ "description": "Legend content"
4560
5002
  },
4561
5003
  "className": {
4562
5004
  "type": "string",
4563
- "optional": true
5005
+ "optional": true,
5006
+ "description": "Additional CSS classes (e.g. \"sr-only\" to visually hide the legend)"
4564
5007
  }
4565
5008
  }
4566
5009
  }
4567
5010
  }
4568
5011
  },
5012
+ "SankeyChart": {
5013
+ "name": "SankeyChart",
5014
+ "type": "component",
5015
+ "description": "SankeyChart component",
5016
+ "importPath": "@cloudflare/kumo",
5017
+ "category": "Data Visualization",
5018
+ "props": {
5019
+ "echarts": {
5020
+ "type": "typeof echarts",
5021
+ "required": true,
5022
+ "description": "The ECharts core instance imported by the consumer. Passed in rather than imported directly so the consumer controls which ECharts modules are bundled (tree-shaking)."
5023
+ },
5024
+ "nodes": {
5025
+ "type": "SankeyNodeData[]",
5026
+ "required": true,
5027
+ "description": "Array of nodes in the Sankey diagram"
5028
+ },
5029
+ "links": {
5030
+ "type": "SankeyLinkData[]",
5031
+ "required": true,
5032
+ "description": "Array of links connecting nodes by index"
5033
+ },
5034
+ "height": {
5035
+ "type": "number",
5036
+ "optional": true,
5037
+ "description": "Height of the chart in pixels"
5038
+ },
5039
+ "showNodeValues": {
5040
+ "type": "boolean",
5041
+ "optional": true,
5042
+ "description": "Show node values above labels (default: true if any node has a value)"
5043
+ },
5044
+ "nodeLabelLayout": {
5045
+ "type": "\"stacked\" | \"inline\"",
5046
+ "optional": true,
5047
+ "description": "Layout for node labels when showNodeValues is true. - 'stacked': value on top, name below (default) - 'inline': \"value name\" on a single line (better for small nodes)"
5048
+ },
5049
+ "formatValue": {
5050
+ "type": "(value: number) => string",
5051
+ "optional": true,
5052
+ "description": "Format function for node values (default: toLocaleString)"
5053
+ },
5054
+ "tooltipFormatter": {
5055
+ "type": "(params: SankeyTooltipParams) => string",
5056
+ "optional": true,
5057
+ "description": "Custom tooltip formatter. Return HTML string or empty string to hide tooltip."
5058
+ },
5059
+ "nodeWidth": {
5060
+ "type": "number",
5061
+ "optional": true
5062
+ },
5063
+ "nodePadding": {
5064
+ "type": "number",
5065
+ "optional": true
5066
+ },
5067
+ "showTooltip": {
5068
+ "type": "boolean",
5069
+ "optional": true
5070
+ },
5071
+ "defaultNodeColor": {
5072
+ "type": "string",
5073
+ "optional": true
5074
+ },
5075
+ "left": {
5076
+ "type": "number | string",
5077
+ "optional": true,
5078
+ "description": "Left padding of the Sankey layout within the chart container. Accepts a number (px) or percentage string. ECharts default: '5%'."
5079
+ },
5080
+ "right": {
5081
+ "type": "number | string",
5082
+ "optional": true,
5083
+ "description": "Right padding of the Sankey layout within the chart container. Accepts a number (px) or percentage string. ECharts default: '5%'."
5084
+ },
5085
+ "linkColor": {
5086
+ "type": "\"gradient\" | \"gray\"",
5087
+ "optional": true,
5088
+ "description": "Link fill style: 'gradient' blends source to target colors, 'gray' uses flat gray"
5089
+ },
5090
+ "linkOpacity": {
5091
+ "type": "number",
5092
+ "optional": true
5093
+ },
5094
+ "className": {
5095
+ "type": "string",
5096
+ "optional": true
5097
+ },
5098
+ "isDarkMode": {
5099
+ "type": "boolean",
5100
+ "optional": true
5101
+ }
5102
+ },
5103
+ "examples": [
5104
+ "<SankeyChart\n echarts={echarts}\n nodes={basicNodes}\n links={basicLinks}\n height={350}\n isDarkMode={isDarkMode}\n />",
5105
+ "<SankeyChart\n echarts={echarts}\n nodes={previewNodes}\n links={previewLinks}\n height={200}\n showTooltip={false}\n isDarkMode={isDarkMode}\n />",
5106
+ "<SankeyChart\n echarts={echarts}\n nodes={multiLevelNodes}\n links={multiLevelLinks}\n height={350}\n nodeWidth={20}\n nodePadding={15}\n isDarkMode={isDarkMode}\n />",
5107
+ "<SankeyChart\n echarts={echarts}\n nodes={nodes}\n links={links}\n height={250}\n linkOpacity={0.6}\n isDarkMode={isDarkMode}\n />",
5108
+ "<SankeyChart\n echarts={echarts}\n nodes={nodes}\n links={links}\n height={300}\n isDarkMode={isDarkMode}\n />",
5109
+ "<SankeyChart\n echarts={echarts}\n nodes={nodes}\n links={links}\n height={300}\n tooltipFormatter={customTooltip}\n isDarkMode={isDarkMode}\n />",
5110
+ "<SankeyChart\n echarts={echarts}\n nodes={basicNodes}\n links={basicLinks}\n height={350}\n left={0}\n right={0}\n isDarkMode={isDarkMode}\n />",
5111
+ "<SankeyChart\n echarts={echarts}\n nodes={basicNodes}\n links={basicLinks}\n height={350}\n onNodeClick={handleNodeClick}\n onLinkClick={handleLinkClick}\n isDarkMode={isDarkMode}\n />",
5112
+ "<div className=\"flex w-full flex-col gap-2\">\n <div className=\"flex items-center gap-2 text-sm text-kumo-subtle\">\n <span>\n {hasSelection\n ? `Showing: ${[selectedSource, selectedTarget].filter(Boolean).join(\" → \")}`\n : \"Click a node to filter\"}\n </span>\n {hasSelection && (\n <button\n onClick={resetFilters}\n className=\"text-kumo-brand hover:underline\"\n >\n Reset\n </button>\n )}\n </div>\n <SankeyChart\n echarts={echarts}\n nodes={filteredNodes}\n links={filteredLinks}\n height={300}\n onNodeClick={handleNodeClick}\n isDarkMode={isDarkMode}\n />\n </div>",
5113
+ "<SankeyChart\n echarts={echarts}\n nodes={nodes}\n links={links}\n height={300}\n nodeLabelLayout=\"inline\"\n isDarkMode={isDarkMode}\n />"
5114
+ ],
5115
+ "colors": []
5116
+ },
4569
5117
  "Select": {
4570
5118
  "name": "Select",
4571
5119
  "type": "component",
@@ -5016,15 +5564,17 @@
5016
5564
  }
5017
5565
  },
5018
5566
  "examples": [
5019
- "<DemoContainer>\n <Sidebar.Provider contained defaultOpen className=\"min-h-0! h-full\">\n <Sidebar>\n <Sidebar.Content>\n <Sidebar.Group>\n <Sidebar.GroupLabel>Overview</Sidebar.GroupLabel>\n <Sidebar.Menu>\n <Sidebar.MenuButton icon={HouseIcon} active>\n Home\n </Sidebar.MenuButton>\n <Sidebar.MenuButton icon={ChartBarIcon}>\n Analytics\n </Sidebar.MenuButton>\n <Sidebar.MenuButton icon={GlobeIcon}>\n Domains\n </Sidebar.MenuButton>\n </Sidebar.Menu>\n </Sidebar.Group>\n\n <Sidebar.Group>\n <Sidebar.GroupLabel>Build</Sidebar.GroupLabel>\n <Sidebar.Menu>\n <Sidebar.MenuItem>\n <Sidebar.Collapsible defaultOpen>\n <Sidebar.CollapsibleTrigger\n render={\n <Sidebar.MenuButton icon={CodeIcon}>\n Compute\n <Sidebar.MenuChevron />\n </Sidebar.MenuButton>\n }\n />\n <Sidebar.CollapsibleContent>\n <Sidebar.MenuSub>\n <Sidebar.MenuSubItem>\n <Sidebar.Collapsible>\n <Sidebar.CollapsibleTrigger\n render={\n <Sidebar.MenuSubButton>\n Workers & Pages\n <Sidebar.MenuChevron />\n </Sidebar.MenuSubButton>\n }\n />\n <Sidebar.CollapsibleContent>\n <Sidebar.MenuSub>\n <Sidebar.MenuSubButton>\n Overview\n </Sidebar.MenuSubButton>\n <Sidebar.MenuSubButton>\n Workers\n </Sidebar.MenuSubButton>\n <Sidebar.MenuSubButton>\n Pages\n </Sidebar.MenuSubButton>\n </Sidebar.MenuSub>\n </Sidebar.CollapsibleContent>\n </Sidebar.Collapsible>\n </Sidebar.MenuSubItem>\n <Sidebar.MenuSubButton>\n Durable Objects\n </Sidebar.MenuSubButton>\n </Sidebar.MenuSub>\n </Sidebar.CollapsibleContent>\n </Sidebar.Collapsible>\n </Sidebar.MenuItem>\n <Sidebar.MenuButton icon={DatabaseIcon}>\n Storage\n </Sidebar.MenuButton>\n </Sidebar.Menu>\n </Sidebar.Group>\n </Sidebar.Content>\n </Sidebar>\n <DemoMain />\n </Sidebar.Provider>\n </DemoContainer>",
5020
- "<DemoContainer>\n <Sidebar.Provider contained defaultOpen className=\"min-h-0! h-full\">\n <Sidebar>\n <Sidebar.Header>\n <BrandLogo />\n </Sidebar.Header>\n <Sidebar.Content>\n <Sidebar.Group>\n <Sidebar.Menu>\n <Sidebar.MenuButton icon={HouseIcon} tooltip=\"Home\" active>\n Home\n </Sidebar.MenuButton>\n <Sidebar.MenuButton icon={ChartBarIcon} tooltip=\"Analytics\">\n Analytics\n </Sidebar.MenuButton>\n <Sidebar.MenuButton icon={CodeIcon} tooltip=\"Compute\">\n Compute\n </Sidebar.MenuButton>\n <Sidebar.MenuButton icon={DatabaseIcon} tooltip=\"Storage\">\n Storage\n </Sidebar.MenuButton>\n </Sidebar.Menu>\n </Sidebar.Group>\n </Sidebar.Content>\n <Sidebar.Footer>\n <Sidebar.Trigger />\n </Sidebar.Footer>\n </Sidebar>\n <DemoMain>\n <ToggleButton />\n <p>\n Click the button or the sidebar trigger to toggle\n </p>\n </DemoMain>\n </Sidebar.Provider>\n </DemoContainer>",
5021
- "<DemoContainer>\n <Sidebar.Provider contained\n defaultOpen\n resizable\n defaultWidth={240}\n minWidth={180}\n maxWidth={400}\n className=\"min-h-0! h-full\"\n >\n <Sidebar>\n <Sidebar.Header>\n <BrandLogo />\n </Sidebar.Header>\n <Sidebar.Content>\n <Sidebar.Group>\n <Sidebar.Menu>\n <Sidebar.MenuButton icon={HouseIcon} active>\n Home\n </Sidebar.MenuButton>\n <Sidebar.MenuButton icon={ChartBarIcon}>\n Analytics\n </Sidebar.MenuButton>\n <Sidebar.MenuButton icon={DatabaseIcon}>\n Storage\n </Sidebar.MenuButton>\n </Sidebar.Menu>\n </Sidebar.Group>\n </Sidebar.Content>\n <Sidebar.Footer>\n <Sidebar.Trigger />\n </Sidebar.Footer>\n <Sidebar.ResizeHandle />\n </Sidebar>\n <DemoMain>\n <p>Drag the sidebar edge to resize</p>\n </DemoMain>\n </Sidebar.Provider>\n </DemoContainer>",
5022
- "<DemoContainer>\n <Sidebar.Provider contained defaultOpen side=\"right\" className=\"min-h-0! h-full\">\n <DemoMain />\n <Sidebar>\n <Sidebar.Content>\n <Sidebar.Group>\n <Sidebar.GroupLabel>Details</Sidebar.GroupLabel>\n <Sidebar.Menu>\n <Sidebar.MenuButton icon={GearIcon} active>\n Properties\n </Sidebar.MenuButton>\n <Sidebar.MenuButton icon={ChartBarIcon}>\n Metrics\n </Sidebar.MenuButton>\n <Sidebar.MenuButton icon={BellIcon}>Alerts</Sidebar.MenuButton>\n </Sidebar.Menu>\n </Sidebar.Group>\n </Sidebar.Content>\n </Sidebar>\n </Sidebar.Provider>\n </DemoContainer>",
5023
- "<DemoContainer>\n <Sidebar.Provider contained defaultOpen peekable className=\"min-h-0! h-full\">\n <Sidebar>\n <Sidebar.Header>\n <BrandLogo />\n </Sidebar.Header>\n <Sidebar.Content>\n <Sidebar.Group>\n <Sidebar.Menu>\n <Sidebar.MenuButton icon={HouseIcon} tooltip=\"Home\" active>\n Home\n </Sidebar.MenuButton>\n <Sidebar.MenuButton icon={ChartBarIcon} tooltip=\"Analytics\">\n Analytics\n </Sidebar.MenuButton>\n <Sidebar.MenuButton icon={CodeIcon} tooltip=\"Compute\">\n Compute\n </Sidebar.MenuButton>\n <Sidebar.MenuButton icon={DatabaseIcon} tooltip=\"Storage\">\n Storage\n </Sidebar.MenuButton>\n </Sidebar.Menu>\n </Sidebar.Group>\n </Sidebar.Content>\n <Sidebar.Footer>\n <Sidebar.Trigger />\n </Sidebar.Footer>\n </Sidebar>\n <DemoMain>\n <PeekStateIndicator />\n </DemoMain>\n </Sidebar.Provider>\n </DemoContainer>",
5024
- "<div className=\"relative h-[420px] w-full overflow-hidden rounded-lg border border-kumo-line bg-kumo-base\">\n <Sidebar.Provider contained defaultOpen className=\"min-h-0! h-full\">\n <Sidebar>\n <Sidebar.Header>\n <BrandLogo />\n </Sidebar.Header>\n <Sidebar.Content>\n <Sidebar.Group>\n <Sidebar.GroupLabel>Overview</Sidebar.GroupLabel>\n <Sidebar.Menu>\n <Sidebar.MenuButton icon={HouseIcon} active>\n Home\n </Sidebar.MenuButton>\n <Sidebar.MenuButton icon={ChartBarIcon}>\n Analytics\n </Sidebar.MenuButton>\n <Sidebar.MenuButton icon={GlobeIcon}>\n Domains\n </Sidebar.MenuButton>\n </Sidebar.Menu>\n </Sidebar.Group>\n\n <Sidebar.Group>\n <Sidebar.GroupLabel>Platform</Sidebar.GroupLabel>\n <Sidebar.Menu>\n <Sidebar.MenuButton icon={DatabaseIcon}>\n Storage\n </Sidebar.MenuButton>\n <Sidebar.MenuButton icon={ShieldCheckIcon}>\n Security\n </Sidebar.MenuButton>\n <Sidebar.MenuButton icon={LockIcon}>\n Zero Trust\n </Sidebar.MenuButton>\n <Sidebar.MenuButton icon={GearIcon}>\n Settings\n </Sidebar.MenuButton>\n </Sidebar.Menu>\n </Sidebar.Group>\n\n <Sidebar.Group>\n <Sidebar.GroupLabel>Build</Sidebar.GroupLabel>\n <Sidebar.Menu>\n <Sidebar.MenuItem>\n <Sidebar.Collapsible autoScrollOnOpen>\n <Sidebar.CollapsibleTrigger\n render={\n <Sidebar.MenuButton icon={CodeIcon}>\n Workers\n <Sidebar.MenuChevron />\n </Sidebar.MenuButton>\n }\n />\n <Sidebar.CollapsibleContent>\n <Sidebar.MenuSub>\n <Sidebar.MenuSubButton>Overview</Sidebar.MenuSubButton>\n <Sidebar.MenuSubButton>Deployments</Sidebar.MenuSubButton>\n <Sidebar.MenuSubButton>Observability</Sidebar.MenuSubButton>\n <Sidebar.MenuSubButton>Settings</Sidebar.MenuSubButton>\n </Sidebar.MenuSub>\n </Sidebar.CollapsibleContent>\n </Sidebar.Collapsible>\n </Sidebar.MenuItem>\n <Sidebar.MenuButton icon={CubeIcon}>\n Containers\n <Sidebar.MenuBadge>Beta</Sidebar.MenuBadge>\n </Sidebar.MenuButton>\n </Sidebar.Menu>\n </Sidebar.Group>\n </Sidebar.Content>\n <Sidebar.Footer>\n <Sidebar.Trigger />\n </Sidebar.Footer>\n </Sidebar>\n <DemoMain>\n <p>Open Workers near the bottom of the list</p>\n </DemoMain>\n </Sidebar.Provider>\n </div>",
5025
- "<DemoContainer>\n <Sidebar.Provider contained defaultOpen className=\"min-h-0! h-full\">\n <Sidebar>\n <Sidebar.Header>\n <button\n type=\"button\"\n onClick={() =>\n setSurface((s) => (s === \"account\" ? \"zone\" : \"account\"))\n }\n className=\"flex w-full cursor-pointer items-center gap-2 rounded-lg px-3 py-2 text-sm font-medium text-kumo-default hover:bg-kumo-tint transition-colors\"\n >\n <ArrowsLeftRightIcon className=\"size-4 shrink-0 text-kumo-brand\" />\n <span className=\"flex-1 text-left font-semibold text-kumo-strong\">\n {surface === \"account\" ? \"Account Nav\" : \"Zone Nav\"}\n </span>\n </button>\n </Sidebar.Header>\n\n <Sidebar.SlidingViews\n activeKey={surface}\n direction={surface === \"zone\" ? \"left\" : \"right\"}\n >\n <Sidebar.SlidingView value=\"account\">\n <Sidebar.Content>\n <Sidebar.Group>\n <Sidebar.GroupLabel>Account</Sidebar.GroupLabel>\n <Sidebar.Menu>\n <Sidebar.MenuButton icon={HouseIcon} active>\n Home\n </Sidebar.MenuButton>\n <Sidebar.MenuButton icon={UserIcon}>\n Members\n </Sidebar.MenuButton>\n <Sidebar.MenuButton icon={ChartBarIcon}>\n Analytics\n </Sidebar.MenuButton>\n <Sidebar.MenuButton icon={GearIcon}>\n Settings\n </Sidebar.MenuButton>\n </Sidebar.Menu>\n </Sidebar.Group>\n </Sidebar.Content>\n </Sidebar.SlidingView>\n\n <Sidebar.SlidingView value=\"zone\">\n <Sidebar.Content>\n <Sidebar.Group>\n <Sidebar.GroupLabel>Zone</Sidebar.GroupLabel>\n <Sidebar.Menu>\n <Sidebar.MenuButton icon={GlobeIcon} active>\n Overview\n </Sidebar.MenuButton>\n <Sidebar.MenuButton icon={ShieldCheckIcon}>\n Security\n </Sidebar.MenuButton>\n <Sidebar.MenuButton icon={LockIcon}>\n SSL/TLS\n </Sidebar.MenuButton>\n <Sidebar.MenuButton icon={DatabaseIcon}>\n Caching\n </Sidebar.MenuButton>\n </Sidebar.Menu>\n </Sidebar.Group>\n </Sidebar.Content>\n </Sidebar.SlidingView>\n </Sidebar.SlidingViews>\n </Sidebar>\n <DemoMain>\n <div className=\"flex flex-col items-center gap-2\">\n <p className=\"font-medium text-kumo-default\">\n Active: {surface === \"account\" ? \"Account\" : \"Zone\"} surface\n </p>\n <p>\n Click the header button to slide between views\n </p>\n </div>\n </DemoMain>\n </Sidebar.Provider>\n </DemoContainer>",
5026
- "<DemoContainer>\n <Sidebar.Provider contained defaultOpen peekable className=\"min-h-0! h-full\">\n <Sidebar>\n <Sidebar.Header>\n <AccountSwitcher />\n </Sidebar.Header>\n <Sidebar.SlidingViews\n activeKey={surface}\n direction={surface === \"domain\" ? \"left\" : \"right\"}\n >\n <Sidebar.SlidingView value=\"account\">\n <Sidebar.Content>\n <Sidebar.Group>\n <Sidebar.Menu>\n <Sidebar.MenuButton\n icon={MagnifyingGlassIcon}\n tooltip=\"Search\"\n className=\"ring ring-kumo-line group-data-[state=collapsed]/sidebar:ring-transparent mb-3 group-data-[state=collapsed]/sidebar:mb-0 transition-[margin] duration-(--sidebar-animation-duration)\"\n >\n Quick search&hellip;\n </Sidebar.MenuButton>\n </Sidebar.Menu>\n </Sidebar.Group>\n <Sidebar.Group>\n <Sidebar.Menu>\n <Sidebar.MenuButton icon={HouseIcon} active>\n Home\n </Sidebar.MenuButton>\n <Sidebar.MenuButton icon={ChartBarIcon}>\n Analytics & Logs\n </Sidebar.MenuButton>\n <Sidebar.MenuButton\n icon={GlobeIcon}\n onClick={() => setSurface(\"domain\")}\n >\n Domains\n </Sidebar.MenuButton>\n </Sidebar.Menu>\n </Sidebar.Group>\n\n <Sidebar.Group>\n <Sidebar.GroupLabel>Build</Sidebar.GroupLabel>\n <Sidebar.Menu>\n <Sidebar.MenuItem>\n <Sidebar.Collapsible defaultOpen>\n <Sidebar.CollapsibleTrigger\n render={\n <Sidebar.MenuButton icon={CodeIcon}>\n Compute\n <Sidebar.MenuChevron />\n </Sidebar.MenuButton>\n }\n />\n <Sidebar.CollapsibleContent>\n <Sidebar.MenuSub>\n <Sidebar.MenuSubItem>\n <Sidebar.Collapsible>\n <Sidebar.CollapsibleTrigger\n render={\n <Sidebar.MenuSubButton>\n Workers & Pages\n <Sidebar.MenuChevron />\n </Sidebar.MenuSubButton>\n }\n />\n <Sidebar.CollapsibleContent>\n <Sidebar.MenuSub>\n <Sidebar.MenuSubButton>\n Overview\n </Sidebar.MenuSubButton>\n <Sidebar.MenuSubButton>\n Workers\n </Sidebar.MenuSubButton>\n <Sidebar.MenuSubButton>\n Pages\n </Sidebar.MenuSubButton>\n </Sidebar.MenuSub>\n </Sidebar.CollapsibleContent>\n </Sidebar.Collapsible>\n </Sidebar.MenuSubItem>\n <Sidebar.MenuSubButton>\n Durable Objects\n </Sidebar.MenuSubButton>\n <Sidebar.MenuSubButton>\n Containers\n <Sidebar.MenuBadge>Beta</Sidebar.MenuBadge>\n </Sidebar.MenuSubButton>\n </Sidebar.MenuSub>\n </Sidebar.CollapsibleContent>\n </Sidebar.Collapsible>\n </Sidebar.MenuItem>\n <Sidebar.MenuButton icon={DatabaseIcon}>\n Storage\n </Sidebar.MenuButton>\n </Sidebar.Menu>\n </Sidebar.Group>\n\n <Sidebar.Group>\n <Sidebar.GroupLabel>Protect & Connect</Sidebar.GroupLabel>\n <Sidebar.Menu>\n <Sidebar.MenuButton icon={ShieldCheckIcon}>\n Security\n </Sidebar.MenuButton>\n <Sidebar.MenuButton icon={LockIcon}>\n Zero Trust\n <Sidebar.MenuBadge>Beta</Sidebar.MenuBadge>\n </Sidebar.MenuButton>\n </Sidebar.Menu>\n </Sidebar.Group>\n </Sidebar.Content>\n </Sidebar.SlidingView>\n\n <Sidebar.SlidingView value=\"domain\">\n <Sidebar.Content>\n <Sidebar.Group>\n <Sidebar.Menu>\n <Sidebar.MenuButton\n icon={ArrowLeftIcon}\n onClick={() => setSurface(\"account\")}\n >\n Back\n </Sidebar.MenuButton>\n </Sidebar.Menu>\n </Sidebar.Group>\n <Sidebar.Group>\n <Sidebar.GroupLabel>example.com</Sidebar.GroupLabel>\n <Sidebar.Menu>\n <Sidebar.MenuButton icon={GlobeIcon} active>\n Overview\n </Sidebar.MenuButton>\n <Sidebar.MenuButton icon={ShieldCheckIcon}>\n Security\n </Sidebar.MenuButton>\n <Sidebar.MenuButton icon={LockIcon}>\n SSL/TLS\n </Sidebar.MenuButton>\n <Sidebar.MenuButton icon={ChartBarIcon}>\n Analytics\n </Sidebar.MenuButton>\n <Sidebar.MenuButton icon={DatabaseIcon}>\n Caching\n </Sidebar.MenuButton>\n </Sidebar.Menu>\n </Sidebar.Group>\n </Sidebar.Content>\n </Sidebar.SlidingView>\n </Sidebar.SlidingViews>\n\n <Sidebar.Footer>\n <Sidebar.Trigger />\n </Sidebar.Footer>\n </Sidebar>\n <DemoMain />\n </Sidebar.Provider>\n </DemoContainer>",
5027
- "<div className=\"relative h-[540px] w-full overflow-hidden rounded-lg border border-kumo-line bg-kumo-base\">\n <Sidebar.Provider contained mobileBreakpoint={9999} className=\"h-full\">\n <Sidebar>\n <Sidebar.Header>\n <BrandLogo />\n </Sidebar.Header>\n <Sidebar.Content>\n <Sidebar.Group>\n <Sidebar.GroupLabel>Overview</Sidebar.GroupLabel>\n <Sidebar.Menu>\n <Sidebar.MenuButton icon={HouseIcon} active>\n Home\n </Sidebar.MenuButton>\n <Sidebar.MenuButton icon={ChartBarIcon}>\n Analytics\n </Sidebar.MenuButton>\n <Sidebar.MenuButton icon={GlobeIcon}>\n Domains\n </Sidebar.MenuButton>\n </Sidebar.Menu>\n </Sidebar.Group>\n\n <Sidebar.Group>\n <Sidebar.GroupLabel>Build</Sidebar.GroupLabel>\n <Sidebar.Menu>\n <Sidebar.MenuButton icon={CodeIcon}>\n Compute\n </Sidebar.MenuButton>\n <Sidebar.MenuButton icon={DatabaseIcon}>\n Storage\n </Sidebar.MenuButton>\n </Sidebar.Menu>\n </Sidebar.Group>\n </Sidebar.Content>\n <Sidebar.Footer>\n <Sidebar.Trigger />\n </Sidebar.Footer>\n </Sidebar>\n <DemoMain>\n <MobileToggleButton />\n <p>Click the button to open the mobile sidebar</p>\n <p className=\"text-sm text-kumo-subtle\">\n Press Escape or click the backdrop to close\n </p>\n </DemoMain>\n </Sidebar.Provider>\n </div>"
5567
+ "<DemoContainer>\n <Sidebar.Provider contained defaultOpen className=\"h-full min-h-0!\">\n <Sidebar>\n <Sidebar.Content>\n <Sidebar.Group>\n <Sidebar.GroupLabel>Overview</Sidebar.GroupLabel>\n <Sidebar.Menu>\n <Sidebar.MenuButton icon={HouseIcon} active>\n Home\n </Sidebar.MenuButton>\n <Sidebar.MenuButton icon={ChartBarIcon}>\n Analytics\n </Sidebar.MenuButton>\n <Sidebar.MenuButton icon={GlobeIcon}>\n Domains\n </Sidebar.MenuButton>\n </Sidebar.Menu>\n </Sidebar.Group>\n\n <Sidebar.Group>\n <Sidebar.GroupLabel>Build</Sidebar.GroupLabel>\n <Sidebar.Menu>\n <Sidebar.MenuItem>\n <Sidebar.Collapsible defaultOpen>\n <Sidebar.CollapsibleTrigger\n render={\n <Sidebar.MenuButton icon={CodeIcon}>\n Compute\n <Sidebar.MenuChevron />\n </Sidebar.MenuButton>\n }\n />\n <Sidebar.CollapsibleContent>\n <Sidebar.MenuSub>\n <Sidebar.MenuSubItem>\n <Sidebar.Collapsible>\n <Sidebar.CollapsibleTrigger\n render={\n <Sidebar.MenuSubButton>\n Workers & Pages\n <Sidebar.MenuChevron />\n </Sidebar.MenuSubButton>\n }\n />\n <Sidebar.CollapsibleContent>\n <Sidebar.MenuSub>\n <Sidebar.MenuSubButton>\n Overview\n </Sidebar.MenuSubButton>\n <Sidebar.MenuSubButton>\n Workers\n </Sidebar.MenuSubButton>\n <Sidebar.MenuSubButton>\n Pages\n </Sidebar.MenuSubButton>\n </Sidebar.MenuSub>\n </Sidebar.CollapsibleContent>\n </Sidebar.Collapsible>\n </Sidebar.MenuSubItem>\n <Sidebar.MenuSubButton>\n Durable Objects\n </Sidebar.MenuSubButton>\n </Sidebar.MenuSub>\n </Sidebar.CollapsibleContent>\n </Sidebar.Collapsible>\n </Sidebar.MenuItem>\n <Sidebar.MenuButton icon={DatabaseIcon}>\n Storage\n </Sidebar.MenuButton>\n </Sidebar.Menu>\n </Sidebar.Group>\n </Sidebar.Content>\n </Sidebar>\n <DemoMain />\n </Sidebar.Provider>\n </DemoContainer>",
5568
+ "<DemoContainer>\n <Sidebar.Provider contained defaultOpen className=\"h-full min-h-0!\">\n <Sidebar>\n <Sidebar.Header>\n <BrandLogo />\n </Sidebar.Header>\n <Sidebar.Content>\n <Sidebar.Group>\n <Sidebar.Menu>\n <Sidebar.MenuButton icon={HouseIcon} tooltip=\"Home\" active>\n Home\n </Sidebar.MenuButton>\n <Sidebar.MenuButton icon={ChartBarIcon} tooltip=\"Analytics\">\n Analytics\n </Sidebar.MenuButton>\n <Sidebar.MenuButton icon={CodeIcon} tooltip=\"Compute\">\n Compute\n </Sidebar.MenuButton>\n <Sidebar.MenuButton icon={DatabaseIcon} tooltip=\"Storage\">\n Storage\n </Sidebar.MenuButton>\n </Sidebar.Menu>\n </Sidebar.Group>\n </Sidebar.Content>\n <Sidebar.Footer>\n <Sidebar.Trigger />\n </Sidebar.Footer>\n </Sidebar>\n <DemoMain>\n <ToggleButton />\n <p>Click the button or the sidebar trigger to toggle</p>\n </DemoMain>\n </Sidebar.Provider>\n </DemoContainer>",
5569
+ "<DemoContainer>\n <Sidebar.Provider contained defaultOpen className=\"h-full min-h-0!\">\n <Sidebar>\n <Sidebar.Header>\n <BrandLogo />\n </Sidebar.Header>\n {loading ? (\n <Sidebar.Loading />\n ) : (\n <Sidebar.Content>\n <Sidebar.Group>\n <Sidebar.Menu>\n <Sidebar.MenuButton icon={HouseIcon} active>\n Home\n </Sidebar.MenuButton>\n <Sidebar.MenuButton icon={ChartBarIcon}>\n Analytics\n </Sidebar.MenuButton>\n <Sidebar.MenuButton icon={CodeIcon}>\n Compute\n </Sidebar.MenuButton>\n <Sidebar.MenuButton icon={DatabaseIcon}>\n Storage\n </Sidebar.MenuButton>\n </Sidebar.Menu>\n </Sidebar.Group>\n </Sidebar.Content>\n )}\n <Sidebar.Footer>\n <Sidebar.Trigger />\n </Sidebar.Footer>\n </Sidebar>\n <DemoMain>\n <button\n type=\"button\"\n onClick={() => setLoading((l) => !l)}\n className=\"cursor-pointer rounded-lg border border-kumo-line bg-kumo-base px-3 py-1.5 text-base text-kumo-default transition-colors hover:bg-kumo-tint\"\n >\n {loading ? \"Show loaded nav\" : \"Show loading\"}\n </button>\n <p>Toggle to compare the loading state with the loaded nav</p>\n </DemoMain>\n </Sidebar.Provider>\n </DemoContainer>",
5570
+ "<DemoContainer>\n <Sidebar.Provider\n contained\n defaultOpen\n resizable\n defaultWidth={240}\n minWidth={180}\n maxWidth={400}\n className=\"h-full min-h-0!\"\n >\n <Sidebar>\n <Sidebar.Header>\n <BrandLogo />\n </Sidebar.Header>\n <Sidebar.Content>\n <Sidebar.Group>\n <Sidebar.Menu>\n <Sidebar.MenuButton icon={HouseIcon} active>\n Home\n </Sidebar.MenuButton>\n <Sidebar.MenuButton icon={ChartBarIcon}>\n Analytics\n </Sidebar.MenuButton>\n <Sidebar.MenuButton icon={DatabaseIcon}>\n Storage\n </Sidebar.MenuButton>\n </Sidebar.Menu>\n </Sidebar.Group>\n </Sidebar.Content>\n <Sidebar.Footer>\n <Sidebar.Trigger />\n </Sidebar.Footer>\n <Sidebar.ResizeHandle />\n </Sidebar>\n <DemoMain>\n <p>Drag the sidebar edge to resize</p>\n </DemoMain>\n </Sidebar.Provider>\n </DemoContainer>",
5571
+ "<DemoContainer>\n <Sidebar.Provider\n contained\n defaultOpen\n side=\"right\"\n className=\"h-full min-h-0!\"\n >\n <DemoMain />\n <Sidebar>\n <Sidebar.Content>\n <Sidebar.Group>\n <Sidebar.GroupLabel>Details</Sidebar.GroupLabel>\n <Sidebar.Menu>\n <Sidebar.MenuButton icon={GearIcon} active>\n Properties\n </Sidebar.MenuButton>\n <Sidebar.MenuButton icon={ChartBarIcon}>\n Metrics\n </Sidebar.MenuButton>\n <Sidebar.MenuButton icon={BellIcon}>Alerts</Sidebar.MenuButton>\n </Sidebar.Menu>\n </Sidebar.Group>\n </Sidebar.Content>\n </Sidebar>\n </Sidebar.Provider>\n </DemoContainer>",
5572
+ "<DemoContainer>\n <Sidebar.Provider\n contained\n defaultOpen\n peekable\n className=\"h-full min-h-0!\"\n >\n <Sidebar>\n <Sidebar.Header>\n <BrandLogo />\n </Sidebar.Header>\n <Sidebar.Content>\n <Sidebar.Group>\n <Sidebar.Menu>\n <Sidebar.MenuButton icon={HouseIcon} tooltip=\"Home\" active>\n Home\n </Sidebar.MenuButton>\n <Sidebar.MenuButton icon={ChartBarIcon} tooltip=\"Analytics\">\n Analytics\n </Sidebar.MenuButton>\n <Sidebar.MenuButton icon={CodeIcon} tooltip=\"Compute\">\n Compute\n </Sidebar.MenuButton>\n <Sidebar.MenuButton icon={DatabaseIcon} tooltip=\"Storage\">\n Storage\n </Sidebar.MenuButton>\n </Sidebar.Menu>\n </Sidebar.Group>\n </Sidebar.Content>\n <Sidebar.Footer>\n <Sidebar.Trigger />\n </Sidebar.Footer>\n </Sidebar>\n <DemoMain>\n <PeekStateIndicator />\n </DemoMain>\n </Sidebar.Provider>\n </DemoContainer>",
5573
+ "<div className=\"relative h-[420px] w-full overflow-hidden rounded-lg border border-kumo-line bg-kumo-base\">\n <Sidebar.Provider contained defaultOpen className=\"h-full min-h-0!\">\n <Sidebar>\n <Sidebar.Header>\n <BrandLogo />\n </Sidebar.Header>\n <Sidebar.Content>\n <Sidebar.Group>\n <Sidebar.GroupLabel>Overview</Sidebar.GroupLabel>\n <Sidebar.Menu>\n <Sidebar.MenuButton icon={HouseIcon} active>\n Home\n </Sidebar.MenuButton>\n <Sidebar.MenuButton icon={ChartBarIcon}>\n Analytics\n </Sidebar.MenuButton>\n <Sidebar.MenuButton icon={GlobeIcon}>\n Domains\n </Sidebar.MenuButton>\n </Sidebar.Menu>\n </Sidebar.Group>\n\n <Sidebar.Group>\n <Sidebar.GroupLabel>Platform</Sidebar.GroupLabel>\n <Sidebar.Menu>\n <Sidebar.MenuButton icon={DatabaseIcon}>\n Storage\n </Sidebar.MenuButton>\n <Sidebar.MenuButton icon={ShieldCheckIcon}>\n Security\n </Sidebar.MenuButton>\n <Sidebar.MenuButton icon={LockIcon}>\n Zero Trust\n </Sidebar.MenuButton>\n <Sidebar.MenuButton icon={GearIcon}>\n Settings\n </Sidebar.MenuButton>\n </Sidebar.Menu>\n </Sidebar.Group>\n\n <Sidebar.Group>\n <Sidebar.GroupLabel>Build</Sidebar.GroupLabel>\n <Sidebar.Menu>\n <Sidebar.MenuItem>\n <Sidebar.Collapsible autoScrollOnOpen>\n <Sidebar.CollapsibleTrigger\n render={\n <Sidebar.MenuButton icon={CodeIcon}>\n Workers\n <Sidebar.MenuChevron />\n </Sidebar.MenuButton>\n }\n />\n <Sidebar.CollapsibleContent>\n <Sidebar.MenuSub>\n <Sidebar.MenuSubButton>Overview</Sidebar.MenuSubButton>\n <Sidebar.MenuSubButton>\n Deployments\n </Sidebar.MenuSubButton>\n <Sidebar.MenuSubButton>\n Observability\n </Sidebar.MenuSubButton>\n <Sidebar.MenuSubButton>Settings</Sidebar.MenuSubButton>\n </Sidebar.MenuSub>\n </Sidebar.CollapsibleContent>\n </Sidebar.Collapsible>\n </Sidebar.MenuItem>\n <Sidebar.MenuButton icon={CubeIcon}>\n Containers\n <Sidebar.MenuBadge>Beta</Sidebar.MenuBadge>\n </Sidebar.MenuButton>\n </Sidebar.Menu>\n </Sidebar.Group>\n </Sidebar.Content>\n <Sidebar.Footer>\n <Sidebar.Trigger />\n </Sidebar.Footer>\n </Sidebar>\n <DemoMain>\n <p>Open Workers near the bottom of the list</p>\n </DemoMain>\n </Sidebar.Provider>\n </div>",
5574
+ "<DemoContainer>\n <Sidebar.Provider contained defaultOpen className=\"h-full min-h-0!\">\n <Sidebar>\n <Sidebar.Header>\n <button\n type=\"button\"\n onClick={() =>\n setSurface((s) => (s === \"account\" ? \"zone\" : \"account\"))\n }\n className=\"flex w-full cursor-pointer items-center gap-2 rounded-lg px-3 py-2 text-sm font-medium text-kumo-default transition-colors hover:bg-kumo-tint\"\n >\n <ArrowsLeftRightIcon className=\"size-4 shrink-0 text-kumo-brand\" />\n <span className=\"flex-1 text-left font-semibold text-kumo-strong\">\n {surface === \"account\" ? \"Account Nav\" : \"Zone Nav\"}\n </span>\n </button>\n </Sidebar.Header>\n\n <Sidebar.SlidingViews\n activeKey={surface}\n direction={surface === \"zone\" ? \"left\" : \"right\"}\n >\n <Sidebar.SlidingView value=\"account\">\n <Sidebar.Content>\n <Sidebar.Group>\n <Sidebar.GroupLabel>Account</Sidebar.GroupLabel>\n <Sidebar.Menu>\n <Sidebar.MenuButton icon={HouseIcon} active>\n Home\n </Sidebar.MenuButton>\n <Sidebar.MenuButton icon={UserIcon}>\n Members\n </Sidebar.MenuButton>\n <Sidebar.MenuButton icon={ChartBarIcon}>\n Analytics\n </Sidebar.MenuButton>\n <Sidebar.MenuButton icon={GearIcon}>\n Settings\n </Sidebar.MenuButton>\n </Sidebar.Menu>\n </Sidebar.Group>\n </Sidebar.Content>\n </Sidebar.SlidingView>\n\n <Sidebar.SlidingView value=\"zone\">\n <Sidebar.Content>\n <Sidebar.Group>\n <Sidebar.GroupLabel>Zone</Sidebar.GroupLabel>\n <Sidebar.Menu>\n <Sidebar.MenuButton icon={GlobeIcon} active>\n Overview\n </Sidebar.MenuButton>\n <Sidebar.MenuButton icon={ShieldCheckIcon}>\n Security\n </Sidebar.MenuButton>\n <Sidebar.MenuButton icon={LockIcon}>\n SSL/TLS\n </Sidebar.MenuButton>\n <Sidebar.MenuButton icon={DatabaseIcon}>\n Caching\n </Sidebar.MenuButton>\n </Sidebar.Menu>\n </Sidebar.Group>\n </Sidebar.Content>\n </Sidebar.SlidingView>\n </Sidebar.SlidingViews>\n </Sidebar>\n <DemoMain>\n <div className=\"flex flex-col items-center gap-2\">\n <p className=\"font-medium text-kumo-default\">\n Active: {surface === \"account\" ? \"Account\" : \"Zone\"} surface\n </p>\n <p>Click the header button to slide between views</p>\n </div>\n </DemoMain>\n </Sidebar.Provider>\n </DemoContainer>",
5575
+ "<DemoContainer>\n <Sidebar.Provider\n contained\n defaultOpen\n peekable\n className=\"h-full min-h-0!\"\n >\n <Sidebar>\n <Sidebar.Header>\n <AccountSwitcher />\n </Sidebar.Header>\n <Sidebar.SlidingViews\n activeKey={surface}\n direction={surface === \"domain\" ? \"left\" : \"right\"}\n >\n <Sidebar.SlidingView value=\"account\">\n <Sidebar.Content>\n <Sidebar.Group>\n <Sidebar.Menu>\n <Sidebar.MenuButton\n icon={MagnifyingGlassIcon}\n tooltip=\"Search\"\n className=\"mb-3 ring ring-kumo-line transition-[margin] duration-(--sidebar-animation-duration) group-data-[state=collapsed]/sidebar:mb-0 group-data-[state=collapsed]/sidebar:ring-transparent\"\n >\n Quick search&hellip;\n </Sidebar.MenuButton>\n </Sidebar.Menu>\n </Sidebar.Group>\n <Sidebar.Group>\n <Sidebar.Menu>\n <Sidebar.MenuButton icon={HouseIcon} active>\n Home\n </Sidebar.MenuButton>\n <Sidebar.MenuButton icon={ChartBarIcon}>\n Analytics & Logs\n </Sidebar.MenuButton>\n <Sidebar.MenuButton\n icon={GlobeIcon}\n onClick={() => setSurface(\"domain\")}\n >\n Domains\n </Sidebar.MenuButton>\n </Sidebar.Menu>\n </Sidebar.Group>\n\n <Sidebar.Group>\n <Sidebar.GroupLabel>Build</Sidebar.GroupLabel>\n <Sidebar.Menu>\n <Sidebar.MenuItem>\n <Sidebar.Collapsible defaultOpen>\n <Sidebar.CollapsibleTrigger\n render={\n <Sidebar.MenuButton icon={CodeIcon}>\n Compute\n <Sidebar.MenuChevron />\n </Sidebar.MenuButton>\n }\n />\n <Sidebar.CollapsibleContent>\n <Sidebar.MenuSub>\n <Sidebar.MenuSubItem>\n <Sidebar.Collapsible>\n <Sidebar.CollapsibleTrigger\n render={\n <Sidebar.MenuSubButton>\n Workers & Pages\n <Sidebar.MenuChevron />\n </Sidebar.MenuSubButton>\n }\n />\n <Sidebar.CollapsibleContent>\n <Sidebar.MenuSub>\n <Sidebar.MenuSubButton>\n Overview\n </Sidebar.MenuSubButton>\n <Sidebar.MenuSubButton>\n Workers\n </Sidebar.MenuSubButton>\n <Sidebar.MenuSubButton>\n Pages\n </Sidebar.MenuSubButton>\n </Sidebar.MenuSub>\n </Sidebar.CollapsibleContent>\n </Sidebar.Collapsible>\n </Sidebar.MenuSubItem>\n <Sidebar.MenuSubButton>\n Durable Objects\n </Sidebar.MenuSubButton>\n <Sidebar.MenuSubButton>\n Containers\n <Sidebar.MenuBadge>Beta</Sidebar.MenuBadge>\n </Sidebar.MenuSubButton>\n </Sidebar.MenuSub>\n </Sidebar.CollapsibleContent>\n </Sidebar.Collapsible>\n </Sidebar.MenuItem>\n <Sidebar.MenuButton icon={DatabaseIcon}>\n Storage\n </Sidebar.MenuButton>\n </Sidebar.Menu>\n </Sidebar.Group>\n\n <Sidebar.Group>\n <Sidebar.GroupLabel>Protect & Connect</Sidebar.GroupLabel>\n <Sidebar.Menu>\n <Sidebar.MenuButton icon={ShieldCheckIcon}>\n Security\n </Sidebar.MenuButton>\n <Sidebar.MenuButton icon={LockIcon}>\n Zero Trust\n <Sidebar.MenuBadge>Beta</Sidebar.MenuBadge>\n </Sidebar.MenuButton>\n </Sidebar.Menu>\n </Sidebar.Group>\n </Sidebar.Content>\n </Sidebar.SlidingView>\n\n <Sidebar.SlidingView value=\"domain\">\n <Sidebar.Content>\n <Sidebar.Group>\n <Sidebar.Menu>\n <Sidebar.MenuButton\n icon={ArrowLeftIcon}\n onClick={() => setSurface(\"account\")}\n >\n Back\n </Sidebar.MenuButton>\n </Sidebar.Menu>\n </Sidebar.Group>\n <Sidebar.Group>\n <Sidebar.GroupLabel>example.com</Sidebar.GroupLabel>\n <Sidebar.Menu>\n <Sidebar.MenuButton icon={GlobeIcon} active>\n Overview\n </Sidebar.MenuButton>\n <Sidebar.MenuButton icon={ShieldCheckIcon}>\n Security\n </Sidebar.MenuButton>\n <Sidebar.MenuButton icon={LockIcon}>\n SSL/TLS\n </Sidebar.MenuButton>\n <Sidebar.MenuButton icon={ChartBarIcon}>\n Analytics\n </Sidebar.MenuButton>\n <Sidebar.MenuButton icon={DatabaseIcon}>\n Caching\n </Sidebar.MenuButton>\n </Sidebar.Menu>\n </Sidebar.Group>\n </Sidebar.Content>\n </Sidebar.SlidingView>\n </Sidebar.SlidingViews>\n\n <Sidebar.Footer>\n <Sidebar.Trigger />\n </Sidebar.Footer>\n </Sidebar>\n <DemoMain />\n </Sidebar.Provider>\n </DemoContainer>",
5576
+ "<div className=\"relative h-[540px] w-full overflow-hidden rounded-lg border border-kumo-line bg-kumo-base\">\n <Sidebar.Provider contained mobileBreakpoint={9999} className=\"h-full\">\n <Sidebar>\n <Sidebar.Header>\n <BrandLogo />\n </Sidebar.Header>\n <Sidebar.Content>\n <Sidebar.Group>\n <Sidebar.GroupLabel>Overview</Sidebar.GroupLabel>\n <Sidebar.Menu>\n <Sidebar.MenuButton icon={HouseIcon} active>\n Home\n </Sidebar.MenuButton>\n <Sidebar.MenuButton icon={ChartBarIcon}>\n Analytics\n </Sidebar.MenuButton>\n <Sidebar.MenuButton icon={GlobeIcon}>\n Domains\n </Sidebar.MenuButton>\n </Sidebar.Menu>\n </Sidebar.Group>\n\n <Sidebar.Group>\n <Sidebar.GroupLabel>Build</Sidebar.GroupLabel>\n <Sidebar.Menu>\n <Sidebar.MenuButton icon={CodeIcon}>Compute</Sidebar.MenuButton>\n <Sidebar.MenuButton icon={DatabaseIcon}>\n Storage\n </Sidebar.MenuButton>\n </Sidebar.Menu>\n </Sidebar.Group>\n </Sidebar.Content>\n <Sidebar.Footer>\n <Sidebar.Trigger />\n </Sidebar.Footer>\n </Sidebar>\n <DemoMain>\n <MobileToggleButton />\n <p>Click the button to open the mobile sidebar</p>\n <p className=\"text-sm text-kumo-subtle\">\n Press Escape or click the backdrop to close\n </p>\n </DemoMain>\n </Sidebar.Provider>\n </div>",
5577
+ "<div className=\"flex flex-col gap-3\">\n {/* Width control — stands in for resizing a real phone viewport. */}\n <label className=\"flex items-center gap-3 text-sm text-kumo-subtle\">\n <span className=\"shrink-0\">Viewport</span>\n <input\n type=\"range\"\n min={280}\n max={720}\n value={width}\n onChange={(e) => setWidth(Number(e.target.value))}\n className=\"flex-1 cursor-pointer\"\n />\n <span className=\"w-14 shrink-0 text-right tabular-nums\">{width}px</span>\n </label>\n\n <div\n className=\"relative h-[540px] overflow-hidden rounded-lg border border-kumo-line bg-kumo-base\"\n style={{ width }}\n >\n <Sidebar.Provider contained mobileBreakpoint={9999} className=\"h-full\">\n <Sidebar fullScreenOnMobile>\n {/* Single row: avatar, then the trail takes the rest of the width.\n Mirrors the product header — account mark, then breadcrumbs. */}\n <Sidebar.Header className=\"gap-2 px-3.5\">\n <CompactAccountSwitcher />\n <div className=\"min-w-0 flex-1\">\n <Breadcrumbs size=\"sm\">\n {trail.map((label) => (\n <Fragment key={label}>\n <Breadcrumbs.Link href=\"#\">{label}</Breadcrumbs.Link>\n <Breadcrumbs.Separator />\n </Fragment>\n ))}\n <Breadcrumbs.Current>{current}</Breadcrumbs.Current>\n </Breadcrumbs>\n </div>\n <Sidebar.Close />\n </Sidebar.Header>\n <Sidebar.Content>\n <div className=\"pt-1 pb-2\">\n <QuickSearch />\n </div>\n <NavTree selected={selected} onSelect={setSelected} />\n </Sidebar.Content>\n </Sidebar>\n\n <div className=\"flex min-w-0 flex-1 flex-col\">\n <header className=\"flex h-12 shrink-0 items-center gap-2 border-b border-kumo-line px-3\">\n <Sidebar.Trigger />\n <div className=\"min-w-0 flex-1\">\n <Breadcrumbs size=\"sm\">\n {trail.map((label) => (\n <Fragment key={label}>\n <Breadcrumbs.Link href=\"#\">{label}</Breadcrumbs.Link>\n <Breadcrumbs.Separator />\n </Fragment>\n ))}\n <Breadcrumbs.Current>{current}</Breadcrumbs.Current>\n </Breadcrumbs>\n </div>\n </header>\n <DemoMain>\n <p className=\"text-kumo-default\">{current}</p>\n <p className=\"text-sm text-kumo-subtle\">\n Drill into the nav — the trail is derived from the tree, so it\n always matches where you are.\n </p>\n </DemoMain>\n </div>\n </Sidebar.Provider>\n </div>\n </div>"
5028
5578
  ],
5029
5579
  "colors": [
5030
5580
  "bg-kumo-brand",
@@ -5044,19 +5594,23 @@
5044
5594
  "props": {
5045
5595
  "defaultOpen": {
5046
5596
  "type": "boolean",
5047
- "optional": true
5597
+ "optional": true,
5598
+ "description": "Initial open state when uncontrolled."
5048
5599
  },
5049
5600
  "open": {
5050
5601
  "type": "boolean",
5051
- "optional": true
5602
+ "optional": true,
5603
+ "description": "Controlled open state."
5052
5604
  },
5053
5605
  "variant": {
5054
5606
  "type": "SidebarVariant",
5055
- "optional": true
5607
+ "optional": true,
5608
+ "description": "Sidebar layout variant."
5056
5609
  },
5057
5610
  "side": {
5058
5611
  "type": "SidebarSide",
5059
- "optional": true
5612
+ "optional": true,
5613
+ "description": "Which side the sidebar is on."
5060
5614
  },
5061
5615
  "collapsible": {
5062
5616
  "type": "\"icon\" | \"offcanvas\" | \"none\"",
@@ -5064,43 +5618,53 @@
5064
5618
  },
5065
5619
  "resizable": {
5066
5620
  "type": "boolean",
5067
- "optional": true
5621
+ "optional": true,
5622
+ "description": "Enable drag-to-resize on the sidebar edge."
5068
5623
  },
5069
5624
  "defaultWidth": {
5070
5625
  "type": "number",
5071
- "optional": true
5626
+ "optional": true,
5627
+ "description": "Initial width in pixels when resizable."
5072
5628
  },
5073
5629
  "minWidth": {
5074
5630
  "type": "number",
5075
- "optional": true
5631
+ "optional": true,
5632
+ "description": "Minimum width in pixels when resizing."
5076
5633
  },
5077
5634
  "maxWidth": {
5078
5635
  "type": "number",
5079
- "optional": true
5636
+ "optional": true,
5637
+ "description": "Maximum width in pixels when resizing."
5080
5638
  },
5081
5639
  "contained": {
5082
5640
  "type": "boolean",
5083
- "optional": true
5641
+ "optional": true,
5642
+ "description": "When true, the collapsed sidebar uses absolute positioning instead of fixed, keeping it scoped inside a bounded parent. Useful for demos and embedded sidebars."
5084
5643
  },
5085
5644
  "peekable": {
5086
5645
  "type": "boolean",
5087
- "optional": true
5646
+ "optional": true,
5647
+ "description": "When true, hovering or focusing the collapsed sidebar temporarily expands it. The `state` will be `\"peeking\"` during the peek. Moving away collapses it back."
5088
5648
  },
5089
5649
  "animationDuration": {
5090
5650
  "type": "number",
5091
- "optional": true
5651
+ "optional": true,
5652
+ "description": "Duration of sidebar expand/collapse animation in milliseconds."
5092
5653
  },
5093
5654
  "mobileBreakpoint": {
5094
5655
  "type": "number",
5095
- "optional": true
5656
+ "optional": true,
5657
+ "description": "Viewport width (in px) below which the sidebar renders as a mobile dialog sheet instead of the desktop aside rail."
5096
5658
  },
5097
5659
  "children": {
5098
5660
  "type": "ReactNode",
5099
- "required": true
5661
+ "required": true,
5662
+ "description": "Content — typically `<Sidebar>` + main content."
5100
5663
  },
5101
5664
  "className": {
5102
5665
  "type": "string",
5103
- "optional": true
5666
+ "optional": true,
5667
+ "description": "Additional CSS classes for the wrapper div."
5104
5668
  }
5105
5669
  }
5106
5670
  },
@@ -5109,7 +5673,37 @@
5109
5673
  "description": "Header sub-component",
5110
5674
  "props": {
5111
5675
  "icon": {
5112
- "type": "React.ComponentType<{ className?: string",
5676
+ "type": "React.ComponentType<{ className?: string }> | React.ReactNode",
5677
+ "optional": true
5678
+ },
5679
+ "active": {
5680
+ "type": "boolean",
5681
+ "optional": true
5682
+ },
5683
+ "size": {
5684
+ "type": "SidebarMenuButtonSize",
5685
+ "optional": true,
5686
+ "description": "Button size. - `\"base\"` — Standard nav item - `\"sm\"` — Compact nav item"
5687
+ },
5688
+ "href": {
5689
+ "type": "string",
5690
+ "optional": true
5691
+ },
5692
+ "target": {
5693
+ "type": "React.HTMLAttributeAnchorTarget",
5694
+ "optional": true,
5695
+ "description": "Link target — only meaningful when `href` is provided."
5696
+ },
5697
+ "tooltip": {
5698
+ "type": "string",
5699
+ "optional": true
5700
+ },
5701
+ "className": {
5702
+ "type": "string",
5703
+ "optional": true
5704
+ },
5705
+ "children": {
5706
+ "type": "ReactNode",
5113
5707
  "optional": true
5114
5708
  }
5115
5709
  }
@@ -5119,7 +5713,37 @@
5119
5713
  "description": "Content sub-component",
5120
5714
  "props": {
5121
5715
  "icon": {
5122
- "type": "React.ComponentType<{ className?: string",
5716
+ "type": "React.ComponentType<{ className?: string }> | React.ReactNode",
5717
+ "optional": true
5718
+ },
5719
+ "active": {
5720
+ "type": "boolean",
5721
+ "optional": true
5722
+ },
5723
+ "size": {
5724
+ "type": "SidebarMenuButtonSize",
5725
+ "optional": true,
5726
+ "description": "Button size. - `\"base\"` — Standard nav item - `\"sm\"` — Compact nav item"
5727
+ },
5728
+ "href": {
5729
+ "type": "string",
5730
+ "optional": true
5731
+ },
5732
+ "target": {
5733
+ "type": "React.HTMLAttributeAnchorTarget",
5734
+ "optional": true,
5735
+ "description": "Link target — only meaningful when `href` is provided."
5736
+ },
5737
+ "tooltip": {
5738
+ "type": "string",
5739
+ "optional": true
5740
+ },
5741
+ "className": {
5742
+ "type": "string",
5743
+ "optional": true
5744
+ },
5745
+ "children": {
5746
+ "type": "ReactNode",
5123
5747
  "optional": true
5124
5748
  }
5125
5749
  }
@@ -5129,7 +5753,77 @@
5129
5753
  "description": "Footer sub-component",
5130
5754
  "props": {
5131
5755
  "icon": {
5132
- "type": "React.ComponentType<{ className?: string",
5756
+ "type": "React.ComponentType<{ className?: string }> | React.ReactNode",
5757
+ "optional": true
5758
+ },
5759
+ "active": {
5760
+ "type": "boolean",
5761
+ "optional": true
5762
+ },
5763
+ "size": {
5764
+ "type": "SidebarMenuButtonSize",
5765
+ "optional": true,
5766
+ "description": "Button size. - `\"base\"` — Standard nav item - `\"sm\"` — Compact nav item"
5767
+ },
5768
+ "href": {
5769
+ "type": "string",
5770
+ "optional": true
5771
+ },
5772
+ "target": {
5773
+ "type": "React.HTMLAttributeAnchorTarget",
5774
+ "optional": true,
5775
+ "description": "Link target — only meaningful when `href` is provided."
5776
+ },
5777
+ "tooltip": {
5778
+ "type": "string",
5779
+ "optional": true
5780
+ },
5781
+ "className": {
5782
+ "type": "string",
5783
+ "optional": true
5784
+ },
5785
+ "children": {
5786
+ "type": "ReactNode",
5787
+ "optional": true
5788
+ }
5789
+ }
5790
+ },
5791
+ "Loading": {
5792
+ "name": "Loading",
5793
+ "description": "Loading sub-component",
5794
+ "props": {
5795
+ "icon": {
5796
+ "type": "React.ComponentType<{ className?: string }> | React.ReactNode",
5797
+ "optional": true
5798
+ },
5799
+ "active": {
5800
+ "type": "boolean",
5801
+ "optional": true
5802
+ },
5803
+ "size": {
5804
+ "type": "SidebarMenuButtonSize",
5805
+ "optional": true,
5806
+ "description": "Button size. - `\"base\"` — Standard nav item - `\"sm\"` — Compact nav item"
5807
+ },
5808
+ "href": {
5809
+ "type": "string",
5810
+ "optional": true
5811
+ },
5812
+ "target": {
5813
+ "type": "React.HTMLAttributeAnchorTarget",
5814
+ "optional": true,
5815
+ "description": "Link target — only meaningful when `href` is provided."
5816
+ },
5817
+ "tooltip": {
5818
+ "type": "string",
5819
+ "optional": true
5820
+ },
5821
+ "className": {
5822
+ "type": "string",
5823
+ "optional": true
5824
+ },
5825
+ "children": {
5826
+ "type": "ReactNode",
5133
5827
  "optional": true
5134
5828
  }
5135
5829
  }
@@ -5139,17 +5833,77 @@
5139
5833
  "description": "Group sub-component",
5140
5834
  "props": {
5141
5835
  "icon": {
5142
- "type": "React.ComponentType<{ className?: string",
5836
+ "type": "React.ComponentType<{ className?: string }> | React.ReactNode",
5837
+ "optional": true
5838
+ },
5839
+ "active": {
5840
+ "type": "boolean",
5841
+ "optional": true
5842
+ },
5843
+ "size": {
5844
+ "type": "SidebarMenuButtonSize",
5845
+ "optional": true,
5846
+ "description": "Button size. - `\"base\"` — Standard nav item - `\"sm\"` — Compact nav item"
5847
+ },
5848
+ "href": {
5849
+ "type": "string",
5850
+ "optional": true
5851
+ },
5852
+ "target": {
5853
+ "type": "React.HTMLAttributeAnchorTarget",
5854
+ "optional": true,
5855
+ "description": "Link target — only meaningful when `href` is provided."
5856
+ },
5857
+ "tooltip": {
5858
+ "type": "string",
5859
+ "optional": true
5860
+ },
5861
+ "className": {
5862
+ "type": "string",
5863
+ "optional": true
5864
+ },
5865
+ "children": {
5866
+ "type": "ReactNode",
5867
+ "optional": true
5868
+ }
5869
+ }
5870
+ },
5871
+ "GroupLabel": {
5872
+ "name": "GroupLabel",
5873
+ "description": "GroupLabel sub-component",
5874
+ "props": {
5875
+ "icon": {
5876
+ "type": "React.ComponentType<{ className?: string }> | React.ReactNode",
5877
+ "optional": true
5878
+ },
5879
+ "active": {
5880
+ "type": "boolean",
5881
+ "optional": true
5882
+ },
5883
+ "size": {
5884
+ "type": "SidebarMenuButtonSize",
5885
+ "optional": true,
5886
+ "description": "Button size. - `\"base\"` — Standard nav item - `\"sm\"` — Compact nav item"
5887
+ },
5888
+ "href": {
5889
+ "type": "string",
5890
+ "optional": true
5891
+ },
5892
+ "target": {
5893
+ "type": "React.HTMLAttributeAnchorTarget",
5894
+ "optional": true,
5895
+ "description": "Link target — only meaningful when `href` is provided."
5896
+ },
5897
+ "tooltip": {
5898
+ "type": "string",
5143
5899
  "optional": true
5144
- }
5145
- }
5146
- },
5147
- "GroupLabel": {
5148
- "name": "GroupLabel",
5149
- "description": "GroupLabel sub-component",
5150
- "props": {
5151
- "icon": {
5152
- "type": "React.ComponentType<{ className?: string",
5900
+ },
5901
+ "className": {
5902
+ "type": "string",
5903
+ "optional": true
5904
+ },
5905
+ "children": {
5906
+ "type": "ReactNode",
5153
5907
  "optional": true
5154
5908
  }
5155
5909
  }
@@ -5159,7 +5913,37 @@
5159
5913
  "description": "Menu sub-component",
5160
5914
  "props": {
5161
5915
  "icon": {
5162
- "type": "React.ComponentType<{ className?: string",
5916
+ "type": "React.ComponentType<{ className?: string }> | React.ReactNode",
5917
+ "optional": true
5918
+ },
5919
+ "active": {
5920
+ "type": "boolean",
5921
+ "optional": true
5922
+ },
5923
+ "size": {
5924
+ "type": "SidebarMenuButtonSize",
5925
+ "optional": true,
5926
+ "description": "Button size. - `\"base\"` — Standard nav item - `\"sm\"` — Compact nav item"
5927
+ },
5928
+ "href": {
5929
+ "type": "string",
5930
+ "optional": true
5931
+ },
5932
+ "target": {
5933
+ "type": "React.HTMLAttributeAnchorTarget",
5934
+ "optional": true,
5935
+ "description": "Link target — only meaningful when `href` is provided."
5936
+ },
5937
+ "tooltip": {
5938
+ "type": "string",
5939
+ "optional": true
5940
+ },
5941
+ "className": {
5942
+ "type": "string",
5943
+ "optional": true
5944
+ },
5945
+ "children": {
5946
+ "type": "ReactNode",
5163
5947
  "optional": true
5164
5948
  }
5165
5949
  }
@@ -5169,7 +5953,37 @@
5169
5953
  "description": "MenuItem sub-component",
5170
5954
  "props": {
5171
5955
  "icon": {
5172
- "type": "React.ComponentType<{ className?: string",
5956
+ "type": "React.ComponentType<{ className?: string }> | React.ReactNode",
5957
+ "optional": true
5958
+ },
5959
+ "active": {
5960
+ "type": "boolean",
5961
+ "optional": true
5962
+ },
5963
+ "size": {
5964
+ "type": "SidebarMenuButtonSize",
5965
+ "optional": true,
5966
+ "description": "Button size. - `\"base\"` — Standard nav item - `\"sm\"` — Compact nav item"
5967
+ },
5968
+ "href": {
5969
+ "type": "string",
5970
+ "optional": true
5971
+ },
5972
+ "target": {
5973
+ "type": "React.HTMLAttributeAnchorTarget",
5974
+ "optional": true,
5975
+ "description": "Link target — only meaningful when `href` is provided."
5976
+ },
5977
+ "tooltip": {
5978
+ "type": "string",
5979
+ "optional": true
5980
+ },
5981
+ "className": {
5982
+ "type": "string",
5983
+ "optional": true
5984
+ },
5985
+ "children": {
5986
+ "type": "ReactNode",
5173
5987
  "optional": true
5174
5988
  }
5175
5989
  }
@@ -5179,7 +5993,37 @@
5179
5993
  "description": "MenuButton sub-component",
5180
5994
  "props": {
5181
5995
  "icon": {
5182
- "type": "React.ComponentType<{ className?: string",
5996
+ "type": "React.ComponentType<{ className?: string }> | React.ReactNode",
5997
+ "optional": true
5998
+ },
5999
+ "active": {
6000
+ "type": "boolean",
6001
+ "optional": true
6002
+ },
6003
+ "size": {
6004
+ "type": "SidebarMenuButtonSize",
6005
+ "optional": true,
6006
+ "description": "Button size. - `\"base\"` — Standard nav item - `\"sm\"` — Compact nav item"
6007
+ },
6008
+ "href": {
6009
+ "type": "string",
6010
+ "optional": true
6011
+ },
6012
+ "target": {
6013
+ "type": "React.HTMLAttributeAnchorTarget",
6014
+ "optional": true,
6015
+ "description": "Link target — only meaningful when `href` is provided."
6016
+ },
6017
+ "tooltip": {
6018
+ "type": "string",
6019
+ "optional": true
6020
+ },
6021
+ "className": {
6022
+ "type": "string",
6023
+ "optional": true
6024
+ },
6025
+ "children": {
6026
+ "type": "ReactNode",
5183
6027
  "optional": true
5184
6028
  }
5185
6029
  }
@@ -5190,11 +6034,18 @@
5190
6034
  "props": {
5191
6035
  "active": {
5192
6036
  "type": "boolean",
5193
- "optional": true
6037
+ "optional": true,
6038
+ "description": "Marks this sub-item as currently active/selected."
5194
6039
  },
5195
6040
  "href": {
5196
6041
  "type": "string",
5197
- "optional": true
6042
+ "optional": true,
6043
+ "description": "Navigation URL. When set, renders as a link via LinkProvider."
6044
+ },
6045
+ "target": {
6046
+ "type": "React.HTMLAttributeAnchorTarget",
6047
+ "optional": true,
6048
+ "description": "Link target — only meaningful when `href` is provided."
5198
6049
  }
5199
6050
  }
5200
6051
  },
@@ -5204,11 +6055,18 @@
5204
6055
  "props": {
5205
6056
  "active": {
5206
6057
  "type": "boolean",
5207
- "optional": true
6058
+ "optional": true,
6059
+ "description": "Marks this sub-item as currently active/selected."
5208
6060
  },
5209
6061
  "href": {
5210
6062
  "type": "string",
5211
- "optional": true
6063
+ "optional": true,
6064
+ "description": "Navigation URL. When set, renders as a link via LinkProvider."
6065
+ },
6066
+ "target": {
6067
+ "type": "React.HTMLAttributeAnchorTarget",
6068
+ "optional": true,
6069
+ "description": "Link target — only meaningful when `href` is provided."
5212
6070
  }
5213
6071
  }
5214
6072
  },
@@ -5218,11 +6076,18 @@
5218
6076
  "props": {
5219
6077
  "active": {
5220
6078
  "type": "boolean",
5221
- "optional": true
6079
+ "optional": true,
6080
+ "description": "Marks this sub-item as currently active/selected."
5222
6081
  },
5223
6082
  "href": {
5224
6083
  "type": "string",
5225
- "optional": true
6084
+ "optional": true,
6085
+ "description": "Navigation URL. When set, renders as a link via LinkProvider."
6086
+ },
6087
+ "target": {
6088
+ "type": "React.HTMLAttributeAnchorTarget",
6089
+ "optional": true,
6090
+ "description": "Link target — only meaningful when `href` is provided."
5226
6091
  }
5227
6092
  }
5228
6093
  },
@@ -5232,11 +6097,18 @@
5232
6097
  "props": {
5233
6098
  "active": {
5234
6099
  "type": "boolean",
5235
- "optional": true
6100
+ "optional": true,
6101
+ "description": "Marks this sub-item as currently active/selected."
5236
6102
  },
5237
6103
  "href": {
5238
6104
  "type": "string",
5239
- "optional": true
6105
+ "optional": true,
6106
+ "description": "Navigation URL. When set, renders as a link via LinkProvider."
6107
+ },
6108
+ "target": {
6109
+ "type": "React.HTMLAttributeAnchorTarget",
6110
+ "optional": true,
6111
+ "description": "Link target — only meaningful when `href` is provided."
5240
6112
  }
5241
6113
  }
5242
6114
  },
@@ -5246,15 +6118,18 @@
5246
6118
  "props": {
5247
6119
  "defaultOpen": {
5248
6120
  "type": "boolean",
5249
- "optional": true
6121
+ "optional": true,
6122
+ "description": "Initial open state (uncontrolled)."
5250
6123
  },
5251
6124
  "open": {
5252
6125
  "type": "boolean",
5253
- "optional": true
6126
+ "optional": true,
6127
+ "description": "Controlled open state."
5254
6128
  },
5255
6129
  "autoScrollOnOpen": {
5256
6130
  "type": "boolean",
5257
- "optional": true
6131
+ "optional": true,
6132
+ "description": "Scroll the expanded content into view after opening."
5258
6133
  }
5259
6134
  }
5260
6135
  },
@@ -5264,15 +6139,39 @@
5264
6139
  "props": {
5265
6140
  "defaultOpen": {
5266
6141
  "type": "boolean",
5267
- "optional": true
6142
+ "optional": true,
6143
+ "description": "Initial open state (uncontrolled)."
5268
6144
  },
5269
6145
  "open": {
5270
6146
  "type": "boolean",
5271
- "optional": true
6147
+ "optional": true,
6148
+ "description": "Controlled open state."
5272
6149
  },
5273
6150
  "autoScrollOnOpen": {
5274
6151
  "type": "boolean",
5275
- "optional": true
6152
+ "optional": true,
6153
+ "description": "Scroll the expanded content into view after opening."
6154
+ }
6155
+ }
6156
+ },
6157
+ "Close": {
6158
+ "name": "Close",
6159
+ "description": "Close sub-component",
6160
+ "props": {
6161
+ "defaultOpen": {
6162
+ "type": "boolean",
6163
+ "optional": true,
6164
+ "description": "Initial open state (uncontrolled)."
6165
+ },
6166
+ "open": {
6167
+ "type": "boolean",
6168
+ "optional": true,
6169
+ "description": "Controlled open state."
6170
+ },
6171
+ "autoScrollOnOpen": {
6172
+ "type": "boolean",
6173
+ "optional": true,
6174
+ "description": "Scroll the expanded content into view after opening."
5276
6175
  }
5277
6176
  }
5278
6177
  },
@@ -5282,15 +6181,18 @@
5282
6181
  "props": {
5283
6182
  "defaultOpen": {
5284
6183
  "type": "boolean",
5285
- "optional": true
6184
+ "optional": true,
6185
+ "description": "Initial open state (uncontrolled)."
5286
6186
  },
5287
6187
  "open": {
5288
6188
  "type": "boolean",
5289
- "optional": true
6189
+ "optional": true,
6190
+ "description": "Controlled open state."
5290
6191
  },
5291
6192
  "autoScrollOnOpen": {
5292
6193
  "type": "boolean",
5293
- "optional": true
6194
+ "optional": true,
6195
+ "description": "Scroll the expanded content into view after opening."
5294
6196
  }
5295
6197
  }
5296
6198
  },
@@ -5300,15 +6202,18 @@
5300
6202
  "props": {
5301
6203
  "defaultOpen": {
5302
6204
  "type": "boolean",
5303
- "optional": true
6205
+ "optional": true,
6206
+ "description": "Initial open state (uncontrolled)."
5304
6207
  },
5305
6208
  "open": {
5306
6209
  "type": "boolean",
5307
- "optional": true
6210
+ "optional": true,
6211
+ "description": "Controlled open state."
5308
6212
  },
5309
6213
  "autoScrollOnOpen": {
5310
6214
  "type": "boolean",
5311
- "optional": true
6215
+ "optional": true,
6216
+ "description": "Scroll the expanded content into view after opening."
5312
6217
  }
5313
6218
  }
5314
6219
  },
@@ -5328,15 +6233,18 @@
5328
6233
  "props": {
5329
6234
  "defaultOpen": {
5330
6235
  "type": "boolean",
5331
- "optional": true
6236
+ "optional": true,
6237
+ "description": "Initial open state (uncontrolled)."
5332
6238
  },
5333
6239
  "open": {
5334
6240
  "type": "boolean",
5335
- "optional": true
6241
+ "optional": true,
6242
+ "description": "Controlled open state."
5336
6243
  },
5337
6244
  "autoScrollOnOpen": {
5338
6245
  "type": "boolean",
5339
- "optional": true
6246
+ "optional": true,
6247
+ "description": "Scroll the expanded content into view after opening."
5340
6248
  }
5341
6249
  }
5342
6250
  },
@@ -5346,7 +6254,8 @@
5346
6254
  "props": {
5347
6255
  "render": {
5348
6256
  "type": "React.ReactElement",
5349
- "required": true
6257
+ "required": true,
6258
+ "description": "Element to render as the trigger. Gets aria-expanded, aria-controls, and onClick merged."
5350
6259
  }
5351
6260
  }
5352
6261
  },
@@ -5356,11 +6265,13 @@
5356
6265
  "props": {
5357
6266
  "activeKey": {
5358
6267
  "type": "string",
5359
- "required": true
6268
+ "required": true,
6269
+ "description": "Key of the currently active view. Must match a child `SlidingView` value."
5360
6270
  },
5361
6271
  "direction": {
5362
6272
  "type": "\"left\" | \"right\"",
5363
- "optional": true
6273
+ "optional": true,
6274
+ "description": "Slide direction for the transition. - `\"left\"`: new view slides in from the right - `\"right\"`: new view slides in from the left"
5364
6275
  }
5365
6276
  }
5366
6277
  },
@@ -5370,11 +6281,13 @@
5370
6281
  "props": {
5371
6282
  "activeKey": {
5372
6283
  "type": "string",
5373
- "required": true
6284
+ "required": true,
6285
+ "description": "Key of the currently active view. Must match a child `SlidingView` value."
5374
6286
  },
5375
6287
  "direction": {
5376
6288
  "type": "\"left\" | \"right\"",
5377
- "optional": true
6289
+ "optional": true,
6290
+ "description": "Slide direction for the transition. - `\"left\"`: new view slides in from the right - `\"right\"`: new view slides in from the left"
5378
6291
  }
5379
6292
  }
5380
6293
  },
@@ -5384,7 +6297,8 @@
5384
6297
  "props": {
5385
6298
  "value": {
5386
6299
  "type": "string",
5387
- "required": true
6300
+ "required": true,
6301
+ "description": "Unique key matching this view. Must correspond to `activeKey` on `SlidingViews`."
5388
6302
  }
5389
6303
  }
5390
6304
  }
@@ -5586,31 +6500,38 @@
5586
6500
  "props": {
5587
6501
  "legend": {
5588
6502
  "type": "string",
5589
- "optional": true
6503
+ "optional": true,
6504
+ "description": "Legend text for the group. For more control over legend styling, omit this prop and use `<Switch.Legend>` as a child instead."
5590
6505
  },
5591
6506
  "children": {
5592
6507
  "type": "ReactNode",
5593
- "required": true
6508
+ "required": true,
6509
+ "description": "Child Switch.Item components (and optionally a Switch.Legend)"
5594
6510
  },
5595
6511
  "error": {
5596
6512
  "type": "string",
5597
- "optional": true
6513
+ "optional": true,
6514
+ "description": "Error message for the group (only appears in groups, not single switches)"
5598
6515
  },
5599
6516
  "description": {
5600
6517
  "type": "ReactNode",
5601
- "optional": true
6518
+ "optional": true,
6519
+ "description": "Helper text for the group"
5602
6520
  },
5603
6521
  "disabled": {
5604
6522
  "type": "boolean",
5605
- "optional": true
6523
+ "optional": true,
6524
+ "description": "Whether all switches in the group are disabled"
5606
6525
  },
5607
6526
  "controlFirst": {
5608
6527
  "type": "boolean",
5609
- "optional": true
6528
+ "optional": true,
6529
+ "description": "When true (default), switch appears before label. When false, label appears before switch."
5610
6530
  },
5611
6531
  "className": {
5612
6532
  "type": "string",
5613
- "optional": true
6533
+ "optional": true,
6534
+ "description": "Additional CSS classes"
5614
6535
  }
5615
6536
  }
5616
6537
  },
@@ -5620,11 +6541,13 @@
5620
6541
  "props": {
5621
6542
  "children": {
5622
6543
  "type": "ReactNode",
5623
- "required": true
6544
+ "required": true,
6545
+ "description": "Legend content"
5624
6546
  },
5625
6547
  "className": {
5626
6548
  "type": "string",
5627
- "optional": true
6549
+ "optional": true,
6550
+ "description": "Additional CSS classes (e.g. \"sr-only\" to visually hide the legend)"
5628
6551
  }
5629
6552
  }
5630
6553
  }
@@ -5697,8 +6620,8 @@
5697
6620
  "<LayerCard className=\"p-0\">\n <Table>\n <Table.Header variant=\"compact\">\n <Table.Row>\n <Table.Head>Subject</Table.Head>\n <Table.Head>From</Table.Head>\n <Table.Head>Date</Table.Head>\n </Table.Row>\n </Table.Header>\n <Table.Body>\n {emailData.slice(0, 3).map((row) => (\n <Table.Row key={row.id}>\n <Table.Cell>{row.subject}</Table.Cell>\n <Table.Cell>{row.from}</Table.Cell>\n <Table.Cell>{row.date}</Table.Cell>\n </Table.Row>\n ))}\n </Table.Body>\n </Table>\n </LayerCard>",
5698
6621
  "<LayerCard className=\"p-0\">\n <Table>\n <Table.Header>\n <Table.Row>\n <Table.CheckHead\n checked={selectedIds.size === rows.length}\n indeterminate={\n selectedIds.size > 0 && selectedIds.size < rows.length\n }\n onCheckedChange={toggleAll}\n aria-label=\"Select all rows\"\n />\n <Table.Head>Subject</Table.Head>\n <Table.Head>From</Table.Head>\n <Table.Head>Date</Table.Head>\n </Table.Row>\n </Table.Header>\n <Table.Body>\n {rows.map((row) => (\n <Table.Row\n key={row.id}\n variant={selectedIds.has(row.id) ? \"selected\" : \"default\"}\n >\n <Table.CheckCell\n checked={selectedIds.has(row.id)}\n onCheckedChange={() => toggleRow(row.id)}\n aria-label={`Select ${row.subject}`}\n />\n <Table.Cell>{row.subject}</Table.Cell>\n <Table.Cell>{row.from}</Table.Cell>\n <Table.Cell>{row.date}</Table.Cell>\n </Table.Row>\n ))}\n </Table.Body>\n </Table>\n </LayerCard>",
5699
6622
  "<LayerCard className=\"p-0\">\n <Table layout=\"fixed\">\n <colgroup>\n <col />\n <col className=\"w-[150px]\" />\n <col className=\"w-[150px]\" />\n </colgroup>\n <Table.Header>\n <Table.Row>\n <Table.Head>Subject</Table.Head>\n <Table.Head>From</Table.Head>\n <Table.Head>Date</Table.Head>\n </Table.Row>\n </Table.Header>\n <Table.Body>\n {emailData.map((row) => (\n <Table.Row key={row.id}>\n <Table.Cell>{row.subject}</Table.Cell>\n <Table.Cell>{row.from}</Table.Cell>\n <Table.Cell>{row.date}</Table.Cell>\n </Table.Row>\n ))}\n </Table.Body>\n </Table>\n </LayerCard>",
5700
- "<LayerCard className=\"w-full max-w-md overflow-x-auto p-0\">\n <Table>\n <Table.Header variant=\"compact\">\n <Table.Row>\n <Table.Head>Subject</Table.Head>\n <Table.Head>From</Table.Head>\n <Table.Head>Date</Table.Head>\n <Table.Head>Tags</Table.Head>\n <Table.Head sticky=\"right\">\n <span className=\"sr-only\">Actions</span>\n </Table.Head>\n </Table.Row>\n </Table.Header>\n <Table.Body>\n {emailData.map((row) => (\n <Table.Row key={row.id}>\n <Table.Cell className=\"whitespace-nowrap\">\n {row.subject}\n </Table.Cell>\n <Table.Cell className=\"whitespace-nowrap\">\n {row.from}\n </Table.Cell>\n <Table.Cell className=\"whitespace-nowrap\">\n {row.date}\n </Table.Cell>\n <Table.Cell className=\"whitespace-nowrap\">\n {row.tags ? (\n <div className=\"inline-flex gap-1\">\n {row.tags.map((tag) => (\n <Badge key={tag}>{tag}</Badge>\n ))}\n </div>\n ) : (\n \"—\"\n )}\n </Table.Cell>\n <Table.Cell sticky=\"right\" className=\"text-right\">\n <DropdownMenu>\n <DropdownMenu.Trigger\n render={\n <Button\n variant=\"ghost\"\n size=\"sm\"\n shape=\"square\"\n aria-label=\"More options\"\n >\n <DotsThree weight=\"bold\" size={16} />\n </Button>\n }\n />\n <DropdownMenu.Content>\n <DropdownMenu.Item icon={Eye}>View</DropdownMenu.Item>\n <DropdownMenu.Item icon={PencilSimple}>\n Edit\n </DropdownMenu.Item>\n <DropdownMenu.Separator />\n <DropdownMenu.Item icon={Trash} variant=\"danger\">\n Delete\n </DropdownMenu.Item>\n </DropdownMenu.Content>\n </DropdownMenu>\n </Table.Cell>\n </Table.Row>\n ))}\n </Table.Body>\n </Table>\n </LayerCard>",
5701
- "<LayerCard className=\"w-full max-w-md overflow-x-auto p-0\">\n <Table>\n <Table.Header>\n <Table.Row>\n <Table.Head>Subject</Table.Head>\n <Table.Head>From</Table.Head>\n <Table.Head>Date</Table.Head>\n <Table.Head>Tags</Table.Head>\n <Table.Head sticky=\"right\">\n <span className=\"sr-only\">Actions</span>\n </Table.Head>\n </Table.Row>\n </Table.Header>\n <Table.Body>\n {emailData.map((row) => (\n <Table.Row key={row.id}>\n <Table.Cell className=\"whitespace-nowrap\">\n {row.subject}\n </Table.Cell>\n <Table.Cell className=\"whitespace-nowrap\">\n {row.from}\n </Table.Cell>\n <Table.Cell className=\"whitespace-nowrap\">\n {row.date}\n </Table.Cell>\n <Table.Cell className=\"whitespace-nowrap\">\n {row.tags ? (\n <div className=\"inline-flex gap-1\">\n {row.tags.map((tag) => (\n <Badge key={tag}>{tag}</Badge>\n ))}\n </div>\n ) : (\n \"—\"\n )}\n </Table.Cell>\n <Table.Cell sticky=\"right\" className=\"text-right\">\n <DropdownMenu>\n <DropdownMenu.Trigger\n render={\n <Button\n variant=\"ghost\"\n size=\"sm\"\n shape=\"square\"\n aria-label=\"More options\"\n >\n <DotsThree weight=\"bold\" size={16} />\n </Button>\n }\n />\n <DropdownMenu.Content>\n <DropdownMenu.Item icon={Eye}>View</DropdownMenu.Item>\n <DropdownMenu.Item icon={PencilSimple}>\n Edit\n </DropdownMenu.Item>\n <DropdownMenu.Separator />\n <DropdownMenu.Item icon={Trash} variant=\"danger\">\n Delete\n </DropdownMenu.Item>\n </DropdownMenu.Content>\n </DropdownMenu>\n </Table.Cell>\n </Table.Row>\n ))}\n </Table.Body>\n </Table>\n </LayerCard>",
6623
+ "<LayerCard className=\"w-full max-w-md overflow-x-auto p-0\">\n <Table>\n <Table.Header variant=\"compact\">\n <Table.Row>\n <Table.Head>Subject</Table.Head>\n <Table.Head>From</Table.Head>\n <Table.Head>Date</Table.Head>\n <Table.Head>Tags</Table.Head>\n <Table.Head sticky=\"right\">\n <span className=\"sr-only\">Actions</span>\n </Table.Head>\n </Table.Row>\n </Table.Header>\n <Table.Body>\n {emailData.map((row) => (\n <Table.Row key={row.id}>\n <Table.Cell className=\"whitespace-nowrap\">\n {row.subject}\n </Table.Cell>\n <Table.Cell className=\"whitespace-nowrap\">{row.from}</Table.Cell>\n <Table.Cell className=\"whitespace-nowrap\">{row.date}</Table.Cell>\n <Table.Cell className=\"whitespace-nowrap\">\n {row.tags ? (\n <div className=\"inline-flex gap-1\">\n {row.tags.map((tag) => (\n <Badge key={tag}>{tag}</Badge>\n ))}\n </div>\n ) : (\n \"—\"\n )}\n </Table.Cell>\n <Table.Cell sticky=\"right\" className=\"text-right\">\n <DropdownMenu>\n <DropdownMenu.Trigger\n render={\n <Button\n variant=\"ghost\"\n size=\"sm\"\n shape=\"square\"\n aria-label=\"More options\"\n >\n <DotsThree weight=\"bold\" size={16} />\n </Button>\n }\n />\n <DropdownMenu.Content>\n <DropdownMenu.Item icon={Eye}>View</DropdownMenu.Item>\n <DropdownMenu.Item icon={PencilSimple}>\n Edit\n </DropdownMenu.Item>\n <DropdownMenu.Separator />\n <DropdownMenu.Item icon={Trash} variant=\"danger\">\n Delete\n </DropdownMenu.Item>\n </DropdownMenu.Content>\n </DropdownMenu>\n </Table.Cell>\n </Table.Row>\n ))}\n </Table.Body>\n </Table>\n </LayerCard>",
6624
+ "<LayerCard className=\"w-full max-w-md overflow-x-auto p-0\">\n <Table>\n <Table.Header>\n <Table.Row>\n <Table.Head>Subject</Table.Head>\n <Table.Head>From</Table.Head>\n <Table.Head>Date</Table.Head>\n <Table.Head>Tags</Table.Head>\n <Table.Head sticky=\"right\">\n <span className=\"sr-only\">Actions</span>\n </Table.Head>\n </Table.Row>\n </Table.Header>\n <Table.Body>\n {emailData.map((row) => (\n <Table.Row key={row.id}>\n <Table.Cell className=\"whitespace-nowrap\">\n {row.subject}\n </Table.Cell>\n <Table.Cell className=\"whitespace-nowrap\">{row.from}</Table.Cell>\n <Table.Cell className=\"whitespace-nowrap\">{row.date}</Table.Cell>\n <Table.Cell className=\"whitespace-nowrap\">\n {row.tags ? (\n <div className=\"inline-flex gap-1\">\n {row.tags.map((tag) => (\n <Badge key={tag}>{tag}</Badge>\n ))}\n </div>\n ) : (\n \"—\"\n )}\n </Table.Cell>\n <Table.Cell sticky=\"right\" className=\"text-right\">\n <DropdownMenu>\n <DropdownMenu.Trigger\n render={\n <Button\n variant=\"ghost\"\n size=\"sm\"\n shape=\"square\"\n aria-label=\"More options\"\n >\n <DotsThree weight=\"bold\" size={16} />\n </Button>\n }\n />\n <DropdownMenu.Content>\n <DropdownMenu.Item icon={Eye}>View</DropdownMenu.Item>\n <DropdownMenu.Item icon={PencilSimple}>\n Edit\n </DropdownMenu.Item>\n <DropdownMenu.Separator />\n <DropdownMenu.Item icon={Trash} variant=\"danger\">\n Delete\n </DropdownMenu.Item>\n </DropdownMenu.Content>\n </DropdownMenu>\n </Table.Cell>\n </Table.Row>\n ))}\n </Table.Body>\n </Table>\n </LayerCard>",
5702
6625
  "<LayerCard className=\"w-full overflow-x-auto p-0\">\n <Table layout=\"fixed\">\n <colgroup>\n <col />{\" \"}\n {/* Checkbox column - width handled by Table.CheckHead/CheckCell */}\n <col />\n <col style={{ width: \"150px\" }} />\n <col style={{ width: \"120px\" }} />\n <col style={{ width: \"50px\" }} />\n </colgroup>\n <Table.Header>\n <Table.Row>\n <Table.CheckHead\n checked={selectedIds.size === emailData.length}\n indeterminate={\n selectedIds.size > 0 && selectedIds.size < emailData.length\n }\n onCheckedChange={toggleAll}\n aria-label=\"Select all rows\"\n />\n <Table.Head>Subject</Table.Head>\n <Table.Head>From</Table.Head>\n <Table.Head>Date</Table.Head>\n <Table.Head></Table.Head>\n </Table.Row>\n </Table.Header>\n <Table.Body>\n {emailData.map((row) => (\n <Table.Row\n key={row.id}\n variant={selectedIds.has(row.id) ? \"selected\" : \"default\"}\n >\n <Table.CheckCell\n checked={selectedIds.has(row.id)}\n onCheckedChange={() => toggleRow(row.id)}\n aria-label={`Select ${row.subject}`}\n />\n <Table.Cell>\n <div className=\"flex items-center gap-2\">\n <EnvelopeSimple size={16} />\n <span className=\"truncate\">{row.subject}</span>\n {row.tags && (\n <div className=\"ml-2 inline-flex gap-1\">\n {row.tags.map((tag) => (\n <Badge key={tag}>{tag}</Badge>\n ))}\n </div>\n )}\n </div>\n </Table.Cell>\n <Table.Cell>\n <span className=\"truncate\">{row.from}</span>\n </Table.Cell>\n <Table.Cell>\n <span className=\"truncate\">{row.date}</span>\n </Table.Cell>\n <Table.Cell className=\"text-right\">\n <DropdownMenu>\n <DropdownMenu.Trigger\n render={\n <Button\n variant=\"ghost\"\n size=\"sm\"\n shape=\"square\"\n aria-label=\"More options\"\n >\n <DotsThree weight=\"bold\" size={16} />\n </Button>\n }\n />\n <DropdownMenu.Content>\n <DropdownMenu.Item icon={Eye}>View</DropdownMenu.Item>\n <DropdownMenu.Item icon={PencilSimple}>\n Edit\n </DropdownMenu.Item>\n <DropdownMenu.Separator />\n <DropdownMenu.Item icon={Trash} variant=\"danger\">\n Delete\n </DropdownMenu.Item>\n </DropdownMenu.Content>\n </DropdownMenu>\n </Table.Cell>\n </Table.Row>\n ))}\n </Table.Body>\n </Table>\n </LayerCard>"
5703
6626
  ],
5704
6627
  "colors": [
@@ -5793,6 +6716,7 @@
5793
6716
  "<DemoWrapper>\n <TableOfContents>\n <TableOfContents.Title>On this page</TableOfContents.Title>\n <TableOfContents.List>\n {headings.map((heading) => (\n <TableOfContents.Item key={heading.text} className=\"cursor-pointer\">\n {heading.text}\n </TableOfContents.Item>\n ))}\n </TableOfContents.List>\n </TableOfContents>\n </DemoWrapper>",
5794
6717
  "<DemoWrapper>\n <TableOfContents>\n <TableOfContents.Title>On this page</TableOfContents.Title>\n <TableOfContents.List>\n <TableOfContents.Item active className=\"cursor-pointer\">\n Overview\n </TableOfContents.Item>\n <TableOfContents.Group label=\"Examples\" href=\"#examples-demo\">\n <TableOfContents.Item className=\"cursor-pointer\">\n Basic example\n </TableOfContents.Item>\n <TableOfContents.Item className=\"cursor-pointer\">\n Advanced example\n </TableOfContents.Item>\n </TableOfContents.Group>\n <TableOfContents.Group label=\"Getting Started\">\n <TableOfContents.Item className=\"cursor-pointer\">\n Installation\n </TableOfContents.Item>\n <TableOfContents.Item className=\"cursor-pointer\">\n Configuration\n </TableOfContents.Item>\n </TableOfContents.Group>\n <TableOfContents.Group label=\"API\" href=\"#api-demo\">\n <TableOfContents.Item className=\"cursor-pointer\">\n Props\n </TableOfContents.Item>\n <TableOfContents.Item className=\"cursor-pointer\">\n Events\n </TableOfContents.Item>\n </TableOfContents.Group>\n </TableOfContents.List>\n </TableOfContents>\n </DemoWrapper>",
5795
6718
  "<DemoWrapper>\n <TableOfContents>\n <TableOfContents.List>\n {headings.slice(0, 3).map((heading) => (\n <TableOfContents.Item\n key={heading.text}\n active={heading.text === \"Introduction\"}\n className=\"cursor-pointer\"\n >\n {heading.text}\n </TableOfContents.Item>\n ))}\n </TableOfContents.List>\n </TableOfContents>\n </DemoWrapper>",
6719
+ "<div className=\"flex w-full max-w-xl gap-6\">\n <div className=\"min-w-40\">\n <TableOfContents>\n <TableOfContents.Title>On this page</TableOfContents.Title>\n <TableOfContents.List>\n {scrollspySections.map((section) => (\n <TableOfContents.Item\n key={section.id}\n render={<button type=\"button\" />}\n active={activeId === section.id}\n onClick={() => {\n selectSection(section.id);\n root\n ?.querySelector(`#${section.id}`)\n ?.scrollIntoView({ behavior: \"smooth\", block: \"start\" });\n }}\n >\n {section.title}\n </TableOfContents.Item>\n ))}\n </TableOfContents.List>\n </TableOfContents>\n </div>\n <div\n ref={setRoot}\n className=\"h-64 flex-1 overflow-y-auto rounded-lg border border-kumo-hairline p-4\"\n >\n {scrollspySections.map((section) => (\n <section key={section.id}>\n <h4\n id={section.id}\n className=\"mb-2 scroll-mt-2 text-sm font-semibold\"\n >\n {section.title}\n </h4>\n <p className=\"mb-6 text-sm text-kumo-subtle\">\n {Array.from(\n { length: 6 },\n () =>\n `Scrollable placeholder copy for the ${section.title} section. `,\n ).join(\"\")}\n </p>\n </section>\n ))}\n <div className=\"h-40\" />\n </div>\n </div>",
5796
6720
  "<DemoWrapper>\n <div className=\"space-y-3\">\n <TableOfContents>\n <TableOfContents.List>\n {[\"Introduction\", \"Installation\", \"Usage\"].map((text) => (\n <TableOfContents.Item\n key={text}\n render={<button type=\"button\" />}\n onClick={() => setClicked(text)}\n active={text === \"Introduction\"}\n >\n {text}\n </TableOfContents.Item>\n ))}\n </TableOfContents.List>\n </TableOfContents>\n {clicked && (\n <p className=\"text-xs text-kumo-subtle\">Clicked: {clicked}</p>\n )}\n </div>\n </DemoWrapper>"
5797
6721
  ],
5798
6722
  "colors": [
@@ -5819,7 +6743,13 @@
5819
6743
  "props": {
5820
6744
  "active": {
5821
6745
  "type": "boolean",
5822
- "optional": true
6746
+ "optional": true,
6747
+ "description": "Whether this item represents the currently active section."
6748
+ },
6749
+ "render": {
6750
+ "type": "React.ReactElement",
6751
+ "optional": true,
6752
+ "description": "Custom element to render as the link. Use this to integrate with framework routers (e.g., Next.js `<Link>`, React Router `<NavLink>`). The element receives all anchor props including `href`, `className`, and `children`."
5823
6753
  }
5824
6754
  }
5825
6755
  },
@@ -5829,15 +6759,18 @@
5829
6759
  "props": {
5830
6760
  "label": {
5831
6761
  "type": "string",
5832
- "required": true
6762
+ "required": true,
6763
+ "description": "Label displayed above the group's items."
5833
6764
  },
5834
6765
  "href": {
5835
6766
  "type": "string",
5836
- "optional": true
6767
+ "optional": true,
6768
+ "description": "URL the group label links to. When provided, the label renders as a clickable link with item styling."
5837
6769
  },
5838
6770
  "active": {
5839
6771
  "type": "boolean",
5840
- "optional": true
6772
+ "optional": true,
6773
+ "description": "Whether this group's label represents the currently active section. Only applies when `href` is provided."
5841
6774
  }
5842
6775
  }
5843
6776
  }
@@ -5885,6 +6818,11 @@
5885
6818
  "optional": true,
5886
6819
  "description": "Additional CSS classes for the indicator element."
5887
6820
  },
6821
+ "labels": {
6822
+ "type": "TabsLabels",
6823
+ "optional": true,
6824
+ "description": "Labels for internationalization of aria-labels. All labels have English defaults."
6825
+ },
5888
6826
  "variant": {
5889
6827
  "type": "enum",
5890
6828
  "optional": true,
@@ -5916,12 +6854,14 @@
5916
6854
  "<Tabs\n variant=\"underline\"\n tabs={[\n { value: \"tab1\", label: \"Tab 1\" },\n { value: \"tab2\", label: \"Tab 2\" },\n { value: \"tab3\", label: \"Tab 3\" },\n ]}\n selectedValue=\"tab1\"\n />",
5917
6855
  "<div className=\"space-y-4\">\n <Tabs\n tabs={[\n { value: \"tab1\", label: \"Tab 1\" },\n { value: \"tab2\", label: \"Tab 2\" },\n { value: \"tab3\", label: \"Tab 3\" },\n ]}\n value={activeTab}\n onValueChange={setActiveTab}\n />\n <p className=\"text-sm text-kumo-subtle\">\n Active tab: <code className=\"text-sm\">{activeTab}</code>\n </p>\n </div>",
5918
6856
  "<div className=\"w-full max-w-md\">\n <Tabs\n tabs={[\n { value: \"overview\", label: \"Overview\" },\n { value: \"analytics\", label: \"Analytics\" },\n { value: \"reports\", label: \"Reports\" },\n { value: \"notifications\", label: \"Notifications\" },\n { value: \"settings\", label: \"Settings\" },\n { value: \"billing\", label: \"Billing\" },\n { value: \"security\", label: \"Security\" },\n { value: \"integrations\", label: \"Integrations\" },\n ]}\n selectedValue=\"overview\"\n />\n </div>",
6857
+ "<div className=\"w-full max-w-xs\">\n <Tabs\n tabs={[\n { value: \"overview\", label: \"Overview\" },\n { value: \"analytics\", label: \"Analytics\" },\n { value: \"reports\", label: \"Reports\" },\n { value: \"notifications\", label: \"Notifications\" },\n { value: \"settings\", label: \"Settings\" },\n { value: \"billing\", label: \"Billing\" },\n { value: \"security\", label: \"Security\" },\n { value: \"integrations\", label: \"Integrations\" },\n ]}\n selectedValue=\"overview\"\n />\n </div>",
5919
6858
  "<div className=\"flex flex-col gap-6\">\n <div>\n <p className=\"mb-2 text-sm text-kumo-subtle\">Segmented sm</p>\n <Tabs\n variant=\"segmented\"\n size=\"sm\"\n tabs={[\n { value: \"tab1\", label: \"Tab 1\" },\n { value: \"tab2\", label: \"Tab 2\" },\n { value: \"tab3\", label: \"Tab 3\" },\n ]}\n selectedValue=\"tab1\"\n />\n </div>\n <div>\n <p className=\"mb-2 text-sm text-kumo-subtle\">Underline sm</p>\n <Tabs\n variant=\"underline\"\n size=\"sm\"\n tabs={[\n { value: \"tab1\", label: \"Tab 1\" },\n { value: \"tab2\", label: \"Tab 2\" },\n { value: \"tab3\", label: \"Tab 3\" },\n ]}\n selectedValue=\"tab1\"\n />\n </div>\n </div>",
5920
6859
  "<Tabs\n tabs={[\n {\n value: \"tab1\",\n label: \"Regular Tab\",\n },\n {\n value: \"tab2\",\n label: \"Link Tab\",\n render: (props) => <a {...props} href=\"#tab2\" />,\n },\n {\n value: \"tab3\",\n label: \"Cloudflare\",\n render: (props) => (\n <a {...props} href=\"https://cloudflare.com\" target=\"_blank\" />\n ),\n },\n ]}\n selectedValue=\"tab1\"\n />"
5921
6860
  ],
5922
6861
  "colors": [
5923
6862
  "bg-kumo-base",
5924
6863
  "bg-kumo-brand",
6864
+ "bg-kumo-elevated",
5925
6865
  "bg-kumo-recessed",
5926
6866
  "bg-kumo-tint",
5927
6867
  "border-kumo-hairline",
@@ -6110,6 +7050,167 @@
6110
7050
  }
6111
7051
  }
6112
7052
  },
7053
+ "TimeseriesChart": {
7054
+ "name": "TimeseriesChart",
7055
+ "type": "component",
7056
+ "description": "TimeseriesChart — a time-series line or bar chart.",
7057
+ "importPath": "@cloudflare/kumo",
7058
+ "category": "Data Visualization",
7059
+ "props": {
7060
+ "echarts": {
7061
+ "type": "typeof echarts",
7062
+ "required": true,
7063
+ "description": "The ECharts core instance imported by the consumer. Passed in rather than imported directly so the consumer controls which ECharts modules are bundled (tree-shaking)."
7064
+ },
7065
+ "type": {
7066
+ "type": "\"line\" | \"bar\"",
7067
+ "optional": true,
7068
+ "description": "Visual style of each series. Defaults to `\"line\"`."
7069
+ },
7070
+ "data": {
7071
+ "type": "TimeseriesData[]",
7072
+ "required": true,
7073
+ "description": "Array of time series data to display on the chart"
7074
+ },
7075
+ "markers": {
7076
+ "type": "TimeseriesMarker[]",
7077
+ "optional": true,
7078
+ "description": "Vertical reference markers rendered on the time axis."
7079
+ },
7080
+ "thresholds": {
7081
+ "type": "TimeseriesThreshold[]",
7082
+ "optional": true,
7083
+ "description": "Horizontal threshold lines rendered on the value axis."
7084
+ },
7085
+ "xAxisName": {
7086
+ "type": "string",
7087
+ "optional": true,
7088
+ "description": "Label for the x-axis (time axis)"
7089
+ },
7090
+ "xAxisTickCount": {
7091
+ "type": "number",
7092
+ "optional": true,
7093
+ "description": "Number of ticks to display on the x-axis"
7094
+ },
7095
+ "xAxisTickFormat": {
7096
+ "type": "(value: number) => string",
7097
+ "optional": true,
7098
+ "description": "Custom formatter for x-axis tick labels. Receives the raw timestamp in milliseconds and returns a display string, overriding ECharts' built-in time formatting."
7099
+ },
7100
+ "yAxisTickFormat": {
7101
+ "type": "(value: number) => string",
7102
+ "optional": true,
7103
+ "description": "Custom formatter for y-axis tick labels. Receives the raw value and returns a display string. When omitted, ECharts' built-in formatter is used."
7104
+ },
7105
+ "yAxisTickLabelFormat": {
7106
+ "type": "(value: number) => string",
7107
+ "optional": true
7108
+ },
7109
+ "yAxisName": {
7110
+ "type": "string",
7111
+ "optional": true,
7112
+ "description": "Label for the y-axis (value axis)"
7113
+ },
7114
+ "yAxisTickCount": {
7115
+ "type": "number",
7116
+ "optional": true,
7117
+ "description": "Number of ticks to display on the y-axis"
7118
+ },
7119
+ "tooltipValueFormat": {
7120
+ "type": "(value: number) => string",
7121
+ "optional": true,
7122
+ "description": "Custom formatter for tooltip values. Receives the raw y-value and returns a display string. When omitted, the raw value is shown. Takes precedence over the deprecated `yAxisTickLabelFormat` prop."
7123
+ },
7124
+ "tooltipMode": {
7125
+ "type": "\"all\" | \"single\"",
7126
+ "optional": true,
7127
+ "description": "Controls which series are shown in the tooltip. - `\"all\"` — show all series at the hovered timestamp (default) - `\"single\"` — show only the series whose value is closest to the cursor"
7128
+ },
7129
+ "tooltipMaxItems": {
7130
+ "type": "number",
7131
+ "optional": true,
7132
+ "description": "Maximum number of series rows shown in the tooltip when `tooltipMode` is `\"all\"`. Additional series are hidden with a `+N more` footer. Defaults to `10`."
7133
+ },
7134
+ "tooltipBoundary": {
7135
+ "type": "\"clipping-ancestors\" | Element | Element[]",
7136
+ "optional": true,
7137
+ "description": "Constrains the tooltip to stay within a specific element or region. By default the tooltip avoids overflowing any clipping ancestor (scroll containers, viewports, etc.). Pass an `Element` or array of elements to restrict the tooltip to a specific container."
7138
+ },
7139
+ "tooltipFollowCursor": {
7140
+ "type": "\"both\" | \"x\"",
7141
+ "optional": true,
7142
+ "description": "Which axis the tooltip follows the cursor on. - `\"both\"` — tooltip tracks the cursor on both axes, staying near the pointer at all times. This is the default and matches the behaviour of ECharts' built-in tooltip. - `\"x\"` — tooltip follows the cursor horizontally but is locked to a fixed vertical position relative to the chart. This keeps the tooltip out of the way of the data and avoids vertical jitter as series values change — the same approach used by Recharts and many dashboard UIs. Only these two modes are offered because the x-axis is always time in a `TimeseriesChart`: y-only tracking and fully-fixed positioning don't produce useful tooltip behaviour for time-series data. Powered by Base UI Tooltip's `trackCursorAxis` under the hood."
7143
+ },
7144
+ "incomplete": {
7145
+ "type": "{ before?: number; after?: number }",
7146
+ "optional": true,
7147
+ "description": "Indicates incomplete data periods with optional before/after timestamps in ms"
7148
+ },
7149
+ "enableLegendSelection": {
7150
+ "type": "boolean",
7151
+ "optional": true,
7152
+ "description": "When `true`, adds a hidden ECharts legend so consumers can drive series visibility imperatively via the `legendSelect` / `legendUnSelect` / `legendToggleSelect` actions (e.g. to build a custom interactive legend). Toggled-off series are also excluded from the tooltip. Requires the consumer to register ECharts' `LegendComponent` (`echarts.use([LegendComponent])`); otherwise the legend actions no-op and, in development, ECharts logs a \"component legend is used but not imported\" warning."
7153
+ },
7154
+ "height": {
7155
+ "type": "number",
7156
+ "optional": true,
7157
+ "description": "Height of the chart in pixels. Defaults to `350`."
7158
+ },
7159
+ "isDarkMode": {
7160
+ "type": "boolean",
7161
+ "optional": true,
7162
+ "description": "When `true`, switches the chart to ECharts' built-in dark theme"
7163
+ },
7164
+ "gradient": {
7165
+ "type": "boolean",
7166
+ "optional": true,
7167
+ "description": "When `true`, renders a vertical gradient fill beneath each line series. The gradient fades from the series' color at the top to transparent at the bottom. Has no effect when `type` is `\"bar\"`."
7168
+ },
7169
+ "loading": {
7170
+ "type": "boolean",
7171
+ "optional": true,
7172
+ "description": "When `true`, hides the chart and displays a skeleton matching the chart type with a subtle shimmer."
7173
+ },
7174
+ "ariaDescription": {
7175
+ "type": "string",
7176
+ "optional": true,
7177
+ "description": "Accessible description for screen readers. When provided, it is passed to ECharts' `aria.label.description` and announced when the chart receives focus. Consumers are responsible for writing a meaningful description — see the W3C guidance on complex images for recommendations."
7178
+ },
7179
+ "optionUpdateBehavior": {
7180
+ "type": "SetOptionOpts",
7181
+ "optional": true,
7182
+ "description": "Additional options passed as the second argument to `chart.setOption()`. Defaults to `{ notMerge: false, lazyUpdate: true }`."
7183
+ }
7184
+ },
7185
+ "examples": [
7186
+ "<Chart\n echarts={echarts}\n options={options}\n height={400}\n isDarkMode={isDarkMode}\n />",
7187
+ "<TimeseriesChart\n echarts={echarts}\n isDarkMode={isDarkMode}\n data={data}\n xAxisName=\"Time (UTC)\"\n yAxisName=\"Count\"\n />",
7188
+ "<TimeseriesChart\n echarts={echarts}\n isDarkMode={isDarkMode}\n data={data}\n markers={markers}\n xAxisName=\"Time (UTC)\"\n yAxisName=\"Count\"\n />",
7189
+ "<TimeseriesChart\n echarts={echarts}\n isDarkMode={isDarkMode}\n data={data}\n thresholds={[\n {\n value: 55,\n label: \"Memory limit\",\n color: ChartPalette.semantic(\"Attention\", isDarkMode),\n },\n ]}\n xAxisName=\"Time (UTC)\"\n yAxisName=\"Memory (MB)\"\n />",
7190
+ "<TimeseriesChart\n echarts={echarts}\n isDarkMode={isDarkMode}\n data={data}\n xAxisName=\"Time (UTC)\"\n yAxisName=\"Requests\"\n xAxisTickFormat={(ts) => {\n const d = new Date(ts);\n return `${d.getHours().toString().padStart(2, \"0\")}:${d.getMinutes().toString().padStart(2, \"0\")}`;\n }}\n yAxisTickFormat={(value) => {\n if (value >= 1000) return `${value / 1000}k`;\n return value.toString();\n }}\n tooltipValueFormat={(value) => `${(value / 1000).toFixed(1)}k requests`}\n />",
7191
+ "<TimeseriesChart\n yAxisTickCount={2}\n echarts={echarts}\n isDarkMode={isDarkMode}\n data={data}\n height={160}\n />",
7192
+ "<TimeseriesChart\n echarts={echarts}\n isDarkMode={isDarkMode}\n data={data}\n xAxisName=\"Time (UTC)\"\n yAxisName=\"Count\"\n gradient\n />",
7193
+ "<TimeseriesChart\n echarts={echarts}\n isDarkMode={isDarkMode}\n data={data}\n xAxisName=\"Time (UTC)\"\n yAxisName=\"Mbps\"\n incomplete={{ after: incompleteTimestamp }}\n />",
7194
+ "<TimeseriesChart\n echarts={echarts}\n isDarkMode={isDarkMode}\n data={data}\n xAxisName=\"Time (UTC)\"\n yAxisName=\"%\"\n onTimeRangeChange={(from, to) => {\n alert(\n `Selected range:\\nFrom: ${new Date(from).toLocaleString()}\\nTo: ${new Date(to).toLocaleString()}`,\n );\n }}\n />",
7195
+ "<Chart\n echarts={echarts}\n options={options}\n height={160}\n isDarkMode={isDarkMode}\n />",
7196
+ "<div className=\"space-y-4\">\n <h3 className=\"text-sm font-medium\">Active State</h3>\n\n <div className=\"flex flex-wrap gap-4 divide-x divide-kumo-hairline\">\n <ChartLegend.LargeItem\n name=\"Requests\"\n color={ChartPalette.semantic(\"Neutral\", isDarkMode)}\n value=\"1,234\"\n unit=\"req/s\"\n />\n <ChartLegend.LargeItem\n name=\"Storage\"\n color={ChartPalette.semantic(\"Attention\", isDarkMode)}\n value=\"56\"\n unit=\"GB\"\n />\n <ChartLegend.LargeItem\n name=\"Warnings\"\n color={ChartPalette.semantic(\"Warning\", isDarkMode)}\n value=\"128\"\n />\n </div>\n\n <h3 className=\"mt-12 text-sm font-medium\">Inactive State</h3>\n\n <div className=\"flex flex-wrap gap-4 divide-x divide-kumo-hairline\">\n <ChartLegend.LargeItem\n name=\"Requests\"\n color={ChartPalette.semantic(\"Neutral\", isDarkMode)}\n value=\"1,234\"\n unit=\"req/s\"\n inactive\n />\n <ChartLegend.LargeItem\n name=\"Storage\"\n color={ChartPalette.semantic(\"Attention\", isDarkMode)}\n value=\"56\"\n unit=\"GB\"\n inactive\n />\n <ChartLegend.LargeItem\n name=\"Warnings\"\n color={ChartPalette.semantic(\"Warning\", isDarkMode)}\n value=\"128\"\n inactive\n />\n </div>\n\n <h3 className=\"mt-12 text-sm font-medium\">Loading state</h3>\n\n <div className=\"flex flex-wrap gap-4 divide-x divide-kumo-hairline\">\n <ChartLegend.LargeItem loading />\n </div>\n </div>",
7197
+ "<div className=\"space-y-4\">\n <h3 className=\"text-sm font-medium\">Active State</h3>\n <div className=\"flex flex-wrap gap-4\">\n <ChartLegend.SmallItem\n name=\"Requests\"\n color={ChartPalette.semantic(\"Neutral\", isDarkMode)}\n value=\"1,234\"\n unit=\"req/s\"\n />\n <ChartLegend.SmallItem\n name=\"Storage\"\n color={ChartPalette.semantic(\"Attention\", isDarkMode)}\n value=\"56\"\n unit=\"GB\"\n />\n <ChartLegend.SmallItem\n name=\"Warnings\"\n color={ChartPalette.semantic(\"Warning\", isDarkMode)}\n value=\"128\"\n />\n </div>\n\n <h3 className=\"mt-12 text-sm font-medium\">Inactive State</h3>\n <div className=\"flex flex-wrap gap-4\">\n <ChartLegend.SmallItem\n name=\"Requests\"\n color={ChartPalette.semantic(\"Neutral\", isDarkMode)}\n value=\"1,234\"\n unit=\"req/s\"\n inactive\n />\n <ChartLegend.SmallItem\n name=\"Storage\"\n color={ChartPalette.semantic(\"Attention\", isDarkMode)}\n value=\"56\"\n unit=\"GB\"\n inactive\n />\n <ChartLegend.SmallItem\n name=\"Warnings\"\n color={ChartPalette.semantic(\"Warning\", isDarkMode)}\n value=\"128\"\n inactive\n />\n </div>\n\n <h3 className=\"mt-12 text-sm font-medium\">Loading state</h3>\n\n <div className=\"flex flex-wrap gap-4\">\n <ChartLegend.SmallItem loading />\n </div>\n </div>",
7198
+ "<TimeseriesChart\n echarts={echarts}\n isDarkMode={isDarkMode}\n type=\"bar\"\n data={data}\n xAxisName=\"Time (UTC)\"\n yAxisName=\"Count\"\n tooltipValueFormat={(r) => r.toFixed(2)}\n />",
7199
+ "<div className=\"flex w-full flex-1 flex-col\">\n <TimeseriesChart\n echarts={echarts}\n isDarkMode={isDarkMode}\n xAxisName=\"Time (UTC)\"\n yAxisName=\"Count\"\n data={[]}\n loading\n />\n </div>",
7200
+ "<div className=\"flex w-full flex-1 flex-col\">\n <TimeseriesChart\n echarts={echarts}\n isDarkMode={isDarkMode}\n type=\"bar\"\n xAxisName=\"Time (UTC)\"\n yAxisName=\"Count\"\n data={[]}\n loading\n />\n </div>",
7201
+ "<div className=\"flex w-full flex-1 flex-col gap-3\">\n <div className=\"flex items-center justify-between\">\n <div className=\"flex flex-wrap gap-4\">\n {data.map((series) => (\n <ChartLegend.SmallItem\n loading={loading}\n key={series.name}\n name={series.name}\n color={series.color}\n value={Math.round(series.data.at(-1)?.[1] ?? 0).toLocaleString()}\n />\n ))}\n </div>\n <Switch\n label=\"Loading\"\n checked={loading}\n onCheckedChange={setLoading}\n />\n </div>\n <TimeseriesChart\n echarts={echarts}\n isDarkMode={isDarkMode}\n xAxisName=\"Time (UTC)\"\n yAxisName=\"Count\"\n data={loading ? [] : data}\n loading={loading}\n />\n </div>",
7202
+ "<LayerCard>\n <LayerCard.Secondary>Read latency</LayerCard.Secondary>\n <LayerCard.Primary>\n <div className=\"mb-2 flex gap-4 divide-x divide-kumo-hairline px-2\">\n <ChartLegend.LargeItem\n name=\"P99\"\n color={ChartPalette.semantic(\"Attention\", isDarkMode)}\n value=\"124\"\n unit=\"ms\"\n />\n <ChartLegend.LargeItem\n name=\"P95\"\n color={ChartPalette.semantic(\"Warning\", isDarkMode)}\n value=\"76\"\n unit=\"ms\"\n />\n <ChartLegend.LargeItem\n name=\"P75\"\n color={ChartPalette.semantic(\"Neutral\", isDarkMode)}\n value=\"32\"\n unit=\"ms\"\n />\n <ChartLegend.LargeItem\n name=\"P50\"\n color={ChartPalette.semantic(\"Neutral\", isDarkMode)}\n value=\"10\"\n unit=\"ms\"\n />\n </div>\n <TimeseriesChart\n xAxisName=\"Time (UTC)\"\n echarts={echarts}\n isDarkMode={isDarkMode}\n data={data}\n height={300}\n />\n </LayerCard.Primary>\n </LayerCard>",
7203
+ "<LayerCard>\n <LayerCard.Secondary>Read latency</LayerCard.Secondary>\n <LayerCard.Primary>\n <div className=\"mb-2 flex divide-x divide-kumo-line px-2\">\n {series.map((s) => (\n <ChartLegend.LargeItem\n key={s.name}\n name={s.name}\n color={s.color}\n value={s.value}\n unit={s.unit}\n inactive={hoveredSeries !== null && hoveredSeries !== s.name}\n onPointerEnter={() => {\n setHoveredSeries(s.name);\n chartRef.current?.dispatchAction({\n type: \"highlight\",\n seriesName: s.name,\n });\n }}\n onPointerLeave={() => {\n setHoveredSeries(null);\n chartRef.current?.dispatchAction({\n type: \"downplay\",\n seriesName: s.name,\n });\n }}\n className=\"not-first:pl-4\"\n />\n ))}\n </div>\n <TimeseriesChart\n ref={chartRef}\n xAxisName=\"Time (UTC)\"\n echarts={echarts}\n isDarkMode={isDarkMode}\n data={data}\n height={300}\n />\n </LayerCard.Primary>\n </LayerCard>",
7204
+ "<LayerCard>\n <LayerCard.Secondary>Read latency</LayerCard.Secondary>\n <LayerCard.Primary>\n <div className=\"mb-2 flex divide-x divide-kumo-line px-2\">\n {series.map((s) => (\n <ChartLegend.LargeItem\n key={s.name}\n name={s.name}\n color={s.color}\n value={s.value}\n unit={s.unit}\n inactive={hiddenSeries[s.name] ?? false}\n onClick={() => handleClick(s.name)}\n className=\"not-first:pl-4\"\n />\n ))}\n </div>\n <TimeseriesChart\n ref={chartRef}\n xAxisName=\"Time (UTC)\"\n echarts={echarts}\n isDarkMode={isDarkMode}\n data={data}\n height={300}\n enableLegendSelection\n />\n </LayerCard.Primary>\n </LayerCard>",
7205
+ "<Chart\n echarts={echarts}\n options={options}\n height={400}\n isDarkMode={isDarkMode}\n />",
7206
+ "<div className=\"flex w-full flex-col gap-4\">\n <Select\n label=\"Tooltip follow cursor\"\n value={selected}\n onValueChange={(v) => {\n if (v) setSelected(v);\n }}\n renderValue={(v) => v.label}\n >\n {FOLLOW_CURSOR_OPTIONS.map((opt) => (\n <Select.Option key={opt.value} value={opt}>\n {opt.label}\n </Select.Option>\n ))}\n </Select>\n <TimeseriesChart\n echarts={echarts}\n isDarkMode={isDarkMode}\n data={data}\n xAxisName=\"Time (UTC)\"\n yAxisName=\"Latency (ms)\"\n tooltipFollowCursor={selected.value}\n />\n </div>",
7207
+ "<div\n ref={boundaryRef}\n className=\"w-full overflow-auto rounded-lg border border-kumo-line\"\n style={{ height: 300 }}\n >\n <TimeseriesChart\n echarts={echarts}\n isDarkMode={isDarkMode}\n data={data}\n xAxisName=\"Time (UTC)\"\n yAxisName=\"Count\"\n height={280}\n tooltipBoundary={boundary ?? undefined}\n />\n </div>"
7208
+ ],
7209
+ "colors": [
7210
+ "bg-kumo-base",
7211
+ "outline-kumo-fill"
7212
+ ]
7213
+ },
6113
7214
  "Toasty": {
6114
7215
  "name": "Toasty",
6115
7216
  "type": "component",
@@ -6142,13 +7243,20 @@
6142
7243
  "info": "ring-[0.3px] ring-kumo-info bg-kumo-control [&_[data-toast-icon]]:text-kumo-info [&_[data-toast-title]]:text-kumo-info"
6143
7244
  }
6144
7245
  },
6145
- "className": {
6146
- "type": "string",
6147
- "description": "Additional CSS classes"
6148
- },
6149
7246
  "children": {
6150
- "type": "ReactNode",
6151
- "description": "Child elements"
7247
+ "type": "React.ReactNode",
7248
+ "required": true,
7249
+ "description": "Application content. Toasts render via a portal above this."
7250
+ },
7251
+ "container": {
7252
+ "type": "PortalContainer",
7253
+ "optional": true,
7254
+ "description": "Container element for the portal. Use this to render toasts inside a Shadow DOM or custom container. Overrides `KumoPortalProvider` context."
7255
+ },
7256
+ "toastManager": {
7257
+ "type": "ReturnType<typeof createKumoToastManager>",
7258
+ "optional": true,
7259
+ "description": "Optional toast manager created by `createKumoToastManager()`. When provided, allows code outside the React tree (timers, module-load callbacks, query-cache listeners) to dispatch toasts via the same dedupe-aware manager that `useKumoToastManager()` returns inside the tree. Forwarded to the underlying `@base-ui/react/toast` `Toast.Provider` `toastManager` prop — see https://base-ui.com/react/components/toast for the upstream primitive."
6152
7260
  }
6153
7261
  },
6154
7262
  "examples": [
@@ -6291,11 +7399,11 @@
6291
7399
  },
6292
7400
  "examples": [
6293
7401
  "<Toolbar className=\"w-full max-w-md\">\n <Toolbar.InputGroup aria-label=\"Search DNS records\" className=\"flex-1\">\n <InputGroup.Addon>\n <MagnifyingGlassIcon />\n </InputGroup.Addon>\n <InputGroup.Input placeholder=\"Search DNS records\" />\n </Toolbar.InputGroup>\n <Toolbar.Button icon={FunnelSimpleIcon} aria-label=\"Filter\" />\n <Toolbar.Button icon={GearSixIcon} aria-label=\"Settings\" />\n </Toolbar>",
6294
- "<div className=\"grid gap-3\">\n {([\"xs\", \"sm\", \"base\", \"lg\"] as const).map((size) => (\n <div key={size} className=\"flex items-center gap-3\">\n <span className=\"w-10 text-sm text-kumo-subtle\">{size}</span>\n <Toolbar size={size} className=\"w-fit\">\n <Toolbar.Input aria-label={`${size} search`} placeholder=\"Search...\" />\n <Toolbar.Button>Apply</Toolbar.Button>\n </Toolbar>\n </div>\n ))}\n </div>",
7402
+ "<div className=\"grid gap-3\">\n {([\"xs\", \"sm\", \"base\", \"lg\"] as const).map((size) => (\n <div key={size} className=\"flex items-center gap-3\">\n <span className=\"w-10 text-sm text-kumo-subtle\">{size}</span>\n <Toolbar size={size} className=\"w-fit\">\n <Toolbar.Input\n aria-label={`${size} search`}\n placeholder=\"Search...\"\n />\n <Toolbar.Button>Apply</Toolbar.Button>\n </Toolbar>\n </div>\n ))}\n </div>",
6295
7403
  "<Toolbar className=\"w-full max-w-md\">\n <Toolbar.Input\n aria-label=\"Search DNS records\"\n placeholder=\"Search DNS records\"\n className=\"flex-1\"\n />\n <Toolbar.Button icon={FunnelSimpleIcon} aria-label=\"Filter\" />\n <Toolbar.Button icon={GearSixIcon} aria-label=\"Settings\" />\n </Toolbar>",
6296
7404
  "<Toolbar className=\"w-full max-w-lg\">\n <Toolbar.InputGroup aria-label=\"Worker subdomain\" className=\"flex-1\">\n <InputGroup.Input placeholder=\"my-worker\" />\n <InputGroup.Suffix>.workers.dev</InputGroup.Suffix>\n </Toolbar.InputGroup>\n <Toolbar.Button>Visit</Toolbar.Button>\n </Toolbar>",
6297
7405
  "<Toolbar>\n <Toolbar.Button icon={UploadSimpleIcon}>Upload</Toolbar.Button>\n <Toolbar.Button icon={DownloadSimpleIcon}>Download</Toolbar.Button>\n </Toolbar>",
6298
- "<Toolbar className=\"w-full max-w-lg\">\n <Toolbar.Input aria-label=\"Search records\" className=\"flex-1\" placeholder=\"Search\" />\n <Toolbar.Button icon={MagnifyingGlassIcon} aria-label=\"Search\" />\n </Toolbar>"
7406
+ "<Toolbar className=\"w-full max-w-lg\">\n <Toolbar.Input\n aria-label=\"Search records\"\n className=\"flex-1\"\n placeholder=\"Search\"\n />\n <Toolbar.Button icon={MagnifyingGlassIcon} aria-label=\"Search\" />\n </Toolbar>"
6299
7407
  ],
6300
7408
  "colors": [
6301
7409
  "bg-kumo-control",
@@ -6682,6 +7790,13 @@
6682
7790
  "Loader",
6683
7791
  "Toasty"
6684
7792
  ],
7793
+ "Data Visualization": [
7794
+ "BubbleMap",
7795
+ "Chart",
7796
+ "ChoroplethMap",
7797
+ "SankeyChart",
7798
+ "TimeseriesChart"
7799
+ ],
6685
7800
  "Action": [
6686
7801
  "Button",
6687
7802
  "ClipboardText"
@@ -6721,8 +7836,11 @@
6721
7836
  "Badge",
6722
7837
  "Banner",
6723
7838
  "Breadcrumbs",
7839
+ "BubbleMap",
6724
7840
  "Button",
7841
+ "Chart",
6725
7842
  "Checkbox",
7843
+ "ChoroplethMap",
6726
7844
  "ClipboardText",
6727
7845
  "CloudflareLogo",
6728
7846
  "Code",
@@ -6750,6 +7868,7 @@
6750
7868
  "Popover",
6751
7869
  "Radio",
6752
7870
  "ResourceListPage",
7871
+ "SankeyChart",
6753
7872
  "Select",
6754
7873
  "SensitiveInput",
6755
7874
  "Sidebar",
@@ -6759,6 +7878,7 @@
6759
7878
  "TableOfContents",
6760
7879
  "Tabs",
6761
7880
  "Text",
7881
+ "TimeseriesChart",
6762
7882
  "Toasty",
6763
7883
  "Toolbar",
6764
7884
  "Tooltip"
@@ -6769,8 +7889,11 @@
6769
7889
  "Badge",
6770
7890
  "Banner",
6771
7891
  "Breadcrumbs",
7892
+ "BubbleMap",
6772
7893
  "Button",
7894
+ "Chart",
6773
7895
  "Checkbox",
7896
+ "ChoroplethMap",
6774
7897
  "ClipboardText",
6775
7898
  "CloudflareLogo",
6776
7899
  "Code",
@@ -6795,6 +7918,7 @@
6795
7918
  "Pagination",
6796
7919
  "Popover",
6797
7920
  "Radio",
7921
+ "SankeyChart",
6798
7922
  "Select",
6799
7923
  "SensitiveInput",
6800
7924
  "Sidebar",
@@ -6804,6 +7928,7 @@
6804
7928
  "TableOfContents",
6805
7929
  "Tabs",
6806
7930
  "Text",
7931
+ "TimeseriesChart",
6807
7932
  "Toasty",
6808
7933
  "Toolbar",
6809
7934
  "Tooltip"