@cloudflare/kumo 2.7.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 (62) hide show
  1. package/CHANGELOG.md +19 -0
  2. package/ai/component-registry.json +1164 -149
  3. package/ai/component-registry.md +1325 -114
  4. package/ai/schemas.ts +136 -7
  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 +1515 -1298
  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/input-area-sg518xu4pyg4m0km.js +144 -0
  13. package/dist/chunks/input-area-sg518xu4pyg4m0km.js.map +1 -0
  14. package/dist/chunks/{sidebar-ctd980heycmxsux1.js → sidebar-7whsl7qwrw5b6ip8.js} +306 -306
  15. package/dist/chunks/sidebar-7whsl7qwrw5b6ip8.js.map +1 -0
  16. package/dist/components/chart.js +1 -1
  17. package/dist/components/flow.js +2306 -2350
  18. package/dist/components/flow.js.map +1 -1
  19. package/dist/components/input.js +1 -1
  20. package/dist/components/sidebar.js +1 -1
  21. package/dist/index.js +3 -3
  22. package/dist/src/components/chart/TimeseriesChart.d.ts +8 -0
  23. package/dist/src/components/chart/TimeseriesChart.d.ts.map +1 -1
  24. package/dist/src/components/chart/index.d.ts +1 -1
  25. package/dist/src/components/chart/index.d.ts.map +1 -1
  26. package/dist/src/components/chart/timeseries-markers.d.ts +107 -0
  27. package/dist/src/components/chart/timeseries-markers.d.ts.map +1 -0
  28. package/dist/src/components/chart/timeseries-thresholds.d.ts +61 -0
  29. package/dist/src/components/chart/timeseries-thresholds.d.ts.map +1 -0
  30. package/dist/src/components/chart/timeseries-tooltip.d.ts +28 -0
  31. package/dist/src/components/chart/timeseries-tooltip.d.ts.map +1 -0
  32. package/dist/src/components/flow/connectors.d.ts +18 -0
  33. package/dist/src/components/flow/connectors.d.ts.map +1 -1
  34. package/dist/src/components/flow/diagram.d.ts +48 -41
  35. package/dist/src/components/flow/diagram.d.ts.map +1 -1
  36. package/dist/src/components/flow/flow-layout.d.ts +77 -0
  37. package/dist/src/components/flow/flow-layout.d.ts.map +1 -0
  38. package/dist/src/components/flow/node.d.ts.map +1 -1
  39. package/dist/src/components/flow/parallel.d.ts +3 -7
  40. package/dist/src/components/flow/parallel.d.ts.map +1 -1
  41. package/dist/src/components/flow/use-children.d.ts +0 -60
  42. package/dist/src/components/flow/use-children.d.ts.map +1 -1
  43. package/dist/src/components/input/input-area.d.ts +18 -0
  44. package/dist/src/components/input/input-area.d.ts.map +1 -1
  45. package/dist/src/components/sidebar/sidebar.d.ts +2 -0
  46. package/dist/src/components/sidebar/sidebar.d.ts.map +1 -1
  47. package/dist/src/primitives/index.d.ts +1 -1
  48. package/dist/src/primitives/index.d.ts.map +1 -1
  49. package/dist/src/primitives/otp-field.d.ts +1 -1
  50. package/dist/src/primitives/otp-field.d.ts.map +1 -1
  51. package/dist/styles/kumo-standalone.css +1 -1
  52. package/package.json +1 -1
  53. package/scripts/component-registry/discovery.ts +87 -0
  54. package/scripts/component-registry/index.test.ts +89 -1
  55. package/scripts/component-registry/index.ts +27 -2
  56. package/scripts/component-registry/sub-components.ts +34 -21
  57. package/scripts/generate-primitives.ts +1 -1
  58. package/dist/chunks/Maps-fkiyllhs5w0qzw1y.js +0 -2155
  59. package/dist/chunks/Maps-fkiyllhs5w0qzw1y.js.map +0 -1
  60. package/dist/chunks/input-area-ixtj4e8eny58nbf9.js +0 -78
  61. package/dist/chunks/input-area-ixtj4e8eny58nbf9.js.map +0 -1
  62. package/dist/chunks/sidebar-ctd980heycmxsux1.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",
@@ -680,6 +818,73 @@
680
818
  "text-kumo-subtle"
681
819
  ]
682
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
+ },
683
888
  "Checkbox": {
684
889
  "name": "Checkbox",
685
890
  "type": "component",
@@ -795,39 +1000,48 @@
795
1000
  "props": {
796
1001
  "legend": {
797
1002
  "type": "string",
798
- "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."
799
1005
  },
800
1006
  "children": {
801
1007
  "type": "ReactNode",
802
- "required": true
1008
+ "required": true,
1009
+ "description": "Child Checkbox.Item components (and optionally a Checkbox.Legend)"
803
1010
  },
804
1011
  "error": {
805
1012
  "type": "string",
806
- "optional": true
1013
+ "optional": true,
1014
+ "description": "Error message for the group (only appears in groups, not single checkboxes)"
807
1015
  },
808
1016
  "description": {
809
1017
  "type": "ReactNode",
810
- "optional": true
1018
+ "optional": true,
1019
+ "description": "Helper text for the group"
811
1020
  },
812
1021
  "value": {
813
1022
  "type": "string[]",
814
- "optional": true
1023
+ "optional": true,
1024
+ "description": "Values of checkboxes that should be checked (controlled)"
815
1025
  },
816
1026
  "allValues": {
817
1027
  "type": "string[]",
818
- "optional": true
1028
+ "optional": true,
1029
+ "description": "All possible checkbox values (required for parent checkbox pattern)"
819
1030
  },
820
1031
  "disabled": {
821
1032
  "type": "boolean",
822
- "optional": true
1033
+ "optional": true,
1034
+ "description": "Whether all checkboxes in the group are disabled"
823
1035
  },
824
1036
  "controlFirst": {
825
1037
  "type": "boolean",
826
- "optional": true
1038
+ "optional": true,
1039
+ "description": "When true (default), checkbox appears before label. When false, label appears before checkbox."
827
1040
  },
828
1041
  "className": {
829
1042
  "type": "string",
830
- "optional": true
1043
+ "optional": true,
1044
+ "description": "Additional CSS classes"
831
1045
  }
832
1046
  }
833
1047
  },
@@ -837,11 +1051,13 @@
837
1051
  "props": {
838
1052
  "children": {
839
1053
  "type": "ReactNode",
840
- "required": true
1054
+ "required": true,
1055
+ "description": "Legend content"
841
1056
  },
842
1057
  "className": {
843
1058
  "type": "string",
844
- "optional": true
1059
+ "optional": true,
1060
+ "description": "Additional CSS classes (e.g. \"sr-only\" to visually hide the legend)"
845
1061
  }
846
1062
  }
847
1063
  }
@@ -890,6 +1106,122 @@
890
1106
  ]
891
1107
  }
892
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
+ },
893
1225
  "ClipboardText": {
894
1226
  "name": "ClipboardText",
895
1227
  "type": "component",
@@ -2223,11 +2555,13 @@
2223
2555
  "props": {
2224
2556
  "code": {
2225
2557
  "type": "string",
2226
- "required": true
2558
+ "required": true,
2559
+ "description": "The code string to display."
2227
2560
  },
2228
2561
  "lang": {
2229
2562
  "type": "CodeLang",
2230
- "optional": true
2563
+ "optional": true,
2564
+ "description": "Language hint for the code content."
2231
2565
  }
2232
2566
  }
2233
2567
  }
@@ -2289,7 +2623,8 @@
2289
2623
  "props": {
2290
2624
  "className": {
2291
2625
  "type": "string",
2292
- "optional": true
2626
+ "optional": true,
2627
+ "description": "Additional CSS classes"
2293
2628
  }
2294
2629
  }
2295
2630
  },
@@ -2299,7 +2634,8 @@
2299
2634
  "props": {
2300
2635
  "className": {
2301
2636
  "type": "string",
2302
- "optional": true
2637
+ "optional": true,
2638
+ "description": "Additional CSS classes"
2303
2639
  }
2304
2640
  }
2305
2641
  },
@@ -2309,7 +2645,8 @@
2309
2645
  "props": {
2310
2646
  "className": {
2311
2647
  "type": "string",
2312
- "optional": true
2648
+ "optional": true,
2649
+ "description": "Additional CSS classes"
2313
2650
  }
2314
2651
  }
2315
2652
  },
@@ -2319,11 +2656,13 @@
2319
2656
  "props": {
2320
2657
  "children": {
2321
2658
  "type": "ReactNode",
2322
- "required": true
2659
+ "required": true,
2660
+ "description": "Label text displayed in the trigger"
2323
2661
  },
2324
2662
  "className": {
2325
2663
  "type": "string",
2326
- "optional": true
2664
+ "optional": true,
2665
+ "description": "Additional CSS classes"
2327
2666
  }
2328
2667
  }
2329
2668
  },
@@ -2333,11 +2672,13 @@
2333
2672
  "props": {
2334
2673
  "children": {
2335
2674
  "type": "ReactNode",
2336
- "required": true
2675
+ "required": true,
2676
+ "description": "Panel content"
2337
2677
  },
2338
2678
  "className": {
2339
2679
  "type": "string",
2340
- "optional": true
2680
+ "optional": true,
2681
+ "description": "Additional CSS classes"
2341
2682
  }
2342
2683
  }
2343
2684
  }
@@ -4271,24 +4612,14 @@
4271
4612
  "description": "Info sub-component",
4272
4613
  "props": {
4273
4614
  "children": {
4274
- "type": "(props: {",
4275
- "optional": true
4276
- },
4277
- "page": {
4278
- "type": "number",
4279
- "required": true
4280
- },
4281
- "perPage": {
4282
- "type": "number",
4283
- "optional": true
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"
4284
4618
  },
4285
- "totalCount": {
4286
- "type": "number",
4287
- "optional": true
4288
- },
4289
- "pageShowingRange": {
4619
+ "className": {
4290
4620
  "type": "string",
4291
- "required": true
4621
+ "optional": true,
4622
+ "description": "Additional CSS classes"
4292
4623
  }
4293
4624
  }
4294
4625
  },
@@ -4298,23 +4629,23 @@
4298
4629
  "props": {
4299
4630
  "value": {
4300
4631
  "type": "number",
4301
- "required": true
4632
+ "required": true,
4633
+ "description": "Current page size value"
4302
4634
  },
4303
4635
  "options": {
4304
4636
  "type": "number[]",
4305
- "optional": true
4306
- },
4307
- "page": {
4308
- "type": "\"",
4309
- "required": true
4637
+ "optional": true,
4638
+ "description": "Available page size options"
4310
4639
  },
4311
4640
  "label": {
4312
4641
  "type": "ReactNode",
4313
- "optional": true
4642
+ "optional": true,
4643
+ "description": "Label text shown before the selector."
4314
4644
  },
4315
4645
  "className": {
4316
4646
  "type": "string",
4317
- "optional": true
4647
+ "optional": true,
4648
+ "description": "Additional CSS classes"
4318
4649
  }
4319
4650
  }
4320
4651
  },
@@ -4322,17 +4653,15 @@
4322
4653
  "name": "Controls",
4323
4654
  "description": "Controls sub-component",
4324
4655
  "props": {
4325
- "Note": {
4326
- "type": "** `\"dropdown\"` renders an option for every page",
4327
- "required": true
4328
- },
4329
4656
  "pageSelector": {
4330
4657
  "type": "\"input\" | \"dropdown\"",
4331
- "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."
4332
4660
  },
4333
4661
  "className": {
4334
4662
  "type": "string",
4335
- "optional": true
4663
+ "optional": true,
4664
+ "description": "Additional CSS classes"
4336
4665
  }
4337
4666
  }
4338
4667
  },
@@ -4342,7 +4671,8 @@
4342
4671
  "props": {
4343
4672
  "className": {
4344
4673
  "type": "string",
4345
- "optional": true
4674
+ "optional": true,
4675
+ "description": "Additional CSS classes"
4346
4676
  }
4347
4677
  }
4348
4678
  }
@@ -4454,43 +4784,66 @@
4454
4784
  }
4455
4785
  },
4456
4786
  "appearance": {
4457
- "type": "enum",
4458
- "values": [
4459
- "default",
4460
- "card"
4461
- ],
4462
- "default": "default",
4463
- "descriptions": {
4464
- "default": "Standard inline radio item",
4465
- "card": "Choice card appearance with border, padding, and highlighted selection state"
4466
- },
4467
- "classes": {
4468
- "card": "rounded-lg border border-kumo-hairline bg-kumo-base p-3 transition-colors hover:bg-kumo-tint has-[[data-checked]]:border-kumo-interact has-[[data-checked]]:bg-kumo-tint"
4469
- },
4470
- "stateClasses": {
4471
- "card": {
4472
- "hover": "hover:bg-kumo-tint"
4473
- }
4474
- }
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."
4475
4790
  },
4476
- "className": {
4791
+ "legend": {
4477
4792
  "type": "string",
4478
- "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."
4479
4795
  },
4480
4796
  "children": {
4481
4797
  "type": "ReactNode",
4482
- "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"
4483
4815
  },
4484
4816
  "value": {
4485
4817
  "type": "T",
4818
+ "optional": true,
4486
4819
  "description": "The controlled value of the selected radio item."
4487
4820
  },
4488
- "defaultValue": {
4489
- "type": "T",
4490
- "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"
4491
4825
  },
4492
- "onValueChange": {
4493
- "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",
4494
4847
  "description": "Callback fired when the selected value changes. The second argument carries native event details about the interaction."
4495
4848
  }
4496
4849
  },
@@ -4536,10 +4889,61 @@
4536
4889
  "name": "Group",
4537
4890
  "description": "Group sub-component",
4538
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
+ },
4539
4922
  "value": {
4540
4923
  "type": "T",
4924
+ "optional": true,
4541
4925
  "description": "The controlled value of the selected radio item."
4542
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
+ },
4543
4947
  "defaultValue": {
4544
4948
  "type": "T",
4545
4949
  "description": "The uncontrolled initial value of the selected radio item."
@@ -4556,16 +4960,123 @@
4556
4960
  "props": {
4557
4961
  "children": {
4558
4962
  "type": "ReactNode",
4559
- "required": true
4963
+ "required": true,
4964
+ "description": "Legend content"
4560
4965
  },
4561
4966
  "className": {
4562
4967
  "type": "string",
4563
- "optional": true
4968
+ "optional": true,
4969
+ "description": "Additional CSS classes (e.g. \"sr-only\" to visually hide the legend)"
4564
4970
  }
4565
4971
  }
4566
4972
  }
4567
4973
  }
4568
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
+ },
4569
5080
  "Select": {
4570
5081
  "name": "Select",
4571
5082
  "type": "component",
@@ -5044,19 +5555,23 @@
5044
5555
  "props": {
5045
5556
  "defaultOpen": {
5046
5557
  "type": "boolean",
5047
- "optional": true
5558
+ "optional": true,
5559
+ "description": "Initial open state when uncontrolled."
5048
5560
  },
5049
5561
  "open": {
5050
5562
  "type": "boolean",
5051
- "optional": true
5563
+ "optional": true,
5564
+ "description": "Controlled open state."
5052
5565
  },
5053
5566
  "variant": {
5054
5567
  "type": "SidebarVariant",
5055
- "optional": true
5568
+ "optional": true,
5569
+ "description": "Sidebar layout variant."
5056
5570
  },
5057
5571
  "side": {
5058
5572
  "type": "SidebarSide",
5059
- "optional": true
5573
+ "optional": true,
5574
+ "description": "Which side the sidebar is on."
5060
5575
  },
5061
5576
  "collapsible": {
5062
5577
  "type": "\"icon\" | \"offcanvas\" | \"none\"",
@@ -5064,43 +5579,53 @@
5064
5579
  },
5065
5580
  "resizable": {
5066
5581
  "type": "boolean",
5067
- "optional": true
5582
+ "optional": true,
5583
+ "description": "Enable drag-to-resize on the sidebar edge."
5068
5584
  },
5069
5585
  "defaultWidth": {
5070
5586
  "type": "number",
5071
- "optional": true
5587
+ "optional": true,
5588
+ "description": "Initial width in pixels when resizable."
5072
5589
  },
5073
5590
  "minWidth": {
5074
5591
  "type": "number",
5075
- "optional": true
5592
+ "optional": true,
5593
+ "description": "Minimum width in pixels when resizing."
5076
5594
  },
5077
5595
  "maxWidth": {
5078
5596
  "type": "number",
5079
- "optional": true
5597
+ "optional": true,
5598
+ "description": "Maximum width in pixels when resizing."
5080
5599
  },
5081
5600
  "contained": {
5082
5601
  "type": "boolean",
5083
- "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."
5084
5604
  },
5085
5605
  "peekable": {
5086
5606
  "type": "boolean",
5087
- "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."
5088
5609
  },
5089
5610
  "animationDuration": {
5090
5611
  "type": "number",
5091
- "optional": true
5612
+ "optional": true,
5613
+ "description": "Duration of sidebar expand/collapse animation in milliseconds."
5092
5614
  },
5093
5615
  "mobileBreakpoint": {
5094
5616
  "type": "number",
5095
- "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."
5096
5619
  },
5097
5620
  "children": {
5098
5621
  "type": "ReactNode",
5099
- "required": true
5622
+ "required": true,
5623
+ "description": "Content — typically `<Sidebar>` + main content."
5100
5624
  },
5101
5625
  "className": {
5102
5626
  "type": "string",
5103
- "optional": true
5627
+ "optional": true,
5628
+ "description": "Additional CSS classes for the wrapper div."
5104
5629
  }
5105
5630
  }
5106
5631
  },
@@ -5109,7 +5634,37 @@
5109
5634
  "description": "Header sub-component",
5110
5635
  "props": {
5111
5636
  "icon": {
5112
- "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",
5113
5668
  "optional": true
5114
5669
  }
5115
5670
  }
@@ -5119,7 +5674,37 @@
5119
5674
  "description": "Content sub-component",
5120
5675
  "props": {
5121
5676
  "icon": {
5122
- "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",
5123
5708
  "optional": true
5124
5709
  }
5125
5710
  }
@@ -5129,7 +5714,37 @@
5129
5714
  "description": "Footer sub-component",
5130
5715
  "props": {
5131
5716
  "icon": {
5132
- "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",
5133
5748
  "optional": true
5134
5749
  }
5135
5750
  }
@@ -5139,7 +5754,37 @@
5139
5754
  "description": "Group sub-component",
5140
5755
  "props": {
5141
5756
  "icon": {
5142
- "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",
5143
5788
  "optional": true
5144
5789
  }
5145
5790
  }
@@ -5149,7 +5794,37 @@
5149
5794
  "description": "GroupLabel sub-component",
5150
5795
  "props": {
5151
5796
  "icon": {
5152
- "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",
5153
5828
  "optional": true
5154
5829
  }
5155
5830
  }
@@ -5159,7 +5834,37 @@
5159
5834
  "description": "Menu sub-component",
5160
5835
  "props": {
5161
5836
  "icon": {
5162
- "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",
5163
5868
  "optional": true
5164
5869
  }
5165
5870
  }
@@ -5169,7 +5874,37 @@
5169
5874
  "description": "MenuItem sub-component",
5170
5875
  "props": {
5171
5876
  "icon": {
5172
- "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",
5173
5908
  "optional": true
5174
5909
  }
5175
5910
  }
@@ -5179,7 +5914,37 @@
5179
5914
  "description": "MenuButton sub-component",
5180
5915
  "props": {
5181
5916
  "icon": {
5182
- "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",
5183
5948
  "optional": true
5184
5949
  }
5185
5950
  }
@@ -5190,11 +5955,18 @@
5190
5955
  "props": {
5191
5956
  "active": {
5192
5957
  "type": "boolean",
5193
- "optional": true
5958
+ "optional": true,
5959
+ "description": "Marks this sub-item as currently active/selected."
5194
5960
  },
5195
5961
  "href": {
5196
5962
  "type": "string",
5197
- "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."
5198
5970
  }
5199
5971
  }
5200
5972
  },
@@ -5204,11 +5976,18 @@
5204
5976
  "props": {
5205
5977
  "active": {
5206
5978
  "type": "boolean",
5207
- "optional": true
5979
+ "optional": true,
5980
+ "description": "Marks this sub-item as currently active/selected."
5208
5981
  },
5209
5982
  "href": {
5210
5983
  "type": "string",
5211
- "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."
5212
5991
  }
5213
5992
  }
5214
5993
  },
@@ -5218,11 +5997,18 @@
5218
5997
  "props": {
5219
5998
  "active": {
5220
5999
  "type": "boolean",
5221
- "optional": true
6000
+ "optional": true,
6001
+ "description": "Marks this sub-item as currently active/selected."
5222
6002
  },
5223
6003
  "href": {
5224
6004
  "type": "string",
5225
- "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."
5226
6012
  }
5227
6013
  }
5228
6014
  },
@@ -5232,11 +6018,18 @@
5232
6018
  "props": {
5233
6019
  "active": {
5234
6020
  "type": "boolean",
5235
- "optional": true
6021
+ "optional": true,
6022
+ "description": "Marks this sub-item as currently active/selected."
5236
6023
  },
5237
6024
  "href": {
5238
6025
  "type": "string",
5239
- "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."
5240
6033
  }
5241
6034
  }
5242
6035
  },
@@ -5246,15 +6039,18 @@
5246
6039
  "props": {
5247
6040
  "defaultOpen": {
5248
6041
  "type": "boolean",
5249
- "optional": true
6042
+ "optional": true,
6043
+ "description": "Initial open state (uncontrolled)."
5250
6044
  },
5251
6045
  "open": {
5252
6046
  "type": "boolean",
5253
- "optional": true
6047
+ "optional": true,
6048
+ "description": "Controlled open state."
5254
6049
  },
5255
6050
  "autoScrollOnOpen": {
5256
6051
  "type": "boolean",
5257
- "optional": true
6052
+ "optional": true,
6053
+ "description": "Scroll the expanded content into view after opening."
5258
6054
  }
5259
6055
  }
5260
6056
  },
@@ -5264,15 +6060,18 @@
5264
6060
  "props": {
5265
6061
  "defaultOpen": {
5266
6062
  "type": "boolean",
5267
- "optional": true
6063
+ "optional": true,
6064
+ "description": "Initial open state (uncontrolled)."
5268
6065
  },
5269
6066
  "open": {
5270
6067
  "type": "boolean",
5271
- "optional": true
6068
+ "optional": true,
6069
+ "description": "Controlled open state."
5272
6070
  },
5273
6071
  "autoScrollOnOpen": {
5274
6072
  "type": "boolean",
5275
- "optional": true
6073
+ "optional": true,
6074
+ "description": "Scroll the expanded content into view after opening."
5276
6075
  }
5277
6076
  }
5278
6077
  },
@@ -5282,15 +6081,18 @@
5282
6081
  "props": {
5283
6082
  "defaultOpen": {
5284
6083
  "type": "boolean",
5285
- "optional": true
6084
+ "optional": true,
6085
+ "description": "Initial open state (uncontrolled)."
5286
6086
  },
5287
6087
  "open": {
5288
6088
  "type": "boolean",
5289
- "optional": true
6089
+ "optional": true,
6090
+ "description": "Controlled open state."
5290
6091
  },
5291
6092
  "autoScrollOnOpen": {
5292
6093
  "type": "boolean",
5293
- "optional": true
6094
+ "optional": true,
6095
+ "description": "Scroll the expanded content into view after opening."
5294
6096
  }
5295
6097
  }
5296
6098
  },
@@ -5300,15 +6102,18 @@
5300
6102
  "props": {
5301
6103
  "defaultOpen": {
5302
6104
  "type": "boolean",
5303
- "optional": true
6105
+ "optional": true,
6106
+ "description": "Initial open state (uncontrolled)."
5304
6107
  },
5305
6108
  "open": {
5306
6109
  "type": "boolean",
5307
- "optional": true
6110
+ "optional": true,
6111
+ "description": "Controlled open state."
5308
6112
  },
5309
6113
  "autoScrollOnOpen": {
5310
6114
  "type": "boolean",
5311
- "optional": true
6115
+ "optional": true,
6116
+ "description": "Scroll the expanded content into view after opening."
5312
6117
  }
5313
6118
  }
5314
6119
  },
@@ -5328,15 +6133,18 @@
5328
6133
  "props": {
5329
6134
  "defaultOpen": {
5330
6135
  "type": "boolean",
5331
- "optional": true
6136
+ "optional": true,
6137
+ "description": "Initial open state (uncontrolled)."
5332
6138
  },
5333
6139
  "open": {
5334
6140
  "type": "boolean",
5335
- "optional": true
6141
+ "optional": true,
6142
+ "description": "Controlled open state."
5336
6143
  },
5337
6144
  "autoScrollOnOpen": {
5338
6145
  "type": "boolean",
5339
- "optional": true
6146
+ "optional": true,
6147
+ "description": "Scroll the expanded content into view after opening."
5340
6148
  }
5341
6149
  }
5342
6150
  },
@@ -5346,7 +6154,8 @@
5346
6154
  "props": {
5347
6155
  "render": {
5348
6156
  "type": "React.ReactElement",
5349
- "required": true
6157
+ "required": true,
6158
+ "description": "Element to render as the trigger. Gets aria-expanded, aria-controls, and onClick merged."
5350
6159
  }
5351
6160
  }
5352
6161
  },
@@ -5356,11 +6165,13 @@
5356
6165
  "props": {
5357
6166
  "activeKey": {
5358
6167
  "type": "string",
5359
- "required": true
6168
+ "required": true,
6169
+ "description": "Key of the currently active view. Must match a child `SlidingView` value."
5360
6170
  },
5361
6171
  "direction": {
5362
6172
  "type": "\"left\" | \"right\"",
5363
- "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"
5364
6175
  }
5365
6176
  }
5366
6177
  },
@@ -5370,11 +6181,13 @@
5370
6181
  "props": {
5371
6182
  "activeKey": {
5372
6183
  "type": "string",
5373
- "required": true
6184
+ "required": true,
6185
+ "description": "Key of the currently active view. Must match a child `SlidingView` value."
5374
6186
  },
5375
6187
  "direction": {
5376
6188
  "type": "\"left\" | \"right\"",
5377
- "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"
5378
6191
  }
5379
6192
  }
5380
6193
  },
@@ -5384,7 +6197,8 @@
5384
6197
  "props": {
5385
6198
  "value": {
5386
6199
  "type": "string",
5387
- "required": true
6200
+ "required": true,
6201
+ "description": "Unique key matching this view. Must correspond to `activeKey` on `SlidingViews`."
5388
6202
  }
5389
6203
  }
5390
6204
  }
@@ -5586,31 +6400,38 @@
5586
6400
  "props": {
5587
6401
  "legend": {
5588
6402
  "type": "string",
5589
- "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."
5590
6405
  },
5591
6406
  "children": {
5592
6407
  "type": "ReactNode",
5593
- "required": true
6408
+ "required": true,
6409
+ "description": "Child Switch.Item components (and optionally a Switch.Legend)"
5594
6410
  },
5595
6411
  "error": {
5596
6412
  "type": "string",
5597
- "optional": true
6413
+ "optional": true,
6414
+ "description": "Error message for the group (only appears in groups, not single switches)"
5598
6415
  },
5599
6416
  "description": {
5600
6417
  "type": "ReactNode",
5601
- "optional": true
6418
+ "optional": true,
6419
+ "description": "Helper text for the group"
5602
6420
  },
5603
6421
  "disabled": {
5604
6422
  "type": "boolean",
5605
- "optional": true
6423
+ "optional": true,
6424
+ "description": "Whether all switches in the group are disabled"
5606
6425
  },
5607
6426
  "controlFirst": {
5608
6427
  "type": "boolean",
5609
- "optional": true
6428
+ "optional": true,
6429
+ "description": "When true (default), switch appears before label. When false, label appears before switch."
5610
6430
  },
5611
6431
  "className": {
5612
6432
  "type": "string",
5613
- "optional": true
6433
+ "optional": true,
6434
+ "description": "Additional CSS classes"
5614
6435
  }
5615
6436
  }
5616
6437
  },
@@ -5620,11 +6441,13 @@
5620
6441
  "props": {
5621
6442
  "children": {
5622
6443
  "type": "ReactNode",
5623
- "required": true
6444
+ "required": true,
6445
+ "description": "Legend content"
5624
6446
  },
5625
6447
  "className": {
5626
6448
  "type": "string",
5627
- "optional": true
6449
+ "optional": true,
6450
+ "description": "Additional CSS classes (e.g. \"sr-only\" to visually hide the legend)"
5628
6451
  }
5629
6452
  }
5630
6453
  }
@@ -5819,7 +6642,13 @@
5819
6642
  "props": {
5820
6643
  "active": {
5821
6644
  "type": "boolean",
5822
- "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`."
5823
6652
  }
5824
6653
  }
5825
6654
  },
@@ -5829,15 +6658,18 @@
5829
6658
  "props": {
5830
6659
  "label": {
5831
6660
  "type": "string",
5832
- "required": true
6661
+ "required": true,
6662
+ "description": "Label displayed above the group's items."
5833
6663
  },
5834
6664
  "href": {
5835
6665
  "type": "string",
5836
- "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."
5837
6668
  },
5838
6669
  "active": {
5839
6670
  "type": "boolean",
5840
- "optional": true
6671
+ "optional": true,
6672
+ "description": "Whether this group's label represents the currently active section. Only applies when `href` is provided."
5841
6673
  }
5842
6674
  }
5843
6675
  }
@@ -6110,6 +6942,165 @@
6110
6942
  }
6111
6943
  }
6112
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
+ },
6113
7104
  "Toasty": {
6114
7105
  "name": "Toasty",
6115
7106
  "type": "component",
@@ -6142,13 +7133,20 @@
6142
7133
  "info": "ring-[0.3px] ring-kumo-info bg-kumo-control [&_[data-toast-icon]]:text-kumo-info [&_[data-toast-title]]:text-kumo-info"
6143
7134
  }
6144
7135
  },
6145
- "className": {
6146
- "type": "string",
6147
- "description": "Additional CSS classes"
6148
- },
6149
7136
  "children": {
6150
- "type": "ReactNode",
6151
- "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."
6152
7150
  }
6153
7151
  },
6154
7152
  "examples": [
@@ -6682,6 +7680,13 @@
6682
7680
  "Loader",
6683
7681
  "Toasty"
6684
7682
  ],
7683
+ "Data Visualization": [
7684
+ "BubbleMap",
7685
+ "Chart",
7686
+ "ChoroplethMap",
7687
+ "SankeyChart",
7688
+ "TimeseriesChart"
7689
+ ],
6685
7690
  "Action": [
6686
7691
  "Button",
6687
7692
  "ClipboardText"
@@ -6721,8 +7726,11 @@
6721
7726
  "Badge",
6722
7727
  "Banner",
6723
7728
  "Breadcrumbs",
7729
+ "BubbleMap",
6724
7730
  "Button",
7731
+ "Chart",
6725
7732
  "Checkbox",
7733
+ "ChoroplethMap",
6726
7734
  "ClipboardText",
6727
7735
  "CloudflareLogo",
6728
7736
  "Code",
@@ -6750,6 +7758,7 @@
6750
7758
  "Popover",
6751
7759
  "Radio",
6752
7760
  "ResourceListPage",
7761
+ "SankeyChart",
6753
7762
  "Select",
6754
7763
  "SensitiveInput",
6755
7764
  "Sidebar",
@@ -6759,6 +7768,7 @@
6759
7768
  "TableOfContents",
6760
7769
  "Tabs",
6761
7770
  "Text",
7771
+ "TimeseriesChart",
6762
7772
  "Toasty",
6763
7773
  "Toolbar",
6764
7774
  "Tooltip"
@@ -6769,8 +7779,11 @@
6769
7779
  "Badge",
6770
7780
  "Banner",
6771
7781
  "Breadcrumbs",
7782
+ "BubbleMap",
6772
7783
  "Button",
7784
+ "Chart",
6773
7785
  "Checkbox",
7786
+ "ChoroplethMap",
6774
7787
  "ClipboardText",
6775
7788
  "CloudflareLogo",
6776
7789
  "Code",
@@ -6795,6 +7808,7 @@
6795
7808
  "Pagination",
6796
7809
  "Popover",
6797
7810
  "Radio",
7811
+ "SankeyChart",
6798
7812
  "Select",
6799
7813
  "SensitiveInput",
6800
7814
  "Sidebar",
@@ -6804,6 +7818,7 @@
6804
7818
  "TableOfContents",
6805
7819
  "Tabs",
6806
7820
  "Text",
7821
+ "TimeseriesChart",
6807
7822
  "Toasty",
6808
7823
  "Toolbar",
6809
7824
  "Tooltip"