minerva-design 1.3.0 → 1.4.0

package/dist/charts/react/shapes.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"shapes.cjs","names":["useMemo","useRef","useState","createShapeChart","createPortal","require_chart","react","react_dom","react_jsx_runtime","size","value","fallback","useCommonOptions","hiddenKey","hidden","stableHidden","palette","legend","tooltip","format","percentFormat","animation","padding","ariaLabel","ShapeChartBase","handlers","containerRef","chartRef","handlersRef","tooltipRef","renderTooltip","tipEvent","setTipEvent","tipHost","customTooltip","resolved","options","base","event","optionsRef","container","chart","offs","off","handleRef","width","height","style","PieChart","PieBase","props","DonutChart","common","innerRadius","defaultInner","data","startAngle","padAngle","cornerRadius","rose","labels","labelContent","centerValue","centerLabel","ShapeHost","RadarChart","indicators","series","shape","levels","dots","GaugeChart","min","max","label","sweep","thickness","bands","color","needle","ticks","FunnelChart","sort","gap","conversion","TreemapChart","headers","defaultHeight"],"sources":["../../../../charts/src/react/shapes.tsx"],"sourcesContent":["import {\n  useEffect,\n  useImperativeHandle,\n  useMemo,\n  useRef,\n  useState,\n  type CSSProperties,\n  type ReactNode,\n  type Ref,\n} from \"react\";\nimport { createPortal, flushSync } from \"react-dom\";\nimport type { ChartPadding } from \"../engine/types\";\nimport { createShapeChart } from \"../engine/shapes/chart\";\nimport type {\n  FunnelChartOptions,\n  GaugeBand,\n  GaugeChartOptions,\n  PieChartOptions,\n  RadarChartOptions,\n  RadarIndicator,\n  RadarSeries,\n  ShapeChartCommonOptions,\n  ShapeChartInstance,\n  ShapeChartOptions,\n  ShapeDatum,\n  ShapeHoverEvent,\n  ShapeLegendOptions,\n  ShapeToggleEvent,\n  ShapeTooltipOptions,\n  TreemapChartOptions,\n  TreemapNode,\n} from \"../engine/shapes/types\";\n\n/** Imperative handle of the shape chart components (`ref`) */\nexport interface ShapeChartHandle {\n  /** The underlying engine instance (minerva-design/charts/core) */\n  getInstance(): ShapeChartInstance | null;\n}\n\n/** Props shared by PieChart, DonutChart, RadarChart, GaugeChart, FunnelChart and TreemapChart */\nexport interface ShapeChartCommonProps {\n  /**\n   * Height of the chart (the legend included); numbers are pixels\n   * @default 320 (GaugeChart: 240)\n   */\n  height?: number | string;\n  /**\n   * Width of the chart; numbers are pixels\n   * @default \"100%\"\n   */\n  width?: number | string;\n  /** Colors of the marks without `color` (defaults to the `--chart-series-1..8` CSS variables, then the theme colors) */\n  palette?: readonly string[];\n  /**\n   * Legend; clicking an item hides / shows its slice, stage or series\n   * @default shown for pie, donut, funnel and multi-series radar charts\n   */\n  legend?: boolean | ShapeLegendOptions;\n  /**\n   * Tooltip; `false` disables it\n   * @default true\n   */\n  tooltip?: boolean | ShapeTooltipOptions;\n  /**\n   * Formats the values of the labels and the tooltip\n   * @default compact numbers (1.2k, 3.4M)\n   */\n  format?: (value: number) => string;\n  /**\n   * Formats the shares (labels, conversion rates, tooltip); `share` is 0-1\n   * @default one decimal, e.g. \"40.0%\"\n   */\n  percentFormat?: (share: number) => string;\n  /**\n   * Hidden slices / stages / radar series / top-level treemap nodes, by\n   * index. Makes the visibility controlled: legend clicks then only call\n   * `onToggle`, whose `hiddenIndexes` should be stored and passed back.\n   * Leave undefined to let the legend hide / show entries by itself.\n   */\n  hidden?: readonly number[];\n  /**\n   * Called when a legend item is clicked (or the instance's `toggle()` is\n   * called), with the toggled index and every hidden index after the toggle\n   */\n  onToggle?: (event: ShapeToggleEvent) => void;\n  /**\n   * Entry and update animations (skipped when the user prefers reduced motion)\n   * @default true\n   */\n  animation?: boolean;\n  /**\n   * Space around the drawing, in pixels\n   * @default 8 on every side\n   */\n  padding?: ChartPadding;\n  /**\n   * Accessible name of the chart\n   * @default the chart type, e.g. \"Donut chart\"\n   */\n  ariaLabel?: string;\n  /** Called when the hovered (or keyboard-focused) mark changes */\n  onHover?: (event: ShapeHoverEvent | null) => void;\n  /** Called when a mark is clicked, tapped or activated with Enter */\n  onClick?: (event: ShapeHoverEvent) => void;\n  /** React content of the tooltip (replaces the default content) */\n  renderTooltip?: (event: ShapeHoverEvent) => ReactNode;\n  /** Additional class name of the root element */\n  className?: string;\n  /** Inline styles of the root element */\n  style?: CSSProperties;\n  /** Imperative handle */\n  ref?: Ref<ShapeChartHandle>;\n}\n\n/** Props of PieChart */\nexport interface PieChartProps extends ShapeChartCommonProps {\n  /** Slices: a name, a value (negative values count as 0) and an optional color */\n  data: readonly ShapeDatum[];\n  /**\n   * Inner radius as a fraction of the outer radius: 0 = pie, 0.6 = donut\n   * @default 0\n   */\n  innerRadius?: number;\n  /**\n   * Angle of the first slice, degrees clockwise from 12 o'clock\n   * @default 0\n   */\n  startAngle?: number;\n  /**\n   * Gap between the slices, in pixels\n   * @default 1 (pie), 2 (donut)\n   */\n  padAngle?: number;\n  /**\n   * Corner radius of the slices, in pixels\n   * @default 0 (pie), 4 (donut)\n   */\n  cornerRadius?: number;\n  /**\n   * Nightingale rose: the radius (instead of the angle) shows the value\n   * @default false\n   */\n  rose?: boolean;\n  /**\n   * Slice labels: `outside` with leader lines, `inside` the slices, or none\n   * @default \"outside\" (up to 12 slices), \"none\" otherwise\n   */\n  labels?: \"outside\" | \"inside\" | \"none\";\n  /**\n   * What a label shows: name, value, percent (combinable)\n   * @default [\"name\", \"percent\"]\n   */\n  labelContent?: readonly (\"name\" | \"value\" | \"percent\")[];\n  /** Big text in the hole of a donut (e.g. the total) */\n  centerValue?: string;\n  /** Small text under `centerValue` */\n  centerLabel?: string;\n}\n\n/** Props of DonutChart: a PieChart with a hole */\nexport interface DonutChartProps extends PieChartProps {\n  /**\n   * Inner radius as a fraction of the outer radius\n   * @default 0.62\n   */\n  innerRadius?: number;\n}\n\n/** Props of RadarChart */\nexport interface RadarChartProps extends ShapeChartCommonProps {\n  /** Axes of the chart, clockwise from 12 o'clock */\n  indicators: readonly RadarIndicator[];\n  /** Polygons: one value per indicator */\n  series: readonly RadarSeries[];\n  /**\n   * Grid shape\n   * @default \"polygon\"\n   */\n  shape?: \"polygon\" | \"circle\";\n  /**\n   * Number of grid rings\n   * @default 4\n   */\n  levels?: number;\n  /**\n   * Dots on the vertices\n   * @default true\n   */\n  dots?: boolean;\n}\n\n/** Props of GaugeChart */\nexport interface GaugeChartProps extends ShapeChartCommonProps {\n  /** Value shown by the arc (clamped to `min` - `max` for the drawing) */\n  value: number;\n  /**\n   * Value at the start of the arc\n   * @default 0\n   */\n  min?: number;\n  /**\n   * Value at the end of the arc\n   * @default 100\n   */\n  max?: number;\n  /** Caption under the value */\n  label?: string;\n  /**\n   * Total angle of the arc, degrees\n   * @default 240\n   */\n  sweep?: number;\n  /**\n   * Thickness of the arc as a fraction of the radius\n   * @default 0.16\n   */\n  thickness?: number;\n  /** Colored ranges of the track; the value arc takes the color of its band */\n  bands?: readonly GaugeBand[];\n  /**\n   * Color of the value arc (when there are no bands)\n   * @default the first palette color\n   */\n  color?: string;\n  /**\n   * Draws a needle in addition to the value arc\n   * @default false\n   */\n  needle?: boolean;\n  /**\n   * Tick labels at the ends (and at the band bounds)\n   * @default true\n   */\n  ticks?: boolean;\n}\n\n/** Props of FunnelChart */\nexport interface FunnelChartProps extends ShapeChartCommonProps {\n  /** Stages: a name, a value and an optional color */\n  data: readonly ShapeDatum[];\n  /**\n   * Order of the stages\n   * @default \"none\" (data order)\n   */\n  sort?: \"descending\" | \"ascending\" | \"none\";\n  /**\n   * Vertical gap between the stages, in pixels\n   * @default 4\n   */\n  gap?: number;\n  /**\n   * Shows the conversion rate from the previous stage\n   * @default true\n   */\n  conversion?: boolean;\n  /**\n   * Shape of the stages: trapezoids that narrow to the next stage, or centered bars\n   * @default \"trapezoid\"\n   */\n  shape?: \"trapezoid\" | \"bar\";\n}\n\n/** Props of TreemapChart */\nexport interface TreemapChartProps extends ShapeChartCommonProps {\n  /** Nodes: leaves carry a value, parents sum their children */\n  data: readonly TreemapNode[];\n  /**\n   * Gap between the cells, in pixels\n   * @default 2\n   */\n  gap?: number;\n  /**\n   * Draws the names of the parents above their children\n   * @default true\n   */\n  headers?: boolean;\n}\n\ninterface Handlers {\n  onHover?: (event: ShapeHoverEvent | null) => void;\n  onClick?: (event: ShapeHoverEvent) => void;\n  onToggle?: (event: ShapeToggleEvent) => void;\n}\n\ninterface ShapeChartBaseProps extends Handlers {\n  options: ShapeChartOptions;\n  height: number | string;\n  width?: number | string;\n  className?: string;\n  style?: CSSProperties;\n  handleRef?: Ref<ShapeChartHandle>;\n  renderTooltip?: (event: ShapeHoverEvent) => ReactNode;\n}\n\nconst size = (value: number | string | undefined, fallback: string) =>\n  value === undefined\n    ? fallback\n    : typeof value === \"number\"\n      ? `${value}px`\n      : value;\n\n/** Engine options shared by every type, stable while the props are equal */\nconst useCommonOptions = ({\n  palette,\n  legend,\n  tooltip,\n  format,\n  percentFormat,\n  hidden,\n  animation,\n  padding,\n  ariaLabel,\n}: ShapeChartCommonProps): ShapeChartCommonOptions => {\n  // a new array with the same indexes keeps the options (and the animation)\n  const hiddenKey = hidden ? hidden.join(\",\") : null;\n  const stableHidden = useMemo(\n    () =>\n      hiddenKey === null\n        ? undefined\n        : hiddenKey\n          ? hiddenKey.split(\",\").map(Number)\n          : [],\n    [hiddenKey],\n  );\n  return useMemo(\n    () => ({\n      palette,\n      legend,\n      tooltip,\n      format,\n      percentFormat,\n      hidden: stableHidden,\n      animation,\n      padding,\n      ariaLabel,\n    }),\n    [\n      palette,\n      legend,\n      tooltip,\n      format,\n      percentFormat,\n      stableHidden,\n      animation,\n      padding,\n      ariaLabel,\n    ],\n  );\n};\n\n/** Mounts the engine in a sized <div> and forwards option / handler changes */\nfunction ShapeChartBase({\n  options,\n  height,\n  width,\n  className,\n  style,\n  handleRef,\n  renderTooltip,\n  ...handlers\n}: ShapeChartBaseProps) {\n  const containerRef = useRef<HTMLDivElement>(null);\n  const chartRef = useRef<ShapeChartInstance | null>(null);\n  const handlersRef = useRef<Handlers>(handlers);\n  const tooltipRef = useRef(renderTooltip);\n  const [tipEvent, setTipEvent] = useState<ShapeHoverEvent | null>(null);\n  const tipHost = useMemo(\n    () =>\n      typeof document === \"undefined\" ? null : document.createElement(\"div\"),\n    [],\n  );\n  const customTooltip = !!renderTooltip;\n\n  const resolved = useMemo((): ShapeChartOptions => {\n    if (!customTooltip || !tipHost || options.tooltip === false) return options;\n    const base = typeof options.tooltip === \"object\" ? options.tooltip : {};\n    return {\n      ...options,\n      tooltip: {\n        ...base,\n        render: (event) => {\n          if (!tooltipRef.current) return null;\n          // render synchronously so the engine measures the final size\n          flushSync(() => setTipEvent(event));\n          return tipHost;\n        },\n      },\n    };\n  }, [options, customTooltip, tipHost]);\n  const optionsRef = useRef(resolved);\n\n  useEffect(() => {\n    handlersRef.current = handlers;\n    tooltipRef.current = renderTooltip;\n  });\n\n  useEffect(() => {\n    const container = containerRef.current;\n    if (!container) return;\n    const chart = createShapeChart(container, optionsRef.current);\n    chartRef.current = chart;\n    const offs = [\n      chart.on(\"hover\", (e) => handlersRef.current.onHover?.(e)),\n      chart.on(\"click\", (e) => handlersRef.current.onClick?.(e)),\n      chart.on(\"toggle\", (e) => handlersRef.current.onToggle?.(e)),\n    ];\n    return () => {\n      offs.forEach((off) => off());\n      chart.destroy();\n      chartRef.current = null;\n    };\n  }, []);\n\n  useEffect(() => {\n    if (optionsRef.current === resolved) return;\n    optionsRef.current = resolved;\n    chartRef.current?.setOptions(resolved);\n  }, [resolved]);\n\n  useImperativeHandle(\n    handleRef,\n    () => ({ getInstance: () => chartRef.current }),\n    [],\n  );\n\n  return (\n    <div\n      className={className}\n      style={{\n        position: \"relative\",\n        width: size(width, \"100%\"),\n        height: size(height, \"320px\"),\n        ...style,\n      }}\n    >\n      <div ref={containerRef} style={{ position: \"absolute\", inset: 0 }} />\n      {tipHost &&\n        tipEvent &&\n        renderTooltip &&\n        createPortal(renderTooltip(tipEvent), tipHost)}\n    </div>\n  );\n}\n\n/**\n * Pie chart (or a donut with `innerRadius`, or a Nightingale rose with\n * `rose`): slices with gaps, outside labels with leader lines, legend toggles.\n */\nexport function PieChart(props: PieChartProps) {\n  return <PieBase {...props} defaultInner={0} />;\n}\n\n/** Donut chart: a PieChart with a hole and optional center texts */\nexport function DonutChart(props: DonutChartProps) {\n  return <PieBase {...props} defaultInner={0.62} />;\n}\n\nfunction PieBase(props: PieChartProps & { defaultInner: number }) {\n  const {\n    data,\n    innerRadius,\n    startAngle,\n    padAngle,\n    cornerRadius,\n    rose,\n    labels,\n    labelContent,\n    centerValue,\n    centerLabel,\n    defaultInner,\n  } = props;\n  const common = useCommonOptions(props);\n  const options = useMemo(\n    (): PieChartOptions => ({\n      ...common,\n      type: \"pie\",\n      data,\n      innerRadius: innerRadius ?? defaultInner,\n      startAngle,\n      padAngle,\n      cornerRadius,\n      rose,\n      labels,\n      labelContent,\n      centerValue,\n      centerLabel,\n    }),\n    [\n      common,\n      data,\n      innerRadius,\n      defaultInner,\n      startAngle,\n      padAngle,\n      cornerRadius,\n      rose,\n      labels,\n      labelContent,\n      centerValue,\n      centerLabel,\n    ],\n  );\n  return <ShapeHost props={props} options={options} defaultHeight={320} />;\n}\n\n/** Radar (spider) chart comparing series over several indicators */\nexport function RadarChart(props: RadarChartProps) {\n  const { indicators, series, shape, levels, dots } = props;\n  const common = useCommonOptions(props);\n  const options = useMemo(\n    (): RadarChartOptions => ({\n      ...common,\n      type: \"radar\",\n      indicators,\n      series,\n      shape,\n      levels,\n      dots,\n    }),\n    [common, indicators, series, shape, levels, dots],\n  );\n  return <ShapeHost props={props} options={options} defaultHeight={320} />;\n}\n\n/** Gauge (speedometer) showing one value on an arc, with colored bands */\nexport function GaugeChart(props: GaugeChartProps) {\n  const {\n    value,\n    min,\n    max,\n    label,\n    sweep,\n    thickness,\n    bands,\n    color,\n    needle,\n    ticks,\n  } = props;\n  const common = useCommonOptions(props);\n  const options = useMemo(\n    (): GaugeChartOptions => ({\n      ...common,\n      type: \"gauge\",\n      value,\n      min,\n      max,\n      label,\n      sweep,\n      thickness,\n      bands,\n      color,\n      needle,\n      ticks,\n    }),\n    [\n      common,\n      value,\n      min,\n      max,\n      label,\n      sweep,\n      thickness,\n      bands,\n      color,\n      needle,\n      ticks,\n    ],\n  );\n  return <ShapeHost props={props} options={options} defaultHeight={240} />;\n}\n\n/** Funnel chart of the stages of a process, with conversion rates */\nexport function FunnelChart(props: FunnelChartProps) {\n  const { data, sort, gap, conversion, shape } = props;\n  const common = useCommonOptions(props);\n  const options = useMemo(\n    (): FunnelChartOptions => ({\n      ...common,\n      type: \"funnel\",\n      data,\n      sort,\n      gap,\n      conversion,\n      shape,\n    }),\n    [common, data, sort, gap, conversion, shape],\n  );\n  return <ShapeHost props={props} options={options} defaultHeight={320} />;\n}\n\n/** Treemap: nested rectangles of areas proportional to the values */\nexport function TreemapChart(props: TreemapChartProps) {\n  const { data, gap, headers } = props;\n  const common = useCommonOptions(props);\n  const options = useMemo(\n    (): TreemapChartOptions => ({\n      ...common,\n      type: \"treemap\",\n      data,\n      gap,\n      headers,\n    }),\n    [common, data, gap, headers],\n  );\n  return <ShapeHost props={props} options={options} defaultHeight={320} />;\n}\n\nfunction ShapeHost({\n  props,\n  options,\n  defaultHeight,\n}: {\n  props: ShapeChartCommonProps;\n  options: ShapeChartOptions;\n  defaultHeight: number;\n}) {\n  return (\n    <ShapeChartBase\n      options={options}\n      height={props.height ?? defaultHeight}\n      width={props.width}\n      className={props.className}\n      style={props.style}\n      handleRef={props.ref}\n      onHover={props.onHover}\n      onClick={props.onClick}\n      onToggle={props.onToggle}\n      renderTooltip={props.renderTooltip}\n    />\n  );\n}\n"],"mappings":"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"}
+{"version":3,"file":"shapes.cjs","names":["useSyncExternalStore","useMemo","useRef","useState","createShapeChart","createPortal","calendarStrips","require_calendar","require_chart","react","react_dom","react_jsx_runtime","size","value","fallback","subscribePageLanguage","observer","onChange","pageLanguage","noPageLanguage","useCommonOptions","language","resolvedLocale","locale","hiddenKey","hidden","stableHidden","palette","legend","tooltip","format","percentFormat","texts","animation","padding","ariaLabel","ShapeChartBase","handlers","containerRef","chartRef","handlersRef","tooltipRef","renderTooltip","tipEvent","setTipEvent","tipHost","customTooltip","resolved","options","base","event","optionsRef","container","chart","offs","off","handleRef","width","height","style","PieChart","PieBase","props","DonutChart","common","innerRadius","defaultInner","data","startAngle","padAngle","cornerRadius","rose","labels","labelContent","centerValue","centerLabel","ShapeHost","RadarChart","indicators","series","shape","levels","dots","GaugeChart","min","max","label","sweep","thickness","bands","color","needle","ticks","FunnelChart","sort","gap","conversion","TreemapChart","headers","SankeyChart","nodes","links","nodeWidth","nodePadding","align","iterations","linkColor","linkOpacity","labelValues","SunburstChart","drillKey","drillPath","stablePath","drill","RadialBarChart","track","rounded","CalendarHeatmap","range","layout","weekStart","colors","thresholds","radius","maxCellSize","monthLabels","weekdayLabels","defaultHeight","BulletChart","orientation","ranges","rangeLabels","rangeColors","barSize","targetColor"],"sources":["../../../../charts/src/react/shapes.tsx"],"sourcesContent":["import {\n  useEffect,\n  useImperativeHandle,\n  useMemo,\n  useRef,\n  useState,\n  useSyncExternalStore,\n  type CSSProperties,\n  type ReactNode,\n  type Ref,\n} from \"react\";\nimport { createPortal, flushSync } from \"react-dom\";\nimport type { ChartPadding } from \"../engine/types\";\nimport { calendarStrips } from \"../engine/shapes/calendar\";\nimport { createShapeChart } from \"../engine/shapes/chart\";\nimport type {\n  BulletChartOptions,\n  BulletDatum,\n  CalendarDate,\n  CalendarDatum,\n  CalendarHeatmapOptions,\n  FunnelChartOptions,\n  GaugeBand,\n  GaugeChartOptions,\n  PieChartOptions,\n  RadarChartOptions,\n  RadarIndicator,\n  RadarSeries,\n  RadialBarChartOptions,\n  RadialBarDatum,\n  SankeyChartOptions,\n  SankeyLink,\n  SankeyNode,\n  ShapeChartCommonOptions,\n  ShapeChartInstance,\n  ShapeChartLabels,\n  ShapeChartOptions,\n  ShapeDatum,\n  ShapeDrillEvent,\n  ShapeHoverEvent,\n  ShapeLegendOptions,\n  ShapeToggleEvent,\n  ShapeTooltipOptions,\n  SunburstChartOptions,\n  TreemapChartOptions,\n  TreemapNode,\n} from \"../engine/shapes/types\";\n\n/** Imperative handle of the shape chart components (`ref`) */\nexport interface ShapeChartHandle {\n  /** The underlying engine instance (minerva-design/charts/core) */\n  getInstance(): ShapeChartInstance | null;\n}\n\n/**\n * Props shared by PieChart, DonutChart, RadarChart, GaugeChart, FunnelChart,\n * TreemapChart, SankeyChart, SunburstChart, RadialBarChart, CalendarHeatmap\n * and BulletChart\n */\nexport interface ShapeChartCommonProps {\n  /**\n   * Height of the chart (the legend included); numbers are pixels\n   * @default 320 (GaugeChart: 240, RadialBarChart: 300, CalendarHeatmap and BulletChart: from the data)\n   */\n  height?: number | string;\n  /**\n   * Width of the chart; numbers are pixels\n   * @default \"100%\"\n   */\n  width?: number | string;\n  /** Colors of the marks without `color` (defaults to the `--chart-series-1..8` CSS variables, then the theme colors) */\n  palette?: readonly string[];\n  /**\n   * Legend; clicking an item hides / shows its slice, stage, series, node, bar, row or level\n   * @default shown for pie, donut, funnel, multi-series radar charts, calendar heatmaps and radial bar charts without labels\n   */\n  legend?: boolean | ShapeLegendOptions;\n  /**\n   * Tooltip; `false` disables it\n   * @default true\n   */\n  tooltip?: boolean | ShapeTooltipOptions;\n  /**\n   * Formats the values of the labels and the tooltip\n   * @default compact numbers of the `locale` (1.2k, 3.4M; 1.2万 in Chinese and Japanese)\n   */\n  format?: (value: number) => string;\n  /**\n   * Formats the shares (labels, conversion rates, tooltip); `share` is 0-1\n   * @default a percent of the `locale` with one decimal, e.g. \"40.0%\", \"40,0 %\"\n   */\n  percentFormat?: (share: number) => string;\n  /**\n   * BCP 47 locale of the texts and numbers the chart writes (tooltip rows,\n   * accessible names, number and percent formats, calendar dates); built-in\n   * texts in English, Chinese, Japanese and French (English otherwise)\n   * @default the page language (`<html lang>`, followed when it changes), else the browser language\n   */\n  locale?: string;\n  /** Replaces built-in texts of the `locale` (tooltip rows, accessible names, \"No data\") */\n  texts?: Partial<ShapeChartLabels>;\n  /**\n   * Hidden slices / stages / radar series / top-level treemap or sunburst\n   * nodes / sankey nodes / radial bars / bullet rows / calendar levels, by\n   * index. Makes the visibility controlled: legend clicks then only call\n   * `onToggle`, whose `hiddenIndexes` should be stored and passed back.\n   * Leave undefined to let the legend hide / show entries by itself.\n   */\n  hidden?: readonly number[];\n  /**\n   * Called when a legend item is clicked (or the instance's `toggle()` is\n   * called), with the toggled index and every hidden index after the toggle\n   */\n  onToggle?: (event: ShapeToggleEvent) => void;\n  /**\n   * Entry and update animations (skipped when the user prefers reduced motion)\n   * @default true\n   */\n  animation?: boolean;\n  /**\n   * Space around the drawing, in pixels\n   * @default 8 on every side\n   */\n  padding?: ChartPadding;\n  /**\n   * Accessible name of the chart\n   * @default the chart type in the `locale`, e.g. \"Donut chart\"\n   */\n  ariaLabel?: string;\n  /** Called when the hovered (or keyboard-focused) mark changes */\n  onHover?: (event: ShapeHoverEvent | null) => void;\n  /** Called when a mark is clicked, tapped or activated with Enter */\n  onClick?: (event: ShapeHoverEvent) => void;\n  /** React content of the tooltip (replaces the default content) */\n  renderTooltip?: (event: ShapeHoverEvent) => ReactNode;\n  /** Additional class name of the root element */\n  className?: string;\n  /** Inline styles of the root element */\n  style?: CSSProperties;\n  /** Imperative handle */\n  ref?: Ref<ShapeChartHandle>;\n}\n\n/** Props of PieChart */\nexport interface PieChartProps extends ShapeChartCommonProps {\n  /** Slices: a name, a value (negative values count as 0) and an optional color */\n  data: readonly ShapeDatum[];\n  /**\n   * Inner radius as a fraction of the outer radius: 0 = pie, 0.6 = donut\n   * @default 0\n   */\n  innerRadius?: number;\n  /**\n   * Angle of the first slice, degrees clockwise from 12 o'clock\n   * @default 0\n   */\n  startAngle?: number;\n  /**\n   * Gap between the slices, in pixels\n   * @default 1 (pie), 2 (donut)\n   */\n  padAngle?: number;\n  /**\n   * Corner radius of the slices, in pixels\n   * @default 0 (pie), 4 (donut)\n   */\n  cornerRadius?: number;\n  /**\n   * Nightingale rose: the radius (instead of the angle) shows the value\n   * @default false\n   */\n  rose?: boolean;\n  /**\n   * Slice labels: `outside` with leader lines, `inside` the slices, or none\n   * @default \"outside\" (up to 12 slices), \"none\" otherwise\n   */\n  labels?: \"outside\" | \"inside\" | \"none\";\n  /**\n   * What a label shows: name, value, percent (combinable)\n   * @default [\"name\", \"percent\"]\n   */\n  labelContent?: readonly (\"name\" | \"value\" | \"percent\")[];\n  /** Big text in the hole of a donut (e.g. the total) */\n  centerValue?: string;\n  /** Small text under `centerValue` */\n  centerLabel?: string;\n}\n\n/** Props of DonutChart: a PieChart with a hole */\nexport interface DonutChartProps extends PieChartProps {\n  /**\n   * Inner radius as a fraction of the outer radius\n   * @default 0.62\n   */\n  innerRadius?: number;\n}\n\n/** Props of RadarChart */\nexport interface RadarChartProps extends ShapeChartCommonProps {\n  /** Axes of the chart, clockwise from 12 o'clock */\n  indicators: readonly RadarIndicator[];\n  /** Polygons: one value per indicator */\n  series: readonly RadarSeries[];\n  /**\n   * Grid shape\n   * @default \"polygon\"\n   */\n  shape?: \"polygon\" | \"circle\";\n  /**\n   * Number of grid rings\n   * @default 4\n   */\n  levels?: number;\n  /**\n   * Dots on the vertices\n   * @default true\n   */\n  dots?: boolean;\n}\n\n/** Props of GaugeChart */\nexport interface GaugeChartProps extends ShapeChartCommonProps {\n  /** Value shown by the arc (clamped to `min` - `max` for the drawing) */\n  value: number;\n  /**\n   * Value at the start of the arc\n   * @default 0\n   */\n  min?: number;\n  /**\n   * Value at the end of the arc\n   * @default 100\n   */\n  max?: number;\n  /** Caption under the value */\n  label?: string;\n  /**\n   * Total angle of the arc, degrees\n   * @default 240\n   */\n  sweep?: number;\n  /**\n   * Thickness of the arc as a fraction of the radius\n   * @default 0.16\n   */\n  thickness?: number;\n  /** Colored ranges of the track; the value arc takes the color of its band */\n  bands?: readonly GaugeBand[];\n  /**\n   * Color of the value arc (when there are no bands)\n   * @default the first palette color\n   */\n  color?: string;\n  /**\n   * Draws a needle in addition to the value arc\n   * @default false\n   */\n  needle?: boolean;\n  /**\n   * Tick labels at the ends (and at the band bounds)\n   * @default true\n   */\n  ticks?: boolean;\n}\n\n/** Props of FunnelChart */\nexport interface FunnelChartProps extends ShapeChartCommonProps {\n  /** Stages: a name, a value and an optional color */\n  data: readonly ShapeDatum[];\n  /**\n   * Order of the stages\n   * @default \"none\" (data order)\n   */\n  sort?: \"descending\" | \"ascending\" | \"none\";\n  /**\n   * Vertical gap between the stages, in pixels\n   * @default 4\n   */\n  gap?: number;\n  /**\n   * Shows the conversion rate from the previous stage\n   * @default true\n   */\n  conversion?: boolean;\n  /**\n   * Shape of the stages: trapezoids that narrow to the next stage, or centered bars\n   * @default \"trapezoid\"\n   */\n  shape?: \"trapezoid\" | \"bar\";\n}\n\n/** Props of TreemapChart */\nexport interface TreemapChartProps extends ShapeChartCommonProps {\n  /** Nodes: leaves carry a value, parents sum their children */\n  data: readonly TreemapNode[];\n  /**\n   * Gap between the cells, in pixels\n   * @default 2\n   */\n  gap?: number;\n  /**\n   * Draws the names of the parents above their children\n   * @default true\n   */\n  headers?: boolean;\n}\n\n/** Props of SankeyChart */\nexport interface SankeyChartProps extends ShapeChartCommonProps {\n  /** Nodes, in their initial order; nodes only named by a link are appended */\n  nodes?: readonly SankeyNode[];\n  /** Flows between the nodes (by name or index); links closing a cycle are ignored */\n  links: readonly SankeyLink[];\n  /**\n   * Width of the node bars, in pixels\n   * @default 12\n   */\n  nodeWidth?: number;\n  /**\n   * Vertical gap between the nodes of a column, in pixels (reduced when space is short)\n   * @default 12\n   */\n  nodePadding?: number;\n  /**\n   * Column of the nodes without a `column`: `justify` puts the sinks in the\n   * last column, `left` / `right` align on the sources / sinks, `center`\n   * puts the sources next to their first target\n   * @default \"justify\"\n   */\n  align?: \"justify\" | \"left\" | \"right\" | \"center\";\n  /**\n   * Relaxation passes that straighten the flows and reduce crossings\n   * @default 32\n   */\n  iterations?: number;\n  /**\n   * Color of the links without `color`: a gradient from the source to the\n   * target color, one of the two, or a neutral gray\n   * @default \"gradient\"\n   */\n  linkColor?: \"gradient\" | \"source\" | \"target\" | \"neutral\";\n  /**\n   * Opacity of the links, 0-1 (hovered flows are more opaque)\n   * @default 0.4\n   */\n  linkOpacity?: number;\n  /**\n   * Node labels (name and value); overlapping labels are skipped\n   * @default true\n   */\n  labels?: boolean;\n  /**\n   * Shows the value after the name in the labels\n   * @default true\n   */\n  labelValues?: boolean;\n}\n\n/** Props of SunburstChart */\nexport interface SunburstChartProps extends ShapeChartCommonProps {\n  /** Nodes: leaves carry a value, parents sum their children */\n  data: readonly TreemapNode[];\n  /**\n   * Radius of the center circle as a fraction of the outer radius\n   * @default 0.26\n   */\n  innerRadius?: number;\n  /**\n   * Rings shown at once below the focused node (fewer when they would be thinner than 18 px)\n   * @default every level\n   */\n  levels?: number;\n  /**\n   * Angle of the first node, degrees clockwise from 12 o'clock\n   * @default 0\n   */\n  startAngle?: number;\n  /**\n   * Gap between the sectors, in pixels\n   * @default 1\n   */\n  padAngle?: number;\n  /**\n   * Corner radius of the sectors, in pixels\n   * @default 2\n   */\n  cornerRadius?: number;\n  /**\n   * Sector labels: `auto` writes each name along the arc or along the\n   * radius, whichever fits best; labels that do not fit are shortened or skipped\n   * @default \"auto\"\n   */\n  labels?: \"auto\" | \"tangential\" | \"radial\" | \"none\";\n  /**\n   * Clicking (or Enter on) a parent zooms into it; clicking the center (or Backspace) goes back up\n   * @default true\n   */\n  drill?: boolean;\n  /**\n   * Names from the root to the focused node (`[]` = the root). Makes the\n   * drill-down controlled: clicks then only call `onDrill`, whose `path`\n   * should be stored and passed back.\n   */\n  drillPath?: readonly string[];\n  /** Called when a parent or the center is clicked (or the instance's `drill()` is called) */\n  onDrill?: (event: ShapeDrillEvent) => void;\n}\n\n/** Props of RadialBarChart */\nexport interface RadialBarChartProps extends ShapeChartCommonProps {\n  /** Bars, from the outermost ring inward: a name, a value, an optional `max` and color */\n  data: readonly RadialBarDatum[];\n  /**\n   * Value of a full bar for the data without `max`\n   * @default the largest value\n   */\n  max?: number;\n  /**\n   * Radius of the innermost ring's inner edge, as a fraction of the outer radius\n   * @default 0.3\n   */\n  innerRadius?: number;\n  /**\n   * Angle where the bars start, degrees clockwise from 12 o'clock\n   * @default 0\n   */\n  startAngle?: number;\n  /**\n   * Angle of a full bar, degrees (360 = full rings)\n   * @default 270\n   */\n  sweep?: number;\n  /**\n   * Gap between the rings, as a fraction of a ring's slot (0-0.9)\n   * @default 0.28\n   */\n  gap?: number;\n  /**\n   * Background tracks behind the bars\n   * @default true\n   */\n  track?: boolean;\n  /**\n   * Rounded bar ends\n   * @default true\n   */\n  rounded?: boolean;\n  /**\n   * Labels before the start of the bars (in the empty part of the circle)\n   * @default true when `sweep` leaves room for them (up to 300°)\n   */\n  labels?: boolean;\n  /**\n   * What a label shows: name, value, percent of the bar's max (combinable)\n   * @default [\"name\", \"value\"]\n   */\n  labelContent?: readonly (\"name\" | \"value\" | \"percent\")[];\n  /** Big text in the center (e.g. the overall completion) */\n  centerValue?: string;\n  /** Small text under `centerValue` */\n  centerLabel?: string;\n}\n\n/** Props of CalendarHeatmap */\nexport interface CalendarHeatmapProps extends ShapeChartCommonProps {\n  /** Daily values (several entries of the same day add up) */\n  data: readonly CalendarDatum[];\n  /**\n   * Days shown: a year (`2026`) or an inclusive `[start, end]` range\n   * @default the 53 weeks ending on the last day of the data\n   */\n  range?: number | readonly [CalendarDate, CalendarDate];\n  /**\n   * `weeks`: a column per week and a row per weekday (one strip per year\n   * when the range spans several years); `months`: a small calendar per month\n   * @default \"weeks\"\n   */\n  layout?: \"weeks\" | \"months\";\n  /**\n   * First day of the week, 0 = Sunday … 6 = Saturday\n   * @default from `locale`\n   */\n  weekStart?: number;\n  /**\n   * BCP 47 locale of the month and weekday names, of the tooltip dates, of the default `weekStart` and of the built-in texts\n   * @default the page language (`<html lang>`), else the browser language\n   */\n  locale?: string;\n  /**\n   * Color of the highest level (lower levels are lighter)\n   * @default the first palette color\n   */\n  color?: string;\n  /** Colors of the levels, lowest first (replaces `color` and sets the number of levels) */\n  colors?: readonly string[];\n  /**\n   * Number of color levels above the empty days\n   * @default 4\n   */\n  levels?: number;\n  /**\n   * Upper bounds of the levels but the last, ascending (`[2, 5, 10]`: 1-2,\n   * 3-5, 6-10, more); an even split of the largest value by default\n   */\n  thresholds?: readonly number[];\n  /**\n   * Gap between the cells, in pixels\n   * @default 3\n   */\n  gap?: number;\n  /**\n   * Corner radius of the cells, in pixels\n   * @default 2\n   */\n  radius?: number;\n  /**\n   * Largest cell size, in pixels (cells shrink to fit the width)\n   * @default 16 (weeks), 28 (months)\n   */\n  maxCellSize?: number;\n  /**\n   * Month names (and years) around the cells\n   * @default true\n   */\n  monthLabels?: boolean;\n  /**\n   * Weekday names beside (weeks) or above (months) the cells\n   * @default true\n   */\n  weekdayLabels?: boolean;\n}\n\n/** Props of BulletChart */\nexport interface BulletChartProps extends ShapeChartCommonProps {\n  /** Rows (columns when vertical): name, value, target, ranges and scale */\n  data: readonly BulletDatum[];\n  /**\n   * Horizontal rows or vertical columns\n   * @default \"horizontal\"\n   */\n  orientation?: \"horizontal\" | \"vertical\";\n  /** Qualitative ranges of the rows without `ranges`: upper bounds, ascending */\n  ranges?: readonly number[];\n  /** Names of the qualitative ranges, lowest first (tooltip) */\n  rangeLabels?: readonly string[];\n  /** Colors of the qualitative ranges, lowest first; shades of gray by default */\n  rangeColors?: readonly string[];\n  /**\n   * Thickness of the value bar as a fraction of the ranges' thickness\n   * @default 0.4\n   */\n  barSize?: number;\n  /**\n   * Color of the target markers\n   * @default the text color\n   */\n  targetColor?: string;\n  /**\n   * Tick labels of the scales (when there is room)\n   * @default true\n   */\n  ticks?: boolean;\n}\n\ninterface Handlers {\n  onHover?: (event: ShapeHoverEvent | null) => void;\n  onClick?: (event: ShapeHoverEvent) => void;\n  onToggle?: (event: ShapeToggleEvent) => void;\n  onDrill?: (event: ShapeDrillEvent) => void;\n}\n\ninterface ShapeChartBaseProps extends Handlers {\n  options: ShapeChartOptions;\n  height: number | string;\n  width?: number | string;\n  className?: string;\n  style?: CSSProperties;\n  handleRef?: Ref<ShapeChartHandle>;\n  renderTooltip?: (event: ShapeHoverEvent) => ReactNode;\n}\n\nconst size = (value: number | string | undefined, fallback: string) =>\n  value === undefined\n    ? fallback\n    : typeof value === \"number\"\n      ? `${value}px`\n      : value;\n\nconst subscribePageLanguage = (onChange: () => void) => {\n  if (typeof document === \"undefined\" || typeof MutationObserver !== \"function\")\n    return () => {};\n  const observer = new MutationObserver(onChange);\n  observer.observe(document.documentElement, {\n    attributes: true,\n    attributeFilter: [\"lang\"],\n  });\n  return () => observer.disconnect();\n};\n\nconst pageLanguage = () =>\n  typeof document === \"undefined\" ? \"\" : document.documentElement.lang;\n\nconst noPageLanguage = () => \"\";\n\n/** Engine options shared by every type, stable while the props are equal */\nconst useCommonOptions = ({\n  palette,\n  legend,\n  tooltip,\n  format,\n  percentFormat,\n  locale,\n  texts,\n  hidden,\n  animation,\n  padding,\n  ariaLabel,\n}: ShapeChartCommonProps): ShapeChartCommonOptions => {\n  // without `locale`, follow the page language (`<html lang>`) as it changes\n  const language = useSyncExternalStore(\n    subscribePageLanguage,\n    pageLanguage,\n    noPageLanguage,\n  );\n  const resolvedLocale = locale ?? (language || undefined);\n  // a new array with the same indexes keeps the options (and the animation)\n  const hiddenKey = hidden ? hidden.join(\",\") : null;\n  const stableHidden = useMemo(\n    () =>\n      hiddenKey === null\n        ? undefined\n        : hiddenKey\n          ? hiddenKey.split(\",\").map(Number)\n          : [],\n    [hiddenKey],\n  );\n  return useMemo(\n    () => ({\n      palette,\n      legend,\n      tooltip,\n      format,\n      percentFormat,\n      locale: resolvedLocale,\n      texts,\n      hidden: stableHidden,\n      animation,\n      padding,\n      ariaLabel,\n    }),\n    [\n      palette,\n      legend,\n      tooltip,\n      format,\n      percentFormat,\n      resolvedLocale,\n      texts,\n      stableHidden,\n      animation,\n      padding,\n      ariaLabel,\n    ],\n  );\n};\n\n/** Mounts the engine in a sized <div> and forwards option / handler changes */\nfunction ShapeChartBase({\n  options,\n  height,\n  width,\n  className,\n  style,\n  handleRef,\n  renderTooltip,\n  ...handlers\n}: ShapeChartBaseProps) {\n  const containerRef = useRef<HTMLDivElement>(null);\n  const chartRef = useRef<ShapeChartInstance | null>(null);\n  const handlersRef = useRef<Handlers>(handlers);\n  const tooltipRef = useRef(renderTooltip);\n  const [tipEvent, setTipEvent] = useState<ShapeHoverEvent | null>(null);\n  const tipHost = useMemo(\n    () =>\n      typeof document === \"undefined\" ? null : document.createElement(\"div\"),\n    [],\n  );\n  const customTooltip = !!renderTooltip;\n\n  const resolved = useMemo((): ShapeChartOptions => {\n    if (!customTooltip || !tipHost || options.tooltip === false) return options;\n    const base = typeof options.tooltip === \"object\" ? options.tooltip : {};\n    return {\n      ...options,\n      tooltip: {\n        ...base,\n        render: (event) => {\n          if (!tooltipRef.current) return null;\n          // render synchronously so the engine measures the final size\n          flushSync(() => setTipEvent(event));\n          return tipHost;\n        },\n      },\n    };\n  }, [options, customTooltip, tipHost]);\n  const optionsRef = useRef(resolved);\n\n  useEffect(() => {\n    handlersRef.current = handlers;\n    tooltipRef.current = renderTooltip;\n  });\n\n  useEffect(() => {\n    const container = containerRef.current;\n    if (!container) return;\n    const chart = createShapeChart(container, optionsRef.current);\n    chartRef.current = chart;\n    const offs = [\n      chart.on(\"hover\", (e) => handlersRef.current.onHover?.(e)),\n      chart.on(\"click\", (e) => handlersRef.current.onClick?.(e)),\n      chart.on(\"toggle\", (e) => handlersRef.current.onToggle?.(e)),\n      chart.on(\"drill\", (e) => handlersRef.current.onDrill?.(e)),\n    ];\n    return () => {\n      offs.forEach((off) => off());\n      chart.destroy();\n      chartRef.current = null;\n    };\n  }, []);\n\n  useEffect(() => {\n    if (optionsRef.current === resolved) return;\n    optionsRef.current = resolved;\n    chartRef.current?.setOptions(resolved);\n  }, [resolved]);\n\n  useImperativeHandle(\n    handleRef,\n    () => ({ getInstance: () => chartRef.current }),\n    [],\n  );\n\n  return (\n    <div\n      className={className}\n      style={{\n        position: \"relative\",\n        width: size(width, \"100%\"),\n        height: size(height, \"320px\"),\n        ...style,\n      }}\n    >\n      <div ref={containerRef} style={{ position: \"absolute\", inset: 0 }} />\n      {tipHost &&\n        tipEvent &&\n        renderTooltip &&\n        createPortal(renderTooltip(tipEvent), tipHost)}\n    </div>\n  );\n}\n\n/**\n * Pie chart (or a donut with `innerRadius`, or a Nightingale rose with\n * `rose`): slices with gaps, outside labels with leader lines, legend toggles.\n */\nexport function PieChart(props: PieChartProps) {\n  return <PieBase {...props} defaultInner={0} />;\n}\n\n/** Donut chart: a PieChart with a hole and optional center texts */\nexport function DonutChart(props: DonutChartProps) {\n  return <PieBase {...props} defaultInner={0.62} />;\n}\n\nfunction PieBase(props: PieChartProps & { defaultInner: number }) {\n  const {\n    data,\n    innerRadius,\n    startAngle,\n    padAngle,\n    cornerRadius,\n    rose,\n    labels,\n    labelContent,\n    centerValue,\n    centerLabel,\n    defaultInner,\n  } = props;\n  const common = useCommonOptions(props);\n  const options = useMemo(\n    (): PieChartOptions => ({\n      ...common,\n      type: \"pie\",\n      data,\n      innerRadius: innerRadius ?? defaultInner,\n      startAngle,\n      padAngle,\n      cornerRadius,\n      rose,\n      labels,\n      labelContent,\n      centerValue,\n      centerLabel,\n    }),\n    [\n      common,\n      data,\n      innerRadius,\n      defaultInner,\n      startAngle,\n      padAngle,\n      cornerRadius,\n      rose,\n      labels,\n      labelContent,\n      centerValue,\n      centerLabel,\n    ],\n  );\n  return <ShapeHost props={props} options={options} defaultHeight={320} />;\n}\n\n/** Radar (spider) chart comparing series over several indicators */\nexport function RadarChart(props: RadarChartProps) {\n  const { indicators, series, shape, levels, dots } = props;\n  const common = useCommonOptions(props);\n  const options = useMemo(\n    (): RadarChartOptions => ({\n      ...common,\n      type: \"radar\",\n      indicators,\n      series,\n      shape,\n      levels,\n      dots,\n    }),\n    [common, indicators, series, shape, levels, dots],\n  );\n  return <ShapeHost props={props} options={options} defaultHeight={320} />;\n}\n\n/** Gauge (speedometer) showing one value on an arc, with colored bands */\nexport function GaugeChart(props: GaugeChartProps) {\n  const {\n    value,\n    min,\n    max,\n    label,\n    sweep,\n    thickness,\n    bands,\n    color,\n    needle,\n    ticks,\n  } = props;\n  const common = useCommonOptions(props);\n  const options = useMemo(\n    (): GaugeChartOptions => ({\n      ...common,\n      type: \"gauge\",\n      value,\n      min,\n      max,\n      label,\n      sweep,\n      thickness,\n      bands,\n      color,\n      needle,\n      ticks,\n    }),\n    [\n      common,\n      value,\n      min,\n      max,\n      label,\n      sweep,\n      thickness,\n      bands,\n      color,\n      needle,\n      ticks,\n    ],\n  );\n  return <ShapeHost props={props} options={options} defaultHeight={240} />;\n}\n\n/** Funnel chart of the stages of a process, with conversion rates */\nexport function FunnelChart(props: FunnelChartProps) {\n  const { data, sort, gap, conversion, shape } = props;\n  const common = useCommonOptions(props);\n  const options = useMemo(\n    (): FunnelChartOptions => ({\n      ...common,\n      type: \"funnel\",\n      data,\n      sort,\n      gap,\n      conversion,\n      shape,\n    }),\n    [common, data, sort, gap, conversion, shape],\n  );\n  return <ShapeHost props={props} options={options} defaultHeight={320} />;\n}\n\n/** Treemap: nested rectangles of areas proportional to the values */\nexport function TreemapChart(props: TreemapChartProps) {\n  const { data, gap, headers } = props;\n  const common = useCommonOptions(props);\n  const options = useMemo(\n    (): TreemapChartOptions => ({\n      ...common,\n      type: \"treemap\",\n      data,\n      gap,\n      headers,\n    }),\n    [common, data, gap, headers],\n  );\n  return <ShapeHost props={props} options={options} defaultHeight={320} />;\n}\n\n/**\n * Sankey diagram: flows between nodes in columns, link thickness\n * proportional to the flow; hovering a node or a link highlights its flows\n */\nexport function SankeyChart(props: SankeyChartProps) {\n  const {\n    nodes,\n    links,\n    nodeWidth,\n    nodePadding,\n    align,\n    iterations,\n    linkColor,\n    linkOpacity,\n    labels,\n    labelValues,\n  } = props;\n  const common = useCommonOptions(props);\n  const options = useMemo(\n    (): SankeyChartOptions => ({\n      ...common,\n      type: \"sankey\",\n      nodes,\n      links,\n      nodeWidth,\n      nodePadding,\n      align,\n      iterations,\n      linkColor,\n      linkOpacity,\n      labels,\n      labelValues,\n    }),\n    [\n      common,\n      nodes,\n      links,\n      nodeWidth,\n      nodePadding,\n      align,\n      iterations,\n      linkColor,\n      linkOpacity,\n      labels,\n      labelValues,\n    ],\n  );\n  return <ShapeHost props={props} options={options} defaultHeight={360} />;\n}\n\n/**\n * Sunburst chart: a hierarchy as concentric rings; clicking a parent zooms\n * into it, clicking the center goes back up\n */\nexport function SunburstChart(props: SunburstChartProps) {\n  const {\n    data,\n    innerRadius,\n    levels,\n    startAngle,\n    padAngle,\n    cornerRadius,\n    labels,\n    drill,\n    drillPath,\n    onDrill,\n  } = props;\n  const common = useCommonOptions(props);\n  // a new array with the same names keeps the options (and the animation)\n  const drillKey = drillPath ? JSON.stringify(drillPath) : null;\n  const stablePath = useMemo(\n    () => (drillKey === null ? undefined : (JSON.parse(drillKey) as string[])),\n    [drillKey],\n  );\n  const options = useMemo(\n    (): SunburstChartOptions => ({\n      ...common,\n      type: \"sunburst\",\n      data,\n      innerRadius,\n      levels,\n      startAngle,\n      padAngle,\n      cornerRadius,\n      labels,\n      drill,\n      drillPath: stablePath,\n    }),\n    [\n      common,\n      data,\n      innerRadius,\n      levels,\n      startAngle,\n      padAngle,\n      cornerRadius,\n      labels,\n      drill,\n      stablePath,\n    ],\n  );\n  return (\n    <ShapeHost\n      props={props}\n      options={options}\n      defaultHeight={360}\n      onDrill={onDrill}\n    />\n  );\n}\n\n/** Radial bar chart: concentric progress rings (activity rings, KPI completion) */\nexport function RadialBarChart(props: RadialBarChartProps) {\n  const {\n    data,\n    max,\n    innerRadius,\n    startAngle,\n    sweep,\n    gap,\n    track,\n    rounded,\n    labels,\n    labelContent,\n    centerValue,\n    centerLabel,\n  } = props;\n  const common = useCommonOptions(props);\n  const options = useMemo(\n    (): RadialBarChartOptions => ({\n      ...common,\n      type: \"radialBar\",\n      data,\n      max,\n      innerRadius,\n      startAngle,\n      sweep,\n      gap,\n      track,\n      rounded,\n      labels,\n      labelContent,\n      centerValue,\n      centerLabel,\n    }),\n    [\n      common,\n      data,\n      max,\n      innerRadius,\n      startAngle,\n      sweep,\n      gap,\n      track,\n      rounded,\n      labels,\n      labelContent,\n      centerValue,\n      centerLabel,\n    ],\n  );\n  return <ShapeHost props={props} options={options} defaultHeight={300} />;\n}\n\n/** Calendar heatmap: daily values on a calendar, contributions-style */\nexport function CalendarHeatmap(props: CalendarHeatmapProps) {\n  const {\n    data,\n    range,\n    layout,\n    weekStart,\n    color,\n    colors,\n    levels,\n    thresholds,\n    gap,\n    radius,\n    maxCellSize,\n    monthLabels,\n    weekdayLabels,\n  } = props;\n  const common = useCommonOptions(props);\n  const options = useMemo(\n    (): CalendarHeatmapOptions => ({\n      ...common,\n      type: \"calendarHeatmap\",\n      data,\n      range,\n      layout,\n      weekStart,\n      color,\n      colors,\n      levels,\n      thresholds,\n      gap,\n      radius,\n      maxCellSize,\n      monthLabels,\n      weekdayLabels,\n    }),\n    [\n      common,\n      data,\n      range,\n      layout,\n      weekStart,\n      color,\n      colors,\n      levels,\n      thresholds,\n      gap,\n      radius,\n      maxCellSize,\n      monthLabels,\n      weekdayLabels,\n    ],\n  );\n  const defaultHeight = useMemo(() => {\n    const legend = options.legend === false ? 0 : 34;\n    if (layout === \"months\") return 560;\n    return calendarStrips(options) * 120 + legend + 16;\n  }, [options, layout]);\n  return (\n    <ShapeHost props={props} options={options} defaultHeight={defaultHeight} />\n  );\n}\n\n/** Bullet chart: KPI bars against qualitative ranges and a target marker */\nexport function BulletChart(props: BulletChartProps) {\n  const {\n    data,\n    orientation,\n    ranges,\n    rangeLabels,\n    rangeColors,\n    barSize,\n    targetColor,\n    ticks,\n  } = props;\n  const common = useCommonOptions(props);\n  const options = useMemo(\n    (): BulletChartOptions => ({\n      ...common,\n      type: \"bullet\",\n      data,\n      orientation,\n      ranges,\n      rangeLabels,\n      rangeColors,\n      barSize,\n      targetColor,\n      ticks,\n    }),\n    [\n      common,\n      data,\n      orientation,\n      ranges,\n      rangeLabels,\n      rangeColors,\n      barSize,\n      targetColor,\n      ticks,\n    ],\n  );\n  const legend = options.legend ? 34 : 0;\n  const defaultHeight =\n    orientation === \"vertical\"\n      ? 320\n      : Math.max(96, data.length * 64 + 16) + legend;\n  return (\n    <ShapeHost props={props} options={options} defaultHeight={defaultHeight} />\n  );\n}\n\nfunction ShapeHost({\n  props,\n  options,\n  defaultHeight,\n  onDrill,\n}: {\n  props: ShapeChartCommonProps;\n  options: ShapeChartOptions;\n  defaultHeight: number;\n  onDrill?: (event: ShapeDrillEvent) => void;\n}) {\n  return (\n    <ShapeChartBase\n      options={options}\n      height={props.height ?? defaultHeight}\n      width={props.width}\n      className={props.className}\n      style={props.style}\n      handleRef={props.ref}\n      onHover={props.onHover}\n      onClick={props.onClick}\n      onToggle={props.onToggle}\n      onDrill={onDrill}\n      renderTooltip={props.renderTooltip}\n    />\n  );\n}\n"],"mappings":"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AAM,SACN,QACA,QACA,YACA,cACA,QACA,aACA,YACA,cACA,SACA,aACF,GACA,CACEA,EACAoC,EACAC,EACAC,EACAC,EACAC,EACAC,EACAC,EACAC,EACAnC,EACAoC,CACF,CACF,EACA,OAAO,EAAAjG,EAAA,IAAA,CAACiE,EAAD,CAAkB,QAAgB,UAAS,cAAe,GAAM,CAAA,CACzE,CAMA,SAAgBiC,EAAc,EAA2B,CACvD,GAAM,CACJ,OACA,cACA,SACA,aACA,WACA,eACA,SACA,QACA,YACA,WACE/C,EACEE,EAAS5C,EAAiB0C,CAAK,EAE/BgD,EAAWC,EAAY,KAAK,UAAUA,CAAS,EAAI,KACnDC,GAAA,EAAa/G,EAAAA,QAAAA,KACV6G,IAAa,KAAO,IAAA,GAAa,KAAK,MAAMA,CAAQ,EAC3D,CAACA,CAAQ,CACX,EACM9D,GAAA,EAAU/C,EAAAA,QAAAA,MACe,CAC3B,GAAG+D,EACH,KAAM,WACN,OACA,cACA,SACA,aACA,WACA,eACA,SACA,QACA,UAAWgD,CACb,GACA,CACEhD,EACAG,EACAF,EACAgB,EACAb,EACAC,EACAC,EACAE,EACAyC,EACAD,CACF,CACF,EACA,OACE,EAAArG,EAAA,IAAA,CAACiE,EAAD,CACS,QACE,UACT,cAAe,IACN,SACV,CAAA,CAEL,CAGA,SAAgBsC,EAAe,EAA4B,CACzD,GAAM,CACJ,OACA,MACA,cACA,aACA,QACA,MACA,QACA,UACA,SACA,eACA,cACA,eACEpD,EACEE,EAAS5C,EAAiB0C,CAAK,EAC/Bd,GAAA,EAAU/C,EAAAA,QAAAA,MACgB,CAC5B,GAAG+D,EACH,KAAM,YACN,OACA,MACA,cACA,aACA,QACA,MACA,QACA,UACA,SACA,eACA,cACA,aACF,GACA,CACEA,EACAG,EACAkB,EACApB,EACAG,EACAmB,EACAQ,EACAoB,EACAC,EACA5C,EACAC,EACAC,EACAC,CACF,CACF,EACA,OAAO,EAAAhE,EAAA,IAAA,CAACiE,EAAD,CAAkB,QAAgB,UAAS,cAAe,GAAM,CAAA,CACzE,CAGA,SAAgByC,EAAgB,EAA6B,CAC3D,GAAM,CACJ,OACA,QACA,SACA,YACA,QACA,SACA,SACA,aACA,MACA,SACA,cACA,cACA,iBACEvD,EACEE,EAAS5C,EAAiB0C,CAAK,EAC/Bd,GAAA,EAAU/C,EAAAA,QAAAA,MACiB,CAC7B,GAAG+D,EACH,KAAM,kBACN,OACA,QACA,SACA,YACA,QACA,SACA,SACA,aACA,MACA,SACA,cACA,cACA,eACF,GACA,CACEA,EACAG,EACAmD,EACAC,EACAC,EACA9B,EACA+B,EACAxC,EACAyC,EACA3B,EACA4B,EACAC,EACAC,EACAC,CACF,CACF,EACMC,GAAA,EAAgB9H,EAAAA,QAAAA,KAAc,CAClC,IAAM2B,EAASoB,EAAQ,SAAW,GAAQ,EAAI,GAE9C,OADIuE,IAAW,SAAiB,IACzBjH,EAAAA,eAAe0C,CAAO,EAAI,IAAMpB,EAAS,EAClD,EAAG,CAACoB,EAASuE,CAAM,CAAC,EACpB,OACE,EAAA5G,EAAA,IAAA,CAACiE,EAAD,CAAkB,QAAgB,UAAwB,eAAgB,CAAA,CAE9E,CAGA,SAAgBoD,EAAY,EAAyB,CACnD,GAAM,CACJ,OACA,cACA,SACA,cACA,cACA,UACA,cACA,SACElE,EACEE,EAAS5C,EAAiB0C,CAAK,EAC/Bd,GAAA,EAAU/C,EAAAA,QAAAA,MACa,CACzB,GAAG+D,EACH,KAAM,SACN,OACA,cACA,SACA,cACA,cACA,UACA,cACA,OACF,GACA,CACEA,EACAG,EACA8D,EACAC,EACAC,EACAC,EACAC,EACAC,EACA1C,CACF,CACF,EACMhE,EAASoB,EAAQ,OAAS,GAAK,EAC/B+E,EACJE,IAAgB,WACZ,IACA,KAAK,IAAI,GAAI9D,EAAK,OAAS,GAAK,EAAE,EAAIvC,EAC5C,OACE,EAAAjB,EAAA,IAAA,CAACiE,EAAD,CAAkB,QAAgB,UAAwB,eAAgB,CAAA,CAE9E,CAEA,SAASA,EAAU,CACjB,QACA,UACA,gBACA,WAMC,CACD,OACE,EAAAjE,EAAA,IAAA,CAACyB,EAAD,CACW,UACT,OAAQ0B,EAAM,QAAUiE,EACxB,MAAOjE,EAAM,MACb,UAAWA,EAAM,UACjB,MAAOA,EAAM,MACb,UAAWA,EAAM,IACjB,QAASA,EAAM,QACf,QAASA,EAAM,QACf,SAAUA,EAAM,SACP,UACT,cAAeA,EAAM,aACtB,CAAA,CAEL"}

package/dist/charts/react/shapes.d.cts

@@ -1,16 +1,20 @@
 import { CSSProperties, ReactNode, Ref } from 'react';
 import { ChartPadding } from '../engine/types.cjs';
-import { GaugeBand, RadarIndicator, RadarSeries, ShapeChartInstance, ShapeDatum, ShapeHoverEvent, ShapeLegendOptions, ShapeToggleEvent, ShapeTooltipOptions, TreemapNode } from '../engine/shapes/types.cjs';
+import { BulletDatum, CalendarDate, CalendarDatum, GaugeBand, RadarIndicator, RadarSeries, RadialBarDatum, SankeyLink, SankeyNode, ShapeChartInstance, ShapeChartLabels, ShapeDatum, ShapeDrillEvent, ShapeHoverEvent, ShapeLegendOptions, ShapeToggleEvent, ShapeTooltipOptions, TreemapNode } from '../engine/shapes/types.cjs';
 /** Imperative handle of the shape chart components (`ref`) */
 export interface ShapeChartHandle {
     /** The underlying engine instance (minerva-design/charts/core) */
     getInstance(): ShapeChartInstance | null;
 }
-/** Props shared by PieChart, DonutChart, RadarChart, GaugeChart, FunnelChart and TreemapChart */
+/**
+ * Props shared by PieChart, DonutChart, RadarChart, GaugeChart, FunnelChart,
+ * TreemapChart, SankeyChart, SunburstChart, RadialBarChart, CalendarHeatmap
+ * and BulletChart
+ */
 export interface ShapeChartCommonProps {
     /**
      * Height of the chart (the legend included); numbers are pixels
-     * @default 320 (GaugeChart: 240)
+     * @default 320 (GaugeChart: 240, RadialBarChart: 300, CalendarHeatmap and BulletChart: from the data)
      */
     height?: number | string;
     /**
@@ -21,8 +25,8 @@ export interface ShapeChartCommonProps {
     /** Colors of the marks without `color` (defaults to the `--chart-series-1..8` CSS variables, then the theme colors) */
     palette?: readonly string[];
     /**
-     * Legend; clicking an item hides / shows its slice, stage or series
-     * @default shown for pie, donut, funnel and multi-series radar charts
+     * Legend; clicking an item hides / shows its slice, stage, series, node, bar, row or level
+     * @default shown for pie, donut, funnel, multi-series radar charts, calendar heatmaps and radial bar charts without labels
      */
     legend?: boolean | ShapeLegendOptions;
     /**
@@ -32,16 +36,26 @@ export interface ShapeChartCommonProps {
     tooltip?: boolean | ShapeTooltipOptions;
     /**
      * Formats the values of the labels and the tooltip
-     * @default compact numbers (1.2k, 3.4M)
+     * @default compact numbers of the `locale` (1.2k, 3.4M; 1.2万 in Chinese and Japanese)
      */
     format?: (value: number) => string;
     /**
      * Formats the shares (labels, conversion rates, tooltip); `share` is 0-1
-     * @default one decimal, e.g. "40.0%"
+     * @default a percent of the `locale` with one decimal, e.g. "40.0%", "40,0 %"
      */
     percentFormat?: (share: number) => string;
     /**
-     * Hidden slices / stages / radar series / top-level treemap nodes, by
+     * BCP 47 locale of the texts and numbers the chart writes (tooltip rows,
+     * accessible names, number and percent formats, calendar dates); built-in
+     * texts in English, Chinese, Japanese and French (English otherwise)
+     * @default the page language (`<html lang>`, followed when it changes), else the browser language
+     */
+    locale?: string;
+    /** Replaces built-in texts of the `locale` (tooltip rows, accessible names, "No data") */
+    texts?: Partial<ShapeChartLabels>;
+    /**
+     * Hidden slices / stages / radar series / top-level treemap or sunburst
+     * nodes / sankey nodes / radial bars / bullet rows / calendar levels, by
      * index. Makes the visibility controlled: legend clicks then only call
      * `onToggle`, whose `hiddenIndexes` should be stored and passed back.
      * Leave undefined to let the legend hide / show entries by itself.
@@ -64,7 +78,7 @@ export interface ShapeChartCommonProps {
     padding?: ChartPadding;
     /**
      * Accessible name of the chart
-     * @default the chart type, e.g. "Donut chart"
+     * @default the chart type in the `locale`, e.g. "Donut chart"
      */
     ariaLabel?: string;
     /** Called when the hovered (or keyboard-focused) mark changes */
@@ -238,6 +252,258 @@ export interface TreemapChartProps extends ShapeChartCommonProps {
      */
     headers?: boolean;
 }
+/** Props of SankeyChart */
+export interface SankeyChartProps extends ShapeChartCommonProps {
+    /** Nodes, in their initial order; nodes only named by a link are appended */
+    nodes?: readonly SankeyNode[];
+    /** Flows between the nodes (by name or index); links closing a cycle are ignored */
+    links: readonly SankeyLink[];
+    /**
+     * Width of the node bars, in pixels
+     * @default 12
+     */
+    nodeWidth?: number;
+    /**
+     * Vertical gap between the nodes of a column, in pixels (reduced when space is short)
+     * @default 12
+     */
+    nodePadding?: number;
+    /**
+     * Column of the nodes without a `column`: `justify` puts the sinks in the
+     * last column, `left` / `right` align on the sources / sinks, `center`
+     * puts the sources next to their first target
+     * @default "justify"
+     */
+    align?: "justify" | "left" | "right" | "center";
+    /**
+     * Relaxation passes that straighten the flows and reduce crossings
+     * @default 32
+     */
+    iterations?: number;
+    /**
+     * Color of the links without `color`: a gradient from the source to the
+     * target color, one of the two, or a neutral gray
+     * @default "gradient"
+     */
+    linkColor?: "gradient" | "source" | "target" | "neutral";
+    /**
+     * Opacity of the links, 0-1 (hovered flows are more opaque)
+     * @default 0.4
+     */
+    linkOpacity?: number;
+    /**
+     * Node labels (name and value); overlapping labels are skipped
+     * @default true
+     */
+    labels?: boolean;
+    /**
+     * Shows the value after the name in the labels
+     * @default true
+     */
+    labelValues?: boolean;
+}
+/** Props of SunburstChart */
+export interface SunburstChartProps extends ShapeChartCommonProps {
+    /** Nodes: leaves carry a value, parents sum their children */
+    data: readonly TreemapNode[];
+    /**
+     * Radius of the center circle as a fraction of the outer radius
+     * @default 0.26
+     */
+    innerRadius?: number;
+    /**
+     * Rings shown at once below the focused node (fewer when they would be thinner than 18 px)
+     * @default every level
+     */
+    levels?: number;
+    /**
+     * Angle of the first node, degrees clockwise from 12 o'clock
+     * @default 0
+     */
+    startAngle?: number;
+    /**
+     * Gap between the sectors, in pixels
+     * @default 1
+     */
+    padAngle?: number;
+    /**
+     * Corner radius of the sectors, in pixels
+     * @default 2
+     */
+    cornerRadius?: number;
+    /**
+     * Sector labels: `auto` writes each name along the arc or along the
+     * radius, whichever fits best; labels that do not fit are shortened or skipped
+     * @default "auto"
+     */
+    labels?: "auto" | "tangential" | "radial" | "none";
+    /**
+     * Clicking (or Enter on) a parent zooms into it; clicking the center (or Backspace) goes back up
+     * @default true
+     */
+    drill?: boolean;
+    /**
+     * Names from the root to the focused node (`[]` = the root). Makes the
+     * drill-down controlled: clicks then only call `onDrill`, whose `path`
+     * should be stored and passed back.
+     */
+    drillPath?: readonly string[];
+    /** Called when a parent or the center is clicked (or the instance's `drill()` is called) */
+    onDrill?: (event: ShapeDrillEvent) => void;
+}
+/** Props of RadialBarChart */
+export interface RadialBarChartProps extends ShapeChartCommonProps {
+    /** Bars, from the outermost ring inward: a name, a value, an optional `max` and color */
+    data: readonly RadialBarDatum[];
+    /**
+     * Value of a full bar for the data without `max`
+     * @default the largest value
+     */
+    max?: number;
+    /**
+     * Radius of the innermost ring's inner edge, as a fraction of the outer radius
+     * @default 0.3
+     */
+    innerRadius?: number;
+    /**
+     * Angle where the bars start, degrees clockwise from 12 o'clock
+     * @default 0
+     */
+    startAngle?: number;
+    /**
+     * Angle of a full bar, degrees (360 = full rings)
+     * @default 270
+     */
+    sweep?: number;
+    /**
+     * Gap between the rings, as a fraction of a ring's slot (0-0.9)
+     * @default 0.28
+     */
+    gap?: number;
+    /**
+     * Background tracks behind the bars
+     * @default true
+     */
+    track?: boolean;
+    /**
+     * Rounded bar ends
+     * @default true
+     */
+    rounded?: boolean;
+    /**
+     * Labels before the start of the bars (in the empty part of the circle)
+     * @default true when `sweep` leaves room for them (up to 300°)
+     */
+    labels?: boolean;
+    /**
+     * What a label shows: name, value, percent of the bar's max (combinable)
+     * @default ["name", "value"]
+     */
+    labelContent?: readonly ("name" | "value" | "percent")[];
+    /** Big text in the center (e.g. the overall completion) */
+    centerValue?: string;
+    /** Small text under `centerValue` */
+    centerLabel?: string;
+}
+/** Props of CalendarHeatmap */
+export interface CalendarHeatmapProps extends ShapeChartCommonProps {
+    /** Daily values (several entries of the same day add up) */
+    data: readonly CalendarDatum[];
+    /**
+     * Days shown: a year (`2026`) or an inclusive `[start, end]` range
+     * @default the 53 weeks ending on the last day of the data
+     */
+    range?: number | readonly [CalendarDate, CalendarDate];
+    /**
+     * `weeks`: a column per week and a row per weekday (one strip per year
+     * when the range spans several years); `months`: a small calendar per month
+     * @default "weeks"
+     */
+    layout?: "weeks" | "months";
+    /**
+     * First day of the week, 0 = Sunday … 6 = Saturday
+     * @default from `locale`
+     */
+    weekStart?: number;
+    /**
+     * BCP 47 locale of the month and weekday names, of the tooltip dates, of the default `weekStart` and of the built-in texts
+     * @default the page language (`<html lang>`), else the browser language
+     */
+    locale?: string;
+    /**
+     * Color of the highest level (lower levels are lighter)
+     * @default the first palette color
+     */
+    color?: string;
+    /** Colors of the levels, lowest first (replaces `color` and sets the number of levels) */
+    colors?: readonly string[];
+    /**
+     * Number of color levels above the empty days
+     * @default 4
+     */
+    levels?: number;
+    /**
+     * Upper bounds of the levels but the last, ascending (`[2, 5, 10]`: 1-2,
+     * 3-5, 6-10, more); an even split of the largest value by default
+     */
+    thresholds?: readonly number[];
+    /**
+     * Gap between the cells, in pixels
+     * @default 3
+     */
+    gap?: number;
+    /**
+     * Corner radius of the cells, in pixels
+     * @default 2
+     */
+    radius?: number;
+    /**
+     * Largest cell size, in pixels (cells shrink to fit the width)
+     * @default 16 (weeks), 28 (months)
+     */
+    maxCellSize?: number;
+    /**
+     * Month names (and years) around the cells
+     * @default true
+     */
+    monthLabels?: boolean;
+    /**
+     * Weekday names beside (weeks) or above (months) the cells
+     * @default true
+     */
+    weekdayLabels?: boolean;
+}
+/** Props of BulletChart */
+export interface BulletChartProps extends ShapeChartCommonProps {
+    /** Rows (columns when vertical): name, value, target, ranges and scale */
+    data: readonly BulletDatum[];
+    /**
+     * Horizontal rows or vertical columns
+     * @default "horizontal"
+     */
+    orientation?: "horizontal" | "vertical";
+    /** Qualitative ranges of the rows without `ranges`: upper bounds, ascending */
+    ranges?: readonly number[];
+    /** Names of the qualitative ranges, lowest first (tooltip) */
+    rangeLabels?: readonly string[];
+    /** Colors of the qualitative ranges, lowest first; shades of gray by default */
+    rangeColors?: readonly string[];
+    /**
+     * Thickness of the value bar as a fraction of the ranges' thickness
+     * @default 0.4
+     */
+    barSize?: number;
+    /**
+     * Color of the target markers
+     * @default the text color
+     */
+    targetColor?: string;
+    /**
+     * Tick labels of the scales (when there is room)
+     * @default true
+     */
+    ticks?: boolean;
+}
 /**
  * Pie chart (or a donut with `innerRadius`, or a Nightingale rose with
  * `rose`): slices with gaps, outside labels with leader lines, legend toggles.
@@ -253,3 +519,19 @@ export declare function GaugeChart(props: GaugeChartProps): import('react').JSX.
 export declare function FunnelChart(props: FunnelChartProps): import('react').JSX.Element;
 /** Treemap: nested rectangles of areas proportional to the values */
 export declare function TreemapChart(props: TreemapChartProps): import('react').JSX.Element;
+/**
+ * Sankey diagram: flows between nodes in columns, link thickness
+ * proportional to the flow; hovering a node or a link highlights its flows
+ */
+export declare function SankeyChart(props: SankeyChartProps): import('react').JSX.Element;
+/**
+ * Sunburst chart: a hierarchy as concentric rings; clicking a parent zooms
+ * into it, clicking the center goes back up
+ */
+export declare function SunburstChart(props: SunburstChartProps): import('react').JSX.Element;
+/** Radial bar chart: concentric progress rings (activity rings, KPI completion) */
+export declare function RadialBarChart(props: RadialBarChartProps): import('react').JSX.Element;
+/** Calendar heatmap: daily values on a calendar, contributions-style */
+export declare function CalendarHeatmap(props: CalendarHeatmapProps): import('react').JSX.Element;
+/** Bullet chart: KPI bars against qualitative ranges and a target marker */
+export declare function BulletChart(props: BulletChartProps): import('react').JSX.Element;