@wick-charts/vue 0.6.3 → 0.6.4

package/dist/index.d.ts

@@ -5,7 +5,7 @@ import { PublicProps } from 'vue';
 import { Ref } from 'vue';
 import { ShallowRef } from 'vue';
 
-declare const __VLS_component: DefineComponent<__VLS_Props_3, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<__VLS_Props_3> & Readonly<{}>, {
+declare const __VLS_component: DefineComponent<__VLS_Props_4, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<__VLS_Props_4> & Readonly<{}>, {
 fade: boolean | {
 top?: number;
 overlap?: number;
@@ -26,35 +26,41 @@ legendAnchor: HTMLDivElement;
 navigatorAnchor: HTMLDivElement;
 }, HTMLDivElement>;
 
-declare const __VLS_component_2: DefineComponent<__VLS_Props_8, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<__VLS_Props_8> & Readonly<{}>, {}, {}, {}, {}, string, ComponentProvideOptions, false, {}, any>;
+declare const __VLS_component_2: DefineComponent<__VLS_Props_9, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<__VLS_Props_9> & Readonly<{}>, {}, {}, {}, {}, string, ComponentProvideOptions, false, {}, any>;
 
-declare const __VLS_component_3: DefineComponent<__VLS_Props_9, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<__VLS_Props_9> & Readonly<{}>, {
+declare const __VLS_component_3: DefineComponent<__VLS_Props_10, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<__VLS_Props_10> & Readonly<{}>, {
 position: "bottom" | "right";
 mode: LegendMode;
 }, {}, {}, {}, string, ComponentProvideOptions, false, {}, any>;
 
-declare const __VLS_component_4: DefineComponent<__VLS_Props_13, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<__VLS_Props_13> & Readonly<{}>, {
+declare const __VLS_component_4: DefineComponent<__VLS_Props_14, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<__VLS_Props_14> & Readonly<{}>, {
 position: PieLegendPosition;
 format: ValueFormatter;
 mode: PieLegendMode;
 }, {}, {}, {}, string, ComponentProvideOptions, false, {}, any>;
 
-declare const __VLS_component_5: DefineComponent<__VLS_Props_14, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<__VLS_Props_14> & Readonly<{}>, {}, {}, {}, {}, string, ComponentProvideOptions, false, {
+declare const __VLS_component_5: DefineComponent<__VLS_Props_15, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<__VLS_Props_15> & Readonly<{}>, {}, {}, {}, {}, string, ComponentProvideOptions, false, {
 containerRef: HTMLDivElement;
 }, any>;
 
-declare const __VLS_component_6: DefineComponent<__VLS_Props_18, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<__VLS_Props_18> & Readonly<{}>, {}, {}, {}, {}, string, ComponentProvideOptions, false, {}, any>;
+declare const __VLS_component_6: DefineComponent<__VLS_Props_19, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<__VLS_Props_19> & Readonly<{}>, {}, {}, {}, {}, string, ComponentProvideOptions, false, {}, any>;
 
-declare const __VLS_component_7: DefineComponent<__VLS_Props_19, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<__VLS_Props_19> & Readonly<{}>, {}, {}, {}, {}, string, ComponentProvideOptions, false, {
+declare const __VLS_component_7: DefineComponent<__VLS_Props_20, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<__VLS_Props_20> & Readonly<{}>, {}, {}, {}, {}, string, ComponentProvideOptions, false, {
 containerRef: HTMLDivElement;
 }, any>;
 
-declare const __VLS_component_8: DefineComponent<__VLS_Props_21, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<__VLS_Props_21> & Readonly<{}>, {}, {}, {}, {}, string, ComponentProvideOptions, false, {}, any>;
+declare const __VLS_component_8: DefineComponent<__VLS_Props_22, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<__VLS_Props_22> & Readonly<{}>, {}, {}, {}, {}, string, ComponentProvideOptions, false, {}, any>;
 
 declare type __VLS_Props = {
-    /** Flat `TimePoint[]`, `TimePoint[][]`, or named `{ label, color?, data }` layers. Time accepts ms or `Date`. */
-    data: MultiLayerData;
-    options?: Partial<BarSeriesOptions>;
+    /**
+     * Band data — one band per layer. A single band passes a flat
+     * `{ time, low, high }[]`; several bands pass `BandPoint[][]`. To name/color
+     * a band, pass `{ label, color?, data }` (or an array of them). Time accepts
+     * ms or `Date`.
+     */
+    data: BandData;
+    /** Visual options override — fill, edge stroke, curve, entrance / intro / smoothing. */
+    options?: Partial<BandSeriesOptions>;
     /** Stable series ID — same value across remounts. */
     id?: string;
     /** Show/hide the series without unmounting it — excludes it from the Y-range fit and tooltip/legend. Default `true`. Live. */
@@ -62,6 +68,15 @@ declare type __VLS_Props = {
 };
 
 declare type __VLS_Props_10 = {
+    items?: LegendItemOverride[];
+    position?: 'bottom' | 'right';
+    /** `'isolate'` shows only the clicked item; `'solo'` is a @deprecated alias. */
+    mode?: LegendMode;
+    /** Fired after a click changes series visibility — via the built-in UI or a custom slot calling `item.toggle()`/`isolate()` directly. */
+    onToggle?: (info: LegendToggleInfo) => void;
+};
+
+declare type __VLS_Props_11 = {
     /** X anchor — epoch ms or a `Date`. */
     time: TimeValue;
     /** Y anchor as a data value. Omit and set `seriesId` to snap to that series' value at `time`. */
@@ -78,13 +93,13 @@ declare type __VLS_Props_10 = {
     color?: string;
 };
 
-declare type __VLS_Props_11 = {
+declare type __VLS_Props_12 = {
     data: NavigatorData;
     /** Strip height in CSS pixels. Defaults to `theme.navigator.height` (60). */
     height?: number;
 };
 
-declare type __VLS_Props_12 = {
+declare type __VLS_Props_13 = {
     value: number;
     /**
      * Value-to-string formatter. Defaults to the current locale's
@@ -96,7 +111,7 @@ declare type __VLS_Props_12 = {
     spinDuration?: number;
 };
 
-declare type __VLS_Props_13 = {
+declare type __VLS_Props_14 = {
     /**
      * Owning series id. **Optional** — when omitted, the first visible pie
      * series is picked.
@@ -110,7 +125,7 @@ declare type __VLS_Props_13 = {
     position?: PieLegendPosition;
 };
 
-declare type __VLS_Props_14 = {
+declare type __VLS_Props_15 = {
     /**
      * Owning series id. **Optional** — when omitted, the first visible pie
      * series is picked.
@@ -120,7 +135,7 @@ declare type __VLS_Props_14 = {
     format?: ValueFormatter;
 };
 
-declare type __VLS_Props_15 = {
+declare type __VLS_Props_16 = {
     /** Horizontal line at this Y data value. Mutually exclusive with `time`. */
     value?: number;
     /** Vertical line at this `time` (epoch ms or `Date`). Mutually exclusive with `value`. */
@@ -135,14 +150,14 @@ declare type __VLS_Props_15 = {
     width?: number;
 };
 
-declare type __VLS_Props_16 = {
+declare type __VLS_Props_17 = {
     /** 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_17 = {
+declare type __VLS_Props_18 = {
     /** Left edge — epoch ms or a `Date`. */
     from: TimeValue;
     /** Right edge — epoch ms or a `Date`. Omit (or pass `'now'`) for an open-ended band to the right edge. */
@@ -155,7 +170,7 @@ declare type __VLS_Props_17 = {
     color?: string;
 };
 
-declare type __VLS_Props_18 = {
+declare type __VLS_Props_19 = {
     /**
      * @deprecated Use the named `sub` slot instead — it accepts arbitrary
      * inline markup (icons, badges, formatted text) to mirror React's
@@ -169,15 +184,10 @@ declare type __VLS_Props_18 = {
     sub?: string;
 };
 
-declare type __VLS_Props_19 = {
-    sort?: SnapshotSort;
-    format?: TooltipFormatter;
-};
-
 declare type __VLS_Props_2 = {
-    /** Flat `OHLCInput[]`, or `{ label, data }` to name the stream. */
-    data: CandlestickData;
-    options?: Partial<CandlestickSeriesOptions>;
+    /** Flat `TimePoint[]`, `TimePoint[][]`, or named `{ label, color?, data }` layers. Time accepts ms or `Date`. */
+    data: MultiLayerData;
+    options?: Partial<BarSeriesOptions>;
     /** Stable series ID — same value across remounts. */
     id?: string;
     /** Show/hide the series without unmounting it — excludes it from the Y-range fit and tooltip/legend. Default `true`. Live. */
@@ -185,6 +195,11 @@ declare type __VLS_Props_2 = {
 };
 
 declare type __VLS_Props_20 = {
+    sort?: SnapshotSort;
+    format?: TooltipFormatter;
+};
+
+declare type __VLS_Props_21 = {
     /** Custom tick-label formatter. Overrides the built-in range-adaptive default. */
     format?: ValueFormatter;
     /**
@@ -196,7 +211,7 @@ declare type __VLS_Props_20 = {
     minLabelSpacing?: number;
 };
 
-declare type __VLS_Props_21 = {
+declare type __VLS_Props_22 = {
     /**
      * Owning series id. **Optional** — when omitted, the first visible
      * single-layer time series is picked, falling back to the first visible
@@ -214,6 +229,16 @@ declare type __VLS_Props_21 = {
 };
 
 declare type __VLS_Props_3 = {
+    /** Flat `OHLCInput[]`, or `{ label, data }` to name the stream. */
+    data: CandlestickData;
+    options?: Partial<CandlestickSeriesOptions>;
+    /** Stable series ID — same value across remounts. */
+    id?: string;
+    /** Show/hide the series without unmounting it — excludes it from the Y-range fit and tooltip/legend. Default `true`. Live. */
+    visible?: boolean;
+};
+
+declare type __VLS_Props_4 = {
     /** Visual theme. Live — changing this at runtime updates all themed elements. */
     theme?: ChartTheme;
     /** Grouped axis configuration (Y/X visibility, bounds, sizing). Live. */
@@ -382,7 +407,7 @@ declare type __VLS_Props_3 = {
     onCrosshairMove?: (position: CrosshairPosition | null) => void;
 };
 
-declare type __VLS_Props_4 = {
+declare type __VLS_Props_5 = {
     data: HeatmapCellData[];
     options?: Partial<HeatmapSeriesOptions>;
     /** Stable series ID — same value across remounts. */
@@ -391,7 +416,7 @@ declare type __VLS_Props_4 = {
     visible?: boolean;
 };
 
-declare type __VLS_Props_5 = {
+declare type __VLS_Props_6 = {
     /** Flat `TimePoint[]`, `TimePoint[][]`, or named `{ label, color?, data }` layers. Time accepts ms or `Date`. */
     data: MultiLayerData;
     options?: Partial<LineSeriesOptions>;
@@ -401,7 +426,7 @@ declare type __VLS_Props_5 = {
     visible?: boolean;
 };
 
-declare type __VLS_Props_6 = {
+declare type __VLS_Props_7 = {
     data: PieSliceData[];
     options?: Partial<PieSeriesOptions>;
     /** Stable series ID — same value across remounts. */
@@ -410,7 +435,7 @@ declare type __VLS_Props_6 = {
     visible?: boolean;
 };
 
-declare type __VLS_Props_7 = {
+declare type __VLS_Props_8 = {
     /**
      * Owning series id. **Optional** — when omitted, the first visible heatmap
      * series is picked.
@@ -420,20 +445,11 @@ declare type __VLS_Props_7 = {
     format?: ValueFormatter;
 };
 
-declare type __VLS_Props_8 = {
+declare type __VLS_Props_9 = {
     sort?: SnapshotSort;
     format?: TooltipFormatter;
 };
 
-declare type __VLS_Props_9 = {
-    items?: LegendItemOverride[];
-    position?: 'bottom' | 'right';
-    /** `'isolate'` shows only the clicked item; `'solo'` is a @deprecated alias. */
-    mode?: LegendMode;
-    /** Fired after a click changes series visibility — via the built-in UI or a custom slot calling `item.toggle()`/`isolate()` directly. */
-    onToggle?: (info: LegendToggleInfo) => void;
-};
-
 declare function __VLS_template(): {
     attrs: Partial<{}>;
     slots: {
@@ -673,7 +689,7 @@ export declare const andromeda: ThemePreset;
  * - `axis.ticks` — axis tick label cross-fade.
  * - `toggle` — series visibility (alpha fade + Y re-fit, locked to one
  *   duration so they finish on the same frame).
- * - `series.{line,candlestick,bar,pie,heatmap}` — per-series-type data tweens.
+ * - `series.{line,candlestick,bar,band,pie,heatmap}` — per-series-type data tweens.
  *
  * Top-level `false` disables every animation category. `axis: false`
  * disables both axes and ticks. `axis.y: false` / `axis.x: false` disables
@@ -885,6 +901,34 @@ export declare interface AnimationsConfig {
              */
             smooth?: AnimationTime;
         };
+        /**
+         * Band-series tweens. `false` disables band entrance, intro and
+         * edge chase.
+         */
+        band?: false | {
+            /**
+             * Per-point entrance duration. `false` disables the entrance
+             * (equivalent to `entryAnimation: 'none'`).
+             *
+             * @default {@link DEFAULT_BAND_ENTRY}
+             */
+            entry?: AnimationTime;
+            /**
+             * Initial-load reveal on the first data seed. The value is the
+             * per-element wave duration; the full reveal lasts ~2×.
+             * `false` / `0` disables the intro.
+             *
+             * @default {@link DEFAULT_BAND_INTRO}
+             */
+            intro?: AnimationTime;
+            /**
+             * Edge chase duration on `updateLastPoint`. `false` / `0`
+             * snaps to the target instantly.
+             *
+             * @default {@link DEFAULT_BAND_SMOOTH}
+             */
+            smooth?: AnimationTime;
+        };
         /**
          * Pie segment entry/update tweens. `false` disables the slice
          * entry sweep (`update` is still parse-only; wiring lands in a
@@ -1051,6 +1095,113 @@ export declare const ayuMirage: ThemePreset;
  */
 export declare function backfillSweepIntro(): LineIntroFn;
 
+/**
+ * `data` shape for a band series — the same omnivorous forms as
+ * {@link MultiLayerData}, one band per layer: a flat `BandPointInput[]`, a
+ * layered `BandPointInput[][]`, a named `SeriesLayer`, or an array mixing both.
+ */
+export declare type BandData = BandPointInput[] | SeriesLayer<BandPointInput> | Array<BandPointInput[] | SeriesLayer<BandPointInput>>;
+
+/** Entrance styles for band points added via `appendData` — the same set as {@link LineEntryAnimation}. */
+export declare type BandEntryAnimation = LineEntryAnimation;
+
+/**
+ * A single band sample: the filled region between `low` and `high` at `time`.
+ * Time is a timestamp in milliseconds. A `low` above `high` is drawn with the
+ * edges swapped; a non-finite edge is a gap.
+ */
+export declare interface BandPoint {
+    time: number;
+    low: number;
+    high: number;
+}
+
+/** {@link BandPoint} that also accepts `Date` for the time field. */
+export declare type BandPointInput = Omit<BandPoint, 'time'> & {
+    time: TimeValue;
+};
+
+export declare const BandSeries: DefineComponent<__VLS_Props, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
+visible: boolean;
+}, {}, {}, {}, string, ComponentProvideOptions, false, {}, any>;
+
+/** Series definition for `chart.addSeries` — keeps the chart renderer-agnostic. */
+export declare const BandSeriesDef: SeriesDefinition<BandSeriesOptions>;
+
+/**
+ * Visual options for a band series — the filled region between a `low` and a
+ * `high` edge. Each layer is one band; layers draw in order with translucent
+ * fills, so nested bands of one color read as a fan chart. There is no
+ * stacking: a stack of ranges has no meaning.
+ */
+export declare interface BandSeriesOptions {
+    /**
+     * Fill between the edges: a flat color, or a `[top, bottom]` pair painted
+     * as a vertical gradient over each band's visible extent. Applies to every
+     * layer. Default: a gradient of the layer color from 40% opacity at the top
+     * to 4% at the bottom.
+     */
+    fill?: string | [string, string];
+    /** Edge strokes, in the layer color at 60% opacity. Default: `{ visible: true, width: 1 }`. */
+    stroke?: {
+        /** Whether the `low` and `high` edges are stroked. Default: `true`. */
+        visible?: boolean;
+        /** Stroke width in CSS pixels. Default: `1`. */
+        width?: number;
+        /** Stroke color for every layer. Default: the layer color at 60% opacity. */
+        color?: string;
+    };
+    /**
+     * Edge smoothing, with the same builders as the line series. Default:
+     * `'straight'`. `'smooth'` is monotone, so an edge never overshoots its own
+     * samples.
+     */
+    curve?: 'straight' | 'smooth' | 'stepped';
+    /**
+     * Entrance style for appended points. Default: `'grow'` — the trailing
+     * segment of both edges unfurls from the previous point.
+     *
+     * @see entryMs — cross-linked duration for this animation.
+     */
+    entryAnimation?: BandEntryAnimation;
+    /**
+     * Per-point entrance duration in milliseconds. Default: `250`. `false` or
+     * `0` disables the entrance. A chart-level `animations.series.band: false`
+     * wins over this field.
+     */
+    entryMs?: number | false;
+    /**
+     * Initial-load reveal duration in milliseconds; the full reveal lasts ~2×.
+     * Default: `500`. `false` or `0` disables it. Bulk re-seeds of a non-empty
+     * series never replay it. Skipped under `prefers-reduced-motion`.
+     */
+    introMs?: number | false;
+    /**
+     * Initial-load reveal choreography — the line series' `LineIntroFn`
+     * contract. The frame's `layerData` / `layerMean` / `primaryPath` describe
+     * each band's center, and a `value` transform applies to both edges.
+     * `heads` are ignored. Default: `unfoldIntro()` — the band opens out of its
+     * mean.
+     *
+     * @see introMs — cross-linked duration for this animation.
+     */
+    introAnimation?: LineIntroFn;
+    /**
+     * History-prepend reveal for older points loaded at the front. Default:
+     * `backfillSweepIntro()`. `'none'` makes prepended points appear at once.
+     *
+     * @see historyRevealMs — cross-linked duration for this animation.
+     */
+    historyReveal?: LineIntroFn | 'none';
+    /** History-prepend reveal duration in milliseconds. Default: `400`. `false` or `0` disables it. */
+    historyRevealMs?: number | false;
+    /**
+     * How long both displayed edges take to catch up on every
+     * `updateLastPoint`. Default: `250` ms. `0` or `false` snaps.
+     */
+    smoothMs?: number | false;
+}
+
 /** Declarative per-bar transform — translation and opacity only; growth is
  *  expressed through {@link BarIntroDirectives.value} instead so stacked
  *  columns rise as one attached unit. */
@@ -1161,7 +1312,7 @@ export declare interface BarPaintArgs {
 /** Paints one bar / stacked segment. Owns its fill — it calls `ctx.fill()`. */
 export declare type BarPainter = (env: PaintEnv, args: BarPaintArgs) => void;
 
-export declare const BarSeries: DefineComponent<__VLS_Props, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
+export declare const BarSeries: DefineComponent<__VLS_Props_2, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<__VLS_Props_2> & Readonly<{}>, {
 visible: boolean;
 }, {}, {}, {}, string, ComponentProvideOptions, false, {}, any>;
 
@@ -1390,7 +1541,7 @@ export declare interface BaseSeriesRenderer {
     /** Last data value for the series, or null if empty. Optional. */
     getLastValue?(): number | null;
     /** Nearest data point to a given time, or null. Optional. */
-    getDataAtTime?(time: number, interval: number): TimePoint | OHLCData | null;
+    getDataAtTime?(time: number, interval: number): TimePoint | OHLCData | BandPoint | null;
     /**
      * For multi-layer renderers: nearest data point per visible layer at `time`.
      * Each entry carries the owning `layerIndex` (so filtered hidden layers
@@ -1399,12 +1550,7 @@ export declare interface BaseSeriesRenderer {
      * tooltips/legends.
      * Returns null for single-layer renderers or when no visible layer has data.
      */
-    getLayerSnapshots?(time: number, interval: number): {
-        layerIndex: number;
-        time: number;
-        value: number;
-        color: string;
-    }[] | null;
+    getLayerSnapshots?(time: number, interval: number): LayerSnapshot[] | null;
     /**
      * Stacked last value — cumulative top of the rendered stack for multi-layer
      * renderers. Falls back to `getLastValue()` behavior for single-layer
@@ -1430,12 +1576,7 @@ export declare interface BaseSeriesRenderer {
      * primary layer's time.
      * Returns null for single-layer renderers or when no visible layer has data.
      */
-    getLayerLastSnapshots?(): {
-        layerIndex: number;
-        time: number;
-        value: number;
-        color: string;
-    }[] | null;
+    getLayerLastSnapshots?(): LayerSnapshot[] | null;
     /** Total data points across all owned stores. Used by Chart for batch-load detection. */
     getTotalLength?(): number;
     /**
@@ -1683,7 +1824,7 @@ declare interface CandlestickDirectionColors {
  */
 export declare type CandlestickEntryAnimation = 'none' | 'fade' | 'unfold' | 'slide' | 'fade-unfold';
 
-export declare const CandlestickSeries: DefineComponent<__VLS_Props_2, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<__VLS_Props_2> & Readonly<{}>, {
+export declare const CandlestickSeries: DefineComponent<__VLS_Props_3, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<__VLS_Props_3> & Readonly<{}>, {
 visible: boolean;
 }, {}, {}, {}, string, ComponentProvideOptions, false, {}, any>;
 
@@ -1929,6 +2070,12 @@ export declare class ChartInstance extends EventEmitter<ChartEvents> implements
         label?: string;
         labels?: (string | undefined)[];
     }>): string;
+    addSeries(type: 'band', options?: Partial<BandSeriesOptions & {
+        layers?: number;
+        id?: string;
+        label?: string;
+        labels?: (string | undefined)[];
+    }>): string;
     addSeries(type: 'pie', options?: Partial<PieSeriesOptions & {
         id?: string;
         label?: string;
@@ -2022,7 +2169,7 @@ export declare class ChartInstance extends EventEmitter<ChartEvents> implements
      */
     setSeriesData(id: string, data: unknown, layerIndex?: number): void;
     /** Append a new data point to the end of a series (real-time tick). */
-    appendData(id: string, point: OHLCInput | TimePointInput, layerIndex?: number): void;
+    appendData(id: string, point: OHLCInput | TimePointInput | BandPointInput, layerIndex?: number): void;
     /**
      * Prepend older points to the front of a series — the "load more history on
      * scroll" path. Unlike {@link setSeriesData}, this deliberately does NOT set
@@ -2036,9 +2183,9 @@ export declare class ChartInstance extends EventEmitter<ChartEvents> implements
      * first point; the sync reconciler guarantees this before calling here.
      * No-op if the renderer doesn't support prepend.
      */
-    prependData(id: string, points: (OHLCInput | TimePointInput)[], layerIndex?: number): void;
+    prependData(id: string, points: (OHLCInput | TimePointInput | BandPointInput)[], layerIndex?: number): void;
     /** Update the last data point of a series in place (e.g. live candle update). */
-    updateData(id: string, point: OHLCInput | TimePointInput, layerIndex?: number): void;
+    updateData(id: string, point: OHLCInput | TimePointInput | BandPointInput, layerIndex?: number): void;
     /**
      * Keep only the most recent `count` points of a series — drop the oldest
      * tail when the series exceeds the cap. Smooth Y-range chase (no snap):
@@ -2054,7 +2201,7 @@ export declare class ChartInstance extends EventEmitter<ChartEvents> implements
      */
     keepLast(id: string, count: number, layerIndex?: number): void;
     /** Update visual options (color, width, etc.) for an existing series. */
-    updateSeriesOptions(id: string, options: Partial<CandlestickSeriesOptions> | Partial<LineSeriesOptions> | Partial<BarSeriesOptions> | Partial<PieSeriesOptions> | Partial<HeatmapSeriesOptions>): void;
+    updateSeriesOptions(id: string, options: Partial<CandlestickSeriesOptions> | Partial<LineSeriesOptions> | Partial<BarSeriesOptions> | Partial<BandSeriesOptions> | Partial<PieSeriesOptions> | Partial<HeatmapSeriesOptions>): void;
     /**
      * Batch multiple updates: suppress recomputes until `fn` returns. Exceptions
      * inside `fn` still flush the batch so counters don't leak across calls.
@@ -2171,21 +2318,16 @@ export declare class ChartInstance extends EventEmitter<ChartEvents> implements
     } | null;
     /** Get the second-to-last value, useful for computing change. */
     getPreviousClose(seriesId: string): number | null;
-    getLastData(seriesId: string): OHLCData | TimePoint | null;
+    getLastData(seriesId: string): OHLCData | TimePoint | BandPoint | null;
     /** Find the data point closest to the given timestamp within one data interval. */
-    getDataAtTime(seriesId: string, time: number): OHLCData | TimePoint | null;
+    getDataAtTime(seriesId: string, time: number): OHLCData | TimePoint | BandPoint | null;
     /**
      * Get all layers' data at a given time for multi-layer series (Bar/Line
      * with stacking). Each entry carries the owning `layerIndex` and the
      * snapped sample time — callers must not derive layer identity from the
      * array index, because hidden layers are filtered out.
      */
-    getLayerSnapshots(seriesId: string, time: number): {
-        layerIndex: number;
-        time: number;
-        value: number;
-        color: string;
-    }[] | null;
+    getLayerSnapshots(seriesId: string, time: number): LayerSnapshot[] | null;
     getSeriesIds(): string[];
     /**
      * Whether pan/zoom gestures currently apply — true when any visible series
@@ -2233,12 +2375,7 @@ export declare class ChartInstance extends EventEmitter<ChartEvents> implements
      * overlay components that must display every layer in last-mode even
      * when layers advance at different rates (ragged streams).
      */
-    getLayerLastSnapshots(seriesId: string): {
-        layerIndex: number;
-        time: number;
-        value: number;
-        color: string;
-    }[] | null;
+    getLayerLastSnapshots(seriesId: string): LayerSnapshot[] | null;
     /** Get the primary display color for a series. */
     getSeriesColor(seriesId: string): string | null;
     /** The series' primary name (first layer). Used for single-layer overlays. */
@@ -2802,7 +2939,7 @@ export declare interface CustomSpatialSeriesRenderer extends BaseSeriesRenderer
  */
 export declare function deepEqual(a: unknown, b: unknown): boolean;
 
-declare const _default: DefineComponent<__VLS_Props_16, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<__VLS_Props_16> & Readonly<{}>, {}, {}, {}, {}, string, ComponentProvideOptions, false, {
+declare const _default: DefineComponent<__VLS_Props_17, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<__VLS_Props_17> & Readonly<{}>, {}, {}, {}, {}, string, ComponentProvideOptions, false, {
 containerRef: HTMLDivElement;
 }, HTMLDivElement>;
 export { _default as TimeAxis }
@@ -2960,7 +3097,7 @@ export declare interface HeatmapCellLabelsOptions {
     format?: (value: number) => string;
 }
 
-export declare const HeatmapSeries: DefineComponent<__VLS_Props_4, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<__VLS_Props_4> & Readonly<{}>, {
+export declare const HeatmapSeries: DefineComponent<__VLS_Props_5, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<__VLS_Props_5> & Readonly<{}>, {
 visible: boolean;
 }, {}, {}, {}, string, ComponentProvideOptions, false, {}, any>;
 
@@ -3011,7 +3148,7 @@ export declare interface HeatmapSeriesRenderer extends BaseSeriesRenderer {
     readonly kind: 'heatmap';
 }
 
-export declare const HeatmapTooltip: DefineComponent<__VLS_Props_7, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<__VLS_Props_7> & Readonly<{}>, {}, {}, {}, {}, string, ComponentProvideOptions, false, {}, any>;
+export declare const HeatmapTooltip: DefineComponent<__VLS_Props_8, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<__VLS_Props_8> & Readonly<{}>, {}, {}, {}, {}, string, ComponentProvideOptions, false, {}, any>;
 
 /**
  * Velocity-matched cubic Hermite Y transition. Direction-aware: per-call
@@ -3055,6 +3192,21 @@ export declare function isTimeSeriesRenderer(renderer: SeriesRenderer): renderer
 
 export declare const lavenderMist: ThemePreset;
 
+/**
+ * One layer's sample in a multi-layer query ({@link BaseSeriesRenderer.getLayerSnapshots}).
+ * `time` is the resolved sample time, not the query time. A band layer also
+ * carries its `low` / `high` edges; its `value` is then their midpoint, kept
+ * only for sorting and anchoring — display the edges instead.
+ */
+export declare interface LayerSnapshot {
+    layerIndex: number;
+    time: number;
+    value: number;
+    color: string;
+    low?: number;
+    high?: number;
+}
+
 export declare const Legend: __VLS_WithTemplateSlots_3<typeof __VLS_component_3, __VLS_TemplateResult_3["slots"]>;
 
 /**
@@ -3202,6 +3354,7 @@ export declare interface LineIntroFrame {
     /**
      * Mean of the layer's visible plottable values, taken on the Y axis (the
      * geometric mean on log), or `null` for an empty/poisoned layer (memoized per frame).
+     * On a percent stack, the layer's mean share of its column, in percent.
      */
     layerMean(layerIndex: number): number | null;
     /**
@@ -3219,7 +3372,10 @@ export declare interface LineIntroFrame {
 export declare interface LineIntroValueArgs {
     layerIndex: number;
     time: number;
-    /** The value the renderer would draw without the intro (live smoothing included). */
+    /**
+     * The value the renderer would draw without the intro (live smoothing included).
+     * On a percent stack, the layer's share of its column, in percent.
+     */
     value: number;
     /** Normalized x-position of `time` across the visible range, clamped to `[0, 1]`. */
     position: number;
@@ -3264,7 +3420,7 @@ declare interface LinePoint {
     y: number;
 }
 
-export declare const LineSeries: DefineComponent<__VLS_Props_5, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<__VLS_Props_5> & Readonly<{}>, {
+export declare const LineSeries: DefineComponent<__VLS_Props_6, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<__VLS_Props_6> & Readonly<{}>, {
 visible: boolean;
 }, {}, {}, {}, string, ComponentProvideOptions, false, {}, any>;
 
@@ -3557,7 +3713,7 @@ export declare interface LogScaleOptions {
     base?: number;
 }
 
-export declare const Marker: DefineComponent<__VLS_Props_10, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<__VLS_Props_10> & Readonly<{}>, {}, {}, {}, {}, string, ComponentProvideOptions, false, {}, any>;
+export declare const Marker: DefineComponent<__VLS_Props_11, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<__VLS_Props_11> & Readonly<{}>, {}, {}, {}, {}, string, ComponentProvideOptions, false, {}, any>;
 
 /**
  * A point annotation pinned to a `time` (X) and a `value` (Y) — "anomaly opened
@@ -3669,7 +3825,7 @@ declare interface MorphPlaceholder {
  */
 export declare type MultiLayerData = TimePointInput[] | SeriesLayer<TimePointInput> | Array<TimePointInput[] | SeriesLayer<TimePointInput>>;
 
-declare const Navigator_2: DefineComponent<__VLS_Props_11, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<__VLS_Props_11> & Readonly<{}>, {}, {}, {}, {}, string, ComponentProvideOptions, false, {
+declare const Navigator_2: DefineComponent<__VLS_Props_12, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<__VLS_Props_12> & Readonly<{}>, {}, {}, {}, {}, string, ComponentProvideOptions, false, {
 stripRef: HTMLDivElement;
 }, any>;
 export { Navigator_2 as Navigator }
@@ -3762,7 +3918,7 @@ 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_12, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<__VLS_Props_12> & Readonly<{}>, {
+export declare const NumberFlow: DefineComponent<__VLS_Props_13, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<__VLS_Props_13> & Readonly<{}>, {
 locale: string;
 spinDuration: number;
 }, {}, {}, {}, string, ComponentProvideOptions, false, {}, HTMLSpanElement>;
@@ -4080,7 +4236,7 @@ declare interface PieOtherOptions {
     color?: string;
 }
 
-export declare const PieSeries: DefineComponent<__VLS_Props_6, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<__VLS_Props_6> & Readonly<{}>, {
+export declare const PieSeries: DefineComponent<__VLS_Props_7, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<__VLS_Props_7> & Readonly<{}>, {
 visible: boolean;
 }, {}, {}, {}, string, ComponentProvideOptions, false, {}, any>;
 
@@ -4261,7 +4417,7 @@ declare interface Rect {
     height: number;
 }
 
-export declare const ReferenceLine: DefineComponent<__VLS_Props_15, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<__VLS_Props_15> & Readonly<{}>, {}, {}, {}, {}, string, ComponentProvideOptions, false, {}, any>;
+export declare const ReferenceLine: DefineComponent<__VLS_Props_16, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<__VLS_Props_16> & Readonly<{}>, {}, {}, {}, {}, string, ComponentProvideOptions, false, {}, any>;
 
 /**
  * A straight reference line across the plot — a horizontal threshold / baseline
@@ -4303,7 +4459,7 @@ declare interface RegionEntry {
 }
 
 /**
- * Register the five built-in series so the string form
+ * Register the six built-in series so the string form
  * `chart.addSeries('line', …)` resolves. Call it once at startup.
  *
  * Importing this helper pulls every renderer into the bundle — hosts that
@@ -4485,7 +4641,7 @@ export declare interface SeriesHoverInfo {
  * series (see {@link CustomSpatialSeriesRenderer} / {@link TimeSeriesRenderer})
  * picks any string that isn't one of the built-ins.
  */
-export declare type SeriesKind = 'candlestick' | 'line' | 'bar' | 'pie' | 'heatmap' | (string & {});
+export declare type SeriesKind = 'candlestick' | 'line' | 'bar' | 'band' | 'pie' | 'heatmap' | (string & {});
 
 /**
  * A single named (and optionally colored) layer. Carries the layer's display
@@ -4546,19 +4702,21 @@ export declare type SeriesRenderer = TimeSeriesRenderer | PieSeriesRenderer | He
  *   grouping (e.g. `snapshots.filter(s => s.seriesId === 'btc')`).
  *
  * `data` is a shallow clone, frozen along with the snapshot itself — a slot
- * consumer cannot accidentally mutate the chart's internal store.
+ * consumer cannot accidentally mutate the chart's internal store. Its shape
+ * follows the series: `OHLCData` for a candlestick, `TimePoint` for a line or
+ * bar, `BandPoint` (`{ time, low, high }`) for a band.
  */
 export declare interface SeriesSnapshot {
     readonly id: string;
     readonly seriesId: string;
     readonly layerIndex?: number;
     readonly label?: string;
-    readonly data: Readonly<OHLCData> | Readonly<TimePoint>;
+    readonly data: Readonly<OHLCData> | Readonly<TimePoint> | Readonly<BandPoint>;
     readonly color: string;
 }
 
 /** Primary series types. Open-ended — a custom {@link SeriesDefinition} picks any string that isn't a built-in. */
-export declare type SeriesType = 'candlestick' | 'line' | 'bar' | 'pie' | 'heatmap' | (string & {});
+export declare type SeriesType = 'candlestick' | 'line' | 'bar' | 'band' | 'pie' | 'heatmap' | (string & {});
 
 /** Width and height pair. */
 declare interface Size {
@@ -4779,7 +4937,7 @@ export declare type TimePointInput = Omit<TimePoint, 'time'> & {
     time: TimeValue;
 };
 
-export declare const TimeRegion: DefineComponent<__VLS_Props_17, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<__VLS_Props_17> & Readonly<{}>, {}, {}, {}, {}, string, ComponentProvideOptions, false, {}, any>;
+export declare const TimeRegion: DefineComponent<__VLS_Props_18, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<__VLS_Props_18> & Readonly<{}>, {}, {}, {}, {}, string, ComponentProvideOptions, false, {}, any>;
 
 /**
  * A translucent vertical band shading the interval `[from, to]` — Grafana's
@@ -4819,20 +4977,20 @@ export declare type TimeRegionEnd = TimeValue | 'now';
  * pinned to layer 0 (see {@link BaseMultiLayerSeries}).
  */
 export declare interface TimeSeriesRenderer extends BaseSeriesRenderer {
-    readonly kind: 'candlestick' | 'line' | 'bar' | (string & {});
+    readonly kind: 'candlestick' | 'line' | 'bar' | 'band' | (string & {});
     /** Earliest/latest sample time across all owned layers, or null when empty. */
     getTimeBounds(): {
         first: number;
         last: number;
     } | null;
     /** Last data point (layer 0 for multi-layer), or null when empty. */
-    getLastDataPoint(): OHLCData | TimePoint | null;
+    getLastDataPoint(): OHLCData | TimePoint | BandPoint | null;
     /** Second-to-last data point (layer 0 for multi-layer), or null. */
-    getSecondLastDataPoint(): OHLCData | TimePoint | null;
+    getSecondLastDataPoint(): OHLCData | TimePoint | BandPoint | null;
     /** First `maxCount` sample times from the first populated layer — feeds interval detection. */
     sampleTimes(maxCount: number): number[];
     /** Visible points in `[from, to]` (layer 0 for multi-layer). */
-    getVisibleDataPoints(from: number, to: number): readonly (OHLCData | TimePoint)[];
+    getVisibleDataPoints(from: number, to: number): readonly (OHLCData | TimePoint | BandPoint)[];
     /**
      * Effective min/max for auto-range (stacked totals for multi-layer; raw
      * min/max otherwise). With `opts.plottable` (a non-linear Y scale) values
@@ -5257,7 +5415,7 @@ export declare class XScale {
     private countTicks;
 }
 
-export declare const YAxis: DefineComponent<__VLS_Props_20, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<__VLS_Props_20> & Readonly<{}>, {}, {}, {}, {}, string, ComponentProvideOptions, false, {
+export declare const YAxis: DefineComponent<__VLS_Props_21, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<__VLS_Props_21> & Readonly<{}>, {}, {}, {}, {}, string, ComponentProvideOptions, false, {
 containerRef: HTMLDivElement;
 }, HTMLDivElement>;