velo-plot 1.11.1 → 1.12.0

package/README.md

@@ -22,12 +22,31 @@ A high-performance, WebGL-powered scientific charting engine built for precision
 
 ## 🛠️ Installation
 
+**Requirements:** Node.js **24+**, pnpm **11+** (enforced via `packageManager` in `package.json`).
+
+```bash
+# Enable pnpm via Corepack (recommended)
+corepack enable
+corepack prepare pnpm@11.9.0 --activate
+
+# Or install pnpm: https://pnpm.io/installation
+```
+
 ```bash
-npm install velo-plot
-# or
 pnpm add velo-plot
 ```
 
+### Development (this repo)
+
+```bash
+git clone https://github.com/jigonzalez930209/velo-plot.git
+cd velo-plot
+pnpm install
+pnpm test
+pnpm build
+pnpm docs:dev
+```
+
 ## 🚀 Quick Examples
 
 ### React (Recommended)

package/dist/axisFormat-B7o_uIEA.js

@@ -0,0 +1,127 @@
+var l = Object.defineProperty;
+var h = (r, e, t) => e in r ? l(r, e, { enumerable: !0, configurable: !0, writable: !0, value: t }) : r[e] = t;
+var s = (r, e, t) => h(r, typeof e != "symbol" ? e + "" : e, t);
+class S {
+  constructor() {
+    s(this, "listeners", /* @__PURE__ */ new Map());
+  }
+  /**
+   * Subscribe to an event
+   */
+  on(e, t) {
+    this.listeners.has(e) || this.listeners.set(e, /* @__PURE__ */ new Set()), this.listeners.get(e).add(t);
+  }
+  /**
+   * Unsubscribe from an event
+   */
+  off(e, t) {
+    const i = this.listeners.get(e);
+    i && i.delete(t);
+  }
+  /**
+   * Emit an event with data
+   */
+  emit(e, t) {
+    const i = this.listeners.get(e);
+    i && i.forEach((n) => {
+      try {
+        n(t);
+      } catch (c) {
+        console.error(`[EventEmitter] Error in handler for "${String(e)}":`, c);
+      }
+    });
+  }
+  /**
+   * Subscribe to an event once
+   */
+  once(e, t) {
+    const i = (n) => {
+      this.off(e, i), t(n);
+    };
+    this.on(e, i);
+  }
+  /**
+   * Remove all listeners
+   */
+  clear() {
+    this.listeners.clear();
+  }
+  /**
+   * Get listener count for an event
+   */
+  listenerCount(e) {
+    var t;
+    return ((t = this.listeners.get(e)) == null ? void 0 : t.size) ?? 0;
+  }
+}
+const m = {
+  n: 1e-9,
+  µ: 1e-6,
+  m: 1e-3,
+  "": 1,
+  k: 1e3,
+  M: 1e6
+};
+function g(r) {
+  const e = Math.abs(r);
+  return e >= 1e6 ? "M" : e >= 1e3 ? "k" : e > 0 && e < 1e-6 ? "n" : e > 0 && e < 1e-3 ? "µ" : e > 0 && e < 1 ? "m" : "";
+}
+function u(r, e) {
+  const t = e === "auto" ? g(r) : e, i = m[t] ?? 1;
+  return `${(r / i).toPrecision(3)}${t}`;
+}
+function E(r) {
+  return r <= 1e3 * 60 * 60 * 36 ? new Intl.DateTimeFormat(void 0, {
+    day: "2-digit",
+    month: "2-digit",
+    hour: "2-digit",
+    minute: "2-digit"
+  }) : r <= 1e3 * 60 * 60 * 24 * 90 ? new Intl.DateTimeFormat(void 0, { day: "2-digit", month: "2-digit" }) : new Intl.DateTimeFormat(void 0, { month: "short", year: "2-digit" });
+}
+function T(r, e) {
+  return E(e ?? 864e5).format(new Date(r));
+}
+function a(r, e) {
+  const t = r.toExponential(e), [i, n] = t.split("e"), c = {
+    0: "⁰",
+    1: "¹",
+    2: "²",
+    3: "³",
+    4: "⁴",
+    5: "⁵",
+    6: "⁶",
+    7: "⁷",
+    8: "⁸",
+    9: "⁹",
+    "-": "⁻",
+    "+": "⁺"
+  }, d = n.replace("+", "").replace(/[0-9\-]/g, (f) => c[f] || f);
+  return `${i}e${d}`;
+}
+function b(r, e, t) {
+  if ((e == null ? void 0 : e.type) === "time")
+    return T(r, t);
+  if ((e == null ? void 0 : e.prefix) !== void 0 && e.prefix !== "")
+    return u(r, e.prefix);
+  const i = (e == null ? void 0 : e.scientific) === !0, n = (e == null ? void 0 : e.scientific) === !1, c = Math.abs(r);
+  return i || !n && c !== 0 && c < 1e-3 ? a(r, 1) : r.toFixed(3).replace(/\.?0+$/, "");
+}
+function w(r, e) {
+  if (r === 0) return "0";
+  const t = (e == null ? void 0 : e.scientific) === !0, i = (e == null ? void 0 : e.scientific) === !1, n = Math.abs(r);
+  return (e == null ? void 0 : e.prefix) !== void 0 && e.prefix !== "" ? u(r, e.prefix) : t || !i && (n < 1e-4 || n >= 1e6) ? a(r, 1) : n >= 1e3 ? r.toLocaleString(void 0, { maximumFractionDigits: 2 }) : r.toPrecision(3);
+}
+function k(r, e) {
+  return b(r, e == null ? void 0 : e.x, e == null ? void 0 : e.xSpan);
+}
+function D(r, e) {
+  return w(r, e == null ? void 0 : e.y);
+}
+export {
+  S as E,
+  D as a,
+  b,
+  w as c,
+  k as f
+};
+//# sourceMappingURL=axisFormat-B7o_uIEA.js.map

package/dist/axisFormat-B7o_uIEA.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"axisFormat-B7o_uIEA.js","sources":["../src/core/EventEmitter.ts","../src/core/format/axisFormat.ts"],"sourcesContent":["/**\n * Type-safe event emitter for chart events\n */\n\nexport class EventEmitter<EventMap extends object> {\n  private listeners: Map<keyof EventMap, Set<(data: unknown) => void>> =\n    new Map();\n\n  /**\n   * Subscribe to an event\n   */\n  on<K extends keyof EventMap>(\n    event: K,\n    handler: (data: EventMap[K]) => void\n  ): void {\n    if (!this.listeners.has(event)) {\n      this.listeners.set(event, new Set());\n    }\n    this.listeners.get(event)!.add(handler as (data: unknown) => void);\n  }\n\n  /**\n   * Unsubscribe from an event\n   */\n  off<K extends keyof EventMap>(\n    event: K,\n    handler: (data: EventMap[K]) => void\n  ): void {\n    const handlers = this.listeners.get(event);\n    if (handlers) {\n      handlers.delete(handler as (data: unknown) => void);\n    }\n  }\n\n  /**\n   * Emit an event with data\n   */\n  emit<K extends keyof EventMap>(event: K, data: EventMap[K]): void {\n    const handlers = this.listeners.get(event);\n    if (handlers) {\n      handlers.forEach((handler) => {\n        try {\n          handler(data);\n        } catch (error) {\n          console.error(`[EventEmitter] Error in handler for \"${String(event)}\":`, error);\n        }\n      });\n    }\n  }\n\n  /**\n   * Subscribe to an event once\n   */\n  once<K extends keyof EventMap>(\n    event: K,\n    handler: (data: EventMap[K]) => void\n  ): void {\n    const wrappedHandler = (data: EventMap[K]) => {\n      this.off(event, wrappedHandler);\n      handler(data);\n    };\n    this.on(event, wrappedHandler);\n  }\n\n  /**\n   * Remove all listeners\n   */\n  clear(): void {\n    this.listeners.clear();\n  }\n\n  /**\n   * Get listener count for an event\n   */\n  listenerCount(event: keyof EventMap): number {\n    return this.listeners.get(event)?.size ?? 0;\n  }\n}\n","/**\n * Shared axis tick and tooltip value formatting.\n */\nimport type { AxisOptions } from \"../../types\";\n\nconst PREFIXDivisors: Record<string, number> = {\n  n: 1e-9,\n  µ: 1e-6,\n  m: 1e-3,\n  \"\": 1,\n  k: 1e3,\n  M: 1e6,\n};\n\nexport function autoPrefixFor(value: number): NonNullable<AxisOptions[\"prefix\"]> {\n  const absVal = Math.abs(value);\n  if (absVal >= 1e6) return \"M\";\n  if (absVal >= 1e3) return \"k\";\n  if (absVal > 0 && absVal < 1e-6) return \"n\";\n  if (absVal > 0 && absVal < 1e-3) return \"µ\";\n  if (absVal > 0 && absVal < 1) return \"m\";\n  return \"\";\n}\n\nexport function applyPrefix(\n  value: number,\n  prefix: NonNullable<AxisOptions[\"prefix\"]>,\n): string {\n  const resolved = prefix === \"auto\" ? autoPrefixFor(value) : prefix;\n  const divisor = PREFIXDivisors[resolved] ?? 1;\n  const scaled = value / divisor;\n  return `${scaled.toPrecision(3)}${resolved}`;\n}\n\nexport function pickTimeFormatter(spanMs: number): Intl.DateTimeFormat {\n  if (spanMs <= 1000 * 60 * 60 * 36) {\n    return new Intl.DateTimeFormat(undefined, {\n      day: \"2-digit\",\n      month: \"2-digit\",\n      hour: \"2-digit\",\n      minute: \"2-digit\",\n    });\n  }\n  if (spanMs <= 1000 * 60 * 60 * 24 * 90) {\n    return new Intl.DateTimeFormat(undefined, { day: \"2-digit\", month: \"2-digit\" });\n  }\n  return new Intl.DateTimeFormat(undefined, { month: \"short\", year: \"2-digit\" });\n}\n\nexport function formatTimeTick(value: number, spanMs?: number): string {\n  const span = spanMs ?? 1000 * 60 * 60 * 24;\n  return pickTimeFormatter(span).format(new Date(value));\n}\n\nexport function toScientificUnicode(value: number, precision: number): string {\n  const str = value.toExponential(precision);\n  const [mantissa, exponent] = str.split(\"e\");\n\n  const superscriptMap: Record<string, string> = {\n    \"0\": \"⁰\",\n    \"1\": \"¹\",\n    \"2\": \"²\",\n    \"3\": \"³\",\n    \"4\": \"⁴\",\n    \"5\": \"⁵\",\n    \"6\": \"⁶\",\n    \"7\": \"⁷\",\n    \"8\": \"⁸\",\n    \"9\": \"⁹\",\n    \"-\": \"⁻\",\n    \"+\": \"⁺\",\n  };\n\n  const unicodeExp = exponent\n    .replace(\"+\", \"\")\n    .replace(/[0-9\\-]/g, (char) => superscriptMap[char] || char);\n\n  return `${mantissa}e${unicodeExp}`;\n}\n\nexport function formatXTickValue(\n  value: number,\n  options?: AxisOptions,\n  domainSpan?: number,\n): string {\n  if (options?.type === \"time\") {\n    return formatTimeTick(value, domainSpan);\n  }\n\n  if (options?.prefix !== undefined && options.prefix !== \"\") {\n    return applyPrefix(value, options.prefix);\n  }\n\n  const forceScientific = options?.scientific === true;\n  const forceLinear = options?.scientific === false;\n  const absVal = Math.abs(value);\n\n  if (forceScientific || (!forceLinear && absVal !== 0 && absVal < 0.001)) {\n    return toScientificUnicode(value, 1);\n  }\n\n  return value.toFixed(3).replace(/\\.?0+$/, \"\");\n}\n\nexport function formatYTickValue(value: number, options?: AxisOptions): string {\n  if (value === 0) return \"0\";\n\n  const forceScientific = options?.scientific === true;\n  const forceLinear = options?.scientific === false;\n  const absVal = Math.abs(value);\n\n  if (options?.prefix !== undefined && options.prefix !== \"\") {\n    return applyPrefix(value, options.prefix);\n  }\n\n  if (forceScientific || (!forceLinear && (absVal < 0.0001 || absVal >= 1e6))) {\n    return toScientificUnicode(value, 1);\n  }\n\n  if (absVal >= 1000) {\n    return value.toLocaleString(undefined, { maximumFractionDigits: 2 });\n  }\n\n  return value.toPrecision(3);\n}\n\nexport interface TooltipAxisFormat {\n  x?: Partial<AxisOptions>;\n  y?: Partial<AxisOptions>;\n  xSpan?: number;\n}\n\nexport function formatTooltipX(value: number, axisFormat?: TooltipAxisFormat): string {\n  return formatXTickValue(value, axisFormat?.x as AxisOptions | undefined, axisFormat?.xSpan);\n}\n\nexport function formatTooltipY(value: number, axisFormat?: TooltipAxisFormat): string {\n  return formatYTickValue(value, axisFormat?.y as AxisOptions | undefined);\n}\n"],"names":["EventEmitter","__publicField","event","handler","handlers","data","error","wrappedHandler","_a","PREFIXDivisors","autoPrefixFor","value","absVal","applyPrefix","prefix","resolved","divisor","pickTimeFormatter","spanMs","formatTimeTick","toScientificUnicode","precision","str","mantissa","exponent","superscriptMap","unicodeExp","char","formatXTickValue","options","domainSpan","forceScientific","forceLinear","formatYTickValue","formatTooltipX","axisFormat","formatTooltipY"],"mappings":"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"}

package/dist/core/OverlayRenderer.d.ts

@@ -28,7 +28,7 @@ export declare class OverlayRenderer {
     /**
      * Draw the grid
      */
-    drawGrid(plotArea: PlotArea, xScale: Scale, yScale: Scale): void;
+    drawGrid(plotArea: PlotArea, xScale: Scale, yScale: Scale, xAxisOptions?: AxisOptions, yAxisOptions?: AxisOptions): void;
     /**
      * Draw polar grid (radial circles and angular spokes)
      */
@@ -85,5 +85,4 @@ export declare class OverlayRenderer {
     private generateMinorTicks;
     private formatXTick;
     private formatYTick;
-    private toScientificUnicode;
 }

package/dist/core/OverlayRenderer.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/core/chart/ChartCore.d.ts

@@ -1,4 +1,4 @@
-import { ChartOptions, AxisOptions, SeriesOptions, HeatmapOptions, SeriesUpdateData, ZoomOptions, CursorOptions, ChartEventMap, Bounds } from '../../types';
+import { ChartOptions, AxisOptions, SeriesOptions, HeatmapOptions, SeriesUpdateData, ZoomOptions, CursorOptions, ChartEventMap, Bounds, FitOptions } from '../../types';
 import { EventEmitter } from '../EventEmitter';
 import { Series } from '../Series';
 import { Scale } from '../../scales';
@@ -44,9 +44,12 @@ export declare class ChartImpl implements Chart {
     private controls;
     private layout;
     private _isDestroyed;
+    /** When true, skip resize (stacked pane drag uses CSS scaling instead). */
+    private resizeSuspended;
     private autoScroll;
     private showStatistics;
     private initQueueId;
+    private readonly chartId;
     private commandQueue;
     private annotationQueue;
     private annotationIdCounter;
@@ -145,6 +148,8 @@ export declare class ChartImpl implements Chart {
     }): void;
     pan(deltaX: number, deltaY: number, axisId?: string): void;
     resetZoom(): void;
+    fit(options?: FitOptions): void;
+    getId(): string;
     getViewBounds(): Bounds;
     autoScale(animate?: boolean): void;
     /**
@@ -219,6 +224,10 @@ export declare class ChartImpl implements Chart {
      * Get Y axis configuration by ID
      */
     getYAxis(id: string): AxisOptions | undefined;
+    /**
+     * Get X axis configuration
+     */
+    getXAxis(): AxisOptions;
     /**
      * Get all Y axes configurations
      */
@@ -313,6 +322,13 @@ export declare class ChartImpl implements Chart {
      */
     fromUrlHash(hash: string, compressed?: boolean): void;
     use(plugin: any): Promise<void>;
+    /**
+     * Suspend canvas backing-store resize (inactive panes during stacked drag).
+     */
+    setResizeSuspended(suspended: boolean): void;
+    /** @deprecated Use CSS transform on pane wrapper during drag; canvas stays untouched. */
+    syncDragLayout(width?: number, height?: number): void;
+    isResizeSuspended(): boolean;
     resize(): void;
     requestRender(): void;
     requestOverlayRender(): void;

package/dist/core/chart/ChartRenderLoop.d.ts

@@ -75,6 +75,10 @@ export declare class ChartRenderLoop {
      * Schedule render on next animation frame
      */
     private scheduleRenderFrame;
+    /**
+     * Perform an immediate full render (used after resize to avoid flicker).
+     */
+    flushRender(): void;
     /**
      * Cancel any pending render
      */

package/dist/core/chart/ChartScaling.d.ts

@@ -5,6 +5,17 @@ import { ZoomOptions } from '../../types';
  * Auto-scale all axes to fit data
  */
 export declare function autoScaleAll(ctx: NavigationContext): void;
+/**
+ * Fit view to data or explicit ranges. Returns false when there is nothing to fit.
+ */
+export declare function fitToData(ctx: NavigationContext, options?: {
+    x?: [number, number];
+    y?: [number, number];
+    padding?: number | {
+        x?: number;
+        y?: number;
+    };
+}): boolean;
 /**
  * Auto-scale only Y-axes to fit data (keeps X-axis stable)
  * Used during streaming to prevent X-axis shifting

package/dist/core/chart/ChartScaling.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/core/chart/NavigationUtils.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Shared navigation helpers for zoom/pan behavior.
+ */
+export interface NavSeriesLike {
+    isVisible(): boolean;
+    getType(): string;
+}
+/**
+ * Pin Y minimum to 0 only for pure volume-style bar charts (bars only, no overlays).
+ * Mixed indicator panes (histogram + lines) get full Y pan/zoom freedom.
+ */
+export declare function usesVolumeBarPinning(series: Iterable<NavSeriesLike>): boolean;

package/dist/core/chart/NavigationUtils.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/core/chart/types.d.ts

@@ -1,4 +1,4 @@
-import { SeriesOptions, HeatmapOptions, SeriesUpdateData, ZoomOptions, CursorOptions, ChartEventMap, Bounds, AxisOptions } from '../../types';
+import { SeriesOptions, HeatmapOptions, SeriesUpdateData, ZoomOptions, CursorOptions, ChartEventMap, Bounds, AxisOptions, FitOptions } from '../../types';
 import { Series } from '../Series';
 import { Annotation } from '../annotations';
 import { ChartAnimationConfig } from '../animation';
@@ -21,12 +21,20 @@ export interface Chart {
     zoom(options: ZoomOptions & {
         animate?: boolean;
     }): void;
+    /** Fit view to data; no-op when series have no valid bounds */
+    fit(options?: FitOptions): void;
+    /** Stable chart id for sync groups */
+    getId(): string;
     pan(deltaX: number, deltaY: number): void;
     resetZoom(): void;
     getViewBounds(): Bounds;
     enableCursor(options: CursorOptions): void;
     disableCursor(): void;
     resize(width?: number, height?: number): void;
+    /** Pause backing-store resize — canvases scale via CSS until cleared */
+    setResizeSuspended?(suspended: boolean): void;
+    /** Re-apply CSS canvas fill after pane flex changes during drag */
+    syncDragLayout?(width?: number, height?: number): void;
     /** Get current device pixel ratio used for rendering */
     getDPR(): number;
     /** Set device pixel ratio and trigger re-render */
@@ -93,6 +101,8 @@ export interface Chart {
     updateXAxis(options: Partial<AxisOptions>): void;
     /** Get Y axis configuration by ID */
     getYAxis(id: string): AxisOptions | undefined;
+    /** Get X axis configuration */
+    getXAxis(): AxisOptions;
     /** Get all Y axes configurations */
     getAllYAxes(): AxisOptions[];
     /** Get the primary Y axis ID */

package/dist/core/format/axisFormat.d.ts

@@ -0,0 +1,16 @@
+import { AxisOptions } from '../../types';
+
+export declare function autoPrefixFor(value: number): NonNullable<AxisOptions["prefix"]>;
+export declare function applyPrefix(value: number, prefix: NonNullable<AxisOptions["prefix"]>): string;
+export declare function pickTimeFormatter(spanMs: number): Intl.DateTimeFormat;
+export declare function formatTimeTick(value: number, spanMs?: number): string;
+export declare function toScientificUnicode(value: number, precision: number): string;
+export declare function formatXTickValue(value: number, options?: AxisOptions, domainSpan?: number): string;
+export declare function formatYTickValue(value: number, options?: AxisOptions): string;
+export interface TooltipAxisFormat {
+    x?: Partial<AxisOptions>;
+    y?: Partial<AxisOptions>;
+    xSpan?: number;
+}
+export declare function formatTooltipX(value: number, axisFormat?: TooltipAxisFormat): string;
+export declare function formatTooltipY(value: number, axisFormat?: TooltipAxisFormat): string;

package/dist/core/format/axisFormat.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/core/indicator/buildIndicatorPane.d.ts

@@ -0,0 +1,22 @@
+import { Range } from '../../types';
+import { StackedPaneConfig } from '../stacked/types';
+import { IndicatorData, IndicatorStyle } from './types';
+
+export interface BuildIndicatorPaneOptions {
+    id: string;
+    /** Flex ratio inside createStackedChart (default 0.25) */
+    height?: number | string;
+    label?: string;
+    data: IndicatorData;
+    style?: IndicatorStyle;
+    /** Lock Y range (recommended for oscillators) */
+    yRange?: Range | "auto";
+    tickCount?: number;
+    showXAxis?: boolean;
+    seriesId?: string;
+}
+/**
+ * Build a stacked pane pre-configured for a trading indicator
+ * (histogram + lines + fills + markers).
+ */
+export declare function buildIndicatorPane(options: BuildIndicatorPaneOptions): StackedPaneConfig;

package/dist/core/indicator/buildIndicatorSeries.d.ts

@@ -0,0 +1,14 @@
+import { SeriesOptions } from '../../types';
+import { IndicatorSeriesOptions } from './types';
+
+/**
+ * Build native series options from an indicator definition.
+ * Use in any chart pane — standalone or inside createStackedChart.
+ */
+export declare function buildIndicatorSeries(options: IndicatorSeriesOptions): SeriesOptions[];
+/** Convenience: one call returns all series for chart.addSeries / stacked pane config. */
+export declare function createIndicatorSeries(options: IndicatorSeriesOptions): SeriesOptions[];
+/**
+ * Detect local extrema on a line for peak/trough markers.
+ */
+export declare function detectIndicatorMarkers(x: Float32Array | Float64Array | number[], y: Float32Array | Float64Array | number[], window?: number): import('./types').IndicatorMarker[];

package/dist/core/indicator/buildIndicatorSeries.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/core/indicator/index.d.ts

@@ -0,0 +1,3 @@
+export type { IndicatorData, IndicatorFillLayer, IndicatorHistogramLayer, IndicatorLineColorZones, IndicatorLineLayer, IndicatorMarker, IndicatorMarkerKind, IndicatorReferenceLine, IndicatorSeriesOptions, IndicatorStyle, } from './types';
+export { buildIndicatorSeries, createIndicatorSeries, detectIndicatorMarkers, } from './buildIndicatorSeries';
+export { buildIndicatorPane, type BuildIndicatorPaneOptions } from './buildIndicatorPane';

package/dist/core/indicator/types.d.ts

@@ -0,0 +1,74 @@
+export type IndicatorMarkerKind = "peak" | "trough";
+/** Two-tone line segments — buy/sell zones relative to a reference. */
+export interface IndicatorLineColorZones {
+    /** Constant Y, `'zero'`, or `id` of another line layer in the same indicator */
+    ref?: number | "zero" | string;
+    /** Color when line is at or above the reference */
+    aboveColor: string;
+    /** Color when line is below the reference */
+    belowColor: string;
+}
+export interface IndicatorLineLayer {
+    id?: string;
+    y: Float32Array | Float64Array | number[];
+    color?: string;
+    width?: number;
+    opacity?: number;
+    /** Split line into colored segments (e.g. buy above signal, sell below) */
+    colorZones?: IndicatorLineColorZones;
+}
+export interface IndicatorFillLayer {
+    id?: string;
+    upper: Float32Array | Float64Array | number[];
+    lower: Float32Array | Float64Array | number[];
+    color?: string;
+    opacity?: number;
+}
+export interface IndicatorMarker {
+    x: number;
+    y: number;
+    kind: IndicatorMarkerKind;
+    color?: string;
+    size?: number;
+}
+export interface IndicatorHistogramLayer {
+    y: Float32Array | Float64Array | number[];
+    positiveColor?: string;
+    negativeColor?: string;
+    opacity?: number;
+    barWidth?: number;
+}
+export interface IndicatorReferenceLine {
+    y: number;
+    color?: string;
+    width?: number;
+    dash?: number[];
+}
+/** Composite trading-indicator payload (histogram, lines, fills, markers). */
+export interface IndicatorData {
+    x: Float32Array | Float64Array | number[];
+    histogram?: IndicatorHistogramLayer;
+    lines?: IndicatorLineLayer[];
+    fills?: IndicatorFillLayer[];
+    markers?: IndicatorMarker[];
+    /** Baseline Y value (default 0) — rendered as dashed reference line */
+    baseline?: number;
+    referenceLines?: IndicatorReferenceLine[];
+}
+export interface IndicatorStyle {
+    baselineColor?: string;
+    baselineWidth?: number;
+    baselineDash?: number[];
+    peakColor?: string;
+    troughColor?: string;
+    peakSize?: number;
+    troughSize?: number;
+}
+export interface IndicatorSeriesOptions {
+    id: string;
+    type: "indicator";
+    data: IndicatorData;
+    style?: IndicatorStyle;
+    visible?: boolean;
+    name?: string;
+}

package/dist/core/series/SeriesBounds.d.ts

@@ -1,3 +1,3 @@
 import { SeriesData, Bounds, SeriesType, HeatmapData, PolarData } from '../../types';
 
-export declare function calculateSeriesBounds(type: SeriesType, data: SeriesData, heatmapData?: HeatmapData, polarData?: PolarData): Bounds;
+export declare function calculateSeriesBounds(type: SeriesType, data: SeriesData, heatmapData?: HeatmapData, polarData?: PolarData): Bounds | null;

package/dist/core/series/SeriesBounds.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/core/stacked/createStackedChart.d.ts

@@ -0,0 +1,3 @@
+import { StackedChart, StackedChartOptions } from './types';
+
+export declare function createStackedChart(options: StackedChartOptions): StackedChart;

package/dist/core/stacked/createStackedChart.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/core/stacked/index.d.ts

@@ -0,0 +1,4 @@
+export { createStackedChart } from './createStackedChart';
+export type { StackedChart, StackedChartOptions, StackedPaneConfig, StackedSyncOptions } from './types';
+export { STACKED_MAX_PANES, STACKED_DEFAULT_MIN_PANE_RATIO, } from './types';
+export { normalizePaneHeights, resolveMinPaneHeightPx, } from './paneResize';

package/dist/core/stacked/paneAxis.d.ts

@@ -0,0 +1,20 @@
+import { Chart } from '../chart/types';
+
+/** Adaptive Y tick count from pane height (~1 tick per 36px, capped by base). */
+export declare function tickCountForPaneHeight(heightPx: number, base?: number): number;
+/** Adaptive X tick count from pane width. */
+export declare function tickCountForPaneWidth(widthPx: number, base?: number): number;
+export interface PaneAxisMeta {
+    chart: Chart;
+    wrapper: HTMLDivElement;
+    baseYTickCount: number;
+    baseXTickCount: number;
+    showXAxis: boolean;
+}
+export declare function readBaseYTickCount(yAxis?: {
+    tickCount?: number;
+} | {
+    tickCount?: number;
+}[]): number;
+export declare function adaptPaneAxes(meta: PaneAxisMeta): void;
+export declare function adaptAllPaneAxes(metas: PaneAxisMeta[]): void;

package/dist/core/stacked/paneAxis.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/core/stacked/paneResize.d.ts

@@ -0,0 +1,32 @@
+/**
+ * VS Code–style drag dividers between stacked chart panes.
+ */
+export interface PaneResizeOptions {
+    /** Min pane height as fraction of available height (default 1/6) */
+    minPaneRatio?: number;
+    /** Absolute min pane height in px — used when larger than ratio-based min */
+    minPanePx?: number;
+    /** Divider hit area height (default 6) */
+    dividerSize?: number;
+    /** Called while dragging with normalized flex ratios keyed by pane id */
+    onResize?: (ratiosById: Record<string, number>) => void;
+    /** Called when divider drag starts — return initial pane heights for this drag session */
+    onDragStart?: (topIdx: number, bottomIdx: number) => number[];
+    /** Called each pointer move (batched to rAF by consumer) with updated heights */
+    onDragMove?: (heightsPx: number[], topIdx: number, bottomIdx: number) => void;
+    /** Called when divider drag ends — perform chart resize here */
+    onDragEnd?: (finalHeightsPx: number[]) => void;
+}
+export interface PaneResizeController {
+    dividers: HTMLDivElement[];
+    destroy: () => void;
+}
+/** Resolve per-pane minimum height in px for the current available stack height. */
+export declare function resolveMinPaneHeightPx(availHeight: number, paneCount: number, minPaneRatio?: number, minPanePx?: number): number;
+/**
+ * Scale pane heights to exactly fill available space (fixes sub-pixel gaps during drag).
+ */
+export declare function normalizePaneHeights(heightsPx: number[], targetTotal: number): number[];
+export declare function attachPaneResize(container: HTMLDivElement, paneWrappers: HTMLDivElement[], paneIds: string[], ratios: number[], options?: PaneResizeOptions): PaneResizeController;
+export declare function applyPaneFlexRatios(paneWrappers: HTMLDivElement[], ratios: number[]): void;
+export declare function initialPaneRatio(height: number | string): number;

package/dist/core/stacked/paneResize.test.d.ts

@@ -0,0 +1 @@
+export {};