velo-plot 2.20.0 → 3.1.0

package/dist/bindings/test-utils/mockLifecycle.d.ts

@@ -0,0 +1,120 @@
+import { vi } from 'vitest';
+
+export declare function createMockChartLifecycle(): {
+    chart: import('../..').Chart & {
+        destroy: ReturnType<typeof vi.fn>;
+        addSeries: ReturnType<typeof vi.fn>;
+        updateSeries: ReturnType<typeof vi.fn>;
+        removeSeries: ReturnType<typeof vi.fn>;
+        on: ReturnType<typeof vi.fn>;
+        off: ReturnType<typeof vi.fn>;
+        zoom: ReturnType<typeof vi.fn>;
+        resetZoom: ReturnType<typeof vi.fn>;
+        autoScale: ReturnType<typeof vi.fn>;
+        enableCursor: ReturnType<typeof vi.fn>;
+        disableCursor: ReturnType<typeof vi.fn>;
+        setTheme: ReturnType<typeof vi.fn>;
+        updateXAxis: ReturnType<typeof vi.fn>;
+        updateYAxis: ReturnType<typeof vi.fn>;
+        resize: ReturnType<typeof vi.fn>;
+        getViewBounds: ReturnType<typeof vi.fn>;
+        getAllSeries: ReturnType<typeof vi.fn>;
+    };
+    destroy: import('vitest').Mock<(...args: any[]) => any>;
+    handle: {
+        chart: import('../..').Chart & {
+            destroy: ReturnType<typeof vi.fn>;
+            addSeries: ReturnType<typeof vi.fn>;
+            updateSeries: ReturnType<typeof vi.fn>;
+            removeSeries: ReturnType<typeof vi.fn>;
+            on: ReturnType<typeof vi.fn>;
+            off: ReturnType<typeof vi.fn>;
+            zoom: ReturnType<typeof vi.fn>;
+            resetZoom: ReturnType<typeof vi.fn>;
+            autoScale: ReturnType<typeof vi.fn>;
+            enableCursor: ReturnType<typeof vi.fn>;
+            disableCursor: ReturnType<typeof vi.fn>;
+            setTheme: ReturnType<typeof vi.fn>;
+            updateXAxis: ReturnType<typeof vi.fn>;
+            updateYAxis: ReturnType<typeof vi.fn>;
+            resize: ReturnType<typeof vi.fn>;
+            getViewBounds: ReturnType<typeof vi.fn>;
+            getAllSeries: ReturnType<typeof vi.fn>;
+        };
+        getBounds: () => import('../..').Bounds;
+        destroy: import('vitest').Mock<(...args: any[]) => any>;
+    };
+};
+export declare function mockChartLifecycleModule(): {
+    createChartLifecycle: import('vitest').Mock<() => {
+        chart: import('../..').Chart & {
+            destroy: ReturnType<typeof vi.fn>;
+            addSeries: ReturnType<typeof vi.fn>;
+            updateSeries: ReturnType<typeof vi.fn>;
+            removeSeries: ReturnType<typeof vi.fn>;
+            on: ReturnType<typeof vi.fn>;
+            off: ReturnType<typeof vi.fn>;
+            zoom: ReturnType<typeof vi.fn>;
+            resetZoom: ReturnType<typeof vi.fn>;
+            autoScale: ReturnType<typeof vi.fn>;
+            enableCursor: ReturnType<typeof vi.fn>;
+            disableCursor: ReturnType<typeof vi.fn>;
+            setTheme: ReturnType<typeof vi.fn>;
+            updateXAxis: ReturnType<typeof vi.fn>;
+            updateYAxis: ReturnType<typeof vi.fn>;
+            resize: ReturnType<typeof vi.fn>;
+            getViewBounds: ReturnType<typeof vi.fn>;
+            getAllSeries: ReturnType<typeof vi.fn>;
+        };
+        getBounds: () => import('../..').Bounds;
+        destroy: import('vitest').Mock<(...args: any[]) => any>;
+    }>;
+    pickSyncableOptions: (o: object) => object;
+    optionsChanged: () => boolean;
+    syncChartOptions: import('vitest').Mock<(...args: any[]) => any>;
+    lifecycle: {
+        chart: import('../..').Chart & {
+            destroy: ReturnType<typeof vi.fn>;
+            addSeries: ReturnType<typeof vi.fn>;
+            updateSeries: ReturnType<typeof vi.fn>;
+            removeSeries: ReturnType<typeof vi.fn>;
+            on: ReturnType<typeof vi.fn>;
+            off: ReturnType<typeof vi.fn>;
+            zoom: ReturnType<typeof vi.fn>;
+            resetZoom: ReturnType<typeof vi.fn>;
+            autoScale: ReturnType<typeof vi.fn>;
+            enableCursor: ReturnType<typeof vi.fn>;
+            disableCursor: ReturnType<typeof vi.fn>;
+            setTheme: ReturnType<typeof vi.fn>;
+            updateXAxis: ReturnType<typeof vi.fn>;
+            updateYAxis: ReturnType<typeof vi.fn>;
+            resize: ReturnType<typeof vi.fn>;
+            getViewBounds: ReturnType<typeof vi.fn>;
+            getAllSeries: ReturnType<typeof vi.fn>;
+        };
+        destroy: import('vitest').Mock<(...args: any[]) => any>;
+        handle: {
+            chart: import('../..').Chart & {
+                destroy: ReturnType<typeof vi.fn>;
+                addSeries: ReturnType<typeof vi.fn>;
+                updateSeries: ReturnType<typeof vi.fn>;
+                removeSeries: ReturnType<typeof vi.fn>;
+                on: ReturnType<typeof vi.fn>;
+                off: ReturnType<typeof vi.fn>;
+                zoom: ReturnType<typeof vi.fn>;
+                resetZoom: ReturnType<typeof vi.fn>;
+                autoScale: ReturnType<typeof vi.fn>;
+                enableCursor: ReturnType<typeof vi.fn>;
+                disableCursor: ReturnType<typeof vi.fn>;
+                setTheme: ReturnType<typeof vi.fn>;
+                updateXAxis: ReturnType<typeof vi.fn>;
+                updateYAxis: ReturnType<typeof vi.fn>;
+                resize: ReturnType<typeof vi.fn>;
+                getViewBounds: ReturnType<typeof vi.fn>;
+                getAllSeries: ReturnType<typeof vi.fn>;
+            };
+            getBounds: () => import('../..').Bounds;
+            destroy: import('vitest').Mock<(...args: any[]) => any>;
+        };
+    };
+};

package/dist/bindings/test-utils/vitestSveltePlugin.d.ts

@@ -0,0 +1,3 @@
+import { Plugin } from 'vite';
+
+export declare function vitestSvelte(): Plugin;

package/dist/chartSyncBridge-D_rCtbFq.js

@@ -0,0 +1,58 @@
+import { c as s } from "./ChartCore-AnR_3Xkb.js";
+import { a as d } from "./createStackedChart-DqcLCFGS.js";
+import { c as u } from "./index-CaXWSOTk.js";
+function c(e) {
+  const r = e.responsive ?? { reducedMotion: "auto" };
+  return { ...e, responsive: r };
+}
+function C(e, r, o = {}) {
+  const t = s({
+    ...c(r),
+    container: e
+  }), i = () => {
+    var a;
+    (a = o.onBoundsChange) == null || a.call(o, t.getViewBounds());
+  };
+  t.on("zoom", i);
+  let n;
+  return r.autoResize !== !1 && (n = new ResizeObserver(() => {
+    t.resize();
+  }), n.observe(e)), {
+    chart: t,
+    getBounds: () => t.getViewBounds(),
+    destroy: () => {
+      n == null || n.disconnect(), t.off("zoom", i), t.destroy();
+    }
+  };
+}
+function f(e) {
+  return e != null && "getPanes" in e && typeof e.getPanes == "function";
+}
+async function h(e, r, o = {}) {
+  if (!e)
+    throw new Error(
+      "[useIndicator] Chart is not ready. Wait for isReady before adding indicators."
+    );
+  return f(e) ? await e.addIndicator(r, o) : d(e, r, o);
+}
+function p(e, r) {
+  for (const o of [...e.getAllSeries()]) {
+    const t = o.getId();
+    (t === r || t.startsWith(`${r}-`)) && e.removeSeries(t);
+  }
+}
+function v(e, r) {
+  const o = u(e, r);
+  return {
+    group: o,
+    destroy: () => o.destroy()
+  };
+}
+export {
+  h as a,
+  v as b,
+  C as c,
+  f as i,
+  p as r
+};
+//# sourceMappingURL=chartSyncBridge-D_rCtbFq.js.map

package/dist/chartSyncBridge-D_rCtbFq.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chartSyncBridge-D_rCtbFq.js","sources":["../src/bindings/shared/chartLifecycle.ts","../src/bindings/shared/indicatorBridge.ts","../src/bindings/shared/chartSyncBridge.ts"],"sourcesContent":["/**\n * Framework-agnostic chart lifecycle helpers.\n */\n\nimport { createChart, type Chart } from \"../../core/Chart\";\nimport type { ChartOptions, Bounds } from \"../../types\";\nimport type { BindingChartOptions } from \"./types\";\n\nexport type ChartBindingOptions = Omit<ChartOptions, \"container\"> &\n  BindingChartOptions;\n\nexport interface ChartLifecycleHandle {\n  chart: Chart;\n  destroy: () => void;\n  getBounds: () => Bounds | null;\n}\n\nexport interface ChartLifecycleCallbacks {\n  onBoundsChange?: (bounds: Bounds) => void;\n  onError?: (error: Error) => void;\n}\n\nfunction defaultResponsive(\n  options: ChartBindingOptions,\n): ChartBindingOptions {\n  const responsive = options.responsive ?? { reducedMotion: \"auto\" as const };\n  return { ...options, responsive };\n}\n\nexport function createChartLifecycle(\n  container: HTMLDivElement,\n  options: ChartBindingOptions,\n  callbacks: ChartLifecycleCallbacks = {},\n): ChartLifecycleHandle {\n  const chart = createChart({\n    ...defaultResponsive(options),\n    container,\n  });\n\n  const onZoom = () => {\n    callbacks.onBoundsChange?.(chart.getViewBounds());\n  };\n  chart.on(\"zoom\", onZoom);\n\n  let resizeObserver: ResizeObserver | undefined;\n  if (options.autoResize !== false) {\n    resizeObserver = new ResizeObserver(() => {\n      chart.resize();\n    });\n    resizeObserver.observe(container);\n  }\n\n  return {\n    chart,\n    getBounds: () => chart.getViewBounds(),\n    destroy: () => {\n      resizeObserver?.disconnect();\n      chart.off(\"zoom\", onZoom);\n      chart.destroy();\n    },\n  };\n}\n\nexport function attachZoomListener(\n  chart: Chart,\n  onBoundsChange: (bounds: Bounds) => void,\n): () => void {\n  const handler = () => onBoundsChange(chart.getViewBounds());\n  chart.on(\"zoom\", handler);\n  return () => chart.off(\"zoom\", handler);\n}\n","/**\n * Indicator bridge for framework bindings.\n */\n\nimport type { Chart } from \"../../core/chart/types\";\nimport type { StackedChart } from \"../../core/stacked/types\";\nimport {\n  addIndicatorToChart,\n  type AddIndicatorOptions,\n  type AddIndicatorResult,\n} from \"../../core/indicator/addIndicator\";\nimport type { IndicatorPresetName } from \"../../core/indicator/indicatorPresets\";\n\nexport type IndicatorHost = Chart | StackedChart | null;\n\nexport function isStackedChart(host: IndicatorHost): host is StackedChart {\n  return (\n    host != null &&\n    \"getPanes\" in host &&\n    typeof (host as StackedChart).getPanes === \"function\"\n  );\n}\n\nexport async function addIndicatorToHost(\n  host: IndicatorHost,\n  preset: IndicatorPresetName,\n  options: AddIndicatorOptions = {},\n): Promise<AddIndicatorResult & { paneId?: string }> {\n  if (!host) {\n    throw new Error(\n      \"[useIndicator] Chart is not ready. Wait for isReady before adding indicators.\",\n    );\n  }\n\n  if (isStackedChart(host)) {\n    const result = await host.addIndicator(preset, options);\n    return result;\n  }\n\n  return addIndicatorToChart(host, preset, options);\n}\n\nexport function removeIndicatorFromChart(\n  chart: Chart,\n  rootId: string,\n): void {\n  for (const s of [...chart.getAllSeries()]) {\n    const sid = s.getId();\n    if (sid === rootId || sid.startsWith(`${rootId}-`)) {\n      chart.removeSeries(sid);\n    }\n  }\n}\n","/**\n * Chart sync bridge for framework bindings.\n */\n\nimport {\n  ChartGroup,\n  createChartGroup,\n  type ChartLike,\n  type SyncOptions,\n} from \"../../core/sync\";\n\nexport interface ChartSyncHandle {\n  group: ChartGroup;\n  destroy: () => void;\n}\n\nexport function createChartSync(\n  charts: ChartLike[],\n  options?: SyncOptions,\n): ChartSyncHandle {\n  const group = createChartGroup(charts, options);\n  return {\n    group,\n    destroy: () => group.destroy(),\n  };\n}\n\nexport function updateChartSync(\n  handle: ChartSyncHandle | null,\n  charts: ChartLike[],\n  options?: SyncOptions,\n): ChartSyncHandle {\n  handle?.destroy();\n  if (charts.length < 2) {\n    return { group: new ChartGroup(options), destroy: () => {} };\n  }\n  return createChartSync(charts, options);\n}\n"],"names":["defaultResponsive","options","responsive","createChartLifecycle","container","callbacks","chart","createChart","onZoom","_a","resizeObserver","isStackedChart","host","addIndicatorToHost","preset","addIndicatorToChart","removeIndicatorFromChart","rootId","s","sid","createChartSync","charts","group","createChartGroup"],"mappings":";;;AAsBA,SAASA,EACPC,GACqB;AACrB,QAAMC,IAAaD,EAAQ,cAAc,EAAE,eAAe,OAAA;AAC1D,SAAO,EAAE,GAAGA,GAAS,YAAAC,EAAA;AACvB;AAEO,SAASC,EACdC,GACAH,GACAI,IAAqC,CAAA,GACf;AACtB,QAAMC,IAAQC,EAAY;AAAA,IACxB,GAAGP,EAAkBC,CAAO;AAAA,IAC5B,WAAAG;AAAA,EAAA,CACD,GAEKI,IAAS,MAAM;;AACnB,KAAAC,IAAAJ,EAAU,mBAAV,QAAAI,EAAA,KAAAJ,GAA2BC,EAAM;EACnC;AACA,EAAAA,EAAM,GAAG,QAAQE,CAAM;AAEvB,MAAIE;AACJ,SAAIT,EAAQ,eAAe,OACzBS,IAAiB,IAAI,eAAe,MAAM;AACxC,IAAAJ,EAAM,OAAA;AAAA,EACR,CAAC,GACDI,EAAe,QAAQN,CAAS,IAG3B;AAAA,IACL,OAAAE;AAAA,IACA,WAAW,MAAMA,EAAM,cAAA;AAAA,IACvB,SAAS,MAAM;AACb,MAAAI,KAAA,QAAAA,EAAgB,cAChBJ,EAAM,IAAI,QAAQE,CAAM,GACxBF,EAAM,QAAA;AAAA,IACR;AAAA,EAAA;AAEJ;AC9CO,SAASK,EAAeC,GAA2C;AACxE,SACEA,KAAQ,QACR,cAAcA,KACd,OAAQA,EAAsB,YAAa;AAE/C;AAEA,eAAsBC,EACpBD,GACAE,GACAb,IAA+B,CAAA,GACoB;AACnD,MAAI,CAACW;AACH,UAAM,IAAI;AAAA,MACR;AAAA,IAAA;AAIJ,SAAID,EAAeC,CAAI,IACN,MAAMA,EAAK,aAAaE,GAAQb,CAAO,IAIjDc,EAAoBH,GAAME,GAAQb,CAAO;AAClD;AAEO,SAASe,EACdV,GACAW,GACM;AACN,aAAWC,KAAK,CAAC,GAAGZ,EAAM,aAAA,CAAc,GAAG;AACzC,UAAMa,IAAMD,EAAE,MAAA;AACd,KAAIC,MAAQF,KAAUE,EAAI,WAAW,GAAGF,CAAM,GAAG,MAC/CX,EAAM,aAAaa,CAAG;AAAA,EAE1B;AACF;ACpCO,SAASC,EACdC,GACApB,GACiB;AACjB,QAAMqB,IAAQC,EAAiBF,GAAQpB,CAAO;AAC9C,SAAO;AAAA,IACL,OAAAqB;AAAA,IACA,SAAS,MAAMA,EAAM,QAAA;AAAA,EAAQ;AAEjC;"}

package/dist/core/Chart.d.ts

@@ -1,5 +1,5 @@
 /**
- * Chart - Main Sci Plot Entry Point
+ * Chart - Main Velo Plot Entry Point
  *
  * This file re-exports the chart API from the modular implementation.
  * For the core implementation, see ./chart/ChartCore.ts

package/dist/core/ChartStatistics.d.ts

@@ -11,7 +11,7 @@ export declare class ChartStatistics {
     constructor(parent: HTMLElement, theme: ChartTheme, series: Map<string, Series>);
     private isDarkTheme;
     private updateContainerStyle;
-    update(viewBounds: Bounds): void;
+    update(viewBounds: Bounds): Promise<void>;
     toggle(): void;
     updateTheme(theme: ChartTheme): void;
     destroy(): void;

package/dist/core/InteractionManager.d.ts

@@ -29,6 +29,8 @@ export interface InteractionCallbacks {
     onDragStart?: () => void;
     /** Called when any drag operation ends */
     onDragEnd?: () => void;
+    /** Called on double-tap (mobile reset zoom) */
+    onDoubleTap?: () => void;
     /** Called for all raw interaction events for plugin processing */
     onInteraction?: (event: import('../plugins/types').InteractionEvent) => void;
 }
@@ -61,6 +63,10 @@ export declare class InteractionManager {
     private lastMousePos;
     private mouseDownPos;
     private mode;
+    private pinchStartDistance;
+    private pinchStartBounds;
+    private lastTapTime;
+    private readonly doubleTapMs;
     private boundWheel;
     private boundMouseDown;
     private boundMouseMove;
@@ -74,7 +80,7 @@ export declare class InteractionManager {
     private detachListeners;
     /**
      * Set the interaction mode
-     * @deprecated Use setMode instead
+     * @deprecated Use setMode instead. **Removed in v4.0.**
      */
     setPanMode(enabled: boolean): void;
     /**

package/dist/core/OverlayRenderer.d.ts

@@ -15,6 +15,11 @@ export declare class OverlayRenderer {
     /** Filter X ticks to valid business-day indices (unique integers in range). */
     private filterBusinessDayXTicks;
     private resolveXTicks;
+    /**
+     * Grid X lines use the full viewport domain (nice even spacing), including
+     * regions past the loaded series. Axis labels stay filtered to real data.
+     */
+    private resolveGridXTicks;
     /**
      * Set LaTeX API for rendering mathematical expressions
      */

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

@@ -1,7 +1,7 @@
 /**
  * Annotation Types
  *
- * Type definitions for all annotation types supported by Sci Plot.
+ * Type definitions for all annotation types supported by Velo Plot.
  */
 export type AnnotationType = 'horizontal-line' | 'vertical-line' | 'rectangle' | 'band' | 'text' | 'arrow';
 export interface BaseAnnotation {

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

@@ -9,11 +9,11 @@ import { ResponsiveConfig, ResponsiveState } from '../responsive';
 import { ChartState, SerializeOptions, DeserializeOptions } from '../../serialization';
 import { Chart, ExportOptions } from './types';
 import { ChartAnimationConfig } from '../animation';
-import { AddIndicatorOptions, AddIndicatorResult, IndicatorPresetName } from '../indicator/addIndicator';
-import { PriceAlertOptions } from './ChartAlerts';
-import { PositionLineOptions } from './positionLines';
+import { ChartFeatureHooks } from './ChartFeatureHooks';
 
 export declare class ChartImpl implements Chart {
+    /** Optional hook for extended bundles (WebGPU, etc.). */
+    static afterConstruct: ((chart: ChartImpl, options: ChartOptions) => void) | null;
     private container;
     private webglCanvas;
     private overlayCanvas;
@@ -35,7 +35,6 @@ export declare class ChartImpl implements Chart {
     private plotAreaBackground;
     private renderer;
     private activeRendererType;
-    private rendererInitPromise;
     private overlay;
     private interaction;
     private xScale;
@@ -103,9 +102,8 @@ export declare class ChartImpl implements Chart {
     get animations(): ChartAnimationConfig;
     private selectionManager;
     private responsiveManager;
-    private alertManager;
+    private featureHooks;
     private timeScaleMapping;
-    private positionLineCounter;
     constructor(options: ChartOptions);
     /**
      * Start the chart initialization (called by queue system)
@@ -142,6 +140,7 @@ export declare class ChartImpl implements Chart {
     };
     private getInteractedBounds;
     exportImage(type?: "png" | "jpeg"): string;
+    setFeatureHooks(hooks: ChartFeatureHooks | null): void;
     exportSVG(): string;
     private getSeriesContext;
     addSeries(options: SeriesOptions | HeatmapOptions): void;
@@ -156,17 +155,14 @@ export declare class ChartImpl implements Chart {
      * Add a line of best fit to a series
      */
     addFitLine(seriesId: string, type: any, options?: any): string;
-    /**
-     * Calculate and render a trading indicator preset (RSI, MACD, Bollinger, EMA, SMA).
-     * For stacked layouts use buildIndicatorPaneFromPreset() when creating panes.
-     */
-    addIndicator(preset: IndicatorPresetName, options?: AddIndicatorOptions): Promise<AddIndicatorResult>;
-    addAlert(options: PriceAlertOptions): string;
-    removeAlert(id: string): boolean;
+    private tradingRequired;
+    addIndicator(_preset: import('../indicator/addIndicator').IndicatorPresetName, _options?: import('../indicator/addIndicator').AddIndicatorOptions): Promise<import('../indicator/addIndicator').AddIndicatorResult>;
+    addAlert(_options: import('./ChartAlerts').PriceAlertOptions): string;
+    removeAlert(_id: string): boolean;
     clearAlerts(): void;
-    getAlerts(): PriceAlertOptions[];
-    addPositionLine(options: PositionLineOptions): string;
-    setDrawingMode(mode: import('../../plugins/drawing-tools').DrawingMode): void;
+    getAlerts(): import('./ChartAlerts').PriceAlertOptions[];
+    addPositionLine(_options: import('./positionLines').PositionLineOptions): string;
+    setDrawingMode(_mode: import('../../plugins/drawing-tools').DrawingMode): void;
     getSeries(id: string): Series | undefined;
     getAllSeries(): Series[];
     private getNavContext;
@@ -241,7 +237,6 @@ export declare class ChartImpl implements Chart {
     getDPR(): number;
     /** Runtime chart renderer backend in use. */
     getActiveRenderer(): "webgl" | "webgpu";
-    private initGpuRenderer;
     /**
      * Set device pixel ratio and re-render
      */
@@ -308,7 +303,7 @@ export declare class ChartImpl implements Chart {
     configureSelection(config: Partial<SelectionConfig>): void;
     /**
      * Set pan mode (true = pan, false = selection)
-     * @deprecated Use setMode('pan') or setMode('select') instead
+     * @deprecated Use setMode('pan') or setMode('select') instead. **Removed in v4.0.**
      */
     setPanMode(enabled: boolean): void;
     /**
@@ -365,7 +360,7 @@ export declare class ChartImpl implements Chart {
      * 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. */
+    /** @deprecated Use CSS transform on pane wrapper during drag; canvas stays untouched. **Removed in v4.0.** */
     syncDragLayout(width?: number, height?: number): void;
     isResizeSuspended(): boolean;
     resize(): void;

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

@@ -0,0 +1,7 @@
+import { PriceAlertOptions } from './ChartAlerts';
+
+export interface ChartFeatureHooks {
+    onDataUpdate?: () => void;
+    getAlerts?: () => PriceAlertOptions[];
+    destroy?: () => void;
+}

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

@@ -0,0 +1,2 @@
+/** Restore sync SVG export on Chart (trading/scientific/full bundles). */
+export declare function patchExportSVG(): void;

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

@@ -0,0 +1,7 @@
+import { Series } from '../Series';
+import { PlotArea } from '../../types';
+
+export type OverlaySeriesDrawer = (overlayCtx: CanvasRenderingContext2D, series: Series, plotArea: PlotArea) => void;
+export declare function registerOverlaySeriesDrawer(type: string, drawer: OverlaySeriesDrawer): void;
+export declare function getOverlaySeriesDrawer(type: string): OverlaySeriesDrawer | undefined;
+export declare function drawRegisteredOverlaySeries(overlayCtx: CanvasRenderingContext2D, series: Iterable<Series>, plotArea: PlotArea): void;

package/dist/core/chart/series/SeriesActions.d.ts

@@ -2,6 +2,7 @@ import { SeriesOptions, HeatmapOptions, SeriesUpdateData } from '../../../types'
 
 export declare function addSeries(ctx: any, options: SeriesOptions | HeatmapOptions): void;
 export declare function removeSeries(ctx: any, id: string): void;
+export declare function registerSeriesDataPreprocessor(fn: (ctx: unknown, data: SeriesUpdateData) => SeriesUpdateData): void;
 export declare function updateSeries(ctx: any, id: string, data: SeriesUpdateData): void;
 export declare function appendData(ctx: any, id: string, x: number[] | Float32Array, y: number[] | Float32Array): void;
 export declare function setMaxPoints(ctx: any, id: string, maxPoints: number): void;

package/dist/core/chart/series/SeriesBufferLite.d.ts

@@ -0,0 +1,13 @@
+import { Series } from '../../Series';
+
+export declare function updateSeriesBufferLite(ctx: {
+    renderer: {
+        createBuffer(id: string, data: Float32Array): void;
+    } | null;
+}, s: Series): void;
+export declare function refreshStackLite(ctx: {
+    renderer: {
+        createBuffer(id: string, data: Float32Array): void;
+    } | null;
+    series: Map<string, Series>;
+}, stackId: string): void;

package/dist/core/chart/series/seriesOptionsRegistry.d.ts

@@ -0,0 +1,8 @@
+import { HeatmapOptions, SeriesOptions } from '../../../types';
+
+export type SeriesOptionsPreprocessor = (ctx: unknown, options: SeriesOptions | HeatmapOptions) => SeriesOptions | HeatmapOptions;
+export type SeriesOptionsExpander = (options: SeriesOptions | HeatmapOptions) => Array<SeriesOptions | HeatmapOptions>;
+export declare function registerSeriesOptionsPreprocessor(fn: SeriesOptionsPreprocessor): void;
+export declare function registerSeriesOptionsExpander(fn: SeriesOptionsExpander): void;
+export declare function applySeriesOptionsPreprocessors(ctx: unknown, options: SeriesOptions | HeatmapOptions): SeriesOptions | HeatmapOptions;
+export declare function expandSeriesOptions(options: SeriesOptions | HeatmapOptions): Array<SeriesOptions | HeatmapOptions>;

package/dist/core/chart/series/seriesTypeRegistry.d.ts

@@ -0,0 +1,5 @@
+import { Series } from '../../Series';
+
+export type SeriesBufferHandler = (ctx: unknown, s: Series) => void;
+export declare function registerSeriesBufferHandler(type: string, handler: SeriesBufferHandler): void;
+export declare function getSeriesBufferHandler(type: string): SeriesBufferHandler | undefined;

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

@@ -144,7 +144,7 @@ export interface Chart {
     configureSelection(config: any): void;
     /**
      * Set pan mode (true = pan, false = selection)
-     * @deprecated Use setMode('pan') or setMode('select') instead
+     * @deprecated Use setMode('pan') or setMode('select') instead. **Removed in v4.0.**
      */
     setPanMode(enabled: boolean): void;
     /**

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

@@ -1,5 +1,5 @@
 /**
- * Sci Plot - Clipboard Module
+ * Velo Plot - Clipboard Module
  *
  * Provides clipboard operations for copying chart data to various formats.
  * Supports copying selected points, visible data, or all data.

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

@@ -1,5 +1,5 @@
 /**
- * Sci Plot - Debug Overlay Module
+ * Velo Plot - Debug Overlay Module
  *
  * Provides a visual debug overlay showing performance metrics,
  * rendering info, and chart state for development and debugging.

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

@@ -1,5 +1,5 @@
 /**
- * Sci Plot - Keyboard Shortcuts Module
+ * Velo Plot - Keyboard Shortcuts Module
  *
  * Provides customizable keyboard shortcuts for chart interactions.
  * Supports key combinations, custom actions, and enable/disable per key.

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

@@ -1,5 +1,5 @@
 /**
- * Sci Plot - Loading Indicator Module
+ * Velo Plot - Loading Indicator Module
  *
  * Provides visual loading/progress indicators for chart operations.
  * Supports progress bars, spinners, and skeleton placeholders.

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

@@ -1,5 +1,5 @@
 /**
- * Sci Plot - Internationalization (i18n) Module
+ * Velo Plot - Internationalization (i18n) Module
  *
  * Provides locale-aware formatting for numbers, dates, and chart UI.
  * Supports custom format functions and predefined locales.

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

@@ -14,6 +14,9 @@ export interface PaneResizeOptions {
     onDragMove?: (sizesPx: number[], leadingIdx: number, trailingIdx: number) => void;
     onDragEnd?: (finalSizesPx: number[]) => void;
 }
+export declare function injectDividerStyles(direction: StackDirection): void;
+export declare function measurePaneSizes(paneWrappers: HTMLDivElement[], isHorizontal: boolean): number[];
+export declare function resolveDragStartSizes(onDragStart: PaneResizeOptions["onDragStart"], leadingIdx: number, trailingIdx: number, paneWrappers: HTMLDivElement[], isHorizontal: boolean): number[];
 export interface PaneResizeController {
     dividers: HTMLDivElement[];
     destroy: () => void;

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

@@ -37,6 +37,12 @@ export interface StackedChartOptions {
     sharedXAxis?: "bottom" | "none";
     /** Shared Y axis on left pane only (horizontal layout) */
     sharedYAxis?: "left" | "none";
+    /**
+     * Shared X-axis defaults applied to every pane (e.g. `type: 'time'`, timeScale).
+     * Per-pane `chart.xAxis` overrides these. Visibility (labels/ticks/line) is still
+     * controlled by `sharedXAxis` / `showXAxis`.
+     */
+    xAxis?: Omit<NonNullable<RootChartOptions["xAxis"]>, "showLabels" | "showTicks" | "showLine">;
     /** Shared theme applied to every pane */
     theme?: string | object;
     devicePixelRatio?: number;
@@ -64,6 +70,10 @@ export interface StackedChartOptions {
 export interface StackedChart {
     readonly container: HTMLDivElement;
     getPane(id: string): Chart | undefined;
+    /**
+     * @deprecated Prefer `getPane(id)`. Alias kept for docs / Trading Experience. **Removed in v4.0.**
+     */
+    getChart(id: string): Chart | undefined;
     getPanes(): Chart[];
     getMaster(): Chart;
     getGroup(): ChartGroup;

package/dist/core/theme-editor/index.d.ts

@@ -1,5 +1,5 @@
 /**
- * Sci Plot - Theme Editor Module
+ * Velo Plot - Theme Editor Module
  *
  * Provides a visual theme editor for customizing chart appearance:
  * - Color pickers for all theme elements