minerva-design 1.2.0 → 1.4.0

package/dist/charts/react/trading.d.ts

@@ -0,0 +1,93 @@
+import { CSSProperties, Ref } from 'react';
+import { TradingBar, TradingBarsInput, TradingChartInstance, TradingChartOptions, TradingClickEvent, TradingCrosshairEvent, TradingDrawing, TradingDrawingTool, TradingHistoryRequestEvent, TradingIndicatorToggleEvent, TradingOrderMoveEvent, TradingVisibleRange } from '../engine/trading/types.js';
+import { ChartRendererKind } from '../engine/types.js';
+/** Imperative handle of `<TradingChart>` */
+export interface TradingChartHandle {
+    /**
+     * Streams a bar: the time of the last bar replaces it, a later time
+     * appends it (cheap: call it on every tick)
+     */
+    update(bar: TradingBar): void;
+    /** Appends bars newer than the last one */
+    appendBars(bars: TradingBarsInput): void;
+    /** Inserts older bars before the first one, keeping the view */
+    prependBars(bars: TradingBarsInput): void;
+    /** Replaces the bars */
+    setBars(bars: TradingBarsInput): void;
+    /** Number of bars */
+    getBarCount(): number;
+    /** Bar at an index, `null` outside the data */
+    getBar(index: number): TradingBar | null;
+    /** Scrolls to the latest bar */
+    scrollToRealtime(animate?: boolean): void;
+    /** Shows every bar */
+    fitContent(): void;
+    /** Visible bars, `null` before mounting */
+    getVisibleRange(): TradingVisibleRange | null;
+    /** Shows the bars between two logical indices */
+    setVisibleRange(range: {
+        from: number;
+        to: number;
+    }): void;
+    /** Fits every price scale to the visible bars again */
+    resetPriceScales(): void;
+    /** Activates a drawing tool */
+    setDrawingTool(tool: TradingDrawingTool): void;
+    /** Current drawings */
+    getDrawings(): readonly TradingDrawing[];
+    /** Deletes a drawing */
+    removeDrawing(id: string): void;
+    /** Selects a drawing (`null` clears the selection) */
+    selectDrawing(id: string | null): void;
+    /** Shows or hides an indicator */
+    setIndicatorVisible(id: string, visible: boolean): void;
+    /** Backend in use, `null` until ready */
+    getRenderer(): ChartRendererKind | null;
+    /** The underlying engine instance (minerva-design/charts/core) */
+    getInstance(): TradingChartInstance | null;
+}
+/** Props of `<TradingChart>`: the options of `createTradingChart`, the size and the events */
+export interface TradingChartProps extends TradingChartOptions {
+    /**
+     * Height (pixels or any CSS length)
+     * @default 480
+     */
+    height?: number | string;
+    /**
+     * Width (pixels or any CSS length)
+     * @default "100%"
+     */
+    width?: number | string;
+    /** Class of the root element */
+    className?: string;
+    /** Inline styles of the root element */
+    style?: CSSProperties;
+    /** Imperative handle (streaming, scrolling, drawings) */
+    ref?: Ref<TradingChartHandle>;
+    /** The crosshair moved (`null` when it left the chart) */
+    onCrosshairMove?: (event: TradingCrosshairEvent | null) => void;
+    /** A pane was clicked */
+    onClick?: (event: TradingClickEvent) => void;
+    /** The visible bars changed */
+    onVisibleRangeChange?: (range: TradingVisibleRange) => void;
+    /** A draggable price line was dropped at a new price */
+    onOrderMove?: (event: TradingOrderMoveEvent) => void;
+    /** The user added, moved or deleted drawings (pass them back as `drawings`) */
+    onDrawingsChange?: (drawings: readonly TradingDrawing[]) => void;
+    /** The selected drawing changed */
+    onDrawingSelect?: (id: string | null) => void;
+    /** The drawing tool changed (back to `cursor` after a drawing) */
+    onDrawingToolChange?: (tool: TradingDrawingTool) => void;
+    /** An indicator was shown or hidden from its legend */
+    onIndicatorToggle?: (event: TradingIndicatorToggleEvent) => void;
+    /** The oldest bar came into view: load older bars (`prependBars`) */
+    onHistoryRequest?: (event: TradingHistoryRequestEvent) => void;
+    /** The backend in use (again after a fallback) */
+    onRendererChange?: (renderer: ChartRendererKind) => void;
+}
+/**
+ * Professional trading chart: candles (hollow, Heikin-Ashi, bars, line,
+ * area, baseline) over a gap-free time axis, indicator panes, drawing
+ * tools, order lines and real-time streaming, drawn on the GPU.
+ */
+export declare function TradingChart(props: TradingChartProps): import('react').JSX.Element;

package/dist/charts/react/trading.js

@@ -0,0 +1,95 @@
+"use client";
+import { createTradingChart as e } from "../engine/trading/chart.js";
+import { useEffect as t, useImperativeHandle as n, useRef as r, useState as i } from "react";
+import { jsx as a } from "react/jsx-runtime";
+//#region src/react/trading.tsx
+var o = (e) => {
+	if (typeof e != "object" || !e) return !1;
+	let t = Object.getPrototypeOf(e);
+	return t === Object.prototype || t === null;
+}, s = (e, t) => {
+	let n = Object.keys(e);
+	return n.length === Object.keys(t).length && n.every((n) => Object.prototype.hasOwnProperty.call(t, n) && c(e[n], t[n]));
+}, c = (e, t) => e === t || Array.isArray(e) && Array.isArray(t) && e.length === t.length && e.every((e, n) => e === t[n]), l = (e, t) => e === t ? !0 : Array.isArray(e) && Array.isArray(t) ? e.length === t.length && e.every((e, n) => e === t[n] || o(e) && o(t[n]) && s(e, t[n])) : o(e) && o(t) && s(e, t), u = (e, t) => {
+	let n = Object.keys(e);
+	return n.length === Object.keys(t).length && n.every((n) => Object.prototype.hasOwnProperty.call(t, n) ? n === "bars" || n === "drawings" ? e[n] === t[n] : l(e[n], t[n]) : !1);
+}, d = (e, t) => e === void 0 ? t : typeof e == "number" ? `${e}px` : e;
+function f(o) {
+	let { height: s, width: c, className: l, style: f, ref: p, onCrosshairMove: m, onClick: h, onVisibleRangeChange: g, onOrderMove: _, onDrawingsChange: v, onDrawingSelect: y, onDrawingToolChange: b, onIndicatorToggle: x, onHistoryRequest: S, onRendererChange: C, ...w } = o, T = {
+		onCrosshairMove: m,
+		onClick: h,
+		onVisibleRangeChange: g,
+		onOrderMove: _,
+		onDrawingsChange: v,
+		onDrawingSelect: y,
+		onDrawingToolChange: b,
+		onIndicatorToggle: x,
+		onHistoryRequest: S,
+		onRendererChange: C
+	}, E = r(null), D = r(null), O = r(T), [k, A] = i(w);
+	k !== w && !u(k, w) && A(w);
+	let j = r(k);
+	return t(() => {
+		O.current = T;
+	}), t(() => {
+		let t = E.current;
+		if (!t) return;
+		let n = e(t, j.current);
+		D.current = n;
+		let r = () => O.current, i = [
+			n.on("crosshairMove", (e) => r().onCrosshairMove?.(e)),
+			n.on("click", (e) => r().onClick?.(e)),
+			n.on("visibleRangeChange", (e) => r().onVisibleRangeChange?.(e)),
+			n.on("orderMove", (e) => r().onOrderMove?.(e)),
+			n.on("drawingsChange", (e) => r().onDrawingsChange?.(e)),
+			n.on("drawingSelect", (e) => r().onDrawingSelect?.(e)),
+			n.on("drawingToolChange", (e) => r().onDrawingToolChange?.(e)),
+			n.on("indicatorToggle", (e) => r().onIndicatorToggle?.(e)),
+			n.on("historyRequest", (e) => r().onHistoryRequest?.(e)),
+			n.on("renderer", (e) => r().onRendererChange?.(e))
+		];
+		return () => {
+			i.forEach((e) => e()), n.destroy(), D.current = null;
+		};
+	}, []), t(() => {
+		j.current !== k && (j.current = k, D.current?.setOptions(k));
+	}, [k]), n(p, () => ({
+		update: (e) => D.current?.update(e),
+		appendBars: (e) => D.current?.appendBars(e),
+		prependBars: (e) => D.current?.prependBars(e),
+		setBars: (e) => D.current?.setBars(e),
+		getBarCount: () => D.current?.getBarCount() ?? 0,
+		getBar: (e) => D.current?.getBar(e) ?? null,
+		scrollToRealtime: (e) => D.current?.scrollToRealtime(e),
+		fitContent: () => D.current?.fitContent(),
+		getVisibleRange: () => D.current?.getVisibleRange() ?? null,
+		setVisibleRange: (e) => D.current?.setVisibleRange(e),
+		resetPriceScales: () => D.current?.resetPriceScales(),
+		setDrawingTool: (e) => D.current?.setDrawingTool(e),
+		getDrawings: () => D.current?.getDrawings() ?? [],
+		removeDrawing: (e) => D.current?.removeDrawing(e),
+		selectDrawing: (e) => D.current?.selectDrawing(e),
+		setIndicatorVisible: (e, t) => D.current?.setIndicatorVisible(e, t),
+		getRenderer: () => D.current?.getRenderer() ?? null,
+		getInstance: () => D.current
+	}), []), /* @__PURE__ */ a("div", {
+		className: l,
+		style: {
+			position: "relative",
+			width: d(c, "100%"),
+			height: d(s, "480px"),
+			...f
+		},
+		children: /* @__PURE__ */ a("div", {
+			ref: E,
+			style: {
+				position: "absolute",
+				inset: 0
+			}
+		})
+	});
+}
+//#endregion
+export { f as TradingChart };
+
+//# sourceMappingURL=trading.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"trading.js","names":["isPlainObject","value","proto","shallowEqual","keys","a","b","key","sameItem","v","i","sameValue","sameOptions","size","fallback","TradingChart","options","props","handlers","containerRef","useRef","chartRef","handlersRef","stable","setStable","useState","optionsRef","useEffect","container","chart","createTradingChart","h","offs","off","useImperativeHandle","ref","bar","bars","index","animate","range","tool","id","visible","width","height","style"],"sources":["../../../../charts/src/react/trading.tsx"],"sourcesContent":["import {\n  useEffect,\n  useImperativeHandle,\n  useRef,\n  useState,\n  type CSSProperties,\n  type Ref,\n} from \"react\";\nimport { createTradingChart } from \"../engine/trading/chart\";\nimport type {\n  TradingBar,\n  TradingBarsInput,\n  TradingChartInstance,\n  TradingChartOptions,\n  TradingClickEvent,\n  TradingCrosshairEvent,\n  TradingDrawing,\n  TradingDrawingTool,\n  TradingHistoryRequestEvent,\n  TradingIndicatorToggleEvent,\n  TradingOrderMoveEvent,\n  TradingVisibleRange,\n} from \"../engine/trading/types\";\nimport type { ChartRendererKind } from \"../engine/types\";\n\n/** Imperative handle of `<TradingChart>` */\nexport interface TradingChartHandle {\n  /**\n   * Streams a bar: the time of the last bar replaces it, a later time\n   * appends it (cheap: call it on every tick)\n   */\n  update(bar: TradingBar): void;\n  /** Appends bars newer than the last one */\n  appendBars(bars: TradingBarsInput): void;\n  /** Inserts older bars before the first one, keeping the view */\n  prependBars(bars: TradingBarsInput): void;\n  /** Replaces the bars */\n  setBars(bars: TradingBarsInput): void;\n  /** Number of bars */\n  getBarCount(): number;\n  /** Bar at an index, `null` outside the data */\n  getBar(index: number): TradingBar | null;\n  /** Scrolls to the latest bar */\n  scrollToRealtime(animate?: boolean): void;\n  /** Shows every bar */\n  fitContent(): void;\n  /** Visible bars, `null` before mounting */\n  getVisibleRange(): TradingVisibleRange | null;\n  /** Shows the bars between two logical indices */\n  setVisibleRange(range: { from: number; to: number }): void;\n  /** Fits every price scale to the visible bars again */\n  resetPriceScales(): void;\n  /** Activates a drawing tool */\n  setDrawingTool(tool: TradingDrawingTool): void;\n  /** Current drawings */\n  getDrawings(): readonly TradingDrawing[];\n  /** Deletes a drawing */\n  removeDrawing(id: string): void;\n  /** Selects a drawing (`null` clears the selection) */\n  selectDrawing(id: string | null): void;\n  /** Shows or hides an indicator */\n  setIndicatorVisible(id: string, visible: boolean): void;\n  /** Backend in use, `null` until ready */\n  getRenderer(): ChartRendererKind | null;\n  /** The underlying engine instance (minerva-design/charts/core) */\n  getInstance(): TradingChartInstance | null;\n}\n\n/** Props of `<TradingChart>`: the options of `createTradingChart`, the size and the events */\nexport interface TradingChartProps extends TradingChartOptions {\n  /**\n   * Height (pixels or any CSS length)\n   * @default 480\n   */\n  height?: number | string;\n  /**\n   * Width (pixels or any CSS length)\n   * @default \"100%\"\n   */\n  width?: number | string;\n  /** Class of the root element */\n  className?: string;\n  /** Inline styles of the root element */\n  style?: CSSProperties;\n  /** Imperative handle (streaming, scrolling, drawings) */\n  ref?: Ref<TradingChartHandle>;\n  /** The crosshair moved (`null` when it left the chart) */\n  onCrosshairMove?: (event: TradingCrosshairEvent | null) => void;\n  /** A pane was clicked */\n  onClick?: (event: TradingClickEvent) => void;\n  /** The visible bars changed */\n  onVisibleRangeChange?: (range: TradingVisibleRange) => void;\n  /** A draggable price line was dropped at a new price */\n  onOrderMove?: (event: TradingOrderMoveEvent) => void;\n  /** The user added, moved or deleted drawings (pass them back as `drawings`) */\n  onDrawingsChange?: (drawings: readonly TradingDrawing[]) => void;\n  /** The selected drawing changed */\n  onDrawingSelect?: (id: string | null) => void;\n  /** The drawing tool changed (back to `cursor` after a drawing) */\n  onDrawingToolChange?: (tool: TradingDrawingTool) => void;\n  /** An indicator was shown or hidden from its legend */\n  onIndicatorToggle?: (event: TradingIndicatorToggleEvent) => void;\n  /** The oldest bar came into view: load older bars (`prependBars`) */\n  onHistoryRequest?: (event: TradingHistoryRequestEvent) => void;\n  /** The backend in use (again after a fallback) */\n  onRendererChange?: (renderer: ChartRendererKind) => void;\n}\n\ntype Handlers = Pick<\n  TradingChartProps,\n  | \"onCrosshairMove\"\n  | \"onClick\"\n  | \"onVisibleRangeChange\"\n  | \"onOrderMove\"\n  | \"onDrawingsChange\"\n  | \"onDrawingSelect\"\n  | \"onDrawingToolChange\"\n  | \"onIndicatorToggle\"\n  | \"onHistoryRequest\"\n  | \"onRendererChange\"\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) =>\n      Object.prototype.hasOwnProperty.call(b, key) && sameItem(a[key], b[key]),\n  );\n};\n\n/** Identical, or inline arrays of identical values */\nconst sameItem = (a: unknown, b: unknown): boolean =>\n  a === b ||\n  (Array.isArray(a) &&\n    Array.isArray(b) &&\n    a.length === b.length &&\n    a.every((v, i) => v === b[i]));\n\n/**\n * Same option value: identical, or inline arrays / objects of plain objects\n * with identical fields (`indicators={[{ type: \"ma\", period: 7 }]}`). Bars,\n * markers and drawings are compared by identity when they are not plain\n * objects (typed arrays) and item by item otherwise.\n */\nconst sameValue = (a: unknown, b: unknown): boolean => {\n  if (a === b) return true;\n  if (Array.isArray(a) && Array.isArray(b)) {\n    return (\n      a.length === b.length &&\n      a.every(\n        (v, i) =>\n          v === b[i] ||\n          (isPlainObject(v) && isPlainObject(b[i]) && shallowEqual(v, b[i])),\n      )\n    );\n  }\n  return isPlainObject(a) && isPlainObject(b) && shallowEqual(a, b);\n};\n\n/** Options describing the same chart (bars and drawings compared by identity) */\nconst sameOptions = (a: TradingChartOptions, b: TradingChartOptions) => {\n  const keys = Object.keys(a) as (keyof TradingChartOptions)[];\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    // new bars / drawings arrays are always applied: compared by identity\n    if (key === \"bars\" || key === \"drawings\") return a[key] === b[key];\n    return sameValue(a[key], b[key]);\n  });\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/**\n * Professional trading chart: candles (hollow, Heikin-Ashi, bars, line,\n * area, baseline) over a gap-free time axis, indicator panes, drawing\n * tools, order lines and real-time streaming, drawn on the GPU.\n */\nexport function TradingChart(props: TradingChartProps) {\n  const {\n    height,\n    width,\n    className,\n    style,\n    ref,\n    onCrosshairMove,\n    onClick,\n    onVisibleRangeChange,\n    onOrderMove,\n    onDrawingsChange,\n    onDrawingSelect,\n    onDrawingToolChange,\n    onIndicatorToggle,\n    onHistoryRequest,\n    onRendererChange,\n    ...options\n  } = props;\n  const handlers: Handlers = {\n    onCrosshairMove,\n    onClick,\n    onVisibleRangeChange,\n    onOrderMove,\n    onDrawingsChange,\n    onDrawingSelect,\n    onDrawingToolChange,\n    onIndicatorToggle,\n    onHistoryRequest,\n    onRendererChange,\n  };\n  const containerRef = useRef<HTMLDivElement>(null);\n  const chartRef = useRef<TradingChartInstance | null>(null);\n  const handlersRef = useRef<Handlers>(handlers);\n\n  // a new options object on every render: keep the previous one while it\n  // describes the same chart (state derived during render)\n  const [stable, setStable] = useState<TradingChartOptions>(options);\n  if (stable !== options && !sameOptions(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 = createTradingChart(container, optionsRef.current);\n    chartRef.current = chart;\n    const h = () => handlersRef.current;\n    const offs = [\n      chart.on(\"crosshairMove\", (e) => h().onCrosshairMove?.(e)),\n      chart.on(\"click\", (e) => h().onClick?.(e)),\n      chart.on(\"visibleRangeChange\", (e) => h().onVisibleRangeChange?.(e)),\n      chart.on(\"orderMove\", (e) => h().onOrderMove?.(e)),\n      chart.on(\"drawingsChange\", (e) => h().onDrawingsChange?.(e)),\n      chart.on(\"drawingSelect\", (e) => h().onDrawingSelect?.(e)),\n      chart.on(\"drawingToolChange\", (e) => h().onDrawingToolChange?.(e)),\n      chart.on(\"indicatorToggle\", (e) => h().onIndicatorToggle?.(e)),\n      chart.on(\"historyRequest\", (e) => h().onHistoryRequest?.(e)),\n      chart.on(\"renderer\", (e) => h().onRendererChange?.(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 === stable) return;\n    optionsRef.current = stable;\n    chartRef.current?.setOptions(stable);\n  }, [stable]);\n\n  useImperativeHandle(\n    ref,\n    (): TradingChartHandle => ({\n      update: (bar) => chartRef.current?.update(bar),\n      appendBars: (bars) => chartRef.current?.appendBars(bars),\n      prependBars: (bars) => chartRef.current?.prependBars(bars),\n      setBars: (bars) => chartRef.current?.setBars(bars),\n      getBarCount: () => chartRef.current?.getBarCount() ?? 0,\n      getBar: (index) => chartRef.current?.getBar(index) ?? null,\n      scrollToRealtime: (animate) =>\n        chartRef.current?.scrollToRealtime(animate),\n      fitContent: () => chartRef.current?.fitContent(),\n      getVisibleRange: () => chartRef.current?.getVisibleRange() ?? null,\n      setVisibleRange: (range) => chartRef.current?.setVisibleRange(range),\n      resetPriceScales: () => chartRef.current?.resetPriceScales(),\n      setDrawingTool: (tool) => chartRef.current?.setDrawingTool(tool),\n      getDrawings: () => chartRef.current?.getDrawings() ?? [],\n      removeDrawing: (id) => chartRef.current?.removeDrawing(id),\n      selectDrawing: (id) => chartRef.current?.selectDrawing(id),\n      setIndicatorVisible: (id, visible) =>\n        chartRef.current?.setIndicatorVisible(id, visible),\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: size(width, \"100%\"),\n        height: size(height, \"480px\"),\n        ...style,\n      }}\n    >\n      <div ref={containerRef} style={{ position: \"absolute\", inset: 0 }} />\n    </div>\n  );\n}\n"],"mappings":"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"}

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

@@ -1,7 +1,7 @@
 import { CSSProperties, ReactNode, Ref } from 'react';
-import { ChartAnnotation, ChartAxisOptions, ChartHoverEvent, ChartInstance, ChartLegendOptions, ChartInteractionOptions, ChartPadding, ChartPlotClickEvent, ChartRendererKind, ChartRendererPreference, ChartSeries, ChartTooltipOptions, ChartView } from '../engine/types.cjs';
-import { QuadrantConfig, QuadrantCorner, QuadrantPoint } from '../engine/presets.cjs';
-export type { QuadrantAxisLabels, QuadrantConfig, QuadrantCorner, QuadrantPoint, QuadrantRegion, QuadrantRegions, } from '../engine/presets.cjs';
+import { ChartAnnotation, ChartAxisOptions, ChartCurve, ChartHoverEvent, ChartInstance, ChartLabels, ChartLegendOptions, ChartInteractionOptions, ChartOrientation, ChartPadding, ChartPlotClickEvent, ChartRendererKind, ChartRendererPreference, ChartSeries, ChartTooltipOptions, ChartView } from '../engine/types.cjs';
+import { BinOptions, BoxplotGroup, BoxplotStatsOptions, BubbleOptions, GanttOptions, GanttTask, HeatmapConfig, QuadrantConfig, QuadrantCorner, QuadrantPoint, SparklineConfig, WaterfallOptions, WaterfallStep } from '../engine/presets.cjs';
+export type { BinOptions, BoxplotGroup, BoxplotStats, BoxplotStatsOptions, BubbleOptions, GanttOptions, GanttSeries, GanttTask, HistogramBinning, HistogramBins, HistogramSeriesOptions, WaterfallOptions, WaterfallStep, HeatmapCell, HeatmapConfig, QuadrantAxisLabels, QuadrantConfig, QuadrantCorner, QuadrantPoint, QuadrantRegion, QuadrantRegions, SparklineConfig, } from '../engine/presets.cjs';
 /** Imperative handle of the chart components (`ref`) */
 export interface ChartHandle {
     /** Shows the whole data range */
@@ -32,7 +32,7 @@ export interface ChartCommonProps {
     /** Y axis */
     yAxis?: ChartAxisOptions;
     /**
-     * Backend of the data layer: `auto` tries WebGPU, then WebGL2, then Canvas2D
+     * Backend of the data layer: `auto` tries WebGPU, then WebGL2, then WebGL, then Canvas2D
      * @default "auto"
      */
     renderer?: ChartRendererPreference;
@@ -55,6 +55,14 @@ export interface ChartCommonProps {
     palette?: readonly string[];
     /** Accessible name of the chart */
     ariaLabel?: string;
+    /**
+     * Locale of the texts and numbers the chart writes (tooltip rows, compact
+     * units `k` / `万`, separators, month and weekday names of time axes)
+     * @default the page language (`<html lang>`), else the browser language
+     */
+    locale?: string;
+    /** Overrides of the built-in texts of the `locale` */
+    labels?: Partial<ChartLabels>;
     /** Called when the hovered (or keyboard-focused) points change */
     onHover?: (event: ChartHoverEvent | null) => void;
     /** Called when a point (or bar) is clicked */
@@ -74,10 +82,26 @@ export interface ChartCommonProps {
     /** Imperative handle */
     ref?: Ref<ChartHandle>;
 }
-/** Props of Chart: any mix of line, area, bar and scatter series */
+/** Props of Chart: any mix of line, area, bar, scatter, candlestick, heatmap and box plot series */
 export interface ChartProps extends ChartCommonProps {
     /** Data series; each sets its own `type` */
     series: readonly ChartSeries[];
+    /**
+     * `percent` scales every stack to 100% at each x
+     * @default "normal"
+     */
+    stackMode?: "normal" | "percent";
+    /**
+     * Right value axis of the series with `yAxis: "right"`; its range is
+     * aligned on the left ticks (vertical charts)
+     */
+    yAxis2?: ChartAxisOptions;
+    /**
+     * `horizontal` puts the x axis (categories) down the left side and the
+     * values along the bottom
+     * @default "vertical"
+     */
+    orientation?: ChartOrientation;
 }
 /** Props of LineChart */
 export interface LineChartProps extends ChartCommonProps {
@@ -88,9 +112,47 @@ export interface LineChartProps extends ChartCommonProps {
      * @default false
      */
     area?: boolean;
+    /**
+     * Shape of the lines: straight, smooth (monotone) or steps
+     * @default "linear"
+     */
+    curve?: ChartCurve;
+    /**
+     * Stacks the series on top of each other
+     * @default false
+     */
+    stacked?: boolean;
+    /**
+     * Scales the stacks to 100% (with `stacked`)
+     * @default false
+     */
+    percent?: boolean;
 }
-/** Props of BarChart */
-export interface BarChartProps extends ChartCommonProps {
+/** Props of AreaChart */
+export interface AreaChartProps extends ChartCommonProps {
+    /** Series drawn as areas unless they set a `type` */
+    series: readonly ChartSeries[];
+    /**
+     * Shape of the edges: straight, smooth (monotone) or steps
+     * @default "smooth"
+     */
+    curve?: ChartCurve;
+    /**
+     * Stacks the areas on top of each other
+     * @default false
+     */
+    stacked?: boolean;
+    /**
+     * Scales the stacks to 100% (implies `stacked`)
+     * @default false
+     */
+    percent?: boolean;
+}
+/**
+ * Props of BarChart (`labels` writes the values: override the tooltip texts
+ * with `tooltip.labels`)
+ */
+export interface BarChartProps extends Omit<ChartCommonProps, "labels"> {
     /** Series drawn as bars unless they set a `type` (e.g. a `line` overlay) */
     series: readonly ChartSeries[];
     /**
@@ -98,6 +160,137 @@ export interface BarChartProps extends ChartCommonProps {
      * @default false
      */
     stacked?: boolean;
+    /**
+     * Scales the stacks to 100% (implies `stacked`)
+     * @default false
+     */
+    percent?: boolean;
+    /**
+     * Writes the value above every bar
+     * @default false
+     */
+    labels?: boolean;
+    /**
+     * `horizontal` draws the bars from the left, the categories down the left side
+     * @default "vertical"
+     */
+    orientation?: ChartOrientation;
+}
+/** Props of HorizontalBarChart */
+export interface HorizontalBarChartProps extends Omit<BarChartProps, "orientation"> {
+    /**
+     * Series drawn as bars from the left unless they set a `type`; the x
+     * values (categories) run from top to bottom
+     */
+    series: readonly ChartSeries[];
+}
+/** Props of RangeAreaChart */
+export interface RangeAreaChartProps extends ChartCommonProps {
+    /**
+     * Bands between `y0` (lower edge) and `y` (upper edge) of every point,
+     * unless a series sets a `type` (e.g. a `line` for the forecast itself)
+     */
+    series: readonly ChartSeries[];
+    /**
+     * Shape of the edges: straight, smooth (monotone) or steps
+     * @default "smooth"
+     */
+    curve?: ChartCurve;
+}
+/** Props of MixedChart */
+export interface MixedChartProps extends ChartProps {
+    /**
+     * Bars, lines, areas and dots, each with its `type`; `yAxis: "right"`
+     * plots a series against `yAxis2`
+     */
+    series: readonly ChartSeries[];
+}
+/** Props of BubbleChart */
+export interface BubbleChartProps extends ChartCommonProps, BubbleOptions {
+    /** Series of points with a `value` sizing their bubble (area ∝ value) */
+    series: readonly ChartSeries[];
+}
+/** Props of HistogramChart */
+export interface HistogramChartProps extends ChartCommonProps, BinOptions {
+    /** Raw samples (typed arrays are counted without copies) */
+    values: ArrayLike<number>;
+    /**
+     * Name of the counts (legend, tooltip)
+     * @default "Count"
+     */
+    name?: string;
+    /** Bar color (any CSS color) */
+    color?: string;
+    /** Formats the edges of the bins in the tooltip */
+    formatBin?: (value: number) => string;
+    /** More series drawn over the bins (e.g. a density `line`) */
+    series?: readonly ChartSeries[];
+}
+/** Props of BoxPlotChart */
+export interface BoxPlotChartProps extends ChartCommonProps, BoxplotStatsOptions {
+    /**
+     * Series of box plots: data points with `low`, `q1`, `y` (the median),
+     * `q3`, `high` and `outliers` (see `boxplotData` / `boxplotStats`)
+     */
+    series?: readonly ChartSeries[];
+    /** Raw samples, one box each (an alternative to `series`) */
+    groups?: readonly BoxplotGroup[];
+    /**
+     * Name of the series built from `groups`
+     * @default "Values"
+     */
+    name?: string;
+    /**
+     * `horizontal` lays the boxes out in rows
+     * @default "vertical"
+     */
+    orientation?: ChartOrientation;
+}
+/** Props of WaterfallChart */
+export interface WaterfallChartProps extends Omit<ChartCommonProps, "crosshair" | "labels">, Omit<WaterfallOptions, "labels"> {
+    /** Changes, subtotals and totals, in order */
+    steps: readonly WaterfallStep[];
+    /**
+     * Writes the change (or the total) at the end of every bar
+     * @default true
+     */
+    labels?: boolean;
+    /**
+     * `horizontal` lays the steps out in rows
+     * @default "vertical"
+     */
+    orientation?: ChartOrientation;
+}
+/** Props of GanttChart */
+export interface GanttChartProps extends Omit<ChartCommonProps, "crosshair">, GanttOptions {
+    /** Tasks and milestones, from top to bottom */
+    tasks: readonly GanttTask[];
+    /**
+     * Draws a line at this date (`true`: now)
+     * @default false
+     */
+    today?: boolean | number | Date;
+    /** Label of the today line */
+    todayLabel?: string;
+}
+/** Props of CandlestickChart */
+export interface CandlestickChartProps extends ChartCommonProps {
+    /**
+     * Series drawn as candles unless they set a `type` (e.g. a moving average
+     * `line`); data points carry `open`, `high`, `low` and `y` (the close)
+     */
+    series: readonly ChartSeries[];
+}
+/** Props of HeatmapChart */
+export interface HeatmapChartProps extends Omit<ChartCommonProps, "crosshair">, HeatmapConfig {
+}
+/** Props of Sparkline */
+export interface SparklineProps extends Pick<ChartCommonProps, "width" | "renderer" | "tooltip" | "palette" | "ariaLabel" | "locale" | "labels" | "onHover" | "renderTooltip" | "className" | "style" | "ref">, SparklineConfig {
+    /**
+     * Height of the sparkline; numbers are pixels
+     * @default 48
+     */
+    height?: number | string;
 }
 /** Props of ScatterChart */
 export interface ScatterChartProps extends ChartCommonProps {