@wick-charts/vue 0.3.0 → 0.3.2

package/dist/index.d.ts

@@ -7,13 +7,16 @@ import { ShallowRef } from 'vue';
 
 declare const __VLS_component: DefineComponent<__VLS_Props_3, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<__VLS_Props_3> & Readonly<{}>, {
 theme: ChartTheme;
+gradient: boolean;
+headerLayout: "overlay" | "inline";
 }, {}, {}, {}, string, ComponentProvideOptions, false, {
-containerRef: HTMLDivElement;
-topOverlayRef: HTMLDivElement;
 titleAnchor: HTMLDivElement;
 infoBarAnchor: HTMLDivElement;
+containerRef: HTMLDivElement;
+topOverlayRef: HTMLDivElement;
 legendRightAnchor: HTMLDivElement;
 legendAnchor: HTMLDivElement;
+navigatorAnchor: HTMLDivElement;
 }, HTMLDivElement>;
 
 declare const __VLS_component_2: DefineComponent<__VLS_Props_6, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<__VLS_Props_6> & Readonly<{}>, {}, {}, {}, {}, string, ComponentProvideOptions, false, {}, any>;
@@ -23,22 +26,23 @@ position: "bottom" | "right";
 mode: LegendMode;
 }, {}, {}, {}, string, ComponentProvideOptions, false, {}, any>;
 
-declare const __VLS_component_4: DefineComponent<__VLS_Props_9, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<__VLS_Props_9> & Readonly<{}>, {
+declare const __VLS_component_4: DefineComponent<__VLS_Props_10, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<__VLS_Props_10> & Readonly<{}>, {
+position: PieLegendPosition;
 format: ValueFormatter;
 mode: PieLegendMode;
 }, {}, {}, {}, string, ComponentProvideOptions, false, {}, any>;
 
-declare const __VLS_component_5: DefineComponent<__VLS_Props_10, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<__VLS_Props_10> & Readonly<{}>, {}, {}, {}, {}, string, ComponentProvideOptions, false, {
+declare const __VLS_component_5: DefineComponent<__VLS_Props_11, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<__VLS_Props_11> & Readonly<{}>, {}, {}, {}, {}, string, ComponentProvideOptions, false, {
 containerRef: HTMLDivElement;
 }, any>;
 
-declare const __VLS_component_6: DefineComponent<__VLS_Props_11, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<__VLS_Props_11> & Readonly<{}>, {}, {}, {}, {}, string, ComponentProvideOptions, false, {}, any>;
+declare const __VLS_component_6: DefineComponent<__VLS_Props_13, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<__VLS_Props_13> & Readonly<{}>, {}, {}, {}, {}, string, ComponentProvideOptions, false, {}, any>;
 
-declare const __VLS_component_7: DefineComponent<__VLS_Props_12, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<__VLS_Props_12> & Readonly<{}>, {}, {}, {}, {}, string, ComponentProvideOptions, false, {
+declare const __VLS_component_7: DefineComponent<__VLS_Props_14, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<__VLS_Props_14> & Readonly<{}>, {}, {}, {}, {}, string, ComponentProvideOptions, false, {
 containerRef: HTMLDivElement;
 }, any>;
 
-declare const __VLS_component_8: DefineComponent<__VLS_Props_14, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<__VLS_Props_14> & Readonly<{}>, {}, {}, {}, {}, string, ComponentProvideOptions, false, {}, any>;
+declare const __VLS_component_8: DefineComponent<__VLS_Props_16, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<__VLS_Props_16> & Readonly<{}>, {}, {}, {}, {}, string, ComponentProvideOptions, false, {}, any>;
 
 declare type __VLS_Props = {
     data: TimePoint[][];
@@ -53,25 +57,63 @@ declare type __VLS_Props_10 = {
      * series is picked.
      */
     seriesId?: string;
-    /** Custom formatter for the slice value. Default: shared `formatCompact`. */
+    /** 'value' shows only the value, 'percent' only the percent, 'both' shows both. Default: 'both'. */
+    mode?: PieLegendMode;
+    /** Custom formatter for the absolute slice value. */
     format?: ValueFormatter;
+    /** Layout placement. Default: `'bottom'`. */
+    position?: PieLegendPosition;
 };
 
 declare type __VLS_Props_11 = {
-    sub?: string;
+    /**
+     * Owning series id. **Optional** — when omitted, the first visible pie
+     * series is picked.
+     */
+    seriesId?: string;
+    /** Custom formatter for the slice value. Default: shared `formatCompact`. */
+    format?: ValueFormatter;
 };
 
 declare type __VLS_Props_12 = {
+    /** Desired number of labels (≥ 2). Overrides chart-level `axis.x.labelCount`. */
+    labelCount?: number;
+    /** Minimum pixel gap between adjacent labels (hard floor). Overrides chart-level. */
+    minLabelSpacing?: number;
+};
+
+declare type __VLS_Props_13 = {
+    /**
+     * @deprecated Use the named `sub` slot instead — it accepts arbitrary
+     * inline markup (icons, badges, formatted text) to mirror React's
+     * `sub: ReactNode`. The string-only prop is kept as a back-compat shim
+     * for callers upgrading from 0.3.1; the slot wins when both are provided.
+     *
+     * Note: the title strip is rendered with `pointer-events: none` so it
+     * doesn't intercept canvas hover events. Interactive children (`<a>`,
+     * `<button>`) need to opt back in with `pointer-events: auto`.
+     */
+    sub?: string;
+};
+
+declare type __VLS_Props_14 = {
     sort?: SnapshotSort;
     format?: TooltipFormatter;
 };
 
-declare type __VLS_Props_13 = {
+declare type __VLS_Props_15 = {
     /** Custom tick-label formatter. Overrides the built-in range-adaptive default. */
     format?: ValueFormatter;
+    /**
+     * Desired number of labels (≥ 2). Overrides any chart-level `axis.y.labelCount`.
+     * Realized count may differ ±1 after the 1-2-5 snap.
+     */
+    labelCount?: number;
+    /** Minimum pixel gap between adjacent labels (hard floor). Overrides chart-level. */
+    minLabelSpacing?: number;
 };
 
-declare type __VLS_Props_14 = {
+declare type __VLS_Props_16 = {
     /**
      * Owning series id. **Optional** — when omitted, the first visible
      * single-layer time series is picked, falling back to the first visible
@@ -93,10 +135,41 @@ declare type __VLS_Props_2 = {
 declare type __VLS_Props_3 = {
     theme?: ChartTheme;
     axis?: AxisConfig;
+    /**
+     * Viewport padding. `top`/`bottom` are in pixels. `left`/`right` accept either pixels (`50`)
+     * or data intervals (`{ intervals: 3 }`). Set to 0 for edge-to-edge sparklines. Updates are
+     * applied reactively when this prop or the measured header height changes.
+     * Defaults: `{ top: 20, bottom: 20, right: { intervals: 3 }, left: { intervals: 0 } }`.
+     */
+    padding?: {
+        top?: number;
+        bottom?: number;
+        right?: number | {
+            intervals: number;
+        };
+        left?: number | {
+            intervals: number;
+        };
+    };
+    /** Show the chart background gradient. Defaults to true. */
+    gradient?: boolean;
+    /** Enable zoom, pan, and crosshair interactions. Defaults to true. */
+    interactive?: boolean;
     /** Background grid configuration. Default: `{ visible: true }`. */
     grid?: {
         visible: boolean;
     };
+    /**
+     * How `<Title>` and `<InfoBar>` are positioned relative to the canvas.
+     * - `'overlay'` (default): absolute overlays on top of the canvas.
+     * - `'inline'`: flex siblings above the canvas — the canvas (and grid) shift down.
+     */
+    headerLayout?: 'overlay' | 'inline';
+    /**
+     * Enable runtime performance instrumentation. Off by default. Read at mount only;
+     * later changes are ignored.
+     */
+    perf?: PerfOption;
 };
 
 declare type __VLS_Props_4 = {
@@ -126,23 +199,21 @@ declare type __VLS_Props_7 = {
 };
 
 declare type __VLS_Props_8 = {
-    value: number;
-    /** Value-to-string formatter. Defaults to the current locale's `Intl.NumberFormat`. */
-    format?: (value: number) => string;
-    locale?: string;
-    spinDuration?: number;
+    data: NavigatorData;
+    /** Strip height in CSS pixels. Defaults to `theme.navigator.height` (60). */
+    height?: number;
 };
 
 declare type __VLS_Props_9 = {
+    value: number;
     /**
-     * Owning series id. **Optional** — when omitted, the first visible pie
-     * series is picked.
+     * Value-to-string formatter. Defaults to the current locale's
+     * `Intl.NumberFormat` when omitted. `Intl.NumberFormatOptions` is also
+     * accepted (legacy) — routed through the built-in `Intl.NumberFormat`.
      */
-    seriesId?: string;
-    /** 'value' shows only the value, 'percent' only the percent, 'both' shows both. Default: 'both'. */
-    mode?: PieLegendMode;
-    /** Custom formatter for the absolute slice value. */
-    format?: ValueFormatter;
+    format?: ((value: number) => string) | Intl.NumberFormatOptions;
+    locale?: string;
+    spinDuration?: number;
 };
 
 declare function __VLS_template(): {
@@ -151,12 +222,13 @@ declare function __VLS_template(): {
         default?(_: {}): any;
     };
     refs: {
-        containerRef: HTMLDivElement;
-        topOverlayRef: HTMLDivElement;
         titleAnchor: HTMLDivElement;
         infoBarAnchor: HTMLDivElement;
+        containerRef: HTMLDivElement;
+        topOverlayRef: HTMLDivElement;
         legendRightAnchor: HTMLDivElement;
         legendAnchor: HTMLDivElement;
+        navigatorAnchor: HTMLDivElement;
     };
     rootEl: HTMLDivElement;
 };
@@ -235,8 +307,28 @@ declare function __VLS_template_5(): {
 
 declare function __VLS_template_6(): {
     attrs: Partial<{}>;
-    slots: {
-        default?(_: {}): any;
+    slots: Readonly<{
+        default?(): unknown;
+        /**
+         * Secondary label rendered in a muted colour next to the primary one. Use a
+         * named slot (instead of the legacy `sub` prop) so consumers can pass
+         * arbitrary inline markup — icons, badges, formatted text — to mirror
+         * React's `sub: ReactNode`. Interactive children (`<a>`, `<button>`) need
+         * `pointer-events: auto` to override the title strip's default
+         * `pointer-events: none`.
+         */
+        sub?(): unknown;
+    }> & {
+        default?(): unknown;
+        /**
+         * Secondary label rendered in a muted colour next to the primary one. Use a
+         * named slot (instead of the legacy `sub` prop) so consumers can pass
+         * arbitrary inline markup — icons, badges, formatted text — to mirror
+         * React's `sub: ReactNode`. Interactive children (`<a>`, `<button>`) need
+         * `pointer-events: auto` to override the title strip's default
+         * `pointer-events: none`.
+         */
+        sub?(): unknown;
     };
     refs: {};
     rootEl: any;
@@ -457,7 +549,9 @@ export declare type AxisBound = 'auto' | number | string | ((values: number[]) =
 
 /** Grouped axis configuration for both axes. */
 export declare interface AxisConfig {
+    /** Y-axis configuration — width, bounds, and visibility of the value axis. */
     y?: YAxisConfig;
+    /** X-axis configuration — height and visibility of the time axis. */
     x?: XAxisConfig;
 }
 
@@ -481,6 +575,7 @@ export declare interface BarSeriesOptions {
     label?: string;
     /** One color per layer. */
     colors: string[];
+    /** Width of each bar as a fraction of the available bar slot (0–1). `1` = bars touch; `0.6` = roughly 60 % of the slot. Default: 0.7. */
     barWidthRatio: number;
     /** Stacking mode. Default: 'off'. */
     stacking: StackingMode;
@@ -572,7 +667,9 @@ export declare interface BuildLastSnapshotsArgs {
  * `autoGradient(color)` for the subtle lightened/darkened look.
  */
 declare interface CandlestickDirectionColors {
+    /** Body fill — single colour for flat, `[top, bottom]` tuple for a 2-stop vertical gradient. */
     body: string | [string, string];
+    /** Wick stroke colour. */
     wick: string;
 }
 
@@ -593,7 +690,9 @@ export declare const CandlestickSeries: DefineComponent<__VLS_Props_2, {}, {}, {
 export declare interface CandlestickSeriesOptions {
     /** Display label shown in the tooltip. */
     label?: string;
+    /** Colours for bullish candles (close ≥ open). */
     up: CandlestickDirectionColors;
+    /** Colours for bearish candles (close < open). */
     down: CandlestickDirectionColors;
     /** Width of candle body as a fraction of the available bar slot (0-1). */
     bodyWidthRatio: number;
@@ -715,6 +814,12 @@ export declare class ChartInstance extends EventEmitter<ChartEvents> {
     /** Auto-fit the viewport to show all data across every series. */
     fitContent(): void;
     getVisibleRange(): VisibleRange;
+    /**
+     * Return the full span of registered data, or `null` before any data has
+     * arrived. `{ from: dataStart, to: dataEnd }` mirrors the viewport's own
+     * tracking and is cheaper than recomputing from series stores.
+     */
+    getDataRange(): VisibleRange | null;
     /**
      * Imperatively set the visible time range.
      *
@@ -973,10 +1078,13 @@ export declare interface ChartTheme {
     background: string;
     /** Chart area gradient [top, bottom] — subtle vignette for depth */
     chartGradient: [string, string];
+    /** Font family and base size used across the chart's text. */
     typography: Typography;
     /** Grid line appearance in the chart area. */
     grid: {
+        /** Grid line stroke colour. */
         color: string;
+        /** Grid line dash pattern. */
         style: 'solid' | 'dashed' | 'dotted';
     };
     /**
@@ -988,33 +1096,48 @@ export declare interface ChartTheme {
      * want the subtle lightened/darkened look pass `autoGradient(color)`.
      */
     candlestick: {
+        /** Bullish candle (close ≥ open). */
         up: {
+            /** Body fill — single colour for flat, `[top, bottom]` tuple for a 2-stop vertical gradient. */
             body: string | [string, string];
+            /** Wick stroke colour. */
             wick: string;
         };
+        /** Bearish candle (close < open). */
         down: {
+            /** Body fill — single colour for flat, `[top, bottom]` tuple for a 2-stop vertical gradient. */
             body: string | [string, string];
+            /** Wick stroke colour. */
             wick: string;
         };
     };
     /** Default line series appearance including area gradient fill. */
     line: {
+        /** Stroke colour of the line. */
         color: string;
+        /** Stroke width in CSS pixels. */
         width: number;
+        /** Top stop of the area-fill vertical gradient (closest to the line). */
         areaTopColor: string;
+        /** Bottom stop of the area-fill vertical gradient (closest to the X axis). */
         areaBottomColor: string;
     };
     /** Color palette for multi-series charts (stacked bars, overlays). */
     seriesColors: string[];
     /** Bollinger band / envelope fill colors. */
     bands: {
+        /** Fill for the upper band region (above the middle band). */
         upper: string;
+        /** Fill for the lower band region (below the middle band). */
         lower: string;
     };
     /** Crosshair line and axis label styling. */
     crosshair: {
+        /** Stroke colour of the crosshair lines. */
         color: string;
+        /** Background fill of the X/Y axis label pills shown at the crosshair position. */
         labelBackground: string;
+        /** Text colour inside the crosshair axis label pills. */
         labelTextColor: string;
     };
     /**
@@ -1024,31 +1147,113 @@ export declare interface ChartTheme {
      * diverge.
      */
     axis: {
+        /** Default tick-label font size shared by both axes. */
         fontSize: number;
+        /** Default tick-label colour shared by both axes. */
         textColor: string;
+        /** Override the shared defaults on the X axis only. */
         x?: {
+            /** X-axis tick-label font size. Falls back to `axis.fontSize`. */
             fontSize?: number;
+            /** X-axis tick-label colour. Falls back to `axis.textColor`. */
             textColor?: string;
         };
+        /** Override the shared defaults on the Y axis only. */
         y?: {
+            /** Y-axis tick-label font size. Falls back to `axis.fontSize`. */
             fontSize?: number;
+            /** Y-axis tick-label colour. Falls back to `axis.textColor`. */
             textColor?: string;
         };
     };
     /** Floating label shown at the current value level on the Y axis. */
     yLabel: {
+        /** Font size of the value text inside the floating Y label. */
         fontSize: number;
+        /** Pill background when the latest delta is positive. */
         upBackground: string;
+        /** Pill background when the latest delta is negative. */
         downBackground: string;
+        /** Pill background when the latest delta is zero / unknown. */
         neutralBackground: string;
+        /** Text colour inside the floating Y label pill. */
         textColor: string;
     };
     /** Hover tooltip styling. */
     tooltip: {
+        /** Tooltip body font size. */
         fontSize: number;
+        /** Tooltip background fill. */
         background: string;
+        /** Tooltip text colour. */
         textColor: string;
+        /** Tooltip outer border colour. */
+        borderColor: string;
+    };
+    /**
+     * Navigator strip shown below the main chart — a miniature overview with a
+     * draggable window indicating the visible range.
+     *
+     * The `candlestick` shape mirrors the root {@link ChartTheme.candlestick}
+     * (including `[top, bottom]` gradient tuples) so candle-type mini views can
+     * share colors with the main plot.
+     */
+    navigator: {
+        /** Default height of the navigator strip in CSS pixels. */
+        height: number;
+        /** Strip background (behind the miniature series). */
+        background: string;
+        /** Color used for the strip's top + bottom inner-shadow separators. */
         borderColor: string;
+        /** Line / close-price miniature color and geometry. */
+        line: {
+            /** Stroke colour of the miniature line. */
+            color: string;
+            /** Stroke width of the miniature line in CSS pixels. */
+            width: number;
+            /** Top stop of the miniature area-fill gradient. */
+            areaTopColor: string;
+            /** Bottom stop of the miniature area-fill gradient. */
+            areaBottomColor: string;
+        };
+        /** Colors for candlestick-type miniature rendering. */
+        candlestick: {
+            /** Bullish miniature candle (close ≥ open). */
+            up: {
+                /** Body fill — single colour for flat, `[top, bottom]` tuple for a vertical gradient. */
+                body: string | [string, string];
+                /** Wick stroke colour. */
+                wick: string;
+            };
+            /** Bearish miniature candle (close < open). */
+            down: {
+                /** Body fill — single colour for flat, `[top, bottom]` tuple for a vertical gradient. */
+                body: string | [string, string];
+                /** Wick stroke colour. */
+                wick: string;
+            };
+        };
+        /** The draggable visible-range window indicator. */
+        window: {
+            /** Fill inside the visible-range window. Usually a translucent tint. */
+            fill: string;
+            /** Stroke colour around the window. */
+            border: string;
+            /** Stroke width of the window border in CSS pixels. */
+            borderWidth: number;
+        };
+        /** Left/right resize handles on the window edges. */
+        handle: {
+            /** Stroke colour of the handle marker. */
+            color: string;
+            /** Handle marker width in CSS pixels. */
+            width: number;
+        };
+        /** Dim overlay covering the regions outside the window. */
+        mask: {
+            /** Fill of the dim overlay applied to regions outside the window. */
+            fill: string;
+        };
     };
 }
 
@@ -1234,6 +1439,7 @@ export declare interface LineSeriesOptions {
     strokeWidth: number;
     /** Area-fill configuration. Default: `{ visible: true }`. */
     area: {
+        /** Whether the area gradient under the line is rendered. Default: `true`. */
         visible: boolean;
     };
     /**
@@ -1295,12 +1501,94 @@ export declare const mintBreeze: ThemePreset;
 
 export declare const monokaiPro: ThemePreset;
 
+declare const Navigator_2: DefineComponent<__VLS_Props_8, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<__VLS_Props_8> & Readonly<{}>, {}, {}, {}, {}, string, ComponentProvideOptions, false, {
+stripRef: HTMLDivElement;
+}, any>;
+export { Navigator_2 as Navigator }
+
+/** Minimal point shape for candlestick miniature series. */
+export declare interface NavigatorCandlePoint {
+    time: number;
+    open: number;
+    high: number;
+    low: number;
+    close: number;
+}
+
+/**
+ * Drives the navigator strip rendered below the main chart.
+ *
+ * Layout: the container holds a canvas (series miniature) and a DOM overlay
+ * with five absolutely-positioned divs — left mask, right mask, window body,
+ * left handle, right handle. The overlay is purely visual; pointer input is
+ * captured on the canvas and hit-tested against the current window geometry.
+ *
+ * Both layers reserve `chart.yAxisWidth` on the right so the navigator's
+ * active zone aligns with the main chart's plot area (matches the TimeAxis).
+ *
+ * Event topology — navigator is a pure listener on the chart side, never emits:
+ *   chart.viewportChange → reposition window DOM + redraw on next frame
+ *   chart.overlayChange  → full redraw (catches data + theme swaps)
+ *   ResizeObserver       → resize canvas + full redraw
+ */
+export declare class NavigatorController {
+    #private;
+    constructor(params: NavigatorControllerParams);
+    setData(data: NavigatorData): void;
+    setOptions(options: NavigatorOptions): void;
+    destroy(): void;
+    /** CSS pixel height of the strip — theme default unless overridden. */
+    get height(): number;
+}
+
+export declare interface NavigatorControllerParams {
+    container: HTMLElement;
+    chart: ChartInstance;
+    data: NavigatorData;
+    options?: NavigatorOptions;
+}
+
+/**
+ * Data passed to the navigator. The discriminant `type` selects the miniature
+ * rendering style. Line and bar accept either a single `points` array
+ * (shorthand) or `series` for multi-series overlays — every series shares the
+ * same y-range and is drawn in the navigator's neutral foreground color.
+ * Candlestick stays single-series; multi-candlestick miniatures don't read.
+ */
+export declare type NavigatorData = {
+    type: 'line' | 'bar';
+    points: readonly NavigatorLinePoint[];
+} | {
+    type: 'line' | 'bar';
+    series: readonly (readonly NavigatorLinePoint[])[];
+} | {
+    type: 'candlestick';
+    points: readonly NavigatorCandlePoint[];
+};
+
+/** Minimal point shape for line and bar miniature series. */
+export declare interface NavigatorLinePoint {
+    time: number;
+    value: number;
+}
+
+export declare interface NavigatorOptions {
+    /**
+     * Strip height in CSS pixels. When omitted, falls back to
+     * `chart.getTheme().navigator.height`.
+     */
+    height?: number;
+}
+
+/** Series type the navigator should render in its miniature view. */
+export declare type NavigatorSeriesType = 'line' | 'bar' | 'candlestick';
+
 export declare const nightOwl: ThemePreset;
 
 /** Convert a {@link TimeValue} (number ms or Date) to a millisecond timestamp. */
 export declare function normalizeTime(t: TimeValue): number;
 
-export declare const NumberFlow: DefineComponent<__VLS_Props_8, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<__VLS_Props_8> & Readonly<{}>, {
+export declare const NumberFlow: DefineComponent<__VLS_Props_9, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<__VLS_Props_9> & Readonly<{}>, {
 locale: string;
 spinDuration: number;
 }, {}, {}, {}, string, ComponentProvideOptions, false, {}, HTMLSpanElement>;
@@ -1394,6 +1682,8 @@ declare interface PerfMonitorOptions {
     heapSampleEveryNFrames?: number;
 }
 
+declare type PerfOption = NonNullable<ChartOptions['perf']>;
+
 declare interface PerfStats {
     /**
      * Main-layer renders per second, derived from the interval between recent main
@@ -1480,6 +1770,8 @@ export declare const PieLegend: __VLS_WithTemplateSlots_4<typeof __VLS_component
 
 declare type PieLegendMode = 'value' | 'percent' | 'both';
 
+declare type PieLegendPosition = 'bottom' | 'right' | 'overlay';
+
 export declare const PieSeries: DefineComponent<__VLS_Props_5, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<__VLS_Props_5> & Readonly<{}>, {}, {}, {}, {}, string, ComponentProvideOptions, false, {}, any>;
 
 /** Visual options for a pie/donut series. `innerRadiusRatio > 0` makes it a donut. */
@@ -1660,6 +1952,19 @@ export declare interface ThemeConfig {
     axis?: Partial<ChartTheme['axis']>;
     yLabel?: Partial<ChartTheme['yLabel']>;
     tooltip?: Partial<ChartTheme['tooltip']>;
+    navigator?: {
+        height?: number;
+        background?: string;
+        borderColor?: string;
+        line?: Partial<ChartTheme['navigator']['line']>;
+        candlestick?: {
+            up?: Partial<ChartTheme['navigator']['candlestick']['up']>;
+            down?: Partial<ChartTheme['navigator']['candlestick']['down']>;
+        };
+        window?: Partial<ChartTheme['navigator']['window']>;
+        handle?: Partial<ChartTheme['navigator']['handle']>;
+        mask?: Partial<ChartTheme['navigator']['mask']>;
+    };
     /** URL to load the font (e.g. Google Fonts). */
     fontUrl?: string | null;
 }
@@ -1675,7 +1980,7 @@ export declare interface ThemePreset {
     backgroundSize?: string;
 }
 
-export declare const TimeAxis: DefineComponent<    {}, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, ComponentProvideOptions, true, {}, HTMLDivElement>;
+export declare const TimeAxis: DefineComponent<__VLS_Props_12, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<__VLS_Props_12> & Readonly<{}>, {}, {}, {}, {}, string, ComponentProvideOptions, false, {}, HTMLDivElement>;
 
 /** A single time-value data point for line and bar series. Time is a timestamp in milliseconds. */
 export declare interface TimePoint {
@@ -1791,6 +2096,7 @@ export declare interface TooltipPositionArgs {
 
 /** Font family and base font size used across the chart. */
 export declare interface Typography {
+    /** CSS `font-family` stack applied to all text rendered by the chart. */
     fontFamily: string;
     /** Base body font size — titles, infobar, pie tooltip/legend default to this. */
     fontSize: number;
@@ -1849,7 +2155,7 @@ export declare interface XAxisConfig {
     visible?: boolean;
 }
 
-export declare const YAxis: DefineComponent<__VLS_Props_13, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<__VLS_Props_13> & Readonly<{}>, {}, {}, {}, {}, string, ComponentProvideOptions, false, {}, HTMLDivElement>;
+export declare const YAxis: DefineComponent<__VLS_Props_15, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<__VLS_Props_15> & Readonly<{}>, {}, {}, {}, {}, string, ComponentProvideOptions, false, {}, HTMLDivElement>;
 
 /** Configuration for the Y axis. */
 export declare interface YAxisConfig {