velo-plot 3.0.0 → 4.0.0-alpha.1

package/dist/core/chart/exporter/svg/plugins/watermark.d.ts

@@ -0,0 +1,13 @@
+import { SVGExportPluginContext } from './types';
+
+export declare function exportWatermark(ctx: SVGExportPluginContext, text: string, options?: {
+    opacity?: number;
+    rotation?: number;
+    color?: string;
+}): void;
+export declare function exportGridHighlight(ctx: SVGExportPluginContext, bands: Array<{
+    axis: "x" | "y";
+    min: number;
+    max: number;
+    color?: string;
+}>): void;

package/dist/core/chart/exporter/svg/series/band.d.ts

@@ -0,0 +1,6 @@
+import { Series } from '../../../../Series';
+import { Scale } from '../../../../../scales';
+import { PlotArea } from '../../../../../types';
+import { SVGDocumentBuilder } from '../SVGDocumentBuilder';
+
+export declare function exportBandSeries(series: Series, plotArea: PlotArea, xScale: Scale, yScale: Scale, builder: SVGDocumentBuilder): void;

package/dist/core/chart/exporter/svg/series/bar.d.ts

@@ -0,0 +1,6 @@
+import { Series } from '../../../../Series';
+import { Scale } from '../../../../../scales';
+import { PlotArea } from '../../../../../types';
+import { SVGDocumentBuilder } from '../SVGDocumentBuilder';
+
+export declare function exportBarSeries(series: Series, plotArea: PlotArea, xScale: Scale, yScale: Scale, builder: SVGDocumentBuilder): void;

package/dist/core/chart/exporter/svg/series/boxplot.d.ts

@@ -0,0 +1,6 @@
+import { Series } from '../../../../Series';
+import { Scale } from '../../../../../scales';
+import { PlotArea } from '../../../../../types';
+import { SVGDocumentBuilder } from '../SVGDocumentBuilder';
+
+export declare function exportBoxplotSeries(series: Series, plotArea: PlotArea, xScale: Scale, yScale: Scale, builder: SVGDocumentBuilder): void;

package/dist/core/chart/exporter/svg/series/candlestick.d.ts

@@ -0,0 +1,6 @@
+import { Series } from '../../../../Series';
+import { Scale } from '../../../../../scales';
+import { PlotArea } from '../../../../../types';
+import { SVGDocumentBuilder } from '../SVGDocumentBuilder';
+
+export declare function exportCandlestickSeries(series: Series, plotArea: PlotArea, xScale: Scale, yScale: Scale, builder: SVGDocumentBuilder): void;

package/dist/core/chart/exporter/svg/series/finitePoints.d.ts

@@ -0,0 +1,6 @@
+import { Scale } from '../../../../../scales';
+
+/** Indices where x/y (and optional y2) are finite. */
+export declare function collectFiniteIndices(x: Float32Array | Float64Array, y: Float32Array | Float64Array, y2?: Float32Array | Float64Array): number[];
+/** Split finite samples into contiguous polyline segments (breaks at NaN gaps). */
+export declare function buildLineSegments(indices: number[], x: Float32Array | Float64Array, y: Float32Array | Float64Array, xScale: Scale, yScale: Scale): string[][];

package/dist/core/chart/exporter/svg/series/gauge.d.ts

@@ -0,0 +1,5 @@
+import { Series } from '../../../../Series';
+import { PlotArea } from '../../../../../types';
+import { SVGDocumentBuilder } from '../SVGDocumentBuilder';
+
+export declare function exportGaugeSeries(series: Series, plotArea: PlotArea, builder: SVGDocumentBuilder): void;

package/dist/core/chart/exporter/svg/series/heatmap.d.ts

@@ -0,0 +1,6 @@
+import { Series } from '../../../../Series';
+import { Scale } from '../../../../../scales';
+import { PlotArea } from '../../../../../types';
+import { SVGDocumentBuilder } from '../SVGDocumentBuilder';
+
+export declare function exportHeatmapSeries(series: Series, plotArea: PlotArea, xScale: Scale, yScale: Scale, builder: SVGDocumentBuilder): void;

package/dist/core/chart/exporter/svg/series/indicator.d.ts

@@ -0,0 +1,6 @@
+import { Series } from '../../../../Series';
+import { Scale } from '../../../../../scales';
+import { PlotArea } from '../../../../../types';
+import { SVGDocumentBuilder } from '../SVGDocumentBuilder';
+
+export declare function exportIndicatorSeries(series: Series, plotArea: PlotArea, xScale: Scale, yScale: Scale, builder: SVGDocumentBuilder): void;

package/dist/core/chart/exporter/svg/series/line.d.ts

@@ -0,0 +1,12 @@
+import { Series } from '../../../../Series';
+import { Scale } from '../../../../../scales';
+import { PlotArea } from '../../../../../types';
+import { SVGDocumentBuilder } from '../SVGDocumentBuilder';
+
+export declare function buildStepPoints(data: {
+    x: Float32Array | Float64Array;
+    y: Float32Array | Float64Array;
+}, xScale: Scale, yScale: Scale, stepMode: string): string[];
+export declare function exportLineSeries(series: Series, plotArea: PlotArea, xScale: Scale, yScale: Scale, builder: SVGDocumentBuilder): void;
+export declare function exportScatterPoints(series: Series, _plotArea: PlotArea, xScale: Scale, yScale: Scale, builder: SVGDocumentBuilder, skipLine?: boolean): void;
+export declare function exportScatterSeries(series: Series, plotArea: PlotArea, xScale: Scale, yScale: Scale, builder: SVGDocumentBuilder): void;

package/dist/core/chart/exporter/svg/series/polar.d.ts

@@ -0,0 +1,6 @@
+import { Series } from '../../../../Series';
+import { Scale } from '../../../../../scales';
+import { PlotArea } from '../../../../../types';
+import { SVGDocumentBuilder } from '../SVGDocumentBuilder';
+
+export declare function exportPolarSeries(series: Series, plotArea: PlotArea, xScale: Scale, yScale: Scale, builder: SVGDocumentBuilder): void;

package/dist/core/chart/exporter/svg/series/radar.d.ts

@@ -0,0 +1,5 @@
+import { SVGExportContext } from '../SVGExportContext';
+import { SVGDocumentBuilder } from '../SVGDocumentBuilder';
+import { RadarSVGExportData } from '../../../../../plugins/radar/types';
+
+export declare function exportRadarChart(ctx: SVGExportContext, builder: SVGDocumentBuilder, data: RadarSVGExportData): void;

package/dist/core/chart/exporter/svg/series/registry.d.ts

@@ -0,0 +1,10 @@
+import { SeriesType, PlotArea } from '../../../../../types';
+import { Series } from '../../../../Series';
+import { Scale } from '../../../../../scales';
+import { SVGDocumentBuilder } from '../SVGDocumentBuilder';
+import { SVGExportContext } from '../SVGExportContext';
+
+export type SeriesSVGExporter = (series: Series, plotArea: PlotArea, xScale: Scale, yScale: Scale, builder: SVGDocumentBuilder, ctx?: SVGExportContext) => void;
+export declare function getSeriesSVGExporter(type: SeriesType): SeriesSVGExporter | undefined;
+export declare function exportAllSeries(ctx: SVGExportContext, builder: SVGDocumentBuilder): void;
+export declare function getRegisteredSeriesTypes(): SeriesType[];

package/dist/core/chart/exporter/svg/series/sankey.d.ts

@@ -0,0 +1,5 @@
+import { Series } from '../../../../Series';
+import { PlotArea } from '../../../../../types';
+import { SVGDocumentBuilder } from '../SVGDocumentBuilder';
+
+export declare function exportSankeySeries(series: Series, plotArea: PlotArea, builder: SVGDocumentBuilder): void;

package/dist/core/chart/exporter/svg/series/scatter.d.ts

@@ -0,0 +1 @@
+export { exportScatterSeries } from './line';

package/dist/core/chart/exporter/svg/series/ternary.d.ts

@@ -0,0 +1,7 @@
+import { Series } from '../../../../Series';
+import { Scale } from '../../../../../scales';
+import { PlotArea } from '../../../../../types';
+import { SVGDocumentBuilder } from '../SVGDocumentBuilder';
+
+/** Ternary plot: equilateral triangle with normalized (a,b,c) components. */
+export declare function exportTernarySeries(series: Series, plotArea: PlotArea, _xScale: Scale, _yScale: Scale, builder: SVGDocumentBuilder): void;

package/dist/core/chart/exporter/svg/series/waterfall.d.ts

@@ -0,0 +1,6 @@
+import { Series } from '../../../../Series';
+import { Scale } from '../../../../../scales';
+import { PlotArea } from '../../../../../types';
+import { SVGDocumentBuilder } from '../SVGDocumentBuilder';
+
+export declare function exportWaterfallSeries(series: Series, plotArea: PlotArea, xScale: Scale, yScale: Scale, builder: SVGDocumentBuilder): void;

package/dist/core/chart/exporter/svg/seriesAtTimestamp.d.ts

@@ -0,0 +1,4 @@
+import { Series } from '../../../Series';
+
+/** Return series truncated to points with x ≤ `at` (data units). */
+export declare function filterSeriesAtTimestamp(series: Series[], at: number): Series[];

package/dist/core/chart/exporter/svg/seriesUtils.d.ts

@@ -0,0 +1,3 @@
+import { Series } from '../../../Series';
+
+export declare function seriesId(series: Series, fallback?: string): string;

package/dist/core/chart/exporter/svg/symbols.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Scatter / legend symbol paths for SVG export.
+ */
+export type ScatterSymbol = "circle" | "square" | "diamond" | "triangle" | "triangleDown" | "cross" | "x" | "star";
+export declare function symbolSvg(symbol: string, cx: number, cy: number, size: number, fill: string, opacity?: number, stroke?: string): string;

package/dist/core/chart/exporter/svg/tickUtils.d.ts

@@ -0,0 +1,9 @@
+import { Scale } from '../../../../scales';
+import { BusinessDayMapping } from '../../../time/TimeScale';
+
+export declare function generateMinorTicks(majorTicks: number[], divisions: number): number[];
+export declare function filterBusinessDayXTicks(ticks: number[], mapping: BusinessDayMapping | null | undefined): number[];
+export declare function resolveXTicks(xScale: Scale, tickCount: number, mapping?: BusinessDayMapping | null): number[];
+export declare function resolveGridXTicks(xScale: Scale, tickCount: number): number[];
+export declare function primaryYScale(yAxes: Map<string, Scale>, primaryYAxisId?: string): Scale | undefined;
+export declare function resolveYScale(yAxes: Map<string, Scale>, yAxisId: string | undefined, primaryYAxisId?: string): Scale | undefined;

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

@@ -0,0 +1,5 @@
+/**
+ * Live SVG chart frame — mounts vector output into the chart DOM.
+ */
+/** Replace children of the live SVG root from a full SVG document string. */
+export declare function mountSVGString(svgRoot: SVGSVGElement, svgString: string): 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

@@ -45,7 +45,7 @@ export interface Chart {
     /** Get current device pixel ratio used for rendering */
     getDPR(): number;
     /** Actual renderer backend in use */
-    getActiveRenderer(): "webgl" | "webgpu";
+    getActiveRenderer(): "webgl" | "webgpu" | "svg";
     /** Set device pixel ratio and trigger re-render */
     setDPR(dpr: number): void;
     /**
@@ -59,7 +59,7 @@ export interface Chart {
     destroy(): void;
     exportImage(type?: "png" | "jpeg"): string;
     /** Vector export of series, axes, grid, and tick labels */
-    exportSVG(): string;
+    exportSVG(options?: import('./exporter/SVGExporter').SVGExportOptions): string;
     autoScale(animate?: boolean): void;
     setTheme(theme: string | object): void;
     /** Access to data analysis utilities */

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

@@ -0,0 +1,14 @@
+import { Chart } from '../chart/types';
+import { StackSVGExportOptions } from './types';
+
+export interface StackSVGPaneLayout {
+    chart: Chart;
+    wrapper: HTMLElement;
+    offsetX: number;
+    offsetY: number;
+    width: number;
+    height: number;
+}
+export declare function buildStackPaneLayouts(container: HTMLDivElement, paneWrappers: HTMLDivElement[], paneCharts: Chart[]): StackSVGPaneLayout[];
+export declare function composeStackSVG(container: HTMLDivElement, paneWrappers: HTMLDivElement[], paneCharts: Chart[], dividers: HTMLElement[], options?: StackSVGExportOptions): string;
+export declare function exportStackSVG(container: HTMLDivElement, paneWrappers: HTMLDivElement[], paneCharts: Chart[], dividers: HTMLElement[], backgroundColor: string, options?: StackSVGExportOptions): string;

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

@@ -1,6 +1,7 @@
 export { createStackedChart } from './createStackedChart';
-export type { StackedChart, StackedChartOptions, StackedPaneConfig, StackedSyncOptions, StackDirection, StackSnapshotOptions, } from './types';
+export type { StackedChart, StackedChartOptions, StackedPaneConfig, StackedSyncOptions, StackDirection, StackSnapshotOptions, StackSVGExportOptions, } from './types';
 export { STACKED_MAX_PANES, STACKED_DEFAULT_MIN_PANE_RATIO, } from './types';
-export { exportStackImage } from './stackExport';
+export { exportStackImage, stackResolutionScale } from './stackExport';
+export { exportStackSVG, composeStackSVG, buildStackPaneLayouts } from './StackSVGComposer';
 export type { StackExportOptions } from './stackExport';
 export { normalizePaneHeights, resolveMinPaneHeightPx, } from './paneResize';

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

@@ -3,6 +3,7 @@ import { ChartGroup, SyncAxis, SyncOptions } from '../sync';
 import { ChartOptions as RootChartOptions, Range, SeriesOptions } from '../../types';
 import { LayoutOptions } from '../layout';
 import { AddIndicatorResult } from '../indicator/addIndicator';
+import { SVGExportOptions } from '../chart/exporter/SVGExporter';
 
 /** Stack layout direction */
 export type StackDirection = "vertical" | "horizontal";
@@ -101,12 +102,20 @@ export interface StackedChart {
         paneId?: string;
         chart?: Chart;
     }>;
-    /** Export the entire stack as one PNG/JPEG/WebP image (WYSIWYG layout) */
+    /** Export the entire stack as one PNG/JPEG/WebP/SVG (WYSIWYG layout) */
     exportImage(options?: StackSnapshotOptions): Promise<string>;
+    /** Export the entire stack as vector SVG */
+    exportSVG(options?: StackSVGExportOptions): string;
     /** Alias for exportImage */
     snapshot(options?: StackSnapshotOptions): Promise<string>;
     destroy(): void;
 }
+/** Stack SVG export options */
+export type StackSVGExportOptions = SVGExportOptions & {
+    includeDividers?: boolean;
+    includeBackground?: boolean;
+    backgroundColor?: string;
+};
 export declare const STACKED_MAX_PANES = 5;
 /** Default minimum pane height as a fraction of available stack height (1/6). */
 export declare const STACKED_DEFAULT_MIN_PANE_RATIO: number;
@@ -121,10 +130,9 @@ export declare const STACKED_FULL_X_MARGIN: {
 export declare const STACKED_FULL_Y_MARGIN: {
     left: number;
 };
-/** Options for full-stack image export */
-export type StackSnapshotFormat = "png" | "jpeg" | "webp";
+export type StackSnapshotFormat = "png" | "jpeg" | "webp" | "svg";
 export type StackSnapshotResolution = "standard" | "2k" | "4k" | "8k" | number;
-export interface StackSnapshotOptions {
+export interface StackSnapshotOptions extends Partial<StackSVGExportOptions> {
     format?: StackSnapshotFormat;
     quality?: number;
     resolution?: StackSnapshotResolution;