velo-plot 1.12.0 → 1.19.0

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

@@ -2,18 +2,23 @@ import { Chart } from '../chart/types';
 import { ChartGroup, SyncAxis, SyncOptions } from '../sync';
 import { ChartOptions as RootChartOptions, Range, SeriesOptions } from '../../types';
 import { LayoutOptions } from '../layout';
+import { AddIndicatorResult } from '../indicator/addIndicator';
 
+/** 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 +27,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 +84,17 @@ export interface StackedChart {
     setSyncOptions(options: Partial<StackedSyncOptions>): void;
     /** Resolves when all pane charts have started rendering */
     whenReady(): Promise<void>;
+    /** Append a pane at runtime (max 5 panes) */
+    addPane(pane: StackedPaneConfig): Chart;
+    /** Calculate + mount indicator pane or overlay on master price chart */
+    addIndicator(preset: import('../indicator/addIndicator').IndicatorPresetName, options?: import('../indicator/addIndicator').AddIndicatorOptions): Promise<AddIndicatorResult & {
+        paneId?: string;
+        chart?: Chart;
+    }>;
+    /** 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 +103,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">;

package/dist/core/time/TimeScale.d.ts

@@ -0,0 +1,31 @@
+/**
+ * TimeScale — business-day / session-aware X mapping for trading charts.
+ * Stage 2.1–2.3
+ */
+export type TimeScaleCalendar = "continuous" | "business-day";
+export type MarketSession = "24x7" | "NYSE";
+export interface TimeScaleOptions {
+    calendar?: TimeScaleCalendar;
+    session?: MarketSession;
+    /** IANA timezone (reserved for future session-hour filtering) */
+    timezone?: string;
+}
+export interface BusinessDayMapping {
+    /** X values for chart (consecutive indices on business days) */
+    scaledX: Float32Array;
+    /** Original timestamp per scaled index (for tooltips / ticks) */
+    timeByIndex: Float32Array;
+    /** Original index → scaled index (-1 if skipped) */
+    sourceToScaled: Int32Array;
+}
+/** Weekend check (NYSE calendar MVP — UTC weekends). */
+export declare function isBusinessDay(ts: number, _opts?: TimeScaleOptions): boolean;
+/**
+ * Map timestamp series to consecutive business-day indices (skips Sat/Sun bars).
+ * NaN in scaledX marks non-business bars (hidden gap).
+ */
+export declare function mapToBusinessDayScale(times: Float32Array | Float64Array, opts?: TimeScaleOptions): BusinessDayMapping;
+/** Resolve timestamp at a scaled business-day index (for axis ticks). */
+export declare function timeAtBusinessIndex(mapping: BusinessDayMapping, index: number): number | undefined;
+/** Visible span in ms using business-day mapping. */
+export declare function businessDaySpanMs(mapping: BusinessDayMapping, xMin: number, xMax: number): number;