velo-plot 2.20.0 → 3.0.0

package/dist/bindings/shared/a11y.d.ts

@@ -0,0 +1,26 @@
+import { Bounds } from '../../types';
+import { VeloPlotSeries } from './types';
+import { KeyBindingManager } from '../../core/keybindings';
+
+export interface A11yOptions {
+    label?: string;
+    series?: VeloPlotSeries[];
+    bounds?: Bounds | null;
+    enableKeyboard?: boolean;
+}
+export interface A11yHandle {
+    keyboard?: KeyBindingManager;
+    srTable?: HTMLTableElement;
+    cleanup: () => void;
+}
+export declare function buildAriaLabel(series?: VeloPlotSeries[], bounds?: Bounds | null, customLabel?: string): string;
+export declare function applyChartA11y(container: HTMLElement, chart: {
+    resetZoom?: () => void;
+    zoom?: (opts: {
+        x?: [number, number];
+        y?: [number, number];
+    }) => void;
+    pan?: (dx: number, dy: number) => void;
+    getViewBounds?: () => Bounds;
+}, options?: A11yOptions): A11yHandle;
+export declare function updateA11y(container: HTMLElement, srTable: HTMLTableElement | undefined, options: A11yOptions): void;

package/dist/bindings/shared/chartLifecycle.d.ts

@@ -0,0 +1,16 @@
+import { Chart } from '../../core/Chart';
+import { ChartOptions, Bounds } from '../../types';
+import { BindingChartOptions } from './types';
+
+export type ChartBindingOptions = Omit<ChartOptions, "container"> & BindingChartOptions;
+export interface ChartLifecycleHandle {
+    chart: Chart;
+    destroy: () => void;
+    getBounds: () => Bounds | null;
+}
+export interface ChartLifecycleCallbacks {
+    onBoundsChange?: (bounds: Bounds) => void;
+    onError?: (error: Error) => void;
+}
+export declare function createChartLifecycle(container: HTMLDivElement, options: ChartBindingOptions, callbacks?: ChartLifecycleCallbacks): ChartLifecycleHandle;
+export declare function attachZoomListener(chart: Chart, onBoundsChange: (bounds: Bounds) => void): () => void;

package/dist/bindings/shared/chartSyncBridge.d.ts

@@ -0,0 +1,8 @@
+import { ChartGroup, ChartLike, SyncOptions } from '../../core/sync';
+
+export interface ChartSyncHandle {
+    group: ChartGroup;
+    destroy: () => void;
+}
+export declare function createChartSync(charts: ChartLike[], options?: SyncOptions): ChartSyncHandle;
+export declare function updateChartSync(handle: ChartSyncHandle | null, charts: ChartLike[], options?: SyncOptions): ChartSyncHandle;

package/dist/bindings/shared/dimensions.d.ts

@@ -0,0 +1 @@
+export declare function formatBindingDimension(value: number | string): string;

package/dist/bindings/shared/index.d.ts

@@ -0,0 +1,9 @@
+export * from './types';
+export * from './chartLifecycle';
+export * from './seriesDiff';
+export * from './optionsSync';
+export * from './stackedSync';
+export * from './indicatorBridge';
+export * from './chartSyncBridge';
+export * from './a11y';
+export * from './dimensions';

package/dist/bindings/shared/indicatorBridge.d.ts

@@ -0,0 +1,11 @@
+import { Chart } from '../../core/chart/types';
+import { StackedChart } from '../../core/stacked/types';
+import { AddIndicatorOptions, AddIndicatorResult } from '../../core/indicator/addIndicator';
+import { IndicatorPresetName } from '../../core/indicator/indicatorPresets';
+
+export type IndicatorHost = Chart | StackedChart | null;
+export declare function isStackedChart(host: IndicatorHost): host is StackedChart;
+export declare function addIndicatorToHost(host: IndicatorHost, preset: IndicatorPresetName, options?: AddIndicatorOptions): Promise<AddIndicatorResult & {
+    paneId?: string;
+}>;
+export declare function removeIndicatorFromChart(chart: Chart, rootId: string): void;

package/dist/bindings/shared/optionsSync.d.ts

@@ -0,0 +1,7 @@
+import { Chart } from '../../core/chart/types';
+import { ChartOptions } from '../../types';
+
+export type SyncableChartOptions = Omit<ChartOptions, "container">;
+export declare function optionsChanged(prev: SyncableChartOptions, next: SyncableChartOptions): boolean;
+export declare function syncChartOptions(chart: Chart, prev: SyncableChartOptions, next: SyncableChartOptions): void;
+export declare function pickSyncableOptions(options: SyncableChartOptions): SyncableChartOptions;

package/dist/bindings/shared/seriesDiff.d.ts

@@ -0,0 +1,8 @@
+import { SeriesOptions } from '../../types';
+import { ChartSeriesActions, VeloPlotSeries } from './types';
+
+export declare function veloPlotSeriesToOptions(series: VeloPlotSeries): SeriesOptions;
+export declare function diffSeries(chart: ChartSeriesActions, current: VeloPlotSeries[], previous: Map<string, VeloPlotSeries>): Map<string, VeloPlotSeries>;
+export declare function serializePaneIds(panes: {
+    id: string;
+}[]): string;

package/dist/bindings/shared/stackedSync.d.ts

@@ -0,0 +1,9 @@
+import { StackedChart, StackedChartOptions, StackedPaneConfig } from '../../core/stacked/types';
+import { VeloPlotSeries } from './types';
+
+export type SyncableStackedOptions = Omit<StackedChartOptions, "container">;
+export declare function stackedStructureKey(panes: StackedPaneConfig[]): string;
+export declare function syncStackedTheme(stack: StackedChart, theme: StackedChartOptions["theme"]): void;
+export declare function syncStackedSyncOptions(stack: StackedChart, sync: StackedChartOptions["sync"]): void;
+export declare function syncStackedPaneSeries(stack: StackedChart, panes: StackedPaneConfig[], previousSeries: Map<string, Map<string, VeloPlotSeries>>): Map<string, Map<string, VeloPlotSeries>>;
+export declare function syncStackedOptions(stack: StackedChart, options: SyncableStackedOptions): void;

package/dist/bindings/shared/types.d.ts

@@ -0,0 +1,46 @@
+import { SeriesOptions, SeriesUpdateData, HeatmapData } from '../../types';
+
+export type VeloPlotSeriesType = "line" | "candlestick" | "bar" | "heatmap";
+export interface VeloPlotSeriesBase {
+    id: string;
+    type?: VeloPlotSeriesType;
+    color?: string;
+    width?: number;
+    visible?: boolean;
+    name?: string;
+}
+export interface VeloPlotLineSeries extends VeloPlotSeriesBase {
+    type?: "line";
+    x: Float32Array | Float64Array;
+    y: Float32Array | Float64Array;
+}
+export interface VeloPlotCandlestickSeries extends VeloPlotSeriesBase {
+    type: "candlestick";
+    x: Float32Array | Float64Array;
+    open: Float32Array | Float64Array;
+    high: Float32Array | Float64Array;
+    low: Float32Array | Float64Array;
+    close: Float32Array | Float64Array;
+}
+export interface VeloPlotBarSeries extends VeloPlotSeriesBase {
+    type: "bar";
+    x: Float32Array | Float64Array;
+    y: Float32Array | Float64Array;
+}
+export interface VeloPlotHeatmapSeries extends VeloPlotSeriesBase {
+    type: "heatmap";
+    data: HeatmapData;
+}
+export type VeloPlotSeries = VeloPlotLineSeries | VeloPlotCandlestickSeries | VeloPlotBarSeries | VeloPlotHeatmapSeries;
+export interface ChartSeriesActions {
+    addSeries: (options: SeriesOptions) => void;
+    updateSeries: (id: string, data: SeriesUpdateData) => void;
+    removeSeries: (id: string) => void;
+    autoScale?: () => void;
+}
+export interface BindingChartOptions {
+    autoResize?: boolean;
+    responsive?: boolean | {
+        reducedMotion?: boolean | "auto";
+    };
+}

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

@@ -0,0 +1,35 @@
+import { vi } from 'vitest';
+import { Chart } from '../../core/chart/types';
+
+export declare function createMockContainer(): HTMLDivElement;
+export declare function sampleLineData(n?: number): {
+    x: Float32Array;
+    y: Float32Array;
+};
+export declare function sampleOhlcData(n?: number): {
+    x: Float32Array;
+    open: Float32Array;
+    high: Float32Array;
+    low: Float32Array;
+    close: Float32Array;
+};
+export declare function buildMockChart(id?: string): 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>;
+};
+export declare function expectDestroyCalled(destroyFn: ReturnType<typeof vi.fn>): void;

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-DbWrwtyP.js

@@ -0,0 +1,57 @@
+import { c as a, k as d } from "./ChartCore-BpzRvN4Y.js";
+import { c as u } from "./index-CaXWSOTk.js";
+function c(e) {
+  const r = e.responsive ?? { reducedMotion: "auto" };
+  return { ...e, responsive: r };
+}
+function y(e, r, o = {}) {
+  const t = a({
+    ...c(r),
+    container: e
+  }), i = () => {
+    var s;
+    (s = o.onBoundsChange) == null || s.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 C(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 h(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 {
+  C as a,
+  v as b,
+  y as c,
+  f as i,
+  h as r
+};
+//# sourceMappingURL=chartSyncBridge-DbWrwtyP.js.map

package/dist/chartSyncBridge-DbWrwtyP.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chartSyncBridge-DbWrwtyP.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/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

@@ -308,7 +308,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 +365,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/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