minerva-design 1.3.0 → 1.5.0

package/dist/charts/react/trading.js

@@ -0,0 +1,126 @@
+"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: _, onOrderCreate: v, onOrderCancel: y, onDrawingsChange: b, onDrawingSelect: x, onDrawingToolChange: S, onUndoChange: C, onReplayChange: w, onFullscreenChange: T, onIndicatorToggle: E, onHistoryRequest: D, onRendererChange: O, ...k } = o, A = {
+		onCrosshairMove: m,
+		onClick: h,
+		onVisibleRangeChange: g,
+		onOrderMove: _,
+		onOrderCreate: v,
+		onOrderCancel: y,
+		onDrawingsChange: b,
+		onDrawingSelect: x,
+		onDrawingToolChange: S,
+		onUndoChange: C,
+		onReplayChange: w,
+		onFullscreenChange: T,
+		onIndicatorToggle: E,
+		onHistoryRequest: D,
+		onRendererChange: O
+	}, j = r(null), M = r(null), N = r(A), [P, F] = i(k);
+	P !== k && !u(P, k) && F(k);
+	let I = r(P);
+	return t(() => {
+		N.current = A;
+	}), t(() => {
+		let t = j.current;
+		if (!t) return;
+		let n = e(t, I.current);
+		M.current = n;
+		let r = () => N.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("orderCreate", (e) => r().onOrderCreate?.(e)),
+			n.on("orderCancel", (e) => r().onOrderCancel?.(e)),
+			n.on("drawingsChange", (e) => r().onDrawingsChange?.(e)),
+			n.on("drawingSelect", (e) => r().onDrawingSelect?.(e)),
+			n.on("drawingToolChange", (e) => r().onDrawingToolChange?.(e)),
+			n.on("undoChange", (e) => r().onUndoChange?.(e)),
+			n.on("replayChange", (e) => r().onReplayChange?.(e)),
+			n.on("fullscreenChange", (e) => r().onFullscreenChange?.(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(), M.current = null;
+		};
+	}, []), t(() => {
+		I.current !== P && (I.current = P, M.current?.setOptions(P));
+	}, [P]), n(p, () => ({
+		update: (e) => M.current?.update(e),
+		appendBars: (e) => M.current?.appendBars(e),
+		prependBars: (e) => M.current?.prependBars(e),
+		setBars: (e) => M.current?.setBars(e),
+		getBarCount: () => M.current?.getBarCount() ?? 0,
+		getBar: (e) => M.current?.getBar(e) ?? null,
+		scrollToRealtime: (e) => M.current?.scrollToRealtime(e),
+		fitContent: () => M.current?.fitContent(),
+		getVisibleRange: () => M.current?.getVisibleRange() ?? null,
+		setVisibleRange: (e) => M.current?.setVisibleRange(e),
+		getVisibleTimeRange: () => M.current?.getVisibleTimeRange() ?? null,
+		setVisibleTimeRange: (e) => M.current?.setVisibleTimeRange(e),
+		setCrosshair: (e, t) => M.current?.setCrosshair(e, t),
+		setScaleMode: (e) => M.current?.setScaleMode(e),
+		resetPriceScales: () => M.current?.resetPriceScales(),
+		setDrawingTool: (e) => M.current?.setDrawingTool(e),
+		getDrawings: () => M.current?.getDrawings() ?? [],
+		removeDrawing: (e) => M.current?.removeDrawing(e),
+		updateDrawing: (e, t) => M.current?.updateDrawing(e, t),
+		selectDrawing: (e) => M.current?.selectDrawing(e),
+		undo: () => M.current?.undo(),
+		redo: () => M.current?.redo(),
+		getUndoState: () => M.current?.getUndoState() ?? {
+			canUndo: !1,
+			canRedo: !1
+		},
+		startReplay: (e) => M.current?.startReplay(e),
+		replayStep: (e) => M.current?.replayStep(e),
+		replayPlay: (e) => M.current?.replayPlay(e),
+		replayPause: () => M.current?.replayPause(),
+		stopReplay: () => M.current?.stopReplay(),
+		getReplayState: () => M.current?.getReplayState() ?? null,
+		toDataURL: (e, t) => M.current?.toDataURL(e, t) ?? "",
+		toBlob: (e, t) => M.current?.toBlob(e, t) ?? Promise.resolve(null),
+		requestFullscreen: () => M.current?.requestFullscreen() ?? Promise.resolve(),
+		exitFullscreen: () => M.current?.exitFullscreen() ?? Promise.resolve(),
+		setIndicatorVisible: (e, t) => M.current?.setIndicatorVisible(e, t),
+		getRenderer: () => M.current?.getRenderer() ?? null,
+		getInstance: () => M.current
+	}), []), /* @__PURE__ */ a("div", {
+		className: l,
+		style: {
+			position: "relative",
+			width: d(c, "100%"),
+			height: d(s, "480px"),
+			...f
+		},
+		children: /* @__PURE__ */ a("div", {
+			ref: j,
+			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","time","price","mode","tool","id","patch","count","speed","type","quality","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  TradingDrawingPatch,\n  TradingDrawingTool,\n  TradingHistoryRequestEvent,\n  TradingIndicatorToggleEvent,\n  TradingOrderCancelEvent,\n  TradingOrderCreateEvent,\n  TradingOrderMoveEvent,\n  TradingReplayState,\n  TradingScaleMode,\n  TradingUndoState,\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  /** Times at the edges of the plot, `null` before mounting */\n  getVisibleTimeRange(): { from: number; to: number } | null;\n  /** Shows the bars between two times */\n  setVisibleTimeRange(range: { from: number; to: number }): void;\n  /** Shows the crosshair at a time (and a price); `null` hides it */\n  setCrosshair(time: number | null, price?: number): void;\n  /** Sets the price scale of the price pane */\n  setScaleMode(mode: TradingScaleMode): 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  /** Changes the style or the content of a drawing (undoable) */\n  updateDrawing(id: string, patch: TradingDrawingPatch): void;\n  /** Selects a drawing (`null` clears the selection) */\n  selectDrawing(id: string | null): void;\n  /** Undoes the last change of the drawings */\n  undo(): void;\n  /** Redoes the last undone change of the drawings */\n  redo(): void;\n  /** Whether the drawings can be undone or redone */\n  getUndoState(): TradingUndoState;\n  /** Starts a bar replay after `time` (the user picks the bar without it) */\n  startReplay(time?: number): void;\n  /** Shows the next bars of the replay */\n  replayStep(count?: number): void;\n  /** Plays the replay at `speed` bars per second */\n  replayPlay(speed?: number): void;\n  /** Pauses the replay */\n  replayPause(): void;\n  /** Ends the replay and shows every bar */\n  stopReplay(): void;\n  /** State of the bar replay, `null` before mounting */\n  getReplayState(): TradingReplayState | null;\n  /** Image of the chart as a data URL (`\"\"` before mounting) */\n  toDataURL(type?: string, quality?: number): string;\n  /** Image of the chart as a blob */\n  toBlob(type?: string, quality?: number): Promise<Blob | null>;\n  /** Shows the chart full screen */\n  requestFullscreen(): Promise<void>;\n  /** Leaves full screen */\n  exitFullscreen(): Promise<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 \"+\" order entry button was clicked (see `orderEntry`) */\n  onOrderCreate?: (event: TradingOrderCreateEvent) => void;\n  /** The close button of a `cancellable` price line was clicked */\n  onOrderCancel?: (event: TradingOrderCancelEvent) => 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  /** Undo / redo of the drawings became possible or impossible */\n  onUndoChange?: (state: TradingUndoState) => void;\n  /** The bar replay started, stepped, played, paused or stopped */\n  onReplayChange?: (state: TradingReplayState) => void;\n  /** The chart entered (`true`) or left full screen */\n  onFullscreenChange?: (fullscreen: boolean) => 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  | \"onOrderCreate\"\n  | \"onOrderCancel\"\n  | \"onDrawingsChange\"\n  | \"onDrawingSelect\"\n  | \"onDrawingToolChange\"\n  | \"onUndoChange\"\n  | \"onReplayChange\"\n  | \"onFullscreenChange\"\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    onOrderCreate,\n    onOrderCancel,\n    onDrawingsChange,\n    onDrawingSelect,\n    onDrawingToolChange,\n    onUndoChange,\n    onReplayChange,\n    onFullscreenChange,\n    onIndicatorToggle,\n    onHistoryRequest,\n    onRendererChange,\n    ...options\n  } = props;\n  const handlers: Handlers = {\n    onCrosshairMove,\n    onClick,\n    onVisibleRangeChange,\n    onOrderMove,\n    onOrderCreate,\n    onOrderCancel,\n    onDrawingsChange,\n    onDrawingSelect,\n    onDrawingToolChange,\n    onUndoChange,\n    onReplayChange,\n    onFullscreenChange,\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(\"orderCreate\", (e) => h().onOrderCreate?.(e)),\n      chart.on(\"orderCancel\", (e) => h().onOrderCancel?.(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(\"undoChange\", (e) => h().onUndoChange?.(e)),\n      chart.on(\"replayChange\", (e) => h().onReplayChange?.(e)),\n      chart.on(\"fullscreenChange\", (e) => h().onFullscreenChange?.(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      getVisibleTimeRange: () =>\n        chartRef.current?.getVisibleTimeRange() ?? null,\n      setVisibleTimeRange: (range) =>\n        chartRef.current?.setVisibleTimeRange(range),\n      setCrosshair: (time, price) =>\n        chartRef.current?.setCrosshair(time, price),\n      setScaleMode: (mode) => chartRef.current?.setScaleMode(mode),\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      updateDrawing: (id, patch) => chartRef.current?.updateDrawing(id, patch),\n      selectDrawing: (id) => chartRef.current?.selectDrawing(id),\n      undo: () => chartRef.current?.undo(),\n      redo: () => chartRef.current?.redo(),\n      getUndoState: () =>\n        chartRef.current?.getUndoState() ?? { canUndo: false, canRedo: false },\n      startReplay: (time) => chartRef.current?.startReplay(time),\n      replayStep: (count) => chartRef.current?.replayStep(count),\n      replayPlay: (speed) => chartRef.current?.replayPlay(speed),\n      replayPause: () => chartRef.current?.replayPause(),\n      stopReplay: () => chartRef.current?.stopReplay(),\n      getReplayState: () => chartRef.current?.getReplayState() ?? null,\n      toDataURL: (type, quality) =>\n        chartRef.current?.toDataURL(type, quality) ?? \"\",\n      toBlob: (type, quality) =>\n        chartRef.current?.toBlob(type, quality) ?? Promise.resolve(null),\n      requestFullscreen: () =>\n        chartRef.current?.requestFullscreen() ?? Promise.resolve(),\n      exitFullscreen: () =>\n        chartRef.current?.exitFullscreen() ?? Promise.resolve(),\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, ChartCurve, ChartHoverEvent, ChartInstance, ChartLegendOptions, ChartInteractionOptions, ChartPadding, ChartPlotClickEvent, ChartRendererKind, ChartRendererPreference, ChartSeries, ChartTooltipOptions, ChartView } from '../engine/types.cjs';
-import { HeatmapConfig, QuadrantConfig, QuadrantCorner, QuadrantPoint, SparklineConfig } from '../engine/presets.cjs';
-export type { HeatmapCell, HeatmapConfig, QuadrantAxisLabels, QuadrantConfig, QuadrantCorner, QuadrantPoint, QuadrantRegion, QuadrantRegions, SparklineConfig, } 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,7 +82,7 @@ export interface ChartCommonProps {
     /** Imperative handle */
     ref?: Ref<ChartHandle>;
 }
-/** Props of Chart: any mix of line, area, bar, scatter, candlestick and heatmap 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[];
@@ -83,6 +91,17 @@ export interface ChartProps extends ChartCommonProps {
      * @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 {
@@ -129,8 +148,11 @@ export interface AreaChartProps extends ChartCommonProps {
      */
     percent?: boolean;
 }
-/** Props of BarChart */
-export interface BarChartProps extends ChartCommonProps {
+/**
+ * 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[];
     /**
@@ -148,6 +170,119 @@ export interface BarChartProps extends ChartCommonProps {
      * @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;
+    /**
+     * Outliers drawn as rings of the series color or as filled dots (series
+     * may set their own `outlierShape`)
+     * @default "hollow"
+     */
+    outlierShape?: "hollow" | "filled";
+    /**
+     * Diameter of the outliers in CSS pixels
+     * @default 7
+     */
+    outlierSize?: number;
+}
+/** 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 {
@@ -161,7 +296,7 @@ export interface CandlestickChartProps extends ChartCommonProps {
 export interface HeatmapChartProps extends Omit<ChartCommonProps, "crosshair">, HeatmapConfig {
 }
 /** Props of Sparkline */
-export interface SparklineProps extends Pick<ChartCommonProps, "width" | "renderer" | "tooltip" | "palette" | "ariaLabel" | "onHover" | "renderTooltip" | "className" | "style" | "ref">, SparklineConfig {
+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

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

@@ -1,7 +1,7 @@
 import { CSSProperties, ReactNode, Ref } from 'react';
-import { ChartAnnotation, ChartAxisOptions, ChartCurve, ChartHoverEvent, ChartInstance, ChartLegendOptions, ChartInteractionOptions, ChartPadding, ChartPlotClickEvent, ChartRendererKind, ChartRendererPreference, ChartSeries, ChartTooltipOptions, ChartView } from '../engine/types.js';
-import { HeatmapConfig, QuadrantConfig, QuadrantCorner, QuadrantPoint, SparklineConfig } from '../engine/presets.js';
-export type { HeatmapCell, HeatmapConfig, QuadrantAxisLabels, QuadrantConfig, QuadrantCorner, QuadrantPoint, QuadrantRegion, QuadrantRegions, SparklineConfig, } from '../engine/presets.js';
+import { ChartAnnotation, ChartAxisOptions, ChartCurve, ChartHoverEvent, ChartInstance, ChartLabels, ChartLegendOptions, ChartInteractionOptions, ChartOrientation, ChartPadding, ChartPlotClickEvent, ChartRendererKind, ChartRendererPreference, ChartSeries, ChartTooltipOptions, ChartView } from '../engine/types.js';
+import { BinOptions, BoxplotGroup, BoxplotStatsOptions, BubbleOptions, GanttOptions, GanttTask, HeatmapConfig, QuadrantConfig, QuadrantCorner, QuadrantPoint, SparklineConfig, WaterfallOptions, WaterfallStep } from '../engine/presets.js';
+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.js';
 /** 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,7 +82,7 @@ export interface ChartCommonProps {
     /** Imperative handle */
     ref?: Ref<ChartHandle>;
 }
-/** Props of Chart: any mix of line, area, bar, scatter, candlestick and heatmap 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[];
@@ -83,6 +91,17 @@ export interface ChartProps extends ChartCommonProps {
      * @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 {
@@ -129,8 +148,11 @@ export interface AreaChartProps extends ChartCommonProps {
      */
     percent?: boolean;
 }
-/** Props of BarChart */
-export interface BarChartProps extends ChartCommonProps {
+/**
+ * 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[];
     /**
@@ -148,6 +170,119 @@ export interface BarChartProps extends ChartCommonProps {
      * @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;
+    /**
+     * Outliers drawn as rings of the series color or as filled dots (series
+     * may set their own `outlierShape`)
+     * @default "hollow"
+     */
+    outlierShape?: "hollow" | "filled";
+    /**
+     * Diameter of the outliers in CSS pixels
+     * @default 7
+     */
+    outlierSize?: number;
+}
+/** 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 {
@@ -161,7 +296,7 @@ export interface CandlestickChartProps extends ChartCommonProps {
 export interface HeatmapChartProps extends Omit<ChartCommonProps, "crosshair">, HeatmapConfig {
 }
 /** Props of Sparkline */
-export interface SparklineProps extends Pick<ChartCommonProps, "width" | "renderer" | "tooltip" | "palette" | "ariaLabel" | "onHover" | "renderTooltip" | "className" | "style" | "ref">, SparklineConfig {
+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