minerva-design 1.3.0 → 1.4.0

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

@@ -1 +1 @@
-{"version":3,"file":"shapes.js","names":["size","value","fallback","useCommonOptions","hiddenKey","hidden","stableHidden","useMemo","palette","legend","tooltip","format","percentFormat","animation","padding","ariaLabel","ShapeChartBase","handlers","containerRef","useRef","chartRef","handlersRef","tooltipRef","renderTooltip","tipEvent","setTipEvent","useState","tipHost","customTooltip","resolved","options","base","flushSync","event","optionsRef","useEffect","container","chart","createShapeChart","offs","off","useImperativeHandle","handleRef","width","height","style","createPortal","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.js","names":["size","value","fallback","subscribePageLanguage","observer","onChange","pageLanguage","noPageLanguage","useCommonOptions","language","useSyncExternalStore","resolvedLocale","locale","hiddenKey","hidden","stableHidden","useMemo","palette","legend","tooltip","format","percentFormat","texts","animation","padding","ariaLabel","ShapeChartBase","handlers","containerRef","useRef","chartRef","handlersRef","tooltipRef","renderTooltip","tipEvent","setTipEvent","useState","tipHost","customTooltip","resolved","options","base","flushSync","event","optionsRef","useEffect","container","chart","createShapeChart","offs","off","useImperativeHandle","handleRef","width","height","style","createPortal","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","calendarStrips","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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AET;AAMA,SAAgBoB,EAAS,GAAsB;CAC7C,OAAO,kBAACC,GAAD;EAAS,GAAIC;EAAO,cAAc;CAAI,CAAA;AAC/C;AAGA,SAAgBC,EAAW,GAAwB;CACjD,OAAO,kBAACF,GAAD;EAAS,GAAIC;EAAO,cAAc;CAAO,CAAA;AAClD;AAEA,SAASD,EAAQ,GAAiD;CAChE,IAAM,EACJ,SACA,gBACA,eACA,aACA,iBACA,SACA,WACA,iBACA,gBACA,gBACA,oBACEC,GACEE,IAASrD,EAAiBmD,CAAK,GAC/BnB,IAAUxB,SACU;EACtB,GAAG6C;EACH,MAAM;EACN;EACA,aAAaC,KAAeC;EAC5B;EACA;EACA;EACA;EACA;EACA;EACA;EACA;CACF,IACA;EACEF;EACAG;EACAF;EACAC;EACAE;EACAC;EACAC;EACAC;EACAC;EACAC;EACAC;EACAC;CACF,CACF;CACA,OAAO,kBAACC,GAAD;EAAkB;EAAgB;EAAS,eAAe;CAAM,CAAA;AACzE;AAGA,SAAgBC,EAAW,GAAwB;CACjD,IAAM,EAAE,eAAY,WAAQ,UAAO,WAAQ,YAASf,GAC9CE,IAASrD,EAAiBmD,CAAK,GAC/BnB,IAAUxB,SACY;EACxB,GAAG6C;EACH,MAAM;EACN;EACA;EACA;EACA;EACA;CACF,IACA;EAACA;EAAQc;EAAYC;EAAQC;EAAOC;EAAQC;CAAI,CAClD;CACA,OAAO,kBAACN,GAAD;EAAkB;EAAgB;EAAS,eAAe;CAAM,CAAA;AACzE;AAGA,SAAgBO,EAAW,GAAwB;CACjD,IAAM,EACJ,UACA,QACA,QACA,UACA,UACA,cACA,UACA,UACA,WACA,aACErB,GACEE,IAASrD,EAAiBmD,CAAK,GAC/BnB,IAAUxB,SACY;EACxB,GAAG6C;EACH,MAAM;EACN;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;CACF,IACA;EACEA;EACA5D;EACAgF;EACAC;EACAC;EACAC;EACAC;EACAC;EACAC;EACAC;EACAC;CACF,CACF;CACA,OAAO,kBAAChB,GAAD;EAAkB;EAAgB;EAAS,eAAe;CAAM,CAAA;AACzE;AAGA,SAAgBiB,EAAY,GAAyB;CACnD,IAAM,EAAE,SAAM,SAAM,QAAK,eAAY,aAAU/B,GACzCE,IAASrD,EAAiBmD,CAAK,GAC/BnB,IAAUxB,SACa;EACzB,GAAG6C;EACH,MAAM;EACN;EACA;EACA;EACA;EACA;CACF,IACA;EAACA;EAAQG;EAAM2B;EAAMC;EAAKC;EAAYhB;CAAK,CAC7C;CACA,OAAO,kBAACJ,GAAD;EAAkB;EAAgB;EAAS,eAAe;CAAM,CAAA;AACzE;AAGA,SAAgBqB,EAAa,GAA0B;CACrD,IAAM,EAAE,SAAM,QAAK,eAAYnC,GACzBE,IAASrD,EAAiBmD,CAAK,GAC/BnB,IAAUxB,SACc;EAC1B,GAAG6C;EACH,MAAM;EACN;EACA;EACA;CACF,IACA;EAACA;EAAQG;EAAM4B;EAAKG;CAAO,CAC7B;CACA,OAAO,kBAACtB,GAAD;EAAkB;EAAgB;EAAS,eAAe;CAAM,CAAA;AACzE;AAMA,SAAgBuB,EAAY,GAAyB;CACnD,IAAM,EACJ,UACA,UACA,cACA,gBACA,UACA,eACA,cACA,gBACA,WACA,mBACErC,GACEE,IAASrD,EAAiBmD,CAAK,GAC/BnB,IAAUxB,SACa;EACzB,GAAG6C;EACH,MAAM;EACN;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;CACF,IACA;EACEA;EACAoC;EACAC;EACAC;EACAC;EACAC;EACAC;EACAC;EACAC;EACAnC;EACAoC;CACF,CACF;CACA,OAAO,kBAAChC,GAAD;EAAkB;EAAgB;EAAS,eAAe;CAAM,CAAA;AACzE;AAMA,SAAgBiC,EAAc,GAA2B;CACvD,IAAM,EACJ,SACA,gBACA,WACA,eACA,aACA,iBACA,WACA,UACA,cACA,eACE/C,GACEE,IAASrD,EAAiBmD,CAAK,GAE/BgD,IAAWC,IAAY,KAAK,UAAUA,CAAS,IAAI,MACnDC,IAAa7F,QACV2F,MAAa,OAAO,KAAA,IAAa,KAAK,MAAMA,CAAQ,GAC3D,CAACA,CAAQ,CACX,GACMnE,IAAUxB,SACe;EAC3B,GAAG6C;EACH,MAAM;EACN;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA,WAAWgD;CACb,IACA;EACEhD;EACAG;EACAF;EACAgB;EACAb;EACAC;EACAC;EACAE;EACAyC;EACAD;CACF,CACF;CACA,OACE,kBAACpC,GAAD;EACS;EACE;EACT,eAAe;EACN;CACV,CAAA;AAEL;AAGA,SAAgBsC,EAAe,GAA4B;CACzD,IAAM,EACJ,SACA,QACA,gBACA,eACA,UACA,QACA,UACA,YACA,WACA,iBACA,gBACA,mBACEpD,GACEE,IAASrD,EAAiBmD,CAAK,GAC/BnB,IAAUxB,SACgB;EAC5B,GAAG6C;EACH,MAAM;EACN;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;CACF,IACA;EACEA;EACAG;EACAkB;EACApB;EACAG;EACAmB;EACAQ;EACAoB;EACAC;EACA5C;EACAC;EACAC;EACAC;CACF,CACF;CACA,OAAO,kBAACC,GAAD;EAAkB;EAAgB;EAAS,eAAe;CAAM,CAAA;AACzE;AAGA,SAAgByC,EAAgB,GAA6B;CAC3D,IAAM,EACJ,SACA,UACA,WACA,cACA,UACA,WACA,WACA,eACA,QACA,WACA,gBACA,gBACA,qBACEvD,GACEE,IAASrD,EAAiBmD,CAAK,GAC/BnB,IAAUxB,SACiB;EAC7B,GAAG6C;EACH,MAAM;EACN;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;CACF,IACA;EACEA;EACAG;EACAmD;EACAC;EACAC;EACA9B;EACA+B;EACAxC;EACAyC;EACA3B;EACA4B;EACAC;EACAC;EACAC;CACF,CACF,GACMC,IAAgB5G,QAAc;EAClC,IAAME,IAASsB,EAAQ,WAAW,KAAQ,IAAI;EAE9C,OADI4E,MAAW,WAAiB,MACzBS,EAAerF,CAAO,IAAI,MAAMtB,IAAS;CAClD,GAAG,CAACsB,GAAS4E,CAAM,CAAC;CACpB,OACE,kBAAC3C,GAAD;EAAkB;EAAgB;EAAwB;CAAgB,CAAA;AAE9E;AAGA,SAAgBqD,EAAY,GAAyB;CACnD,IAAM,EACJ,SACA,gBACA,WACA,gBACA,gBACA,YACA,gBACA,aACEnE,GACEE,IAASrD,EAAiBmD,CAAK,GAC/BnB,IAAUxB,SACa;EACzB,GAAG6C;EACH,MAAM;EACN;EACA;EACA;EACA;EACA;EACA;EACA;EACA;CACF,IACA;EACEA;EACAG;EACA+D;EACAC;EACAC;EACAC;EACAC;EACAC;EACA3C;CACF,CACF,GACMvE,IAASsB,EAAQ,SAAS,KAAK,GAC/BoF,IACJG,MAAgB,aACZ,MACA,KAAK,IAAI,IAAI/D,EAAK,SAAS,KAAK,EAAE,IAAI9C;CAC5C,OACE,kBAACuD,GAAD;EAAkB;EAAgB;EAAwB;CAAgB,CAAA;AAE9E;AAEA,SAASA,EAAU,EACjB,UACA,YACA,kBACA,cAMC;CACD,OACE,kBAAC/C,GAAD;EACW;EACT,QAAQiC,EAAM,UAAUiE;EACxB,OAAOjE,EAAM;EACb,WAAWA,EAAM;EACjB,OAAOA,EAAM;EACb,WAAWA,EAAM;EACjB,SAASA,EAAM;EACf,SAASA,EAAM;EACf,UAAUA,EAAM;EACP;EACT,eAAeA,EAAM;CACtB,CAAA;AAEL"}

package/dist/charts/react/three-d.cjs

@@ -0,0 +1,2 @@
+"use client";const e=require("../engine/three-d/chart.cjs");let t=require("react"),n=require("react/jsx-runtime");var r=e=>{if(typeof e!=`object`||!e)return!1;let t=Object.getPrototypeOf(e);return t===Object.prototype||t===null},i=(e,t)=>{let n=Object.keys(e);return n.length===Object.keys(t).length&&n.every(n=>e[n]===t[n]&&Object.prototype.hasOwnProperty.call(t,n))},a=(e,t)=>e===t?!0:Array.isArray(e)&&Array.isArray(t)?e.length===t.length&&e.every((e,n)=>e===t[n]):r(e)&&r(t)&&i(e,t),o=(e,t)=>{if(e===t)return!0;let n=Object.keys(e);return n.length===Object.keys(t).length&&n.every(n=>{if(!Object.prototype.hasOwnProperty.call(t,n))return!1;if(n!==`series`)return a(e[n],t[n]);let r=e.series,o=t.series;return r===o||r.length===o.length&&r.every((e,t)=>e===o[t]||i(e,o[t]))})},s=(e,t)=>e===void 0?t:typeof e==`number`?`${e}px`:e;function c({options:r,height:i,width:a,className:c,style:l,handleRef:u,...d}){let f=(0,t.useRef)(null),p=(0,t.useRef)(null),m=(0,t.useRef)(d),[h,g]=(0,t.useState)(r);h!==r&&!o(h,r)&&g(r);let _=(0,t.useRef)(h);return(0,t.useEffect)(()=>{m.current=d}),(0,t.useEffect)(()=>{let t=f.current;if(!t)return;let n=e.createChart3D(t,_.current);p.current=n;let r=[n.on(`hover`,e=>m.current.onHover?.(e)),n.on(`click`,e=>m.current.onPointClick?.(e)),n.on(`camera`,e=>m.current.onCameraChange?.(e)),n.on(`renderer`,e=>m.current.onRendererChange?.(e))];return()=>{r.forEach(e=>e()),n.destroy(),p.current=null}},[]),(0,t.useEffect)(()=>{_.current!==h&&(_.current=h,p.current?.setOptions(h))},[h]),(0,t.useImperativeHandle)(u,()=>({resetCamera:()=>p.current?.resetCamera(),getCamera:()=>p.current?.getCamera()??null,setCamera:e=>p.current?.setCamera(e),getRenderer:()=>p.current?.getRenderer()??null,getInstance:()=>p.current}),[]),(0,n.jsx)(`div`,{className:c,style:{position:`relative`,width:s(a,`100%`),height:s(i,`400px`),...l},children:(0,n.jsx)(`div`,{ref:f,style:{position:`absolute`,inset:0}})})}function l({props:e,series:t}){let{height:r,width:i,xAxis:a,yAxis:o,zAxis:s,camera:l,autoRotate:u,aspect:d,box:f,colorScale:p,valueRange:m,colorBar:h,legend:g,tooltip:_,interaction:v,lighting:y,renderer:b,palette:x,ariaLabel:S,locale:C,labels:w,onHover:T,onPointClick:E,onCameraChange:D,onRendererChange:O,className:k,style:A,ref:j}=e;return(0,n.jsx)(c,{options:{series:t,xAxis:a,yAxis:o,zAxis:s,camera:l,autoRotate:u,aspect:d,box:f,colorScale:p,valueRange:m,colorBar:h,legend:g,tooltip:_,interaction:v,lighting:y,renderer:b,palette:x,ariaLabel:S,locale:C,labels:w},height:r,width:i,className:k,style:A,handleRef:j,onHover:T,onPointClick:E,onCameraChange:D,onRendererChange:O})}function u(e){let{series:r}=e,i=(0,t.useMemo)(()=>r.map(e=>({...e,type:`scatter`})),[r]);return(0,n.jsx)(l,{props:e,series:i})}function d(e){let{series:r}=e,i=(0,t.useMemo)(()=>r.map(e=>({...e,type:`line`})),[r]);return(0,n.jsx)(l,{props:e,series:i})}function f(e){let{series:r,wireframe:i,contours:a}=e,o=(0,t.useMemo)(()=>r.map(e=>({...e,type:`surface`,wireframe:e.wireframe??i,contours:e.contours??a})),[r,i,a]);return(0,n.jsx)(l,{props:e,series:o})}function p(e){let{series:r,barWidth:i}=e,a=(0,t.useMemo)(()=>r.map(e=>({...e,type:`bar`,barWidth:e.barWidth??i})),[r,i]);return(0,n.jsx)(l,{props:e,series:a})}exports.Bar3DChart=p,exports.Line3DChart=d,exports.Scatter3DChart=u,exports.Surface3DChart=f;
+//# sourceMappingURL=three-d.cjs.map

package/dist/charts/react/three-d.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"three-d.cjs","names":["useRef","useState","createChart3D","useMemo","require_chart","react","react_jsx_runtime","isPlainObject","value","proto","shallowEqual","keys","a","b","key","sameValue","v","i","sameOptions3D","sa","sb","s","cssSize","fallback","Chart3DBase","handlers","containerRef","chartRef","handlersRef","stable","setStable","options","optionsRef","container","chart","offs","c","r","off","handleRef","camera","width","height","style","Chart3DFrame","props","ref","Scatter3DChart","input","series","Line3DChart","Surface3DChart","wireframe","contours","Bar3DChart","barWidth"],"sources":["../../../../charts/src/react/three-d.tsx"],"sourcesContent":["import {\n  useEffect,\n  useImperativeHandle,\n  useMemo,\n  useRef,\n  useState,\n  type CSSProperties,\n  type Ref,\n} from \"react\";\nimport { createChart3D } from \"../engine/three-d/chart\";\nimport type {\n  Bar3DSeries,\n  Chart3DAxisOptions,\n  Chart3DCameraOptions,\n  Chart3DCameraState,\n  Chart3DColorBarOptions,\n  Chart3DColorScale,\n  Chart3DHoverEvent,\n  Chart3DInstance,\n  Chart3DInteractionOptions,\n  Chart3DLabels,\n  Chart3DLegendOptions,\n  Chart3DLightingOptions,\n  Chart3DOptions,\n  Chart3DSeries,\n  Chart3DTooltipOptions,\n  Line3DSeries,\n  Scatter3DSeries,\n  Surface3DContourOptions,\n  Surface3DSeries,\n  Surface3DWireframeOptions,\n} from \"../engine/three-d/types\";\nimport type {\n  ChartRendererKind,\n  ChartRendererPreference,\n} from \"../engine/types\";\n\n/** Imperative handle of the 3D chart components (`ref`) */\nexport interface Chart3DHandle {\n  /** Restores the camera of the `camera` prop */\n  resetCamera(): void;\n  /** Current camera, `null` before mount */\n  getCamera(): Chart3DCameraState | null;\n  /** Moves the camera */\n  setCamera(camera: Partial<Chart3DCameraState>): void;\n  /** Backend in use, `null` until ready */\n  getRenderer(): ChartRendererKind | null;\n  /** The underlying engine instance (minerva-design/charts/core) */\n  getInstance(): Chart3DInstance | null;\n}\n\n/** Props shared by every 3D chart component */\nexport interface Chart3DCommonProps {\n  /**\n   * Height of the chart (the legend included); numbers are pixels\n   * @default 400\n   */\n  height?: number | string;\n  /**\n   * Width of the chart; numbers are pixels\n   * @default \"100%\"\n   */\n  width?: number | string;\n  /** X axis (width of the box) */\n  xAxis?: Chart3DAxisOptions;\n  /** Y axis (depth of the box) */\n  yAxis?: Chart3DAxisOptions;\n  /** Z axis (height of the box) */\n  zAxis?: Chart3DAxisOptions;\n  /** Initial camera, also restored by a double click (changing it moves the camera) */\n  camera?: Chart3DCameraOptions;\n  /**\n   * Turns the camera around the box: `true` at 12°/s or a speed in degrees\n   * per second; pauses while hovered, off-screen and with reduced motion\n   * @default false\n   */\n  autoRotate?: boolean | number;\n  /**\n   * Proportions of the box (x, y, z)\n   * @default [1, 1, 0.7]\n   */\n  aspect?: readonly [number, number, number];\n  /**\n   * Draws the axis box: back walls, grid lines, tick labels and axis titles\n   * @default true\n   */\n  box?: boolean;\n  /**\n   * Colors of `colorBy: \"z\"` / `\"value\"`: a built-in ramp or CSS colors\n   * @default \"viridis\"\n   */\n  colorScale?: Chart3DColorScale;\n  /** Values mapped to the ends of the color scale; the data range by default */\n  valueRange?: readonly [number, number];\n  /** Color bar; shown by default when a visible series uses the color scale */\n  colorBar?: boolean | Chart3DColorBarOptions;\n  /** Legend; shown by default when several series have a name */\n  legend?: boolean | Chart3DLegendOptions;\n  /** Tooltip; `false` disables it */\n  tooltip?: boolean | Chart3DTooltipOptions;\n  /**\n   * Drag rotates, right / Shift + drag pans, Ctrl / ⌘ + wheel and pinch zoom,\n   * double click resets, arrow keys rotate; `false` makes the chart static\n   * @default true\n   */\n  interaction?: boolean | Chart3DInteractionOptions;\n  /** Lighting of the surfaces and bars */\n  lighting?: Chart3DLightingOptions;\n  /**\n   * Backend of the data layer: `auto` tries WebGPU, then WebGL2, then WebGL,\n   * then Canvas2D, skipping GPUs running in software\n   * @default \"auto\"\n   */\n  renderer?: ChartRendererPreference;\n  /** Series colors (defaults to the `--chart-series-1..8` CSS variables, then the theme colors) */\n  palette?: readonly string[];\n  /** Accessible name of the chart */\n  ariaLabel?: string;\n  /**\n   * Language of the built-in texts (accessible summary, legend announcements,\n   * tooltip row names) and of the number formatting; built-in texts in\n   * English, Chinese, Japanese and French\n   * @default the page language (`<html lang>`), then the browser language\n   */\n  locale?: string;\n  /** Overrides of the built-in texts of the `locale` */\n  labels?: Partial<Chart3DLabels>;\n  /** Called when the hovered point, cell or bar changes */\n  onHover?: (event: Chart3DHoverEvent | null) => void;\n  /** Called when a point, cell or bar is clicked */\n  onPointClick?: (event: Chart3DHoverEvent) => void;\n  /** Called after the user rotated, zoomed, panned or reset the camera */\n  onCameraChange?: (camera: Chart3DCameraState) => void;\n  /** Called with the backend once it is ready (and after a fallback) */\n  onRendererChange?: (renderer: ChartRendererKind) => void;\n  /** Class of the outer element */\n  className?: string;\n  /** Style of the outer element */\n  style?: CSSProperties;\n  /** Imperative handle */\n  ref?: Ref<Chart3DHandle>;\n}\n\n/** Props of `Scatter3DChart` */\nexport interface Scatter3DChartProps extends Chart3DCommonProps {\n  /** Point clouds (objects, `[x, y, z]` tuples or typed-array columns) */\n  series: readonly Scatter3DSeries[];\n}\n\n/** Props of `Line3DChart` */\nexport interface Line3DChartProps extends Chart3DCommonProps {\n  /** 3D polylines (trajectories) */\n  series: readonly Line3DSeries[];\n}\n\n/** Props of `Surface3DChart` */\nexport interface Surface3DChartProps extends Chart3DCommonProps {\n  /** Surfaces over regular grids */\n  series: readonly Surface3DSeries[];\n  /** Wireframe of the series that do not set one */\n  wireframe?: boolean | Surface3DWireframeOptions;\n  /** Contour lines of the series that do not set them */\n  contours?: boolean | Surface3DContourOptions;\n}\n\n/** Props of `Bar3DChart` */\nexport interface Bar3DChartProps extends Chart3DCommonProps {\n  /** Bars over the x × y category grid (bars of the same cell are stacked) */\n  series: readonly Bar3DSeries[];\n  /**\n   * Width of the bars of the series that do not set one, as a fraction of a cell\n   * @default 0.7\n   */\n  barWidth?: number;\n}\n\n// ----------------------------------------------------------------- base\n\ninterface Handlers {\n  onHover?: (event: Chart3DHoverEvent | null) => void;\n  onPointClick?: (event: Chart3DHoverEvent) => void;\n  onCameraChange?: (camera: Chart3DCameraState) => void;\n  onRendererChange?: (renderer: ChartRendererKind) => void;\n}\n\nconst isPlainObject = (value: unknown): value is Record<string, unknown> => {\n  if (typeof value !== \"object\" || value === null) return false;\n  const proto = Object.getPrototypeOf(value);\n  return proto === Object.prototype || proto === null;\n};\n\nconst shallowEqual = (\n  a: Record<string, unknown>,\n  b: Record<string, unknown>,\n): boolean => {\n  const keys = Object.keys(a);\n  if (keys.length !== Object.keys(b).length) return false;\n  return keys.every(\n    (key) => a[key] === b[key] && Object.prototype.hasOwnProperty.call(b, key),\n  );\n};\n\nconst sameValue = (a: unknown, b: unknown): boolean => {\n  if (a === b) return true;\n  if (Array.isArray(a) && Array.isArray(b))\n    return a.length === b.length && a.every((v, i) => v === b[i]);\n  return isPlainObject(a) && isPlainObject(b) && shallowEqual(a, b);\n};\n\n/**\n * Whether two option objects describe the same chart: top-level values by\n * identity (one level deep for inline arrays / objects), series one by one\n * and shallowly. Data is never compared by content.\n */\nconst sameOptions3D = (a: Chart3DOptions, b: Chart3DOptions): boolean => {\n  if (a === b) return true;\n  const keys = Object.keys(a) as (keyof Chart3DOptions)[];\n  if (keys.length !== Object.keys(b).length) return false;\n  return keys.every((key) => {\n    if (!Object.prototype.hasOwnProperty.call(b, key)) return false;\n    if (key !== \"series\") return sameValue(a[key], b[key]);\n    const sa = a.series;\n    const sb = b.series;\n    return (\n      sa === sb ||\n      (sa.length === sb.length &&\n        sa.every(\n          (s, i) =>\n            s === sb[i] ||\n            shallowEqual(\n              s as unknown as Record<string, unknown>,\n              sb[i] as unknown as Record<string, unknown>,\n            ),\n        ))\n    );\n  });\n};\n\nconst cssSize = (value: number | string | undefined, fallback: string) =>\n  value === undefined\n    ? fallback\n    : typeof value === \"number\"\n      ? `${value}px`\n      : value;\n\ninterface Chart3DBaseProps extends Handlers {\n  options: Chart3DOptions;\n  height?: number | string;\n  width?: number | string;\n  className?: string;\n  style?: CSSProperties;\n  handleRef?: Ref<Chart3DHandle>;\n}\n\nfunction Chart3DBase({\n  options,\n  height,\n  width,\n  className,\n  style,\n  handleRef,\n  ...handlers\n}: Chart3DBaseProps) {\n  const containerRef = useRef<HTMLDivElement>(null);\n  const chartRef = useRef<Chart3DInstance | null>(null);\n  const handlersRef = useRef<Handlers>(handlers);\n  // keep the previous options while they describe the same chart\n  const [stable, setStable] = useState(options);\n  if (stable !== options && !sameOptions3D(stable, options)) setStable(options);\n  const optionsRef = useRef(stable);\n\n  useEffect(() => {\n    handlersRef.current = handlers;\n  });\n\n  useEffect(() => {\n    const container = containerRef.current;\n    if (!container) return;\n    const chart = createChart3D(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.onPointClick?.(e)),\n      chart.on(\"camera\", (c) => handlersRef.current.onCameraChange?.(c)),\n      chart.on(\"renderer\", (r) => handlersRef.current.onRendererChange?.(r)),\n    ];\n    return () => {\n      offs.forEach((off) => off());\n      chart.destroy();\n      chartRef.current = null;\n    };\n  }, []);\n\n  useEffect(() => {\n    if (optionsRef.current === stable) return;\n    optionsRef.current = stable;\n    chartRef.current?.setOptions(stable);\n  }, [stable]);\n\n  useImperativeHandle(\n    handleRef,\n    () => ({\n      resetCamera: () => chartRef.current?.resetCamera(),\n      getCamera: () => chartRef.current?.getCamera() ?? null,\n      setCamera: (camera) => chartRef.current?.setCamera(camera),\n      getRenderer: () => chartRef.current?.getRenderer() ?? null,\n      getInstance: () => chartRef.current,\n    }),\n    [],\n  );\n\n  return (\n    <div\n      className={className}\n      style={{\n        position: \"relative\",\n        width: cssSize(width, \"100%\"),\n        height: cssSize(height, \"400px\"),\n        ...style,\n      }}\n    >\n      <div ref={containerRef} style={{ position: \"absolute\", inset: 0 }} />\n    </div>\n  );\n}\n\n/** Renders a chart from the common props and the typed series */\nfunction Chart3DFrame({\n  props,\n  series,\n}: {\n  props: Chart3DCommonProps;\n  series: readonly Chart3DSeries[];\n}) {\n  const {\n    height,\n    width,\n    xAxis,\n    yAxis,\n    zAxis,\n    camera,\n    autoRotate,\n    aspect,\n    box,\n    colorScale,\n    valueRange,\n    colorBar,\n    legend,\n    tooltip,\n    interaction,\n    lighting,\n    renderer,\n    palette,\n    ariaLabel,\n    locale,\n    labels,\n    onHover,\n    onPointClick,\n    onCameraChange,\n    onRendererChange,\n    className,\n    style,\n    ref,\n  } = props;\n  const options: Chart3DOptions = {\n    series,\n    xAxis,\n    yAxis,\n    zAxis,\n    camera,\n    autoRotate,\n    aspect,\n    box,\n    colorScale,\n    valueRange,\n    colorBar,\n    legend,\n    tooltip,\n    interaction,\n    lighting,\n    renderer,\n    palette,\n    ariaLabel,\n    locale,\n    labels,\n  };\n  return (\n    <Chart3DBase\n      options={options}\n      height={height}\n      width={width}\n      className={className}\n      style={style}\n      handleRef={ref}\n      onHover={onHover}\n      onPointClick={onPointClick}\n      onCameraChange={onCameraChange}\n      onRendererChange={onRendererChange}\n    />\n  );\n}\n\n// ----------------------------------------------------------- components\n\n/**\n * 3D scatter plot: point clouds of up to millions of points on the GPU,\n * colored per series, per point or through a color scale; orbit camera,\n * hover picking and color bar.\n */\nexport function Scatter3DChart(props: Scatter3DChartProps) {\n  const { series: input } = props;\n  const series = useMemo(\n    () => input.map((s) => ({ ...s, type: \"scatter\" as const })),\n    [input],\n  );\n  return <Chart3DFrame props={props} series={series} />;\n}\n\n/** 3D polylines (trajectories, paths), optionally colored along the line */\nexport function Line3DChart(props: Line3DChartProps) {\n  const { series: input } = props;\n  const series = useMemo(\n    () => input.map((s) => ({ ...s, type: \"line\" as const })),\n    [input],\n  );\n  return <Chart3DFrame props={props} series={series} />;\n}\n\n/**\n * 3D surface `z = f(x, y)` over a regular grid: lit, colored by a color\n * map, with an optional wireframe, contour lines and transparency.\n */\nexport function Surface3DChart(props: Surface3DChartProps) {\n  const { series: input, wireframe, contours } = props;\n  const series = useMemo(\n    () =>\n      input.map((s) => ({\n        ...s,\n        type: \"surface\" as const,\n        wireframe: s.wireframe ?? wireframe,\n        contours: s.contours ?? contours,\n      })),\n    [input, wireframe, contours],\n  );\n  return <Chart3DFrame props={props} series={series} />;\n}\n\n/** 3D bars over an x × y category grid, lit, stacked across series */\nexport function Bar3DChart(props: Bar3DChartProps) {\n  const { series: input, barWidth } = props;\n  const series = useMemo(\n    () =>\n      input.map((s) => ({\n        ...s,\n        type: \"bar\" as const,\n        barWidth: s.barWidth ?? barWidth,\n      })),\n    [input, barWidth],\n  );\n  return <Chart3DFrame props={props} series={series} />;\n}\n"],"mappings":"kHAyLA,IAAMO,EAAiB,GAAqD,CAC1E,GAAI,OAAOC,GAAU,WAAYA,EAAgB,MAAO,GACxD,IAAMC,EAAQ,OAAO,eAAeD,CAAK,EACzC,OAAOC,IAAU,OAAO,WAAaA,IAAU,IACjD,EAEMC,GACJ,EACA,IACY,CACZ,IAAMC,EAAO,OAAO,KAAKC,CAAC,EAE1B,OADID,EAAK,SAAW,OAAO,KAAKE,CAAC,CAAC,CAAC,QAC5BF,EAAK,MACT,GAAQC,EAAEE,KAASD,EAAEC,IAAQ,OAAO,UAAU,eAAe,KAAKD,EAAGC,CAAG,CAC3E,CACF,EAEMC,GAAa,EAAY,IACzBH,IAAMC,EAAU,GAChB,MAAM,QAAQD,CAAC,GAAK,MAAM,QAAQC,CAAC,EAC9BD,EAAE,SAAWC,EAAE,QAAUD,EAAE,OAAO,EAAG,IAAMI,IAAMH,EAAEI,EAAE,EACvDV,EAAcK,CAAC,GAAKL,EAAcM,CAAC,GAAKH,EAAaE,EAAGC,CAAC,EAQ5DK,GAAiB,EAAmB,IAA+B,CACvE,GAAIN,IAAMC,EAAG,MAAO,GACpB,IAAMF,EAAO,OAAO,KAAKC,CAAC,EAE1B,OADID,EAAK,SAAW,OAAO,KAAKE,CAAC,CAAC,CAAC,QAC5BF,EAAK,MAAO,GAAQ,CACzB,GAAI,CAAC,OAAO,UAAU,eAAe,KAAKE,EAAGC,CAAG,EAAG,MAAO,GAC1D,GAAIA,IAAQ,SAAU,OAAOC,EAAUH,EAAEE,GAAMD,EAAEC,EAAI,EACrD,IAAMK,EAAKP,EAAE,OACPQ,EAAKP,EAAE,OACb,OACEM,IAAOC,GACND,EAAG,SAAWC,EAAG,QAChBD,EAAG,OACA,EAAG,IACFE,IAAMD,EAAGH,IACTP,EACEW,EACAD,EAAGH,EACL,CACJ,CAEN,CAAC,CACH,EAEMK,GAAW,EAAoC,IACnDd,IAAU,IAAA,GACNe,EACA,OAAOf,GAAU,SACf,GAAGA,EAAM,IACTA,EAWR,SAASgB,EAAY,CACnB,UACA,SACA,QACA,YACA,QACA,YACA,GAAGC,GACgB,CACnB,IAAMC,GAAA,EAAe1B,EAAAA,OAAAA,CAAuB,IAAI,EAC1C2B,GAAA,EAAW3B,EAAAA,OAAAA,CAA+B,IAAI,EAC9C4B,GAAA,EAAc5B,EAAAA,OAAAA,CAAiByB,CAAQ,EAEvC,CAACI,EAAQC,IAAA,EAAa7B,EAAAA,SAAAA,CAAS8B,CAAO,EACxCF,IAAWE,GAAW,CAACb,EAAcW,EAAQE,CAAO,GAAGD,EAAUC,CAAO,EAC5E,IAAMC,GAAA,EAAahC,EAAAA,OAAAA,CAAO6B,CAAM,EA0ChC,OAxCA,EAAAxB,EAAA,UAAA,KAAgB,CACd,EAAY,QAAUoB,CACxB,CAAC,GAED,EAAApB,EAAA,UAAA,KAAgB,CACd,IAAM4B,EAAYP,EAAa,QAC/B,GAAI,CAACO,EAAW,OAChB,IAAMC,EAAQhC,EAAAA,cAAc+B,EAAWD,EAAW,OAAO,EACzD,EAAS,QAAUE,EACnB,IAAMC,EAAO,CACXD,EAAM,GAAG,QAAU,GAAMN,EAAY,QAAQ,UAAU,CAAC,CAAC,EACzDM,EAAM,GAAG,QAAU,GAAMN,EAAY,QAAQ,eAAe,CAAC,CAAC,EAC9DM,EAAM,GAAG,SAAW,GAAMN,EAAY,QAAQ,iBAAiBQ,CAAC,CAAC,EACjEF,EAAM,GAAG,WAAa,GAAMN,EAAY,QAAQ,mBAAmBS,CAAC,CAAC,CACvE,EACA,UAAa,CACXF,EAAK,QAAS,GAAQG,EAAI,CAAC,EAC3BJ,EAAM,QAAQ,EACd,EAAS,QAAU,IACrB,CACF,EAAG,CAAC,CAAC,GAEL,EAAA7B,EAAA,UAAA,KAAgB,CACV2B,EAAW,UAAYH,IAC3B,EAAW,QAAUA,EACrBF,EAAS,SAAS,WAAWE,CAAM,EACrC,EAAG,CAACA,CAAM,CAAC,GAEX,EAAAxB,EAAA,oBAAA,CACEkC,OACO,CACL,gBAAmBZ,EAAS,SAAS,YAAY,EACjD,cAAiBA,EAAS,SAAS,UAAU,GAAK,KAClD,UAAY,GAAWA,EAAS,SAAS,UAAUa,CAAM,EACzD,gBAAmBb,EAAS,SAAS,YAAY,GAAK,KACtD,gBAAmBA,EAAS,OAC9B,GACA,CAAC,CACH,GAGE,EAAArB,EAAA,IAAA,CAAC,MAAD,CACa,YACX,MAAO,CACL,SAAU,WACV,MAAOgB,EAAQmB,EAAO,MAAM,EAC5B,OAAQnB,EAAQoB,EAAQ,OAAO,EAC/B,GAAGC,CACL,EAEA,UAAA,EAAArC,EAAA,IAAA,CAAC,MAAD,CAAK,IAAKoB,EAAc,MAAO,CAAE,SAAU,WAAY,MAAO,CAAE,CAAI,CAAA,CACjE,CAAA,CAET,CAGA,SAASkB,EAAa,CACpB,QACA,UAIC,CACD,GAAM,CACJ,SACA,QACA,QACA,QACA,QACA,SACA,aACA,SACA,MACA,aACA,aACA,WACA,SACA,UACA,cACA,WACA,WACA,UACA,YACA,SACA,SACA,UACA,eACA,iBACA,mBACA,YACA,QACA,OACEC,EAuBJ,OACE,EAAAvC,EAAA,IAAA,CAACkB,EAAD,CACW,QAAA,CAvBX,SACA,QACA,QACA,QACA,SACA,aACA,SACA,MACA,aACA,aACA,WACA,SACA,UACA,cACA,WACA,WACA,UACA,YACA,SACA,QAIW,EACD,SACD,QACI,YACJ,QACP,UAAWsB,EACF,UACK,eACE,iBACE,kBACnB,CAAA,CAEL,CASA,SAAgBC,EAAe,EAA4B,CACzD,GAAM,CAAE,OAAQC,GAAUH,EACpBI,GAAA,EAAS9C,EAAAA,QAAAA,KACP6C,EAAM,IAAK,IAAO,CAAE,GAAG3B,EAAG,KAAM,SAAmB,EAAE,EAC3D,CAAC2B,CAAK,CACR,EACA,OAAO,EAAA1C,EAAA,IAAA,CAACsC,EAAD,CAAqB,QAAe,QAAS,CAAA,CACtD,CAGA,SAAgBM,EAAY,EAAyB,CACnD,GAAM,CAAE,OAAQF,GAAUH,EACpBI,GAAA,EAAS9C,EAAAA,QAAAA,KACP6C,EAAM,IAAK,IAAO,CAAE,GAAG3B,EAAG,KAAM,MAAgB,EAAE,EACxD,CAAC2B,CAAK,CACR,EACA,OAAO,EAAA1C,EAAA,IAAA,CAACsC,EAAD,CAAqB,QAAe,QAAS,CAAA,CACtD,CAMA,SAAgBO,EAAe,EAA4B,CACzD,GAAM,CAAE,OAAQH,EAAO,YAAW,YAAaH,EACzCI,GAAA,EAAS9C,EAAAA,QAAAA,KAEX6C,EAAM,IAAK,IAAO,CAChB,GAAG3B,EACH,KAAM,UACN,UAAWA,EAAE,WAAa+B,EAC1B,SAAU/B,EAAE,UAAYgC,CAC1B,EAAE,EACJ,CAACL,EAAOI,EAAWC,CAAQ,CAC7B,EACA,OAAO,EAAA/C,EAAA,IAAA,CAACsC,EAAD,CAAqB,QAAe,QAAS,CAAA,CACtD,CAGA,SAAgBU,EAAW,EAAwB,CACjD,GAAM,CAAE,OAAQN,EAAO,YAAaH,EAC9BI,GAAA,EAAS9C,EAAAA,QAAAA,KAEX6C,EAAM,IAAK,IAAO,CAChB,GAAG3B,EACH,KAAM,MACN,SAAUA,EAAE,UAAYkC,CAC1B,EAAE,EACJ,CAACP,EAAOO,CAAQ,CAClB,EACA,OAAO,EAAAjD,EAAA,IAAA,CAACsC,EAAD,CAAqB,QAAe,QAAS,CAAA,CACtD"}

package/dist/charts/react/three-d.d.cts

@@ -0,0 +1,151 @@
+import { CSSProperties, Ref } from 'react';
+import { Bar3DSeries, Chart3DAxisOptions, Chart3DCameraOptions, Chart3DCameraState, Chart3DColorBarOptions, Chart3DColorScale, Chart3DHoverEvent, Chart3DInstance, Chart3DInteractionOptions, Chart3DLabels, Chart3DLegendOptions, Chart3DLightingOptions, Chart3DTooltipOptions, Line3DSeries, Scatter3DSeries, Surface3DContourOptions, Surface3DSeries, Surface3DWireframeOptions } from '../engine/three-d/types.cjs';
+import { ChartRendererKind, ChartRendererPreference } from '../engine/types.cjs';
+/** Imperative handle of the 3D chart components (`ref`) */
+export interface Chart3DHandle {
+    /** Restores the camera of the `camera` prop */
+    resetCamera(): void;
+    /** Current camera, `null` before mount */
+    getCamera(): Chart3DCameraState | null;
+    /** Moves the camera */
+    setCamera(camera: Partial<Chart3DCameraState>): void;
+    /** Backend in use, `null` until ready */
+    getRenderer(): ChartRendererKind | null;
+    /** The underlying engine instance (minerva-design/charts/core) */
+    getInstance(): Chart3DInstance | null;
+}
+/** Props shared by every 3D chart component */
+export interface Chart3DCommonProps {
+    /**
+     * Height of the chart (the legend included); numbers are pixels
+     * @default 400
+     */
+    height?: number | string;
+    /**
+     * Width of the chart; numbers are pixels
+     * @default "100%"
+     */
+    width?: number | string;
+    /** X axis (width of the box) */
+    xAxis?: Chart3DAxisOptions;
+    /** Y axis (depth of the box) */
+    yAxis?: Chart3DAxisOptions;
+    /** Z axis (height of the box) */
+    zAxis?: Chart3DAxisOptions;
+    /** Initial camera, also restored by a double click (changing it moves the camera) */
+    camera?: Chart3DCameraOptions;
+    /**
+     * Turns the camera around the box: `true` at 12°/s or a speed in degrees
+     * per second; pauses while hovered, off-screen and with reduced motion
+     * @default false
+     */
+    autoRotate?: boolean | number;
+    /**
+     * Proportions of the box (x, y, z)
+     * @default [1, 1, 0.7]
+     */
+    aspect?: readonly [number, number, number];
+    /**
+     * Draws the axis box: back walls, grid lines, tick labels and axis titles
+     * @default true
+     */
+    box?: boolean;
+    /**
+     * Colors of `colorBy: "z"` / `"value"`: a built-in ramp or CSS colors
+     * @default "viridis"
+     */
+    colorScale?: Chart3DColorScale;
+    /** Values mapped to the ends of the color scale; the data range by default */
+    valueRange?: readonly [number, number];
+    /** Color bar; shown by default when a visible series uses the color scale */
+    colorBar?: boolean | Chart3DColorBarOptions;
+    /** Legend; shown by default when several series have a name */
+    legend?: boolean | Chart3DLegendOptions;
+    /** Tooltip; `false` disables it */
+    tooltip?: boolean | Chart3DTooltipOptions;
+    /**
+     * Drag rotates, right / Shift + drag pans, Ctrl / ⌘ + wheel and pinch zoom,
+     * double click resets, arrow keys rotate; `false` makes the chart static
+     * @default true
+     */
+    interaction?: boolean | Chart3DInteractionOptions;
+    /** Lighting of the surfaces and bars */
+    lighting?: Chart3DLightingOptions;
+    /**
+     * Backend of the data layer: `auto` tries WebGPU, then WebGL2, then WebGL,
+     * then Canvas2D, skipping GPUs running in software
+     * @default "auto"
+     */
+    renderer?: ChartRendererPreference;
+    /** Series colors (defaults to the `--chart-series-1..8` CSS variables, then the theme colors) */
+    palette?: readonly string[];
+    /** Accessible name of the chart */
+    ariaLabel?: string;
+    /**
+     * Language of the built-in texts (accessible summary, legend announcements,
+     * tooltip row names) and of the number formatting; built-in texts in
+     * English, Chinese, Japanese and French
+     * @default the page language (`<html lang>`), then the browser language
+     */
+    locale?: string;
+    /** Overrides of the built-in texts of the `locale` */
+    labels?: Partial<Chart3DLabels>;
+    /** Called when the hovered point, cell or bar changes */
+    onHover?: (event: Chart3DHoverEvent | null) => void;
+    /** Called when a point, cell or bar is clicked */
+    onPointClick?: (event: Chart3DHoverEvent) => void;
+    /** Called after the user rotated, zoomed, panned or reset the camera */
+    onCameraChange?: (camera: Chart3DCameraState) => void;
+    /** Called with the backend once it is ready (and after a fallback) */
+    onRendererChange?: (renderer: ChartRendererKind) => void;
+    /** Class of the outer element */
+    className?: string;
+    /** Style of the outer element */
+    style?: CSSProperties;
+    /** Imperative handle */
+    ref?: Ref<Chart3DHandle>;
+}
+/** Props of `Scatter3DChart` */
+export interface Scatter3DChartProps extends Chart3DCommonProps {
+    /** Point clouds (objects, `[x, y, z]` tuples or typed-array columns) */
+    series: readonly Scatter3DSeries[];
+}
+/** Props of `Line3DChart` */
+export interface Line3DChartProps extends Chart3DCommonProps {
+    /** 3D polylines (trajectories) */
+    series: readonly Line3DSeries[];
+}
+/** Props of `Surface3DChart` */
+export interface Surface3DChartProps extends Chart3DCommonProps {
+    /** Surfaces over regular grids */
+    series: readonly Surface3DSeries[];
+    /** Wireframe of the series that do not set one */
+    wireframe?: boolean | Surface3DWireframeOptions;
+    /** Contour lines of the series that do not set them */
+    contours?: boolean | Surface3DContourOptions;
+}
+/** Props of `Bar3DChart` */
+export interface Bar3DChartProps extends Chart3DCommonProps {
+    /** Bars over the x × y category grid (bars of the same cell are stacked) */
+    series: readonly Bar3DSeries[];
+    /**
+     * Width of the bars of the series that do not set one, as a fraction of a cell
+     * @default 0.7
+     */
+    barWidth?: number;
+}
+/**
+ * 3D scatter plot: point clouds of up to millions of points on the GPU,
+ * colored per series, per point or through a color scale; orbit camera,
+ * hover picking and color bar.
+ */
+export declare function Scatter3DChart(props: Scatter3DChartProps): import('react').JSX.Element;
+/** 3D polylines (trajectories, paths), optionally colored along the line */
+export declare function Line3DChart(props: Line3DChartProps): import('react').JSX.Element;
+/**
+ * 3D surface `z = f(x, y)` over a regular grid: lit, colored by a color
+ * map, with an optional wireframe, contour lines and transparency.
+ */
+export declare function Surface3DChart(props: Surface3DChartProps): import('react').JSX.Element;
+/** 3D bars over an x × y category grid, lit, stacked across series */
+export declare function Bar3DChart(props: Bar3DChartProps): import('react').JSX.Element;

package/dist/charts/react/three-d.d.ts

@@ -0,0 +1,151 @@
+import { CSSProperties, Ref } from 'react';
+import { Bar3DSeries, Chart3DAxisOptions, Chart3DCameraOptions, Chart3DCameraState, Chart3DColorBarOptions, Chart3DColorScale, Chart3DHoverEvent, Chart3DInstance, Chart3DInteractionOptions, Chart3DLabels, Chart3DLegendOptions, Chart3DLightingOptions, Chart3DTooltipOptions, Line3DSeries, Scatter3DSeries, Surface3DContourOptions, Surface3DSeries, Surface3DWireframeOptions } from '../engine/three-d/types.js';
+import { ChartRendererKind, ChartRendererPreference } from '../engine/types.js';
+/** Imperative handle of the 3D chart components (`ref`) */
+export interface Chart3DHandle {
+    /** Restores the camera of the `camera` prop */
+    resetCamera(): void;
+    /** Current camera, `null` before mount */
+    getCamera(): Chart3DCameraState | null;
+    /** Moves the camera */
+    setCamera(camera: Partial<Chart3DCameraState>): void;
+    /** Backend in use, `null` until ready */
+    getRenderer(): ChartRendererKind | null;
+    /** The underlying engine instance (minerva-design/charts/core) */
+    getInstance(): Chart3DInstance | null;
+}
+/** Props shared by every 3D chart component */
+export interface Chart3DCommonProps {
+    /**
+     * Height of the chart (the legend included); numbers are pixels
+     * @default 400
+     */
+    height?: number | string;
+    /**
+     * Width of the chart; numbers are pixels
+     * @default "100%"
+     */
+    width?: number | string;
+    /** X axis (width of the box) */
+    xAxis?: Chart3DAxisOptions;
+    /** Y axis (depth of the box) */
+    yAxis?: Chart3DAxisOptions;
+    /** Z axis (height of the box) */
+    zAxis?: Chart3DAxisOptions;
+    /** Initial camera, also restored by a double click (changing it moves the camera) */
+    camera?: Chart3DCameraOptions;
+    /**
+     * Turns the camera around the box: `true` at 12°/s or a speed in degrees
+     * per second; pauses while hovered, off-screen and with reduced motion
+     * @default false
+     */
+    autoRotate?: boolean | number;
+    /**
+     * Proportions of the box (x, y, z)
+     * @default [1, 1, 0.7]
+     */
+    aspect?: readonly [number, number, number];
+    /**
+     * Draws the axis box: back walls, grid lines, tick labels and axis titles
+     * @default true
+     */
+    box?: boolean;
+    /**
+     * Colors of `colorBy: "z"` / `"value"`: a built-in ramp or CSS colors
+     * @default "viridis"
+     */
+    colorScale?: Chart3DColorScale;
+    /** Values mapped to the ends of the color scale; the data range by default */
+    valueRange?: readonly [number, number];
+    /** Color bar; shown by default when a visible series uses the color scale */
+    colorBar?: boolean | Chart3DColorBarOptions;
+    /** Legend; shown by default when several series have a name */
+    legend?: boolean | Chart3DLegendOptions;
+    /** Tooltip; `false` disables it */
+    tooltip?: boolean | Chart3DTooltipOptions;
+    /**
+     * Drag rotates, right / Shift + drag pans, Ctrl / ⌘ + wheel and pinch zoom,
+     * double click resets, arrow keys rotate; `false` makes the chart static
+     * @default true
+     */
+    interaction?: boolean | Chart3DInteractionOptions;
+    /** Lighting of the surfaces and bars */
+    lighting?: Chart3DLightingOptions;
+    /**
+     * Backend of the data layer: `auto` tries WebGPU, then WebGL2, then WebGL,
+     * then Canvas2D, skipping GPUs running in software
+     * @default "auto"
+     */
+    renderer?: ChartRendererPreference;
+    /** Series colors (defaults to the `--chart-series-1..8` CSS variables, then the theme colors) */
+    palette?: readonly string[];
+    /** Accessible name of the chart */
+    ariaLabel?: string;
+    /**
+     * Language of the built-in texts (accessible summary, legend announcements,
+     * tooltip row names) and of the number formatting; built-in texts in
+     * English, Chinese, Japanese and French
+     * @default the page language (`<html lang>`), then the browser language
+     */
+    locale?: string;
+    /** Overrides of the built-in texts of the `locale` */
+    labels?: Partial<Chart3DLabels>;
+    /** Called when the hovered point, cell or bar changes */
+    onHover?: (event: Chart3DHoverEvent | null) => void;
+    /** Called when a point, cell or bar is clicked */
+    onPointClick?: (event: Chart3DHoverEvent) => void;
+    /** Called after the user rotated, zoomed, panned or reset the camera */
+    onCameraChange?: (camera: Chart3DCameraState) => void;
+    /** Called with the backend once it is ready (and after a fallback) */
+    onRendererChange?: (renderer: ChartRendererKind) => void;
+    /** Class of the outer element */
+    className?: string;
+    /** Style of the outer element */
+    style?: CSSProperties;
+    /** Imperative handle */
+    ref?: Ref<Chart3DHandle>;
+}
+/** Props of `Scatter3DChart` */
+export interface Scatter3DChartProps extends Chart3DCommonProps {
+    /** Point clouds (objects, `[x, y, z]` tuples or typed-array columns) */
+    series: readonly Scatter3DSeries[];
+}
+/** Props of `Line3DChart` */
+export interface Line3DChartProps extends Chart3DCommonProps {
+    /** 3D polylines (trajectories) */
+    series: readonly Line3DSeries[];
+}
+/** Props of `Surface3DChart` */
+export interface Surface3DChartProps extends Chart3DCommonProps {
+    /** Surfaces over regular grids */
+    series: readonly Surface3DSeries[];
+    /** Wireframe of the series that do not set one */
+    wireframe?: boolean | Surface3DWireframeOptions;
+    /** Contour lines of the series that do not set them */
+    contours?: boolean | Surface3DContourOptions;
+}
+/** Props of `Bar3DChart` */
+export interface Bar3DChartProps extends Chart3DCommonProps {
+    /** Bars over the x × y category grid (bars of the same cell are stacked) */
+    series: readonly Bar3DSeries[];
+    /**
+     * Width of the bars of the series that do not set one, as a fraction of a cell
+     * @default 0.7
+     */
+    barWidth?: number;
+}
+/**
+ * 3D scatter plot: point clouds of up to millions of points on the GPU,
+ * colored per series, per point or through a color scale; orbit camera,
+ * hover picking and color bar.
+ */
+export declare function Scatter3DChart(props: Scatter3DChartProps): import('react').JSX.Element;
+/** 3D polylines (trajectories, paths), optionally colored along the line */
+export declare function Line3DChart(props: Line3DChartProps): import('react').JSX.Element;
+/**
+ * 3D surface `z = f(x, y)` over a regular grid: lit, colored by a color
+ * map, with an optional wireframe, contour lines and transparency.
+ */
+export declare function Surface3DChart(props: Surface3DChartProps): import('react').JSX.Element;
+/** 3D bars over an x × y category grid, lit, stacked across series */
+export declare function Bar3DChart(props: Bar3DChartProps): import('react').JSX.Element;