minerva-design 1.2.0 → 1.4.0

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;

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"three-d.js","names":["isPlainObject","value","proto","shallowEqual","keys","a","b","key","sameValue","v","i","sameOptions3D","sa","sb","s","cssSize","fallback","Chart3DBase","handlers","containerRef","useRef","chartRef","handlersRef","stable","setStable","useState","options","optionsRef","useEffect","container","chart","createChart3D","offs","c","r","off","useImperativeHandle","handleRef","camera","width","height","style","Chart3DFrame","props","ref","Scatter3DChart","input","series","useMemo","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":"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"}

package/dist/charts/react/trading.cjs

@@ -0,0 +1,2 @@
+"use client";const e=require("../engine/trading/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=>Object.prototype.hasOwnProperty.call(t,n)&&a(e[n],t[n]))},a=(e,t)=>e===t||Array.isArray(e)&&Array.isArray(t)&&e.length===t.length&&e.every((e,n)=>e===t[n]),o=(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[n])&&i(e,t[n])):r(e)&&r(t)&&i(e,t),s=(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]:o(e[n],t[n]):!1)},c=(e,t)=>e===void 0?t:typeof e==`number`?`${e}px`:e;function l(r){let{height:i,width:a,className:o,style:l,ref:u,onCrosshairMove:d,onClick:f,onVisibleRangeChange:p,onOrderMove:m,onDrawingsChange:h,onDrawingSelect:g,onDrawingToolChange:_,onIndicatorToggle:v,onHistoryRequest:y,onRendererChange:b,...x}=r,S={onCrosshairMove:d,onClick:f,onVisibleRangeChange:p,onOrderMove:m,onDrawingsChange:h,onDrawingSelect:g,onDrawingToolChange:_,onIndicatorToggle:v,onHistoryRequest:y,onRendererChange:b},C=(0,t.useRef)(null),w=(0,t.useRef)(null),T=(0,t.useRef)(S),[E,D]=(0,t.useState)(x);E!==x&&!s(E,x)&&D(x);let O=(0,t.useRef)(E);return(0,t.useEffect)(()=>{T.current=S}),(0,t.useEffect)(()=>{let t=C.current;if(!t)return;let n=e.createTradingChart(t,O.current);w.current=n;let r=()=>T.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(),w.current=null}},[]),(0,t.useEffect)(()=>{O.current!==E&&(O.current=E,w.current?.setOptions(E))},[E]),(0,t.useImperativeHandle)(u,()=>({update:e=>w.current?.update(e),appendBars:e=>w.current?.appendBars(e),prependBars:e=>w.current?.prependBars(e),setBars:e=>w.current?.setBars(e),getBarCount:()=>w.current?.getBarCount()??0,getBar:e=>w.current?.getBar(e)??null,scrollToRealtime:e=>w.current?.scrollToRealtime(e),fitContent:()=>w.current?.fitContent(),getVisibleRange:()=>w.current?.getVisibleRange()??null,setVisibleRange:e=>w.current?.setVisibleRange(e),resetPriceScales:()=>w.current?.resetPriceScales(),setDrawingTool:e=>w.current?.setDrawingTool(e),getDrawings:()=>w.current?.getDrawings()??[],removeDrawing:e=>w.current?.removeDrawing(e),selectDrawing:e=>w.current?.selectDrawing(e),setIndicatorVisible:(e,t)=>w.current?.setIndicatorVisible(e,t),getRenderer:()=>w.current?.getRenderer()??null,getInstance:()=>w.current}),[]),(0,n.jsx)(`div`,{className:o,style:{position:`relative`,width:c(a,`100%`),height:c(i,`480px`),...l},children:(0,n.jsx)(`div`,{ref:C,style:{position:`absolute`,inset:0}})})}exports.TradingChart=l;
+//# sourceMappingURL=trading.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"trading.cjs","names":["useRef","useState","createTradingChart","require_chart","react","react_jsx_runtime","isPlainObject","value","proto","shallowEqual","keys","a","b","key","sameItem","v","i","sameValue","sameOptions","size","fallback","TradingChart","options","props","handlers","containerRef","chartRef","handlersRef","stable","setStable","optionsRef","container","chart","h","offs","off","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/trading.d.cts

@@ -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.cjs';
+import { ChartRendererKind } from '../engine/types.cjs';
+/** 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;