@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
@@ -232,7 +232,7 @@ Collection sub-component (wraps AutocompleteBase)
232
232
  ```
233
233
 
234
234
  ```tsx
235
- <div className="flex flex-col gap-3 w-80">
235
+ <div className="flex w-80 flex-col gap-3">
236
236
  <Autocomplete
237
237
  items={fruits}
238
238
  value={value}
@@ -251,7 +251,7 @@ Collection sub-component (wraps AutocompleteBase)
251
251
  </Autocomplete>
252
252
  {value && (
253
253
  <p className="text-sm text-kumo-subtle">
254
- Value: <span className="text-kumo-default font-medium">{value}</span>
254
+ Value: <span className="font-medium text-kumo-default">{value}</span>
255
255
  </p>
256
256
  )}
257
257
  </div>
@@ -338,10 +338,18 @@ Small status label for categorizing or highlighting content.
338
338
 
339
339
  ```tsx
340
340
  <div className="flex flex-wrap items-center gap-2">
341
- <Badge variant="success" appearance="dot">Healthy</Badge>
342
- <Badge variant="warning" appearance="dot">Warning</Badge>
343
- <Badge variant="error" appearance="dot">Error</Badge>
344
- <Badge variant="neutral" appearance="dot">Neutral</Badge>
341
+ <Badge variant="success" appearance="dot">
342
+ Healthy
343
+ </Badge>
344
+ <Badge variant="warning" appearance="dot">
345
+ Warning
346
+ </Badge>
347
+ <Badge variant="error" appearance="dot">
348
+ Error
349
+ </Badge>
350
+ <Badge variant="neutral" appearance="dot">
351
+ Neutral
352
+ </Badge>
345
353
  </div>
346
354
  ```
347
355
 
@@ -350,7 +358,7 @@ Small status label for categorizing or highlighting content.
350
358
 
351
359
  ### Banner
352
360
 
353
- Full-width message bar for informational, warning, or error notices. Supports structured title/description for i18n, or simple children for basic usage.
361
+ Full-width message bar with an optional trailing CTA slot.
354
362
 
355
363
  **Type:** component
356
364
 
@@ -371,7 +379,7 @@ Full-width message bar for informational, warning, or error notices. Supports st
371
379
  - `description`: ReactNode
372
380
  Secondary description text displayed below the title. Use for i18n string injection.
373
381
  - `action`: ReactNode
374
- 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`).
382
+ 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`).
375
383
  - `text`: string
376
384
  - `children`: ReactNode
377
385
  - `variant`: enum [default: default]
@@ -379,10 +387,22 @@ Full-width message bar for informational, warning, or error notices. Supports st
379
387
  - `"alert"`: Warning banner for cautionary messages
380
388
  - `"error"`: Error banner for critical issues
381
389
  - `"secondary"`: Neutral banner for secondary messages
390
+ - `size`: enum [default: base]
391
+ - `"base"`: Default banner size
392
+ - `"sm"`: Compact banner for dialogs and tight spaces
382
393
 
383
394
  **Colors (kumo tokens used):**
384
395
 
385
- `bg-kumo-banner-info`, `bg-kumo-banner-warning`, `bg-kumo-contrast`, `bg-kumo-danger-tint`, `text-kumo-danger`, `text-kumo-info`, `text-kumo-subtle`, `text-kumo-warning`
396
+ `bg-kumo-contrast`, `bg-kumo-danger-tint`, `bg-kumo-info-tint`, `bg-kumo-warning-tint`, `fill-kumo-danger`, `fill-kumo-info`, `fill-kumo-interact`, `fill-kumo-warning`, `text-kumo-danger`, `text-kumo-default`, `text-kumo-info`, `text-kumo-warning`
397
+
398
+ **Sub-Components:**
399
+
400
+ This is a compound component. Use these sub-components:
401
+
402
+ #### Banner.Action
403
+
404
+ Action sub-component
405
+
386
406
 
387
407
  **Examples:**
388
408
 
@@ -456,20 +476,64 @@ Full-width message bar for informational, warning, or error notices. Supports st
456
476
  icon={<Info weight="fill" />}
457
477
  title="Update available"
458
478
  description="A new version is ready to install."
459
- action={<Button size="sm">Update now</Button>}
479
+ action={
480
+ <>
481
+ <Banner.Action>Update</Banner.Action>
482
+ <Banner.Action variant="ghost" icon={<X />} aria-label="Dismiss" />
483
+ </>
484
+ }
460
485
  />
461
486
  <Banner
462
- icon={<Info weight="fill" />}
463
- title="Update available"
464
- description="A new version is ready to install."
487
+ variant="error"
488
+ icon={<WarningCircle weight="fill" />}
489
+ title="Save failed"
490
+ description="We couldn't save your changes. Please try again."
465
491
  action={
466
- <Button
467
- size="sm"
468
- variant="ghost"
469
- shape="square"
470
- icon={X}
471
- aria-label="Dismiss"
472
- />
492
+ <>
493
+ <Banner.Action>Retry</Banner.Action>
494
+ <Banner.Action variant="ghost" icon={<X />} aria-label="Dismiss" />
495
+ </>
496
+ }
497
+ />
498
+ <Banner
499
+ variant="alert"
500
+ icon={<WarningCircle weight="fill" />}
501
+ title="Save failed"
502
+ description="We couldn't save your changes. Please try again."
503
+ action={
504
+ <>
505
+ <Banner.Action>Retry</Banner.Action>
506
+ <Banner.Action variant="ghost" icon={<X />} aria-label="Dismiss" />
507
+ </>
508
+ }
509
+ />
510
+ <Banner
511
+ variant="secondary"
512
+ icon={<WarningCircle weight="fill" />}
513
+ title="Save failed"
514
+ description="We couldn't save your changes. Please try again."
515
+ action={
516
+ <>
517
+ <Banner.Action>Retry</Banner.Action>
518
+ <Banner.Action variant="ghost" icon={<X />} aria-label="Dismiss" />
519
+ </>
520
+ }
521
+ />
522
+ </div>
523
+ ```
524
+
525
+ ```tsx
526
+ <div className="w-full space-y-3">
527
+ <Banner
528
+ icon={<Warning weight="fill" />}
529
+ variant="error"
530
+ title="Your account is 90 days past due."
531
+ description="Pay now to avoid interruption."
532
+ action={
533
+ <>
534
+ <Banner.Action>Pay now</Banner.Action>
535
+ <Banner.Action variant="secondary">Go to billing</Banner.Action>
536
+ </>
473
537
  }
474
538
  />
475
539
  </div>
@@ -477,21 +541,34 @@ Full-width message bar for informational, warning, or error notices. Supports st
477
541
 
478
542
  ```tsx
479
543
  <Banner
480
- icon={<Warning weight="fill" />}
481
- variant="alert"
482
- title="Session expiring"
483
- description="Your session will expire in 5 minutes."
544
+ size="sm"
545
+ description="A DNS record for puppies.cloudflare.dev already exists in this zone."
546
+ action={<Link href="#">Manage DNS for puppies.cloudflare.dev</Link>}
547
+ />
548
+ ```
549
+
550
+ ```tsx
551
+ <Banner
552
+ size="sm"
553
+ description="A DNS record for puppies.cloudflare.dev already exists in this zone."
484
554
  action={
485
555
  <>
486
- <Button size="sm" variant="secondary">
487
- Dismiss
488
- </Button>
489
- <Button size="sm">Extend session</Button>
556
+ <Banner.Action>Manage DNS</Banner.Action>
557
+ <Banner.Action variant="ghost">
558
+ <X />
559
+ </Banner.Action>
490
560
  </>
491
561
  }
492
562
  />
493
563
  ```
494
564
 
565
+ ```tsx
566
+ <Banner
567
+ size="sm"
568
+ description="A DNS record for puppies.cloudflare.dev already exists in this zone."
569
+ />
570
+ ```
571
+
495
572
  ```tsx
496
573
  <Banner icon={<Info />}>This is a simple banner using children.</Banner>
497
574
  ```
@@ -596,6 +673,120 @@ Props:
596
673
  ```
597
674
 
598
675
 
676
+ ---
677
+
678
+ ### BubbleMap
679
+
680
+ BubbleMap component
681
+
682
+ **Type:** component
683
+
684
+ **Import:** `import { BubbleMap } from "@cloudflare/kumo";`
685
+
686
+ **Category:** Data Visualization
687
+
688
+ **Props:**
689
+
690
+ - `echarts`: typeof echarts (required)
691
+ The ECharts core instance imported by the consumer (passed in for tree-shaking). Requires `MapChart`, `ScatterChart`, `TooltipComponent`, and a renderer registered via `echarts.use([...])`.
692
+ - `geoJson`: MapGeoJson (required)
693
+ GeoJSON `FeatureCollection` for the land base.
694
+ - `mapName`: string
695
+ 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.
696
+ - `data`: T[] (required)
697
+ Raw data rows. Coordinates/value/name are read via the accessors below.
698
+ - `lng`: MapAccessor<T, number> (required)
699
+ Longitude accessor (key of `T` or `(row) => number`).
700
+ - `lat`: MapAccessor<T, number> (required)
701
+ Latitude accessor (key of `T` or `(row) => number`).
702
+ - `value`: MapAccessor<T, number> (required)
703
+ Value accessor — drives bubble size.
704
+ - `name`: MapAccessor<T, string>
705
+ Optional name accessor — used by the default tooltip.
706
+ - `minRadius`: number
707
+ Smallest bubble radius in px. Default: `6`.
708
+ - `maxRadius`: number
709
+ Largest bubble radius in px. Default: `26`.
710
+ - `bubbleSize`: (value: number) => number
711
+ Explicit bubble radius `(value) => px`. Overrides the default `minRadius`/`maxRadius` scaling.
712
+ - `bubbleColor`: MapStyle<T, string>
713
+ Bubble fill colour — constant or `(row) => color`. Defaults to the chart blue.
714
+ - `bubbleBorderColor`: MapStyle<T, string>
715
+ Bubble border colour — constant or `(row) => color`. Default: `transparent`.
716
+ - `bubbleBorderWidth`: MapStyle<T, number>
717
+ Bubble border width — constant or `(row) => px`. Default: `0`.
718
+ - `center`: [number, number]
719
+ Map center as `[longitude, latitude]`. Defaults to auto-fit.
720
+ - `zoom`: number
721
+ Zoom level — multiplies the auto-fit scale. Default: `1.25`.
722
+ - `roam`: boolean
723
+ Enable drag-to-pan and scroll-to-zoom. Default: `false`.
724
+ - `projection`: MapProjection | null
725
+ 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.
726
+ - `showTooltip`: boolean
727
+ Show the tooltip. Default: `true`.
728
+ - `valueFormat`: (value: number) => string
729
+ Format the value for the default tooltip. Default: `toLocaleString()`.
730
+ - `tooltipFormatter`: (row: T) => string
731
+ 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.
732
+ - `aspectRatio`: number | string
733
+ 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.
734
+ - `height`: number
735
+ Fixed chart height in pixels. Overrides `aspectRatio` when set. Leave unset to size by aspect ratio (the default) so the map fills the container.
736
+ - `className`: string
737
+ - `isDarkMode`: boolean
738
+
739
+ **Examples:**
740
+
741
+ ```tsx
742
+ <BubbleMap<CfLocation>
743
+ echarts={echarts}
744
+ geoJson={geoJson}
745
+ data={cloudflareLocations}
746
+ lng="lon"
747
+ lat="lat"
748
+ name="city"
749
+ value={() => 1}
750
+ bubbleColor="#F6821F"
751
+ minRadius={8}
752
+ maxRadius={8}
753
+ tooltipFormatter={(row) =>
754
+ `<span style="font-size:12px"><strong>${row.city}</strong><span style="color:var(--text-color-kumo-subtle);margin-left:8px">${row.iata}</span></span>`
755
+ }
756
+ isDarkMode={isDarkMode}
757
+ />
758
+ ```
759
+
760
+ ```tsx
761
+ <BubbleMap<Colo>
762
+ echarts={echarts}
763
+ geoJson={geoJson}
764
+ data={colos}
765
+ lng="lon"
766
+ lat="lat"
767
+ name="city"
768
+ value="requests"
769
+ valueFormat={fmt}
770
+ minRadius={8}
771
+ isDarkMode={isDarkMode}
772
+ />
773
+ ```
774
+
775
+ ```tsx
776
+ <BubbleMap<Colo>
777
+ echarts={echarts}
778
+ geoJson={geoJson}
779
+ data={colos2}
780
+ lng="lon"
781
+ lat="lat"
782
+ name="city"
783
+ value="requests"
784
+ valueFormat={fmt}
785
+ isDarkMode={isDarkMode}
786
+ />
787
+ ```
788
+
789
+
599
790
  ---
600
791
 
601
792
  ### Button
@@ -736,6 +927,434 @@ Primary action trigger. Supports multiple variants, sizes, shapes, icons, and lo
736
927
  aria-label="Add item"
737
928
  title="Add item"
738
929
  />
930
+ <Button
931
+ variant="secondary"
932
+ title="You need edit access to create a Worker"
933
+ disabled
934
+ >
935
+ Create Worker
936
+ </Button>
937
+ </div>
938
+ ```
939
+
940
+
941
+ ---
942
+
943
+ ### Chart
944
+
945
+ Chart — a low-level wrapper around [Apache ECharts](https://echarts.apache.org).
946
+
947
+ **Type:** component
948
+
949
+ **Import:** `import { Chart } from "@cloudflare/kumo";`
950
+
951
+ **Category:** Data Visualization
952
+
953
+ **Props:**
954
+
955
+ - `echarts`: typeof echarts (required)
956
+ 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).
957
+ - `options`: KumoChartOption (required)
958
+ ECharts option object — passed through to `chart.setOption()`
959
+ - `optionUpdateBehavior`: SetOptionOpts
960
+ Additional options passed as the second argument to `chart.setOption()`. Defaults to `{ notMerge: false, lazyUpdate: true }`.
961
+ - `className`: string
962
+ Additional CSS classes applied to the chart container `<div>`
963
+ - `isDarkMode`: boolean
964
+ When `true`, initialises ECharts with its built-in dark theme. Changing this value after mount destroys and re-creates the chart instance.
965
+ - `height`: number
966
+ Height of the chart container in pixels. Defaults to `350`.
967
+ - `aspectRatio`: number | string
968
+ 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.
969
+
970
+ **Examples:**
971
+
972
+ ```tsx
973
+ <Chart
974
+ echarts={echarts}
975
+ options={options}
976
+ height={400}
977
+ isDarkMode={isDarkMode}
978
+ />
979
+ ```
980
+
981
+ ```tsx
982
+ <TimeseriesChart
983
+ echarts={echarts}
984
+ isDarkMode={isDarkMode}
985
+ data={data}
986
+ xAxisName="Time (UTC)"
987
+ yAxisName="Count"
988
+ />
989
+ ```
990
+
991
+ ```tsx
992
+ <TimeseriesChart
993
+ echarts={echarts}
994
+ isDarkMode={isDarkMode}
995
+ data={data}
996
+ markers={markers}
997
+ xAxisName="Time (UTC)"
998
+ yAxisName="Count"
999
+ />
1000
+ ```
1001
+
1002
+ ```tsx
1003
+ <TimeseriesChart
1004
+ echarts={echarts}
1005
+ isDarkMode={isDarkMode}
1006
+ data={data}
1007
+ thresholds={[
1008
+ {
1009
+ value: 55,
1010
+ label: "Memory limit",
1011
+ color: ChartPalette.semantic("Attention", isDarkMode),
1012
+ },
1013
+ ]}
1014
+ xAxisName="Time (UTC)"
1015
+ yAxisName="Memory (MB)"
1016
+ />
1017
+ ```
1018
+
1019
+ ```tsx
1020
+ <TimeseriesChart
1021
+ echarts={echarts}
1022
+ isDarkMode={isDarkMode}
1023
+ data={data}
1024
+ xAxisName="Time (UTC)"
1025
+ yAxisName="Requests"
1026
+ xAxisTickFormat={(ts) => {
1027
+ const d = new Date(ts);
1028
+ return `${d.getHours().toString().padStart(2, "0")}:${d.getMinutes().toString().padStart(2, "0")}`;
1029
+ }}
1030
+ yAxisTickFormat={(value) => {
1031
+ if (value >= 1000) return `${value / 1000}k`;
1032
+ return value.toString();
1033
+ }}
1034
+ tooltipValueFormat={(value) => `${(value / 1000).toFixed(1)}k requests`}
1035
+ />
1036
+ ```
1037
+
1038
+ ```tsx
1039
+ <TimeseriesChart
1040
+ yAxisTickCount={2}
1041
+ echarts={echarts}
1042
+ isDarkMode={isDarkMode}
1043
+ data={data}
1044
+ height={160}
1045
+ />
1046
+ ```
1047
+
1048
+ ```tsx
1049
+ <TimeseriesChart
1050
+ echarts={echarts}
1051
+ isDarkMode={isDarkMode}
1052
+ data={data}
1053
+ xAxisName="Time (UTC)"
1054
+ yAxisName="Mbps"
1055
+ incomplete={{ after: incompleteTimestamp }}
1056
+ />
1057
+ ```
1058
+
1059
+ ```tsx
1060
+ <TimeseriesChart
1061
+ echarts={echarts}
1062
+ isDarkMode={isDarkMode}
1063
+ data={data}
1064
+ xAxisName="Time (UTC)"
1065
+ yAxisName="%"
1066
+ onTimeRangeChange={(from, to) => {
1067
+ alert(
1068
+ `Selected range:\nFrom: ${new Date(from).toLocaleString()}\nTo: ${new Date(to).toLocaleString()}`,
1069
+ );
1070
+ }}
1071
+ />
1072
+ ```
1073
+
1074
+ ```tsx
1075
+ <div className="space-y-4">
1076
+ <h3 className="text-sm font-medium">Active State</h3>
1077
+
1078
+ <div className="flex flex-wrap gap-4 divide-x divide-kumo-hairline">
1079
+ <ChartLegend.LargeItem
1080
+ name="Requests"
1081
+ color={ChartPalette.semantic("Neutral", isDarkMode)}
1082
+ value="1,234"
1083
+ unit="req/s"
1084
+ />
1085
+ <ChartLegend.LargeItem
1086
+ name="Storage"
1087
+ color={ChartPalette.semantic("Attention", isDarkMode)}
1088
+ value="56"
1089
+ unit="GB"
1090
+ />
1091
+ <ChartLegend.LargeItem
1092
+ name="Warnings"
1093
+ color={ChartPalette.semantic("Warning", isDarkMode)}
1094
+ value="128"
1095
+ />
1096
+ </div>
1097
+
1098
+ <h3 className="mt-12 text-sm font-medium">Inactive State</h3>
1099
+
1100
+ <div className="flex flex-wrap gap-4 divide-x divide-kumo-hairline">
1101
+ <ChartLegend.LargeItem
1102
+ name="Requests"
1103
+ color={ChartPalette.semantic("Neutral", isDarkMode)}
1104
+ value="1,234"
1105
+ unit="req/s"
1106
+ inactive
1107
+ />
1108
+ <ChartLegend.LargeItem
1109
+ name="Storage"
1110
+ color={ChartPalette.semantic("Attention", isDarkMode)}
1111
+ value="56"
1112
+ unit="GB"
1113
+ inactive
1114
+ />
1115
+ <ChartLegend.LargeItem
1116
+ name="Warnings"
1117
+ color={ChartPalette.semantic("Warning", isDarkMode)}
1118
+ value="128"
1119
+ inactive
1120
+ />
1121
+ </div>
1122
+
1123
+ <h3 className="mt-12 text-sm font-medium">Loading state</h3>
1124
+
1125
+ <div className="flex flex-wrap gap-4 divide-x divide-kumo-hairline">
1126
+ <ChartLegend.LargeItem loading />
1127
+ </div>
1128
+ </div>
1129
+ ```
1130
+
1131
+ ```tsx
1132
+ <TimeseriesChart
1133
+ echarts={echarts}
1134
+ isDarkMode={isDarkMode}
1135
+ type="bar"
1136
+ data={data}
1137
+ xAxisName="Time (UTC)"
1138
+ yAxisName="Count"
1139
+ tooltipValueFormat={(r) => r.toFixed(2)}
1140
+ />
1141
+ ```
1142
+
1143
+ ```tsx
1144
+ <div className="flex w-full flex-1 flex-col">
1145
+ <TimeseriesChart
1146
+ echarts={echarts}
1147
+ isDarkMode={isDarkMode}
1148
+ xAxisName="Time (UTC)"
1149
+ yAxisName="Count"
1150
+ data={[]}
1151
+ loading
1152
+ />
1153
+ </div>
1154
+ ```
1155
+
1156
+ ```tsx
1157
+ <div className="flex w-full flex-1 flex-col">
1158
+ <TimeseriesChart
1159
+ echarts={echarts}
1160
+ isDarkMode={isDarkMode}
1161
+ type="bar"
1162
+ xAxisName="Time (UTC)"
1163
+ yAxisName="Count"
1164
+ data={[]}
1165
+ loading
1166
+ />
1167
+ </div>
1168
+ ```
1169
+
1170
+ ```tsx
1171
+ <div className="flex w-full flex-1 flex-col gap-3">
1172
+ <div className="flex items-center justify-between">
1173
+ <div className="flex flex-wrap gap-4">
1174
+ {data.map((series) => (
1175
+ <ChartLegend.SmallItem
1176
+ loading={loading}
1177
+ key={series.name}
1178
+ name={series.name}
1179
+ color={series.color}
1180
+ value={Math.round(series.data.at(-1)?.[1] ?? 0).toLocaleString()}
1181
+ />
1182
+ ))}
1183
+ </div>
1184
+ <Switch
1185
+ label="Loading"
1186
+ checked={loading}
1187
+ onCheckedChange={setLoading}
1188
+ />
1189
+ </div>
1190
+ <TimeseriesChart
1191
+ echarts={echarts}
1192
+ isDarkMode={isDarkMode}
1193
+ xAxisName="Time (UTC)"
1194
+ yAxisName="Count"
1195
+ data={loading ? [] : data}
1196
+ loading={loading}
1197
+ />
1198
+ </div>
1199
+ ```
1200
+
1201
+ ```tsx
1202
+ <LayerCard>
1203
+ <LayerCard.Secondary>Read latency</LayerCard.Secondary>
1204
+ <LayerCard.Primary>
1205
+ <div className="mb-2 flex gap-4 divide-x divide-kumo-hairline px-2">
1206
+ <ChartLegend.LargeItem
1207
+ name="P99"
1208
+ color={ChartPalette.semantic("Attention", isDarkMode)}
1209
+ value="124"
1210
+ unit="ms"
1211
+ />
1212
+ <ChartLegend.LargeItem
1213
+ name="P95"
1214
+ color={ChartPalette.semantic("Warning", isDarkMode)}
1215
+ value="76"
1216
+ unit="ms"
1217
+ />
1218
+ <ChartLegend.LargeItem
1219
+ name="P75"
1220
+ color={ChartPalette.semantic("Neutral", isDarkMode)}
1221
+ value="32"
1222
+ unit="ms"
1223
+ />
1224
+ <ChartLegend.LargeItem
1225
+ name="P50"
1226
+ color={ChartPalette.semantic("Neutral", isDarkMode)}
1227
+ value="10"
1228
+ unit="ms"
1229
+ />
1230
+ </div>
1231
+ <TimeseriesChart
1232
+ xAxisName="Time (UTC)"
1233
+ echarts={echarts}
1234
+ isDarkMode={isDarkMode}
1235
+ data={data}
1236
+ height={300}
1237
+ />
1238
+ </LayerCard.Primary>
1239
+ </LayerCard>
1240
+ ```
1241
+
1242
+ ```tsx
1243
+ <LayerCard>
1244
+ <LayerCard.Secondary>Read latency</LayerCard.Secondary>
1245
+ <LayerCard.Primary>
1246
+ <div className="mb-2 flex divide-x divide-kumo-line px-2">
1247
+ {series.map((s) => (
1248
+ <ChartLegend.LargeItem
1249
+ key={s.name}
1250
+ name={s.name}
1251
+ color={s.color}
1252
+ value={s.value}
1253
+ unit={s.unit}
1254
+ inactive={hoveredSeries !== null && hoveredSeries !== s.name}
1255
+ onPointerEnter={() => {
1256
+ setHoveredSeries(s.name);
1257
+ chartRef.current?.dispatchAction({
1258
+ type: "highlight",
1259
+ seriesName: s.name,
1260
+ });
1261
+ }}
1262
+ onPointerLeave={() => {
1263
+ setHoveredSeries(null);
1264
+ chartRef.current?.dispatchAction({
1265
+ type: "downplay",
1266
+ seriesName: s.name,
1267
+ });
1268
+ }}
1269
+ className="not-first:pl-4"
1270
+ />
1271
+ ))}
1272
+ </div>
1273
+ <TimeseriesChart
1274
+ ref={chartRef}
1275
+ xAxisName="Time (UTC)"
1276
+ echarts={echarts}
1277
+ isDarkMode={isDarkMode}
1278
+ data={data}
1279
+ height={300}
1280
+ />
1281
+ </LayerCard.Primary>
1282
+ </LayerCard>
1283
+ ```
1284
+
1285
+ ```tsx
1286
+ <LayerCard>
1287
+ <LayerCard.Secondary>Read latency</LayerCard.Secondary>
1288
+ <LayerCard.Primary>
1289
+ <div className="mb-2 flex divide-x divide-kumo-line px-2">
1290
+ {series.map((s) => (
1291
+ <ChartLegend.LargeItem
1292
+ key={s.name}
1293
+ name={s.name}
1294
+ color={s.color}
1295
+ value={s.value}
1296
+ unit={s.unit}
1297
+ inactive={hiddenSeries[s.name] ?? false}
1298
+ onClick={() => handleClick(s.name)}
1299
+ className="not-first:pl-4"
1300
+ />
1301
+ ))}
1302
+ </div>
1303
+ <TimeseriesChart
1304
+ ref={chartRef}
1305
+ xAxisName="Time (UTC)"
1306
+ echarts={echarts}
1307
+ isDarkMode={isDarkMode}
1308
+ data={data}
1309
+ height={300}
1310
+ enableLegendSelection
1311
+ />
1312
+ </LayerCard.Primary>
1313
+ </LayerCard>
1314
+ ```
1315
+
1316
+ ```tsx
1317
+ <div className="flex w-full flex-col gap-4">
1318
+ <Select
1319
+ label="Tooltip follow cursor"
1320
+ value={selected}
1321
+ onValueChange={(v) => {
1322
+ if (v) setSelected(v);
1323
+ }}
1324
+ renderValue={(v) => v.label}
1325
+ >
1326
+ {FOLLOW_CURSOR_OPTIONS.map((opt) => (
1327
+ <Select.Option key={opt.value} value={opt}>
1328
+ {opt.label}
1329
+ </Select.Option>
1330
+ ))}
1331
+ </Select>
1332
+ <TimeseriesChart
1333
+ echarts={echarts}
1334
+ isDarkMode={isDarkMode}
1335
+ data={data}
1336
+ xAxisName="Time (UTC)"
1337
+ yAxisName="Latency (ms)"
1338
+ tooltipFollowCursor={selected.value}
1339
+ />
1340
+ </div>
1341
+ ```
1342
+
1343
+ ```tsx
1344
+ <div
1345
+ ref={boundaryRef}
1346
+ className="w-full overflow-auto rounded-lg border border-kumo-line"
1347
+ style={{ height: 300 }}
1348
+ >
1349
+ <TimeseriesChart
1350
+ echarts={echarts}
1351
+ isDarkMode={isDarkMode}
1352
+ data={data}
1353
+ xAxisName="Time (UTC)"
1354
+ yAxisName="Count"
1355
+ height={280}
1356
+ tooltipBoundary={boundary ?? undefined}
1357
+ />
739
1358
  </div>
740
1359
  ```
741
1360
 
@@ -814,23 +1433,23 @@ Item sub-component
814
1433
  Group sub-component
815
1434
 
816
1435
  Props:
817
- - `legend`: string
818
- - `children`: ReactNode (required)
819
- - `error`: string
820
- - `description`: ReactNode
821
- - `value`: string[]
822
- - `allValues`: string[]
823
- - `disabled`: boolean
824
- - `controlFirst`: boolean
825
- - `className`: string
1436
+ - `legend`: string - Legend text for the group. For more control over legend styling, omit this prop and use `<Checkbox.Legend>` as a child instead.
1437
+ - `children`: ReactNode (required) - Child Checkbox.Item components (and optionally a Checkbox.Legend)
1438
+ - `error`: string - Error message for the group (only appears in groups, not single checkboxes)
1439
+ - `description`: ReactNode - Helper text for the group
1440
+ - `value`: string[] - Values of checkboxes that should be checked (controlled)
1441
+ - `allValues`: string[] - All possible checkbox values (required for parent checkbox pattern)
1442
+ - `disabled`: boolean - Whether all checkboxes in the group are disabled
1443
+ - `controlFirst`: boolean - When true (default), checkbox appears before label. When false, label appears before checkbox.
1444
+ - `className`: string - Additional CSS classes
826
1445
 
827
1446
  #### Checkbox.Legend
828
1447
 
829
1448
  Legend sub-component
830
1449
 
831
1450
  Props:
832
- - `children`: ReactNode (required)
833
- - `className`: string
1451
+ - `children`: ReactNode (required) - Legend content
1452
+ - `className`: string - Additional CSS classes (e.g. "sr-only" to visually hide the legend)
834
1453
 
835
1454
 
836
1455
  **Examples:**
@@ -905,6 +1524,76 @@ Props:
905
1524
  ```
906
1525
 
907
1526
 
1527
+ ---
1528
+
1529
+ ### ChoroplethMap
1530
+
1531
+ ChoroplethMap component
1532
+
1533
+ **Type:** component
1534
+
1535
+ **Import:** `import { ChoroplethMap } from "@cloudflare/kumo";`
1536
+
1537
+ **Category:** Data Visualization
1538
+
1539
+ **Props:**
1540
+
1541
+ - `echarts`: typeof echarts (required)
1542
+ The ECharts core instance imported by the consumer (passed in for tree-shaking). Requires `MapChart`, `VisualMapComponent`, `TooltipComponent`, and a renderer registered via `echarts.use([...])`.
1543
+ - `geoJson`: MapGeoJson (required)
1544
+ GeoJSON `FeatureCollection` whose regions are shaded by value.
1545
+ - `mapName`: string
1546
+ 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.
1547
+ - `data`: T[] (required)
1548
+ Raw data rows. The region key and value are read via the accessors below.
1549
+ - `name`: MapAccessor<T, string> (required)
1550
+ Region-key accessor (key of `T` or `(row) => string`). Each row is joined to a GeoJSON feature whose `nameProperty` equals this value.
1551
+ - `value`: MapAccessor<T, number> (required)
1552
+ Value accessor — drives the region's fill colour.
1553
+ - `nameProperty`: string
1554
+ 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"`).
1555
+ - `colorRange`: string[]
1556
+ 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.
1557
+ - `noDataColor`: string
1558
+ Fill for regions with no matching data row. Defaults to the neutral land grey.
1559
+ - `showLegend`: boolean
1560
+ Show the visualMap colour legend. Default: `false`.
1561
+ - `showTooltip`: boolean
1562
+ Show the tooltip. Default: `true`.
1563
+ - `valueFormat`: (value: number) => string
1564
+ Format the value for the default tooltip. Default: `toLocaleString()`.
1565
+ - `tooltipFormatter`: (row: T) => string
1566
+ 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.
1567
+ - `center`: [number, number]
1568
+ Map center as `[longitude, latitude]`. Defaults to auto-fit.
1569
+ - `zoom`: number
1570
+ Zoom level — multiplies the auto-fit scale. Default: `1.25`.
1571
+ - `roam`: boolean
1572
+ Enable drag-to-pan and scroll-to-zoom. Default: `false`.
1573
+ - `projection`: MapProjection | null
1574
+ 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.
1575
+ - `aspectRatio`: number | string
1576
+ 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.
1577
+ - `height`: number
1578
+ Fixed chart height in pixels. Overrides `aspectRatio` when set. Leave unset to size by aspect ratio (the default) so the map fills the container.
1579
+ - `className`: string
1580
+ - `isDarkMode`: boolean
1581
+
1582
+ **Examples:**
1583
+
1584
+ ```tsx
1585
+ <ChoroplethMap<CountryTraffic>
1586
+ echarts={echarts}
1587
+ geoJson={geoJson}
1588
+ data={countries}
1589
+ name="country"
1590
+ value="requests"
1591
+ valueFormat={fmt}
1592
+ isDarkMode={isDarkMode}
1593
+ />
1594
+ ```
1595
+
1596
+
908
1597
  ---
909
1598
 
910
1599
  ### ClipboardText
@@ -1460,8 +2149,8 @@ This is a compound component. Use these sub-components:
1460
2149
  Block sub-component
1461
2150
 
1462
2151
  Props:
1463
- - `code`: string (required)
1464
- - `lang`: CodeLang
2152
+ - `code`: string (required) - The code string to display.
2153
+ - `lang`: CodeLang - Language hint for the code content.
1465
2154
 
1466
2155
 
1467
2156
  ---
@@ -1496,37 +2185,37 @@ This is a compound component. Use these sub-components:
1496
2185
  Root sub-component
1497
2186
 
1498
2187
  Props:
1499
- - `className`: string
2188
+ - `className`: string - Additional CSS classes
1500
2189
 
1501
2190
  #### Collapsible.Trigger
1502
2191
 
1503
2192
  Trigger sub-component
1504
2193
 
1505
2194
  Props:
1506
- - `className`: string
2195
+ - `className`: string - Additional CSS classes
1507
2196
 
1508
2197
  #### Collapsible.Panel
1509
2198
 
1510
2199
  Panel sub-component
1511
2200
 
1512
2201
  Props:
1513
- - `className`: string
2202
+ - `className`: string - Additional CSS classes
1514
2203
 
1515
2204
  #### Collapsible.DefaultTrigger
1516
2205
 
1517
2206
  DefaultTrigger sub-component
1518
2207
 
1519
2208
  Props:
1520
- - `children`: ReactNode (required)
1521
- - `className`: string
2209
+ - `children`: ReactNode (required) - Label text displayed in the trigger
2210
+ - `className`: string - Additional CSS classes
1522
2211
 
1523
2212
  #### Collapsible.DefaultPanel
1524
2213
 
1525
2214
  DefaultPanel sub-component
1526
2215
 
1527
2216
  Props:
1528
- - `children`: ReactNode (required)
1529
- - `className`: string
2217
+ - `children`: ReactNode (required) - Panel content
2218
+ - `className`: string - Additional CSS classes
1530
2219
 
1531
2220
 
1532
2221
  **Examples:**
@@ -1551,13 +2240,17 @@ Props:
1551
2240
  </Collapsible.DefaultPanel>
1552
2241
  </Collapsible.Root>
1553
2242
  <Collapsible.Root open={open2} onOpenChange={setOpen2}>
1554
- <Collapsible.DefaultTrigger>How do I use it?</Collapsible.DefaultTrigger>
2243
+ <Collapsible.DefaultTrigger>
2244
+ How do I use it?
2245
+ </Collapsible.DefaultTrigger>
1555
2246
  <Collapsible.DefaultPanel>
1556
2247
  <Text>Install the components and import them into your project.</Text>
1557
2248
  </Collapsible.DefaultPanel>
1558
2249
  </Collapsible.Root>
1559
2250
  <Collapsible.Root open={open3} onOpenChange={setOpen3}>
1560
- <Collapsible.DefaultTrigger>Is it open source?</Collapsible.DefaultTrigger>
2251
+ <Collapsible.DefaultTrigger>
2252
+ Is it open source?
2253
+ </Collapsible.DefaultTrigger>
1561
2254
  <Collapsible.DefaultPanel>
1562
2255
  <Text>Check the repository for license information.</Text>
1563
2256
  </Collapsible.DefaultPanel>
@@ -1568,14 +2261,13 @@ Props:
1568
2261
  ```tsx
1569
2262
  <div className="w-full">
1570
2263
  <Collapsible.Root open={isOpen} onOpenChange={setIsOpen}>
1571
- <Collapsible.Trigger
1572
- render={<Button variant="secondary" size="sm" />}
1573
- >
2264
+ <Collapsible.Trigger render={<Button variant="secondary" size="sm" />}>
1574
2265
  {isOpen ? "Hide details" : "Show details"}
1575
2266
  </Collapsible.Trigger>
1576
2267
  <Collapsible.Panel className="mt-3 rounded-lg bg-kumo-tint p-4">
1577
2268
  <Text>
1578
- This panel uses custom styling instead of the default border-left accent.
2269
+ This panel uses custom styling instead of the default border-left
2270
+ accent.
1579
2271
  </Text>
1580
2272
  </Collapsible.Panel>
1581
2273
  </Collapsible.Root>
@@ -1913,7 +2605,7 @@ Icon sub-component (wraps ComboboxBase)
1913
2605
  ```
1914
2606
 
1915
2607
  ```tsx
1916
- <div className="flex flex-wrap gap-4 items-start">
2608
+ <div className="flex flex-wrap items-start gap-4">
1917
2609
  <Combobox value="Apple" items={fruits} disabled>
1918
2610
  <Combobox.TriggerInput
1919
2611
  className="w-[200px]"
@@ -2092,17 +2784,13 @@ Icon sub-component (wraps ComboboxBase)
2092
2784
  onValueChange={(v) => setValue(v as Language)}
2093
2785
  items={languages}
2094
2786
  >
2095
- <Combobox.Trigger
2096
- render={
2097
- <Button variant="ghost" size="sm" />
2098
- }
2099
- >
2787
+ <Combobox.Trigger render={<Button variant="ghost" size="sm" />}>
2100
2788
  <Combobox.Value>
2101
2789
  <span className="truncate">
2102
2790
  {value.emoji} {value.label}
2103
2791
  </span>
2104
2792
  </Combobox.Value>
2105
- <CaretUpDownIcon size={14} className="text-kumo-subtle shrink-0" />
2793
+ <CaretUpDownIcon size={14} className="shrink-0 text-kumo-subtle" />
2106
2794
  </Combobox.Trigger>
2107
2795
  <Combobox.Content>
2108
2796
  <Combobox.Input placeholder="Search languages" />
@@ -2595,7 +3283,7 @@ DatePicker — a date selection calendar.
2595
3283
  disabled={unavailableDates}
2596
3284
  fixedWeeks
2597
3285
  footer={
2598
- <p className="text-xs text-kumo-subtle pt-2 w-full">
3286
+ <p className="w-full pt-2 text-xs text-kumo-subtle">
2599
3287
  {selectedCount}/{maxDays} days selected. Grayed dates are unavailable.
2600
3288
  </p>
2601
3289
  }
@@ -2808,7 +3496,9 @@ Close sub-component
2808
3496
 
2809
3497
  ```tsx
2810
3498
  <Dialog.Root>
2811
- <Dialog.Trigger render={(p) => <Button {...p}>Open capped dialog</Button>} />
3499
+ <Dialog.Trigger
3500
+ render={(p) => <Button {...p}>Open capped dialog</Button>}
3501
+ />
2812
3502
  <Dialog className="max-w-lg p-8">
2813
3503
  <div className="mb-4 flex items-start justify-between gap-4">
2814
3504
  <Dialog.Title className="text-2xl font-semibold">
@@ -2949,9 +3639,7 @@ Close sub-component
2949
3639
  <Select
2950
3640
  className="w-full"
2951
3641
  placeholder="Select region..."
2952
- renderValue={(v) =>
2953
- regions.find((r) => r.value === v)?.label
2954
- }
3642
+ renderValue={(v) => regions.find((r) => r.value === v)?.label}
2955
3643
  >
2956
3644
  {regions.map((region) => (
2957
3645
  <Select.Option key={region.value} value={region.value}>
@@ -4290,7 +4978,7 @@ Description sub-component
4290
4978
  </InputGroup.Addon>
4291
4979
  <InputGroup.Input placeholder="Search..." aria-label="Search" />
4292
4980
  <InputGroup.Addon align="end">
4293
- <kbd className="bg-none! border-none!">⌘K</kbd>
4981
+ <kbd className="border-none! bg-none!">⌘K</kbd>
4294
4982
  </InputGroup.Addon>
4295
4983
  </InputGroup>
4296
4984
  ```
@@ -4954,37 +5642,37 @@ Info sub-component
4954
5642
 
4955
5643
  Props:
4956
5644
  - `children`: (props: {
4957
- - `page`: number (required)
4958
- - `perPage`: number
4959
- - `totalCount`: number
4960
- - `pageShowingRange`: string (required)
5645
+ page: number;
5646
+ perPage?: number;
5647
+ totalCount?: number;
5648
+ pageShowingRange: string;
5649
+ }) => ReactNode - Custom render function for the info text
5650
+ - `className`: string - Additional CSS classes
4961
5651
 
4962
5652
  #### Pagination.PageSize
4963
5653
 
4964
5654
  PageSize sub-component
4965
5655
 
4966
5656
  Props:
4967
- - `value`: number (required)
4968
- - `options`: number[]
4969
- - `page`: " (required)
4970
- - `label`: ReactNode
4971
- - `className`: string
5657
+ - `value`: number (required) - Current page size value
5658
+ - `options`: number[] - Available page size options
5659
+ - `label`: ReactNode - Label text shown before the selector.
5660
+ - `className`: string - Additional CSS classes
4972
5661
 
4973
5662
  #### Pagination.Controls
4974
5663
 
4975
5664
  Controls sub-component
4976
5665
 
4977
5666
  Props:
4978
- - `Note`: ** `"dropdown"` renders an option for every page (required)
4979
- - `pageSelector`: "input" | "dropdown"
4980
- - `className`: string
5667
+ - `pageSelector`: "input" | "dropdown" - 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.
5668
+ - `className`: string - Additional CSS classes
4981
5669
 
4982
5670
  #### Pagination.Separator
4983
5671
 
4984
5672
  Separator sub-component
4985
5673
 
4986
5674
  Props:
4987
- - `className`: string
5675
+ - `className`: string - Additional CSS classes
4988
5676
 
4989
5677
 
4990
5678
  **Examples:**
@@ -5401,19 +6089,28 @@ Radio — radio button group for single-select choices.
5401
6089
  - `variant`: enum [default: default]
5402
6090
  - `"default"`: Default radio appearance
5403
6091
  - `"error"`: Error state for validation failures
5404
- - `appearance`: enum [default: default]
5405
- - `"default"`: Standard inline radio item
5406
- - `"card"`: Choice card appearance with border, padding, and highlighted selection state
5407
-
5408
- **State Classes:**
5409
- - `"card"`:
5410
- - `hover`: `hover:bg-kumo-tint`
5411
- - `className`: string
5412
- Additional CSS classes
5413
- - `children`: ReactNode
5414
- Child elements
6092
+ - `appearance`: KumoRadioAppearance
6093
+ 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.
6094
+ - `legend`: string
6095
+ 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.
6096
+ - `children`: ReactNode (required)
6097
+ Child Radio.Item components (and optionally a Radio.Legend)
6098
+ - `orientation`: "vertical" | "horizontal"
6099
+ Layout direction of the radio items
6100
+ - `error`: string
6101
+ Error message for the group
6102
+ - `description`: ReactNode
6103
+ Helper text for the group
5415
6104
  - `value`: T
5416
6105
  The controlled value of the selected radio item.
6106
+ - `disabled`: boolean
6107
+ Whether all radios in the group are disabled
6108
+ - `controlPosition`: RadioControlPosition
6109
+ 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.
6110
+ - `name`: string
6111
+ Form submission name for the radio group
6112
+ - `className`: string
6113
+ Additional CSS classes
5417
6114
  - `defaultValue`: T
5418
6115
  The uncontrolled initial value of the selected radio item.
5419
6116
  - `onValueChange`: (value: T, eventDetails: RadioGroupChangeEventDetails) => void
@@ -5436,7 +6133,17 @@ Item sub-component
5436
6133
  Group sub-component
5437
6134
 
5438
6135
  Props:
6136
+ - `legend`: string - 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.
6137
+ - `children`: ReactNode (required) - Child Radio.Item components (and optionally a Radio.Legend)
6138
+ - `orientation`: "vertical" | "horizontal" - Layout direction of the radio items
6139
+ - `appearance`: KumoRadioAppearance - 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.
6140
+ - `error`: string - Error message for the group
6141
+ - `description`: ReactNode - Helper text for the group
5439
6142
  - `value`: T - The controlled value of the selected radio item.
6143
+ - `disabled`: boolean - Whether all radios in the group are disabled
6144
+ - `controlPosition`: RadioControlPosition - 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.
6145
+ - `name`: string - Form submission name for the radio group
6146
+ - `className`: string - Additional CSS classes
5440
6147
  - `defaultValue`: T - The uncontrolled initial value of the selected radio item.
5441
6148
  - `onValueChange`: (value: T, eventDetails: RadioGroupChangeEventDetails) => void - Callback fired when the selected value changes. The second argument carries native event details about the interaction.
5442
6149
 
@@ -5445,8 +6152,8 @@ Props:
5445
6152
  Legend sub-component
5446
6153
 
5447
6154
  Props:
5448
- - `children`: ReactNode (required)
5449
- - `className`: string
6155
+ - `children`: ReactNode (required) - Legend content
6156
+ - `className`: string - Additional CSS classes (e.g. "sr-only" to visually hide the legend)
5450
6157
 
5451
6158
 
5452
6159
  **Examples:**
@@ -5728,6 +6435,171 @@ Props:
5728
6435
  ```
5729
6436
 
5730
6437
 
6438
+ ---
6439
+
6440
+ ### SankeyChart
6441
+
6442
+ SankeyChart component
6443
+
6444
+ **Type:** component
6445
+
6446
+ **Import:** `import { SankeyChart } from "@cloudflare/kumo";`
6447
+
6448
+ **Category:** Data Visualization
6449
+
6450
+ **Props:**
6451
+
6452
+ - `echarts`: typeof echarts (required)
6453
+ 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).
6454
+ - `nodes`: SankeyNodeData[] (required)
6455
+ Array of nodes in the Sankey diagram
6456
+ - `links`: SankeyLinkData[] (required)
6457
+ Array of links connecting nodes by index
6458
+ - `height`: number
6459
+ Height of the chart in pixels
6460
+ - `showNodeValues`: boolean
6461
+ Show node values above labels (default: true if any node has a value)
6462
+ - `nodeLabelLayout`: "stacked" | "inline"
6463
+ 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)
6464
+ - `formatValue`: (value: number) => string
6465
+ Format function for node values (default: toLocaleString)
6466
+ - `tooltipFormatter`: (params: SankeyTooltipParams) => string
6467
+ Custom tooltip formatter. Return HTML string or empty string to hide tooltip.
6468
+ - `nodeWidth`: number
6469
+ - `nodePadding`: number
6470
+ - `showTooltip`: boolean
6471
+ - `defaultNodeColor`: string
6472
+ - `left`: number | string
6473
+ Left padding of the Sankey layout within the chart container. Accepts a number (px) or percentage string. ECharts default: '5%'.
6474
+ - `right`: number | string
6475
+ Right padding of the Sankey layout within the chart container. Accepts a number (px) or percentage string. ECharts default: '5%'.
6476
+ - `linkColor`: "gradient" | "gray"
6477
+ Link fill style: 'gradient' blends source to target colors, 'gray' uses flat gray
6478
+ - `linkOpacity`: number
6479
+ - `className`: string
6480
+ - `isDarkMode`: boolean
6481
+
6482
+ **Examples:**
6483
+
6484
+ ```tsx
6485
+ <SankeyChart
6486
+ echarts={echarts}
6487
+ nodes={basicNodes}
6488
+ links={basicLinks}
6489
+ height={350}
6490
+ isDarkMode={isDarkMode}
6491
+ />
6492
+ ```
6493
+
6494
+ ```tsx
6495
+ <SankeyChart
6496
+ echarts={echarts}
6497
+ nodes={previewNodes}
6498
+ links={previewLinks}
6499
+ height={200}
6500
+ showTooltip={false}
6501
+ isDarkMode={isDarkMode}
6502
+ />
6503
+ ```
6504
+
6505
+ ```tsx
6506
+ <SankeyChart
6507
+ echarts={echarts}
6508
+ nodes={multiLevelNodes}
6509
+ links={multiLevelLinks}
6510
+ height={350}
6511
+ nodeWidth={20}
6512
+ nodePadding={15}
6513
+ isDarkMode={isDarkMode}
6514
+ />
6515
+ ```
6516
+
6517
+ ```tsx
6518
+ <SankeyChart
6519
+ echarts={echarts}
6520
+ nodes={nodes}
6521
+ links={links}
6522
+ height={250}
6523
+ linkOpacity={0.6}
6524
+ isDarkMode={isDarkMode}
6525
+ />
6526
+ ```
6527
+
6528
+ ```tsx
6529
+ <SankeyChart
6530
+ echarts={echarts}
6531
+ nodes={nodes}
6532
+ links={links}
6533
+ height={300}
6534
+ tooltipFormatter={customTooltip}
6535
+ isDarkMode={isDarkMode}
6536
+ />
6537
+ ```
6538
+
6539
+ ```tsx
6540
+ <SankeyChart
6541
+ echarts={echarts}
6542
+ nodes={basicNodes}
6543
+ links={basicLinks}
6544
+ height={350}
6545
+ left={0}
6546
+ right={0}
6547
+ isDarkMode={isDarkMode}
6548
+ />
6549
+ ```
6550
+
6551
+ ```tsx
6552
+ <SankeyChart
6553
+ echarts={echarts}
6554
+ nodes={basicNodes}
6555
+ links={basicLinks}
6556
+ height={350}
6557
+ onNodeClick={handleNodeClick}
6558
+ onLinkClick={handleLinkClick}
6559
+ isDarkMode={isDarkMode}
6560
+ />
6561
+ ```
6562
+
6563
+ ```tsx
6564
+ <div className="flex w-full flex-col gap-2">
6565
+ <div className="flex items-center gap-2 text-sm text-kumo-subtle">
6566
+ <span>
6567
+ {hasSelection
6568
+ ? `Showing: ${[selectedSource, selectedTarget].filter(Boolean).join(" → ")}`
6569
+ : "Click a node to filter"}
6570
+ </span>
6571
+ {hasSelection && (
6572
+ <button
6573
+ onClick={resetFilters}
6574
+ className="text-kumo-brand hover:underline"
6575
+ >
6576
+ Reset
6577
+ </button>
6578
+ )}
6579
+ </div>
6580
+ <SankeyChart
6581
+ echarts={echarts}
6582
+ nodes={filteredNodes}
6583
+ links={filteredLinks}
6584
+ height={300}
6585
+ onNodeClick={handleNodeClick}
6586
+ isDarkMode={isDarkMode}
6587
+ />
6588
+ </div>
6589
+ ```
6590
+
6591
+ ```tsx
6592
+ <SankeyChart
6593
+ echarts={echarts}
6594
+ nodes={nodes}
6595
+ links={links}
6596
+ height={300}
6597
+ nodeLabelLayout="inline"
6598
+ isDarkMode={isDarkMode}
6599
+ />
6600
+ ```
6601
+
6602
+
5731
6603
  ---
5732
6604
 
5733
6605
  ### Select
@@ -6317,145 +7189,228 @@ This is a compound component. Use these sub-components:
6317
7189
  Provider sub-component
6318
7190
 
6319
7191
  Props:
6320
- - `defaultOpen`: boolean
6321
- - `open`: boolean
6322
- - `variant`: SidebarVariant
6323
- - `side`: SidebarSide
7192
+ - `defaultOpen`: boolean - Initial open state when uncontrolled.
7193
+ - `open`: boolean - Controlled open state.
7194
+ - `variant`: SidebarVariant - Sidebar layout variant.
7195
+ - `side`: SidebarSide - Which side the sidebar is on.
6324
7196
  - `collapsible`: "icon" | "offcanvas" | "none"
6325
- - `resizable`: boolean
6326
- - `defaultWidth`: number
6327
- - `minWidth`: number
6328
- - `maxWidth`: number
6329
- - `contained`: boolean
6330
- - `peekable`: boolean
6331
- - `animationDuration`: number
6332
- - `mobileBreakpoint`: number
6333
- - `children`: ReactNode (required)
6334
- - `className`: string
7197
+ - `resizable`: boolean - Enable drag-to-resize on the sidebar edge.
7198
+ - `defaultWidth`: number - Initial width in pixels when resizable.
7199
+ - `minWidth`: number - Minimum width in pixels when resizing.
7200
+ - `maxWidth`: number - Maximum width in pixels when resizing.
7201
+ - `contained`: boolean - When true, the collapsed sidebar uses absolute positioning instead of fixed, keeping it scoped inside a bounded parent. Useful for demos and embedded sidebars.
7202
+ - `peekable`: boolean - When true, hovering or focusing the collapsed sidebar temporarily expands it. The `state` will be `"peeking"` during the peek. Moving away collapses it back.
7203
+ - `animationDuration`: number - Duration of sidebar expand/collapse animation in milliseconds.
7204
+ - `mobileBreakpoint`: number - Viewport width (in px) below which the sidebar renders as a mobile dialog sheet instead of the desktop aside rail.
7205
+ - `children`: ReactNode (required) - Content — typically `<Sidebar>` + main content.
7206
+ - `className`: string - Additional CSS classes for the wrapper div.
6335
7207
 
6336
7208
  #### Sidebar.Header
6337
7209
 
6338
7210
  Header sub-component
6339
7211
 
6340
7212
  Props:
6341
- - `icon`: React.ComponentType<{ className?: string
7213
+ - `icon`: React.ComponentType<{ className?: string }> | React.ReactNode
7214
+ - `active`: boolean
7215
+ - `size`: SidebarMenuButtonSize - Button size. - `"base"` — Standard nav item - `"sm"` — Compact nav item
7216
+ - `href`: string
7217
+ - `target`: React.HTMLAttributeAnchorTarget - Link target — only meaningful when `href` is provided.
7218
+ - `tooltip`: string
7219
+ - `className`: string
7220
+ - `children`: ReactNode
6342
7221
 
6343
7222
  #### Sidebar.Content
6344
7223
 
6345
7224
  Content sub-component
6346
7225
 
6347
7226
  Props:
6348
- - `icon`: React.ComponentType<{ className?: string
7227
+ - `icon`: React.ComponentType<{ className?: string }> | React.ReactNode
7228
+ - `active`: boolean
7229
+ - `size`: SidebarMenuButtonSize - Button size. - `"base"` — Standard nav item - `"sm"` — Compact nav item
7230
+ - `href`: string
7231
+ - `target`: React.HTMLAttributeAnchorTarget - Link target — only meaningful when `href` is provided.
7232
+ - `tooltip`: string
7233
+ - `className`: string
7234
+ - `children`: ReactNode
6349
7235
 
6350
7236
  #### Sidebar.Footer
6351
7237
 
6352
7238
  Footer sub-component
6353
7239
 
6354
7240
  Props:
6355
- - `icon`: React.ComponentType<{ className?: string
7241
+ - `icon`: React.ComponentType<{ className?: string }> | React.ReactNode
7242
+ - `active`: boolean
7243
+ - `size`: SidebarMenuButtonSize - Button size. - `"base"` — Standard nav item - `"sm"` — Compact nav item
7244
+ - `href`: string
7245
+ - `target`: React.HTMLAttributeAnchorTarget - Link target — only meaningful when `href` is provided.
7246
+ - `tooltip`: string
7247
+ - `className`: string
7248
+ - `children`: ReactNode
7249
+
7250
+ #### Sidebar.Loading
7251
+
7252
+ Loading sub-component
7253
+
7254
+ Props:
7255
+ - `icon`: React.ComponentType<{ className?: string }> | React.ReactNode
7256
+ - `active`: boolean
7257
+ - `size`: SidebarMenuButtonSize - Button size. - `"base"` — Standard nav item - `"sm"` — Compact nav item
7258
+ - `href`: string
7259
+ - `target`: React.HTMLAttributeAnchorTarget - Link target — only meaningful when `href` is provided.
7260
+ - `tooltip`: string
7261
+ - `className`: string
7262
+ - `children`: ReactNode
6356
7263
 
6357
7264
  #### Sidebar.Group
6358
7265
 
6359
7266
  Group sub-component
6360
7267
 
6361
7268
  Props:
6362
- - `icon`: React.ComponentType<{ className?: string
7269
+ - `icon`: React.ComponentType<{ className?: string }> | React.ReactNode
7270
+ - `active`: boolean
7271
+ - `size`: SidebarMenuButtonSize - Button size. - `"base"` — Standard nav item - `"sm"` — Compact nav item
7272
+ - `href`: string
7273
+ - `target`: React.HTMLAttributeAnchorTarget - Link target — only meaningful when `href` is provided.
7274
+ - `tooltip`: string
7275
+ - `className`: string
7276
+ - `children`: ReactNode
6363
7277
 
6364
7278
  #### Sidebar.GroupLabel
6365
7279
 
6366
7280
  GroupLabel sub-component
6367
7281
 
6368
7282
  Props:
6369
- - `icon`: React.ComponentType<{ className?: string
7283
+ - `icon`: React.ComponentType<{ className?: string }> | React.ReactNode
7284
+ - `active`: boolean
7285
+ - `size`: SidebarMenuButtonSize - Button size. - `"base"` — Standard nav item - `"sm"` — Compact nav item
7286
+ - `href`: string
7287
+ - `target`: React.HTMLAttributeAnchorTarget - Link target — only meaningful when `href` is provided.
7288
+ - `tooltip`: string
7289
+ - `className`: string
7290
+ - `children`: ReactNode
6370
7291
 
6371
7292
  #### Sidebar.Menu
6372
7293
 
6373
7294
  Menu sub-component
6374
7295
 
6375
7296
  Props:
6376
- - `icon`: React.ComponentType<{ className?: string
7297
+ - `icon`: React.ComponentType<{ className?: string }> | React.ReactNode
7298
+ - `active`: boolean
7299
+ - `size`: SidebarMenuButtonSize - Button size. - `"base"` — Standard nav item - `"sm"` — Compact nav item
7300
+ - `href`: string
7301
+ - `target`: React.HTMLAttributeAnchorTarget - Link target — only meaningful when `href` is provided.
7302
+ - `tooltip`: string
7303
+ - `className`: string
7304
+ - `children`: ReactNode
6377
7305
 
6378
7306
  #### Sidebar.MenuItem
6379
7307
 
6380
7308
  MenuItem sub-component
6381
7309
 
6382
7310
  Props:
6383
- - `icon`: React.ComponentType<{ className?: string
7311
+ - `icon`: React.ComponentType<{ className?: string }> | React.ReactNode
7312
+ - `active`: boolean
7313
+ - `size`: SidebarMenuButtonSize - Button size. - `"base"` — Standard nav item - `"sm"` — Compact nav item
7314
+ - `href`: string
7315
+ - `target`: React.HTMLAttributeAnchorTarget - Link target — only meaningful when `href` is provided.
7316
+ - `tooltip`: string
7317
+ - `className`: string
7318
+ - `children`: ReactNode
6384
7319
 
6385
7320
  #### Sidebar.MenuButton
6386
7321
 
6387
7322
  MenuButton sub-component
6388
7323
 
6389
7324
  Props:
6390
- - `icon`: React.ComponentType<{ className?: string
7325
+ - `icon`: React.ComponentType<{ className?: string }> | React.ReactNode
7326
+ - `active`: boolean
7327
+ - `size`: SidebarMenuButtonSize - Button size. - `"base"` — Standard nav item - `"sm"` — Compact nav item
7328
+ - `href`: string
7329
+ - `target`: React.HTMLAttributeAnchorTarget - Link target — only meaningful when `href` is provided.
7330
+ - `tooltip`: string
7331
+ - `className`: string
7332
+ - `children`: ReactNode
6391
7333
 
6392
7334
  #### Sidebar.MenuBadge
6393
7335
 
6394
7336
  MenuBadge sub-component
6395
7337
 
6396
7338
  Props:
6397
- - `active`: boolean
6398
- - `href`: string
7339
+ - `active`: boolean - Marks this sub-item as currently active/selected.
7340
+ - `href`: string - Navigation URL. When set, renders as a link via LinkProvider.
7341
+ - `target`: React.HTMLAttributeAnchorTarget - Link target — only meaningful when `href` is provided.
6399
7342
 
6400
7343
  #### Sidebar.MenuSub
6401
7344
 
6402
7345
  MenuSub sub-component
6403
7346
 
6404
7347
  Props:
6405
- - `active`: boolean
6406
- - `href`: string
7348
+ - `active`: boolean - Marks this sub-item as currently active/selected.
7349
+ - `href`: string - Navigation URL. When set, renders as a link via LinkProvider.
7350
+ - `target`: React.HTMLAttributeAnchorTarget - Link target — only meaningful when `href` is provided.
6407
7351
 
6408
7352
  #### Sidebar.MenuSubItem
6409
7353
 
6410
7354
  MenuSubItem sub-component
6411
7355
 
6412
7356
  Props:
6413
- - `active`: boolean
6414
- - `href`: string
7357
+ - `active`: boolean - Marks this sub-item as currently active/selected.
7358
+ - `href`: string - Navigation URL. When set, renders as a link via LinkProvider.
7359
+ - `target`: React.HTMLAttributeAnchorTarget - Link target — only meaningful when `href` is provided.
6415
7360
 
6416
7361
  #### Sidebar.MenuSubButton
6417
7362
 
6418
7363
  MenuSubButton sub-component
6419
7364
 
6420
7365
  Props:
6421
- - `active`: boolean
6422
- - `href`: string
7366
+ - `active`: boolean - Marks this sub-item as currently active/selected.
7367
+ - `href`: string - Navigation URL. When set, renders as a link via LinkProvider.
7368
+ - `target`: React.HTMLAttributeAnchorTarget - Link target — only meaningful when `href` is provided.
6423
7369
 
6424
7370
  #### Sidebar.Separator
6425
7371
 
6426
7372
  Separator sub-component
6427
7373
 
6428
7374
  Props:
6429
- - `defaultOpen`: boolean
6430
- - `open`: boolean
6431
- - `autoScrollOnOpen`: boolean
7375
+ - `defaultOpen`: boolean - Initial open state (uncontrolled).
7376
+ - `open`: boolean - Controlled open state.
7377
+ - `autoScrollOnOpen`: boolean - Scroll the expanded content into view after opening.
6432
7378
 
6433
7379
  #### Sidebar.Trigger
6434
7380
 
6435
- Trigger sub-component
7381
+ Trigger sub-component
7382
+
7383
+ Props:
7384
+ - `defaultOpen`: boolean - Initial open state (uncontrolled).
7385
+ - `open`: boolean - Controlled open state.
7386
+ - `autoScrollOnOpen`: boolean - Scroll the expanded content into view after opening.
7387
+
7388
+ #### Sidebar.Close
7389
+
7390
+ Close sub-component
6436
7391
 
6437
7392
  Props:
6438
- - `defaultOpen`: boolean
6439
- - `open`: boolean
6440
- - `autoScrollOnOpen`: boolean
7393
+ - `defaultOpen`: boolean - Initial open state (uncontrolled).
7394
+ - `open`: boolean - Controlled open state.
7395
+ - `autoScrollOnOpen`: boolean - Scroll the expanded content into view after opening.
6441
7396
 
6442
7397
  #### Sidebar.Rail
6443
7398
 
6444
7399
  Rail sub-component
6445
7400
 
6446
7401
  Props:
6447
- - `defaultOpen`: boolean
6448
- - `open`: boolean
6449
- - `autoScrollOnOpen`: boolean
7402
+ - `defaultOpen`: boolean - Initial open state (uncontrolled).
7403
+ - `open`: boolean - Controlled open state.
7404
+ - `autoScrollOnOpen`: boolean - Scroll the expanded content into view after opening.
6450
7405
 
6451
7406
  #### Sidebar.ResizeHandle
6452
7407
 
6453
7408
  ResizeHandle sub-component
6454
7409
 
6455
7410
  Props:
6456
- - `defaultOpen`: boolean
6457
- - `open`: boolean
6458
- - `autoScrollOnOpen`: boolean
7411
+ - `defaultOpen`: boolean - Initial open state (uncontrolled).
7412
+ - `open`: boolean - Controlled open state.
7413
+ - `autoScrollOnOpen`: boolean - Scroll the expanded content into view after opening.
6459
7414
 
6460
7415
  #### Sidebar.MenuChevron
6461
7416
 
@@ -6469,46 +7424,46 @@ Props:
6469
7424
  Collapsible sub-component
6470
7425
 
6471
7426
  Props:
6472
- - `defaultOpen`: boolean
6473
- - `open`: boolean
6474
- - `autoScrollOnOpen`: boolean
7427
+ - `defaultOpen`: boolean - Initial open state (uncontrolled).
7428
+ - `open`: boolean - Controlled open state.
7429
+ - `autoScrollOnOpen`: boolean - Scroll the expanded content into view after opening.
6475
7430
 
6476
7431
  #### Sidebar.CollapsibleTrigger
6477
7432
 
6478
7433
  CollapsibleTrigger sub-component
6479
7434
 
6480
7435
  Props:
6481
- - `render`: React.ReactElement (required)
7436
+ - `render`: React.ReactElement (required) - Element to render as the trigger. Gets aria-expanded, aria-controls, and onClick merged.
6482
7437
 
6483
7438
  #### Sidebar.CollapsibleContent
6484
7439
 
6485
7440
  CollapsibleContent sub-component
6486
7441
 
6487
7442
  Props:
6488
- - `activeKey`: string (required)
6489
- - `direction`: "left" | "right"
7443
+ - `activeKey`: string (required) - Key of the currently active view. Must match a child `SlidingView` value.
7444
+ - `direction`: "left" | "right" - Slide direction for the transition. - `"left"`: new view slides in from the right - `"right"`: new view slides in from the left
6490
7445
 
6491
7446
  #### Sidebar.SlidingViews
6492
7447
 
6493
7448
  SlidingViews sub-component
6494
7449
 
6495
7450
  Props:
6496
- - `activeKey`: string (required)
6497
- - `direction`: "left" | "right"
7451
+ - `activeKey`: string (required) - Key of the currently active view. Must match a child `SlidingView` value.
7452
+ - `direction`: "left" | "right" - Slide direction for the transition. - `"left"`: new view slides in from the right - `"right"`: new view slides in from the left
6498
7453
 
6499
7454
  #### Sidebar.SlidingView
6500
7455
 
6501
7456
  SlidingView sub-component
6502
7457
 
6503
7458
  Props:
6504
- - `value`: string (required)
7459
+ - `value`: string (required) - Unique key matching this view. Must correspond to `activeKey` on `SlidingViews`.
6505
7460
 
6506
7461
 
6507
7462
  **Examples:**
6508
7463
 
6509
7464
  ```tsx
6510
7465
  <DemoContainer>
6511
- <Sidebar.Provider contained defaultOpen className="min-h-0! h-full">
7466
+ <Sidebar.Provider contained defaultOpen className="h-full min-h-0!">
6512
7467
  <Sidebar>
6513
7468
  <Sidebar.Content>
6514
7469
  <Sidebar.Group>
@@ -6587,7 +7542,7 @@ Props:
6587
7542
 
6588
7543
  ```tsx
6589
7544
  <DemoContainer>
6590
- <Sidebar.Provider contained defaultOpen className="min-h-0! h-full">
7545
+ <Sidebar.Provider contained defaultOpen className="h-full min-h-0!">
6591
7546
  <Sidebar>
6592
7547
  <Sidebar.Header>
6593
7548
  <BrandLogo />
@@ -6616,9 +7571,54 @@ Props:
6616
7571
  </Sidebar>
6617
7572
  <DemoMain>
6618
7573
  <ToggleButton />
6619
- <p>
6620
- Click the button or the sidebar trigger to toggle
6621
- </p>
7574
+ <p>Click the button or the sidebar trigger to toggle</p>
7575
+ </DemoMain>
7576
+ </Sidebar.Provider>
7577
+ </DemoContainer>
7578
+ ```
7579
+
7580
+ ```tsx
7581
+ <DemoContainer>
7582
+ <Sidebar.Provider contained defaultOpen className="h-full min-h-0!">
7583
+ <Sidebar>
7584
+ <Sidebar.Header>
7585
+ <BrandLogo />
7586
+ </Sidebar.Header>
7587
+ {loading ? (
7588
+ <Sidebar.Loading />
7589
+ ) : (
7590
+ <Sidebar.Content>
7591
+ <Sidebar.Group>
7592
+ <Sidebar.Menu>
7593
+ <Sidebar.MenuButton icon={HouseIcon} active>
7594
+ Home
7595
+ </Sidebar.MenuButton>
7596
+ <Sidebar.MenuButton icon={ChartBarIcon}>
7597
+ Analytics
7598
+ </Sidebar.MenuButton>
7599
+ <Sidebar.MenuButton icon={CodeIcon}>
7600
+ Compute
7601
+ </Sidebar.MenuButton>
7602
+ <Sidebar.MenuButton icon={DatabaseIcon}>
7603
+ Storage
7604
+ </Sidebar.MenuButton>
7605
+ </Sidebar.Menu>
7606
+ </Sidebar.Group>
7607
+ </Sidebar.Content>
7608
+ )}
7609
+ <Sidebar.Footer>
7610
+ <Sidebar.Trigger />
7611
+ </Sidebar.Footer>
7612
+ </Sidebar>
7613
+ <DemoMain>
7614
+ <button
7615
+ type="button"
7616
+ onClick={() => setLoading((l) => !l)}
7617
+ 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"
7618
+ >
7619
+ {loading ? "Show loaded nav" : "Show loading"}
7620
+ </button>
7621
+ <p>Toggle to compare the loading state with the loaded nav</p>
6622
7622
  </DemoMain>
6623
7623
  </Sidebar.Provider>
6624
7624
  </DemoContainer>
@@ -6626,13 +7626,14 @@ Props:
6626
7626
 
6627
7627
  ```tsx
6628
7628
  <DemoContainer>
6629
- <Sidebar.Provider contained
7629
+ <Sidebar.Provider
7630
+ contained
6630
7631
  defaultOpen
6631
7632
  resizable
6632
7633
  defaultWidth={240}
6633
7634
  minWidth={180}
6634
7635
  maxWidth={400}
6635
- className="min-h-0! h-full"
7636
+ className="h-full min-h-0!"
6636
7637
  >
6637
7638
  <Sidebar>
6638
7639
  <Sidebar.Header>
@@ -6667,7 +7668,12 @@ Props:
6667
7668
 
6668
7669
  ```tsx
6669
7670
  <DemoContainer>
6670
- <Sidebar.Provider contained defaultOpen side="right" className="min-h-0! h-full">
7671
+ <Sidebar.Provider
7672
+ contained
7673
+ defaultOpen
7674
+ side="right"
7675
+ className="h-full min-h-0!"
7676
+ >
6671
7677
  <DemoMain />
6672
7678
  <Sidebar>
6673
7679
  <Sidebar.Content>
@@ -6691,7 +7697,7 @@ Props:
6691
7697
 
6692
7698
  ```tsx
6693
7699
  <div className="relative h-[420px] w-full overflow-hidden rounded-lg border border-kumo-line bg-kumo-base">
6694
- <Sidebar.Provider contained defaultOpen className="min-h-0! h-full">
7700
+ <Sidebar.Provider contained defaultOpen className="h-full min-h-0!">
6695
7701
  <Sidebar>
6696
7702
  <Sidebar.Header>
6697
7703
  <BrandLogo />
@@ -6746,8 +7752,12 @@ Props:
6746
7752
  <Sidebar.CollapsibleContent>
6747
7753
  <Sidebar.MenuSub>
6748
7754
  <Sidebar.MenuSubButton>Overview</Sidebar.MenuSubButton>
6749
- <Sidebar.MenuSubButton>Deployments</Sidebar.MenuSubButton>
6750
- <Sidebar.MenuSubButton>Observability</Sidebar.MenuSubButton>
7755
+ <Sidebar.MenuSubButton>
7756
+ Deployments
7757
+ </Sidebar.MenuSubButton>
7758
+ <Sidebar.MenuSubButton>
7759
+ Observability
7760
+ </Sidebar.MenuSubButton>
6751
7761
  <Sidebar.MenuSubButton>Settings</Sidebar.MenuSubButton>
6752
7762
  </Sidebar.MenuSub>
6753
7763
  </Sidebar.CollapsibleContent>
@@ -6773,7 +7783,7 @@ Props:
6773
7783
 
6774
7784
  ```tsx
6775
7785
  <DemoContainer>
6776
- <Sidebar.Provider contained defaultOpen className="min-h-0! h-full">
7786
+ <Sidebar.Provider contained defaultOpen className="h-full min-h-0!">
6777
7787
  <Sidebar>
6778
7788
  <Sidebar.Header>
6779
7789
  <button
@@ -6781,7 +7791,7 @@ Props:
6781
7791
  onClick={() =>
6782
7792
  setSurface((s) => (s === "account" ? "zone" : "account"))
6783
7793
  }
6784
- 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"
7794
+ 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"
6785
7795
  >
6786
7796
  <ArrowsLeftRightIcon className="size-4 shrink-0 text-kumo-brand" />
6787
7797
  <span className="flex-1 text-left font-semibold text-kumo-strong">
@@ -6844,9 +7854,7 @@ Props:
6844
7854
  <p className="font-medium text-kumo-default">
6845
7855
  Active: {surface === "account" ? "Account" : "Zone"} surface
6846
7856
  </p>
6847
- <p>
6848
- Click the header button to slide between views
6849
- </p>
7857
+ <p>Click the header button to slide between views</p>
6850
7858
  </div>
6851
7859
  </DemoMain>
6852
7860
  </Sidebar.Provider>
@@ -6855,7 +7863,12 @@ Props:
6855
7863
 
6856
7864
  ```tsx
6857
7865
  <DemoContainer>
6858
- <Sidebar.Provider contained defaultOpen peekable className="min-h-0! h-full">
7866
+ <Sidebar.Provider
7867
+ contained
7868
+ defaultOpen
7869
+ peekable
7870
+ className="h-full min-h-0!"
7871
+ >
6859
7872
  <Sidebar>
6860
7873
  <Sidebar.Header>
6861
7874
  <AccountSwitcher />
@@ -6871,7 +7884,7 @@ Props:
6871
7884
  <Sidebar.MenuButton
6872
7885
  icon={MagnifyingGlassIcon}
6873
7886
  tooltip="Search"
6874
- 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)"
7887
+ 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"
6875
7888
  >
6876
7889
  Quick search&hellip;
6877
7890
  </Sidebar.MenuButton>
@@ -7037,9 +8050,7 @@ Props:
7037
8050
  <Sidebar.Group>
7038
8051
  <Sidebar.GroupLabel>Build</Sidebar.GroupLabel>
7039
8052
  <Sidebar.Menu>
7040
- <Sidebar.MenuButton icon={CodeIcon}>
7041
- Compute
7042
- </Sidebar.MenuButton>
8053
+ <Sidebar.MenuButton icon={CodeIcon}>Compute</Sidebar.MenuButton>
7043
8054
  <Sidebar.MenuButton icon={DatabaseIcon}>
7044
8055
  Storage
7045
8056
  </Sidebar.MenuButton>
@@ -7061,6 +8072,81 @@ Props:
7061
8072
  </div>
7062
8073
  ```
7063
8074
 
8075
+ ```tsx
8076
+ <div className="flex flex-col gap-3">
8077
+ {/* Width control — stands in for resizing a real phone viewport. */}
8078
+ <label className="flex items-center gap-3 text-sm text-kumo-subtle">
8079
+ <span className="shrink-0">Viewport</span>
8080
+ <input
8081
+ type="range"
8082
+ min={280}
8083
+ max={720}
8084
+ value={width}
8085
+ onChange={(e) => setWidth(Number(e.target.value))}
8086
+ className="flex-1 cursor-pointer"
8087
+ />
8088
+ <span className="w-14 shrink-0 text-right tabular-nums">{width}px</span>
8089
+ </label>
8090
+
8091
+ <div
8092
+ className="relative h-[540px] overflow-hidden rounded-lg border border-kumo-line bg-kumo-base"
8093
+ style={{ width }}
8094
+ >
8095
+ <Sidebar.Provider contained mobileBreakpoint={9999} className="h-full">
8096
+ <Sidebar fullScreenOnMobile>
8097
+ {/* Single row: avatar, then the trail takes the rest of the width.
8098
+ Mirrors the product header — account mark, then breadcrumbs. */}
8099
+ <Sidebar.Header className="gap-2 px-3.5">
8100
+ <CompactAccountSwitcher />
8101
+ <div className="min-w-0 flex-1">
8102
+ <Breadcrumbs size="sm">
8103
+ {trail.map((label) => (
8104
+ <Fragment key={label}>
8105
+ <Breadcrumbs.Link href="#">{label}</Breadcrumbs.Link>
8106
+ <Breadcrumbs.Separator />
8107
+ </Fragment>
8108
+ ))}
8109
+ <Breadcrumbs.Current>{current}</Breadcrumbs.Current>
8110
+ </Breadcrumbs>
8111
+ </div>
8112
+ <Sidebar.Close />
8113
+ </Sidebar.Header>
8114
+ <Sidebar.Content>
8115
+ <div className="pt-1 pb-2">
8116
+ <QuickSearch />
8117
+ </div>
8118
+ <NavTree selected={selected} onSelect={setSelected} />
8119
+ </Sidebar.Content>
8120
+ </Sidebar>
8121
+
8122
+ <div className="flex min-w-0 flex-1 flex-col">
8123
+ <header className="flex h-12 shrink-0 items-center gap-2 border-b border-kumo-line px-3">
8124
+ <Sidebar.Trigger />
8125
+ <div className="min-w-0 flex-1">
8126
+ <Breadcrumbs size="sm">
8127
+ {trail.map((label) => (
8128
+ <Fragment key={label}>
8129
+ <Breadcrumbs.Link href="#">{label}</Breadcrumbs.Link>
8130
+ <Breadcrumbs.Separator />
8131
+ </Fragment>
8132
+ ))}
8133
+ <Breadcrumbs.Current>{current}</Breadcrumbs.Current>
8134
+ </Breadcrumbs>
8135
+ </div>
8136
+ </header>
8137
+ <DemoMain>
8138
+ <p className="text-kumo-default">{current}</p>
8139
+ <p className="text-sm text-kumo-subtle">
8140
+ Drill into the nav — the trail is derived from the tree, so it
8141
+ always matches where you are.
8142
+ </p>
8143
+ </DemoMain>
8144
+ </div>
8145
+ </Sidebar.Provider>
8146
+ </div>
8147
+ </div>
8148
+ ```
8149
+
7064
8150
 
7065
8151
  ---
7066
8152
 
@@ -7146,21 +8232,21 @@ Item sub-component
7146
8232
  Group sub-component
7147
8233
 
7148
8234
  Props:
7149
- - `legend`: string
7150
- - `children`: ReactNode (required)
7151
- - `error`: string
7152
- - `description`: ReactNode
7153
- - `disabled`: boolean
7154
- - `controlFirst`: boolean
7155
- - `className`: string
8235
+ - `legend`: string - Legend text for the group. For more control over legend styling, omit this prop and use `<Switch.Legend>` as a child instead.
8236
+ - `children`: ReactNode (required) - Child Switch.Item components (and optionally a Switch.Legend)
8237
+ - `error`: string - Error message for the group (only appears in groups, not single switches)
8238
+ - `description`: ReactNode - Helper text for the group
8239
+ - `disabled`: boolean - Whether all switches in the group are disabled
8240
+ - `controlFirst`: boolean - When true (default), switch appears before label. When false, label appears before switch.
8241
+ - `className`: string - Additional CSS classes
7156
8242
 
7157
8243
  #### Switch.Legend
7158
8244
 
7159
8245
  Legend sub-component
7160
8246
 
7161
8247
  Props:
7162
- - `children`: ReactNode (required)
7163
- - `className`: string
8248
+ - `children`: ReactNode (required) - Legend content
8249
+ - `className`: string - Additional CSS classes (e.g. "sr-only" to visually hide the legend)
7164
8250
 
7165
8251
 
7166
8252
  **Examples:**
@@ -7518,12 +8604,8 @@ ResizeHandle sub-component
7518
8604
  <Table.Cell className="whitespace-nowrap">
7519
8605
  {row.subject}
7520
8606
  </Table.Cell>
7521
- <Table.Cell className="whitespace-nowrap">
7522
- {row.from}
7523
- </Table.Cell>
7524
- <Table.Cell className="whitespace-nowrap">
7525
- {row.date}
7526
- </Table.Cell>
8607
+ <Table.Cell className="whitespace-nowrap">{row.from}</Table.Cell>
8608
+ <Table.Cell className="whitespace-nowrap">{row.date}</Table.Cell>
7527
8609
  <Table.Cell className="whitespace-nowrap">
7528
8610
  {row.tags ? (
7529
8611
  <div className="inline-flex gap-1">
@@ -7588,12 +8670,8 @@ ResizeHandle sub-component
7588
8670
  <Table.Cell className="whitespace-nowrap">
7589
8671
  {row.subject}
7590
8672
  </Table.Cell>
7591
- <Table.Cell className="whitespace-nowrap">
7592
- {row.from}
7593
- </Table.Cell>
7594
- <Table.Cell className="whitespace-nowrap">
7595
- {row.date}
7596
- </Table.Cell>
8673
+ <Table.Cell className="whitespace-nowrap">{row.from}</Table.Cell>
8674
+ <Table.Cell className="whitespace-nowrap">{row.date}</Table.Cell>
7597
8675
  <Table.Cell className="whitespace-nowrap">
7598
8676
  {row.tags ? (
7599
8677
  <div className="inline-flex gap-1">
@@ -7770,16 +8848,17 @@ List sub-component
7770
8848
  Item sub-component
7771
8849
 
7772
8850
  Props:
7773
- - `active`: boolean
8851
+ - `active`: boolean - Whether this item represents the currently active section.
8852
+ - `render`: React.ReactElement - 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`.
7774
8853
 
7775
8854
  #### TableOfContents.Group
7776
8855
 
7777
8856
  Group sub-component
7778
8857
 
7779
8858
  Props:
7780
- - `label`: string (required)
7781
- - `href`: string
7782
- - `active`: boolean
8859
+ - `label`: string (required) - Label displayed above the group's items.
8860
+ - `href`: string - URL the group label links to. When provided, the label renders as a clickable link with item styling.
8861
+ - `active`: boolean - Whether this group's label represents the currently active section. Only applies when `href` is provided.
7783
8862
 
7784
8863
 
7785
8864
  **Examples:**
@@ -7875,6 +8954,56 @@ Props:
7875
8954
  </DemoWrapper>
7876
8955
  ```
7877
8956
 
8957
+ ```tsx
8958
+ <div className="flex w-full max-w-xl gap-6">
8959
+ <div className="min-w-40">
8960
+ <TableOfContents>
8961
+ <TableOfContents.Title>On this page</TableOfContents.Title>
8962
+ <TableOfContents.List>
8963
+ {scrollspySections.map((section) => (
8964
+ <TableOfContents.Item
8965
+ key={section.id}
8966
+ render={<button type="button" />}
8967
+ active={activeId === section.id}
8968
+ onClick={() => {
8969
+ selectSection(section.id);
8970
+ root
8971
+ ?.querySelector(`#${section.id}`)
8972
+ ?.scrollIntoView({ behavior: "smooth", block: "start" });
8973
+ }}
8974
+ >
8975
+ {section.title}
8976
+ </TableOfContents.Item>
8977
+ ))}
8978
+ </TableOfContents.List>
8979
+ </TableOfContents>
8980
+ </div>
8981
+ <div
8982
+ ref={setRoot}
8983
+ className="h-64 flex-1 overflow-y-auto rounded-lg border border-kumo-hairline p-4"
8984
+ >
8985
+ {scrollspySections.map((section) => (
8986
+ <section key={section.id}>
8987
+ <h4
8988
+ id={section.id}
8989
+ className="mb-2 scroll-mt-2 text-sm font-semibold"
8990
+ >
8991
+ {section.title}
8992
+ </h4>
8993
+ <p className="mb-6 text-sm text-kumo-subtle">
8994
+ {Array.from(
8995
+ { length: 6 },
8996
+ () =>
8997
+ `Scrollable placeholder copy for the ${section.title} section. `,
8998
+ ).join("")}
8999
+ </p>
9000
+ </section>
9001
+ ))}
9002
+ <div className="h-40" />
9003
+ </div>
9004
+ </div>
9005
+ ```
9006
+
7878
9007
  ```tsx
7879
9008
  <DemoWrapper>
7880
9009
  <div className="space-y-3">
@@ -7928,6 +9057,8 @@ Tab navigation component with segmented or underline style. Built on Base UI Tab
7928
9057
  Additional CSS classes for the tab list element.
7929
9058
  - `indicatorClassName`: string
7930
9059
  Additional CSS classes for the indicator element.
9060
+ - `labels`: TabsLabels
9061
+ Labels for internationalization of aria-labels. All labels have English defaults.
7931
9062
  - `variant`: enum [default: segmented]
7932
9063
  Tab style.
7933
9064
  - `"segmented"` — Pill-shaped indicator on a filled track
@@ -7941,7 +9072,7 @@ Tab navigation component with segmented or underline style. Built on Base UI Tab
7941
9072
 
7942
9073
  **Colors (kumo tokens used):**
7943
9074
 
7944
- `bg-kumo-base`, `bg-kumo-brand`, `bg-kumo-recessed`, `bg-kumo-tint`, `border-kumo-hairline`, `ring-kumo-brand`, `ring-kumo-focus`, `ring-kumo-hairline`, `ring-kumo-line`, `text-kumo-default`, `text-kumo-subtle`
9075
+ `bg-kumo-base`, `bg-kumo-brand`, `bg-kumo-elevated`, `bg-kumo-recessed`, `bg-kumo-tint`, `border-kumo-hairline`, `ring-kumo-brand`, `ring-kumo-focus`, `ring-kumo-hairline`, `ring-kumo-line`, `text-kumo-default`, `text-kumo-subtle`
7945
9076
 
7946
9077
  **Styling:**
7947
9078
 
@@ -8209,6 +9340,466 @@ Text component
8209
9340
  ```
8210
9341
 
8211
9342
 
9343
+ ---
9344
+
9345
+ ### TimeseriesChart
9346
+
9347
+ TimeseriesChart — a time-series line or bar chart.
9348
+
9349
+ **Type:** component
9350
+
9351
+ **Import:** `import { TimeseriesChart } from "@cloudflare/kumo";`
9352
+
9353
+ **Category:** Data Visualization
9354
+
9355
+ **Props:**
9356
+
9357
+ - `echarts`: typeof echarts (required)
9358
+ 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).
9359
+ - `type`: "line" | "bar"
9360
+ Visual style of each series. Defaults to `"line"`.
9361
+ - `data`: TimeseriesData[] (required)
9362
+ Array of time series data to display on the chart
9363
+ - `markers`: TimeseriesMarker[]
9364
+ Vertical reference markers rendered on the time axis.
9365
+ - `thresholds`: TimeseriesThreshold[]
9366
+ Horizontal threshold lines rendered on the value axis.
9367
+ - `xAxisName`: string
9368
+ Label for the x-axis (time axis)
9369
+ - `xAxisTickCount`: number
9370
+ Number of ticks to display on the x-axis
9371
+ - `xAxisTickFormat`: (value: number) => string
9372
+ Custom formatter for x-axis tick labels. Receives the raw timestamp in milliseconds and returns a display string, overriding ECharts' built-in time formatting.
9373
+ - `yAxisTickFormat`: (value: number) => string
9374
+ Custom formatter for y-axis tick labels. Receives the raw value and returns a display string. When omitted, ECharts' built-in formatter is used.
9375
+ - `yAxisTickLabelFormat`: (value: number) => string
9376
+ - `yAxisName`: string
9377
+ Label for the y-axis (value axis)
9378
+ - `yAxisTickCount`: number
9379
+ Number of ticks to display on the y-axis
9380
+ - `tooltipValueFormat`: (value: number) => string
9381
+ 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.
9382
+ - `tooltipMode`: "all" | "single"
9383
+ 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
9384
+ - `tooltipMaxItems`: number
9385
+ 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`.
9386
+ - `tooltipBoundary`: "clipping-ancestors" | Element | Element[]
9387
+ 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.
9388
+ - `tooltipFollowCursor`: "both" | "x"
9389
+ 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.
9390
+ - `incomplete`: { before?: number; after?: number }
9391
+ Indicates incomplete data periods with optional before/after timestamps in ms
9392
+ - `enableLegendSelection`: boolean
9393
+ 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.
9394
+ - `height`: number
9395
+ Height of the chart in pixels. Defaults to `350`.
9396
+ - `isDarkMode`: boolean
9397
+ When `true`, switches the chart to ECharts' built-in dark theme
9398
+ - `gradient`: boolean
9399
+ 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"`.
9400
+ - `loading`: boolean
9401
+ When `true`, hides the chart and displays a skeleton matching the chart type with a subtle shimmer.
9402
+ - `ariaDescription`: string
9403
+ 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.
9404
+ - `optionUpdateBehavior`: SetOptionOpts
9405
+ Additional options passed as the second argument to `chart.setOption()`. Defaults to `{ notMerge: false, lazyUpdate: true }`.
9406
+
9407
+ **Colors (kumo tokens used):**
9408
+
9409
+ `bg-kumo-base`, `outline-kumo-fill`
9410
+
9411
+ **Examples:**
9412
+
9413
+ ```tsx
9414
+ <Chart
9415
+ echarts={echarts}
9416
+ options={options}
9417
+ height={400}
9418
+ isDarkMode={isDarkMode}
9419
+ />
9420
+ ```
9421
+
9422
+ ```tsx
9423
+ <TimeseriesChart
9424
+ echarts={echarts}
9425
+ isDarkMode={isDarkMode}
9426
+ data={data}
9427
+ xAxisName="Time (UTC)"
9428
+ yAxisName="Count"
9429
+ />
9430
+ ```
9431
+
9432
+ ```tsx
9433
+ <TimeseriesChart
9434
+ echarts={echarts}
9435
+ isDarkMode={isDarkMode}
9436
+ data={data}
9437
+ markers={markers}
9438
+ xAxisName="Time (UTC)"
9439
+ yAxisName="Count"
9440
+ />
9441
+ ```
9442
+
9443
+ ```tsx
9444
+ <TimeseriesChart
9445
+ echarts={echarts}
9446
+ isDarkMode={isDarkMode}
9447
+ data={data}
9448
+ thresholds={[
9449
+ {
9450
+ value: 55,
9451
+ label: "Memory limit",
9452
+ color: ChartPalette.semantic("Attention", isDarkMode),
9453
+ },
9454
+ ]}
9455
+ xAxisName="Time (UTC)"
9456
+ yAxisName="Memory (MB)"
9457
+ />
9458
+ ```
9459
+
9460
+ ```tsx
9461
+ <TimeseriesChart
9462
+ echarts={echarts}
9463
+ isDarkMode={isDarkMode}
9464
+ data={data}
9465
+ xAxisName="Time (UTC)"
9466
+ yAxisName="Requests"
9467
+ xAxisTickFormat={(ts) => {
9468
+ const d = new Date(ts);
9469
+ return `${d.getHours().toString().padStart(2, "0")}:${d.getMinutes().toString().padStart(2, "0")}`;
9470
+ }}
9471
+ yAxisTickFormat={(value) => {
9472
+ if (value >= 1000) return `${value / 1000}k`;
9473
+ return value.toString();
9474
+ }}
9475
+ tooltipValueFormat={(value) => `${(value / 1000).toFixed(1)}k requests`}
9476
+ />
9477
+ ```
9478
+
9479
+ ```tsx
9480
+ <TimeseriesChart
9481
+ yAxisTickCount={2}
9482
+ echarts={echarts}
9483
+ isDarkMode={isDarkMode}
9484
+ data={data}
9485
+ height={160}
9486
+ />
9487
+ ```
9488
+
9489
+ ```tsx
9490
+ <TimeseriesChart
9491
+ echarts={echarts}
9492
+ isDarkMode={isDarkMode}
9493
+ data={data}
9494
+ xAxisName="Time (UTC)"
9495
+ yAxisName="Mbps"
9496
+ incomplete={{ after: incompleteTimestamp }}
9497
+ />
9498
+ ```
9499
+
9500
+ ```tsx
9501
+ <TimeseriesChart
9502
+ echarts={echarts}
9503
+ isDarkMode={isDarkMode}
9504
+ data={data}
9505
+ xAxisName="Time (UTC)"
9506
+ yAxisName="%"
9507
+ onTimeRangeChange={(from, to) => {
9508
+ alert(
9509
+ `Selected range:\nFrom: ${new Date(from).toLocaleString()}\nTo: ${new Date(to).toLocaleString()}`,
9510
+ );
9511
+ }}
9512
+ />
9513
+ ```
9514
+
9515
+ ```tsx
9516
+ <div className="space-y-4">
9517
+ <h3 className="text-sm font-medium">Active State</h3>
9518
+
9519
+ <div className="flex flex-wrap gap-4 divide-x divide-kumo-hairline">
9520
+ <ChartLegend.LargeItem
9521
+ name="Requests"
9522
+ color={ChartPalette.semantic("Neutral", isDarkMode)}
9523
+ value="1,234"
9524
+ unit="req/s"
9525
+ />
9526
+ <ChartLegend.LargeItem
9527
+ name="Storage"
9528
+ color={ChartPalette.semantic("Attention", isDarkMode)}
9529
+ value="56"
9530
+ unit="GB"
9531
+ />
9532
+ <ChartLegend.LargeItem
9533
+ name="Warnings"
9534
+ color={ChartPalette.semantic("Warning", isDarkMode)}
9535
+ value="128"
9536
+ />
9537
+ </div>
9538
+
9539
+ <h3 className="mt-12 text-sm font-medium">Inactive State</h3>
9540
+
9541
+ <div className="flex flex-wrap gap-4 divide-x divide-kumo-hairline">
9542
+ <ChartLegend.LargeItem
9543
+ name="Requests"
9544
+ color={ChartPalette.semantic("Neutral", isDarkMode)}
9545
+ value="1,234"
9546
+ unit="req/s"
9547
+ inactive
9548
+ />
9549
+ <ChartLegend.LargeItem
9550
+ name="Storage"
9551
+ color={ChartPalette.semantic("Attention", isDarkMode)}
9552
+ value="56"
9553
+ unit="GB"
9554
+ inactive
9555
+ />
9556
+ <ChartLegend.LargeItem
9557
+ name="Warnings"
9558
+ color={ChartPalette.semantic("Warning", isDarkMode)}
9559
+ value="128"
9560
+ inactive
9561
+ />
9562
+ </div>
9563
+
9564
+ <h3 className="mt-12 text-sm font-medium">Loading state</h3>
9565
+
9566
+ <div className="flex flex-wrap gap-4 divide-x divide-kumo-hairline">
9567
+ <ChartLegend.LargeItem loading />
9568
+ </div>
9569
+ </div>
9570
+ ```
9571
+
9572
+ ```tsx
9573
+ <TimeseriesChart
9574
+ echarts={echarts}
9575
+ isDarkMode={isDarkMode}
9576
+ type="bar"
9577
+ data={data}
9578
+ xAxisName="Time (UTC)"
9579
+ yAxisName="Count"
9580
+ tooltipValueFormat={(r) => r.toFixed(2)}
9581
+ />
9582
+ ```
9583
+
9584
+ ```tsx
9585
+ <div className="flex w-full flex-1 flex-col">
9586
+ <TimeseriesChart
9587
+ echarts={echarts}
9588
+ isDarkMode={isDarkMode}
9589
+ xAxisName="Time (UTC)"
9590
+ yAxisName="Count"
9591
+ data={[]}
9592
+ loading
9593
+ />
9594
+ </div>
9595
+ ```
9596
+
9597
+ ```tsx
9598
+ <div className="flex w-full flex-1 flex-col">
9599
+ <TimeseriesChart
9600
+ echarts={echarts}
9601
+ isDarkMode={isDarkMode}
9602
+ type="bar"
9603
+ xAxisName="Time (UTC)"
9604
+ yAxisName="Count"
9605
+ data={[]}
9606
+ loading
9607
+ />
9608
+ </div>
9609
+ ```
9610
+
9611
+ ```tsx
9612
+ <div className="flex w-full flex-1 flex-col gap-3">
9613
+ <div className="flex items-center justify-between">
9614
+ <div className="flex flex-wrap gap-4">
9615
+ {data.map((series) => (
9616
+ <ChartLegend.SmallItem
9617
+ loading={loading}
9618
+ key={series.name}
9619
+ name={series.name}
9620
+ color={series.color}
9621
+ value={Math.round(series.data.at(-1)?.[1] ?? 0).toLocaleString()}
9622
+ />
9623
+ ))}
9624
+ </div>
9625
+ <Switch
9626
+ label="Loading"
9627
+ checked={loading}
9628
+ onCheckedChange={setLoading}
9629
+ />
9630
+ </div>
9631
+ <TimeseriesChart
9632
+ echarts={echarts}
9633
+ isDarkMode={isDarkMode}
9634
+ xAxisName="Time (UTC)"
9635
+ yAxisName="Count"
9636
+ data={loading ? [] : data}
9637
+ loading={loading}
9638
+ />
9639
+ </div>
9640
+ ```
9641
+
9642
+ ```tsx
9643
+ <LayerCard>
9644
+ <LayerCard.Secondary>Read latency</LayerCard.Secondary>
9645
+ <LayerCard.Primary>
9646
+ <div className="mb-2 flex gap-4 divide-x divide-kumo-hairline px-2">
9647
+ <ChartLegend.LargeItem
9648
+ name="P99"
9649
+ color={ChartPalette.semantic("Attention", isDarkMode)}
9650
+ value="124"
9651
+ unit="ms"
9652
+ />
9653
+ <ChartLegend.LargeItem
9654
+ name="P95"
9655
+ color={ChartPalette.semantic("Warning", isDarkMode)}
9656
+ value="76"
9657
+ unit="ms"
9658
+ />
9659
+ <ChartLegend.LargeItem
9660
+ name="P75"
9661
+ color={ChartPalette.semantic("Neutral", isDarkMode)}
9662
+ value="32"
9663
+ unit="ms"
9664
+ />
9665
+ <ChartLegend.LargeItem
9666
+ name="P50"
9667
+ color={ChartPalette.semantic("Neutral", isDarkMode)}
9668
+ value="10"
9669
+ unit="ms"
9670
+ />
9671
+ </div>
9672
+ <TimeseriesChart
9673
+ xAxisName="Time (UTC)"
9674
+ echarts={echarts}
9675
+ isDarkMode={isDarkMode}
9676
+ data={data}
9677
+ height={300}
9678
+ />
9679
+ </LayerCard.Primary>
9680
+ </LayerCard>
9681
+ ```
9682
+
9683
+ ```tsx
9684
+ <LayerCard>
9685
+ <LayerCard.Secondary>Read latency</LayerCard.Secondary>
9686
+ <LayerCard.Primary>
9687
+ <div className="mb-2 flex divide-x divide-kumo-line px-2">
9688
+ {series.map((s) => (
9689
+ <ChartLegend.LargeItem
9690
+ key={s.name}
9691
+ name={s.name}
9692
+ color={s.color}
9693
+ value={s.value}
9694
+ unit={s.unit}
9695
+ inactive={hoveredSeries !== null && hoveredSeries !== s.name}
9696
+ onPointerEnter={() => {
9697
+ setHoveredSeries(s.name);
9698
+ chartRef.current?.dispatchAction({
9699
+ type: "highlight",
9700
+ seriesName: s.name,
9701
+ });
9702
+ }}
9703
+ onPointerLeave={() => {
9704
+ setHoveredSeries(null);
9705
+ chartRef.current?.dispatchAction({
9706
+ type: "downplay",
9707
+ seriesName: s.name,
9708
+ });
9709
+ }}
9710
+ className="not-first:pl-4"
9711
+ />
9712
+ ))}
9713
+ </div>
9714
+ <TimeseriesChart
9715
+ ref={chartRef}
9716
+ xAxisName="Time (UTC)"
9717
+ echarts={echarts}
9718
+ isDarkMode={isDarkMode}
9719
+ data={data}
9720
+ height={300}
9721
+ />
9722
+ </LayerCard.Primary>
9723
+ </LayerCard>
9724
+ ```
9725
+
9726
+ ```tsx
9727
+ <LayerCard>
9728
+ <LayerCard.Secondary>Read latency</LayerCard.Secondary>
9729
+ <LayerCard.Primary>
9730
+ <div className="mb-2 flex divide-x divide-kumo-line px-2">
9731
+ {series.map((s) => (
9732
+ <ChartLegend.LargeItem
9733
+ key={s.name}
9734
+ name={s.name}
9735
+ color={s.color}
9736
+ value={s.value}
9737
+ unit={s.unit}
9738
+ inactive={hiddenSeries[s.name] ?? false}
9739
+ onClick={() => handleClick(s.name)}
9740
+ className="not-first:pl-4"
9741
+ />
9742
+ ))}
9743
+ </div>
9744
+ <TimeseriesChart
9745
+ ref={chartRef}
9746
+ xAxisName="Time (UTC)"
9747
+ echarts={echarts}
9748
+ isDarkMode={isDarkMode}
9749
+ data={data}
9750
+ height={300}
9751
+ enableLegendSelection
9752
+ />
9753
+ </LayerCard.Primary>
9754
+ </LayerCard>
9755
+ ```
9756
+
9757
+ ```tsx
9758
+ <div className="flex w-full flex-col gap-4">
9759
+ <Select
9760
+ label="Tooltip follow cursor"
9761
+ value={selected}
9762
+ onValueChange={(v) => {
9763
+ if (v) setSelected(v);
9764
+ }}
9765
+ renderValue={(v) => v.label}
9766
+ >
9767
+ {FOLLOW_CURSOR_OPTIONS.map((opt) => (
9768
+ <Select.Option key={opt.value} value={opt}>
9769
+ {opt.label}
9770
+ </Select.Option>
9771
+ ))}
9772
+ </Select>
9773
+ <TimeseriesChart
9774
+ echarts={echarts}
9775
+ isDarkMode={isDarkMode}
9776
+ data={data}
9777
+ xAxisName="Time (UTC)"
9778
+ yAxisName="Latency (ms)"
9779
+ tooltipFollowCursor={selected.value}
9780
+ />
9781
+ </div>
9782
+ ```
9783
+
9784
+ ```tsx
9785
+ <div
9786
+ ref={boundaryRef}
9787
+ className="w-full overflow-auto rounded-lg border border-kumo-line"
9788
+ style={{ height: 300 }}
9789
+ >
9790
+ <TimeseriesChart
9791
+ echarts={echarts}
9792
+ isDarkMode={isDarkMode}
9793
+ data={data}
9794
+ xAxisName="Time (UTC)"
9795
+ yAxisName="Count"
9796
+ height={280}
9797
+ tooltipBoundary={boundary ?? undefined}
9798
+ />
9799
+ </div>
9800
+ ```
9801
+
9802
+
8212
9803
  ---
8213
9804
 
8214
9805
  ### Toasty
@@ -8229,10 +9820,12 @@ Toasty — toast notification provider and viewport.
8229
9820
  - `"error"`: Error toast for critical issues
8230
9821
  - `"warning"`: Warning toast for cautionary messages
8231
9822
  - `"info"`: Info toast for neutral informational messages
8232
- - `className`: string
8233
- Additional CSS classes
8234
- - `children`: ReactNode
8235
- Child elements
9823
+ - `children`: React.ReactNode (required)
9824
+ Application content. Toasts render via a portal above this.
9825
+ - `container`: PortalContainer
9826
+ Container element for the portal. Use this to render toasts inside a Shadow DOM or custom container. Overrides `KumoPortalProvider` context.
9827
+ - `toastManager`: ReturnType<typeof createKumoToastManager>
9828
+ 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.
8236
9829
 
8237
9830
  **Colors (kumo tokens used):**
8238
9831
 
@@ -8328,7 +9921,10 @@ InputGroup sub-component
8328
9921
  <div key={size} className="flex items-center gap-3">
8329
9922
  <span className="w-10 text-sm text-kumo-subtle">{size}</span>
8330
9923
  <Toolbar size={size} className="w-fit">
8331
- <Toolbar.Input aria-label={`${size} search`} placeholder="Search..." />
9924
+ <Toolbar.Input
9925
+ aria-label={`${size} search`}
9926
+ placeholder="Search..."
9927
+ />
8332
9928
  <Toolbar.Button>Apply</Toolbar.Button>
8333
9929
  </Toolbar>
8334
9930
  </div>
@@ -8355,7 +9951,11 @@ InputGroup sub-component
8355
9951
 
8356
9952
  ```tsx
8357
9953
  <Toolbar className="w-full max-w-lg">
8358
- <Toolbar.Input aria-label="Search records" className="flex-1" placeholder="Search" />
9954
+ <Toolbar.Input
9955
+ aria-label="Search records"
9956
+ className="flex-1"
9957
+ placeholder="Search"
9958
+ />
8359
9959
  <Toolbar.Button icon={MagnifyingGlassIcon} aria-label="Search" />
8360
9960
  </Toolbar>
8361
9961
  ```
@@ -8545,6 +10145,7 @@ Multi-line textarea input with Input variants and InputArea-specific dimensions
8545
10145
  - **Other:** Autocomplete, CloudflareLogo, DatePicker, Label, Link, SensitiveInput, Sidebar, Table, TableOfContents, Toolbar, DeleteResource
8546
10146
  - **Display:** Badge, Breadcrumbs, Code, Collapsible, Empty, LayerCard, Meter, Text
8547
10147
  - **Feedback:** Banner, Loader, Toasty
10148
+ - **Data Visualization:** BubbleMap, Chart, ChoroplethMap, SankeyChart, TimeseriesChart
8548
10149
  - **Action:** Button, ClipboardText
8549
10150
  - **Input:** Checkbox, Combobox, DateRangePicker, Field, Input, InputGroup, Radio, Select, Switch
8550
10151
  - **Navigation:** CommandPalette, MenuBar, Pagination, Tabs