velo-plot 1.11.1 → 1.12.0

package/dist/react/useStackedPlot.d.ts

@@ -0,0 +1,17 @@
+import { RefObject } from 'react';
+import { StackedChart, StackedChartOptions } from '../core/stacked';
+import { Range } from '../types';
+
+export interface UseStackedPlotOptions extends Omit<StackedChartOptions, "container"> {
+}
+export interface UseStackedPlotReturn {
+    containerRef: RefObject<HTMLDivElement>;
+    stack: StackedChart | null;
+    isReady: boolean;
+    fitAll: (options?: {
+        x?: Range;
+        padding?: number;
+    }) => void;
+    resetAll: () => void;
+}
+export declare function useStackedPlot(options: UseStackedPlotOptions): UseStackedPlotReturn;

package/dist/types.d.ts

@@ -23,6 +23,8 @@ export interface AxisOptions {
     position?: "left" | "right" | "top" | "bottom";
     /** Scale type */
     scale?: ScaleType;
+    /** Tick display type — affects label formatting, not the mathematical scale */
+    type?: "linear" | "time";
     /** Axis label (e.g., 'E / V') */
     label?: string;
     /** Unit for formatting (e.g., 'V', 'A') */
@@ -65,8 +67,10 @@ export interface AxisOptions {
     labelFontSize?: number;
     /** Label rotation in degrees (useful for crowded X-axis) */
     labelRotation?: number;
+    /** Target number of tick divisions on this axis (default: 8 for X, 6 for Y) */
+    tickCount?: number;
 }
-export type SeriesType = "line" | "scatter" | "line+scatter" | "step" | "step+scatter" | "band" | "area" | "bar" | "heatmap" | "candlestick" | "polar" | "radar" | "boxplot" | "waterfall" | "gauge" | "sankey" | "ternary";
+export type SeriesType = "line" | "scatter" | "line+scatter" | "step" | "step+scatter" | "band" | "area" | "bar" | "heatmap" | "candlestick" | "polar" | "radar" | "boxplot" | "waterfall" | "gauge" | "sankey" | "ternary" | "indicator";
 /** Step mode defines where the step occurs */
 export type StepMode = "before" | "after" | "center";
 /** Error bar direction */
@@ -503,6 +507,8 @@ export interface TernaryOptions extends Omit<SeriesOptions, "data" | "style"> {
 export interface ChartOptions {
     /** Target container element */
     container: HTMLDivElement;
+    /** Stable chart id (used by sync groups; auto-generated if omitted) */
+    id?: string;
     /** Renderer backend selection (default: 'webgl') */
     renderer?: "webgl" | "webgpu";
     /** X-axis configuration */
@@ -589,6 +595,20 @@ export interface ZoomOptions {
     /** Animate the transition */
     animate?: boolean;
 }
+/** Options for {@link Chart.fit} — safe fit that skips empty series */
+export interface FitOptions {
+    /** Explicit X range (otherwise derived from visible series) */
+    x?: Range;
+    /** Explicit Y range for the primary Y axis (otherwise derived per axis) */
+    y?: Range;
+    /** Padding fraction applied to computed ranges (default: 0.02 for X, 0.05 for Y) */
+    padding?: number | {
+        x?: number;
+        y?: number;
+    };
+    /** Animate the transition */
+    animate?: boolean;
+}
 export interface CursorOptions {
     /** Enable cursor */
     enabled?: boolean;