@wick-charts/vue 0.6.2 → 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. */
@@ -268,7 +293,7 @@ declare type __VLS_Props_3 = {
      * change, use `viewport.initialRange` instead.
      */
     visibleRange?: VisibleRangeSpec;
-    /** Show the chart background gradient. Live. Defaults to true. */
+    /** Show the chart background gradient. Live. Defaults to false. */
     gradient?: boolean;
     /**
      * Enable zoom, pan, and crosshair interactions. Defaults to true.
@@ -285,16 +310,20 @@ declare type __VLS_Props_3 = {
      * Soft fade-out at the top of the plot area, so series content dissolves
      * under a floating `<Title>` / `<InfoBar>` instead of colliding with it.
      * The mask erases canvas alpha rather than painting a cover color, so it
-     * stays correct over the default background gradient. Live.
+     * stays correct over a background gradient. Live.
      *
      * Two directions, independently controlled:
      *
      * **X (under the axis)** — panning content slides under the Y-axis
      * column and dissolves instead of hard-clipping at the pane edge. **On
      * by default** as a 60px ramp that finishes just inside the axis
-     * column, before the label glyphs; `{ right }` overrides the total
-     * ramp width in CSS px (`0` disables). `{ left }` adds the mirror zone
-     * at the left pane edge (default off).
+     * column, before the label glyphs — on whichever side
+     * `axis.y.position` puts it (a left-axis ramp ends at the pane edge
+     * instead). The axis side's key (`{ right }` by default, `{ left }` for
+     * a left axis) overrides the total ramp width in CSS px (`0` disables);
+     * the other key adds a plain zone at the opposite pane edge (default
+     * off). A chart with only pie / heatmap series has no axis column, so
+     * both keys add plain zones there.
      *
      * **Top (under the header)** — opt-in. `true` enables the auto zone
      * (measured header + 24px run-out, half the header fold-in released so
@@ -378,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. */
@@ -387,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>;
@@ -397,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. */
@@ -406,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.
@@ -416,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: {
@@ -669,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
@@ -881,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
@@ -1047,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. */
@@ -1080,8 +1235,9 @@ export declare interface BarIntroDirectives {
         fromX?: number;
         toX?: number;
     };
-    /** Per-value transform applied before geometry and stacking. Scaling the
-     *  value grows the bar from the baseline on every render path. */
+    /** Per-value transform applied before geometry. Moving the value from
+     *  `frame.baseline` grows the bar on every render path. A stack applies it
+     *  to each segment before stacking, or to each drawn edge on a non-linear axis. */
     value?: (args: BarIntroValueArgs) => number;
     /** Per-bar transform applied after the geometry is resolved. */
     element?: (el: BarIntroElement) => BarElementTransform;
@@ -1109,6 +1265,14 @@ export declare type BarIntroFn = (frame: BarIntroFrame) => BarIntroDirectives;
 export declare interface BarIntroFrame extends WaveIntroFrame {
     /** Time → bitmap X through the live time scale. */
     timeToX(time: number): number;
+    /** The value bars grow from: `0`, or the plot floor's value on a scale with no place for 0 (log). */
+    baseline: number;
+    /**
+     * The value `t` of the way from `from` to `to` on the Y axis — a plain lerp
+     * on a linear axis, a geometric one on log. Grow bars through this: a bare
+     * `value * t` stays below a log axis's floor for most of the intro.
+     */
+    lerpValue(from: number, to: number, t: number): number;
 }
 
 /** Arguments handed to {@link BarIntroDirectives.value} for every rendered value. */
@@ -1148,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>;
 
@@ -1377,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
@@ -1386,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
@@ -1417,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;
     /**
@@ -1670,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>;
 
@@ -1873,7 +2027,20 @@ export declare class ChartInstance extends EventEmitter<ChartEvents> implements
     readonly timeScale: XScale;
     /** Maps price/value to vertical pixel coordinates. */
     readonly yScale: YScale;
+    /** CSS px of the Y-axis column. The default collapses to `0` on a spatial-only chart. */
     get yAxisWidth(): number;
+    /** Side of the plot area the Y-axis column sits on. */
+    get yAxisPosition(): YAxisPosition;
+    /**
+     * Left edge of the plot area in container CSS px — the Y-axis width when
+     * the axis sits on the left, `0` otherwise. Scales map into the plot area,
+     * so add this to `timeScale.timeToX()` to get a container coordinate.
+     */
+    get plotLeft(): number;
+    /** CSS px height of the floating Title / InfoBar header, `0` without one. A left
+     *  axis shares its column with it, so tick labels fade out underneath. */
+    get headerHeight(): number;
+    /** CSS px of the time-axis row. The default collapses to `0` on a spatial-only chart. */
     get xAxisHeight(): number;
     constructor(container: HTMLElement, options?: ChartOptions);
     /**
@@ -1903,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;
@@ -1996,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
@@ -2010,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):
@@ -2028,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.
@@ -2145,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
@@ -2207,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. */
@@ -2293,6 +2456,9 @@ export declare class ChartInstance extends EventEmitter<ChartEvents> implements
      * the next render frame.
      */
     setFade(fade: ChartOptions['fade']): void;
+    /** Report the floating header's height (see {@link headerHeight}). The
+     *  framework wrappers keep it in sync with the measured Title / InfoBar. */
+    setHeaderHeight(height: number): void;
     /**
      * Set the visual state for one side of the chart. Typically called in
      * response to the `onEdgeReached` callback:
@@ -2368,8 +2534,10 @@ export declare class ChartInstance extends EventEmitter<ChartEvents> implements
 
 /** Layout metrics describing the chart area, Y axis, and time axis sizes. */
 export declare interface ChartLayout {
+    /** Plot area in container CSS px — `x` is the Y-axis width when the axis sits on the left. */
     chartArea: Rect;
     yAxisWidth: number;
+    yAxisPosition: YAxisPosition;
     xAxisHeight: number;
 }
 
@@ -2437,11 +2605,11 @@ export declare interface ChartOptions {
      * Soft alpha fade applied at the edges of the plot area. Anything the main
      * layer draws inside a zone (series, grid, time-region bands) dissolves to
      * transparent as it approaches the edge: horizontally sliding under the
-     * Y-axis labels on the right (`right`, **on by default**), toward a
-     * floating Title / InfoBar at the top (`top`), or out the left edge
-     * (`left`). The mask *erases* pixels rather than painting a cover color,
+     * Y-axis labels (the axis side, **on by default**), toward a floating
+     * Title / InfoBar at the top (`top`), or out the edge opposite the axis.
+     * The mask *erases* pixels rather than painting a cover color,
      * so it stays correct over any container background — including the
-     * default CSS gradient. Live — `chart.setFade()` updates it after
+     * optional CSS gradient. Live — `chart.setFade()` updates it after
      * construction.
      */
     fade?: FadeConfig;
@@ -2771,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 }
@@ -2818,18 +2986,30 @@ declare interface FadeConfig {
      *  area. `0` / omitted disables the mask. */
     top?: number;
     /**
-     * Total width in CSS pixels of the horizontal dissolve at the right edge.
-     * The ramp finishes just inside the Y-axis column — 12px past the pane
-     * edge, before the right-anchored label glyphs start — so content melts
-     * on approach (pan / tail-scroll exit) and is fully gone before it can
-     * cross any axis text; the rest of the width runs backward into the pane
-     * as a soft lead-in. **Defaults to a 60px ramp** — on out of the box;
+     * Width in CSS pixels of the horizontal dissolve at the right edge.
+     *
+     * On the Y-axis side (the default `axis.y.position`) this is the total
+     * width of a ramp that finishes just inside the axis column — 12px past
+     * the pane edge, before the label glyphs start — so content melts on
+     * approach (pan / tail-scroll exit) and is fully gone before it can cross
+     * any axis text; the rest of the width runs backward into the pane as a
+     * soft lead-in. **Defaults to a 60px ramp** there — on out of the box;
      * `0` disables. A no-op while the Y axis is hidden.
+     *
+     * On the side opposite the axis it's a plain zone at the pane edge —
+     * content leaving the plot dissolves instead of hard-clipping at the
+     * canvas boundary. Off by default.
+     *
+     * A chart whose series are all spatial (pie, heatmap) has no axis column,
+     * so both sides take the plain zone, off by default.
      */
     right?: number;
-    /** Fade-zone width in CSS pixels at the left pane edge — content panning
-     *  out to the left dissolves instead of hard-clipping at the canvas
-     *  boundary. `0` / omitted disables. */
+    /**
+     * Width in CSS pixels of the horizontal dissolve at the left edge. Same
+     * rules as {@link right}, except that with `axis.y.position: 'left'` the
+     * ramp (60px by default) finishes at the pane edge rather than under the
+     * column: data scrolls out through the left edge and isn't drawn past it.
+     */
     left?: number;
 }
 
@@ -2917,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>;
 
@@ -2968,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
@@ -3012,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"]>;
 
 /**
@@ -3146,11 +3341,21 @@ export declare interface LineIntroFrame {
     xToTime(x: number): number;
     /** Value → bitmap Y through the live Y scale. */
     valueToY(value: number): number;
+    /**
+     * The value `t` of the way from `from` to `to` on the Y axis — a plain lerp
+     * on a linear axis, a geometric one on log. Move values through this, or a
+     * log axis bunches the motion at one end and overshoots past 0.
+     */
+    lerpValue(from: number, to: number, t: number): number;
     /** Number of layers in the series. */
     layerCount: number;
     /** Visible data of one layer (memoized per frame). */
     layerData(layerIndex: number): readonly TimePoint[];
-    /** Mean of the layer's visible finite values, or `null` for an empty/poisoned layer (memoized per frame). */
+    /**
+     * 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;
     /**
      * Bitmap-space polyline of the first visible layer (finite values only,
@@ -3167,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;
@@ -3212,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>;
 
@@ -3487,7 +3695,25 @@ export declare interface LoadingIndicatorArgs {
 /** Pure function contract for a pluggable loading indicator. */
 export declare type LoadingIndicatorFn = (args: LoadingIndicatorArgs) => void;
 
-export declare const Marker: DefineComponent<__VLS_Props_10, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<__VLS_Props_10> & Readonly<{}>, {}, {}, {}, {}, string, ComponentProvideOptions, false, {}, any>;
+/**
+ * Logarithmic Y scale for `axis.y.scale`: each power of the base gets the same
+ * height. Ticks sit on powers of the base, thinned when they crowd and — for
+ * base 10 — with 2× / 5× steps when a decade has room; a range too narrow to
+ * catch a power falls back to linear ticks. Values ≤ 0 have no position.
+ *
+ * Tree-shakeable: charts that never call it don't ship the log code.
+ */
+export declare function logScale(options?: LogScaleOptions): YScaleTransform;
+
+export declare interface LogScaleOptions {
+    /**
+     * Base whose powers carry the ticks. The mapping itself is the same for
+     * every base — only tick placement changes. Default: 10.
+     */
+    base?: number;
+}
+
+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
@@ -3599,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 }
@@ -3621,8 +3847,9 @@ export declare interface NavigatorCandlePoint {
  * 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).
+ * Both layers reserve `chart.yAxisWidth` on the Y-axis side 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 on next frame (canvas untouched)
@@ -3691,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>;
@@ -3779,6 +4006,12 @@ declare interface PanZoomTarget {
      * chart keeps working. Targets that omit the hook are always pan/zoomable.
      */
     canPanZoom?(): boolean;
+    /**
+     * Left edge of the plot area in canvas CSS px — nonzero when the Y axis
+     * sits on the left. Pointer offsets subtract it before mapping through the
+     * time scale. Omitted means `0`.
+     */
+    readonly plotLeft?: number;
 }
 
 /**
@@ -4003,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>;
 
@@ -4184,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
@@ -4226,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
@@ -4355,6 +4588,24 @@ export declare function sampleRamp(stops: readonly string[], t: number): string;
 
 export declare const sandDune: ThemePreset;
 
+/** What a {@link YScaleTransform.ticks} generator is asked to fill. */
+export declare interface ScaleTickArgs {
+    /** Visible value range. Both bounds are plottable on the scale. */
+    min: number;
+    max: number;
+    /** Plot height in CSS pixels. */
+    height: number;
+    /** Minimum pixel gap between adjacent labels. */
+    minSpacing: number;
+    /** Desired label count from `<YAxis labelCount>`, or `null`. */
+    labelCount: number | null;
+    /**
+     * Linear {1,2,5}×10^k ticks already spaced for this mapping (with the axis's
+     * anti-flicker hold). Return this array itself to keep them.
+     */
+    linear: readonly number[];
+}
+
 /** Environment the chart hands a {@link SeriesDefinition} when constructing its renderer. */
 export declare interface SeriesCreateEnv {
     /** Active chart theme — definitions read their default colours from it. */
@@ -4390,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
@@ -4451,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 {
@@ -4684,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
@@ -4724,25 +4977,32 @@ 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)[];
-    /** Effective min/max for auto-range (stacked totals for multi-layer; raw min/max otherwise). */
-    getValueRange(from: number, to: number): {
+    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
+     * it rejects are left out, so the range covers only what the scale can
+     * place; `null` when nothing plottable is in view.
+     */
+    getValueRange(from: number, to: number, opts?: ValueRangeOptions): {
         min: number;
         max: number;
     } | null;
+    /** Stacking mode of a multi-layer series — the chart rejects `'percent'` on a Y scale with no 0. */
+    readonly stacking?: StackingMode;
 }
 
 /** Custom tick-value generator — replaces the built-in `niceTimeIntervals` tier resolution entirely when installed. */
@@ -4781,10 +5041,16 @@ export declare interface TooltipPosition {
  * time-series, full media size for pie).
  */
 export declare interface TooltipPositionArgs {
-    /** Cursor or anchor x in CSS pixels, relative to the chart area origin. */
+    /** Cursor or anchor x in CSS pixels, relative to the overlay container. */
     x: number;
     /** Cursor or anchor y in CSS pixels, relative to the chart area origin. */
     y: number;
+    /**
+     * Left edge of the plot area in the same space as `x` — `chart.plotLeft`
+     * for a time-series tooltip, so it stays clear of a left-side Y axis.
+     * The result is in that space too. Default `0`.
+     */
+    chartLeft?: number;
     /** Plot-area width in CSS pixels. */
     chartWidth: number;
     /** Plot-area height in CSS pixels. */
@@ -4946,6 +5212,12 @@ declare type ValueColor = string | ((value: number) => string);
 /** Signature for a value-to-string formatter (YAxis, YLabel, Pie, Sparkline, NumberFlow). */
 export declare type ValueFormatter = (value: number) => string;
 
+/** Options for {@link TimeSeriesRenderer.getValueRange}. */
+declare interface ValueRangeOptions {
+    /** Whether a value has a position on the Y scale (e.g. `v > 0` on log); others are left out. */
+    plottable?: (value: number) => boolean;
+}
+
 /** Custom tick-value generator — replaces the built-in {1,2,5}×10^k resolution entirely when installed. */
 export declare type ValueTickGenerator = (range: YRange) => number[];
 
@@ -5036,7 +5308,7 @@ export declare function wipeIntro(): WaveIntroFn;
 
 /** Configuration for the X (time) axis. */
 export declare interface XAxisConfig {
-    /** Height in CSS pixels. Default: 30. */
+    /** Height in CSS pixels. Default: 30, or 0 when every series is spatial (pie, heatmap). */
     height?: number;
     /** Whether the axis is visible. Default: true. When false, height is treated as 0. */
     visible?: boolean;
@@ -5143,14 +5415,32 @@ 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>;
 
 /** Configuration for the Y axis. */
 export declare interface YAxisConfig {
-    /** Width in CSS pixels. Default: 55. */
+    /**
+     * Side the axis column sits on — the plot area shifts right by the axis
+     * width when it's `'left'`. The default edge fade follows the axis to
+     * whichever side it's on. Default: 'right'.
+     */
+    position?: YAxisPosition;
+    /** Width in CSS pixels. Default: 55, or 0 when every series is spatial (pie, heatmap). */
     width?: number;
+    /**
+     * Value mapping. Omitted: linear. `logScale()` gives each power of ten equal
+     * height — for series spanning orders of magnitude; `logScale({ base: 2 })`
+     * puts the ticks on powers of two. Any {@link YScaleTransform} works.
+     *
+     * Autoscale and Y animations run in the scale's space. Values the scale
+     * can't place (≤ 0 on log) are skipped — a gap in a line, no bar or candle —
+     * a fixed `min` / `max` it can't place falls back to `'auto'`, and area
+     * fills close to the plot floor. Percent stacking is rejected when the
+     * scale has no position for 0. Live — a different scale refits the Y range.
+     */
+    scale?: YScaleTransform;
     /** Minimum bound. Default: 'auto'. */
     min?: AxisBound;
     /** Maximum bound. Default: 'auto'. */
@@ -5159,6 +5449,9 @@ export declare interface YAxisConfig {
     visible?: boolean;
 }
 
+/** Side of the plot area the Y axis column sits on. */
+export declare type YAxisPosition = 'left' | 'right';
+
 export declare const YLabel: __VLS_WithTemplateSlots_8<typeof __VLS_component_8, __VLS_TemplateResult_8["slots"]>;
 
 /**
@@ -5197,8 +5490,13 @@ export declare interface YRange {
 export declare class YScale {
     /** Shared fade state for Y ticks; see {@link TimeScale.tickTracker}. */
     readonly tickTracker: AxisTickTracker;
+    /** Non-linear value mapping (`axis.y.scale`); `null` is linear. */
+    private transform;
     private min;
     private max;
+    /** Domain bounds in scale space — `transform.forward` of `min` / `max`. */
+    private lo;
+    private hi;
     private height;
     private pixelRatio;
     private labelCountHintValue;
@@ -5215,6 +5513,8 @@ export declare class YScale {
      * the boundary doesn't instantly flip back.
      */
     private lastRawInterval;
+    /** The transform's own ticks (e.g. powers of ten); `null` while linear ticks are in use. */
+    private ownTicks;
     /** Custom formatter (driven by `<YAxis format=…>`). */
     private customFormat;
     /** Custom tick generator — bypasses {1,2,5}×10^k resolution in `niceTickValues` when set. */
@@ -5223,11 +5523,23 @@ export declare class YScale {
     private get minLabelSpacing();
     /** Recalculate the scale with a new Y range, chart height, and device pixel ratio. */
     update(range: YRange, mediaHeight: number, pixelRatio: number): void;
+    /** Install a non-linear value mapping, or `null` for linear. The range is kept as-is — the chart refits it. */
+    setTransform(transform: YScaleTransform | null): void;
+    getTransform(): YScaleTransform | null;
+    /**
+     * Whether `value` has a position on this scale: finite, and inside the
+     * transform's domain (positive on log). Renderers skip values that fail —
+     * {@link valueToY} still maps them (to the plot floor) so nothing
+     * downstream sees NaN.
+     */
+    isPlottable(value: number): boolean;
     /** Desired label count. Invalid values (NaN, <2, Infinity) clear the hint. */
     setLabelCount(n: number | null | undefined): void;
     /** Minimum pixel gap between adjacent labels. */
     setMinSpacing(px: number | null | undefined): void;
     private resetHysteresis;
+    /** A transformed domain needs both bounds plottable; anything else collapses to a flat one. */
+    private updateDomain;
     /** Install (or clear) a custom formatter. */
     setFormat(fn: ValueFormatter | null): void;
     /** Read back the currently installed formatter — null when the built-in is active. */
@@ -5238,7 +5550,10 @@ export declare class YScale {
      * with the current range.
      */
     setTickGenerator(fn: ValueTickGenerator | null): void;
-    /** Convert a value to a Y position in CSS (media) pixels. */
+    /**
+     * Convert a value to a Y position in CSS (media) pixels. A value the
+     * transform can't place (≤ 0 on log) lands on the plot floor.
+     */
     valueToY(value: number): number;
     /** Convert a value to a Y position in physical (bitmap) pixels, snapped to
      *  the pixel grid — for axis-aligned edges that have to stay crisp. */
@@ -5255,13 +5570,23 @@ export declare class YScale {
      * so text and gridline share one pixel grid.
      */
     valueToSnappedY(value: number): number;
-    /** Convert a Y position in CSS pixels back to a value. */
+    /** Convert a Y position in CSS pixels back to a value — the exact inverse of {@link valueToY}. */
     yToValue(y: number): number;
+    /** The value bars and stacks grow from: `0`, or the plot floor's value on a scale with no place for 0 (log). */
+    baselineValue(): number;
+    /**
+     * The value `t` of the way from `from` to `to` in pixels — a plain lerp on a
+     * linear axis, a geometric one on log. `t` past `[0, 1]` overshoots along the
+     * axis. An endpoint the transform can't place returns `to`, so a gap stays a gap.
+     */
+    lerpValue(from: number, to: number, t: number): number;
     /**
      * Generate evenly spaced "nice" tick values for the current range and
      * chart height. Pure read — resolution happens in `update()`.
      */
     niceTickValues(): number[];
+    /** {1,2,5}×10^k ticks at the resolved interval, limited to what the transform can place. */
+    private linearTickValues;
     getRange(): YRange;
     getMediaHeight(): number;
     /**
@@ -5272,9 +5597,18 @@ export declare class YScale {
      * range happens to be < 1000.
      */
     formatY(value: number): string;
+    private resolveTicks;
+    /**
+     * Smallest linear interval whose ticks stay `minLabelSpacing` apart on the
+     * transformed axis. A monotonic mapping squeezes its gaps hardest at one
+     * end — the top for log (concave), the bottom for a convex one — so
+     * checking both ends covers it.
+     */
+    private transformedGapFloor;
     /**
      * Resolve the interval to a {1,2,5}×10^k tick size that satisfies the pixel
-     * floor and (optionally) targets `labelCountHint` labels.
+     * floor and (optionally) targets `labelCountHint` labels. `gapFloorValue` is
+     * the smallest interval that clears `minLabelSpacing` anywhere on the axis.
      *
      * Hysteresis: the band [0.8×, 1.25×] is anchored to **rawInterval at last
      * snap**, not to `lastInterval`. After an escalation (e.g. 100 → 200),
@@ -5287,4 +5621,43 @@ export declare class YScale {
     private countTicks;
 }
 
+/**
+ * A non-linear value mapping for the Y axis — pass one as `axis.y.scale`.
+ * `logScale()` is the built-in one; any monotonic mapping works, e.g. a
+ * square-root axis:
+ *
+ * ```ts
+ * const sqrtScale: YScaleTransform = {
+ *   forward: Math.sqrt,
+ *   inverse: (s) => s * s,
+ *   isPlottable: (v) => v >= 0,
+ * };
+ * ```
+ *
+ * Everything vertical runs in the transformed space: pixel positions,
+ * autoscale padding and the Y animations. Keep the object stable — define it
+ * outside a component, since a new object means a new scale and resets the
+ * Y range.
+ */
+export declare interface YScaleTransform {
+    /** Value → scale space. Must be strictly increasing over the plottable values. */
+    forward(value: number): number;
+    /** Scale space → value; the exact inverse of {@link forward}. */
+    inverse(scaled: number): number;
+    /**
+     * Whether a finite value has a position on this scale — one contiguous
+     * interval, e.g. `v > 0` for log. Values that fail are skipped: a gap in a
+     * line, no bar or candle, left out of autoscale. Default: every finite value.
+     */
+    isPlottable?(value: number): boolean;
+    /**
+     * The scale's own tick values (e.g. powers of ten), or `args.linear` to keep
+     * the linear ticks — say, on a range too narrow for its own. Omitted: linear
+     * ticks, spaced so the tightest gap on this mapping clears `minSpacing`.
+     */
+    ticks?(args: ScaleTickArgs): readonly number[];
+    /** Label format while the scale's own ticks are in use. Default: the linear formatter. */
+    format?(value: number): string;
+}
+
 export { }