velo-plot 1.12.0 → 1.15.0

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

@@ -126,6 +126,7 @@ export declare class ChartImpl implements Chart {
     };
     private getInteractedBounds;
     exportImage(type?: "png" | "jpeg"): string;
+    exportSVG(): string;
     private getSeriesContext;
     addSeries(options: SeriesOptions | HeatmapOptions): void;
     addBar(options: Omit<SeriesOptions, "type">): void;

package/dist/core/chart/exporter/SVGExporter.d.ts

@@ -1,6 +1,11 @@
 import { Series } from '../../Series';
-import { Bounds, PlotArea } from '../../../types';
+import { AxisOptions, Bounds, PlotArea } from '../../../types';
 import { Scale } from '../../../scales';
 import { ChartTheme } from '../../../theme';
 
-export declare function exportToSVG(series: Series[], _viewBounds: Bounds, plotArea: PlotArea, xAxis: Scale, yAxes: Map<string, Scale>, theme: ChartTheme, width: number, height: number): string;
+export interface SVGExportOptions {
+    xAxis?: AxisOptions;
+    yAxis?: AxisOptions;
+    primaryYAxisId?: string;
+}
+export declare function exportToSVG(series: Series[], _viewBounds: Bounds, plotArea: PlotArea, xAxis: Scale, yAxes: Map<string, Scale>, theme: ChartTheme, width: number, height: number, axisOptions?: SVGExportOptions): string;

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

@@ -44,6 +44,8 @@ export interface Chart {
     off<K extends keyof ChartEventMap>(event: K, handler: (data: ChartEventMap[K]) => void): void;
     destroy(): void;
     exportImage(type?: "png" | "jpeg"): string;
+    /** Vector export of series, axes, grid, and tick labels */
+    exportSVG(): string;
     autoScale(animate?: boolean): void;
     setTheme(theme: string | object): void;
     /** Access to data analysis utilities */

package/dist/core/render/pixelSnap.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Canvas pixel-alignment helpers for crisp 1px lines and sharper text.
+ * Coordinates are in CSS/logical space (before or after setTransform(dpr)).
+ */
+/** Snap a coordinate to the center of a physical pixel (crisp 1px strokes). */
+export declare function snapLineCoord(value: number): number;
+/** Snap label positions to whole pixels (reduces sub-pixel blur on fillText). */
+export declare function snapLabelCoord(value: number): number;

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

@@ -1,4 +1,6 @@
 export { createStackedChart } from './createStackedChart';
-export type { StackedChart, StackedChartOptions, StackedPaneConfig, StackedSyncOptions } from './types';
+export type { StackedChart, StackedChartOptions, StackedPaneConfig, StackedSyncOptions, StackDirection, StackSnapshotOptions, } from './types';
 export { STACKED_MAX_PANES, STACKED_DEFAULT_MIN_PANE_RATIO, } from './types';
+export { exportStackImage } from './stackExport';
+export type { StackExportOptions } from './stackExport';
 export { normalizePaneHeights, resolveMinPaneHeightPx, } from './paneResize';

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

@@ -1,32 +1,29 @@
-/**
- * VS Code–style drag dividers between stacked chart panes.
- */
+import { StackDirection } from './types';
+
 export interface PaneResizeOptions {
-    /** Min pane height as fraction of available height (default 1/6) */
+    /** Stack layout direction */
+    direction?: StackDirection;
+    /** Min pane size as fraction of available stack dimension (default 1/6) */
     minPaneRatio?: number;
-    /** Absolute min pane height in px — used when larger than ratio-based min */
+    /** Absolute min pane size in px */
     minPanePx?: number;
-    /** Divider hit area height (default 6) */
+    /** Divider hit area size (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;
+    onDragStart?: (leadingIdx: number, trailingIdx: number) => number[];
+    onDragMove?: (sizesPx: number[], leadingIdx: number, trailingIdx: number) => void;
+    onDragEnd?: (finalSizesPx: number[]) => void;
 }
 export interface PaneResizeController {
     dividers: HTMLDivElement[];
     destroy: () => void;
 }
-/** Resolve per-pane minimum height in px for the current available stack height. */
+declare function paneFlexStyle(ratio: number | string, direction: StackDirection): string;
 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 resolveMinPaneWidthPx(availWidth: number, paneCount: number, minPaneRatio?: number, minPanePx?: number): number;
 export declare function normalizePaneHeights(heightsPx: number[], targetTotal: number): number[];
+export declare const normalizePaneWidths: typeof normalizePaneHeights;
 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 applyPaneFlexRatios(paneWrappers: HTMLDivElement[], ratios: number[], direction?: StackDirection): void;
 export declare function initialPaneRatio(height: number | string): number;
+export { paneFlexStyle };

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

@@ -0,0 +1,18 @@
+import { Chart } from '../chart/types';
+
+export type StackExportFormat = "png" | "jpeg" | "webp";
+export type StackExportResolution = "standard" | "2k" | "4k" | "8k" | number;
+export interface StackExportOptions {
+    format?: StackExportFormat;
+    quality?: number;
+    resolution?: StackExportResolution;
+    includeBackground?: boolean;
+    includeDividers?: boolean;
+    transparent?: boolean;
+}
+/** @internal Exported for unit tests */
+export declare function stackResolutionScale(res: StackExportResolution): number;
+/**
+ * Compose every pane chart into one raster image matching the on-screen stack layout.
+ */
+export declare function exportStackImage(container: HTMLDivElement, paneWrappers: HTMLDivElement[], paneCharts: Chart[], dividers: HTMLDivElement[], backgroundColor: string, options?: StackExportOptions): Promise<string>;

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

@@ -3,17 +3,21 @@ import { ChartGroup, SyncAxis, SyncOptions } from '../sync';
 import { ChartOptions as RootChartOptions, Range, SeriesOptions } from '../../types';
 import { LayoutOptions } from '../layout';
 
+/** Stack layout direction */
+export type StackDirection = "vertical" | "horizontal";
 /** Per-pane configuration (max 5 panes per stack) */
 export interface StackedPaneConfig {
     id: string;
-    /** Flex ratio (e.g. 0.6) or CSS length ("24%", "80px") */
+    /** Flex ratio (e.g. 0.6) or CSS length ("24%", "80px") — height ratio when vertical, width ratio when horizontal */
     height: number | string;
     /** Chart options excluding container/id (series added via chart API or `series`) */
     chart?: Omit<RootChartOptions, "container" | "id">;
     /** Series to add immediately after pane chart is created */
     series?: SeriesOptions[];
-    /** Show native X axis (default: only bottom pane when sharedXAxis is bottom) */
+    /** Show native X axis (default: only bottom pane when vertical + sharedXAxis; each pane when horizontal) */
     showXAxis?: boolean;
+    /** Show native Y axis (default: only first pane when horizontal + sharedYAxis) */
+    showYAxis?: boolean;
     /** Receive pan/zoom (default: true on every pane) */
     interactive?: boolean;
     /** Lock Y range — skips auto fit on Y for this pane */
@@ -22,12 +26,16 @@ export interface StackedPaneConfig {
 export interface StackedChartOptions {
     /** Root container (will be cleared and filled with pane layout) */
     container: HTMLDivElement;
-    /** 1–5 stacked panes, top to bottom */
+    /** 1–5 stacked panes */
     panes: StackedPaneConfig[];
-    /** Pane that drives X sync (default: first pane) */
+    /** Layout direction (default: vertical — panes top to bottom) */
+    direction?: StackDirection;
+    /** Pane that drives sync (default: first pane) */
     masterPaneId?: string;
-    /** Shared date/time row on bottom pane only */
+    /** Shared date/time row on bottom pane only (vertical layout) */
     sharedXAxis?: "bottom" | "none";
+    /** Shared Y axis on left pane only (horizontal layout) */
+    sharedYAxis?: "left" | "none";
     /** Shared theme applied to every pane */
     theme?: string | object;
     devicePixelRatio?: number;
@@ -75,6 +83,10 @@ export interface StackedChart {
     setSyncOptions(options: Partial<StackedSyncOptions>): void;
     /** Resolves when all pane charts have started rendering */
     whenReady(): Promise<void>;
+    /** Export the entire stack as one PNG/JPEG/WebP image (WYSIWYG layout) */
+    exportImage(options?: StackSnapshotOptions): Promise<string>;
+    /** Alias for exportImage */
+    snapshot(options?: StackSnapshotOptions): Promise<string>;
     destroy(): void;
 }
 export declare const STACKED_MAX_PANES = 5;
@@ -83,9 +95,26 @@ export declare const STACKED_DEFAULT_MIN_PANE_RATIO: number;
 export declare const STACKED_COMPACT_MARGIN: {
     top: number;
     bottom: number;
+    left: number;
 };
 export declare const STACKED_FULL_X_MARGIN: {
     bottom: number;
 };
+export declare const STACKED_FULL_Y_MARGIN: {
+    left: number;
+};
+/** Options for full-stack image export */
+export type StackSnapshotFormat = "png" | "jpeg" | "webp";
+export type StackSnapshotResolution = "standard" | "2k" | "4k" | "8k" | number;
+export interface StackSnapshotOptions {
+    format?: StackSnapshotFormat;
+    quality?: number;
+    resolution?: StackSnapshotResolution;
+    includeBackground?: boolean;
+    includeDividers?: boolean;
+    transparent?: boolean;
+    download?: boolean;
+    fileName?: string;
+}
 /** Pan/zoom sync between stacked panes (Y stays independent when axis is `x`). */
 export type StackedSyncOptions = Pick<SyncOptions, "axis" | "syncCursor" | "syncSelection" | "syncZoom" | "syncPan" | "bidirectional" | "debounce">;