@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
@@ -492,6 +492,144 @@
492
492
  }
493
493
  }
494
494
  },
495
+ "BubbleMap": {
496
+ "name": "BubbleMap",
497
+ "type": "component",
498
+ "description": "BubbleMap component",
499
+ "importPath": "@cloudflare/kumo",
500
+ "category": "Data Visualization",
501
+ "props": {
502
+ "echarts": {
503
+ "type": "typeof echarts",
504
+ "required": true,
505
+ "description": "The ECharts core instance imported by the consumer (passed in for tree-shaking). Requires `MapChart`, `ScatterChart`, `TooltipComponent`, and a renderer registered via `echarts.use([...])`."
506
+ },
507
+ "geoJson": {
508
+ "type": "MapGeoJson",
509
+ "required": true,
510
+ "description": "GeoJSON `FeatureCollection` for the land base."
511
+ },
512
+ "mapName": {
513
+ "type": "string",
514
+ "optional": true,
515
+ "description": "Optional stable ECharts map registry name. Set this when the same GeoJSON is parsed into new object instances across mounts and should reuse one global ECharts registration."
516
+ },
517
+ "data": {
518
+ "type": "T[]",
519
+ "required": true,
520
+ "description": "Raw data rows. Coordinates/value/name are read via the accessors below."
521
+ },
522
+ "lng": {
523
+ "type": "MapAccessor<T, number>",
524
+ "required": true,
525
+ "description": "Longitude accessor (key of `T` or `(row) => number`)."
526
+ },
527
+ "lat": {
528
+ "type": "MapAccessor<T, number>",
529
+ "required": true,
530
+ "description": "Latitude accessor (key of `T` or `(row) => number`)."
531
+ },
532
+ "value": {
533
+ "type": "MapAccessor<T, number>",
534
+ "required": true,
535
+ "description": "Value accessor — drives bubble size."
536
+ },
537
+ "name": {
538
+ "type": "MapAccessor<T, string>",
539
+ "optional": true,
540
+ "description": "Optional name accessor — used by the default tooltip."
541
+ },
542
+ "minRadius": {
543
+ "type": "number",
544
+ "optional": true,
545
+ "description": "Smallest bubble radius in px. Default: `6`."
546
+ },
547
+ "maxRadius": {
548
+ "type": "number",
549
+ "optional": true,
550
+ "description": "Largest bubble radius in px. Default: `26`."
551
+ },
552
+ "bubbleSize": {
553
+ "type": "(value: number) => number",
554
+ "optional": true,
555
+ "description": "Explicit bubble radius `(value) => px`. Overrides the default `minRadius`/`maxRadius` scaling."
556
+ },
557
+ "bubbleColor": {
558
+ "type": "MapStyle<T, string>",
559
+ "optional": true,
560
+ "description": "Bubble fill colour — constant or `(row) => color`. Defaults to the chart blue."
561
+ },
562
+ "bubbleBorderColor": {
563
+ "type": "MapStyle<T, string>",
564
+ "optional": true,
565
+ "description": "Bubble border colour — constant or `(row) => color`. Default: `transparent`."
566
+ },
567
+ "bubbleBorderWidth": {
568
+ "type": "MapStyle<T, number>",
569
+ "optional": true,
570
+ "description": "Bubble border width — constant or `(row) => px`. Default: `0`."
571
+ },
572
+ "center": {
573
+ "type": "[number, number]",
574
+ "optional": true,
575
+ "description": "Map center as `[longitude, latitude]`. Defaults to auto-fit."
576
+ },
577
+ "zoom": {
578
+ "type": "number",
579
+ "optional": true,
580
+ "description": "Zoom level — multiplies the auto-fit scale. Default: `1.25`."
581
+ },
582
+ "roam": {
583
+ "type": "boolean",
584
+ "optional": true,
585
+ "description": "Enable drag-to-pan and scroll-to-zoom. Default: `false`."
586
+ },
587
+ "projection": {
588
+ "type": "MapProjection | null",
589
+ "optional": true,
590
+ "description": "Geographic projection. Defaults to a latitude-clamped Mercator (flat 2D web-map look). Pass another d3-geo projection to override, or `null` for ECharts' raw equirectangular plotting. Use a stable reference (module-level or memoised): a new object each render rebuilds the view and resets a roamed/zoomed map."
591
+ },
592
+ "showTooltip": {
593
+ "type": "boolean",
594
+ "optional": true,
595
+ "description": "Show the tooltip. Default: `true`."
596
+ },
597
+ "valueFormat": {
598
+ "type": "(value: number) => string",
599
+ "optional": true,
600
+ "description": "Format the value for the default tooltip. Default: `toLocaleString()`."
601
+ },
602
+ "tooltipFormatter": {
603
+ "type": "(row: T) => string",
604
+ "optional": true,
605
+ "description": "Override the tooltip content for a row. Returns an HTML string rendered by ECharts' own tooltip. USE WITH CAUTION: the return value is injected as HTML. Escape any user-provided strings to avoid XSS."
606
+ },
607
+ "aspectRatio": {
608
+ "type": "number | string",
609
+ "optional": true,
610
+ "description": "Container aspect ratio as `width / height` (e.g. `1.7` or `\"16 / 9\"`). The height derives from the rendered width so the map fills the frame with no letterboxing. Defaults to the projected aspect of the displayed window, so the land fits edge-to-edge. Pass `height` to fix a pixel height instead."
611
+ },
612
+ "height": {
613
+ "type": "number",
614
+ "optional": true,
615
+ "description": "Fixed chart height in pixels. Overrides `aspectRatio` when set. Leave unset to size by aspect ratio (the default) so the map fills the container."
616
+ },
617
+ "className": {
618
+ "type": "string",
619
+ "optional": true
620
+ },
621
+ "isDarkMode": {
622
+ "type": "boolean",
623
+ "optional": true
624
+ }
625
+ },
626
+ "examples": [
627
+ "<BubbleMap<CfLocation>\n echarts={echarts}\n geoJson={geoJson}\n data={cloudflareLocations}\n lng=\"lon\"\n lat=\"lat\"\n name=\"city\"\n value={() => 1}\n bubbleColor=\"#F6821F\"\n minRadius={8}\n maxRadius={8}\n tooltipFormatter={(row) =>\n `<span style=\"font-size:12px\"><strong>${row.city}</strong><span style=\"color:var(--text-color-kumo-subtle);margin-left:8px\">${row.iata}</span></span>`\n }\n isDarkMode={isDarkMode}\n />",
628
+ "<BubbleMap<Colo>\n echarts={echarts}\n geoJson={geoJson}\n data={colos}\n lng=\"lon\"\n lat=\"lat\"\n name=\"city\"\n value=\"requests\"\n valueFormat={fmt}\n minRadius={8}\n isDarkMode={isDarkMode}\n />",
629
+ "<BubbleMap<Colo>\n echarts={echarts}\n geoJson={geoJson}\n data={colos2}\n lng=\"lon\"\n lat=\"lat\"\n name=\"city\"\n value=\"requests\"\n valueFormat={fmt}\n isDarkMode={isDarkMode}\n />"
630
+ ],
631
+ "colors": []
632
+ },
495
633
  "Button": {
496
634
  "name": "Button",
497
635
  "type": "component",
@@ -561,15 +699,17 @@
561
699
  "outline": "Bordered button with transparent background"
562
700
  },
563
701
  "classes": {
564
- "primary": "relative overflow-hidden bg-(--kumo-button-emphasis-bg) !text-white ring ring-(--kumo-button-emphasis-ring) disabled:opacity-50",
702
+ "primary": "relative overflow-hidden bg-(--kumo-button-emphasis-bg) !text-white ring ring-(--kumo-button-emphasis-ring) focus:ring-(--kumo-button-emphasis-ring) focus-visible:ring-(--kumo-button-emphasis-ring) active:ring-(--kumo-button-emphasis-ring) disabled:opacity-50",
565
703
  "secondary": "bg-kumo-base !text-kumo-default ring not-disabled:hover:bg-kumo-tint disabled:bg-kumo-base/50 disabled:!text-kumo-default/70 ring-kumo-line data-[state=open]:bg-kumo-base",
566
704
  "ghost": "text-kumo-default hover:bg-kumo-tint shadow-none bg-inherit",
567
- "destructive": "relative overflow-hidden bg-(--kumo-button-emphasis-bg) !text-white ring ring-(--kumo-button-emphasis-ring) disabled:opacity-50",
705
+ "destructive": "relative overflow-hidden bg-(--kumo-button-emphasis-bg) !text-white ring ring-(--kumo-button-emphasis-ring) focus:ring-(--kumo-button-emphasis-ring) focus-visible:ring-(--kumo-button-emphasis-ring) active:ring-(--kumo-button-emphasis-ring) disabled:opacity-50",
568
706
  "secondary-destructive": "bg-kumo-base !text-kumo-danger ring not-disabled:hover:!text-kumo-danger not-disabled:hover:ring-kumo-danger/30 disabled:bg-kumo-base/50 disabled:!text-kumo-danger/70 ring-kumo-line data-[state=open]:bg-kumo-base",
569
707
  "outline": "bg-transparent text-kumo-default ring ring-kumo-line transition-colors not-disabled:hover:text-kumo-strong not-disabled:hover:ring-kumo-focus/25"
570
708
  },
571
709
  "stateClasses": {
572
710
  "primary": {
711
+ "focus": "focus:ring-(--kumo-button-emphasis-ring) focus-visible:ring-(--kumo-button-emphasis-ring)",
712
+ "active": "active:ring-(--kumo-button-emphasis-ring)",
573
713
  "disabled": "disabled:opacity-50"
574
714
  },
575
715
  "secondary": {
@@ -581,6 +721,8 @@
581
721
  "hover": "hover:bg-kumo-tint"
582
722
  },
583
723
  "destructive": {
724
+ "focus": "focus:ring-(--kumo-button-emphasis-ring) focus-visible:ring-(--kumo-button-emphasis-ring)",
725
+ "active": "active:ring-(--kumo-button-emphasis-ring)",
584
726
  "disabled": "disabled:opacity-50"
585
727
  },
586
728
  "secondary-destructive": {
@@ -676,6 +818,73 @@
676
818
  "text-kumo-subtle"
677
819
  ]
678
820
  },
821
+ "Chart": {
822
+ "name": "Chart",
823
+ "type": "component",
824
+ "description": "Chart — a low-level wrapper around [Apache ECharts](https://echarts.apache.org).",
825
+ "importPath": "@cloudflare/kumo",
826
+ "category": "Data Visualization",
827
+ "props": {
828
+ "echarts": {
829
+ "type": "typeof echarts",
830
+ "required": true,
831
+ "description": "The ECharts core instance imported by the consumer. Passed in rather than imported directly so the consumer controls which ECharts modules are bundled (tree-shaking)."
832
+ },
833
+ "options": {
834
+ "type": "KumoChartOption",
835
+ "required": true,
836
+ "description": "ECharts option object — passed through to `chart.setOption()`"
837
+ },
838
+ "optionUpdateBehavior": {
839
+ "type": "SetOptionOpts",
840
+ "optional": true,
841
+ "description": "Additional options passed as the second argument to `chart.setOption()`. Defaults to `{ notMerge: false, lazyUpdate: true }`."
842
+ },
843
+ "className": {
844
+ "type": "string",
845
+ "optional": true,
846
+ "description": "Additional CSS classes applied to the chart container `<div>`"
847
+ },
848
+ "isDarkMode": {
849
+ "type": "boolean",
850
+ "optional": true,
851
+ "description": "When `true`, initialises ECharts with its built-in dark theme. Changing this value after mount destroys and re-creates the chart instance."
852
+ },
853
+ "height": {
854
+ "type": "number",
855
+ "optional": true,
856
+ "description": "Height of the chart container in pixels. Defaults to `350`."
857
+ },
858
+ "aspectRatio": {
859
+ "type": "number | string",
860
+ "optional": true,
861
+ "description": "Container aspect ratio as `width / height` (e.g. `1.7` or `\"16 / 9\"`). When set, the height derives from the rendered width via CSS `aspect-ratio` and the `height` prop is ignored — useful for maps so the canvas matches the map's shape and fills the frame with no letterboxing."
862
+ }
863
+ },
864
+ "examples": [
865
+ "<Chart\n echarts={echarts}\n options={options}\n height={400}\n isDarkMode={isDarkMode}\n />",
866
+ "<TimeseriesChart\n echarts={echarts}\n isDarkMode={isDarkMode}\n data={data}\n xAxisName=\"Time (UTC)\"\n yAxisName=\"Count\"\n />",
867
+ "<TimeseriesChart\n echarts={echarts}\n isDarkMode={isDarkMode}\n data={data}\n markers={markers}\n xAxisName=\"Time (UTC)\"\n yAxisName=\"Count\"\n />",
868
+ "<TimeseriesChart\n echarts={echarts}\n isDarkMode={isDarkMode}\n data={data}\n thresholds={[\n {\n value: 55,\n label: \"Memory limit\",\n color: ChartPalette.semantic(\"Attention\", isDarkMode),\n },\n ]}\n xAxisName=\"Time (UTC)\"\n yAxisName=\"Memory (MB)\"\n />",
869
+ "<TimeseriesChart\n echarts={echarts}\n isDarkMode={isDarkMode}\n data={data}\n xAxisName=\"Time (UTC)\"\n yAxisName=\"Requests\"\n xAxisTickFormat={(ts) => {\n const d = new Date(ts);\n return `${d.getHours().toString().padStart(2, \"0\")}:${d.getMinutes().toString().padStart(2, \"0\")}`;\n }}\n yAxisTickFormat={(value) => {\n if (value >= 1000) return `${value / 1000}k`;\n return value.toString();\n }}\n tooltipValueFormat={(value) => `${(value / 1000).toFixed(1)}k requests`}\n />",
870
+ "<TimeseriesChart\n yAxisTickCount={2}\n echarts={echarts}\n isDarkMode={isDarkMode}\n data={data}\n height={160}\n />",
871
+ "<TimeseriesChart\n echarts={echarts}\n isDarkMode={isDarkMode}\n data={data}\n xAxisName=\"Time (UTC)\"\n yAxisName=\"Count\"\n gradient\n />",
872
+ "<TimeseriesChart\n echarts={echarts}\n isDarkMode={isDarkMode}\n data={data}\n xAxisName=\"Time (UTC)\"\n yAxisName=\"Mbps\"\n incomplete={{ after: incompleteTimestamp }}\n />",
873
+ "<TimeseriesChart\n echarts={echarts}\n isDarkMode={isDarkMode}\n data={data}\n xAxisName=\"Time (UTC)\"\n yAxisName=\"%\"\n onTimeRangeChange={(from, to) => {\n alert(\n `Selected range:\\nFrom: ${new Date(from).toLocaleString()}\\nTo: ${new Date(to).toLocaleString()}`,\n );\n }}\n />",
874
+ "<Chart\n echarts={echarts}\n options={options}\n height={160}\n isDarkMode={isDarkMode}\n />",
875
+ "<div className=\"space-y-4\">\n <h3 className=\"text-sm font-medium\">Active State</h3>\n\n <div className=\"flex flex-wrap gap-4 divide-x divide-kumo-hairline\">\n <ChartLegend.LargeItem\n name=\"Requests\"\n color={ChartPalette.semantic(\"Neutral\", isDarkMode)}\n value=\"1,234\"\n unit=\"req/s\"\n />\n <ChartLegend.LargeItem\n name=\"Storage\"\n color={ChartPalette.semantic(\"Attention\", isDarkMode)}\n value=\"56\"\n unit=\"GB\"\n />\n <ChartLegend.LargeItem\n name=\"Warnings\"\n color={ChartPalette.semantic(\"Warning\", isDarkMode)}\n value=\"128\"\n />\n </div>\n\n <h3 className=\"text-sm font-medium mt-12\">Inactive State</h3>\n\n <div className=\"flex flex-wrap gap-4 divide-x divide-kumo-hairline\">\n <ChartLegend.LargeItem\n name=\"Requests\"\n color={ChartPalette.semantic(\"Neutral\", isDarkMode)}\n value=\"1,234\"\n unit=\"req/s\"\n inactive\n />\n <ChartLegend.LargeItem\n name=\"Storage\"\n color={ChartPalette.semantic(\"Attention\", isDarkMode)}\n value=\"56\"\n unit=\"GB\"\n inactive\n />\n <ChartLegend.LargeItem\n name=\"Warnings\"\n color={ChartPalette.semantic(\"Warning\", isDarkMode)}\n value=\"128\"\n inactive\n />\n </div>\n </div>",
876
+ "<div className=\"space-y-4\">\n <h3 className=\"text-sm font-medium\">Active State</h3>\n <div className=\"flex flex-wrap gap-4\">\n <ChartLegend.SmallItem\n name=\"Requests\"\n color={ChartPalette.semantic(\"Neutral\", isDarkMode)}\n value=\"1,234\"\n unit=\"req/s\"\n />\n <ChartLegend.SmallItem\n name=\"Storage\"\n color={ChartPalette.semantic(\"Attention\", isDarkMode)}\n value=\"56\"\n unit=\"GB\"\n />\n <ChartLegend.SmallItem\n name=\"Warnings\"\n color={ChartPalette.semantic(\"Warning\", isDarkMode)}\n value=\"128\"\n />\n </div>\n\n <h3 className=\"text-sm font-medium mt-12\">Inactive State</h3>\n <div className=\"flex flex-wrap gap-4\">\n <ChartLegend.SmallItem\n name=\"Requests\"\n color={ChartPalette.semantic(\"Neutral\", isDarkMode)}\n value=\"1,234\"\n unit=\"req/s\"\n inactive\n />\n <ChartLegend.SmallItem\n name=\"Storage\"\n color={ChartPalette.semantic(\"Attention\", isDarkMode)}\n value=\"56\"\n unit=\"GB\"\n inactive\n />\n <ChartLegend.SmallItem\n name=\"Warnings\"\n color={ChartPalette.semantic(\"Warning\", isDarkMode)}\n value=\"128\"\n inactive\n />\n </div>\n </div>",
877
+ "<TimeseriesChart\n echarts={echarts}\n isDarkMode={isDarkMode}\n type=\"bar\"\n data={data}\n xAxisName=\"Time (UTC)\"\n yAxisName=\"Count\"\n tooltipValueFormat={(r) => r.toFixed(2)}\n />",
878
+ "<div className=\"flex flex-col flex-1 w-full\">\n <TimeseriesChart\n echarts={echarts}\n isDarkMode={isDarkMode}\n xAxisName=\"Time (UTC)\"\n yAxisName=\"Count\"\n data={[]}\n loading\n />\n </div>",
879
+ "<LayerCard>\n <LayerCard.Secondary>Read latency</LayerCard.Secondary>\n <LayerCard.Primary>\n <div className=\"flex divide-x divide-kumo-hairline gap-4 px-2 mb-2\">\n <ChartLegend.LargeItem\n name=\"P99\"\n color={ChartPalette.semantic(\"Attention\", isDarkMode)}\n value=\"124\"\n unit=\"ms\"\n />\n <ChartLegend.LargeItem\n name=\"P95\"\n color={ChartPalette.semantic(\"Warning\", isDarkMode)}\n value=\"76\"\n unit=\"ms\"\n />\n <ChartLegend.LargeItem\n name=\"P75\"\n color={ChartPalette.semantic(\"Neutral\", isDarkMode)}\n value=\"32\"\n unit=\"ms\"\n />\n <ChartLegend.LargeItem\n name=\"P50\"\n color={ChartPalette.semantic(\"Neutral\", isDarkMode)}\n value=\"10\"\n unit=\"ms\"\n />\n </div>\n <TimeseriesChart\n xAxisName=\"Time (UTC)\"\n echarts={echarts}\n isDarkMode={isDarkMode}\n data={data}\n height={300}\n />\n </LayerCard.Primary>\n </LayerCard>",
880
+ "<LayerCard>\n <LayerCard.Secondary>Read latency</LayerCard.Secondary>\n <LayerCard.Primary>\n <div className=\"flex divide-x divide-kumo-line px-2 mb-2\">\n {series.map((s) => (\n <ChartLegend.LargeItem\n key={s.name}\n name={s.name}\n color={s.color}\n value={s.value}\n unit={s.unit}\n inactive={hoveredSeries !== null && hoveredSeries !== s.name}\n onPointerEnter={() => {\n setHoveredSeries(s.name);\n chartRef.current?.dispatchAction({\n type: \"highlight\",\n seriesName: s.name,\n });\n }}\n onPointerLeave={() => {\n setHoveredSeries(null);\n chartRef.current?.dispatchAction({\n type: \"downplay\",\n seriesName: s.name,\n });\n }}\n className=\"not-first:pl-4\"\n />\n ))}\n </div>\n <TimeseriesChart\n ref={chartRef}\n xAxisName=\"Time (UTC)\"\n echarts={echarts}\n isDarkMode={isDarkMode}\n data={data}\n height={300}\n />\n </LayerCard.Primary>\n </LayerCard>",
881
+ "<LayerCard>\n <LayerCard.Secondary>Read latency</LayerCard.Secondary>\n <LayerCard.Primary>\n <div className=\"flex divide-x divide-kumo-line px-2 mb-2\">\n {series.map((s) => (\n <ChartLegend.LargeItem\n key={s.name}\n name={s.name}\n color={s.color}\n value={s.value}\n unit={s.unit}\n inactive={hiddenSeries[s.name] ?? false}\n onClick={() => handleClick(s.name)}\n className=\"not-first:pl-4\"\n />\n ))}\n </div>\n <TimeseriesChart\n ref={chartRef}\n xAxisName=\"Time (UTC)\"\n echarts={echarts}\n isDarkMode={isDarkMode}\n data={data}\n height={300}\n enableLegendSelection\n />\n </LayerCard.Primary>\n </LayerCard>",
882
+ "<Chart\n echarts={echarts}\n options={options}\n height={400}\n isDarkMode={isDarkMode}\n />",
883
+ "<div className=\"flex w-full flex-col gap-4\">\n <Select\n label=\"Tooltip follow cursor\"\n value={selected}\n onValueChange={(v) => {\n if (v) setSelected(v);\n }}\n renderValue={(v) => v.label}\n >\n {FOLLOW_CURSOR_OPTIONS.map((opt) => (\n <Select.Option key={opt.value} value={opt}>\n {opt.label}\n </Select.Option>\n ))}\n </Select>\n <TimeseriesChart\n echarts={echarts}\n isDarkMode={isDarkMode}\n data={data}\n xAxisName=\"Time (UTC)\"\n yAxisName=\"Latency (ms)\"\n tooltipFollowCursor={selected.value}\n />\n </div>",
884
+ "<div\n ref={boundaryRef}\n className=\"w-full overflow-auto rounded-lg border border-kumo-line\"\n style={{ height: 300 }}\n >\n <TimeseriesChart\n echarts={echarts}\n isDarkMode={isDarkMode}\n data={data}\n xAxisName=\"Time (UTC)\"\n yAxisName=\"Count\"\n height={280}\n tooltipBoundary={boundary ?? undefined}\n />\n </div>"
885
+ ],
886
+ "colors": []
887
+ },
679
888
  "Checkbox": {
680
889
  "name": "Checkbox",
681
890
  "type": "component",
@@ -791,39 +1000,48 @@
791
1000
  "props": {
792
1001
  "legend": {
793
1002
  "type": "string",
794
- "optional": true
1003
+ "optional": true,
1004
+ "description": "Legend text for the group. For more control over legend styling, omit this prop and use `<Checkbox.Legend>` as a child instead."
795
1005
  },
796
1006
  "children": {
797
1007
  "type": "ReactNode",
798
- "required": true
1008
+ "required": true,
1009
+ "description": "Child Checkbox.Item components (and optionally a Checkbox.Legend)"
799
1010
  },
800
1011
  "error": {
801
1012
  "type": "string",
802
- "optional": true
1013
+ "optional": true,
1014
+ "description": "Error message for the group (only appears in groups, not single checkboxes)"
803
1015
  },
804
1016
  "description": {
805
1017
  "type": "ReactNode",
806
- "optional": true
1018
+ "optional": true,
1019
+ "description": "Helper text for the group"
807
1020
  },
808
1021
  "value": {
809
1022
  "type": "string[]",
810
- "optional": true
1023
+ "optional": true,
1024
+ "description": "Values of checkboxes that should be checked (controlled)"
811
1025
  },
812
1026
  "allValues": {
813
1027
  "type": "string[]",
814
- "optional": true
1028
+ "optional": true,
1029
+ "description": "All possible checkbox values (required for parent checkbox pattern)"
815
1030
  },
816
1031
  "disabled": {
817
1032
  "type": "boolean",
818
- "optional": true
1033
+ "optional": true,
1034
+ "description": "Whether all checkboxes in the group are disabled"
819
1035
  },
820
1036
  "controlFirst": {
821
1037
  "type": "boolean",
822
- "optional": true
1038
+ "optional": true,
1039
+ "description": "When true (default), checkbox appears before label. When false, label appears before checkbox."
823
1040
  },
824
1041
  "className": {
825
1042
  "type": "string",
826
- "optional": true
1043
+ "optional": true,
1044
+ "description": "Additional CSS classes"
827
1045
  }
828
1046
  }
829
1047
  },
@@ -833,11 +1051,13 @@
833
1051
  "props": {
834
1052
  "children": {
835
1053
  "type": "ReactNode",
836
- "required": true
1054
+ "required": true,
1055
+ "description": "Legend content"
837
1056
  },
838
1057
  "className": {
839
1058
  "type": "string",
840
- "optional": true
1059
+ "optional": true,
1060
+ "description": "Additional CSS classes (e.g. \"sr-only\" to visually hide the legend)"
841
1061
  }
842
1062
  }
843
1063
  }
@@ -886,6 +1106,122 @@
886
1106
  ]
887
1107
  }
888
1108
  },
1109
+ "ChoroplethMap": {
1110
+ "name": "ChoroplethMap",
1111
+ "type": "component",
1112
+ "description": "ChoroplethMap component",
1113
+ "importPath": "@cloudflare/kumo",
1114
+ "category": "Data Visualization",
1115
+ "props": {
1116
+ "echarts": {
1117
+ "type": "typeof echarts",
1118
+ "required": true,
1119
+ "description": "The ECharts core instance imported by the consumer (passed in for tree-shaking). Requires `MapChart`, `VisualMapComponent`, `TooltipComponent`, and a renderer registered via `echarts.use([...])`."
1120
+ },
1121
+ "geoJson": {
1122
+ "type": "MapGeoJson",
1123
+ "required": true,
1124
+ "description": "GeoJSON `FeatureCollection` whose regions are shaded by value."
1125
+ },
1126
+ "mapName": {
1127
+ "type": "string",
1128
+ "optional": true,
1129
+ "description": "Optional stable ECharts map registry name. Set this when the same GeoJSON is parsed into new object instances across mounts and should reuse one global ECharts registration."
1130
+ },
1131
+ "data": {
1132
+ "type": "T[]",
1133
+ "required": true,
1134
+ "description": "Raw data rows. The region key and value are read via the accessors below."
1135
+ },
1136
+ "name": {
1137
+ "type": "MapAccessor<T, string>",
1138
+ "required": true,
1139
+ "description": "Region-key accessor (key of `T` or `(row) => string`). Each row is joined to a GeoJSON feature whose `nameProperty` equals this value."
1140
+ },
1141
+ "value": {
1142
+ "type": "MapAccessor<T, number>",
1143
+ "required": true,
1144
+ "description": "Value accessor — drives the region's fill colour."
1145
+ },
1146
+ "nameProperty": {
1147
+ "type": "string",
1148
+ "optional": true,
1149
+ "description": "GeoJSON feature property to join on. Default: `\"name\"`. Real-world data is often more reliably matched on an ISO-code property (e.g. `\"iso_a2\"`)."
1150
+ },
1151
+ "colorRange": {
1152
+ "type": "string[]",
1153
+ "optional": true,
1154
+ "description": "Sequential colour ramp (low → high). Defaults to the Kumo choropleth blues, tuned to stay distinct from the no-data fill. Distributed across the continuous gradient."
1155
+ },
1156
+ "noDataColor": {
1157
+ "type": "string",
1158
+ "optional": true,
1159
+ "description": "Fill for regions with no matching data row. Defaults to the neutral land grey."
1160
+ },
1161
+ "showLegend": {
1162
+ "type": "boolean",
1163
+ "optional": true,
1164
+ "description": "Show the visualMap colour legend. Default: `false`."
1165
+ },
1166
+ "showTooltip": {
1167
+ "type": "boolean",
1168
+ "optional": true,
1169
+ "description": "Show the tooltip. Default: `true`."
1170
+ },
1171
+ "valueFormat": {
1172
+ "type": "(value: number) => string",
1173
+ "optional": true,
1174
+ "description": "Format the value for the default tooltip. Default: `toLocaleString()`."
1175
+ },
1176
+ "tooltipFormatter": {
1177
+ "type": "(row: T) => string",
1178
+ "optional": true,
1179
+ "description": "Override the tooltip content for a row. Returns an HTML string rendered by ECharts' own tooltip. USE WITH CAUTION: the return value is injected as HTML. Escape any user-provided strings to avoid XSS."
1180
+ },
1181
+ "center": {
1182
+ "type": "[number, number]",
1183
+ "optional": true,
1184
+ "description": "Map center as `[longitude, latitude]`. Defaults to auto-fit."
1185
+ },
1186
+ "zoom": {
1187
+ "type": "number",
1188
+ "optional": true,
1189
+ "description": "Zoom level — multiplies the auto-fit scale. Default: `1.25`."
1190
+ },
1191
+ "roam": {
1192
+ "type": "boolean",
1193
+ "optional": true,
1194
+ "description": "Enable drag-to-pan and scroll-to-zoom. Default: `false`."
1195
+ },
1196
+ "projection": {
1197
+ "type": "MapProjection | null",
1198
+ "optional": true,
1199
+ "description": "Geographic projection. Defaults to a latitude-clamped Mercator (flat 2D web-map look). Pass another d3-geo projection to override, or `null` for ECharts' raw equirectangular plotting. Use a stable reference (module-level or memoised): a new object each render rebuilds the view and resets a roamed/zoomed map."
1200
+ },
1201
+ "aspectRatio": {
1202
+ "type": "number | string",
1203
+ "optional": true,
1204
+ "description": "Container aspect ratio as `width / height` (e.g. `1.7` or `\"16 / 9\"`). The height derives from the rendered width so the map fills the frame with no letterboxing. Defaults to the projected aspect of the displayed window, so the regions fit edge-to-edge. Pass `height` to fix a pixel height instead."
1205
+ },
1206
+ "height": {
1207
+ "type": "number",
1208
+ "optional": true,
1209
+ "description": "Fixed chart height in pixels. Overrides `aspectRatio` when set. Leave unset to size by aspect ratio (the default) so the map fills the container."
1210
+ },
1211
+ "className": {
1212
+ "type": "string",
1213
+ "optional": true
1214
+ },
1215
+ "isDarkMode": {
1216
+ "type": "boolean",
1217
+ "optional": true
1218
+ }
1219
+ },
1220
+ "examples": [
1221
+ "<ChoroplethMap<CountryTraffic>\n echarts={echarts}\n geoJson={geoJson}\n data={countries}\n name=\"country\"\n value=\"requests\"\n valueFormat={fmt}\n isDarkMode={isDarkMode}\n />"
1222
+ ],
1223
+ "colors": []
1224
+ },
889
1225
  "ClipboardText": {
890
1226
  "name": "ClipboardText",
891
1227
  "type": "component",
@@ -2219,11 +2555,13 @@
2219
2555
  "props": {
2220
2556
  "code": {
2221
2557
  "type": "string",
2222
- "required": true
2558
+ "required": true,
2559
+ "description": "The code string to display."
2223
2560
  },
2224
2561
  "lang": {
2225
2562
  "type": "CodeLang",
2226
- "optional": true
2563
+ "optional": true,
2564
+ "description": "Language hint for the code content."
2227
2565
  }
2228
2566
  }
2229
2567
  }
@@ -2285,7 +2623,8 @@
2285
2623
  "props": {
2286
2624
  "className": {
2287
2625
  "type": "string",
2288
- "optional": true
2626
+ "optional": true,
2627
+ "description": "Additional CSS classes"
2289
2628
  }
2290
2629
  }
2291
2630
  },
@@ -2295,7 +2634,8 @@
2295
2634
  "props": {
2296
2635
  "className": {
2297
2636
  "type": "string",
2298
- "optional": true
2637
+ "optional": true,
2638
+ "description": "Additional CSS classes"
2299
2639
  }
2300
2640
  }
2301
2641
  },
@@ -2305,7 +2645,8 @@
2305
2645
  "props": {
2306
2646
  "className": {
2307
2647
  "type": "string",
2308
- "optional": true
2648
+ "optional": true,
2649
+ "description": "Additional CSS classes"
2309
2650
  }
2310
2651
  }
2311
2652
  },
@@ -2315,11 +2656,13 @@
2315
2656
  "props": {
2316
2657
  "children": {
2317
2658
  "type": "ReactNode",
2318
- "required": true
2659
+ "required": true,
2660
+ "description": "Label text displayed in the trigger"
2319
2661
  },
2320
2662
  "className": {
2321
2663
  "type": "string",
2322
- "optional": true
2664
+ "optional": true,
2665
+ "description": "Additional CSS classes"
2323
2666
  }
2324
2667
  }
2325
2668
  },
@@ -2329,11 +2672,13 @@
2329
2672
  "props": {
2330
2673
  "children": {
2331
2674
  "type": "ReactNode",
2332
- "required": true
2675
+ "required": true,
2676
+ "description": "Panel content"
2333
2677
  },
2334
2678
  "className": {
2335
2679
  "type": "string",
2336
- "optional": true
2680
+ "optional": true,
2681
+ "description": "Additional CSS classes"
2337
2682
  }
2338
2683
  }
2339
2684
  }
@@ -2793,7 +3138,7 @@
2793
3138
  "size": {
2794
3139
  "type": "enum",
2795
3140
  "optional": true,
2796
- "description": "Dialog width.\n- `\"sm\"` — Small (min 288px) for simple confirmations\n- `\"base\"` — Default (min 384px)\n- `\"lg\"` — Large (min 512px) for complex content\n- `\"xl\"` — Extra large (min 768px) for detailed views",
3141
+ "description": "Dialog width.\n- `\"sm\"` — Small (288px) for simple confirmations\n- `\"base\"` — Default (384px)\n- `\"lg\"` — Large (512px) for complex content\n- `\"xl\"` — Extra large (768px) for detailed views",
2797
3142
  "values": [
2798
3143
  "base",
2799
3144
  "sm",
@@ -2801,16 +3146,16 @@
2801
3146
  "xl"
2802
3147
  ],
2803
3148
  "descriptions": {
2804
- "base": "Default dialog width",
2805
- "sm": "Small dialog for simple confirmations",
2806
- "lg": "Large dialog for complex content",
2807
- "xl": "Extra large dialog for detailed views"
3149
+ "base": "Default dialog width (384px)",
3150
+ "sm": "Small dialog for simple confirmations (288px)",
3151
+ "lg": "Large dialog for complex content (512px)",
3152
+ "xl": "Extra large dialog for detailed views (768px)"
2808
3153
  },
2809
3154
  "classes": {
2810
- "base": "sm:min-w-96",
2811
- "sm": "min-w-72",
2812
- "lg": "min-w-[32rem]",
2813
- "xl": "min-w-[48rem]"
3155
+ "base": "sm:w-96",
3156
+ "sm": "sm:w-72",
3157
+ "lg": "sm:w-[32rem]",
3158
+ "xl": "sm:w-[48rem]"
2814
3159
  },
2815
3160
  "default": "base"
2816
3161
  }
@@ -2823,7 +3168,8 @@
2823
3168
  "<Dialog.Root role=\"alertdialog\">\n <Dialog.Trigger\n render={(p) => (\n <Button {...p} variant=\"destructive\">\n Delete Account\n </Button>\n )}\n />\n <Dialog className=\"p-8\">\n <div className=\"mb-4 flex items-center gap-3\">\n <div className=\"flex h-10 w-10 items-center justify-center rounded-full bg-kumo-danger/20\">\n <Warning size={20} className=\"text-kumo-danger\" weight=\"fill\" />\n </div>\n <Dialog.Title className=\"text-xl font-semibold\">\n Delete Account?\n </Dialog.Title>\n </div>\n <Dialog.Description className=\"text-kumo-subtle\">\n This action cannot be undone. All your data will be permanently\n removed from our servers. Are you sure you want to proceed?\n </Dialog.Description>\n <div className=\"mt-8 flex justify-end gap-2\">\n <Dialog.Close\n render={(props) => (\n <Button variant=\"secondary\" {...props}>\n Cancel\n </Button>\n )}\n />\n <Dialog.Close\n render={(props) => (\n <Button variant=\"destructive\" {...props}>\n Delete Account\n </Button>\n )}\n />\n </div>\n </Dialog>\n </Dialog.Root>",
2824
3169
  "<Dialog.Root>\n <Dialog.Trigger render={(p) => <Button {...p}>Open Form</Button>} />\n <Dialog className=\"p-8\">\n <div className=\"mb-4 flex items-start justify-between gap-4\">\n <Dialog.Title className=\"text-2xl font-semibold\">\n Create Resource\n </Dialog.Title>\n <Dialog.Close\n aria-label=\"Close\"\n render={(props) => (\n <Button\n {...props}\n variant=\"secondary\"\n shape=\"square\"\n icon={<X />}\n aria-label=\"Close\"\n />\n )}\n />\n </div>\n <Dialog.Description className=\"mb-4 text-kumo-subtle\">\n Select a region for your new resource.\n </Dialog.Description>\n <Select\n className=\"w-full\"\n placeholder=\"Select region...\"\n renderValue={(v) =>\n regions.find((r) => r.value === v)?.label\n }\n >\n {regions.map((region) => (\n <Select.Option key={region.value} value={region.value}>\n {region.label}\n </Select.Option>\n ))}\n </Select>\n <div className=\"mt-8 flex justify-end gap-2\">\n <Dialog.Close\n render={(props) => (\n <Button variant=\"secondary\" {...props}>\n Cancel\n </Button>\n )}\n />\n <Button variant=\"primary\">Create</Button>\n </div>\n </Dialog>\n </Dialog.Root>",
2825
3170
  "<Dialog.Root>\n <Dialog.Trigger render={(p) => <Button {...p}>Open Form</Button>} />\n <Dialog className=\"p-8\">\n <div className=\"mb-4 flex items-start justify-between gap-4\">\n <Dialog.Title className=\"text-2xl font-semibold\">\n Create Resource\n </Dialog.Title>\n <Dialog.Close\n aria-label=\"Close\"\n render={(props) => (\n <Button\n {...props}\n variant=\"secondary\"\n shape=\"square\"\n icon={<X />}\n aria-label=\"Close\"\n />\n )}\n />\n </div>\n <Dialog.Description className=\"mb-4 text-kumo-subtle\">\n Search and select a region for your new resource.\n </Dialog.Description>\n <Combobox value={value} onValueChange={setValue} items={regions}>\n <Combobox.TriggerInput\n className=\"w-full\"\n placeholder=\"Search regions...\"\n />\n <Combobox.Content>\n <Combobox.Empty>No regions found</Combobox.Empty>\n <Combobox.List>\n {(item: { value: string; label: string }) => (\n <Combobox.Item key={item.value} value={item}>\n {item.label}\n </Combobox.Item>\n )}\n </Combobox.List>\n </Combobox.Content>\n </Combobox>\n <div className=\"mt-8 flex justify-end gap-2\">\n <Dialog.Close\n render={(props) => (\n <Button variant=\"secondary\" {...props}>\n Cancel\n </Button>\n )}\n />\n <Button variant=\"primary\">Create</Button>\n </div>\n </Dialog>\n </Dialog.Root>",
2826
- "<Dialog.Root>\n <Dialog.Trigger render={(p) => <Button {...p}>Open Form</Button>} />\n <Dialog className=\"p-8\">\n <div className=\"mb-4 flex items-start justify-between gap-4\">\n <Dialog.Title className=\"text-2xl font-semibold\">\n Resource Actions\n </Dialog.Title>\n <Dialog.Close\n aria-label=\"Close\"\n render={(props) => (\n <Button\n {...props}\n variant=\"secondary\"\n shape=\"square\"\n icon={<X />}\n aria-label=\"Close\"\n />\n )}\n />\n </div>\n <Dialog.Description className=\"mb-4 text-kumo-subtle\">\n Choose an action for the selected resource.\n </Dialog.Description>\n <DropdownMenu>\n <DropdownMenu.Trigger render={<Button>Actions</Button>} />\n <DropdownMenu.Content>\n <DropdownMenu.Item>Edit</DropdownMenu.Item>\n <DropdownMenu.Item>Duplicate</DropdownMenu.Item>\n <DropdownMenu.Separator />\n <DropdownMenu.Item variant=\"danger\">Delete</DropdownMenu.Item>\n </DropdownMenu.Content>\n </DropdownMenu>\n <div className=\"mt-8 flex justify-end\">\n <Dialog.Close\n render={(props) => (\n <Button variant=\"secondary\" {...props}>\n Close\n </Button>\n )}\n />\n </div>\n </Dialog>\n </Dialog.Root>"
3171
+ "<Dialog.Root>\n <Dialog.Trigger render={(p) => <Button {...p}>Open Form</Button>} />\n <Dialog className=\"p-8\">\n <div className=\"mb-4 flex items-start justify-between gap-4\">\n <Dialog.Title className=\"text-2xl font-semibold\">\n Resource Actions\n </Dialog.Title>\n <Dialog.Close\n aria-label=\"Close\"\n render={(props) => (\n <Button\n {...props}\n variant=\"secondary\"\n shape=\"square\"\n icon={<X />}\n aria-label=\"Close\"\n />\n )}\n />\n </div>\n <Dialog.Description className=\"mb-4 text-kumo-subtle\">\n Choose an action for the selected resource.\n </Dialog.Description>\n <DropdownMenu>\n <DropdownMenu.Trigger render={<Button>Actions</Button>} />\n <DropdownMenu.Content>\n <DropdownMenu.Item>Edit</DropdownMenu.Item>\n <DropdownMenu.Item>Duplicate</DropdownMenu.Item>\n <DropdownMenu.Separator />\n <DropdownMenu.Item variant=\"danger\">Delete</DropdownMenu.Item>\n </DropdownMenu.Content>\n </DropdownMenu>\n <div className=\"mt-8 flex justify-end\">\n <Dialog.Close\n render={(props) => (\n <Button variant=\"secondary\" {...props}>\n Close\n </Button>\n )}\n />\n </div>\n </Dialog>\n </Dialog.Root>",
3172
+ "<div className=\"flex flex-wrap gap-2\">\n {sizes.map(({ size, label, width }) => (\n <Dialog.Root key={size}>\n <Dialog.Trigger\n render={(p) => (\n <Button variant=\"secondary\" {...p}>\n {label} ({width})\n </Button>\n )}\n />\n <Dialog size={size} className=\"p-8\">\n <div className=\"mb-4 flex items-start justify-between gap-4\">\n <Dialog.Title className=\"text-2xl font-semibold\">\n {label} Dialog\n </Dialog.Title>\n <Dialog.Close\n aria-label=\"Close\"\n render={(props) => (\n <Button\n {...props}\n variant=\"secondary\"\n shape=\"square\"\n icon={<X />}\n aria-label=\"Close\"\n />\n )}\n />\n </div>\n <Dialog.Description className=\"text-kumo-subtle\">\n This <code>size=\"{size}\"</code> dialog should stay at {width} wide\n regardless of the content below.\n </Dialog.Description>\n <div className=\"mt-4 overflow-auto rounded-md border border-kumo-line\">\n <table className=\"w-max text-sm\">\n <thead className=\"bg-kumo-elevated text-left\">\n <tr>\n <th className=\"px-3 py-2\">Resource</th>\n <th className=\"px-3 py-2\">Region</th>\n <th className=\"px-3 py-2\">Status</th>\n <th className=\"px-3 py-2\">Latency</th>\n <th className=\"px-3 py-2\">Requests</th>\n <th className=\"px-3 py-2\">Last Deployed</th>\n </tr>\n </thead>\n <tbody className=\"divide-y divide-kumo-hairline\">\n <tr>\n <td className=\"px-3 py-2\">api-gateway-prod</td>\n <td className=\"px-3 py-2\">us-east-1</td>\n <td className=\"px-3 py-2 text-kumo-success\">Healthy</td>\n <td className=\"px-3 py-2\">12ms</td>\n <td className=\"px-3 py-2\">1,234,567</td>\n <td className=\"px-3 py-2\">2026-06-23</td>\n </tr>\n <tr>\n <td className=\"px-3 py-2\">worker-analytics</td>\n <td className=\"px-3 py-2\">eu-west-1</td>\n <td className=\"px-3 py-2 text-kumo-warning\">Degraded</td>\n <td className=\"px-3 py-2\">89ms</td>\n <td className=\"px-3 py-2\">456,789</td>\n <td className=\"px-3 py-2\">2026-06-22</td>\n </tr>\n </tbody>\n </table>\n </div>\n <div className=\"mt-6 flex justify-end gap-2\">\n <Dialog.Close\n render={(props) => (\n <Button variant=\"secondary\" {...props}>\n Close\n </Button>\n )}\n />\n </div>\n </Dialog>\n </Dialog.Root>\n ))}\n </div>"
2827
3173
  ],
2828
3174
  "colors": [
2829
3175
  "bg-kumo-base",
@@ -2962,6 +3308,7 @@
2962
3308
  "<DropdownMenu>\n <DropdownMenu.Trigger render={<Button>Edit</Button>} />\n <DropdownMenu.Content>\n <DropdownMenu.Item icon={PencilSimpleIcon}>Rename</DropdownMenu.Item>\n <DropdownMenu.Item icon={CopyIcon}>Duplicate</DropdownMenu.Item>\n <DropdownMenu.Separator />\n <DropdownMenu.Item inset>Move to folder</DropdownMenu.Item>\n <DropdownMenu.Item inset>Add to favorites</DropdownMenu.Item>\n <DropdownMenu.Separator />\n <DropdownMenu.Item icon={TrashIcon} variant=\"danger\">\n Delete\n </DropdownMenu.Item>\n </DropdownMenu.Content>\n </DropdownMenu>",
2963
3309
  "<div className=\"flex flex-col items-start gap-2\">\n <DropdownMenu>\n <DropdownMenu.Trigger render={<Button>Actions</Button>} />\n <DropdownMenu.Content>\n <DropdownMenu.Item\n icon={CopyIcon}\n onClick={() => setLastAction(\"Duplicated\")}\n >\n Duplicate\n </DropdownMenu.Item>\n <DropdownMenu.Item\n icon={PencilSimpleIcon}\n onClick={() => setLastAction(\"Renamed\")}\n >\n Rename\n </DropdownMenu.Item>\n <DropdownMenu.Separator />\n <DropdownMenu.Item\n icon={TrashIcon}\n variant=\"danger\"\n onClick={() => setLastAction(\"Deleted\")}\n >\n Delete\n </DropdownMenu.Item>\n </DropdownMenu.Content>\n </DropdownMenu>\n {lastAction && (\n <p className=\"text-sm text-kumo-subtle\">\n Last action: <span className=\"text-kumo-default\">{lastAction}</span>\n </p>\n )}\n </div>",
2964
3310
  "<DropdownMenu>\n <DropdownMenu.Trigger\n render={<button type=\"button\" className=\"rounded-full\" />}\n >\n <span className=\"flex h-8 w-8 items-center justify-center rounded-full bg-kumo-brand text-sm font-medium text-white\">\n MR\n </span>\n </DropdownMenu.Trigger>\n <DropdownMenu.Content>\n <DropdownMenu.Item icon={UserIcon}>Profile</DropdownMenu.Item>\n <DropdownMenu.Item icon={GearIcon}>Settings</DropdownMenu.Item>\n <DropdownMenu.Separator />\n <DropdownMenu.Item icon={SignOutIcon} variant=\"danger\">\n Log out\n </DropdownMenu.Item>\n </DropdownMenu.Content>\n </DropdownMenu>",
3311
+ "<DropdownMenu>\n <DropdownMenu.Trigger render={<Button>Open long list</Button>} />\n <DropdownMenu.Content>\n {items.map((item) => (\n <DropdownMenu.Item key={item}>{item}</DropdownMenu.Item>\n ))}\n </DropdownMenu.Content>\n </DropdownMenu>",
2965
3312
  "<DropdownMenu>\n <DropdownMenu.Trigger render={<Button>Resources</Button>} />\n <DropdownMenu.Content>\n <DropdownMenu.LinkItem href=\"/settings\" icon={GearIcon}>\n Settings\n </DropdownMenu.LinkItem>\n <DropdownMenu.LinkItem href=\"/docs\" icon={BookOpenIcon}>\n Documentation\n </DropdownMenu.LinkItem>\n <DropdownMenu.Separator />\n <DropdownMenu.LinkItem\n href=\"https://developers.cloudflare.com\"\n target=\"_blank\"\n icon={ArrowSquareOutIcon}\n >\n Developer Docs\n </DropdownMenu.LinkItem>\n </DropdownMenu.Content>\n </DropdownMenu>"
2966
3313
  ],
2967
3314
  "colors": [
@@ -4265,24 +4612,14 @@
4265
4612
  "description": "Info sub-component",
4266
4613
  "props": {
4267
4614
  "children": {
4268
- "type": "(props: {",
4269
- "optional": true
4270
- },
4271
- "page": {
4272
- "type": "number",
4273
- "required": true
4274
- },
4275
- "perPage": {
4276
- "type": "number",
4277
- "optional": true
4615
+ "type": "(props: {\n page: number;\n perPage?: number;\n totalCount?: number;\n pageShowingRange: string;\n }) => ReactNode",
4616
+ "optional": true,
4617
+ "description": "Custom render function for the info text"
4278
4618
  },
4279
- "totalCount": {
4280
- "type": "number",
4281
- "optional": true
4282
- },
4283
- "pageShowingRange": {
4619
+ "className": {
4284
4620
  "type": "string",
4285
- "required": true
4621
+ "optional": true,
4622
+ "description": "Additional CSS classes"
4286
4623
  }
4287
4624
  }
4288
4625
  },
@@ -4292,23 +4629,23 @@
4292
4629
  "props": {
4293
4630
  "value": {
4294
4631
  "type": "number",
4295
- "required": true
4632
+ "required": true,
4633
+ "description": "Current page size value"
4296
4634
  },
4297
4635
  "options": {
4298
4636
  "type": "number[]",
4299
- "optional": true
4300
- },
4301
- "page": {
4302
- "type": "\"",
4303
- "required": true
4637
+ "optional": true,
4638
+ "description": "Available page size options"
4304
4639
  },
4305
4640
  "label": {
4306
4641
  "type": "ReactNode",
4307
- "optional": true
4642
+ "optional": true,
4643
+ "description": "Label text shown before the selector."
4308
4644
  },
4309
4645
  "className": {
4310
4646
  "type": "string",
4311
- "optional": true
4647
+ "optional": true,
4648
+ "description": "Additional CSS classes"
4312
4649
  }
4313
4650
  }
4314
4651
  },
@@ -4316,17 +4653,15 @@
4316
4653
  "name": "Controls",
4317
4654
  "description": "Controls sub-component",
4318
4655
  "props": {
4319
- "Note": {
4320
- "type": "** `\"dropdown\"` renders an option for every page",
4321
- "required": true
4322
- },
4323
4656
  "pageSelector": {
4324
4657
  "type": "\"input\" | \"dropdown\"",
4325
- "optional": true
4658
+ "optional": true,
4659
+ "description": "How the page number selector is rendered in \"full\" controls mode. - `\"input\"` (default): A text input where users type a page number. - `\"dropdown\"`: A dropdown select with all page numbers as options. **Note:** `\"dropdown\"` renders an option for every page, so it is best suited for small page counts. For large datasets (hundreds of pages or more) prefer `\"input\"` to avoid rendering performance overhead."
4326
4660
  },
4327
4661
  "className": {
4328
4662
  "type": "string",
4329
- "optional": true
4663
+ "optional": true,
4664
+ "description": "Additional CSS classes"
4330
4665
  }
4331
4666
  }
4332
4667
  },
@@ -4336,7 +4671,8 @@
4336
4671
  "props": {
4337
4672
  "className": {
4338
4673
  "type": "string",
4339
- "optional": true
4674
+ "optional": true,
4675
+ "description": "Additional CSS classes"
4340
4676
  }
4341
4677
  }
4342
4678
  }
@@ -4448,43 +4784,66 @@
4448
4784
  }
4449
4785
  },
4450
4786
  "appearance": {
4451
- "type": "enum",
4452
- "values": [
4453
- "default",
4454
- "card"
4455
- ],
4456
- "default": "default",
4457
- "descriptions": {
4458
- "default": "Standard inline radio item",
4459
- "card": "Choice card appearance with border, padding, and highlighted selection state"
4460
- },
4461
- "classes": {
4462
- "card": "rounded-lg border border-kumo-hairline bg-kumo-base p-3 transition-colors hover:bg-kumo-tint has-[[data-checked]]:border-kumo-interact has-[[data-checked]]:bg-kumo-tint"
4463
- },
4464
- "stateClasses": {
4465
- "card": {
4466
- "hover": "hover:bg-kumo-tint"
4467
- }
4468
- }
4787
+ "type": "KumoRadioAppearance",
4788
+ "optional": true,
4789
+ "description": "Visual appearance applied to all Radio.Item children. - `\"default\"` — Standard inline radio items - `\"card\"` — Choice card with border, padding, and highlighted selection state Individual items can override this with their own `appearance` prop."
4469
4790
  },
4470
- "className": {
4791
+ "legend": {
4471
4792
  "type": "string",
4472
- "description": "Additional CSS classes"
4793
+ "optional": true,
4794
+ "description": "Legend text for the group (required for accessibility). For more control over legend styling, omit this prop and use `<Radio.Legend>` as a child instead."
4473
4795
  },
4474
4796
  "children": {
4475
4797
  "type": "ReactNode",
4476
- "description": "Child elements"
4798
+ "required": true,
4799
+ "description": "Child Radio.Item components (and optionally a Radio.Legend)"
4800
+ },
4801
+ "orientation": {
4802
+ "type": "\"vertical\" | \"horizontal\"",
4803
+ "optional": true,
4804
+ "description": "Layout direction of the radio items"
4805
+ },
4806
+ "error": {
4807
+ "type": "string",
4808
+ "optional": true,
4809
+ "description": "Error message for the group"
4810
+ },
4811
+ "description": {
4812
+ "type": "ReactNode",
4813
+ "optional": true,
4814
+ "description": "Helper text for the group"
4477
4815
  },
4478
4816
  "value": {
4479
4817
  "type": "T",
4818
+ "optional": true,
4480
4819
  "description": "The controlled value of the selected radio item."
4481
4820
  },
4482
- "defaultValue": {
4483
- "type": "T",
4484
- "description": "The uncontrolled initial value of the selected radio item."
4821
+ "disabled": {
4822
+ "type": "boolean",
4823
+ "optional": true,
4824
+ "description": "Whether all radios in the group are disabled"
4485
4825
  },
4486
- "onValueChange": {
4487
- "type": "(value: T, eventDetails: RadioGroupChangeEventDetails) => void",
4826
+ "controlPosition": {
4827
+ "type": "RadioControlPosition",
4828
+ "optional": true,
4829
+ "description": "Position of radio control relative to label: \"start\" puts radio before label, \"end\" puts label before radio. Defaults to \"start\" for default appearance and \"end\" for card appearance."
4830
+ },
4831
+ "name": {
4832
+ "type": "string",
4833
+ "optional": true,
4834
+ "description": "Form submission name for the radio group"
4835
+ },
4836
+ "className": {
4837
+ "type": "string",
4838
+ "optional": true,
4839
+ "description": "Additional CSS classes"
4840
+ },
4841
+ "defaultValue": {
4842
+ "type": "T",
4843
+ "description": "The uncontrolled initial value of the selected radio item."
4844
+ },
4845
+ "onValueChange": {
4846
+ "type": "(value: T, eventDetails: RadioGroupChangeEventDetails) => void",
4488
4847
  "description": "Callback fired when the selected value changes. The second argument carries native event details about the interaction."
4489
4848
  }
4490
4849
  },
@@ -4530,10 +4889,61 @@
4530
4889
  "name": "Group",
4531
4890
  "description": "Group sub-component",
4532
4891
  "props": {
4892
+ "legend": {
4893
+ "type": "string",
4894
+ "optional": true,
4895
+ "description": "Legend text for the group (required for accessibility). For more control over legend styling, omit this prop and use `<Radio.Legend>` as a child instead."
4896
+ },
4897
+ "children": {
4898
+ "type": "ReactNode",
4899
+ "required": true,
4900
+ "description": "Child Radio.Item components (and optionally a Radio.Legend)"
4901
+ },
4902
+ "orientation": {
4903
+ "type": "\"vertical\" | \"horizontal\"",
4904
+ "optional": true,
4905
+ "description": "Layout direction of the radio items"
4906
+ },
4907
+ "appearance": {
4908
+ "type": "KumoRadioAppearance",
4909
+ "optional": true,
4910
+ "description": "Visual appearance applied to all Radio.Item children. - `\"default\"` — Standard inline radio items - `\"card\"` — Choice card with border, padding, and highlighted selection state Individual items can override this with their own `appearance` prop."
4911
+ },
4912
+ "error": {
4913
+ "type": "string",
4914
+ "optional": true,
4915
+ "description": "Error message for the group"
4916
+ },
4917
+ "description": {
4918
+ "type": "ReactNode",
4919
+ "optional": true,
4920
+ "description": "Helper text for the group"
4921
+ },
4533
4922
  "value": {
4534
4923
  "type": "T",
4924
+ "optional": true,
4535
4925
  "description": "The controlled value of the selected radio item."
4536
4926
  },
4927
+ "disabled": {
4928
+ "type": "boolean",
4929
+ "optional": true,
4930
+ "description": "Whether all radios in the group are disabled"
4931
+ },
4932
+ "controlPosition": {
4933
+ "type": "RadioControlPosition",
4934
+ "optional": true,
4935
+ "description": "Position of radio control relative to label: \"start\" puts radio before label, \"end\" puts label before radio. Defaults to \"start\" for default appearance and \"end\" for card appearance."
4936
+ },
4937
+ "name": {
4938
+ "type": "string",
4939
+ "optional": true,
4940
+ "description": "Form submission name for the radio group"
4941
+ },
4942
+ "className": {
4943
+ "type": "string",
4944
+ "optional": true,
4945
+ "description": "Additional CSS classes"
4946
+ },
4537
4947
  "defaultValue": {
4538
4948
  "type": "T",
4539
4949
  "description": "The uncontrolled initial value of the selected radio item."
@@ -4550,16 +4960,123 @@
4550
4960
  "props": {
4551
4961
  "children": {
4552
4962
  "type": "ReactNode",
4553
- "required": true
4963
+ "required": true,
4964
+ "description": "Legend content"
4554
4965
  },
4555
4966
  "className": {
4556
4967
  "type": "string",
4557
- "optional": true
4968
+ "optional": true,
4969
+ "description": "Additional CSS classes (e.g. \"sr-only\" to visually hide the legend)"
4558
4970
  }
4559
4971
  }
4560
4972
  }
4561
4973
  }
4562
4974
  },
4975
+ "SankeyChart": {
4976
+ "name": "SankeyChart",
4977
+ "type": "component",
4978
+ "description": "SankeyChart component",
4979
+ "importPath": "@cloudflare/kumo",
4980
+ "category": "Data Visualization",
4981
+ "props": {
4982
+ "echarts": {
4983
+ "type": "typeof echarts",
4984
+ "required": true,
4985
+ "description": "The ECharts core instance imported by the consumer. Passed in rather than imported directly so the consumer controls which ECharts modules are bundled (tree-shaking)."
4986
+ },
4987
+ "nodes": {
4988
+ "type": "SankeyNodeData[]",
4989
+ "required": true,
4990
+ "description": "Array of nodes in the Sankey diagram"
4991
+ },
4992
+ "links": {
4993
+ "type": "SankeyLinkData[]",
4994
+ "required": true,
4995
+ "description": "Array of links connecting nodes by index"
4996
+ },
4997
+ "height": {
4998
+ "type": "number",
4999
+ "optional": true,
5000
+ "description": "Height of the chart in pixels"
5001
+ },
5002
+ "showNodeValues": {
5003
+ "type": "boolean",
5004
+ "optional": true,
5005
+ "description": "Show node values above labels (default: true if any node has a value)"
5006
+ },
5007
+ "nodeLabelLayout": {
5008
+ "type": "\"stacked\" | \"inline\"",
5009
+ "optional": true,
5010
+ "description": "Layout for node labels when showNodeValues is true. - 'stacked': value on top, name below (default) - 'inline': \"value name\" on a single line (better for small nodes)"
5011
+ },
5012
+ "formatValue": {
5013
+ "type": "(value: number) => string",
5014
+ "optional": true,
5015
+ "description": "Format function for node values (default: toLocaleString)"
5016
+ },
5017
+ "tooltipFormatter": {
5018
+ "type": "(params: SankeyTooltipParams) => string",
5019
+ "optional": true,
5020
+ "description": "Custom tooltip formatter. Return HTML string or empty string to hide tooltip."
5021
+ },
5022
+ "nodeWidth": {
5023
+ "type": "number",
5024
+ "optional": true
5025
+ },
5026
+ "nodePadding": {
5027
+ "type": "number",
5028
+ "optional": true
5029
+ },
5030
+ "showTooltip": {
5031
+ "type": "boolean",
5032
+ "optional": true
5033
+ },
5034
+ "defaultNodeColor": {
5035
+ "type": "string",
5036
+ "optional": true
5037
+ },
5038
+ "left": {
5039
+ "type": "number | string",
5040
+ "optional": true,
5041
+ "description": "Left padding of the Sankey layout within the chart container. Accepts a number (px) or percentage string. ECharts default: '5%'."
5042
+ },
5043
+ "right": {
5044
+ "type": "number | string",
5045
+ "optional": true,
5046
+ "description": "Right padding of the Sankey layout within the chart container. Accepts a number (px) or percentage string. ECharts default: '5%'."
5047
+ },
5048
+ "linkColor": {
5049
+ "type": "\"gradient\" | \"gray\"",
5050
+ "optional": true,
5051
+ "description": "Link fill style: 'gradient' blends source to target colors, 'gray' uses flat gray"
5052
+ },
5053
+ "linkOpacity": {
5054
+ "type": "number",
5055
+ "optional": true
5056
+ },
5057
+ "className": {
5058
+ "type": "string",
5059
+ "optional": true
5060
+ },
5061
+ "isDarkMode": {
5062
+ "type": "boolean",
5063
+ "optional": true
5064
+ }
5065
+ },
5066
+ "examples": [
5067
+ "<SankeyChart\n echarts={echarts}\n nodes={basicNodes}\n links={basicLinks}\n height={350}\n isDarkMode={isDarkMode}\n />",
5068
+ "<SankeyChart\n echarts={echarts}\n nodes={previewNodes}\n links={previewLinks}\n height={200}\n showTooltip={false}\n isDarkMode={isDarkMode}\n />",
5069
+ "<SankeyChart\n echarts={echarts}\n nodes={multiLevelNodes}\n links={multiLevelLinks}\n height={350}\n nodeWidth={20}\n nodePadding={15}\n isDarkMode={isDarkMode}\n />",
5070
+ "<SankeyChart\n echarts={echarts}\n nodes={nodes}\n links={links}\n height={250}\n linkOpacity={0.6}\n isDarkMode={isDarkMode}\n />",
5071
+ "<SankeyChart\n echarts={echarts}\n nodes={nodes}\n links={links}\n height={300}\n isDarkMode={isDarkMode}\n />",
5072
+ "<SankeyChart\n echarts={echarts}\n nodes={nodes}\n links={links}\n height={300}\n tooltipFormatter={customTooltip}\n isDarkMode={isDarkMode}\n />",
5073
+ "<SankeyChart\n echarts={echarts}\n nodes={basicNodes}\n links={basicLinks}\n height={350}\n left={0}\n right={0}\n isDarkMode={isDarkMode}\n />",
5074
+ "<SankeyChart\n echarts={echarts}\n nodes={basicNodes}\n links={basicLinks}\n height={350}\n onNodeClick={handleNodeClick}\n onLinkClick={handleLinkClick}\n isDarkMode={isDarkMode}\n />",
5075
+ "<div className=\"flex w-full flex-col gap-2\">\n <div className=\"flex items-center gap-2 text-sm text-kumo-subtle\">\n <span>\n {hasSelection\n ? `Showing: ${[selectedSource, selectedTarget].filter(Boolean).join(\" → \")}`\n : \"Click a node to filter\"}\n </span>\n {hasSelection && (\n <button\n onClick={resetFilters}\n className=\"text-kumo-brand hover:underline\"\n >\n Reset\n </button>\n )}\n </div>\n <SankeyChart\n echarts={echarts}\n nodes={filteredNodes}\n links={filteredLinks}\n height={300}\n onNodeClick={handleNodeClick}\n isDarkMode={isDarkMode}\n />\n </div>",
5076
+ "<SankeyChart\n echarts={echarts}\n nodes={nodes}\n links={links}\n height={300}\n nodeLabelLayout=\"inline\"\n isDarkMode={isDarkMode}\n />"
5077
+ ],
5078
+ "colors": []
5079
+ },
4563
5080
  "Select": {
4564
5081
  "name": "Select",
4565
5082
  "type": "component",
@@ -5038,19 +5555,23 @@
5038
5555
  "props": {
5039
5556
  "defaultOpen": {
5040
5557
  "type": "boolean",
5041
- "optional": true
5558
+ "optional": true,
5559
+ "description": "Initial open state when uncontrolled."
5042
5560
  },
5043
5561
  "open": {
5044
5562
  "type": "boolean",
5045
- "optional": true
5563
+ "optional": true,
5564
+ "description": "Controlled open state."
5046
5565
  },
5047
5566
  "variant": {
5048
5567
  "type": "SidebarVariant",
5049
- "optional": true
5568
+ "optional": true,
5569
+ "description": "Sidebar layout variant."
5050
5570
  },
5051
5571
  "side": {
5052
5572
  "type": "SidebarSide",
5053
- "optional": true
5573
+ "optional": true,
5574
+ "description": "Which side the sidebar is on."
5054
5575
  },
5055
5576
  "collapsible": {
5056
5577
  "type": "\"icon\" | \"offcanvas\" | \"none\"",
@@ -5058,43 +5579,53 @@
5058
5579
  },
5059
5580
  "resizable": {
5060
5581
  "type": "boolean",
5061
- "optional": true
5582
+ "optional": true,
5583
+ "description": "Enable drag-to-resize on the sidebar edge."
5062
5584
  },
5063
5585
  "defaultWidth": {
5064
5586
  "type": "number",
5065
- "optional": true
5587
+ "optional": true,
5588
+ "description": "Initial width in pixels when resizable."
5066
5589
  },
5067
5590
  "minWidth": {
5068
5591
  "type": "number",
5069
- "optional": true
5592
+ "optional": true,
5593
+ "description": "Minimum width in pixels when resizing."
5070
5594
  },
5071
5595
  "maxWidth": {
5072
5596
  "type": "number",
5073
- "optional": true
5597
+ "optional": true,
5598
+ "description": "Maximum width in pixels when resizing."
5074
5599
  },
5075
5600
  "contained": {
5076
5601
  "type": "boolean",
5077
- "optional": true
5602
+ "optional": true,
5603
+ "description": "When true, the collapsed sidebar uses absolute positioning instead of fixed, keeping it scoped inside a bounded parent. Useful for demos and embedded sidebars."
5078
5604
  },
5079
5605
  "peekable": {
5080
5606
  "type": "boolean",
5081
- "optional": true
5607
+ "optional": true,
5608
+ "description": "When true, hovering or focusing the collapsed sidebar temporarily expands it. The `state` will be `\"peeking\"` during the peek. Moving away collapses it back."
5082
5609
  },
5083
5610
  "animationDuration": {
5084
5611
  "type": "number",
5085
- "optional": true
5612
+ "optional": true,
5613
+ "description": "Duration of sidebar expand/collapse animation in milliseconds."
5086
5614
  },
5087
5615
  "mobileBreakpoint": {
5088
5616
  "type": "number",
5089
- "optional": true
5617
+ "optional": true,
5618
+ "description": "Viewport width (in px) below which the sidebar renders as a mobile dialog sheet instead of the desktop aside rail."
5090
5619
  },
5091
5620
  "children": {
5092
5621
  "type": "ReactNode",
5093
- "required": true
5622
+ "required": true,
5623
+ "description": "Content — typically `<Sidebar>` + main content."
5094
5624
  },
5095
5625
  "className": {
5096
5626
  "type": "string",
5097
- "optional": true
5627
+ "optional": true,
5628
+ "description": "Additional CSS classes for the wrapper div."
5098
5629
  }
5099
5630
  }
5100
5631
  },
@@ -5103,7 +5634,37 @@
5103
5634
  "description": "Header sub-component",
5104
5635
  "props": {
5105
5636
  "icon": {
5106
- "type": "React.ComponentType<{ className?: string",
5637
+ "type": "React.ComponentType<{ className?: string }> | React.ReactNode",
5638
+ "optional": true
5639
+ },
5640
+ "active": {
5641
+ "type": "boolean",
5642
+ "optional": true
5643
+ },
5644
+ "size": {
5645
+ "type": "SidebarMenuButtonSize",
5646
+ "optional": true,
5647
+ "description": "Button size. - `\"base\"` — Standard nav item - `\"sm\"` — Compact nav item"
5648
+ },
5649
+ "href": {
5650
+ "type": "string",
5651
+ "optional": true
5652
+ },
5653
+ "target": {
5654
+ "type": "React.HTMLAttributeAnchorTarget",
5655
+ "optional": true,
5656
+ "description": "Link target — only meaningful when `href` is provided."
5657
+ },
5658
+ "tooltip": {
5659
+ "type": "string",
5660
+ "optional": true
5661
+ },
5662
+ "className": {
5663
+ "type": "string",
5664
+ "optional": true
5665
+ },
5666
+ "children": {
5667
+ "type": "ReactNode",
5107
5668
  "optional": true
5108
5669
  }
5109
5670
  }
@@ -5113,7 +5674,37 @@
5113
5674
  "description": "Content sub-component",
5114
5675
  "props": {
5115
5676
  "icon": {
5116
- "type": "React.ComponentType<{ className?: string",
5677
+ "type": "React.ComponentType<{ className?: string }> | React.ReactNode",
5678
+ "optional": true
5679
+ },
5680
+ "active": {
5681
+ "type": "boolean",
5682
+ "optional": true
5683
+ },
5684
+ "size": {
5685
+ "type": "SidebarMenuButtonSize",
5686
+ "optional": true,
5687
+ "description": "Button size. - `\"base\"` — Standard nav item - `\"sm\"` — Compact nav item"
5688
+ },
5689
+ "href": {
5690
+ "type": "string",
5691
+ "optional": true
5692
+ },
5693
+ "target": {
5694
+ "type": "React.HTMLAttributeAnchorTarget",
5695
+ "optional": true,
5696
+ "description": "Link target — only meaningful when `href` is provided."
5697
+ },
5698
+ "tooltip": {
5699
+ "type": "string",
5700
+ "optional": true
5701
+ },
5702
+ "className": {
5703
+ "type": "string",
5704
+ "optional": true
5705
+ },
5706
+ "children": {
5707
+ "type": "ReactNode",
5117
5708
  "optional": true
5118
5709
  }
5119
5710
  }
@@ -5123,7 +5714,37 @@
5123
5714
  "description": "Footer sub-component",
5124
5715
  "props": {
5125
5716
  "icon": {
5126
- "type": "React.ComponentType<{ className?: string",
5717
+ "type": "React.ComponentType<{ className?: string }> | React.ReactNode",
5718
+ "optional": true
5719
+ },
5720
+ "active": {
5721
+ "type": "boolean",
5722
+ "optional": true
5723
+ },
5724
+ "size": {
5725
+ "type": "SidebarMenuButtonSize",
5726
+ "optional": true,
5727
+ "description": "Button size. - `\"base\"` — Standard nav item - `\"sm\"` — Compact nav item"
5728
+ },
5729
+ "href": {
5730
+ "type": "string",
5731
+ "optional": true
5732
+ },
5733
+ "target": {
5734
+ "type": "React.HTMLAttributeAnchorTarget",
5735
+ "optional": true,
5736
+ "description": "Link target — only meaningful when `href` is provided."
5737
+ },
5738
+ "tooltip": {
5739
+ "type": "string",
5740
+ "optional": true
5741
+ },
5742
+ "className": {
5743
+ "type": "string",
5744
+ "optional": true
5745
+ },
5746
+ "children": {
5747
+ "type": "ReactNode",
5127
5748
  "optional": true
5128
5749
  }
5129
5750
  }
@@ -5133,7 +5754,37 @@
5133
5754
  "description": "Group sub-component",
5134
5755
  "props": {
5135
5756
  "icon": {
5136
- "type": "React.ComponentType<{ className?: string",
5757
+ "type": "React.ComponentType<{ className?: string }> | React.ReactNode",
5758
+ "optional": true
5759
+ },
5760
+ "active": {
5761
+ "type": "boolean",
5762
+ "optional": true
5763
+ },
5764
+ "size": {
5765
+ "type": "SidebarMenuButtonSize",
5766
+ "optional": true,
5767
+ "description": "Button size. - `\"base\"` — Standard nav item - `\"sm\"` — Compact nav item"
5768
+ },
5769
+ "href": {
5770
+ "type": "string",
5771
+ "optional": true
5772
+ },
5773
+ "target": {
5774
+ "type": "React.HTMLAttributeAnchorTarget",
5775
+ "optional": true,
5776
+ "description": "Link target — only meaningful when `href` is provided."
5777
+ },
5778
+ "tooltip": {
5779
+ "type": "string",
5780
+ "optional": true
5781
+ },
5782
+ "className": {
5783
+ "type": "string",
5784
+ "optional": true
5785
+ },
5786
+ "children": {
5787
+ "type": "ReactNode",
5137
5788
  "optional": true
5138
5789
  }
5139
5790
  }
@@ -5143,7 +5794,37 @@
5143
5794
  "description": "GroupLabel sub-component",
5144
5795
  "props": {
5145
5796
  "icon": {
5146
- "type": "React.ComponentType<{ className?: string",
5797
+ "type": "React.ComponentType<{ className?: string }> | React.ReactNode",
5798
+ "optional": true
5799
+ },
5800
+ "active": {
5801
+ "type": "boolean",
5802
+ "optional": true
5803
+ },
5804
+ "size": {
5805
+ "type": "SidebarMenuButtonSize",
5806
+ "optional": true,
5807
+ "description": "Button size. - `\"base\"` — Standard nav item - `\"sm\"` — Compact nav item"
5808
+ },
5809
+ "href": {
5810
+ "type": "string",
5811
+ "optional": true
5812
+ },
5813
+ "target": {
5814
+ "type": "React.HTMLAttributeAnchorTarget",
5815
+ "optional": true,
5816
+ "description": "Link target — only meaningful when `href` is provided."
5817
+ },
5818
+ "tooltip": {
5819
+ "type": "string",
5820
+ "optional": true
5821
+ },
5822
+ "className": {
5823
+ "type": "string",
5824
+ "optional": true
5825
+ },
5826
+ "children": {
5827
+ "type": "ReactNode",
5147
5828
  "optional": true
5148
5829
  }
5149
5830
  }
@@ -5153,7 +5834,37 @@
5153
5834
  "description": "Menu sub-component",
5154
5835
  "props": {
5155
5836
  "icon": {
5156
- "type": "React.ComponentType<{ className?: string",
5837
+ "type": "React.ComponentType<{ className?: string }> | React.ReactNode",
5838
+ "optional": true
5839
+ },
5840
+ "active": {
5841
+ "type": "boolean",
5842
+ "optional": true
5843
+ },
5844
+ "size": {
5845
+ "type": "SidebarMenuButtonSize",
5846
+ "optional": true,
5847
+ "description": "Button size. - `\"base\"` — Standard nav item - `\"sm\"` — Compact nav item"
5848
+ },
5849
+ "href": {
5850
+ "type": "string",
5851
+ "optional": true
5852
+ },
5853
+ "target": {
5854
+ "type": "React.HTMLAttributeAnchorTarget",
5855
+ "optional": true,
5856
+ "description": "Link target — only meaningful when `href` is provided."
5857
+ },
5858
+ "tooltip": {
5859
+ "type": "string",
5860
+ "optional": true
5861
+ },
5862
+ "className": {
5863
+ "type": "string",
5864
+ "optional": true
5865
+ },
5866
+ "children": {
5867
+ "type": "ReactNode",
5157
5868
  "optional": true
5158
5869
  }
5159
5870
  }
@@ -5163,7 +5874,37 @@
5163
5874
  "description": "MenuItem sub-component",
5164
5875
  "props": {
5165
5876
  "icon": {
5166
- "type": "React.ComponentType<{ className?: string",
5877
+ "type": "React.ComponentType<{ className?: string }> | React.ReactNode",
5878
+ "optional": true
5879
+ },
5880
+ "active": {
5881
+ "type": "boolean",
5882
+ "optional": true
5883
+ },
5884
+ "size": {
5885
+ "type": "SidebarMenuButtonSize",
5886
+ "optional": true,
5887
+ "description": "Button size. - `\"base\"` — Standard nav item - `\"sm\"` — Compact nav item"
5888
+ },
5889
+ "href": {
5890
+ "type": "string",
5891
+ "optional": true
5892
+ },
5893
+ "target": {
5894
+ "type": "React.HTMLAttributeAnchorTarget",
5895
+ "optional": true,
5896
+ "description": "Link target — only meaningful when `href` is provided."
5897
+ },
5898
+ "tooltip": {
5899
+ "type": "string",
5900
+ "optional": true
5901
+ },
5902
+ "className": {
5903
+ "type": "string",
5904
+ "optional": true
5905
+ },
5906
+ "children": {
5907
+ "type": "ReactNode",
5167
5908
  "optional": true
5168
5909
  }
5169
5910
  }
@@ -5173,7 +5914,37 @@
5173
5914
  "description": "MenuButton sub-component",
5174
5915
  "props": {
5175
5916
  "icon": {
5176
- "type": "React.ComponentType<{ className?: string",
5917
+ "type": "React.ComponentType<{ className?: string }> | React.ReactNode",
5918
+ "optional": true
5919
+ },
5920
+ "active": {
5921
+ "type": "boolean",
5922
+ "optional": true
5923
+ },
5924
+ "size": {
5925
+ "type": "SidebarMenuButtonSize",
5926
+ "optional": true,
5927
+ "description": "Button size. - `\"base\"` — Standard nav item - `\"sm\"` — Compact nav item"
5928
+ },
5929
+ "href": {
5930
+ "type": "string",
5931
+ "optional": true
5932
+ },
5933
+ "target": {
5934
+ "type": "React.HTMLAttributeAnchorTarget",
5935
+ "optional": true,
5936
+ "description": "Link target — only meaningful when `href` is provided."
5937
+ },
5938
+ "tooltip": {
5939
+ "type": "string",
5940
+ "optional": true
5941
+ },
5942
+ "className": {
5943
+ "type": "string",
5944
+ "optional": true
5945
+ },
5946
+ "children": {
5947
+ "type": "ReactNode",
5177
5948
  "optional": true
5178
5949
  }
5179
5950
  }
@@ -5184,11 +5955,18 @@
5184
5955
  "props": {
5185
5956
  "active": {
5186
5957
  "type": "boolean",
5187
- "optional": true
5958
+ "optional": true,
5959
+ "description": "Marks this sub-item as currently active/selected."
5188
5960
  },
5189
5961
  "href": {
5190
5962
  "type": "string",
5191
- "optional": true
5963
+ "optional": true,
5964
+ "description": "Navigation URL. When set, renders as a link via LinkProvider."
5965
+ },
5966
+ "target": {
5967
+ "type": "React.HTMLAttributeAnchorTarget",
5968
+ "optional": true,
5969
+ "description": "Link target — only meaningful when `href` is provided."
5192
5970
  }
5193
5971
  }
5194
5972
  },
@@ -5198,11 +5976,18 @@
5198
5976
  "props": {
5199
5977
  "active": {
5200
5978
  "type": "boolean",
5201
- "optional": true
5979
+ "optional": true,
5980
+ "description": "Marks this sub-item as currently active/selected."
5202
5981
  },
5203
5982
  "href": {
5204
5983
  "type": "string",
5205
- "optional": true
5984
+ "optional": true,
5985
+ "description": "Navigation URL. When set, renders as a link via LinkProvider."
5986
+ },
5987
+ "target": {
5988
+ "type": "React.HTMLAttributeAnchorTarget",
5989
+ "optional": true,
5990
+ "description": "Link target — only meaningful when `href` is provided."
5206
5991
  }
5207
5992
  }
5208
5993
  },
@@ -5212,11 +5997,18 @@
5212
5997
  "props": {
5213
5998
  "active": {
5214
5999
  "type": "boolean",
5215
- "optional": true
6000
+ "optional": true,
6001
+ "description": "Marks this sub-item as currently active/selected."
5216
6002
  },
5217
6003
  "href": {
5218
6004
  "type": "string",
5219
- "optional": true
6005
+ "optional": true,
6006
+ "description": "Navigation URL. When set, renders as a link via LinkProvider."
6007
+ },
6008
+ "target": {
6009
+ "type": "React.HTMLAttributeAnchorTarget",
6010
+ "optional": true,
6011
+ "description": "Link target — only meaningful when `href` is provided."
5220
6012
  }
5221
6013
  }
5222
6014
  },
@@ -5226,11 +6018,18 @@
5226
6018
  "props": {
5227
6019
  "active": {
5228
6020
  "type": "boolean",
5229
- "optional": true
6021
+ "optional": true,
6022
+ "description": "Marks this sub-item as currently active/selected."
5230
6023
  },
5231
6024
  "href": {
5232
6025
  "type": "string",
5233
- "optional": true
6026
+ "optional": true,
6027
+ "description": "Navigation URL. When set, renders as a link via LinkProvider."
6028
+ },
6029
+ "target": {
6030
+ "type": "React.HTMLAttributeAnchorTarget",
6031
+ "optional": true,
6032
+ "description": "Link target — only meaningful when `href` is provided."
5234
6033
  }
5235
6034
  }
5236
6035
  },
@@ -5240,15 +6039,18 @@
5240
6039
  "props": {
5241
6040
  "defaultOpen": {
5242
6041
  "type": "boolean",
5243
- "optional": true
6042
+ "optional": true,
6043
+ "description": "Initial open state (uncontrolled)."
5244
6044
  },
5245
6045
  "open": {
5246
6046
  "type": "boolean",
5247
- "optional": true
6047
+ "optional": true,
6048
+ "description": "Controlled open state."
5248
6049
  },
5249
6050
  "autoScrollOnOpen": {
5250
6051
  "type": "boolean",
5251
- "optional": true
6052
+ "optional": true,
6053
+ "description": "Scroll the expanded content into view after opening."
5252
6054
  }
5253
6055
  }
5254
6056
  },
@@ -5258,15 +6060,18 @@
5258
6060
  "props": {
5259
6061
  "defaultOpen": {
5260
6062
  "type": "boolean",
5261
- "optional": true
6063
+ "optional": true,
6064
+ "description": "Initial open state (uncontrolled)."
5262
6065
  },
5263
6066
  "open": {
5264
6067
  "type": "boolean",
5265
- "optional": true
6068
+ "optional": true,
6069
+ "description": "Controlled open state."
5266
6070
  },
5267
6071
  "autoScrollOnOpen": {
5268
6072
  "type": "boolean",
5269
- "optional": true
6073
+ "optional": true,
6074
+ "description": "Scroll the expanded content into view after opening."
5270
6075
  }
5271
6076
  }
5272
6077
  },
@@ -5276,15 +6081,18 @@
5276
6081
  "props": {
5277
6082
  "defaultOpen": {
5278
6083
  "type": "boolean",
5279
- "optional": true
6084
+ "optional": true,
6085
+ "description": "Initial open state (uncontrolled)."
5280
6086
  },
5281
6087
  "open": {
5282
6088
  "type": "boolean",
5283
- "optional": true
6089
+ "optional": true,
6090
+ "description": "Controlled open state."
5284
6091
  },
5285
6092
  "autoScrollOnOpen": {
5286
6093
  "type": "boolean",
5287
- "optional": true
6094
+ "optional": true,
6095
+ "description": "Scroll the expanded content into view after opening."
5288
6096
  }
5289
6097
  }
5290
6098
  },
@@ -5294,15 +6102,18 @@
5294
6102
  "props": {
5295
6103
  "defaultOpen": {
5296
6104
  "type": "boolean",
5297
- "optional": true
6105
+ "optional": true,
6106
+ "description": "Initial open state (uncontrolled)."
5298
6107
  },
5299
6108
  "open": {
5300
6109
  "type": "boolean",
5301
- "optional": true
6110
+ "optional": true,
6111
+ "description": "Controlled open state."
5302
6112
  },
5303
6113
  "autoScrollOnOpen": {
5304
6114
  "type": "boolean",
5305
- "optional": true
6115
+ "optional": true,
6116
+ "description": "Scroll the expanded content into view after opening."
5306
6117
  }
5307
6118
  }
5308
6119
  },
@@ -5322,15 +6133,18 @@
5322
6133
  "props": {
5323
6134
  "defaultOpen": {
5324
6135
  "type": "boolean",
5325
- "optional": true
6136
+ "optional": true,
6137
+ "description": "Initial open state (uncontrolled)."
5326
6138
  },
5327
6139
  "open": {
5328
6140
  "type": "boolean",
5329
- "optional": true
6141
+ "optional": true,
6142
+ "description": "Controlled open state."
5330
6143
  },
5331
6144
  "autoScrollOnOpen": {
5332
6145
  "type": "boolean",
5333
- "optional": true
6146
+ "optional": true,
6147
+ "description": "Scroll the expanded content into view after opening."
5334
6148
  }
5335
6149
  }
5336
6150
  },
@@ -5340,7 +6154,8 @@
5340
6154
  "props": {
5341
6155
  "render": {
5342
6156
  "type": "React.ReactElement",
5343
- "required": true
6157
+ "required": true,
6158
+ "description": "Element to render as the trigger. Gets aria-expanded, aria-controls, and onClick merged."
5344
6159
  }
5345
6160
  }
5346
6161
  },
@@ -5350,11 +6165,13 @@
5350
6165
  "props": {
5351
6166
  "activeKey": {
5352
6167
  "type": "string",
5353
- "required": true
6168
+ "required": true,
6169
+ "description": "Key of the currently active view. Must match a child `SlidingView` value."
5354
6170
  },
5355
6171
  "direction": {
5356
6172
  "type": "\"left\" | \"right\"",
5357
- "optional": true
6173
+ "optional": true,
6174
+ "description": "Slide direction for the transition. - `\"left\"`: new view slides in from the right - `\"right\"`: new view slides in from the left"
5358
6175
  }
5359
6176
  }
5360
6177
  },
@@ -5364,11 +6181,13 @@
5364
6181
  "props": {
5365
6182
  "activeKey": {
5366
6183
  "type": "string",
5367
- "required": true
6184
+ "required": true,
6185
+ "description": "Key of the currently active view. Must match a child `SlidingView` value."
5368
6186
  },
5369
6187
  "direction": {
5370
6188
  "type": "\"left\" | \"right\"",
5371
- "optional": true
6189
+ "optional": true,
6190
+ "description": "Slide direction for the transition. - `\"left\"`: new view slides in from the right - `\"right\"`: new view slides in from the left"
5372
6191
  }
5373
6192
  }
5374
6193
  },
@@ -5378,7 +6197,8 @@
5378
6197
  "props": {
5379
6198
  "value": {
5380
6199
  "type": "string",
5381
- "required": true
6200
+ "required": true,
6201
+ "description": "Unique key matching this view. Must correspond to `activeKey` on `SlidingViews`."
5382
6202
  }
5383
6203
  }
5384
6204
  }
@@ -5580,31 +6400,38 @@
5580
6400
  "props": {
5581
6401
  "legend": {
5582
6402
  "type": "string",
5583
- "optional": true
6403
+ "optional": true,
6404
+ "description": "Legend text for the group. For more control over legend styling, omit this prop and use `<Switch.Legend>` as a child instead."
5584
6405
  },
5585
6406
  "children": {
5586
6407
  "type": "ReactNode",
5587
- "required": true
6408
+ "required": true,
6409
+ "description": "Child Switch.Item components (and optionally a Switch.Legend)"
5588
6410
  },
5589
6411
  "error": {
5590
6412
  "type": "string",
5591
- "optional": true
6413
+ "optional": true,
6414
+ "description": "Error message for the group (only appears in groups, not single switches)"
5592
6415
  },
5593
6416
  "description": {
5594
6417
  "type": "ReactNode",
5595
- "optional": true
6418
+ "optional": true,
6419
+ "description": "Helper text for the group"
5596
6420
  },
5597
6421
  "disabled": {
5598
6422
  "type": "boolean",
5599
- "optional": true
6423
+ "optional": true,
6424
+ "description": "Whether all switches in the group are disabled"
5600
6425
  },
5601
6426
  "controlFirst": {
5602
6427
  "type": "boolean",
5603
- "optional": true
6428
+ "optional": true,
6429
+ "description": "When true (default), switch appears before label. When false, label appears before switch."
5604
6430
  },
5605
6431
  "className": {
5606
6432
  "type": "string",
5607
- "optional": true
6433
+ "optional": true,
6434
+ "description": "Additional CSS classes"
5608
6435
  }
5609
6436
  }
5610
6437
  },
@@ -5614,11 +6441,13 @@
5614
6441
  "props": {
5615
6442
  "children": {
5616
6443
  "type": "ReactNode",
5617
- "required": true
6444
+ "required": true,
6445
+ "description": "Legend content"
5618
6446
  },
5619
6447
  "className": {
5620
6448
  "type": "string",
5621
- "optional": true
6449
+ "optional": true,
6450
+ "description": "Additional CSS classes (e.g. \"sr-only\" to visually hide the legend)"
5622
6451
  }
5623
6452
  }
5624
6453
  }
@@ -5813,7 +6642,13 @@
5813
6642
  "props": {
5814
6643
  "active": {
5815
6644
  "type": "boolean",
5816
- "optional": true
6645
+ "optional": true,
6646
+ "description": "Whether this item represents the currently active section."
6647
+ },
6648
+ "render": {
6649
+ "type": "React.ReactElement",
6650
+ "optional": true,
6651
+ "description": "Custom element to render as the link. Use this to integrate with framework routers (e.g., Next.js `<Link>`, React Router `<NavLink>`). The element receives all anchor props including `href`, `className`, and `children`."
5817
6652
  }
5818
6653
  }
5819
6654
  },
@@ -5823,15 +6658,18 @@
5823
6658
  "props": {
5824
6659
  "label": {
5825
6660
  "type": "string",
5826
- "required": true
6661
+ "required": true,
6662
+ "description": "Label displayed above the group's items."
5827
6663
  },
5828
6664
  "href": {
5829
6665
  "type": "string",
5830
- "optional": true
6666
+ "optional": true,
6667
+ "description": "URL the group label links to. When provided, the label renders as a clickable link with item styling."
5831
6668
  },
5832
6669
  "active": {
5833
6670
  "type": "boolean",
5834
- "optional": true
6671
+ "optional": true,
6672
+ "description": "Whether this group's label represents the currently active section. Only applies when `href` is provided."
5835
6673
  }
5836
6674
  }
5837
6675
  }
@@ -6104,6 +6942,165 @@
6104
6942
  }
6105
6943
  }
6106
6944
  },
6945
+ "TimeseriesChart": {
6946
+ "name": "TimeseriesChart",
6947
+ "type": "component",
6948
+ "description": "TimeseriesChart — a time-series line or bar chart.",
6949
+ "importPath": "@cloudflare/kumo",
6950
+ "category": "Data Visualization",
6951
+ "props": {
6952
+ "echarts": {
6953
+ "type": "typeof echarts",
6954
+ "required": true,
6955
+ "description": "The ECharts core instance imported by the consumer. Passed in rather than imported directly so the consumer controls which ECharts modules are bundled (tree-shaking)."
6956
+ },
6957
+ "type": {
6958
+ "type": "\"line\" | \"bar\"",
6959
+ "optional": true,
6960
+ "description": "Visual style of each series. Defaults to `\"line\"`."
6961
+ },
6962
+ "data": {
6963
+ "type": "TimeseriesData[]",
6964
+ "required": true,
6965
+ "description": "Array of time series data to display on the chart"
6966
+ },
6967
+ "markers": {
6968
+ "type": "TimeseriesMarker[]",
6969
+ "optional": true,
6970
+ "description": "Vertical reference markers rendered on the time axis."
6971
+ },
6972
+ "thresholds": {
6973
+ "type": "TimeseriesThreshold[]",
6974
+ "optional": true,
6975
+ "description": "Horizontal threshold lines rendered on the value axis."
6976
+ },
6977
+ "xAxisName": {
6978
+ "type": "string",
6979
+ "optional": true,
6980
+ "description": "Label for the x-axis (time axis)"
6981
+ },
6982
+ "xAxisTickCount": {
6983
+ "type": "number",
6984
+ "optional": true,
6985
+ "description": "Number of ticks to display on the x-axis"
6986
+ },
6987
+ "xAxisTickFormat": {
6988
+ "type": "(value: number) => string",
6989
+ "optional": true,
6990
+ "description": "Custom formatter for x-axis tick labels. Receives the raw timestamp in milliseconds and returns a display string, overriding ECharts' built-in time formatting."
6991
+ },
6992
+ "yAxisTickFormat": {
6993
+ "type": "(value: number) => string",
6994
+ "optional": true,
6995
+ "description": "Custom formatter for y-axis tick labels. Receives the raw value and returns a display string. When omitted, ECharts' built-in formatter is used."
6996
+ },
6997
+ "yAxisTickLabelFormat": {
6998
+ "type": "(value: number) => string",
6999
+ "optional": true
7000
+ },
7001
+ "yAxisName": {
7002
+ "type": "string",
7003
+ "optional": true,
7004
+ "description": "Label for the y-axis (value axis)"
7005
+ },
7006
+ "yAxisTickCount": {
7007
+ "type": "number",
7008
+ "optional": true,
7009
+ "description": "Number of ticks to display on the y-axis"
7010
+ },
7011
+ "tooltipValueFormat": {
7012
+ "type": "(value: number) => string",
7013
+ "optional": true,
7014
+ "description": "Custom formatter for tooltip values. Receives the raw y-value and returns a display string. When omitted, the raw value is shown. Takes precedence over the deprecated `yAxisTickLabelFormat` prop."
7015
+ },
7016
+ "tooltipMode": {
7017
+ "type": "\"all\" | \"single\"",
7018
+ "optional": true,
7019
+ "description": "Controls which series are shown in the tooltip. - `\"all\"` — show all series at the hovered timestamp (default) - `\"single\"` — show only the series whose value is closest to the cursor"
7020
+ },
7021
+ "tooltipMaxItems": {
7022
+ "type": "number",
7023
+ "optional": true,
7024
+ "description": "Maximum number of series rows shown in the tooltip when `tooltipMode` is `\"all\"`. Additional series are hidden with a `+N more` footer. Defaults to `10`."
7025
+ },
7026
+ "tooltipBoundary": {
7027
+ "type": "\"clipping-ancestors\" | Element | Element[]",
7028
+ "optional": true,
7029
+ "description": "Constrains the tooltip to stay within a specific element or region. By default the tooltip avoids overflowing any clipping ancestor (scroll containers, viewports, etc.). Pass an `Element` or array of elements to restrict the tooltip to a specific container."
7030
+ },
7031
+ "tooltipFollowCursor": {
7032
+ "type": "\"both\" | \"x\"",
7033
+ "optional": true,
7034
+ "description": "Which axis the tooltip follows the cursor on. - `\"both\"` — tooltip tracks the cursor on both axes, staying near the pointer at all times. This is the default and matches the behaviour of ECharts' built-in tooltip. - `\"x\"` — tooltip follows the cursor horizontally but is locked to a fixed vertical position relative to the chart. This keeps the tooltip out of the way of the data and avoids vertical jitter as series values change — the same approach used by Recharts and many dashboard UIs. Only these two modes are offered because the x-axis is always time in a `TimeseriesChart`: y-only tracking and fully-fixed positioning don't produce useful tooltip behaviour for time-series data. Powered by Base UI Tooltip's `trackCursorAxis` under the hood."
7035
+ },
7036
+ "incomplete": {
7037
+ "type": "{ before?: number; after?: number }",
7038
+ "optional": true,
7039
+ "description": "Indicates incomplete data periods with optional before/after timestamps in ms"
7040
+ },
7041
+ "enableLegendSelection": {
7042
+ "type": "boolean",
7043
+ "optional": true,
7044
+ "description": "When `true`, adds a hidden ECharts legend so consumers can drive series visibility imperatively via the `legendSelect` / `legendUnSelect` / `legendToggleSelect` actions (e.g. to build a custom interactive legend). Toggled-off series are also excluded from the tooltip. Requires the consumer to register ECharts' `LegendComponent` (`echarts.use([LegendComponent])`); otherwise the legend actions no-op and, in development, ECharts logs a \"component legend is used but not imported\" warning."
7045
+ },
7046
+ "height": {
7047
+ "type": "number",
7048
+ "optional": true,
7049
+ "description": "Height of the chart in pixels. Defaults to `350`."
7050
+ },
7051
+ "isDarkMode": {
7052
+ "type": "boolean",
7053
+ "optional": true,
7054
+ "description": "When `true`, switches the chart to ECharts' built-in dark theme"
7055
+ },
7056
+ "gradient": {
7057
+ "type": "boolean",
7058
+ "optional": true,
7059
+ "description": "When `true`, renders a vertical gradient fill beneath each line series. The gradient fades from the series' color at the top to transparent at the bottom. Has no effect when `type` is `\"bar\"`."
7060
+ },
7061
+ "loading": {
7062
+ "type": "boolean",
7063
+ "optional": true,
7064
+ "description": "When `true`, hides the chart and displays an animated sine-wave skeleton that oscillates back and forth to indicate that data is being fetched."
7065
+ },
7066
+ "ariaDescription": {
7067
+ "type": "string",
7068
+ "optional": true,
7069
+ "description": "Accessible description for screen readers. When provided, it is passed to ECharts' `aria.label.description` and announced when the chart receives focus. Consumers are responsible for writing a meaningful description — see the W3C guidance on complex images for recommendations."
7070
+ },
7071
+ "optionUpdateBehavior": {
7072
+ "type": "SetOptionOpts",
7073
+ "optional": true,
7074
+ "description": "Additional options passed as the second argument to `chart.setOption()`. Defaults to `{ notMerge: false, lazyUpdate: true }`."
7075
+ }
7076
+ },
7077
+ "examples": [
7078
+ "<Chart\n echarts={echarts}\n options={options}\n height={400}\n isDarkMode={isDarkMode}\n />",
7079
+ "<TimeseriesChart\n echarts={echarts}\n isDarkMode={isDarkMode}\n data={data}\n xAxisName=\"Time (UTC)\"\n yAxisName=\"Count\"\n />",
7080
+ "<TimeseriesChart\n echarts={echarts}\n isDarkMode={isDarkMode}\n data={data}\n markers={markers}\n xAxisName=\"Time (UTC)\"\n yAxisName=\"Count\"\n />",
7081
+ "<TimeseriesChart\n echarts={echarts}\n isDarkMode={isDarkMode}\n data={data}\n thresholds={[\n {\n value: 55,\n label: \"Memory limit\",\n color: ChartPalette.semantic(\"Attention\", isDarkMode),\n },\n ]}\n xAxisName=\"Time (UTC)\"\n yAxisName=\"Memory (MB)\"\n />",
7082
+ "<TimeseriesChart\n echarts={echarts}\n isDarkMode={isDarkMode}\n data={data}\n xAxisName=\"Time (UTC)\"\n yAxisName=\"Requests\"\n xAxisTickFormat={(ts) => {\n const d = new Date(ts);\n return `${d.getHours().toString().padStart(2, \"0\")}:${d.getMinutes().toString().padStart(2, \"0\")}`;\n }}\n yAxisTickFormat={(value) => {\n if (value >= 1000) return `${value / 1000}k`;\n return value.toString();\n }}\n tooltipValueFormat={(value) => `${(value / 1000).toFixed(1)}k requests`}\n />",
7083
+ "<TimeseriesChart\n yAxisTickCount={2}\n echarts={echarts}\n isDarkMode={isDarkMode}\n data={data}\n height={160}\n />",
7084
+ "<TimeseriesChart\n echarts={echarts}\n isDarkMode={isDarkMode}\n data={data}\n xAxisName=\"Time (UTC)\"\n yAxisName=\"Count\"\n gradient\n />",
7085
+ "<TimeseriesChart\n echarts={echarts}\n isDarkMode={isDarkMode}\n data={data}\n xAxisName=\"Time (UTC)\"\n yAxisName=\"Mbps\"\n incomplete={{ after: incompleteTimestamp }}\n />",
7086
+ "<TimeseriesChart\n echarts={echarts}\n isDarkMode={isDarkMode}\n data={data}\n xAxisName=\"Time (UTC)\"\n yAxisName=\"%\"\n onTimeRangeChange={(from, to) => {\n alert(\n `Selected range:\\nFrom: ${new Date(from).toLocaleString()}\\nTo: ${new Date(to).toLocaleString()}`,\n );\n }}\n />",
7087
+ "<Chart\n echarts={echarts}\n options={options}\n height={160}\n isDarkMode={isDarkMode}\n />",
7088
+ "<div className=\"space-y-4\">\n <h3 className=\"text-sm font-medium\">Active State</h3>\n\n <div className=\"flex flex-wrap gap-4 divide-x divide-kumo-hairline\">\n <ChartLegend.LargeItem\n name=\"Requests\"\n color={ChartPalette.semantic(\"Neutral\", isDarkMode)}\n value=\"1,234\"\n unit=\"req/s\"\n />\n <ChartLegend.LargeItem\n name=\"Storage\"\n color={ChartPalette.semantic(\"Attention\", isDarkMode)}\n value=\"56\"\n unit=\"GB\"\n />\n <ChartLegend.LargeItem\n name=\"Warnings\"\n color={ChartPalette.semantic(\"Warning\", isDarkMode)}\n value=\"128\"\n />\n </div>\n\n <h3 className=\"text-sm font-medium mt-12\">Inactive State</h3>\n\n <div className=\"flex flex-wrap gap-4 divide-x divide-kumo-hairline\">\n <ChartLegend.LargeItem\n name=\"Requests\"\n color={ChartPalette.semantic(\"Neutral\", isDarkMode)}\n value=\"1,234\"\n unit=\"req/s\"\n inactive\n />\n <ChartLegend.LargeItem\n name=\"Storage\"\n color={ChartPalette.semantic(\"Attention\", isDarkMode)}\n value=\"56\"\n unit=\"GB\"\n inactive\n />\n <ChartLegend.LargeItem\n name=\"Warnings\"\n color={ChartPalette.semantic(\"Warning\", isDarkMode)}\n value=\"128\"\n inactive\n />\n </div>\n </div>",
7089
+ "<div className=\"space-y-4\">\n <h3 className=\"text-sm font-medium\">Active State</h3>\n <div className=\"flex flex-wrap gap-4\">\n <ChartLegend.SmallItem\n name=\"Requests\"\n color={ChartPalette.semantic(\"Neutral\", isDarkMode)}\n value=\"1,234\"\n unit=\"req/s\"\n />\n <ChartLegend.SmallItem\n name=\"Storage\"\n color={ChartPalette.semantic(\"Attention\", isDarkMode)}\n value=\"56\"\n unit=\"GB\"\n />\n <ChartLegend.SmallItem\n name=\"Warnings\"\n color={ChartPalette.semantic(\"Warning\", isDarkMode)}\n value=\"128\"\n />\n </div>\n\n <h3 className=\"text-sm font-medium mt-12\">Inactive State</h3>\n <div className=\"flex flex-wrap gap-4\">\n <ChartLegend.SmallItem\n name=\"Requests\"\n color={ChartPalette.semantic(\"Neutral\", isDarkMode)}\n value=\"1,234\"\n unit=\"req/s\"\n inactive\n />\n <ChartLegend.SmallItem\n name=\"Storage\"\n color={ChartPalette.semantic(\"Attention\", isDarkMode)}\n value=\"56\"\n unit=\"GB\"\n inactive\n />\n <ChartLegend.SmallItem\n name=\"Warnings\"\n color={ChartPalette.semantic(\"Warning\", isDarkMode)}\n value=\"128\"\n inactive\n />\n </div>\n </div>",
7090
+ "<TimeseriesChart\n echarts={echarts}\n isDarkMode={isDarkMode}\n type=\"bar\"\n data={data}\n xAxisName=\"Time (UTC)\"\n yAxisName=\"Count\"\n tooltipValueFormat={(r) => r.toFixed(2)}\n />",
7091
+ "<div className=\"flex flex-col flex-1 w-full\">\n <TimeseriesChart\n echarts={echarts}\n isDarkMode={isDarkMode}\n xAxisName=\"Time (UTC)\"\n yAxisName=\"Count\"\n data={[]}\n loading\n />\n </div>",
7092
+ "<LayerCard>\n <LayerCard.Secondary>Read latency</LayerCard.Secondary>\n <LayerCard.Primary>\n <div className=\"flex divide-x divide-kumo-hairline gap-4 px-2 mb-2\">\n <ChartLegend.LargeItem\n name=\"P99\"\n color={ChartPalette.semantic(\"Attention\", isDarkMode)}\n value=\"124\"\n unit=\"ms\"\n />\n <ChartLegend.LargeItem\n name=\"P95\"\n color={ChartPalette.semantic(\"Warning\", isDarkMode)}\n value=\"76\"\n unit=\"ms\"\n />\n <ChartLegend.LargeItem\n name=\"P75\"\n color={ChartPalette.semantic(\"Neutral\", isDarkMode)}\n value=\"32\"\n unit=\"ms\"\n />\n <ChartLegend.LargeItem\n name=\"P50\"\n color={ChartPalette.semantic(\"Neutral\", isDarkMode)}\n value=\"10\"\n unit=\"ms\"\n />\n </div>\n <TimeseriesChart\n xAxisName=\"Time (UTC)\"\n echarts={echarts}\n isDarkMode={isDarkMode}\n data={data}\n height={300}\n />\n </LayerCard.Primary>\n </LayerCard>",
7093
+ "<LayerCard>\n <LayerCard.Secondary>Read latency</LayerCard.Secondary>\n <LayerCard.Primary>\n <div className=\"flex divide-x divide-kumo-line px-2 mb-2\">\n {series.map((s) => (\n <ChartLegend.LargeItem\n key={s.name}\n name={s.name}\n color={s.color}\n value={s.value}\n unit={s.unit}\n inactive={hoveredSeries !== null && hoveredSeries !== s.name}\n onPointerEnter={() => {\n setHoveredSeries(s.name);\n chartRef.current?.dispatchAction({\n type: \"highlight\",\n seriesName: s.name,\n });\n }}\n onPointerLeave={() => {\n setHoveredSeries(null);\n chartRef.current?.dispatchAction({\n type: \"downplay\",\n seriesName: s.name,\n });\n }}\n className=\"not-first:pl-4\"\n />\n ))}\n </div>\n <TimeseriesChart\n ref={chartRef}\n xAxisName=\"Time (UTC)\"\n echarts={echarts}\n isDarkMode={isDarkMode}\n data={data}\n height={300}\n />\n </LayerCard.Primary>\n </LayerCard>",
7094
+ "<LayerCard>\n <LayerCard.Secondary>Read latency</LayerCard.Secondary>\n <LayerCard.Primary>\n <div className=\"flex divide-x divide-kumo-line px-2 mb-2\">\n {series.map((s) => (\n <ChartLegend.LargeItem\n key={s.name}\n name={s.name}\n color={s.color}\n value={s.value}\n unit={s.unit}\n inactive={hiddenSeries[s.name] ?? false}\n onClick={() => handleClick(s.name)}\n className=\"not-first:pl-4\"\n />\n ))}\n </div>\n <TimeseriesChart\n ref={chartRef}\n xAxisName=\"Time (UTC)\"\n echarts={echarts}\n isDarkMode={isDarkMode}\n data={data}\n height={300}\n enableLegendSelection\n />\n </LayerCard.Primary>\n </LayerCard>",
7095
+ "<Chart\n echarts={echarts}\n options={options}\n height={400}\n isDarkMode={isDarkMode}\n />",
7096
+ "<div className=\"flex w-full flex-col gap-4\">\n <Select\n label=\"Tooltip follow cursor\"\n value={selected}\n onValueChange={(v) => {\n if (v) setSelected(v);\n }}\n renderValue={(v) => v.label}\n >\n {FOLLOW_CURSOR_OPTIONS.map((opt) => (\n <Select.Option key={opt.value} value={opt}>\n {opt.label}\n </Select.Option>\n ))}\n </Select>\n <TimeseriesChart\n echarts={echarts}\n isDarkMode={isDarkMode}\n data={data}\n xAxisName=\"Time (UTC)\"\n yAxisName=\"Latency (ms)\"\n tooltipFollowCursor={selected.value}\n />\n </div>",
7097
+ "<div\n ref={boundaryRef}\n className=\"w-full overflow-auto rounded-lg border border-kumo-line\"\n style={{ height: 300 }}\n >\n <TimeseriesChart\n echarts={echarts}\n isDarkMode={isDarkMode}\n data={data}\n xAxisName=\"Time (UTC)\"\n yAxisName=\"Count\"\n height={280}\n tooltipBoundary={boundary ?? undefined}\n />\n </div>"
7098
+ ],
7099
+ "colors": [
7100
+ "bg-kumo-base",
7101
+ "outline-kumo-fill"
7102
+ ]
7103
+ },
6107
7104
  "Toasty": {
6108
7105
  "name": "Toasty",
6109
7106
  "type": "component",
@@ -6136,13 +7133,20 @@
6136
7133
  "info": "ring-[0.3px] ring-kumo-info bg-kumo-control [&_[data-toast-icon]]:text-kumo-info [&_[data-toast-title]]:text-kumo-info"
6137
7134
  }
6138
7135
  },
6139
- "className": {
6140
- "type": "string",
6141
- "description": "Additional CSS classes"
6142
- },
6143
7136
  "children": {
6144
- "type": "ReactNode",
6145
- "description": "Child elements"
7137
+ "type": "React.ReactNode",
7138
+ "required": true,
7139
+ "description": "Application content. Toasts render via a portal above this."
7140
+ },
7141
+ "container": {
7142
+ "type": "PortalContainer",
7143
+ "optional": true,
7144
+ "description": "Container element for the portal. Use this to render toasts inside a Shadow DOM or custom container. Overrides `KumoPortalProvider` context."
7145
+ },
7146
+ "toastManager": {
7147
+ "type": "ReturnType<typeof createKumoToastManager>",
7148
+ "optional": true,
7149
+ "description": "Optional toast manager created by `createKumoToastManager()`. When provided, allows code outside the React tree (timers, module-load callbacks, query-cache listeners) to dispatch toasts via the same dedupe-aware manager that `useKumoToastManager()` returns inside the tree. Forwarded to the underlying `@base-ui/react/toast` `Toast.Provider` `toastManager` prop — see https://base-ui.com/react/components/toast for the upstream primitive."
6146
7150
  }
6147
7151
  },
6148
7152
  "examples": [
@@ -6160,10 +7164,8 @@
6160
7164
  ],
6161
7165
  "colors": [
6162
7166
  "bg-kumo-base",
6163
- "bg-kumo-contrast",
6164
7167
  "bg-kumo-control",
6165
7168
  "bg-kumo-danger-tint",
6166
- "bg-kumo-fill-hover",
6167
7169
  "bg-kumo-info-tint",
6168
7170
  "bg-kumo-success-tint",
6169
7171
  "bg-kumo-warning-tint",
@@ -6678,6 +7680,13 @@
6678
7680
  "Loader",
6679
7681
  "Toasty"
6680
7682
  ],
7683
+ "Data Visualization": [
7684
+ "BubbleMap",
7685
+ "Chart",
7686
+ "ChoroplethMap",
7687
+ "SankeyChart",
7688
+ "TimeseriesChart"
7689
+ ],
6681
7690
  "Action": [
6682
7691
  "Button",
6683
7692
  "ClipboardText"
@@ -6717,8 +7726,11 @@
6717
7726
  "Badge",
6718
7727
  "Banner",
6719
7728
  "Breadcrumbs",
7729
+ "BubbleMap",
6720
7730
  "Button",
7731
+ "Chart",
6721
7732
  "Checkbox",
7733
+ "ChoroplethMap",
6722
7734
  "ClipboardText",
6723
7735
  "CloudflareLogo",
6724
7736
  "Code",
@@ -6746,6 +7758,7 @@
6746
7758
  "Popover",
6747
7759
  "Radio",
6748
7760
  "ResourceListPage",
7761
+ "SankeyChart",
6749
7762
  "Select",
6750
7763
  "SensitiveInput",
6751
7764
  "Sidebar",
@@ -6755,6 +7768,7 @@
6755
7768
  "TableOfContents",
6756
7769
  "Tabs",
6757
7770
  "Text",
7771
+ "TimeseriesChart",
6758
7772
  "Toasty",
6759
7773
  "Toolbar",
6760
7774
  "Tooltip"
@@ -6765,8 +7779,11 @@
6765
7779
  "Badge",
6766
7780
  "Banner",
6767
7781
  "Breadcrumbs",
7782
+ "BubbleMap",
6768
7783
  "Button",
7784
+ "Chart",
6769
7785
  "Checkbox",
7786
+ "ChoroplethMap",
6770
7787
  "ClipboardText",
6771
7788
  "CloudflareLogo",
6772
7789
  "Code",
@@ -6791,6 +7808,7 @@
6791
7808
  "Pagination",
6792
7809
  "Popover",
6793
7810
  "Radio",
7811
+ "SankeyChart",
6794
7812
  "Select",
6795
7813
  "SensitiveInput",
6796
7814
  "Sidebar",
@@ -6800,6 +7818,7 @@
6800
7818
  "TableOfContents",
6801
7819
  "Tabs",
6802
7820
  "Text",
7821
+ "TimeseriesChart",
6803
7822
  "Toasty",
6804
7823
  "Toolbar",
6805
7824
  "Tooltip"