@cloudflare/kumo 2.6.0 → 2.8.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 (264) hide show
  1. package/CHANGELOG.md +53 -0
  2. package/ai/component-registry.json +1182 -163
  3. package/ai/component-registry.md +1425 -119
  4. package/ai/schemas.ts +137 -8
  5. package/dist/.build-complete +1 -1
  6. package/dist/ai/schemas.d.ts +259 -22
  7. package/dist/ai/schemas.d.ts.map +1 -1
  8. package/dist/ai/schemas.js +1516 -1299
  9. package/dist/ai/schemas.js.map +1 -1
  10. package/dist/chunks/Maps-imwfwgb7do9lr3i5.js +2448 -0
  11. package/dist/chunks/Maps-imwfwgb7do9lr3i5.js.map +1 -0
  12. package/dist/chunks/{autocomplete-hgprlcuf0ixbbo6d.js → autocomplete-a4gvspveibfuod24.js} +5 -5
  13. package/dist/chunks/{autocomplete-hgprlcuf0ixbbo6d.js.map → autocomplete-a4gvspveibfuod24.js.map} +1 -1
  14. package/dist/chunks/{badge-c1th6h6ahz7eu49q.js → badge-dfc1r37osagi3rs4.js} +9 -9
  15. package/dist/chunks/{badge-c1th6h6ahz7eu49q.js.map → badge-dfc1r37osagi3rs4.js.map} +1 -1
  16. package/dist/chunks/{banner-es5iwuk4pf25e29e.js → banner-j52y8l13puk7dybi.js} +2 -2
  17. package/dist/chunks/{banner-es5iwuk4pf25e29e.js.map → banner-j52y8l13puk7dybi.js.map} +1 -1
  18. package/dist/chunks/{breadcrumbs-lyj8ljudrm2owx5y.js → breadcrumbs-js59m7m57bdsveew.js} +4 -4
  19. package/dist/chunks/{breadcrumbs-lyj8ljudrm2owx5y.js.map → breadcrumbs-js59m7m57bdsveew.js.map} +1 -1
  20. package/dist/chunks/{button-gtdhvogt5rlrf1is.js → button-ebfdg9mkhojue36n.js} +80 -80
  21. package/dist/chunks/button-ebfdg9mkhojue36n.js.map +1 -0
  22. package/dist/chunks/{checkbox-byg8t8r9vbmif696.js → checkbox-k355pnfisqt0h4eg.js} +4 -4
  23. package/dist/chunks/{checkbox-byg8t8r9vbmif696.js.map → checkbox-k355pnfisqt0h4eg.js.map} +1 -1
  24. package/dist/chunks/{clipboard-text-lf909phvldd8rfk8.js → clipboard-text-isb05zkg2aox0tp6.js} +5 -5
  25. package/dist/chunks/{clipboard-text-lf909phvldd8rfk8.js.map → clipboard-text-isb05zkg2aox0tp6.js.map} +1 -1
  26. package/dist/chunks/{cloudflare-logo-fya2cd2ljozkzjh8.js → cloudflare-logo-fiuocxdxqrxawjfv.js} +2 -2
  27. package/dist/chunks/{cloudflare-logo-fya2cd2ljozkzjh8.js.map → cloudflare-logo-fiuocxdxqrxawjfv.js.map} +1 -1
  28. package/dist/chunks/{cn-ct4n7r74mh8y0f48.js → cn-bo7ya7641lkickbt.js} +6 -10
  29. package/dist/chunks/cn-bo7ya7641lkickbt.js.map +1 -0
  30. package/dist/chunks/{code-bbnjm8vk9hxl129r.js → code-pbkfdfat0yilg6dx.js} +2 -2
  31. package/dist/chunks/{code-bbnjm8vk9hxl129r.js.map → code-pbkfdfat0yilg6dx.js.map} +1 -1
  32. package/dist/chunks/{collapsible-dl61f8gd4j897hmv.js → collapsible-f9hgtc1u6xvqrgt8.js} +3 -3
  33. package/dist/chunks/{collapsible-dl61f8gd4j897hmv.js.map → collapsible-f9hgtc1u6xvqrgt8.js.map} +1 -1
  34. package/dist/chunks/{combobox-dxff22zxzq846nec.js → combobox-hc9wi9nwsyyli8ur.js} +5 -5
  35. package/dist/chunks/{combobox-dxff22zxzq846nec.js.map → combobox-hc9wi9nwsyyli8ur.js.map} +1 -1
  36. package/dist/chunks/{command-palette-i4r0402b838wiy0j.js → command-palette-c03zze4ayuytwxjg.js} +4 -4
  37. package/dist/chunks/{command-palette-i4r0402b838wiy0j.js.map → command-palette-c03zze4ayuytwxjg.js.map} +1 -1
  38. package/dist/chunks/{date-picker-mjocqqbggb76n8rt.js → date-picker-bffp889exjixmgz3.js} +8 -8
  39. package/dist/chunks/{date-picker-mjocqqbggb76n8rt.js.map → date-picker-bffp889exjixmgz3.js.map} +1 -1
  40. package/dist/chunks/{date-range-picker-o8uyril1kogvhoei.js → date-range-picker-oks2r14lbbukd545.js} +2 -2
  41. package/dist/chunks/{date-range-picker-o8uyril1kogvhoei.js.map → date-range-picker-oks2r14lbbukd545.js.map} +1 -1
  42. package/dist/chunks/{dialog-g1b8161nbyixdit0.js → dialog-ovhmzfuppr5xix0e.js} +15 -15
  43. package/dist/chunks/dialog-ovhmzfuppr5xix0e.js.map +1 -0
  44. package/dist/chunks/{dropdown-irp18txvgz8590e9.js → dropdown-iey8f344rd5dgahz.js} +24 -16
  45. package/dist/chunks/dropdown-iey8f344rd5dgahz.js.map +1 -0
  46. package/dist/chunks/{empty-daa6d7u9oleaw24a.js → empty-k83r53jh5utqvv7w.js} +3 -3
  47. package/dist/chunks/{empty-daa6d7u9oleaw24a.js.map → empty-k83r53jh5utqvv7w.js.map} +1 -1
  48. package/dist/chunks/{field-f1hy08um3jf9jos6.js → field-bmglk138wa8bf3ei.js} +4 -4
  49. package/dist/chunks/{field-f1hy08um3jf9jos6.js.map → field-bmglk138wa8bf3ei.js.map} +1 -1
  50. package/dist/chunks/{grid-do93dv1rjggqxx7p.js → grid-jze04557ljywg3uc.js} +2 -2
  51. package/dist/chunks/{grid-do93dv1rjggqxx7p.js.map → grid-jze04557ljywg3uc.js.map} +1 -1
  52. package/dist/chunks/input-area-sg518xu4pyg4m0km.js +144 -0
  53. package/dist/chunks/input-area-sg518xu4pyg4m0km.js.map +1 -0
  54. package/dist/chunks/{input-f2ct7obgdzypjmp2.js → input-ckl5misj0jd9cu5r.js} +4 -4
  55. package/dist/chunks/{input-f2ct7obgdzypjmp2.js.map → input-ckl5misj0jd9cu5r.js.map} +1 -1
  56. package/dist/chunks/{input-group-kcd3jin5pbdijmw8.js → input-group-bflx1m6ki55e99vf.js} +6 -6
  57. package/dist/chunks/{input-group-kcd3jin5pbdijmw8.js.map → input-group-bflx1m6ki55e99vf.js.map} +1 -1
  58. package/dist/chunks/{label-himqjkdhh0hgfdsa.js → label-i1xbmg8y1n0tbtkx.js} +4 -4
  59. package/dist/chunks/{label-himqjkdhh0hgfdsa.js.map → label-i1xbmg8y1n0tbtkx.js.map} +1 -1
  60. package/dist/chunks/{layer-card-cshi5vydqg3phyfx.js → layer-card-m6h85dpadvee39h2.js} +3 -3
  61. package/dist/chunks/{layer-card-cshi5vydqg3phyfx.js.map → layer-card-m6h85dpadvee39h2.js.map} +1 -1
  62. package/dist/chunks/{link-bw21ofmgg58igq5n.js → link-j93fl5m8zrcfivsr.js} +3 -3
  63. package/dist/chunks/{link-bw21ofmgg58igq5n.js.map → link-j93fl5m8zrcfivsr.js.map} +1 -1
  64. package/dist/chunks/{menubar-m12wcbbucuszspw4.js → menubar-opzxfzylaatfz4nv.js} +8 -8
  65. package/dist/chunks/{menubar-m12wcbbucuszspw4.js.map → menubar-opzxfzylaatfz4nv.js.map} +1 -1
  66. package/dist/chunks/{meter-dn8vgc0smpk0du75.js → meter-6br6z5ekw41trxeh.js} +3 -3
  67. package/dist/chunks/{meter-dn8vgc0smpk0du75.js.map → meter-6br6z5ekw41trxeh.js.map} +1 -1
  68. package/dist/chunks/{pagination-oafyxvdndm9m8250.js → pagination-j33ntwqmm9qskfgv.js} +4 -4
  69. package/dist/chunks/{pagination-oafyxvdndm9m8250.js.map → pagination-j33ntwqmm9qskfgv.js.map} +1 -1
  70. package/dist/chunks/{popover-bbxr39l1lx175hum.js → popover-cqdmpp8i4hg8gzzx.js} +3 -3
  71. package/dist/chunks/{popover-bbxr39l1lx175hum.js.map → popover-cqdmpp8i4hg8gzzx.js.map} +1 -1
  72. package/dist/chunks/{radio-ffx05ih9nc764evh.js → radio-ejey7i6r4tq314av.js} +3 -3
  73. package/dist/chunks/{radio-ffx05ih9nc764evh.js.map → radio-ejey7i6r4tq314av.js.map} +1 -1
  74. package/dist/chunks/{select-kl1skfh3pmwc33rp.js → select-p8adn2tnpom25hpl.js} +8 -8
  75. package/dist/chunks/{select-kl1skfh3pmwc33rp.js.map → select-p8adn2tnpom25hpl.js.map} +1 -1
  76. package/dist/chunks/{sensitive-input-izmbyk1t7r56ciiq.js → sensitive-input-it1hsswlccq3u7g6.js} +5 -5
  77. package/dist/chunks/{sensitive-input-izmbyk1t7r56ciiq.js.map → sensitive-input-it1hsswlccq3u7g6.js.map} +1 -1
  78. package/dist/chunks/{sidebar-ior8rnhsd7gy5am5.js → sidebar-7whsl7qwrw5b6ip8.js} +307 -307
  79. package/dist/chunks/sidebar-7whsl7qwrw5b6ip8.js.map +1 -0
  80. package/dist/chunks/{skeleton-line-epxenksfesr2fkcv.js → skeleton-line-omxgxia23vpav94x.js} +2 -2
  81. package/dist/chunks/{skeleton-line-epxenksfesr2fkcv.js.map → skeleton-line-omxgxia23vpav94x.js.map} +1 -1
  82. package/dist/chunks/{surface-g5a1buofz4erjov2.js → surface-gc2gblserrxcb1eg.js} +5 -5
  83. package/dist/chunks/{surface-g5a1buofz4erjov2.js.map → surface-gc2gblserrxcb1eg.js.map} +1 -1
  84. package/dist/chunks/{switch-kh8a6l3l0hszm9h4.js → switch-ljsq915e0l1a5mjd.js} +4 -4
  85. package/dist/chunks/{switch-kh8a6l3l0hszm9h4.js.map → switch-ljsq915e0l1a5mjd.js.map} +1 -1
  86. package/dist/chunks/{table-of-contents-jco9kvt48d34dwsw.js → table-of-contents-cghjqyk43nj5zmlw.js} +2 -2
  87. package/dist/chunks/{table-of-contents-jco9kvt48d34dwsw.js.map → table-of-contents-cghjqyk43nj5zmlw.js.map} +1 -1
  88. package/dist/chunks/{table-dz2k55oab66h2vi9.js → table-ojjjeqszmt9jgnug.js} +3 -3
  89. package/dist/chunks/{table-dz2k55oab66h2vi9.js.map → table-ojjjeqszmt9jgnug.js.map} +1 -1
  90. package/dist/chunks/{tabs-kcw98wibdz4mhpkc.js → tabs-kemdy19kfesj2xjr.js} +3 -3
  91. package/dist/chunks/{tabs-kcw98wibdz4mhpkc.js.map → tabs-kemdy19kfesj2xjr.js.map} +1 -1
  92. package/dist/chunks/{text-be7ehenoyldhyjma.js → text-oqp48b9m5u6t62b4.js} +2 -2
  93. package/dist/chunks/{text-be7ehenoyldhyjma.js.map → text-oqp48b9m5u6t62b4.js.map} +1 -1
  94. package/dist/chunks/{toast-dkdo1lu72tnefya6.js → toast-ldj9zi940w83ub90.js} +97 -81
  95. package/dist/chunks/toast-ldj9zi940w83ub90.js.map +1 -0
  96. package/dist/chunks/{toolbar-o7xe6pd189evdd53.js → toolbar-lmylyrod70sn0q4i.js} +6 -6
  97. package/dist/chunks/{toolbar-o7xe6pd189evdd53.js.map → toolbar-lmylyrod70sn0q4i.js.map} +1 -1
  98. package/dist/chunks/{tooltip-eqnhjdbvwapy8gj4.js → tooltip-mooldq78tg77ekvv.js} +4 -4
  99. package/dist/chunks/tooltip-mooldq78tg77ekvv.js.map +1 -0
  100. package/dist/chunks/vendor-base-ui-elpbzr8xeffrz4h2.js +25027 -0
  101. package/dist/chunks/vendor-base-ui-elpbzr8xeffrz4h2.js.map +1 -0
  102. package/dist/chunks/{vendor-floating-ui-c4mwmh0xmfzevy9l.js → vendor-floating-ui-k1zjlb8fkwtcw4k5.js} +22 -23
  103. package/dist/chunks/{vendor-floating-ui-c4mwmh0xmfzevy9l.js.map → vendor-floating-ui-k1zjlb8fkwtcw4k5.js.map} +1 -1
  104. package/dist/chunks/vendor-styling-ofvnbcuht98q88oo.js +3252 -0
  105. package/dist/chunks/vendor-styling-ofvnbcuht98q88oo.js.map +1 -0
  106. package/dist/code.js +2 -2
  107. package/dist/components/autocomplete.js +1 -1
  108. package/dist/components/badge.js +1 -1
  109. package/dist/components/banner.js +1 -1
  110. package/dist/components/breadcrumbs.js +1 -1
  111. package/dist/components/button.js +1 -1
  112. package/dist/components/chart.js +6 -4
  113. package/dist/components/checkbox.js +1 -1
  114. package/dist/components/clipboard-text.js +1 -1
  115. package/dist/components/cloudflare-logo.js +1 -1
  116. package/dist/components/code.js +1 -1
  117. package/dist/components/collapsible.js +1 -1
  118. package/dist/components/combobox.js +1 -1
  119. package/dist/components/command-palette.js +1 -1
  120. package/dist/components/date-picker.js +1 -1
  121. package/dist/components/date-range-picker.js +1 -1
  122. package/dist/components/dialog.js +1 -1
  123. package/dist/components/dropdown.js +1 -1
  124. package/dist/components/empty.js +1 -1
  125. package/dist/components/field.js +1 -1
  126. package/dist/components/flow.js +2277 -2312
  127. package/dist/components/flow.js.map +1 -1
  128. package/dist/components/grid.js +1 -1
  129. package/dist/components/input-group.js +1 -1
  130. package/dist/components/input.js +3 -3
  131. package/dist/components/label.js +1 -1
  132. package/dist/components/layer-card.js +1 -1
  133. package/dist/components/link.js +1 -1
  134. package/dist/components/loader.js +1 -1
  135. package/dist/components/menubar.js +1 -1
  136. package/dist/components/meter.js +1 -1
  137. package/dist/components/pagination.js +1 -1
  138. package/dist/components/popover.js +1 -1
  139. package/dist/components/radio.js +1 -1
  140. package/dist/components/select.js +1 -1
  141. package/dist/components/sensitive-input.js +1 -1
  142. package/dist/components/sidebar.js +1 -1
  143. package/dist/components/surface.js +1 -1
  144. package/dist/components/switch.js +1 -1
  145. package/dist/components/table-of-contents.js +1 -1
  146. package/dist/components/table.js +1 -1
  147. package/dist/components/tabs.js +1 -1
  148. package/dist/components/text.js +1 -1
  149. package/dist/components/toast.js +2 -2
  150. package/dist/components/toolbar.js +1 -1
  151. package/dist/components/tooltip.js +1 -1
  152. package/dist/index.js +128 -126
  153. package/dist/primitives/accordion.js +1 -1
  154. package/dist/primitives/alert-dialog.js +1 -1
  155. package/dist/primitives/autocomplete.js +1 -1
  156. package/dist/primitives/avatar.js +1 -1
  157. package/dist/primitives/button.js +1 -1
  158. package/dist/primitives/checkbox-group.js +1 -1
  159. package/dist/primitives/checkbox.js +1 -1
  160. package/dist/primitives/collapsible.js +1 -1
  161. package/dist/primitives/combobox.js +1 -1
  162. package/dist/primitives/context-menu.js +1 -1
  163. package/dist/primitives/csp-provider.js +1 -1
  164. package/dist/primitives/dialog.js +1 -1
  165. package/dist/primitives/direction-provider.js +1 -1
  166. package/dist/primitives/drawer.js +1 -1
  167. package/dist/primitives/field.js +1 -1
  168. package/dist/primitives/fieldset.js +1 -1
  169. package/dist/primitives/form.js +1 -1
  170. package/dist/primitives/input.js +1 -1
  171. package/dist/primitives/menu.js +1 -1
  172. package/dist/primitives/menubar.js +1 -1
  173. package/dist/primitives/meter.js +1 -1
  174. package/dist/primitives/navigation-menu.js +1 -1
  175. package/dist/primitives/number-field.js +1 -1
  176. package/dist/primitives/otp-field.js +3 -2
  177. package/dist/primitives/popover.js +1 -1
  178. package/dist/primitives/preview-card.js +1 -1
  179. package/dist/primitives/progress.js +1 -1
  180. package/dist/primitives/radio-group.js +1 -1
  181. package/dist/primitives/radio.js +1 -1
  182. package/dist/primitives/scroll-area.js +1 -1
  183. package/dist/primitives/select.js +1 -1
  184. package/dist/primitives/separator.js +1 -1
  185. package/dist/primitives/slider.js +1 -1
  186. package/dist/primitives/switch.js +1 -1
  187. package/dist/primitives/tabs.js +1 -1
  188. package/dist/primitives/toast.js +1 -1
  189. package/dist/primitives/toggle-group.js +1 -1
  190. package/dist/primitives/toggle.js +1 -1
  191. package/dist/primitives/toolbar.js +1 -1
  192. package/dist/primitives/tooltip.js +1 -1
  193. package/dist/primitives.js +27 -26
  194. package/dist/src/components/button/button.d.ts +2 -2
  195. package/dist/src/components/chart/Color.d.ts +16 -0
  196. package/dist/src/components/chart/Color.d.ts.map +1 -1
  197. package/dist/src/components/chart/EChart.d.ts +7 -0
  198. package/dist/src/components/chart/EChart.d.ts.map +1 -1
  199. package/dist/src/components/chart/Maps.d.ts +211 -0
  200. package/dist/src/components/chart/Maps.d.ts.map +1 -0
  201. package/dist/src/components/chart/SankeyChart.d.ts.map +1 -1
  202. package/dist/src/components/chart/TimeseriesChart.d.ts +8 -0
  203. package/dist/src/components/chart/TimeseriesChart.d.ts.map +1 -1
  204. package/dist/src/components/chart/index.d.ts +2 -1
  205. package/dist/src/components/chart/index.d.ts.map +1 -1
  206. package/dist/src/components/chart/timeseries-markers.d.ts +107 -0
  207. package/dist/src/components/chart/timeseries-markers.d.ts.map +1 -0
  208. package/dist/src/components/chart/timeseries-thresholds.d.ts +61 -0
  209. package/dist/src/components/chart/timeseries-thresholds.d.ts.map +1 -0
  210. package/dist/src/components/chart/timeseries-tooltip.d.ts +28 -0
  211. package/dist/src/components/chart/timeseries-tooltip.d.ts.map +1 -0
  212. package/dist/src/components/chart/tooltip-utils.d.ts +4 -0
  213. package/dist/src/components/chart/tooltip-utils.d.ts.map +1 -0
  214. package/dist/src/components/dialog/dialog.d.ts +12 -12
  215. package/dist/src/components/dropdown/dropdown.d.ts.map +1 -1
  216. package/dist/src/components/flow/connectors.d.ts +18 -0
  217. package/dist/src/components/flow/connectors.d.ts.map +1 -1
  218. package/dist/src/components/flow/diagram.d.ts +48 -39
  219. package/dist/src/components/flow/diagram.d.ts.map +1 -1
  220. package/dist/src/components/flow/flow-layout.d.ts +77 -0
  221. package/dist/src/components/flow/flow-layout.d.ts.map +1 -0
  222. package/dist/src/components/flow/node.d.ts.map +1 -1
  223. package/dist/src/components/flow/parallel.d.ts +3 -7
  224. package/dist/src/components/flow/parallel.d.ts.map +1 -1
  225. package/dist/src/components/flow/use-children.d.ts +0 -60
  226. package/dist/src/components/flow/use-children.d.ts.map +1 -1
  227. package/dist/src/components/input/input-area.d.ts +18 -0
  228. package/dist/src/components/input/input-area.d.ts.map +1 -1
  229. package/dist/src/components/sidebar/sidebar.d.ts +2 -0
  230. package/dist/src/components/sidebar/sidebar.d.ts.map +1 -1
  231. package/dist/src/components/toast/toast.d.ts +2 -2
  232. package/dist/src/components/toast/toast.d.ts.map +1 -1
  233. package/dist/src/index.d.ts +1 -1
  234. package/dist/src/index.d.ts.map +1 -1
  235. package/dist/src/primitives/index.d.ts +1 -0
  236. package/dist/src/primitives/index.d.ts.map +1 -1
  237. package/dist/src/primitives/otp-field.d.ts +1 -0
  238. package/dist/src/primitives/otp-field.d.ts.map +1 -1
  239. package/dist/src/utils/cn.d.ts +1 -2
  240. package/dist/src/utils/cn.d.ts.map +1 -1
  241. package/dist/styles/kumo-standalone.css +1 -1
  242. package/dist/utils.js +8 -7
  243. package/dist/utils.js.map +1 -1
  244. package/package.json +6 -5
  245. package/scripts/component-registry/discovery.ts +87 -0
  246. package/scripts/component-registry/index.test.ts +89 -1
  247. package/scripts/component-registry/index.ts +27 -2
  248. package/scripts/component-registry/sub-components.ts +34 -21
  249. package/scripts/generate-primitives.ts +9 -0
  250. package/dist/chunks/SankeyChart-g1tng405ml2e0qg2.js +0 -890
  251. package/dist/chunks/SankeyChart-g1tng405ml2e0qg2.js.map +0 -1
  252. package/dist/chunks/button-gtdhvogt5rlrf1is.js.map +0 -1
  253. package/dist/chunks/cn-ct4n7r74mh8y0f48.js.map +0 -1
  254. package/dist/chunks/dialog-g1b8161nbyixdit0.js.map +0 -1
  255. package/dist/chunks/dropdown-irp18txvgz8590e9.js.map +0 -1
  256. package/dist/chunks/input-area-bwyujceeulpfkpxv.js +0 -78
  257. package/dist/chunks/input-area-bwyujceeulpfkpxv.js.map +0 -1
  258. package/dist/chunks/sidebar-ior8rnhsd7gy5am5.js.map +0 -1
  259. package/dist/chunks/toast-dkdo1lu72tnefya6.js.map +0 -1
  260. package/dist/chunks/tooltip-eqnhjdbvwapy8gj4.js.map +0 -1
  261. package/dist/chunks/vendor-base-ui-f9z44m829vvptrg0.js +0 -24712
  262. package/dist/chunks/vendor-base-ui-f9z44m829vvptrg0.js.map +0 -1
  263. package/dist/chunks/vendor-styling-gobnkhsy0rva4qd3.js +0 -2775
  264. package/dist/chunks/vendor-styling-gobnkhsy0rva4qd3.js.map +0 -1
@@ -596,6 +596,120 @@ Props:
596
596
  ```
597
597
 
598
598
 
599
+ ---
600
+
601
+ ### BubbleMap
602
+
603
+ BubbleMap component
604
+
605
+ **Type:** component
606
+
607
+ **Import:** `import { BubbleMap } from "@cloudflare/kumo";`
608
+
609
+ **Category:** Data Visualization
610
+
611
+ **Props:**
612
+
613
+ - `echarts`: typeof echarts (required)
614
+ The ECharts core instance imported by the consumer (passed in for tree-shaking). Requires `MapChart`, `ScatterChart`, `TooltipComponent`, and a renderer registered via `echarts.use([...])`.
615
+ - `geoJson`: MapGeoJson (required)
616
+ GeoJSON `FeatureCollection` for the land base.
617
+ - `mapName`: string
618
+ 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.
619
+ - `data`: T[] (required)
620
+ Raw data rows. Coordinates/value/name are read via the accessors below.
621
+ - `lng`: MapAccessor<T, number> (required)
622
+ Longitude accessor (key of `T` or `(row) => number`).
623
+ - `lat`: MapAccessor<T, number> (required)
624
+ Latitude accessor (key of `T` or `(row) => number`).
625
+ - `value`: MapAccessor<T, number> (required)
626
+ Value accessor — drives bubble size.
627
+ - `name`: MapAccessor<T, string>
628
+ Optional name accessor — used by the default tooltip.
629
+ - `minRadius`: number
630
+ Smallest bubble radius in px. Default: `6`.
631
+ - `maxRadius`: number
632
+ Largest bubble radius in px. Default: `26`.
633
+ - `bubbleSize`: (value: number) => number
634
+ Explicit bubble radius `(value) => px`. Overrides the default `minRadius`/`maxRadius` scaling.
635
+ - `bubbleColor`: MapStyle<T, string>
636
+ Bubble fill colour — constant or `(row) => color`. Defaults to the chart blue.
637
+ - `bubbleBorderColor`: MapStyle<T, string>
638
+ Bubble border colour — constant or `(row) => color`. Default: `transparent`.
639
+ - `bubbleBorderWidth`: MapStyle<T, number>
640
+ Bubble border width — constant or `(row) => px`. Default: `0`.
641
+ - `center`: [number, number]
642
+ Map center as `[longitude, latitude]`. Defaults to auto-fit.
643
+ - `zoom`: number
644
+ Zoom level — multiplies the auto-fit scale. Default: `1.25`.
645
+ - `roam`: boolean
646
+ Enable drag-to-pan and scroll-to-zoom. Default: `false`.
647
+ - `projection`: MapProjection | null
648
+ 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.
649
+ - `showTooltip`: boolean
650
+ Show the tooltip. Default: `true`.
651
+ - `valueFormat`: (value: number) => string
652
+ Format the value for the default tooltip. Default: `toLocaleString()`.
653
+ - `tooltipFormatter`: (row: T) => string
654
+ 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.
655
+ - `aspectRatio`: number | string
656
+ 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.
657
+ - `height`: number
658
+ Fixed chart height in pixels. Overrides `aspectRatio` when set. Leave unset to size by aspect ratio (the default) so the map fills the container.
659
+ - `className`: string
660
+ - `isDarkMode`: boolean
661
+
662
+ **Examples:**
663
+
664
+ ```tsx
665
+ <BubbleMap<CfLocation>
666
+ echarts={echarts}
667
+ geoJson={geoJson}
668
+ data={cloudflareLocations}
669
+ lng="lon"
670
+ lat="lat"
671
+ name="city"
672
+ value={() => 1}
673
+ bubbleColor="#F6821F"
674
+ minRadius={8}
675
+ maxRadius={8}
676
+ tooltipFormatter={(row) =>
677
+ `<span style="font-size:12px"><strong>${row.city}</strong><span style="color:var(--text-color-kumo-subtle);margin-left:8px">${row.iata}</span></span>`
678
+ }
679
+ isDarkMode={isDarkMode}
680
+ />
681
+ ```
682
+
683
+ ```tsx
684
+ <BubbleMap<Colo>
685
+ echarts={echarts}
686
+ geoJson={geoJson}
687
+ data={colos}
688
+ lng="lon"
689
+ lat="lat"
690
+ name="city"
691
+ value="requests"
692
+ valueFormat={fmt}
693
+ minRadius={8}
694
+ isDarkMode={isDarkMode}
695
+ />
696
+ ```
697
+
698
+ ```tsx
699
+ <BubbleMap<Colo>
700
+ echarts={echarts}
701
+ geoJson={geoJson}
702
+ data={colos2}
703
+ lng="lon"
704
+ lat="lat"
705
+ name="city"
706
+ value="requests"
707
+ valueFormat={fmt}
708
+ isDarkMode={isDarkMode}
709
+ />
710
+ ```
711
+
712
+
599
713
  ---
600
714
 
601
715
  ### Button
@@ -629,6 +743,8 @@ Primary action trigger. Supports multiple variants, sizes, shapes, icons, and lo
629
743
 
630
744
  **State Classes:**
631
745
  - `"primary"`:
746
+ - `focus`: `focus:ring-(--kumo-button-emphasis-ring) focus-visible:ring-(--kumo-button-emphasis-ring)`
747
+ - `active`: `active:ring-(--kumo-button-emphasis-ring)`
632
748
  - `disabled`: `disabled:opacity-50`
633
749
  - `"secondary"`:
634
750
  - `not-disabled`: `not-disabled:hover:bg-kumo-tint`
@@ -637,6 +753,8 @@ Primary action trigger. Supports multiple variants, sizes, shapes, icons, and lo
637
753
  - `"ghost"`:
638
754
  - `hover`: `hover:bg-kumo-tint`
639
755
  - `"destructive"`:
756
+ - `focus`: `focus:ring-(--kumo-button-emphasis-ring) focus-visible:ring-(--kumo-button-emphasis-ring)`
757
+ - `active`: `active:ring-(--kumo-button-emphasis-ring)`
640
758
  - `disabled`: `disabled:opacity-50`
641
759
  - `"secondary-destructive"`:
642
760
  - `not-disabled`: `not-disabled:hover:!text-kumo-danger not-disabled:hover:ring-kumo-danger/30`
@@ -736,6 +854,376 @@ Primary action trigger. Supports multiple variants, sizes, shapes, icons, and lo
736
854
  ```
737
855
 
738
856
 
857
+ ---
858
+
859
+ ### Chart
860
+
861
+ Chart — a low-level wrapper around [Apache ECharts](https://echarts.apache.org).
862
+
863
+ **Type:** component
864
+
865
+ **Import:** `import { Chart } from "@cloudflare/kumo";`
866
+
867
+ **Category:** Data Visualization
868
+
869
+ **Props:**
870
+
871
+ - `echarts`: typeof echarts (required)
872
+ 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).
873
+ - `options`: KumoChartOption (required)
874
+ ECharts option object — passed through to `chart.setOption()`
875
+ - `optionUpdateBehavior`: SetOptionOpts
876
+ Additional options passed as the second argument to `chart.setOption()`. Defaults to `{ notMerge: false, lazyUpdate: true }`.
877
+ - `className`: string
878
+ Additional CSS classes applied to the chart container `<div>`
879
+ - `isDarkMode`: boolean
880
+ When `true`, initialises ECharts with its built-in dark theme. Changing this value after mount destroys and re-creates the chart instance.
881
+ - `height`: number
882
+ Height of the chart container in pixels. Defaults to `350`.
883
+ - `aspectRatio`: number | string
884
+ 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.
885
+
886
+ **Examples:**
887
+
888
+ ```tsx
889
+ <Chart
890
+ echarts={echarts}
891
+ options={options}
892
+ height={400}
893
+ isDarkMode={isDarkMode}
894
+ />
895
+ ```
896
+
897
+ ```tsx
898
+ <TimeseriesChart
899
+ echarts={echarts}
900
+ isDarkMode={isDarkMode}
901
+ data={data}
902
+ xAxisName="Time (UTC)"
903
+ yAxisName="Count"
904
+ />
905
+ ```
906
+
907
+ ```tsx
908
+ <TimeseriesChart
909
+ echarts={echarts}
910
+ isDarkMode={isDarkMode}
911
+ data={data}
912
+ markers={markers}
913
+ xAxisName="Time (UTC)"
914
+ yAxisName="Count"
915
+ />
916
+ ```
917
+
918
+ ```tsx
919
+ <TimeseriesChart
920
+ echarts={echarts}
921
+ isDarkMode={isDarkMode}
922
+ data={data}
923
+ thresholds={[
924
+ {
925
+ value: 55,
926
+ label: "Memory limit",
927
+ color: ChartPalette.semantic("Attention", isDarkMode),
928
+ },
929
+ ]}
930
+ xAxisName="Time (UTC)"
931
+ yAxisName="Memory (MB)"
932
+ />
933
+ ```
934
+
935
+ ```tsx
936
+ <TimeseriesChart
937
+ echarts={echarts}
938
+ isDarkMode={isDarkMode}
939
+ data={data}
940
+ xAxisName="Time (UTC)"
941
+ yAxisName="Requests"
942
+ xAxisTickFormat={(ts) => {
943
+ const d = new Date(ts);
944
+ return `${d.getHours().toString().padStart(2, "0")}:${d.getMinutes().toString().padStart(2, "0")}`;
945
+ }}
946
+ yAxisTickFormat={(value) => {
947
+ if (value >= 1000) return `${value / 1000}k`;
948
+ return value.toString();
949
+ }}
950
+ tooltipValueFormat={(value) => `${(value / 1000).toFixed(1)}k requests`}
951
+ />
952
+ ```
953
+
954
+ ```tsx
955
+ <TimeseriesChart
956
+ yAxisTickCount={2}
957
+ echarts={echarts}
958
+ isDarkMode={isDarkMode}
959
+ data={data}
960
+ height={160}
961
+ />
962
+ ```
963
+
964
+ ```tsx
965
+ <TimeseriesChart
966
+ echarts={echarts}
967
+ isDarkMode={isDarkMode}
968
+ data={data}
969
+ xAxisName="Time (UTC)"
970
+ yAxisName="Mbps"
971
+ incomplete={{ after: incompleteTimestamp }}
972
+ />
973
+ ```
974
+
975
+ ```tsx
976
+ <TimeseriesChart
977
+ echarts={echarts}
978
+ isDarkMode={isDarkMode}
979
+ data={data}
980
+ xAxisName="Time (UTC)"
981
+ yAxisName="%"
982
+ onTimeRangeChange={(from, to) => {
983
+ alert(
984
+ `Selected range:\nFrom: ${new Date(from).toLocaleString()}\nTo: ${new Date(to).toLocaleString()}`,
985
+ );
986
+ }}
987
+ />
988
+ ```
989
+
990
+ ```tsx
991
+ <div className="space-y-4">
992
+ <h3 className="text-sm font-medium">Active State</h3>
993
+
994
+ <div className="flex flex-wrap gap-4 divide-x divide-kumo-hairline">
995
+ <ChartLegend.LargeItem
996
+ name="Requests"
997
+ color={ChartPalette.semantic("Neutral", isDarkMode)}
998
+ value="1,234"
999
+ unit="req/s"
1000
+ />
1001
+ <ChartLegend.LargeItem
1002
+ name="Storage"
1003
+ color={ChartPalette.semantic("Attention", isDarkMode)}
1004
+ value="56"
1005
+ unit="GB"
1006
+ />
1007
+ <ChartLegend.LargeItem
1008
+ name="Warnings"
1009
+ color={ChartPalette.semantic("Warning", isDarkMode)}
1010
+ value="128"
1011
+ />
1012
+ </div>
1013
+
1014
+ <h3 className="text-sm font-medium mt-12">Inactive State</h3>
1015
+
1016
+ <div className="flex flex-wrap gap-4 divide-x divide-kumo-hairline">
1017
+ <ChartLegend.LargeItem
1018
+ name="Requests"
1019
+ color={ChartPalette.semantic("Neutral", isDarkMode)}
1020
+ value="1,234"
1021
+ unit="req/s"
1022
+ inactive
1023
+ />
1024
+ <ChartLegend.LargeItem
1025
+ name="Storage"
1026
+ color={ChartPalette.semantic("Attention", isDarkMode)}
1027
+ value="56"
1028
+ unit="GB"
1029
+ inactive
1030
+ />
1031
+ <ChartLegend.LargeItem
1032
+ name="Warnings"
1033
+ color={ChartPalette.semantic("Warning", isDarkMode)}
1034
+ value="128"
1035
+ inactive
1036
+ />
1037
+ </div>
1038
+ </div>
1039
+ ```
1040
+
1041
+ ```tsx
1042
+ <TimeseriesChart
1043
+ echarts={echarts}
1044
+ isDarkMode={isDarkMode}
1045
+ type="bar"
1046
+ data={data}
1047
+ xAxisName="Time (UTC)"
1048
+ yAxisName="Count"
1049
+ tooltipValueFormat={(r) => r.toFixed(2)}
1050
+ />
1051
+ ```
1052
+
1053
+ ```tsx
1054
+ <div className="flex flex-col flex-1 w-full">
1055
+ <TimeseriesChart
1056
+ echarts={echarts}
1057
+ isDarkMode={isDarkMode}
1058
+ xAxisName="Time (UTC)"
1059
+ yAxisName="Count"
1060
+ data={[]}
1061
+ loading
1062
+ />
1063
+ </div>
1064
+ ```
1065
+
1066
+ ```tsx
1067
+ <LayerCard>
1068
+ <LayerCard.Secondary>Read latency</LayerCard.Secondary>
1069
+ <LayerCard.Primary>
1070
+ <div className="flex divide-x divide-kumo-hairline gap-4 px-2 mb-2">
1071
+ <ChartLegend.LargeItem
1072
+ name="P99"
1073
+ color={ChartPalette.semantic("Attention", isDarkMode)}
1074
+ value="124"
1075
+ unit="ms"
1076
+ />
1077
+ <ChartLegend.LargeItem
1078
+ name="P95"
1079
+ color={ChartPalette.semantic("Warning", isDarkMode)}
1080
+ value="76"
1081
+ unit="ms"
1082
+ />
1083
+ <ChartLegend.LargeItem
1084
+ name="P75"
1085
+ color={ChartPalette.semantic("Neutral", isDarkMode)}
1086
+ value="32"
1087
+ unit="ms"
1088
+ />
1089
+ <ChartLegend.LargeItem
1090
+ name="P50"
1091
+ color={ChartPalette.semantic("Neutral", isDarkMode)}
1092
+ value="10"
1093
+ unit="ms"
1094
+ />
1095
+ </div>
1096
+ <TimeseriesChart
1097
+ xAxisName="Time (UTC)"
1098
+ echarts={echarts}
1099
+ isDarkMode={isDarkMode}
1100
+ data={data}
1101
+ height={300}
1102
+ />
1103
+ </LayerCard.Primary>
1104
+ </LayerCard>
1105
+ ```
1106
+
1107
+ ```tsx
1108
+ <LayerCard>
1109
+ <LayerCard.Secondary>Read latency</LayerCard.Secondary>
1110
+ <LayerCard.Primary>
1111
+ <div className="flex divide-x divide-kumo-line px-2 mb-2">
1112
+ {series.map((s) => (
1113
+ <ChartLegend.LargeItem
1114
+ key={s.name}
1115
+ name={s.name}
1116
+ color={s.color}
1117
+ value={s.value}
1118
+ unit={s.unit}
1119
+ inactive={hoveredSeries !== null && hoveredSeries !== s.name}
1120
+ onPointerEnter={() => {
1121
+ setHoveredSeries(s.name);
1122
+ chartRef.current?.dispatchAction({
1123
+ type: "highlight",
1124
+ seriesName: s.name,
1125
+ });
1126
+ }}
1127
+ onPointerLeave={() => {
1128
+ setHoveredSeries(null);
1129
+ chartRef.current?.dispatchAction({
1130
+ type: "downplay",
1131
+ seriesName: s.name,
1132
+ });
1133
+ }}
1134
+ className="not-first:pl-4"
1135
+ />
1136
+ ))}
1137
+ </div>
1138
+ <TimeseriesChart
1139
+ ref={chartRef}
1140
+ xAxisName="Time (UTC)"
1141
+ echarts={echarts}
1142
+ isDarkMode={isDarkMode}
1143
+ data={data}
1144
+ height={300}
1145
+ />
1146
+ </LayerCard.Primary>
1147
+ </LayerCard>
1148
+ ```
1149
+
1150
+ ```tsx
1151
+ <LayerCard>
1152
+ <LayerCard.Secondary>Read latency</LayerCard.Secondary>
1153
+ <LayerCard.Primary>
1154
+ <div className="flex divide-x divide-kumo-line px-2 mb-2">
1155
+ {series.map((s) => (
1156
+ <ChartLegend.LargeItem
1157
+ key={s.name}
1158
+ name={s.name}
1159
+ color={s.color}
1160
+ value={s.value}
1161
+ unit={s.unit}
1162
+ inactive={hiddenSeries[s.name] ?? false}
1163
+ onClick={() => handleClick(s.name)}
1164
+ className="not-first:pl-4"
1165
+ />
1166
+ ))}
1167
+ </div>
1168
+ <TimeseriesChart
1169
+ ref={chartRef}
1170
+ xAxisName="Time (UTC)"
1171
+ echarts={echarts}
1172
+ isDarkMode={isDarkMode}
1173
+ data={data}
1174
+ height={300}
1175
+ enableLegendSelection
1176
+ />
1177
+ </LayerCard.Primary>
1178
+ </LayerCard>
1179
+ ```
1180
+
1181
+ ```tsx
1182
+ <div className="flex w-full flex-col gap-4">
1183
+ <Select
1184
+ label="Tooltip follow cursor"
1185
+ value={selected}
1186
+ onValueChange={(v) => {
1187
+ if (v) setSelected(v);
1188
+ }}
1189
+ renderValue={(v) => v.label}
1190
+ >
1191
+ {FOLLOW_CURSOR_OPTIONS.map((opt) => (
1192
+ <Select.Option key={opt.value} value={opt}>
1193
+ {opt.label}
1194
+ </Select.Option>
1195
+ ))}
1196
+ </Select>
1197
+ <TimeseriesChart
1198
+ echarts={echarts}
1199
+ isDarkMode={isDarkMode}
1200
+ data={data}
1201
+ xAxisName="Time (UTC)"
1202
+ yAxisName="Latency (ms)"
1203
+ tooltipFollowCursor={selected.value}
1204
+ />
1205
+ </div>
1206
+ ```
1207
+
1208
+ ```tsx
1209
+ <div
1210
+ ref={boundaryRef}
1211
+ className="w-full overflow-auto rounded-lg border border-kumo-line"
1212
+ style={{ height: 300 }}
1213
+ >
1214
+ <TimeseriesChart
1215
+ echarts={echarts}
1216
+ isDarkMode={isDarkMode}
1217
+ data={data}
1218
+ xAxisName="Time (UTC)"
1219
+ yAxisName="Count"
1220
+ height={280}
1221
+ tooltipBoundary={boundary ?? undefined}
1222
+ />
1223
+ </div>
1224
+ ```
1225
+
1226
+
739
1227
  ---
740
1228
 
741
1229
  ### Checkbox
@@ -810,23 +1298,23 @@ Item sub-component
810
1298
  Group sub-component
811
1299
 
812
1300
  Props:
813
- - `legend`: string
814
- - `children`: ReactNode (required)
815
- - `error`: string
816
- - `description`: ReactNode
817
- - `value`: string[]
818
- - `allValues`: string[]
819
- - `disabled`: boolean
820
- - `controlFirst`: boolean
821
- - `className`: string
1301
+ - `legend`: string - Legend text for the group. For more control over legend styling, omit this prop and use `<Checkbox.Legend>` as a child instead.
1302
+ - `children`: ReactNode (required) - Child Checkbox.Item components (and optionally a Checkbox.Legend)
1303
+ - `error`: string - Error message for the group (only appears in groups, not single checkboxes)
1304
+ - `description`: ReactNode - Helper text for the group
1305
+ - `value`: string[] - Values of checkboxes that should be checked (controlled)
1306
+ - `allValues`: string[] - All possible checkbox values (required for parent checkbox pattern)
1307
+ - `disabled`: boolean - Whether all checkboxes in the group are disabled
1308
+ - `controlFirst`: boolean - When true (default), checkbox appears before label. When false, label appears before checkbox.
1309
+ - `className`: string - Additional CSS classes
822
1310
 
823
1311
  #### Checkbox.Legend
824
1312
 
825
1313
  Legend sub-component
826
1314
 
827
1315
  Props:
828
- - `children`: ReactNode (required)
829
- - `className`: string
1316
+ - `children`: ReactNode (required) - Legend content
1317
+ - `className`: string - Additional CSS classes (e.g. "sr-only" to visually hide the legend)
830
1318
 
831
1319
 
832
1320
  **Examples:**
@@ -901,6 +1389,76 @@ Props:
901
1389
  ```
902
1390
 
903
1391
 
1392
+ ---
1393
+
1394
+ ### ChoroplethMap
1395
+
1396
+ ChoroplethMap component
1397
+
1398
+ **Type:** component
1399
+
1400
+ **Import:** `import { ChoroplethMap } from "@cloudflare/kumo";`
1401
+
1402
+ **Category:** Data Visualization
1403
+
1404
+ **Props:**
1405
+
1406
+ - `echarts`: typeof echarts (required)
1407
+ The ECharts core instance imported by the consumer (passed in for tree-shaking). Requires `MapChart`, `VisualMapComponent`, `TooltipComponent`, and a renderer registered via `echarts.use([...])`.
1408
+ - `geoJson`: MapGeoJson (required)
1409
+ GeoJSON `FeatureCollection` whose regions are shaded by value.
1410
+ - `mapName`: string
1411
+ 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.
1412
+ - `data`: T[] (required)
1413
+ Raw data rows. The region key and value are read via the accessors below.
1414
+ - `name`: MapAccessor<T, string> (required)
1415
+ Region-key accessor (key of `T` or `(row) => string`). Each row is joined to a GeoJSON feature whose `nameProperty` equals this value.
1416
+ - `value`: MapAccessor<T, number> (required)
1417
+ Value accessor — drives the region's fill colour.
1418
+ - `nameProperty`: string
1419
+ 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"`).
1420
+ - `colorRange`: string[]
1421
+ 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.
1422
+ - `noDataColor`: string
1423
+ Fill for regions with no matching data row. Defaults to the neutral land grey.
1424
+ - `showLegend`: boolean
1425
+ Show the visualMap colour legend. Default: `false`.
1426
+ - `showTooltip`: boolean
1427
+ Show the tooltip. Default: `true`.
1428
+ - `valueFormat`: (value: number) => string
1429
+ Format the value for the default tooltip. Default: `toLocaleString()`.
1430
+ - `tooltipFormatter`: (row: T) => string
1431
+ 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.
1432
+ - `center`: [number, number]
1433
+ Map center as `[longitude, latitude]`. Defaults to auto-fit.
1434
+ - `zoom`: number
1435
+ Zoom level — multiplies the auto-fit scale. Default: `1.25`.
1436
+ - `roam`: boolean
1437
+ Enable drag-to-pan and scroll-to-zoom. Default: `false`.
1438
+ - `projection`: MapProjection | null
1439
+ 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.
1440
+ - `aspectRatio`: number | string
1441
+ 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.
1442
+ - `height`: number
1443
+ Fixed chart height in pixels. Overrides `aspectRatio` when set. Leave unset to size by aspect ratio (the default) so the map fills the container.
1444
+ - `className`: string
1445
+ - `isDarkMode`: boolean
1446
+
1447
+ **Examples:**
1448
+
1449
+ ```tsx
1450
+ <ChoroplethMap<CountryTraffic>
1451
+ echarts={echarts}
1452
+ geoJson={geoJson}
1453
+ data={countries}
1454
+ name="country"
1455
+ value="requests"
1456
+ valueFormat={fmt}
1457
+ isDarkMode={isDarkMode}
1458
+ />
1459
+ ```
1460
+
1461
+
904
1462
  ---
905
1463
 
906
1464
  ### ClipboardText
@@ -1456,8 +2014,8 @@ This is a compound component. Use these sub-components:
1456
2014
  Block sub-component
1457
2015
 
1458
2016
  Props:
1459
- - `code`: string (required)
1460
- - `lang`: CodeLang
2017
+ - `code`: string (required) - The code string to display.
2018
+ - `lang`: CodeLang - Language hint for the code content.
1461
2019
 
1462
2020
 
1463
2021
  ---
@@ -1492,37 +2050,37 @@ This is a compound component. Use these sub-components:
1492
2050
  Root sub-component
1493
2051
 
1494
2052
  Props:
1495
- - `className`: string
2053
+ - `className`: string - Additional CSS classes
1496
2054
 
1497
2055
  #### Collapsible.Trigger
1498
2056
 
1499
2057
  Trigger sub-component
1500
2058
 
1501
2059
  Props:
1502
- - `className`: string
2060
+ - `className`: string - Additional CSS classes
1503
2061
 
1504
2062
  #### Collapsible.Panel
1505
2063
 
1506
2064
  Panel sub-component
1507
2065
 
1508
2066
  Props:
1509
- - `className`: string
2067
+ - `className`: string - Additional CSS classes
1510
2068
 
1511
2069
  #### Collapsible.DefaultTrigger
1512
2070
 
1513
2071
  DefaultTrigger sub-component
1514
2072
 
1515
2073
  Props:
1516
- - `children`: ReactNode (required)
1517
- - `className`: string
2074
+ - `children`: ReactNode (required) - Label text displayed in the trigger
2075
+ - `className`: string - Additional CSS classes
1518
2076
 
1519
2077
  #### Collapsible.DefaultPanel
1520
2078
 
1521
2079
  DefaultPanel sub-component
1522
2080
 
1523
2081
  Props:
1524
- - `children`: ReactNode (required)
1525
- - `className`: string
2082
+ - `children`: ReactNode (required) - Panel content
2083
+ - `className`: string - Additional CSS classes
1526
2084
 
1527
2085
 
1528
2086
  **Examples:**
@@ -2688,10 +3246,10 @@ Dialog component
2688
3246
  - `container`: PortalContainer
2689
3247
  Container element for the portal. Use this to render the dialog inside a Shadow DOM or custom container. Overrides `KumoPortalProvider` context.
2690
3248
  - `size`: enum [default: base]
2691
- - `"base"`: Default dialog width
2692
- - `"sm"`: Small dialog for simple confirmations
2693
- - `"lg"`: Large dialog for complex content
2694
- - `"xl"`: Extra large dialog for detailed views
3249
+ - `"base"`: Default dialog width (384px)
3250
+ - `"sm"`: Small dialog for simple confirmations (288px)
3251
+ - `"lg"`: Large dialog for complex content (512px)
3252
+ - `"xl"`: Extra large dialog for detailed views (768px)
2695
3253
 
2696
3254
  **Colors (kumo tokens used):**
2697
3255
 
@@ -3023,6 +3581,86 @@ Close sub-component
3023
3581
  </Dialog.Root>
3024
3582
  ```
3025
3583
 
3584
+ ```tsx
3585
+ <div className="flex flex-wrap gap-2">
3586
+ {sizes.map(({ size, label, width }) => (
3587
+ <Dialog.Root key={size}>
3588
+ <Dialog.Trigger
3589
+ render={(p) => (
3590
+ <Button variant="secondary" {...p}>
3591
+ {label} ({width})
3592
+ </Button>
3593
+ )}
3594
+ />
3595
+ <Dialog size={size} className="p-8">
3596
+ <div className="mb-4 flex items-start justify-between gap-4">
3597
+ <Dialog.Title className="text-2xl font-semibold">
3598
+ {label} Dialog
3599
+ </Dialog.Title>
3600
+ <Dialog.Close
3601
+ aria-label="Close"
3602
+ render={(props) => (
3603
+ <Button
3604
+ {...props}
3605
+ variant="secondary"
3606
+ shape="square"
3607
+ icon={<X />}
3608
+ aria-label="Close"
3609
+ />
3610
+ )}
3611
+ />
3612
+ </div>
3613
+ <Dialog.Description className="text-kumo-subtle">
3614
+ This <code>size="{size}"</code> dialog should stay at {width} wide
3615
+ regardless of the content below.
3616
+ </Dialog.Description>
3617
+ <div className="mt-4 overflow-auto rounded-md border border-kumo-line">
3618
+ <table className="w-max text-sm">
3619
+ <thead className="bg-kumo-elevated text-left">
3620
+ <tr>
3621
+ <th className="px-3 py-2">Resource</th>
3622
+ <th className="px-3 py-2">Region</th>
3623
+ <th className="px-3 py-2">Status</th>
3624
+ <th className="px-3 py-2">Latency</th>
3625
+ <th className="px-3 py-2">Requests</th>
3626
+ <th className="px-3 py-2">Last Deployed</th>
3627
+ </tr>
3628
+ </thead>
3629
+ <tbody className="divide-y divide-kumo-hairline">
3630
+ <tr>
3631
+ <td className="px-3 py-2">api-gateway-prod</td>
3632
+ <td className="px-3 py-2">us-east-1</td>
3633
+ <td className="px-3 py-2 text-kumo-success">Healthy</td>
3634
+ <td className="px-3 py-2">12ms</td>
3635
+ <td className="px-3 py-2">1,234,567</td>
3636
+ <td className="px-3 py-2">2026-06-23</td>
3637
+ </tr>
3638
+ <tr>
3639
+ <td className="px-3 py-2">worker-analytics</td>
3640
+ <td className="px-3 py-2">eu-west-1</td>
3641
+ <td className="px-3 py-2 text-kumo-warning">Degraded</td>
3642
+ <td className="px-3 py-2">89ms</td>
3643
+ <td className="px-3 py-2">456,789</td>
3644
+ <td className="px-3 py-2">2026-06-22</td>
3645
+ </tr>
3646
+ </tbody>
3647
+ </table>
3648
+ </div>
3649
+ <div className="mt-6 flex justify-end gap-2">
3650
+ <Dialog.Close
3651
+ render={(props) => (
3652
+ <Button variant="secondary" {...props}>
3653
+ Close
3654
+ </Button>
3655
+ )}
3656
+ />
3657
+ </div>
3658
+ </Dialog>
3659
+ </Dialog.Root>
3660
+ ))}
3661
+ </div>
3662
+ ```
3663
+
3026
3664
 
3027
3665
  ---
3028
3666
 
@@ -3333,6 +3971,17 @@ Group sub-component (wraps DropdownMenuPrimitive)
3333
3971
  </DropdownMenu>
3334
3972
  ```
3335
3973
 
3974
+ ```tsx
3975
+ <DropdownMenu>
3976
+ <DropdownMenu.Trigger render={<Button>Open long list</Button>} />
3977
+ <DropdownMenu.Content>
3978
+ {items.map((item) => (
3979
+ <DropdownMenu.Item key={item}>{item}</DropdownMenu.Item>
3980
+ ))}
3981
+ </DropdownMenu.Content>
3982
+ </DropdownMenu>
3983
+ ```
3984
+
3336
3985
  ```tsx
3337
3986
  <DropdownMenu>
3338
3987
  <DropdownMenu.Trigger render={<Button>Resources</Button>} />
@@ -4859,37 +5508,37 @@ Info sub-component
4859
5508
 
4860
5509
  Props:
4861
5510
  - `children`: (props: {
4862
- - `page`: number (required)
4863
- - `perPage`: number
4864
- - `totalCount`: number
4865
- - `pageShowingRange`: string (required)
5511
+ page: number;
5512
+ perPage?: number;
5513
+ totalCount?: number;
5514
+ pageShowingRange: string;
5515
+ }) => ReactNode - Custom render function for the info text
5516
+ - `className`: string - Additional CSS classes
4866
5517
 
4867
5518
  #### Pagination.PageSize
4868
5519
 
4869
5520
  PageSize sub-component
4870
5521
 
4871
5522
  Props:
4872
- - `value`: number (required)
4873
- - `options`: number[]
4874
- - `page`: " (required)
4875
- - `label`: ReactNode
4876
- - `className`: string
5523
+ - `value`: number (required) - Current page size value
5524
+ - `options`: number[] - Available page size options
5525
+ - `label`: ReactNode - Label text shown before the selector.
5526
+ - `className`: string - Additional CSS classes
4877
5527
 
4878
5528
  #### Pagination.Controls
4879
5529
 
4880
5530
  Controls sub-component
4881
5531
 
4882
5532
  Props:
4883
- - `Note`: ** `"dropdown"` renders an option for every page (required)
4884
- - `pageSelector`: "input" | "dropdown"
4885
- - `className`: string
5533
+ - `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.
5534
+ - `className`: string - Additional CSS classes
4886
5535
 
4887
5536
  #### Pagination.Separator
4888
5537
 
4889
5538
  Separator sub-component
4890
5539
 
4891
5540
  Props:
4892
- - `className`: string
5541
+ - `className`: string - Additional CSS classes
4893
5542
 
4894
5543
 
4895
5544
  **Examples:**
@@ -5306,19 +5955,28 @@ Radio — radio button group for single-select choices.
5306
5955
  - `variant`: enum [default: default]
5307
5956
  - `"default"`: Default radio appearance
5308
5957
  - `"error"`: Error state for validation failures
5309
- - `appearance`: enum [default: default]
5310
- - `"default"`: Standard inline radio item
5311
- - `"card"`: Choice card appearance with border, padding, and highlighted selection state
5312
-
5313
- **State Classes:**
5314
- - `"card"`:
5315
- - `hover`: `hover:bg-kumo-tint`
5316
- - `className`: string
5317
- Additional CSS classes
5318
- - `children`: ReactNode
5319
- Child elements
5958
+ - `appearance`: KumoRadioAppearance
5959
+ 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.
5960
+ - `legend`: string
5961
+ 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.
5962
+ - `children`: ReactNode (required)
5963
+ Child Radio.Item components (and optionally a Radio.Legend)
5964
+ - `orientation`: "vertical" | "horizontal"
5965
+ Layout direction of the radio items
5966
+ - `error`: string
5967
+ Error message for the group
5968
+ - `description`: ReactNode
5969
+ Helper text for the group
5320
5970
  - `value`: T
5321
5971
  The controlled value of the selected radio item.
5972
+ - `disabled`: boolean
5973
+ Whether all radios in the group are disabled
5974
+ - `controlPosition`: RadioControlPosition
5975
+ 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.
5976
+ - `name`: string
5977
+ Form submission name for the radio group
5978
+ - `className`: string
5979
+ Additional CSS classes
5322
5980
  - `defaultValue`: T
5323
5981
  The uncontrolled initial value of the selected radio item.
5324
5982
  - `onValueChange`: (value: T, eventDetails: RadioGroupChangeEventDetails) => void
@@ -5341,7 +5999,17 @@ Item sub-component
5341
5999
  Group sub-component
5342
6000
 
5343
6001
  Props:
6002
+ - `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.
6003
+ - `children`: ReactNode (required) - Child Radio.Item components (and optionally a Radio.Legend)
6004
+ - `orientation`: "vertical" | "horizontal" - Layout direction of the radio items
6005
+ - `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.
6006
+ - `error`: string - Error message for the group
6007
+ - `description`: ReactNode - Helper text for the group
5344
6008
  - `value`: T - The controlled value of the selected radio item.
6009
+ - `disabled`: boolean - Whether all radios in the group are disabled
6010
+ - `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.
6011
+ - `name`: string - Form submission name for the radio group
6012
+ - `className`: string - Additional CSS classes
5345
6013
  - `defaultValue`: T - The uncontrolled initial value of the selected radio item.
5346
6014
  - `onValueChange`: (value: T, eventDetails: RadioGroupChangeEventDetails) => void - Callback fired when the selected value changes. The second argument carries native event details about the interaction.
5347
6015
 
@@ -5350,8 +6018,8 @@ Props:
5350
6018
  Legend sub-component
5351
6019
 
5352
6020
  Props:
5353
- - `children`: ReactNode (required)
5354
- - `className`: string
6021
+ - `children`: ReactNode (required) - Legend content
6022
+ - `className`: string - Additional CSS classes (e.g. "sr-only" to visually hide the legend)
5355
6023
 
5356
6024
 
5357
6025
  **Examples:**
@@ -5633,6 +6301,171 @@ Props:
5633
6301
  ```
5634
6302
 
5635
6303
 
6304
+ ---
6305
+
6306
+ ### SankeyChart
6307
+
6308
+ SankeyChart component
6309
+
6310
+ **Type:** component
6311
+
6312
+ **Import:** `import { SankeyChart } from "@cloudflare/kumo";`
6313
+
6314
+ **Category:** Data Visualization
6315
+
6316
+ **Props:**
6317
+
6318
+ - `echarts`: typeof echarts (required)
6319
+ 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).
6320
+ - `nodes`: SankeyNodeData[] (required)
6321
+ Array of nodes in the Sankey diagram
6322
+ - `links`: SankeyLinkData[] (required)
6323
+ Array of links connecting nodes by index
6324
+ - `height`: number
6325
+ Height of the chart in pixels
6326
+ - `showNodeValues`: boolean
6327
+ Show node values above labels (default: true if any node has a value)
6328
+ - `nodeLabelLayout`: "stacked" | "inline"
6329
+ 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)
6330
+ - `formatValue`: (value: number) => string
6331
+ Format function for node values (default: toLocaleString)
6332
+ - `tooltipFormatter`: (params: SankeyTooltipParams) => string
6333
+ Custom tooltip formatter. Return HTML string or empty string to hide tooltip.
6334
+ - `nodeWidth`: number
6335
+ - `nodePadding`: number
6336
+ - `showTooltip`: boolean
6337
+ - `defaultNodeColor`: string
6338
+ - `left`: number | string
6339
+ Left padding of the Sankey layout within the chart container. Accepts a number (px) or percentage string. ECharts default: '5%'.
6340
+ - `right`: number | string
6341
+ Right padding of the Sankey layout within the chart container. Accepts a number (px) or percentage string. ECharts default: '5%'.
6342
+ - `linkColor`: "gradient" | "gray"
6343
+ Link fill style: 'gradient' blends source to target colors, 'gray' uses flat gray
6344
+ - `linkOpacity`: number
6345
+ - `className`: string
6346
+ - `isDarkMode`: boolean
6347
+
6348
+ **Examples:**
6349
+
6350
+ ```tsx
6351
+ <SankeyChart
6352
+ echarts={echarts}
6353
+ nodes={basicNodes}
6354
+ links={basicLinks}
6355
+ height={350}
6356
+ isDarkMode={isDarkMode}
6357
+ />
6358
+ ```
6359
+
6360
+ ```tsx
6361
+ <SankeyChart
6362
+ echarts={echarts}
6363
+ nodes={previewNodes}
6364
+ links={previewLinks}
6365
+ height={200}
6366
+ showTooltip={false}
6367
+ isDarkMode={isDarkMode}
6368
+ />
6369
+ ```
6370
+
6371
+ ```tsx
6372
+ <SankeyChart
6373
+ echarts={echarts}
6374
+ nodes={multiLevelNodes}
6375
+ links={multiLevelLinks}
6376
+ height={350}
6377
+ nodeWidth={20}
6378
+ nodePadding={15}
6379
+ isDarkMode={isDarkMode}
6380
+ />
6381
+ ```
6382
+
6383
+ ```tsx
6384
+ <SankeyChart
6385
+ echarts={echarts}
6386
+ nodes={nodes}
6387
+ links={links}
6388
+ height={250}
6389
+ linkOpacity={0.6}
6390
+ isDarkMode={isDarkMode}
6391
+ />
6392
+ ```
6393
+
6394
+ ```tsx
6395
+ <SankeyChart
6396
+ echarts={echarts}
6397
+ nodes={nodes}
6398
+ links={links}
6399
+ height={300}
6400
+ tooltipFormatter={customTooltip}
6401
+ isDarkMode={isDarkMode}
6402
+ />
6403
+ ```
6404
+
6405
+ ```tsx
6406
+ <SankeyChart
6407
+ echarts={echarts}
6408
+ nodes={basicNodes}
6409
+ links={basicLinks}
6410
+ height={350}
6411
+ left={0}
6412
+ right={0}
6413
+ isDarkMode={isDarkMode}
6414
+ />
6415
+ ```
6416
+
6417
+ ```tsx
6418
+ <SankeyChart
6419
+ echarts={echarts}
6420
+ nodes={basicNodes}
6421
+ links={basicLinks}
6422
+ height={350}
6423
+ onNodeClick={handleNodeClick}
6424
+ onLinkClick={handleLinkClick}
6425
+ isDarkMode={isDarkMode}
6426
+ />
6427
+ ```
6428
+
6429
+ ```tsx
6430
+ <div className="flex w-full flex-col gap-2">
6431
+ <div className="flex items-center gap-2 text-sm text-kumo-subtle">
6432
+ <span>
6433
+ {hasSelection
6434
+ ? `Showing: ${[selectedSource, selectedTarget].filter(Boolean).join(" → ")}`
6435
+ : "Click a node to filter"}
6436
+ </span>
6437
+ {hasSelection && (
6438
+ <button
6439
+ onClick={resetFilters}
6440
+ className="text-kumo-brand hover:underline"
6441
+ >
6442
+ Reset
6443
+ </button>
6444
+ )}
6445
+ </div>
6446
+ <SankeyChart
6447
+ echarts={echarts}
6448
+ nodes={filteredNodes}
6449
+ links={filteredLinks}
6450
+ height={300}
6451
+ onNodeClick={handleNodeClick}
6452
+ isDarkMode={isDarkMode}
6453
+ />
6454
+ </div>
6455
+ ```
6456
+
6457
+ ```tsx
6458
+ <SankeyChart
6459
+ echarts={echarts}
6460
+ nodes={nodes}
6461
+ links={links}
6462
+ height={300}
6463
+ nodeLabelLayout="inline"
6464
+ isDarkMode={isDarkMode}
6465
+ />
6466
+ ```
6467
+
6468
+
5636
6469
  ---
5637
6470
 
5638
6471
  ### Select
@@ -6222,145 +7055,205 @@ This is a compound component. Use these sub-components:
6222
7055
  Provider sub-component
6223
7056
 
6224
7057
  Props:
6225
- - `defaultOpen`: boolean
6226
- - `open`: boolean
6227
- - `variant`: SidebarVariant
6228
- - `side`: SidebarSide
7058
+ - `defaultOpen`: boolean - Initial open state when uncontrolled.
7059
+ - `open`: boolean - Controlled open state.
7060
+ - `variant`: SidebarVariant - Sidebar layout variant.
7061
+ - `side`: SidebarSide - Which side the sidebar is on.
6229
7062
  - `collapsible`: "icon" | "offcanvas" | "none"
6230
- - `resizable`: boolean
6231
- - `defaultWidth`: number
6232
- - `minWidth`: number
6233
- - `maxWidth`: number
6234
- - `contained`: boolean
6235
- - `peekable`: boolean
6236
- - `animationDuration`: number
6237
- - `mobileBreakpoint`: number
6238
- - `children`: ReactNode (required)
6239
- - `className`: string
7063
+ - `resizable`: boolean - Enable drag-to-resize on the sidebar edge.
7064
+ - `defaultWidth`: number - Initial width in pixels when resizable.
7065
+ - `minWidth`: number - Minimum width in pixels when resizing.
7066
+ - `maxWidth`: number - Maximum width in pixels when resizing.
7067
+ - `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.
7068
+ - `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.
7069
+ - `animationDuration`: number - Duration of sidebar expand/collapse animation in milliseconds.
7070
+ - `mobileBreakpoint`: number - Viewport width (in px) below which the sidebar renders as a mobile dialog sheet instead of the desktop aside rail.
7071
+ - `children`: ReactNode (required) - Content — typically `<Sidebar>` + main content.
7072
+ - `className`: string - Additional CSS classes for the wrapper div.
6240
7073
 
6241
7074
  #### Sidebar.Header
6242
7075
 
6243
7076
  Header sub-component
6244
7077
 
6245
7078
  Props:
6246
- - `icon`: React.ComponentType<{ className?: string
7079
+ - `icon`: React.ComponentType<{ className?: string }> | React.ReactNode
7080
+ - `active`: boolean
7081
+ - `size`: SidebarMenuButtonSize - Button size. - `"base"` — Standard nav item - `"sm"` — Compact nav item
7082
+ - `href`: string
7083
+ - `target`: React.HTMLAttributeAnchorTarget - Link target — only meaningful when `href` is provided.
7084
+ - `tooltip`: string
7085
+ - `className`: string
7086
+ - `children`: ReactNode
6247
7087
 
6248
7088
  #### Sidebar.Content
6249
7089
 
6250
7090
  Content sub-component
6251
7091
 
6252
7092
  Props:
6253
- - `icon`: React.ComponentType<{ className?: string
7093
+ - `icon`: React.ComponentType<{ className?: string }> | React.ReactNode
7094
+ - `active`: boolean
7095
+ - `size`: SidebarMenuButtonSize - Button size. - `"base"` — Standard nav item - `"sm"` — Compact nav item
7096
+ - `href`: string
7097
+ - `target`: React.HTMLAttributeAnchorTarget - Link target — only meaningful when `href` is provided.
7098
+ - `tooltip`: string
7099
+ - `className`: string
7100
+ - `children`: ReactNode
6254
7101
 
6255
7102
  #### Sidebar.Footer
6256
7103
 
6257
7104
  Footer sub-component
6258
7105
 
6259
7106
  Props:
6260
- - `icon`: React.ComponentType<{ className?: string
7107
+ - `icon`: React.ComponentType<{ className?: string }> | React.ReactNode
7108
+ - `active`: boolean
7109
+ - `size`: SidebarMenuButtonSize - Button size. - `"base"` — Standard nav item - `"sm"` — Compact nav item
7110
+ - `href`: string
7111
+ - `target`: React.HTMLAttributeAnchorTarget - Link target — only meaningful when `href` is provided.
7112
+ - `tooltip`: string
7113
+ - `className`: string
7114
+ - `children`: ReactNode
6261
7115
 
6262
7116
  #### Sidebar.Group
6263
7117
 
6264
7118
  Group sub-component
6265
7119
 
6266
7120
  Props:
6267
- - `icon`: React.ComponentType<{ className?: string
7121
+ - `icon`: React.ComponentType<{ className?: string }> | React.ReactNode
7122
+ - `active`: boolean
7123
+ - `size`: SidebarMenuButtonSize - Button size. - `"base"` — Standard nav item - `"sm"` — Compact nav item
7124
+ - `href`: string
7125
+ - `target`: React.HTMLAttributeAnchorTarget - Link target — only meaningful when `href` is provided.
7126
+ - `tooltip`: string
7127
+ - `className`: string
7128
+ - `children`: ReactNode
6268
7129
 
6269
7130
  #### Sidebar.GroupLabel
6270
7131
 
6271
7132
  GroupLabel sub-component
6272
7133
 
6273
7134
  Props:
6274
- - `icon`: React.ComponentType<{ className?: string
7135
+ - `icon`: React.ComponentType<{ className?: string }> | React.ReactNode
7136
+ - `active`: boolean
7137
+ - `size`: SidebarMenuButtonSize - Button size. - `"base"` — Standard nav item - `"sm"` — Compact nav item
7138
+ - `href`: string
7139
+ - `target`: React.HTMLAttributeAnchorTarget - Link target — only meaningful when `href` is provided.
7140
+ - `tooltip`: string
7141
+ - `className`: string
7142
+ - `children`: ReactNode
6275
7143
 
6276
7144
  #### Sidebar.Menu
6277
7145
 
6278
7146
  Menu sub-component
6279
7147
 
6280
7148
  Props:
6281
- - `icon`: React.ComponentType<{ className?: string
7149
+ - `icon`: React.ComponentType<{ className?: string }> | React.ReactNode
7150
+ - `active`: boolean
7151
+ - `size`: SidebarMenuButtonSize - Button size. - `"base"` — Standard nav item - `"sm"` — Compact nav item
7152
+ - `href`: string
7153
+ - `target`: React.HTMLAttributeAnchorTarget - Link target — only meaningful when `href` is provided.
7154
+ - `tooltip`: string
7155
+ - `className`: string
7156
+ - `children`: ReactNode
6282
7157
 
6283
7158
  #### Sidebar.MenuItem
6284
7159
 
6285
7160
  MenuItem sub-component
6286
7161
 
6287
7162
  Props:
6288
- - `icon`: React.ComponentType<{ className?: string
7163
+ - `icon`: React.ComponentType<{ className?: string }> | React.ReactNode
7164
+ - `active`: boolean
7165
+ - `size`: SidebarMenuButtonSize - Button size. - `"base"` — Standard nav item - `"sm"` — Compact nav item
7166
+ - `href`: string
7167
+ - `target`: React.HTMLAttributeAnchorTarget - Link target — only meaningful when `href` is provided.
7168
+ - `tooltip`: string
7169
+ - `className`: string
7170
+ - `children`: ReactNode
6289
7171
 
6290
7172
  #### Sidebar.MenuButton
6291
7173
 
6292
7174
  MenuButton sub-component
6293
7175
 
6294
7176
  Props:
6295
- - `icon`: React.ComponentType<{ className?: string
7177
+ - `icon`: React.ComponentType<{ className?: string }> | React.ReactNode
7178
+ - `active`: boolean
7179
+ - `size`: SidebarMenuButtonSize - Button size. - `"base"` — Standard nav item - `"sm"` — Compact nav item
7180
+ - `href`: string
7181
+ - `target`: React.HTMLAttributeAnchorTarget - Link target — only meaningful when `href` is provided.
7182
+ - `tooltip`: string
7183
+ - `className`: string
7184
+ - `children`: ReactNode
6296
7185
 
6297
7186
  #### Sidebar.MenuBadge
6298
7187
 
6299
7188
  MenuBadge sub-component
6300
7189
 
6301
7190
  Props:
6302
- - `active`: boolean
6303
- - `href`: string
7191
+ - `active`: boolean - Marks this sub-item as currently active/selected.
7192
+ - `href`: string - Navigation URL. When set, renders as a link via LinkProvider.
7193
+ - `target`: React.HTMLAttributeAnchorTarget - Link target — only meaningful when `href` is provided.
6304
7194
 
6305
7195
  #### Sidebar.MenuSub
6306
7196
 
6307
7197
  MenuSub sub-component
6308
7198
 
6309
7199
  Props:
6310
- - `active`: boolean
6311
- - `href`: string
7200
+ - `active`: boolean - Marks this sub-item as currently active/selected.
7201
+ - `href`: string - Navigation URL. When set, renders as a link via LinkProvider.
7202
+ - `target`: React.HTMLAttributeAnchorTarget - Link target — only meaningful when `href` is provided.
6312
7203
 
6313
7204
  #### Sidebar.MenuSubItem
6314
7205
 
6315
7206
  MenuSubItem sub-component
6316
7207
 
6317
7208
  Props:
6318
- - `active`: boolean
6319
- - `href`: string
7209
+ - `active`: boolean - Marks this sub-item as currently active/selected.
7210
+ - `href`: string - Navigation URL. When set, renders as a link via LinkProvider.
7211
+ - `target`: React.HTMLAttributeAnchorTarget - Link target — only meaningful when `href` is provided.
6320
7212
 
6321
7213
  #### Sidebar.MenuSubButton
6322
7214
 
6323
7215
  MenuSubButton sub-component
6324
7216
 
6325
7217
  Props:
6326
- - `active`: boolean
6327
- - `href`: string
7218
+ - `active`: boolean - Marks this sub-item as currently active/selected.
7219
+ - `href`: string - Navigation URL. When set, renders as a link via LinkProvider.
7220
+ - `target`: React.HTMLAttributeAnchorTarget - Link target — only meaningful when `href` is provided.
6328
7221
 
6329
7222
  #### Sidebar.Separator
6330
7223
 
6331
7224
  Separator sub-component
6332
7225
 
6333
7226
  Props:
6334
- - `defaultOpen`: boolean
6335
- - `open`: boolean
6336
- - `autoScrollOnOpen`: boolean
7227
+ - `defaultOpen`: boolean - Initial open state (uncontrolled).
7228
+ - `open`: boolean - Controlled open state.
7229
+ - `autoScrollOnOpen`: boolean - Scroll the expanded content into view after opening.
6337
7230
 
6338
7231
  #### Sidebar.Trigger
6339
7232
 
6340
7233
  Trigger sub-component
6341
7234
 
6342
7235
  Props:
6343
- - `defaultOpen`: boolean
6344
- - `open`: boolean
6345
- - `autoScrollOnOpen`: boolean
7236
+ - `defaultOpen`: boolean - Initial open state (uncontrolled).
7237
+ - `open`: boolean - Controlled open state.
7238
+ - `autoScrollOnOpen`: boolean - Scroll the expanded content into view after opening.
6346
7239
 
6347
7240
  #### Sidebar.Rail
6348
7241
 
6349
7242
  Rail sub-component
6350
7243
 
6351
7244
  Props:
6352
- - `defaultOpen`: boolean
6353
- - `open`: boolean
6354
- - `autoScrollOnOpen`: boolean
7245
+ - `defaultOpen`: boolean - Initial open state (uncontrolled).
7246
+ - `open`: boolean - Controlled open state.
7247
+ - `autoScrollOnOpen`: boolean - Scroll the expanded content into view after opening.
6355
7248
 
6356
7249
  #### Sidebar.ResizeHandle
6357
7250
 
6358
7251
  ResizeHandle sub-component
6359
7252
 
6360
7253
  Props:
6361
- - `defaultOpen`: boolean
6362
- - `open`: boolean
6363
- - `autoScrollOnOpen`: boolean
7254
+ - `defaultOpen`: boolean - Initial open state (uncontrolled).
7255
+ - `open`: boolean - Controlled open state.
7256
+ - `autoScrollOnOpen`: boolean - Scroll the expanded content into view after opening.
6364
7257
 
6365
7258
  #### Sidebar.MenuChevron
6366
7259
 
@@ -6374,39 +7267,39 @@ Props:
6374
7267
  Collapsible sub-component
6375
7268
 
6376
7269
  Props:
6377
- - `defaultOpen`: boolean
6378
- - `open`: boolean
6379
- - `autoScrollOnOpen`: boolean
7270
+ - `defaultOpen`: boolean - Initial open state (uncontrolled).
7271
+ - `open`: boolean - Controlled open state.
7272
+ - `autoScrollOnOpen`: boolean - Scroll the expanded content into view after opening.
6380
7273
 
6381
7274
  #### Sidebar.CollapsibleTrigger
6382
7275
 
6383
7276
  CollapsibleTrigger sub-component
6384
7277
 
6385
7278
  Props:
6386
- - `render`: React.ReactElement (required)
7279
+ - `render`: React.ReactElement (required) - Element to render as the trigger. Gets aria-expanded, aria-controls, and onClick merged.
6387
7280
 
6388
7281
  #### Sidebar.CollapsibleContent
6389
7282
 
6390
7283
  CollapsibleContent sub-component
6391
7284
 
6392
7285
  Props:
6393
- - `activeKey`: string (required)
6394
- - `direction`: "left" | "right"
7286
+ - `activeKey`: string (required) - Key of the currently active view. Must match a child `SlidingView` value.
7287
+ - `direction`: "left" | "right" - Slide direction for the transition. - `"left"`: new view slides in from the right - `"right"`: new view slides in from the left
6395
7288
 
6396
7289
  #### Sidebar.SlidingViews
6397
7290
 
6398
7291
  SlidingViews sub-component
6399
7292
 
6400
7293
  Props:
6401
- - `activeKey`: string (required)
6402
- - `direction`: "left" | "right"
7294
+ - `activeKey`: string (required) - Key of the currently active view. Must match a child `SlidingView` value.
7295
+ - `direction`: "left" | "right" - Slide direction for the transition. - `"left"`: new view slides in from the right - `"right"`: new view slides in from the left
6403
7296
 
6404
7297
  #### Sidebar.SlidingView
6405
7298
 
6406
7299
  SlidingView sub-component
6407
7300
 
6408
7301
  Props:
6409
- - `value`: string (required)
7302
+ - `value`: string (required) - Unique key matching this view. Must correspond to `activeKey` on `SlidingViews`.
6410
7303
 
6411
7304
 
6412
7305
  **Examples:**
@@ -7051,21 +7944,21 @@ Item sub-component
7051
7944
  Group sub-component
7052
7945
 
7053
7946
  Props:
7054
- - `legend`: string
7055
- - `children`: ReactNode (required)
7056
- - `error`: string
7057
- - `description`: ReactNode
7058
- - `disabled`: boolean
7059
- - `controlFirst`: boolean
7060
- - `className`: string
7947
+ - `legend`: string - Legend text for the group. For more control over legend styling, omit this prop and use `<Switch.Legend>` as a child instead.
7948
+ - `children`: ReactNode (required) - Child Switch.Item components (and optionally a Switch.Legend)
7949
+ - `error`: string - Error message for the group (only appears in groups, not single switches)
7950
+ - `description`: ReactNode - Helper text for the group
7951
+ - `disabled`: boolean - Whether all switches in the group are disabled
7952
+ - `controlFirst`: boolean - When true (default), switch appears before label. When false, label appears before switch.
7953
+ - `className`: string - Additional CSS classes
7061
7954
 
7062
7955
  #### Switch.Legend
7063
7956
 
7064
7957
  Legend sub-component
7065
7958
 
7066
7959
  Props:
7067
- - `children`: ReactNode (required)
7068
- - `className`: string
7960
+ - `children`: ReactNode (required) - Legend content
7961
+ - `className`: string - Additional CSS classes (e.g. "sr-only" to visually hide the legend)
7069
7962
 
7070
7963
 
7071
7964
  **Examples:**
@@ -7675,16 +8568,17 @@ List sub-component
7675
8568
  Item sub-component
7676
8569
 
7677
8570
  Props:
7678
- - `active`: boolean
8571
+ - `active`: boolean - Whether this item represents the currently active section.
8572
+ - `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`.
7679
8573
 
7680
8574
  #### TableOfContents.Group
7681
8575
 
7682
8576
  Group sub-component
7683
8577
 
7684
8578
  Props:
7685
- - `label`: string (required)
7686
- - `href`: string
7687
- - `active`: boolean
8579
+ - `label`: string (required) - Label displayed above the group's items.
8580
+ - `href`: string - URL the group label links to. When provided, the label renders as a clickable link with item styling.
8581
+ - `active`: boolean - Whether this group's label represents the currently active section. Only applies when `href` is provided.
7688
8582
 
7689
8583
 
7690
8584
  **Examples:**
@@ -8114,6 +9008,415 @@ Text component
8114
9008
  ```
8115
9009
 
8116
9010
 
9011
+ ---
9012
+
9013
+ ### TimeseriesChart
9014
+
9015
+ TimeseriesChart — a time-series line or bar chart.
9016
+
9017
+ **Type:** component
9018
+
9019
+ **Import:** `import { TimeseriesChart } from "@cloudflare/kumo";`
9020
+
9021
+ **Category:** Data Visualization
9022
+
9023
+ **Props:**
9024
+
9025
+ - `echarts`: typeof echarts (required)
9026
+ 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).
9027
+ - `type`: "line" | "bar"
9028
+ Visual style of each series. Defaults to `"line"`.
9029
+ - `data`: TimeseriesData[] (required)
9030
+ Array of time series data to display on the chart
9031
+ - `markers`: TimeseriesMarker[]
9032
+ Vertical reference markers rendered on the time axis.
9033
+ - `thresholds`: TimeseriesThreshold[]
9034
+ Horizontal threshold lines rendered on the value axis.
9035
+ - `xAxisName`: string
9036
+ Label for the x-axis (time axis)
9037
+ - `xAxisTickCount`: number
9038
+ Number of ticks to display on the x-axis
9039
+ - `xAxisTickFormat`: (value: number) => string
9040
+ Custom formatter for x-axis tick labels. Receives the raw timestamp in milliseconds and returns a display string, overriding ECharts' built-in time formatting.
9041
+ - `yAxisTickFormat`: (value: number) => string
9042
+ Custom formatter for y-axis tick labels. Receives the raw value and returns a display string. When omitted, ECharts' built-in formatter is used.
9043
+ - `yAxisTickLabelFormat`: (value: number) => string
9044
+ - `yAxisName`: string
9045
+ Label for the y-axis (value axis)
9046
+ - `yAxisTickCount`: number
9047
+ Number of ticks to display on the y-axis
9048
+ - `tooltipValueFormat`: (value: number) => string
9049
+ 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.
9050
+ - `tooltipMode`: "all" | "single"
9051
+ 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
9052
+ - `tooltipMaxItems`: number
9053
+ 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`.
9054
+ - `tooltipBoundary`: "clipping-ancestors" | Element | Element[]
9055
+ 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.
9056
+ - `tooltipFollowCursor`: "both" | "x"
9057
+ 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.
9058
+ - `incomplete`: { before?: number; after?: number }
9059
+ Indicates incomplete data periods with optional before/after timestamps in ms
9060
+ - `enableLegendSelection`: boolean
9061
+ 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.
9062
+ - `height`: number
9063
+ Height of the chart in pixels. Defaults to `350`.
9064
+ - `isDarkMode`: boolean
9065
+ When `true`, switches the chart to ECharts' built-in dark theme
9066
+ - `gradient`: boolean
9067
+ 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"`.
9068
+ - `loading`: boolean
9069
+ When `true`, hides the chart and displays an animated sine-wave skeleton that oscillates back and forth to indicate that data is being fetched.
9070
+ - `ariaDescription`: string
9071
+ 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.
9072
+ - `optionUpdateBehavior`: SetOptionOpts
9073
+ Additional options passed as the second argument to `chart.setOption()`. Defaults to `{ notMerge: false, lazyUpdate: true }`.
9074
+
9075
+ **Colors (kumo tokens used):**
9076
+
9077
+ `bg-kumo-base`, `outline-kumo-fill`
9078
+
9079
+ **Examples:**
9080
+
9081
+ ```tsx
9082
+ <Chart
9083
+ echarts={echarts}
9084
+ options={options}
9085
+ height={400}
9086
+ isDarkMode={isDarkMode}
9087
+ />
9088
+ ```
9089
+
9090
+ ```tsx
9091
+ <TimeseriesChart
9092
+ echarts={echarts}
9093
+ isDarkMode={isDarkMode}
9094
+ data={data}
9095
+ xAxisName="Time (UTC)"
9096
+ yAxisName="Count"
9097
+ />
9098
+ ```
9099
+
9100
+ ```tsx
9101
+ <TimeseriesChart
9102
+ echarts={echarts}
9103
+ isDarkMode={isDarkMode}
9104
+ data={data}
9105
+ markers={markers}
9106
+ xAxisName="Time (UTC)"
9107
+ yAxisName="Count"
9108
+ />
9109
+ ```
9110
+
9111
+ ```tsx
9112
+ <TimeseriesChart
9113
+ echarts={echarts}
9114
+ isDarkMode={isDarkMode}
9115
+ data={data}
9116
+ thresholds={[
9117
+ {
9118
+ value: 55,
9119
+ label: "Memory limit",
9120
+ color: ChartPalette.semantic("Attention", isDarkMode),
9121
+ },
9122
+ ]}
9123
+ xAxisName="Time (UTC)"
9124
+ yAxisName="Memory (MB)"
9125
+ />
9126
+ ```
9127
+
9128
+ ```tsx
9129
+ <TimeseriesChart
9130
+ echarts={echarts}
9131
+ isDarkMode={isDarkMode}
9132
+ data={data}
9133
+ xAxisName="Time (UTC)"
9134
+ yAxisName="Requests"
9135
+ xAxisTickFormat={(ts) => {
9136
+ const d = new Date(ts);
9137
+ return `${d.getHours().toString().padStart(2, "0")}:${d.getMinutes().toString().padStart(2, "0")}`;
9138
+ }}
9139
+ yAxisTickFormat={(value) => {
9140
+ if (value >= 1000) return `${value / 1000}k`;
9141
+ return value.toString();
9142
+ }}
9143
+ tooltipValueFormat={(value) => `${(value / 1000).toFixed(1)}k requests`}
9144
+ />
9145
+ ```
9146
+
9147
+ ```tsx
9148
+ <TimeseriesChart
9149
+ yAxisTickCount={2}
9150
+ echarts={echarts}
9151
+ isDarkMode={isDarkMode}
9152
+ data={data}
9153
+ height={160}
9154
+ />
9155
+ ```
9156
+
9157
+ ```tsx
9158
+ <TimeseriesChart
9159
+ echarts={echarts}
9160
+ isDarkMode={isDarkMode}
9161
+ data={data}
9162
+ xAxisName="Time (UTC)"
9163
+ yAxisName="Mbps"
9164
+ incomplete={{ after: incompleteTimestamp }}
9165
+ />
9166
+ ```
9167
+
9168
+ ```tsx
9169
+ <TimeseriesChart
9170
+ echarts={echarts}
9171
+ isDarkMode={isDarkMode}
9172
+ data={data}
9173
+ xAxisName="Time (UTC)"
9174
+ yAxisName="%"
9175
+ onTimeRangeChange={(from, to) => {
9176
+ alert(
9177
+ `Selected range:\nFrom: ${new Date(from).toLocaleString()}\nTo: ${new Date(to).toLocaleString()}`,
9178
+ );
9179
+ }}
9180
+ />
9181
+ ```
9182
+
9183
+ ```tsx
9184
+ <div className="space-y-4">
9185
+ <h3 className="text-sm font-medium">Active State</h3>
9186
+
9187
+ <div className="flex flex-wrap gap-4 divide-x divide-kumo-hairline">
9188
+ <ChartLegend.LargeItem
9189
+ name="Requests"
9190
+ color={ChartPalette.semantic("Neutral", isDarkMode)}
9191
+ value="1,234"
9192
+ unit="req/s"
9193
+ />
9194
+ <ChartLegend.LargeItem
9195
+ name="Storage"
9196
+ color={ChartPalette.semantic("Attention", isDarkMode)}
9197
+ value="56"
9198
+ unit="GB"
9199
+ />
9200
+ <ChartLegend.LargeItem
9201
+ name="Warnings"
9202
+ color={ChartPalette.semantic("Warning", isDarkMode)}
9203
+ value="128"
9204
+ />
9205
+ </div>
9206
+
9207
+ <h3 className="text-sm font-medium mt-12">Inactive State</h3>
9208
+
9209
+ <div className="flex flex-wrap gap-4 divide-x divide-kumo-hairline">
9210
+ <ChartLegend.LargeItem
9211
+ name="Requests"
9212
+ color={ChartPalette.semantic("Neutral", isDarkMode)}
9213
+ value="1,234"
9214
+ unit="req/s"
9215
+ inactive
9216
+ />
9217
+ <ChartLegend.LargeItem
9218
+ name="Storage"
9219
+ color={ChartPalette.semantic("Attention", isDarkMode)}
9220
+ value="56"
9221
+ unit="GB"
9222
+ inactive
9223
+ />
9224
+ <ChartLegend.LargeItem
9225
+ name="Warnings"
9226
+ color={ChartPalette.semantic("Warning", isDarkMode)}
9227
+ value="128"
9228
+ inactive
9229
+ />
9230
+ </div>
9231
+ </div>
9232
+ ```
9233
+
9234
+ ```tsx
9235
+ <TimeseriesChart
9236
+ echarts={echarts}
9237
+ isDarkMode={isDarkMode}
9238
+ type="bar"
9239
+ data={data}
9240
+ xAxisName="Time (UTC)"
9241
+ yAxisName="Count"
9242
+ tooltipValueFormat={(r) => r.toFixed(2)}
9243
+ />
9244
+ ```
9245
+
9246
+ ```tsx
9247
+ <div className="flex flex-col flex-1 w-full">
9248
+ <TimeseriesChart
9249
+ echarts={echarts}
9250
+ isDarkMode={isDarkMode}
9251
+ xAxisName="Time (UTC)"
9252
+ yAxisName="Count"
9253
+ data={[]}
9254
+ loading
9255
+ />
9256
+ </div>
9257
+ ```
9258
+
9259
+ ```tsx
9260
+ <LayerCard>
9261
+ <LayerCard.Secondary>Read latency</LayerCard.Secondary>
9262
+ <LayerCard.Primary>
9263
+ <div className="flex divide-x divide-kumo-hairline gap-4 px-2 mb-2">
9264
+ <ChartLegend.LargeItem
9265
+ name="P99"
9266
+ color={ChartPalette.semantic("Attention", isDarkMode)}
9267
+ value="124"
9268
+ unit="ms"
9269
+ />
9270
+ <ChartLegend.LargeItem
9271
+ name="P95"
9272
+ color={ChartPalette.semantic("Warning", isDarkMode)}
9273
+ value="76"
9274
+ unit="ms"
9275
+ />
9276
+ <ChartLegend.LargeItem
9277
+ name="P75"
9278
+ color={ChartPalette.semantic("Neutral", isDarkMode)}
9279
+ value="32"
9280
+ unit="ms"
9281
+ />
9282
+ <ChartLegend.LargeItem
9283
+ name="P50"
9284
+ color={ChartPalette.semantic("Neutral", isDarkMode)}
9285
+ value="10"
9286
+ unit="ms"
9287
+ />
9288
+ </div>
9289
+ <TimeseriesChart
9290
+ xAxisName="Time (UTC)"
9291
+ echarts={echarts}
9292
+ isDarkMode={isDarkMode}
9293
+ data={data}
9294
+ height={300}
9295
+ />
9296
+ </LayerCard.Primary>
9297
+ </LayerCard>
9298
+ ```
9299
+
9300
+ ```tsx
9301
+ <LayerCard>
9302
+ <LayerCard.Secondary>Read latency</LayerCard.Secondary>
9303
+ <LayerCard.Primary>
9304
+ <div className="flex divide-x divide-kumo-line px-2 mb-2">
9305
+ {series.map((s) => (
9306
+ <ChartLegend.LargeItem
9307
+ key={s.name}
9308
+ name={s.name}
9309
+ color={s.color}
9310
+ value={s.value}
9311
+ unit={s.unit}
9312
+ inactive={hoveredSeries !== null && hoveredSeries !== s.name}
9313
+ onPointerEnter={() => {
9314
+ setHoveredSeries(s.name);
9315
+ chartRef.current?.dispatchAction({
9316
+ type: "highlight",
9317
+ seriesName: s.name,
9318
+ });
9319
+ }}
9320
+ onPointerLeave={() => {
9321
+ setHoveredSeries(null);
9322
+ chartRef.current?.dispatchAction({
9323
+ type: "downplay",
9324
+ seriesName: s.name,
9325
+ });
9326
+ }}
9327
+ className="not-first:pl-4"
9328
+ />
9329
+ ))}
9330
+ </div>
9331
+ <TimeseriesChart
9332
+ ref={chartRef}
9333
+ xAxisName="Time (UTC)"
9334
+ echarts={echarts}
9335
+ isDarkMode={isDarkMode}
9336
+ data={data}
9337
+ height={300}
9338
+ />
9339
+ </LayerCard.Primary>
9340
+ </LayerCard>
9341
+ ```
9342
+
9343
+ ```tsx
9344
+ <LayerCard>
9345
+ <LayerCard.Secondary>Read latency</LayerCard.Secondary>
9346
+ <LayerCard.Primary>
9347
+ <div className="flex divide-x divide-kumo-line px-2 mb-2">
9348
+ {series.map((s) => (
9349
+ <ChartLegend.LargeItem
9350
+ key={s.name}
9351
+ name={s.name}
9352
+ color={s.color}
9353
+ value={s.value}
9354
+ unit={s.unit}
9355
+ inactive={hiddenSeries[s.name] ?? false}
9356
+ onClick={() => handleClick(s.name)}
9357
+ className="not-first:pl-4"
9358
+ />
9359
+ ))}
9360
+ </div>
9361
+ <TimeseriesChart
9362
+ ref={chartRef}
9363
+ xAxisName="Time (UTC)"
9364
+ echarts={echarts}
9365
+ isDarkMode={isDarkMode}
9366
+ data={data}
9367
+ height={300}
9368
+ enableLegendSelection
9369
+ />
9370
+ </LayerCard.Primary>
9371
+ </LayerCard>
9372
+ ```
9373
+
9374
+ ```tsx
9375
+ <div className="flex w-full flex-col gap-4">
9376
+ <Select
9377
+ label="Tooltip follow cursor"
9378
+ value={selected}
9379
+ onValueChange={(v) => {
9380
+ if (v) setSelected(v);
9381
+ }}
9382
+ renderValue={(v) => v.label}
9383
+ >
9384
+ {FOLLOW_CURSOR_OPTIONS.map((opt) => (
9385
+ <Select.Option key={opt.value} value={opt}>
9386
+ {opt.label}
9387
+ </Select.Option>
9388
+ ))}
9389
+ </Select>
9390
+ <TimeseriesChart
9391
+ echarts={echarts}
9392
+ isDarkMode={isDarkMode}
9393
+ data={data}
9394
+ xAxisName="Time (UTC)"
9395
+ yAxisName="Latency (ms)"
9396
+ tooltipFollowCursor={selected.value}
9397
+ />
9398
+ </div>
9399
+ ```
9400
+
9401
+ ```tsx
9402
+ <div
9403
+ ref={boundaryRef}
9404
+ className="w-full overflow-auto rounded-lg border border-kumo-line"
9405
+ style={{ height: 300 }}
9406
+ >
9407
+ <TimeseriesChart
9408
+ echarts={echarts}
9409
+ isDarkMode={isDarkMode}
9410
+ data={data}
9411
+ xAxisName="Time (UTC)"
9412
+ yAxisName="Count"
9413
+ height={280}
9414
+ tooltipBoundary={boundary ?? undefined}
9415
+ />
9416
+ </div>
9417
+ ```
9418
+
9419
+
8117
9420
  ---
8118
9421
 
8119
9422
  ### Toasty
@@ -8134,14 +9437,16 @@ Toasty — toast notification provider and viewport.
8134
9437
  - `"error"`: Error toast for critical issues
8135
9438
  - `"warning"`: Warning toast for cautionary messages
8136
9439
  - `"info"`: Info toast for neutral informational messages
8137
- - `className`: string
8138
- Additional CSS classes
8139
- - `children`: ReactNode
8140
- Child elements
9440
+ - `children`: React.ReactNode (required)
9441
+ Application content. Toasts render via a portal above this.
9442
+ - `container`: PortalContainer
9443
+ Container element for the portal. Use this to render toasts inside a Shadow DOM or custom container. Overrides `KumoPortalProvider` context.
9444
+ - `toastManager`: ReturnType<typeof createKumoToastManager>
9445
+ 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.
8141
9446
 
8142
9447
  **Colors (kumo tokens used):**
8143
9448
 
8144
- `bg-kumo-base`, `bg-kumo-contrast`, `bg-kumo-control`, `bg-kumo-danger-tint`, `bg-kumo-fill-hover`, `bg-kumo-info-tint`, `bg-kumo-success-tint`, `bg-kumo-warning-tint`, `border-kumo-fill`, `ring-kumo-danger`, `ring-kumo-hairline`, `ring-kumo-info`, `ring-kumo-line`, `ring-kumo-success`, `ring-kumo-warning`, `text-kumo-danger`, `text-kumo-default`, `text-kumo-info`, `text-kumo-subtle`, `text-kumo-success`, `text-kumo-warning`
9449
+ `bg-kumo-base`, `bg-kumo-control`, `bg-kumo-danger-tint`, `bg-kumo-info-tint`, `bg-kumo-success-tint`, `bg-kumo-warning-tint`, `border-kumo-fill`, `ring-kumo-danger`, `ring-kumo-hairline`, `ring-kumo-info`, `ring-kumo-line`, `ring-kumo-success`, `ring-kumo-warning`, `text-kumo-danger`, `text-kumo-default`, `text-kumo-info`, `text-kumo-subtle`, `text-kumo-success`, `text-kumo-warning`
8145
9450
 
8146
9451
  **Styling:**
8147
9452
 
@@ -8450,6 +9755,7 @@ Multi-line textarea input with Input variants and InputArea-specific dimensions
8450
9755
  - **Other:** Autocomplete, CloudflareLogo, DatePicker, Label, Link, SensitiveInput, Sidebar, Table, TableOfContents, Toolbar, DeleteResource
8451
9756
  - **Display:** Badge, Breadcrumbs, Code, Collapsible, Empty, LayerCard, Meter, Text
8452
9757
  - **Feedback:** Banner, Loader, Toasty
9758
+ - **Data Visualization:** BubbleMap, Chart, ChoroplethMap, SankeyChart, TimeseriesChart
8453
9759
  - **Action:** Button, ClipboardText
8454
9760
  - **Input:** Checkbox, Combobox, DateRangePicker, Field, Input, InputGroup, Radio, Select, Switch
8455
9761
  - **Navigation:** CommandPalette, MenuBar, Pagination, Tabs