@wick-charts/vue 0.6.3 → 0.7.0

package/dist/core/dist/chart.js

@@ -1,64 +1,100 @@
-import { Animator as K } from "./animation/animator.js";
-import { AnimationConfig as j, DEFAULT_LINE_PULSE as q } from "./animation/config.js";
+import { Animator as nt } from "./animation/animator.js";
+import { AnimationConfig as at, DEFAULT_LINE_PULSE as ot } from "./animation/config.js";
 import { easeOutCubic as W } from "./animation/easing.js";
-import { prefersReducedMotion as J } from "./animation/reduced-motion.js";
-import { createViewportEngine as Q } from "./animation/viewport-engine.js";
-import { CanvasManager as tt } from "./canvas-manager.js";
-import { resolveEdgeAnchorValue as it, drawEdgeIndicators as et, resolveEdgeBoundary as st } from "./chart/edge-indicators.js";
-import { computeFitToData as rt } from "./chart/fit-to-data.js";
-import { getLastValue as nt, getPreviousClose as at, getStackedLastValue as ot } from "./chart/last-value.js";
-import { resolveFade as O, resolveMaxVisibleBars as ht, resolvePadding as F, resolvePerfOptions as lt, isSameHorizontalPadding as N } from "./chart/options.js";
-import { computePan as ct, computeZoom as dt } from "./chart/pan-zoom-math.js";
-import { warnUnplottableBounds as E, assertStackingFitsScale as M, warnUnplottableValues as ut } from "./chart/scale-guards.js";
-import { StreamingCadence as mt } from "./chart/streaming-cadence.js";
-import { computeStreamingTarget as ft } from "./chart/streaming-target.js";
-import { resolvePaddingTime as B } from "./chart/viewport-padding.js";
-import { fromScaleSpace as gt, computeTargetYRange as pt, resolveYTarget as yt } from "./chart/y-target.js";
-import { renderCrosshair as vt } from "./components/crosshair.js";
-import { renderGrid as $ } from "./components/grid.js";
-import { renderMarker as bt } from "./components/marker.js";
-import { renderReferenceLine as xt } from "./components/reference-line.js";
-import { resolveTimeRegionColors as St, renderTimeRegion as kt } from "./components/time-region.js";
-import { EventEmitter as At } from "./events.js";
-import { InteractionHandler as Tt } from "./interactions/handler.js";
-import { RenderScheduler as Y } from "./render-scheduler.js";
-import { XScale as wt } from "./scales/x-scale.js";
-import { YScale as Lt, isPlottableOn as Mt } from "./scales/y-scale.js";
-import { resolveSeriesDefinition as Dt } from "./series/definition.js";
-import { isTimeSeriesRenderer as b } from "./series/types.js";
-import { catppuccin as Pt } from "./theme/themes/catppuccin.js";
-import { clamp as Rt } from "./utils/math.js";
-import { crispLineWidth as Ct, crispCenterOffset as It } from "./utils/pixel-grid.js";
-import { normalizeTime as x, detectInterval as Ht } from "./utils/time.js";
-const zt = 200, Vt = 1500, Wt = 48, X = 12, D = 9, Ot = ["left", "right"], Ft = ["left"], Nt = ["right"];
-let Et = 0, Bt = 0, $t = 0, Yt = 0;
-function Z(y, t) {
-  return y === t ? !0 : !y || !t || y.length !== t.length ? !1 : y.every((i, e) => i === t[e]);
+import { prefersReducedMotion as ht } from "./animation/reduced-motion.js";
+import { createViewportEngine as lt } from "./animation/viewport-engine.js";
+import { CanvasManager as ct } from "./canvas-manager.js";
+import { resolveEdgeAnchorValue as dt, drawEdgeIndicators as ut, resolveEdgeBoundary as mt } from "./chart/edge-indicators.js";
+import { computeFitToData as ft } from "./chart/fit-to-data.js";
+import { getLastValue as gt, getPreviousClose as pt, getStackedLastValue as yt } from "./chart/last-value.js";
+import { resolveFade as Y, resolveMaxVisibleBars as xt, resolvePadding as E, resolvePerfOptions as vt, isSameHorizontalPadding as B } from "./chart/options.js";
+import { computePan as St, computeZoom as bt } from "./chart/pan-zoom-math.js";
+import { warnUnplottableBounds as C, assertStackingFitsScale as L, warnScaleSideTaken as kt, warnUnknownScale as wt, warnStackingOffScale as Tt, warnUnplottableValues as At } from "./chart/scale-guards.js";
+import { StreamingCadence as Mt } from "./chart/streaming-cadence.js";
+import { computeStreamingTarget as Pt } from "./chart/streaming-target.js";
+import { resolvePaddingTime as N } from "./chart/viewport-padding.js";
+import { assertSeriesFitsXAxis as Ct, warnXMisfit as Lt, warnXTimeMixed as Dt, warnTimeOnlyFeature as Rt, warnXTypeChange as It } from "./chart/x-guards.js";
+import { fromScaleSpace as Ht, computeTargetYRange as Vt, resolveYTarget as zt } from "./chart/y-target.js";
+import { renderCrosshair as Ft } from "./components/crosshair.js";
+import { renderGrid as X } from "./components/grid.js";
+import { renderMarker as Ot } from "./components/marker.js";
+import { renderReferenceLine as $t } from "./components/reference-line.js";
+import { resolveTimeRegionColors as Wt, renderTimeRegion as Yt } from "./components/time-region.js";
+import { EventEmitter as Et } from "./events.js";
+import { InteractionHandler as Bt } from "./interactions/handler.js";
+import { RenderScheduler as Z } from "./render-scheduler.js";
+import { XScale as Nt } from "./scales/x-scale.js";
+import { YScale as U, isPlottableOn as _ } from "./scales/y-scale.js";
+import { resolveSeriesDefinition as Xt } from "./series/definition.js";
+import { isTimeSeriesRenderer as v } from "./series/types.js";
+import { catppuccin as Zt } from "./theme/themes/catppuccin.js";
+import { deepEqual as Ut } from "./utils/deep-equal.js";
+import { clamp as _t } from "./utils/math.js";
+import { crispLineWidth as Gt, crispCenterOffset as Kt } from "./utils/pixel-grid.js";
+import { pointValue as G, isBandPoint as jt } from "./utils/point.js";
+import { normalizeTime as k, detectInterval as qt } from "./utils/time.js";
+const Jt = 200, Qt = 1500, te = 48, K = 12, D = 9, ee = ["left", "right"], ie = { entries: [], isAnimating: !1 }, se = [], re = ["left"], ne = ["right"], ae = 55;
+function j(p, t) {
+  return {
+    yScale: p,
+    bounds: { min: t?.min, max: t?.max },
+    range: { min: 0, max: 0 },
+    prevMin: Number.NaN,
+    prevMax: Number.NaN
+  };
 }
-function Xt(y, t) {
-  return y === t ? !0 : !y || !t || y.length !== t.length ? !1 : y.every((i, e) => i === t[e]);
+function q(p) {
+  return p === "left" ? "right" : "left";
 }
-class Ai extends At {
+function J(p, t) {
+  return p === void 0 || p === "auto" ? !1 : !(typeof p == "number" && !t.isPlottable(p));
+}
+let oe = 0, he = 0, le = 0, ce = 0;
+function Q(p, t) {
+  return p === t ? !0 : !p || !t || p.length !== t.length ? !1 : p.every((e, i) => e === t[i]);
+}
+function tt(p) {
+  return v(p) ? p.stacking : void 0;
+}
+function de(p, t) {
+  return p === t ? !0 : !p || !t || p.length !== t.length ? !1 : p.every((e, i) => e === t[i]);
+}
+class _e extends Et {
   /** Canvas lifecycle and DPR-aware sizing. */
-  #a;
+  #l;
   /** Schedules main-layer redraws (background, grid, series). */
   #i;
   /** Schedules overlay redraws (crosshair). */
-  #o;
+  #c;
   /** Maps time values to horizontal pixel coordinates. */
   timeScale;
-  /** Maps price/value to vertical pixel coordinates. */
+  /** Maps price/value to vertical pixel coordinates — the default Y scale. */
   yScale;
+  /** Default-scale Y state; `yScale` is its scale. */
+  #P;
+  /** Named Y scales from `options.scales`, in declaration order. */
+  #a = /* @__PURE__ */ new Map();
+  /** Copy of the `scales` option as last applied — `setScales` skips a deep-equal replay,
+   *  and the copy keeps an in-place edit of the caller's object from comparing equal. */
+  #At = {};
+  /** Set when a named scale's range moved, so the crosshair re-emits for its axis label. */
+  #nt = !1;
+  /** Keys of dev warnings already printed, so each fires once. */
+  #Mt = /* @__PURE__ */ new Set();
+  /** What the X axis maps — read from `axis.x.type` once, at construction. */
+  #r;
+  /** Category axis: name → band index, in first-seen order across the series. */
+  #Y = /* @__PURE__ */ new Map();
   /** Zoom, pan, crosshair — null when interactive=false. */
-  #D;
+  #V;
   /** All registered series (candlestick, line, bar, pie). */
   #t = [];
   /** Point annotations (event markers) drawn on the overlay layer, kept out of the series model. */
-  #u = [];
+  #y = [];
   /** Time-region bands drawn on the main layer behind the series, kept out of the series model. */
-  #x = [];
+  #T = [];
   /** Reference lines (horizontal threshold / vertical event) drawn on the overlay layer, kept out of the series model. */
-  #y = [];
+  #b = [];
   /**
    * Overlay-intro latch. Annotations ride the *initial* reveal, then stay put.
    * `#overlayIntroSeen` flips once we've actually watched an intro in progress
@@ -67,31 +103,31 @@ class Ai extends At {
    * later — which re-arms `getIntroFront()`'s global min — can't blink settled
    * markers / reference lines back out.
    */
-  #mt = !1;
-  #ft = !1;
+  #Pt = !1;
+  #Ct = !1;
   /** Active visual theme (colors, fonts, grid style). */
   #n;
   /** Whether to render the background grid. */
-  #F;
+  #G;
   /**
    * Gridline layer opacity, multiplied into every per-tick fade: `0 → 1` on
    * the opening reveal, `1 → 0` when {@link setGrid} hides the grid. The
    * per-tick fades stay snapped during mount (see the tracker's arming), so
    * this is what keeps `fitToData` tick churn from flickering the reveal.
    */
-  #H;
+  #E;
   /** Resolved edge-fade zones — a `null` side is auto: the axis-column ramp on the Y-axis side, off on the other. */
-  #A;
+  #C;
   /** See {@link headerHeight}. */
-  #U = 0;
+  #at = 0;
   /** Memoized destination-out mask gradients, one per edge, keyed by the
    *  zone's bitmap geometry so a resize / DPR change / `setFade` rebuilds
    *  them and steady frames reuse them. */
-  #v = { top: null, axis: null, edge: { left: null, right: null }, tail: null, overhang: null };
+  #k = { top: null, axis: { left: null, right: null }, edge: { left: null, right: null }, tail: null, overhang: null };
   /** Detected time interval between data points (milliseconds). */
-  #r = 6e4;
+  #o = 6e4;
   /** Current crosshair position, null when cursor is outside the chart. */
-  #c = null;
+  #f = null;
   /**
    * What the crosshair is anchored to, deciding which half of the position
    * survives a viewport move (see {@link #syncCrosshairToViewport}):
@@ -99,45 +135,43 @@ class Ai extends At {
    * `time`/`y`; `'time'` (programmatic {@link setCrosshair}) keeps
    * `time`/`y` and re-projects the pixel position.
    */
-  #K = "pointer";
+  #ot = "pointer";
   /** Whether the last overlay pass painted anything — gates the full-bitmap
    *  clear so an empty overlay isn't cleared again every main frame. */
-  #gt = !1;
-  /** User-specified Y-axis bounds (auto, fixed, percentage). */
-  #p = {};
+  #Lt = !1;
   /** Cached series ID list — invalidated on add/remove. */
-  #P = null;
+  #z = null;
   /** Axis visibility and sizing configuration. */
-  #w = {};
+  #v = {};
   /** Host-declared state per edge — drives the edge-indicator overlay. */
-  #S = { left: "idle", right: "idle" };
+  #A = { left: "idle", right: "idle" };
   /** Wall-clock start of a `loading` exit fade per side — set when the host
    *  drops `loading` back to `idle`/`has-more`, so the indicator fades out
    *  over {@link EDGE_EXIT_FADE_MS} instead of vanishing the same frame the
    *  fetched data lands. `null` = no fade in flight. */
-  #N = { left: null, right: null };
+  #K = { left: null, right: null };
   /** Cached boundary timestamps from the last `edgeReached` emission, by side. */
-  #pt = { left: null, right: null };
+  #Dt = { left: null, right: null };
   /** Latest placeholder shapes a `loading` indicator reported per side —
    *  the morph hand-off candidate consumed by {@link prependData}. */
-  #j = { left: null, right: null };
+  #ht = { left: null, right: null };
   /** True after a prepend consumed a side's placeholder snapshot: the series'
    *  reveal owns those pixels now, so the still-`loading` indicator is hidden
    *  and the upcoming `loading → idle` transition skips its exit fade. Reset
    *  by the next {@link setEdgeState} call. */
-  #z = { left: !1, right: !1 };
+  #B = { left: !1, right: !1 };
   /** Host-supplied callback fired when the user releases a pan/zoom past a data edge. */
-  #yt;
+  #Rt;
   /** Per-side custom painter for the edge `loading` spinner. `null` falls back to the built-in dots. */
-  #vt = { left: null, right: null };
+  #It = { left: null, right: null };
   /** Nesting depth for batch updates. Suppresses recomputes while > 0. */
-  #L = 0;
+  #R = 0;
   /** True when batched operations include data changes (triggers full onDataChanged on end). */
-  #q = !1;
+  #lt = !1;
   /** True when batched operations include visibility changes (triggers Y-range + redraw on end). */
-  #V = !1;
+  #N = !1;
   /** True when batched operations bumped overlay version (emits a single overlayChange on flush). */
-  #J = !1;
+  #ct = !1;
   /**
    * Monotonic counter bumped on any mutation that affects overlay output —
    * data, visibility, series options, theme. Used by snapshot helpers in
@@ -147,36 +181,59 @@ class Ai extends At {
    *
    * @internal
    */
-  #bt = 0;
-  /** CSS px of the Y-axis column. The default collapses to `0` on a spatial-only chart. */
+  #Ht = 0;
+  /** CSS px of the default Y-axis column. The default collapses to `0` on a spatial-only chart. */
   get yAxisWidth() {
-    const t = this.#w.y;
-    return t?.visible === !1 ? 0 : t?.width !== void 0 ? t.width : this.#X() ? 0 : 55;
+    return this.#j(this.#v.y);
   }
-  /** Side of the plot area the Y-axis column sits on. */
+  /** Side of the plot area the default Y-axis column sits on. */
   get yAxisPosition() {
-    return this.#w.y?.position ?? "right";
+    return this.#v.y?.position ?? "right";
   }
   /**
-   * 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.
+   * Left edge of the plot area in container CSS px — the width of the Y-axis
+   * column on the left, `0` without one. Scales map into the plot area, so
+   * add this to `timeScale.timeToX()` to get a container coordinate.
    */
   get plotLeft() {
-    return this.yAxisPosition === "left" ? this.yAxisWidth : 0;
+    return this.getAxisColumnWidth("left");
+  }
+  /**
+   * CSS px of the Y-axis column on `side` — the default axis's or the named
+   * scale's that owns that side — `0` when no column sits there.
+   */
+  getAxisColumnWidth(t) {
+    if (t === this.yAxisPosition && this.yAxisWidth > 0) return this.yAxisWidth;
+    for (const e of this.#a.values())
+      if (e.column === t) return this.#j(e.config);
+    return 0;
+  }
+  /** The named scale whose axis column sits on `side`, `null` when the default axis's does or none. */
+  getAxisColumnScale(t) {
+    for (const [e, i] of this.#a)
+      if (i.column === t) return e;
+    return null;
+  }
+  /** Both Y-axis columns together — the plot area is the canvas width minus this. */
+  #w() {
+    return this.getAxisColumnWidth("left") + this.getAxisColumnWidth("right");
+  }
+  /** Column width a Y-axis config asks for; `0` when hidden, and by default on a spatial-only chart. */
+  #j(t) {
+    return t?.visible === !1 ? 0 : t?.width !== void 0 ? t.width : this.#Q() ? 0 : ae;
   }
   /** 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() {
-    return this.#U;
+    return this.#at;
   }
   /** CSS px of the time-axis row. The default collapses to `0` on a spatial-only chart. */
   get xAxisHeight() {
-    const t = this.#w.x;
-    return t?.visible === !1 ? 0 : t?.height !== void 0 ? t.height : this.#X() ? 0 : 30;
+    const t = this.#v.x;
+    return t?.visible === !1 ? 0 : t?.height !== void 0 ? t.height : this.#Q() ? 0 : 30;
   }
   /** Resolved animation config derived from `options.animations` at construction. */
-  #d;
+  #g;
   /**
    * Single source of truth for the chart's X / Y viewport animation.
    * Push-model API: chart emits intent signals (`onPointAppended`,
@@ -185,13 +242,13 @@ class Ai extends At {
    * matching targets back through `computeXTarget` / `computeYTarget`
    * closures supplied at construction.
    */
-  #s;
+  #e;
   /** EMA-smoothed real-wall-clock cadence between streaming appends. The
    *  X spring's `setSettleMs` is fed from this so the settle time stays just
    *  longer than the producer's tick interval — the spring never quite
    *  settles between ticks, so velocity carries continuously and the slide
    *  doesn't pulse. */
-  #R;
+  #F;
   /**
    * Mirrors `#dataReplaceSnapPending` for the engine signal that follows
    * inside the same `onDataChanged` call. `#dataReplaceSnapPending` is
@@ -201,31 +258,31 @@ class Ai extends At {
    * field carries the decision across that gap. The closure also reads
    * `#dataStart` / `#dataEnd` directly for the timestamps.
    */
-  #xt = !1;
+  #Vt = !1;
   /** Earliest data timestamp registered across all series, `null` before any data has arrived. */
-  #T = null;
+  #S = null;
   /** Latest data timestamp registered across all series, `null` before any data has arrived. */
-  #e = null;
+  #s = null;
   /**
    * Previous {@link #dataEnd} value. Streaming-target math reads it to
    * preserve any pan offset across ticks: a user who panned a few bars
    * left of the tail keeps that offset as new bars arrive, instead of
    * snapping back to the natural-pin position every frame.
    */
-  #E = null;
+  #q = null;
   /**
    * Warm-up window flag — `setVisibleRange({ from, bars })` arms it and
    * the streaming-target math suppresses pan ticks while the data hasn't
    * reached the right edge yet. Cleared by user interaction or once the
    * data fills the window.
    */
-  #M = !1;
+  #L = !1;
   /**
    * Cap for fit-to-data. When the data span exceeds this, the fit anchors
    * the right edge and trims the left. Resolved once at construction from
    * `options.viewport.maxVisibleBars`.
    */
-  #St;
+  #zt;
   /**
    * Committed logical X range — the "where X should be" target. Engine
    * eases its visual toward this. Pan / zoom / setRange / fitContent /
@@ -233,69 +290,75 @@ class Ai extends At {
    * as "uninitialized" by `#computeXTarget` until first paint.
    */
   #h = { from: 0, to: 0 };
-  /** Padded Y range — engine's raw Y target plus pixel padding from `#padding`. */
-  #B = { min: 0, max: 0 };
   /**
    * Auto-scroll flag — when `true`, streaming ticks slide X to track the
    * data tail. Pan flips this off when the gesture pushes the tail off
    * screen; chart's per-frame autoscroll check re-engages it when a
    * follow-up pan brings the tail back into view.
    */
-  #m = !0;
+  #p = !0;
   /** Resolved viewport padding (top/bottom px + left/right pixels-or-intervals). */
-  #l;
+  #d;
   /** Cached chart width — passed by interactions on every call; kept for the rare
    *  call that omits it (e.g. programmatic `chart.pan(...)` without explicit width). */
-  #$ = 0;
+  #J = 0;
   /** Active performance monitor, or `null` when instrumentation is disabled (the default). */
-  #k;
+  #M;
   /** When true, `destroy()` tears down the monitor; false for caller-supplied monitors we must not destroy. */
-  #Q = !1;
+  #dt = !1;
   /** Visible HUD overlay (mounted by the perf config); non-null only when the caller requested one. */
-  #tt = null;
-  constructor(t, i) {
-    super(), i?.axis && (this.#w = i.axis, this.#p = { min: i.axis.y?.min, max: i.axis.y?.max }), this.#n = i?.theme ?? Pt.theme, this.#F = i?.grid?.visible !== !1, this.#A = O(i?.fade), this.#d = j.resolve(i?.animations), this.#St = ht(i?.viewport?.maxVisibleBars), this.#l = F(i?.padding), this.#R = new mt();
-    const e = this.#d.axis.y, s = this.#d.axis.x;
-    this.#s = Q({
+  #ut = null;
+  constructor(t, e) {
+    super(), e?.axis && (this.#v = e.axis), this.#r = this.#v.x?.type ?? "time", this.#n = e?.theme ?? Zt.theme, this.#G = e?.grid?.visible !== !1, this.#C = Y(e?.fade), this.#g = at.resolve(e?.animations), this.#zt = xt(e?.viewport?.maxVisibleBars), this.#d = E(e?.padding), this.#F = new Mt();
+    const i = this.#g.axis.y, s = this.#g.axis.x;
+    this.#e = lt({
       initial: { yRange: { min: 0, max: 0 }, xRange: { from: 0, to: 0 } },
       y: {
-        curve: e.curve,
-        settleMs: e.settleMs,
-        stickyMs: e.stickyMs,
-        stickyFloorMs: e.stickyFloorMs,
-        gestureMs: e.gestureMs,
-        toggleMs: this.#d.toggleMs
+        curve: i.curve,
+        settleMs: i.settleMs,
+        stickyMs: i.stickyMs,
+        stickyFloorMs: i.stickyFloorMs,
+        gestureMs: i.gestureMs,
+        toggleMs: this.#g.toggleMs
       },
       x: {
         curve: s.curve,
         settleMs: s.settleMs,
         gestureMs: s.gestureMs
       },
-      computeXTarget: () => this.#Jt(),
-      computeYTarget: ({ xTarget: o }) => this.#ht(o),
+      computeXTarget: () => this.#we(),
+      computeYTarget: ({ xTarget: o, scale: h }) => this.#_(o, h),
       onWake: () => this.#i?.markDirty()
-    }), this.#yt = i?.onEdgeReached, this.#_ = i?.viewport?.initialRange;
-    const r = lt(i?.perf);
-    this.#k = r.monitor, this.#Q = r.ownsMonitor, this.#a = new tt(t, this.#k ?? void 0), this.timeScale = new wt(), this.yScale = new Lt(), this.yScale.setTransform(this.#w.y?.scale ?? null), E({ y: this.#w.y, isPlottable: this.#Y }), this.timeScale.setLocale(i?.locale), this.timeScale.setTimeZone(i?.timeZone);
-    const n = this.#d.axis.ticksMs;
-    this.timeScale.tickTracker.setFadeMs(n), this.yScale.tickTracker.setFadeMs(n), this.#H = new K({
+    }), e?.onEdgeReached && this.checkTimeOnlyFeature("onEdgeReached") && (this.#Rt = e.onEdgeReached), this.#it = e?.viewport?.initialRange;
+    const r = vt(e?.perf);
+    this.#M = r.monitor, this.#dt = r.ownsMonitor, this.#l = new ct(t, this.#M ?? void 0), this.timeScale = new Nt(), this.timeScale.setType(this.#r), this.timeScale.setBandPadding(this.#v.x?.padding), this.yScale = new U(), this.#P = j(this.yScale, this.#v.y), this.yScale.setTransform(this.#v.y?.scale ?? null), C({ y: this.#v.y, isPlottable: this.#gt(void 0) }), this.timeScale.setLocale(e?.locale), this.timeScale.setTimeZone(e?.timeZone);
+    const n = this.#g.axis.ticksMs;
+    this.timeScale.tickTracker.setFadeMs(n), this.yScale.tickTracker.setFadeMs(n), this.#Xt(e?.scales ?? {}), this.#St(), this.#E = new nt({
       initial: 0,
-      duration: this.#d.axis.gridMs,
-      lerp: (o, l, h) => o + (l - o) * h
-    }), this.#i = new Y((o) => this.#dt(o)), this.#o = new Y(
-      (o) => this.#ut("overlay", o, () => this.renderOverlay(o))
-    ), this.#k && r.hud && (this.#tt = r.hud(t, this.#k));
-    const a = i?.interactive !== !1;
-    this.#D = a ? new Tt(this.#a.canvas, this, this.timeScale, this.yScale) : null, this.#a.on("resize", () => {
-      this.syncScales(), this.#dt(), this.emit("viewportChange");
-    }), this.syncScales(), this.#D?.on("crosshairMove", (o) => {
-      this.#K = "pointer", this.#c = o, this.#o.markDirty(), this.emit("crosshairMove", o), this.#rt(o);
-    }), this.#D?.on("click", (o) => {
-      this.emit("pointClick", { ...o, spatialHit: this.#Pt(o) });
-    }), this.#D?.on("dblclick", (o) => {
-      this.fitContent(), this.emit("pointDoubleClick", { ...o, spatialHit: this.#Pt(o) });
+      duration: this.#g.axis.gridMs,
+      lerp: (o, h, l) => o + (h - o) * l
+    }), this.#i = new Z((o) => this.#wt(o)), this.#c = new Z(
+      (o) => this.#Tt("overlay", o, () => this.renderOverlay(o))
+    ), this.#M && r.hud && (this.#ut = r.hud(t, this.#M));
+    const a = e?.interactive !== !1;
+    this.#V = a ? new Bt(this.#l.canvas, this, this.timeScale, this.yScale) : null, this.#l.on("resize", () => {
+      this.syncScales(), this.#wt(), this.emit("viewportChange");
+    }), this.syncScales(), this.#V?.on("crosshairMove", (o) => {
+      const h = o === null ? null : this.#mt(o);
+      this.#ot = "pointer", this.#f = h, this.#c.markDirty(), this.emit("crosshairMove", h), this.#bt(h);
+    }), this.#V?.on("click", (o) => {
+      const h = this.#mt(o);
+      this.emit("pointClick", { ...h, spatialHit: this.#Ut(h) });
+    }), this.#V?.on("dblclick", (o) => {
+      const h = this.#mt(o);
+      this.fitContent(), this.emit("pointDoubleClick", { ...h, spatialHit: this.#Ut(h) });
     });
   }
+  /** A pointer position on a category axis snaps to the nearest band; `x` is the coordinate in the axis domain. */
+  #mt(t) {
+    const e = this.timeScale.snapToBand(t.time);
+    return { ...t, time: e, x: this.timeScale.domainValue(e) };
+  }
   /**
    * Bump overlay version + emit `overlayChange`. Call from every mutation
    * path whose output overlay components care about: data, series list,
@@ -308,9 +371,9 @@ class Ai extends At {
    * `setSeriesVisible` / `setLayerVisible` calls — produce one overlay
    * render instead of N.
    */
-  #f() {
-    if (this.#bt++, this.#L > 0) {
-      this.#J = !0;
+  #u() {
+    if (this.#Ht++, this.#R > 0) {
+      this.#ct = !0;
       return;
     }
     this.emit("overlayChange");
@@ -324,45 +387,59 @@ class Ai extends At {
    * @internal
    */
   getOverlayVersion() {
-    return this.#bt;
+    return this.#Ht;
   }
   /**
    * Return a series ID: use the provided hint if it's non-empty and not already taken,
    * otherwise generate a new auto ID. Auto-generated IDs never collide with each other
    * or with user-provided IDs because they use a monotonically increasing counter.
    */
-  #$t(t) {
-    if (t && !this.#t.some((e) => e.id === t))
+  #ne(t) {
+    if (t && !this.#t.some((i) => i.id === t))
       return t;
-    let i;
+    let e;
     do
-      i = `series_${++Et}`;
-    while (this.#t.some((e) => e.id === i));
-    return i;
+      e = `series_${++oe}`;
+    while (this.#t.some((i) => i.id === e));
+    return e;
   }
-  addSeries(t, i = {}) {
-    const e = typeof t == "string" ? Dt(t) : t;
-    if (!e)
+  addSeries(t, e = {}) {
+    const i = typeof t == "string" ? Xt(t) : t;
+    if (!i)
       throw new Error(
         `[wick-charts] Unknown series type '${String(t)}'. The string form of addSeries resolves through the series registry — call registerBuiltinSeries() once at startup, or pass the definition directly: chart.addSeries(LineSeriesDef, options).`
       );
-    const { layers: s, id: r, label: n, labels: a, ...o } = i, l = s ?? 1;
-    M({ seriesId: r ?? e.type, stacking: o.stacking, isPlottable: this.#Y });
-    const h = {
-      ...this.#d.defaults(e.type),
-      ...o,
-      ...this.#d.overrides(e.type)
-    }, d = e.create({ theme: this.#n, layerCount: l }, h), m = a ?? (typeof n == "string" ? [n] : void 0), c = this.#$t(r);
-    d.onDataChanged?.(() => this.onDataChanged());
-    const f = this.#Z();
-    return this.#t.push({ id: c, labels: m, renderer: d, visible: !0 }), this.#P = null, this.#st(), this.#et(f), this.emit("seriesChange"), this.#f(), c;
+    const { layers: s, id: r, label: n, labels: a, scale: o, ...h } = e, l = s ?? 1;
+    o === void 0 && L({
+      seriesId: r ?? i.type,
+      stacking: h.stacking,
+      isPlottable: this.#gt(o)
+    });
+    const d = {
+      ...this.#g.defaults(i.type),
+      ...h,
+      ...this.#g.overrides(i.type)
+    }, f = i.create({ theme: this.#n, layerCount: l }, d);
+    v(f) && Ct({ seriesType: i.type, axisType: this.#r, supported: i.xTypes ?? ["time"] });
+    const c = a ?? (typeof n == "string" ? [n] : void 0), m = this.#ne(r);
+    f.onDataChanged?.(() => this.onDataChanged());
+    const y = this.#Z();
+    return this.#t.push({
+      id: m,
+      labels: c,
+      renderer: f,
+      visible: !0,
+      scale: o,
+      xKeys: { x: !1, time: !1 },
+      categoryPoints: []
+    }), this.#z = null, this.#et(), this.#tt(y), this.emit("seriesChange"), this.#u(), m;
   }
   /** Remove a series by ID and clean up its resources. */
   removeSeries(t) {
-    const i = this.#t.findIndex((e) => e.id === t);
-    if (i >= 0) {
-      const e = this.#Z();
-      this.#t[i].renderer.dispose(), this.#t.splice(i, 1), this.#P = null, this.#st(), this.#et(e), this.#i.markDirty(), this.emit("seriesChange"), this.#f();
+    const e = this.#t.findIndex((i) => i.id === t);
+    if (e >= 0) {
+      const i = this.#Z();
+      this.#t[e].renderer.dispose(), this.#t.splice(e, 1), this.#z = null, this.#r === "category" && this.#Bt(), this.#et(), this.#tt(i), this.#i.markDirty(), this.emit("seriesChange"), this.#u();
     }
   }
   // --- Markers (point annotations) -----------------------------------------
@@ -376,77 +453,82 @@ class Ai extends At {
    * appear in series queries.
    */
   addMarker(t) {
-    const i = `marker_${++Bt}`;
-    return this.#u.push(this.#kt(i, t)), this.#o.markDirty(), i;
+    const e = `marker_${++he}`;
+    return this.#y.push(this.#Ft(e, t)), this.#c.markDirty(), e;
   }
   /** Replace a marker's config in place. No-op when the id is unknown. */
-  updateMarker(t, i) {
-    const e = this.#u.findIndex((s) => s.id === t);
-    e !== -1 && (this.#u[e] = this.#kt(t, i), this.#o.markDirty());
+  updateMarker(t, e) {
+    const i = this.#y.findIndex((s) => s.id === t);
+    i !== -1 && (this.#y[i] = this.#Ft(t, e), this.#c.markDirty());
   }
   /** Remove a marker by id. No-op when the id is unknown. */
   removeMarker(t) {
-    const i = this.#u.findIndex((e) => e.id === t);
-    i !== -1 && (this.#u.splice(i, 1), this.#o.markDirty());
+    const e = this.#y.findIndex((i) => i.id === t);
+    e !== -1 && (this.#y.splice(e, 1), this.#c.markDirty());
   }
   /** Read-only snapshot of the registered markers (normalized). Mutate via add / update / removeMarker. */
   getMarkers() {
-    return this.#u;
+    return this.#y;
   }
-  #kt(t, i) {
+  #Ft(t, e) {
     return {
       id: t,
-      time: x(i.time),
-      value: i.value,
-      seriesId: i.seriesId,
-      shape: i.shape ?? "dot",
-      pulse: i.pulse ?? !1,
-      label: i.label,
-      color: i.color
+      time: k(e.time),
+      value: e.value,
+      seriesId: e.seriesId,
+      shape: e.shape ?? "dot",
+      pulse: e.pulse ?? !1,
+      label: e.label,
+      color: e.color,
+      scale: e.scale
     };
   }
+  /** The scale a marker's value maps through: its own `scale`, else its series' scale. */
+  #ae(t) {
+    return t.scale !== void 0 || t.seriesId === void 0 ? this.getYScale(t.scale) : this.getYScale(this.getSeriesScale(t.seriesId));
+  }
   /** Resolve a marker's Y value: explicit `value`, else snapped to its series at `time`. Null when neither resolves. */
-  #Yt(t) {
+  #oe(t) {
     if (t.value !== void 0 && Number.isFinite(t.value)) return t.value;
     if (t.seriesId === void 0) return null;
-    const i = this.getDataAtTime(t.seriesId, t.time);
-    return i ? "close" in i ? i.close : i.value : null;
+    const e = this.getDataAtTime(t.seriesId, t.time);
+    return e ? G(e) : null;
   }
   /** Resolve a marker's color: explicit `color`, else the series color, else the theme line color. */
-  #Xt(t) {
+  #he(t) {
     if (t.color !== void 0) return t.color;
     if (t.seriesId !== void 0) {
-      const i = this.getSeriesColor(t.seriesId);
-      if (i !== null) return i;
+      const e = this.getSeriesColor(t.seriesId);
+      if (e !== null) return e;
     }
     return this.#n.line.color;
   }
-  #Zt(t, i, e) {
-    if (this.#u.length === 0) return;
-    const s = performance.now() / (q * 2 * Math.PI) % 1, r = this.#it();
-    for (const n of this.#u) {
-      const a = this.#Yt(n);
+  #le(t, e, i) {
+    if (this.#y.length === 0) return;
+    const s = performance.now() / (ot * 2 * Math.PI) % 1, r = this.#pt();
+    for (const n of this.#y) {
+      const a = this.#oe(n);
       if (a === null) continue;
-      const o = this.#Lt(r, n.time);
+      const o = this.#Yt(r, n.time);
       if (o <= 0) continue;
-      const l = t.context.globalAlpha;
-      o < 1 && (t.context.globalAlpha = l * o), bt({
+      const h = t.context.globalAlpha;
+      o < 1 && (t.context.globalAlpha = h * o), Ot({
         scope: t,
         timeScale: this.timeScale,
-        yScale: this.yScale,
+        yScale: this.#ae(n),
         theme: this.#n,
         marker: {
           time: n.time,
           value: a,
-          color: this.#Xt(n),
+          color: this.#he(n),
           shape: n.shape,
           pulse: n.pulse,
           label: n.label
         },
         phase: s,
-        plotWidth: i,
-        plotHeight: e
-      }), o < 1 && (t.context.globalAlpha = l);
+        plotWidth: e,
+        plotHeight: i
+      }), o < 1 && (t.context.globalAlpha = h);
     }
   }
   // --- Time regions (shaded bands) -----------------------------------------
@@ -462,45 +544,45 @@ class Ai extends At {
    * legend.
    */
   addRegion(t) {
-    const i = `region_${++$t}`;
-    return this.#x.push(this.#At(i, t)), this.#i.markDirty(), i;
+    const e = `region_${++le}`;
+    return this.checkTimeOnlyFeature("TimeRegion") && (this.#T.push(this.#Ot(e, t)), this.#i.markDirty()), e;
   }
   /** Replace a region's config in place. No-op when the id is unknown. */
-  updateRegion(t, i) {
-    const e = this.#x.findIndex((s) => s.id === t);
-    e !== -1 && (this.#x[e] = this.#At(t, i), this.#i.markDirty());
+  updateRegion(t, e) {
+    const i = this.#T.findIndex((s) => s.id === t);
+    i !== -1 && (this.#T[i] = this.#Ot(t, e), this.#i.markDirty());
   }
   /** Remove a region by id. No-op when the id is unknown. */
   removeRegion(t) {
-    const i = this.#x.findIndex((e) => e.id === t);
-    i !== -1 && (this.#x.splice(i, 1), this.#i.markDirty());
+    const e = this.#T.findIndex((i) => i.id === t);
+    e !== -1 && (this.#T.splice(e, 1), this.#i.markDirty());
   }
   /** Read-only snapshot of the registered regions (normalized). Mutate via add / update / removeRegion. */
   getRegions() {
-    return this.#x;
+    return this.#T;
   }
-  #At(t, i) {
-    const { to: e } = i, s = e === void 0 || e === "now" ? null : x(e);
+  #Ot(t, e) {
+    const { to: i } = e, s = i === void 0 || i === "now" ? null : k(i);
     return {
       id: t,
-      from: x(i.from),
+      from: k(e.from),
       to: s,
-      fill: i.fill,
-      color: i.color,
-      label: i.label
+      fill: e.fill,
+      color: e.color,
+      label: e.label
     };
   }
-  #_t(t, i, e) {
-    if (this.#x.length !== 0)
-      for (const s of this.#x) {
-        const { color: r, fill: n } = St(s, this.#n);
-        kt({
+  #ce(t, e, i) {
+    if (this.#T.length !== 0)
+      for (const s of this.#T) {
+        const { color: r, fill: n } = Wt(s, this.#n);
+        Yt({
           scope: t,
           timeScale: this.timeScale,
           theme: this.#n,
           region: { from: s.from, to: s.to, fill: n, color: r, label: s.label },
-          plotWidth: i,
-          plotHeight: e
+          plotWidth: e,
+          plotHeight: i
         });
       }
   }
@@ -516,44 +598,45 @@ class Ai extends At {
    * legend.
    */
   addLine(t) {
-    const i = `line_${++Yt}`;
-    return this.#y.push(this.#Tt(i, t)), this.#o.markDirty(), i;
+    const e = `line_${++ce}`;
+    return this.#b.push(this.#$t(e, t)), this.#c.markDirty(), e;
   }
   /** Replace a reference line's config in place. No-op when the id is unknown. */
-  updateLine(t, i) {
-    const e = this.#y.findIndex((s) => s.id === t);
-    e !== -1 && (this.#y[e] = this.#Tt(t, i), this.#o.markDirty());
+  updateLine(t, e) {
+    const i = this.#b.findIndex((s) => s.id === t);
+    i !== -1 && (this.#b[i] = this.#$t(t, e), this.#c.markDirty());
   }
   /** Remove a reference line by id. No-op when the id is unknown. */
   removeLine(t) {
-    const i = this.#y.findIndex((e) => e.id === t);
-    i !== -1 && (this.#y.splice(i, 1), this.#o.markDirty());
+    const e = this.#b.findIndex((i) => i.id === t);
+    e !== -1 && (this.#b.splice(e, 1), this.#c.markDirty());
   }
   /** Read-only snapshot of the registered reference lines (normalized). Mutate via add / update / removeLine. */
   getLines() {
-    return this.#y;
+    return this.#b;
   }
-  #Tt(t, i) {
-    const { time: e, value: s } = i, r = {
+  #$t(t, e) {
+    const { time: i, value: s } = e, r = {
       id: t,
-      color: i.color,
-      label: i.label,
-      style: i.style ?? "dashed",
-      width: i.width ?? 1
+      color: e.color,
+      label: e.label,
+      style: e.style ?? "dashed",
+      width: e.width ?? 1,
+      scale: e.scale
     };
-    return e !== void 0 ? { ...r, orientation: "vertical", coord: x(e) } : { ...r, orientation: "horizontal", coord: s ?? Number.NaN };
+    return i !== void 0 ? { ...r, orientation: "vertical", coord: k(i) } : { ...r, orientation: "horizontal", coord: s ?? Number.NaN };
   }
-  #Gt(t, i, e) {
-    if (this.#y.length === 0) return;
-    const s = this.#it();
-    for (const r of this.#y) {
-      const n = s >= 1 ? 1 : r.orientation === "vertical" ? this.#Lt(s, r.coord) : W(s);
+  #de(t, e, i) {
+    if (this.#b.length === 0) return;
+    const s = this.#pt();
+    for (const r of this.#b) {
+      const n = s >= 1 ? 1 : r.orientation === "vertical" ? this.#Yt(s, r.coord) : W(s);
       if (n <= 0) continue;
       const a = t.context.globalAlpha;
-      n < 1 && (t.context.globalAlpha = a * n), xt({
+      n < 1 && (t.context.globalAlpha = a * n), $t({
         scope: t,
         timeScale: this.timeScale,
-        yScale: this.yScale,
+        yScale: this.getYScale(r.scale),
         theme: this.#n,
         line: {
           orientation: r.orientation,
@@ -563,8 +646,8 @@ class Ai extends At {
           width: r.width,
           label: r.label
         },
-        plotWidth: i,
-        plotHeight: e
+        plotWidth: e,
+        plotHeight: i
       }), n < 1 && (t.context.globalAlpha = a);
     }
   }
@@ -575,15 +658,23 @@ class Ai extends At {
    * underlying animator mutates between frames.
    */
   getAnimationState() {
-    return this.#wt(this.#s.getAnimationState());
+    return this.#ft(this.#e.getAnimationState());
   }
-  /** The engine animates Y in scale space (`axis.y.scale`'s forward); readers outside it get values. */
-  #wt(t) {
-    const i = this.yScale.getTransform();
-    return i === null ? t : { ...t, yRange: gt(t.yRange, i) };
+  /** The engine animates Y in scale space (the scale's forward); readers outside it get values. */
+  #ft(t, e = this.yScale) {
+    const i = e.getTransform();
+    return i === null ? t : { ...t, yRange: Ht(t.yRange, i) };
+  }
+  /** The animation state as a named scale's series see it: its own Y, in values. */
+  #Wt(t, e) {
+    const i = this.#e.getScaleYRange(e) ?? t.yRange;
+    return this.#ft({ ...t, yRange: i }, this.getYScale(e));
+  }
+  /** `isPlottable` of a scale (`undefined` = default), as a predicate for the guard helpers. */
+  #gt(t) {
+    const e = this.getYScale(t);
+    return (i) => e.isPlottable(i);
   }
-  /** `yScale.isPlottable`, bound once for the helpers that take a predicate. */
-  #Y = (t) => this.yScale.isPlottable(t);
   /**
    * Reveal-front position in `[0, 1]` of any in-flight initial-load intro.
    * With a `seriesId`, that series' own front; without, the minimum across
@@ -593,14 +684,14 @@ class Ai extends At {
    */
   getIntroFront(t) {
     if (t !== void 0)
-      return this.#t.find((e) => e.id === t)?.renderer.getIntroFront?.() ?? 1;
-    let i = 1;
-    for (const e of this.#t) {
-      if (!e.visible) continue;
-      const s = e.renderer.getIntroFront?.();
-      s !== void 0 && s < i && (i = s);
+      return this.#t.find((i) => i.id === t)?.renderer.getIntroFront?.() ?? 1;
+    let e = 1;
+    for (const i of this.#t) {
+      if (!i.visible) continue;
+      const s = i.renderer.getIntroFront?.();
+      s !== void 0 && s < e && (e = s);
     }
-    return i;
+    return e;
   }
   /**
    * Reveal front for annotations (markers / reference lines). The same as
@@ -610,10 +701,10 @@ class Ai extends At {
    * has actually been observed in progress, so an annotation drawn on a chart
    * that has no data yet still rides the reveal once data arrives.
    */
-  #it() {
-    if (this.#ft) return 1;
+  #pt() {
+    if (this.#Ct) return 1;
     const t = this.getIntroFront();
-    return t < 1 ? (this.#mt = !0, t) : (this.#mt && (this.#ft = !0), 1);
+    return t < 1 ? (this.#Pt = !0, t) : (this.#Pt && (this.#Ct = !0), 1);
   }
   /**
    * Entrance alpha for an overlay pinned at `time`, given the intro reveal
@@ -621,10 +712,10 @@ class Ai extends At {
    * then fades in over a short band — so annotations surface in step with the
    * series drawing past them. `1` once the intro has settled.
    */
-  #Lt(t, i) {
+  #Yt(t, e) {
     if (t >= 1) return 1;
-    const { from: e, to: s } = this.timeScale.getRange(), r = s - e, n = r > 0 ? (i - e) / r : 0;
-    return Rt((t - n) / 0.12, 0, 1);
+    const { from: i, to: s } = this.timeScale.getRange(), r = s - i, n = r > 0 ? (e - i) / r : 0;
+    return _t((t - n) / 0.12, 0, 1);
   }
   /**
    * Replace all data for a series.
@@ -634,15 +725,127 @@ class Ai extends At {
    *
    * For line/bar accepts `TimePointInput[]` (time may be `Date`); for candlestick accepts `OHLCInput[]`;
    * for pie accepts `PieSliceData[]`. Time fields are normalized internally.
+   *
+   * On a category axis a replace is how a bar other than the last changes value,
+   * so it eases like a stream: points that keep their band ease to their new values.
    */
-  setSeriesData(t, i, e) {
-    const s = this.#t.find((r) => r.id === t);
-    s && (this.#nt = !0, s.renderer.setData(i, e));
+  setSeriesData(t, e, i) {
+    const s = this.#t.find((a) => a.id === t);
+    if (!s) return;
+    const r = this.#r === "category" && this.#vt(s);
+    if (this.#kt = !r, !this.#vt(s)) {
+      s.renderer.setData(e, i);
+      return;
+    }
+    const n = this.#Et(s, e ?? []);
+    if (!r) {
+      s.renderer.setData(n, i);
+      return;
+    }
+    this.#xt({ entry: s, layerIndex: i, mutate: () => n });
   }
   /** Append a new data point to the end of a series (real-time tick). */
-  appendData(t, i, e) {
-    const s = this.#t.find((r) => r.id === t);
-    s === void 0 || s.renderer.appendPoint === void 0 || s.renderer.appendPoint(i, e);
+  appendData(t, e, i) {
+    const s = this.#t.find((n) => n.id === t);
+    if (s === void 0 || s.renderer.appendPoint === void 0) return;
+    const r = s.renderer.appendPoint.bind(s.renderer);
+    this.#yt({
+      entry: s,
+      layerIndex: i,
+      points: [e],
+      apply: ([n]) => r(n, i),
+      mutateCategory: (n, a) => [...n, ...a]
+    });
+  }
+  /**
+   * Run a store mutation with its points mapped onto the X axis. A time axis
+   * passes them through and a numeric axis drops the ones that don't fit. A
+   * category axis applies `mutateCategory` to the layer's input-order points
+   * instead, then re-sets the store from them.
+   */
+  #yt(t) {
+    const { entry: e, apply: i } = t;
+    if (!this.#vt(e)) {
+      i(t.points.slice());
+      return;
+    }
+    const s = this.#Et(e, t.points);
+    if (s.length !== 0) {
+      if (this.#r === "numeric") {
+        i(s);
+        return;
+      }
+      this.#xt({
+        entry: e,
+        layerIndex: t.layerIndex,
+        mutate: (r) => t.mutateCategory(r, s)
+      });
+    }
+  }
+  /** Replace a category layer's input-order points with `mutate`'s result and sync the categories and stores. */
+  #xt(t) {
+    const { entry: e } = t, i = t.layerIndex ?? 0;
+    e.categoryPoints[i] = t.mutate(e.categoryPoints[i] ?? []), this.#Bt({ entry: e, layerIndex: i });
+  }
+  /** Whether `entry`'s points go through the numeric / category ingest. */
+  #vt(t) {
+    return this.#r !== "time" && v(t.renderer);
+  }
+  /**
+   * Points that fit the X axis, a numeric one with its `x` copied to `time`.
+   * The rest are skipped with a dev warning, as is a series mixing `x` and `time`.
+   */
+  #Et(t, e) {
+    const i = [];
+    for (const s of e) {
+      const r = s.x !== void 0;
+      if (r && (t.xKeys.x = !0), s.time !== void 0 && (t.xKeys.time = !0), !(this.#r === "category" ? typeof s.x == "string" : !r || typeof s.x == "number")) {
+        this.#I(
+          `x-misfit:${t.id}`,
+          () => Lt({ seriesId: t.id, axisType: this.#r, x: s.x })
+        );
+        continue;
+      }
+      i.push(r && this.#r === "numeric" ? { ...s, time: s.x } : s);
+    }
+    return t.xKeys.x && t.xKeys.time && this.#I(`x-mixed:${t.id}`, () => Dt({ seriesId: t.id })), i;
+  }
+  /** Category points with `time` set to their band index. */
+  #ue(t) {
+    return t.map((e) => ({ ...e, time: this.#Y.get(e.x) }));
+  }
+  /**
+   * Re-derive the categories — first-seen order across the series (mount
+   * order, then layers, then points in input order) — and re-set every store
+   * whose band indices moved, plus the `changed` layer.
+   */
+  #Bt(t) {
+    const e = /* @__PURE__ */ new Set();
+    for (const a of this.#t)
+      for (const o of a.categoryPoints)
+        for (const h of o ?? [])
+          e.add(h.x);
+    const i = [...e], s = this.timeScale.getCategories(), r = i.length !== s.length || i.some((a, o) => a !== s[o]), n = this.#Y;
+    this.#Y = new Map(i.map((a, o) => [a, o])), this.timeScale.setCategories(i), this.batch(() => {
+      for (const a of this.#t)
+        this.#me({ entry: a, previous: n, changed: t });
+      r && this.onDataChanged();
+    });
+  }
+  /** Re-set `entry`'s layers whose points moved band, or that `changed` names, from their input-order points. */
+  #me(t) {
+    const { entry: e, previous: i, changed: s } = t;
+    for (let r = 0; r < e.categoryPoints.length; r++) {
+      const n = e.categoryPoints[r] ?? [], a = s?.entry === e && s.layerIndex === r, o = n.some(
+        (d) => i.get(d.x) !== this.#Y.get(d.x)
+      );
+      if (!a && !o) continue;
+      const h = this.#ue(n).sort((d, f) => d.time - f.time), l = n.some((d) => {
+        const f = i.get(d.x);
+        return f !== void 0 && f !== this.#Y.get(d.x);
+      });
+      a && !l && e.renderer.morphData !== void 0 ? e.renderer.morphData(h, r) : e.renderer.setData(h, r);
+    }
   }
   /**
    * Prepend older points to the front of a series — the "load more history on
@@ -657,15 +860,33 @@ class Ai extends At {
    * first point; the sync reconciler guarantees this before calling here.
    * No-op if the renderer doesn't support prepend.
    */
-  prependData(t, i, e) {
-    const s = this.#t.find((n) => n.id === t);
+  prependData(t, e, i) {
+    const s = this.#t.find((a) => a.id === t);
     if (s === void 0 || s.renderer.prependPoints === void 0) return;
-    const r = this.#j.left;
-    r !== null && s.renderer.setHistoryHandoff !== void 0 && performance.now() - r.at < Vt && (s.renderer.setHistoryHandoff(r.bars), this.#z.left = !0, this.#N.left = null, this.#j.left = null, this.#o.markDirty()), s.renderer.prependPoints(i, e);
+    const r = this.#ht.left;
+    r !== null && s.renderer.setHistoryHandoff !== void 0 && performance.now() - r.at < Qt && (s.renderer.setHistoryHandoff(r.bars), this.#B.left = !0, this.#K.left = null, this.#ht.left = null, this.#c.markDirty());
+    const n = s.renderer.prependPoints.bind(s.renderer);
+    this.#yt({
+      entry: s,
+      layerIndex: i,
+      points: e,
+      apply: (a) => n(a, i),
+      mutateCategory: (a, o) => [...o, ...a]
+    });
   }
   /** Update the last data point of a series in place (e.g. live candle update). */
-  updateData(t, i, e) {
-    this.#t.find((s) => s.id === t)?.renderer.updateLastPoint?.(i, e);
+  updateData(t, e, i) {
+    const s = this.#t.find((n) => n.id === t);
+    if (s === void 0 || s.renderer.updateLastPoint === void 0) return;
+    const r = s.renderer.updateLastPoint.bind(s.renderer);
+    this.#yt({
+      entry: s,
+      layerIndex: i,
+      points: [e],
+      apply: ([n]) => r(n, i),
+      // Like the store, an empty layer has no last point to update.
+      mutateCategory: (n, a) => n.length === 0 ? [] : [...n.slice(0, -1), ...a]
+    });
   }
   /**
    * Keep only the most recent `count` points of a series — drop the oldest
@@ -680,37 +901,59 @@ class Ai extends At {
    * chart.keepLast('feed', 100);
    * ```
    */
-  keepLast(t, i, e) {
-    this.#t.find((s) => s.id === t)?.renderer.keepLast?.(i, e);
+  keepLast(t, e, i) {
+    const s = this.#t.find((r) => r.id === t);
+    if (s?.renderer.keepLast !== void 0) {
+      if (this.#r !== "category") {
+        s.renderer.keepLast(e, i);
+        return;
+      }
+      this.#xt({
+        entry: s,
+        layerIndex: i,
+        mutate: (r) => e < 0 ? [...r] : r.slice(Math.max(0, r.length - e))
+      });
+    }
   }
-  /** Update visual options (color, width, etc.) for an existing series. */
-  updateSeriesOptions(t, i) {
-    const e = this.#t.find((h) => h.id === t);
-    if (!e) return;
-    "stacking" in i && M({ seriesId: t, stacking: i.stacking, isPlottable: this.#Y });
-    const s = e.labels, r = e.renderer.getLayerColors().slice(), n = this.#d.overrides(e.renderer.kind);
-    e.renderer.updateOptions({ ...i, ...n }), "label" in i && typeof i.label == "string" && (e.labels = [i.label]), this.#i.markDirty();
-    const a = e.renderer.getLayerColors(), o = r.length !== a.length || r.some((h, d) => h !== a[d]), l = !Z(s, e.labels);
-    (o || l) && this.#f();
+  /**
+   * Update visual options (color, width, etc.) for an existing series. `scale`
+   * (time series) moves it onto a named Y scale, `undefined` back to the default.
+   */
+  updateSeriesOptions(t, e) {
+    const i = this.#t.find((u) => u.id === t);
+    if (!i) return;
+    const { scale: s, ...r } = e, n = "scale" in e, a = n ? s : i.scale;
+    if (("stacking" in e || n) && a === void 0) {
+      const u = "stacking" in e ? e.stacking : tt(i.renderer);
+      L({ seriesId: t, stacking: u, isPlottable: this.#gt(a) });
+    }
+    const o = i.labels, h = i.renderer.getLayerColors().slice(), l = this.#g.overrides(i.renderer.kind);
+    i.renderer.updateOptions({ ...r, ...l }), "label" in e && typeof e.label == "string" && (i.labels = [e.label]), this.#i.markDirty();
+    const d = this.#D(i);
+    i.scale = a;
+    const f = this.#D(i) !== d;
+    f && this.#xe();
+    const c = i.renderer.getLayerColors(), m = h.length !== c.length || h.some((u, g) => u !== c[g]), y = !Q(o, i.labels);
+    (m || y || f) && this.#u();
   }
   /**
    * Batch multiple updates: suppress recomputes until `fn` returns. Exceptions
    * inside `fn` still flush the batch so counters don't leak across calls.
    */
   batch(t) {
-    this.#L++;
+    this.#R++;
     try {
       t();
     } finally {
-      if (--this.#L <= 0) {
-        if (this.#L = 0, this.#q)
-          this.#q = !1, this.#V = !1, this.onDataChanged();
-        else if (this.#V) {
-          this.#V = !1, this.#g = !0;
-          const i = performance.now();
-          this.#s.onAxisReconfig(i), this.#b(i), this.#i.markDirty();
+      if (--this.#R <= 0) {
+        if (this.#R = 0, this.#lt)
+          this.#lt = !1, this.#N = !1, this.onDataChanged();
+        else if (this.#N) {
+          this.#N = !1, this.#m = !0;
+          const e = performance.now();
+          this.#e.onSeriesVisibilityChanged(e), this.#x(e), this.#i.markDirty();
         }
-        this.#J && (this.#J = !1, this.emit("overlayChange"));
+        this.#ct && (this.#ct = !1, this.emit("overlayChange"));
       }
     }
   }
@@ -721,18 +964,18 @@ class Ai extends At {
    *  computation immediately so the axis can start moving while the line
    *  fades out in parallel.
    */
-  setSeriesVisible(t, i) {
-    const e = this.#t.find((n) => n.id === t);
-    if (!e || e.visible === i) return;
-    e.visible = i, this.#f(), this.#st();
-    const s = this.#d.toggleMs;
-    if (e.renderer.setAlpha?.(i ? 1 : 0, s), this.#i.markDirty(), this.#L > 0) {
-      this.#V = !0;
+  setSeriesVisible(t, e) {
+    const i = this.#t.find((n) => n.id === t);
+    if (!i || i.visible === e) return;
+    i.visible = e, this.#u(), this.#et();
+    const s = this.#g.toggleMs;
+    if (i.renderer.setAlpha?.(e ? 1 : 0, s), this.#i.markDirty(), this.#R > 0) {
+      this.#N = !0;
       return;
     }
-    this.#g = !0;
+    this.#m = !0;
     const r = performance.now();
-    this.#s.onSeriesVisibilityChanged(r), this.#b(r);
+    this.#e.onSeriesVisibilityChanged(r), this.#x(r);
   }
   /**
    * Whether streaming ticks slide the visible range to track the data tail.
@@ -742,10 +985,10 @@ class Ai extends At {
    * containing the tail.
    */
   getAutoScroll() {
-    return this.#m;
+    return this.#p;
   }
   isSeriesVisible(t) {
-    return this.#t.find((i) => i.id === t)?.visible ?? !0;
+    return this.#t.find((e) => e.id === t)?.visible ?? !0;
   }
   /**
    * Show or hide a specific layer within a multi-layer series.
@@ -757,31 +1000,31 @@ class Ai extends At {
    * `getValueRange` reading `store.isVisible()`); the alpha fade keeps the
    * layer's geometry on screen until the engine's Y ease settles.
    */
-  setLayerVisible(t, i, e) {
+  setLayerVisible(t, e, i) {
     const s = this.#t.find((a) => a.id === t);
-    if (!s || s.renderer.getLayerCount() <= 1 || s.renderer.isLayerVisible(i) === e) return;
-    s.renderer.setLayerVisible(i, e), this.#f();
-    const r = this.#d.toggleMs;
-    if (s.renderer.setLayerAlpha?.(i, e ? 1 : 0, r), this.#i.markDirty(), this.#L > 0) {
-      this.#V = !0;
+    if (!s || s.renderer.getLayerCount() <= 1 || s.renderer.isLayerVisible(e) === i) return;
+    s.renderer.setLayerVisible(e, i), this.#u();
+    const r = this.#g.toggleMs;
+    if (s.renderer.setLayerAlpha?.(e, i ? 1 : 0, r), this.#i.markDirty(), this.#R > 0) {
+      this.#N = !0;
       return;
     }
-    this.#g = !0;
+    this.#m = !0;
     const n = performance.now();
-    this.#s.onSeriesVisibilityChanged(n), this.#b(n);
+    this.#e.onSeriesVisibilityChanged(n), this.#x(n);
   }
-  isLayerVisible(t, i) {
-    return this.#t.find((e) => e.id === t)?.renderer.isLayerVisible(i) ?? !0;
+  isLayerVisible(t, e) {
+    return this.#t.find((i) => i.id === t)?.renderer.isLayerVisible(e) ?? !0;
   }
   /** Auto-fit the viewport to show all data across every series. */
   fitContent() {
-    const { first: t, last: i } = this.getDataBounds();
-    if (t === void 0 || i === void 0) return;
-    const e = this.#a.size.media.width - this.yAxisWidth;
-    this.#O(t, i, e), this.#G({ xEase: !0 });
+    const { first: t, last: e } = this.getDataBounds();
+    if (t === void 0 || e === void 0) return;
+    const i = this.#l.size.media.width - this.#w();
+    this.#O(t, e, i), this.#st({ xEase: !0 });
   }
   getVisibleRange() {
-    return this.#h.from === 0 && this.#h.to === 0 ? this.#s.getAnimationState().xRange : this.#h;
+    return this.#h.from === 0 && this.#h.to === 0 ? this.#e.getAnimationState().xRange : this.#h;
   }
   /**
    * Return the full span of registered data, or `null` before any data has
@@ -789,7 +1032,7 @@ class Ai extends At {
    * tracking and is cheaper than recomputing from series stores.
    */
   getDataRange() {
-    return this.#T === null || this.#e === null ? null : { from: this.#T, to: this.#e };
+    return this.#S === null || this.#s === null ? null : { from: this.#S, to: this.#s };
   }
   /**
    * Imperatively set the visible time range. Three forms:
@@ -815,35 +1058,35 @@ class Ai extends At {
    * multi-chart sync so a synced pane tracks the originating gesture in
    * lockstep rather than lagging behind on the long sticky contract.
    */
-  setVisibleRange(t, i) {
+  setVisibleRange(t, e) {
     if (typeof t == "number") {
       if (!Number.isInteger(t) || t < 2) return;
       const { first: n, last: a } = this.getDataBounds();
       if (n === void 0 || a === void 0) return;
-      const o = Math.max(n, a - (t - 1) * this.#r), l = this.#a.size.media.width - this.yAxisWidth;
-      this.#O(o, a, l), this.#G();
+      const o = Math.max(n, a - (t - 1) * this.#o), h = this.#l.size.media.width - this.#w();
+      this.#O(o, a, h), this.#st();
       return;
     }
     if ("bars" in t) {
       if (!Number.isInteger(t.bars) || t.bars < 2) return;
-      const n = x(t.from), a = n + t.bars * this.#r;
-      this.#m = this.#e !== null && this.#e >= n && this.#e <= a, this.#C({ from: n, to: a }, { emitChange: !0 }), this.#M = !0, this.#G();
+      const n = k(t.from), a = n + t.bars * this.#o;
+      this.#p = this.#s !== null && this.#s >= n && this.#s <= a, this.#H({ from: n, to: a }, { emitChange: !0 }), this.#L = !0, this.#st();
       return;
     }
-    const e = x(t.from), s = x(t.to);
-    this.#m = this.#e !== null && this.#e >= e && this.#e <= s, this.#M = !1;
-    const r = this.#C({ from: e, to: s }, { emitChange: !0 });
-    if (i?.gesture) {
-      r && this.#Qt();
+    const i = k(t.from), s = k(t.to);
+    this.#p = this.#s !== null && this.#s >= i && this.#s <= s, this.#L = !1;
+    const r = this.#H({ from: i, to: s }, { emitChange: !0 });
+    if (e?.gesture) {
+      r && this.#Te();
       return;
     }
-    this.#G();
+    this.#st();
   }
   getYRange() {
-    return this.#B;
+    return this.#P.range;
   }
   getCrosshairPosition() {
-    return this.#c;
+    return this.#f;
   }
   /**
    * Programmatically set or clear the crosshair. Same effect as the user
@@ -880,34 +1123,34 @@ class Ai extends At {
    */
   setCrosshair(t) {
     if (t === null) {
-      if (this.#c === null) return;
-      this.#c = null, this.#o.markDirty(), this.emit("crosshairMove", null);
+      if (this.#f === null) return;
+      this.#f = null, this.#c.markDirty(), this.emit("crosshairMove", null);
       return;
     }
-    const { time: i } = t;
-    if (!Number.isFinite(i)) return;
-    const e = this.#c;
+    const { time: e } = t;
+    if (!Number.isFinite(e)) return;
+    const i = this.#f;
     let s;
-    if (t.y !== void 0 ? s = t.y : e !== null ? s = e.y : s = this.yScale.yToValue(this.yScale.getMediaHeight() / 2), !Number.isFinite(s) || e !== null && e.time === i && e.y === s) return;
-    const r = this.plotLeft + this.timeScale.timeToX(i), n = this.yScale.valueToY(s);
-    this.#K = "time", this.#c = { mediaX: r, mediaY: n, time: i, y: s }, this.#o.markDirty(), this.emit("crosshairMove", this.#c);
+    if (t.y !== void 0 ? s = t.y : i !== null ? s = i.y : s = this.yScale.yToValue(this.yScale.getMediaHeight() / 2), !Number.isFinite(s) || i !== null && i.time === e && i.y === s) return;
+    const r = this.plotLeft + this.timeScale.timeToX(e), n = this.yScale.valueToY(s);
+    this.#ot = "time", this.#f = { mediaX: r, mediaY: n, time: e, x: this.timeScale.domainValue(e), y: s }, this.#c.markDirty(), this.emit("crosshairMove", this.#f);
   }
   /** Get the last visible value and whether the absolute last point is on screen. */
   getLastValue(t) {
-    return nt(t, this.#t, this.#s.getAnimationState().xRange);
+    return gt(t, this.#t, this.#e.getAnimationState().xRange);
   }
   /** Get the second-to-last value, useful for computing change. */
   getPreviousClose(t) {
-    return at(t, this.#t);
+    return pt(t, this.#t);
   }
   getLastData(t) {
-    const i = this.#t.find((e) => e.id === t);
-    return !i || !b(i.renderer) ? null : i.renderer.getLastDataPoint();
+    const e = this.#t.find((i) => i.id === t);
+    return !e || !v(e.renderer) ? null : e.renderer.getLastDataPoint();
   }
   /** Find the data point closest to the given timestamp within one data interval. */
-  getDataAtTime(t, i) {
-    const e = this.#t.find((s) => s.id === t);
-    return e ? e.renderer.getDataAtTime?.(i, this.#r) ?? null : null;
+  getDataAtTime(t, e) {
+    const i = this.#t.find((s) => s.id === t);
+    return i ? i.renderer.getDataAtTime?.(e, this.#X()) ?? null : null;
   }
   /**
    * Get all layers' data at a given time for multi-layer series (Bar/Line
@@ -915,12 +1158,21 @@ class Ai extends At {
    * snapped sample time — callers must not derive layer identity from the
    * array index, because hidden layers are filtered out.
    */
-  getLayerSnapshots(t, i) {
-    const e = this.#t.find((s) => s.id === t);
-    return e?.visible ? e.renderer.getLayerSnapshots?.(i, this.#r) ?? null : null;
+  getLayerSnapshots(t, e) {
+    const i = this.#t.find((s) => s.id === t);
+    return i?.visible ? i.renderer.getLayerSnapshots?.(e, this.#X()) ?? null : null;
+  }
+  /**
+   * How far from a point the crosshair and hit-tests still find it — one data
+   * interval on a time axis; on a category axis half a step, so a band only
+   * finds its own point; on a numeric axis the whole data span, so a point
+   * past a wide gap is still the nearest.
+   */
+  #X() {
+    return this.#r === "category" ? 0.5 : this.#r === "time" || this.#S === null || this.#s === null ? this.#o : Math.max(this.#o, this.#s - this.#S);
   }
   getSeriesIds() {
-    return this.#P || (this.#P = this.#t.map((t) => t.id)), this.#P.slice();
+    return this.#z || (this.#z = this.#t.map((t) => t.id)), this.#z.slice();
   }
   /**
    * True if any visible series has a time axis (line / bar / candlestick).
@@ -928,9 +1180,9 @@ class Ai extends At {
    * has no meaningful x/y coordinate system, so the dashed hairlines would
    * just be visual noise.
    */
-  #Mt() {
+  #Nt() {
     for (const t of this.#t)
-      if (t.visible && b(t.renderer))
+      if (t.visible && v(t.renderer))
         return !0;
     return !1;
   }
@@ -940,26 +1192,43 @@ class Ai extends At {
    * to reserve and nothing slides under an axis column. Reads registration,
    * not visibility — a legend toggle must not shift the layout.
    */
-  #X() {
-    return this.#t.length === 0 ? !1 : this.#t.every((t) => !b(t.renderer));
+  #Q() {
+    return this.#t.length === 0 ? !1 : this.#t.every((t) => !v(t.renderer));
   }
   #Z() {
-    return { yAxisWidth: this.yAxisWidth, xAxisHeight: this.xAxisHeight, yAxisPosition: this.yAxisPosition };
+    return {
+      yAxisWidth: this.yAxisWidth,
+      xAxisHeight: this.xAxisHeight,
+      yAxisPosition: this.yAxisPosition,
+      leftWidth: this.getAxisColumnWidth("left"),
+      rightWidth: this.getAxisColumnWidth("right")
+    };
   }
-  /** Resync the scales after the axis gutters moved, and let DOM axis / label
-   *  components re-read the layout, as they do after a resize. */
-  #et(t) {
-    const i = this.#Z();
-    (i.yAxisWidth !== t.yAxisWidth || i.xAxisHeight !== t.xAxisHeight || i.yAxisPosition !== t.yAxisPosition) && (this.syncScales(), this.emit("viewportChange"), this.#i.markDirty());
+  /** Reassign the Y-axis columns, then resync the scales if the gutters moved
+   *  and let DOM axis / label components re-read the layout, as they do after a resize. */
+  #tt(t) {
+    this.#St();
+    const e = this.#Z();
+    (e.yAxisWidth !== t.yAxisWidth || e.xAxisHeight !== t.xAxisHeight || e.yAxisPosition !== t.yAxisPosition || e.leftWidth !== t.leftWidth || e.rightWidth !== t.rightWidth) && (this.syncScales(), this.emit("viewportChange"), this.#i.markDirty());
   }
   /**
    * Whether pan/zoom gestures currently apply — true when any visible series
-   * has a time axis. Part of the {@link PanZoomTarget} surface: on a
-   * spatial-only chart (pie, heatmap) the interaction layer stops capturing
-   * wheel and touch events, so the page scrolls normally under the cursor.
+   * has a time axis and `axis.x.panZoom` allows it. Part of the
+   * {@link PanZoomTarget} surface: otherwise the interaction layer stops
+   * capturing wheel and touch events, so the page scrolls normally under the cursor.
    */
   canPanZoom() {
-    return this.#Mt();
+    return (this.#v.x?.panZoom ?? this.#r !== "category") && this.#Nt();
+  }
+  /**
+   * Whether a time-only feature (Navigator, EdgeLoader, TimeRegion) can run
+   * on this chart's X axis. On a numeric or category axis it warns once per
+   * feature in dev and returns `false` — the caller then does nothing.
+   *
+   * @internal
+   */
+  checkTimeOnlyFeature(t) {
+    return this.#r === "time" ? !0 : (this.#I(`time-only:${t}`, () => Rt({ feature: t, axisType: this.#r })), !1);
   }
   /**
    * Push the current pan/zoom capability into the interaction layer (canvas
@@ -968,8 +1237,8 @@ class Ai extends At {
    * every mutation that can flip {@link canPanZoom}: series add/remove and
    * series visibility.
    */
-  #st() {
-    this.#D?.syncPanZoomMode();
+  #et() {
+    this.#V?.syncPanZoomMode();
   }
   /**
    * Filter `getSeriesIds()` by renderer type. A concrete kind (`'pie'`,
@@ -982,18 +1251,18 @@ class Ai extends At {
    * - `opts.singleLayerOnly` — exclude series with more than one layer.
    *   Useful for YLabel fallback priority (stick to a single line first).
    */
-  getSeriesIdsByType(t, i) {
-    const e = i?.visibleOnly === !0, s = i?.singleLayerOnly === !0, r = [];
+  getSeriesIdsByType(t, e) {
+    const i = e?.visibleOnly === !0, s = e?.singleLayerOnly === !0, r = [];
     for (const n of this.#t) {
-      if (!(t === "time" ? b(n.renderer) : n.renderer.kind === t)) continue;
+      if (!(t === "time" ? v(n.renderer) : n.renderer.kind === t)) continue;
       const a = n.renderer.getLayerCount();
       if (!(s && a > 1)) {
-        if (e) {
+        if (i) {
           if (!n.visible) continue;
           if (a > 1) {
             let o = !1;
-            for (let l = 0; l < a; l++)
-              if (n.renderer.isLayerVisible(l)) {
+            for (let h = 0; h < a; h++)
+              if (n.renderer.isLayerVisible(h)) {
                 o = !0;
                 break;
               }
@@ -1012,7 +1281,7 @@ class Ai extends At {
    * Returns `null` for unknown ids or empty series.
    */
   getStackedLastValue(t) {
-    return ot(t, this.#t, this.#s.getAnimationState().xRange);
+    return yt(t, this.#t, this.#e.getAnimationState().xRange);
   }
   /**
    * Stacked value at an arbitrary `time` — the cumulative stack top at that
@@ -1021,13 +1290,13 @@ class Ai extends At {
    * (Candlestick, single-layer Line/Bar). Returns `null` for unknown ids or
    * when no sample sits near `time`. Used by the YLabel intro count-up start.
    */
-  getStackedValueAtTime(t, i) {
-    const e = this.#t.find((n) => n.id === t);
-    if (!e) return null;
-    const s = e.renderer.getStackedValueAtTime?.(i, this.#r);
+  getStackedValueAtTime(t, e) {
+    const i = this.#t.find((n) => n.id === t);
+    if (!i) return null;
+    const s = i.renderer.getStackedValueAtTime?.(e, this.#X());
     if (s != null) return s;
-    const r = e.renderer.getDataAtTime?.(i, this.#r);
-    return r ? "close" in r ? r.close : r.value : null;
+    const r = i.renderer.getDataAtTime?.(e, this.#X());
+    return !r || jt(r) ? null : G(r);
   }
   /**
    * Per-layer last snapshots with each layer's own `time`. Returns `null`
@@ -1036,7 +1305,7 @@ class Ai extends At {
    * when layers advance at different rates (ragged streams).
    */
   getLayerLastSnapshots(t) {
-    return this.#t.find((i) => i.id === t)?.renderer.getLayerLastSnapshots?.() ?? null;
+    return this.#t.find((e) => e.id === t)?.renderer.getLayerLastSnapshots?.() ?? null;
   }
   /**
    * Shallow view of the internal series entries so unit tests can introspect
@@ -1050,16 +1319,16 @@ class Ai extends At {
   }
   /** Get the primary display color for a series. */
   getSeriesColor(t) {
-    const i = this.#t.find((e) => e.id === t);
-    return i ? i.renderer.getLayerColors()[0] ?? this.#n.line.color : null;
+    const e = this.#t.find((i) => i.id === t);
+    return e ? e.renderer.getLayerColors()[0] ?? this.#n.line.color : null;
   }
   /** The series' primary name (first layer). Used for single-layer overlays. */
   getSeriesLabel(t) {
-    return this.#t.find((i) => i.id === t)?.labels?.[0];
+    return this.#t.find((e) => e.id === t)?.labels?.[0];
   }
   /** The display name of one layer, or `undefined` when that layer is unnamed. */
-  getLayerLabel(t, i) {
-    return this.#t.find((e) => e.id === t)?.labels?.[i];
+  getLayerLabel(t, e) {
+    return this.#t.find((i) => i.id === t)?.labels?.[e];
   }
   /**
    * Set every layer's display name at once (index = layer). Drives the tooltip,
@@ -1067,9 +1336,9 @@ class Ai extends At {
    * per-layer labels in `data` change. No-ops (and skips the overlay bump) when
    * the labels are unchanged, so it's safe to call on every data tick.
    */
-  setSeriesLabels(t, i) {
-    const e = this.#t.find((s) => s.id === t);
-    !e || Z(e.labels, i) || (e.labels = i, this.#f());
+  setSeriesLabels(t, e) {
+    const i = this.#t.find((s) => s.id === t);
+    !i || Q(i.labels, e) || (i.labels = e, this.#u());
   }
   /**
    * Set the per-layer color overrides carried in `data` (sparse — `undefined`
@@ -1078,92 +1347,220 @@ class Ai extends At {
    * the renderer, which keeps them separate from the theme base so a theme swap
    * preserves them. Called by the framework wrappers; no-ops when unchanged.
    */
-  setLayerColors(t, i) {
-    const e = this.#t.find((s) => s.id === t);
-    !e || Xt(e.colorOverrides, i) || (e.colorOverrides = i, e.renderer.setColorOverrides?.(i), this.#i.markDirty(), this.#f());
+  setLayerColors(t, e) {
+    const i = this.#t.find((s) => s.id === t);
+    !i || de(i.colorOverrides, e) || (i.colorOverrides = e, i.renderer.setColorOverrides?.(e), this.#i.markDirty(), this.#u());
   }
   /** Get per-layer colors for a series. Returns null for single-layer non-bar/line series. */
   getSeriesLayers(t) {
-    const i = this.#t.find((r) => r.id === t);
-    if (!i) return null;
-    const e = i.renderer.getLayerCount();
-    if (e <= 1) return null;
-    const s = i.renderer.getLayerColors();
-    return Array.from({ length: e }, (r, n) => ({ color: s[n % s.length] }));
+    const e = this.#t.find((r) => r.id === t);
+    if (!e) return null;
+    const i = e.renderer.getLayerCount();
+    if (i <= 1) return null;
+    const s = e.renderer.getLayerColors();
+    return Array.from({ length: i }, (r, n) => ({ color: s[n % s.length] }));
   }
   /** Get all slices with computed colors and percentages. Returns null for series without slice data (e.g. candlestick, line, bar). */
   getSliceInfo(t) {
-    return this.#t.find((i) => i.id === t)?.renderer.getSliceInfo?.(this.#n) ?? null;
+    return this.#t.find((e) => e.id === t)?.renderer.getSliceInfo?.(this.#n) ?? null;
   }
   /** Get hover info (label/value/percent/color) for the currently hovered element, or null. */
   getHoverInfo(t) {
-    return this.#t.find((i) => i.id === t)?.renderer.getHoverInfo?.(this.#n) ?? null;
+    return this.#t.find((e) => e.id === t)?.renderer.getHoverInfo?.(this.#n) ?? null;
   }
   /** Apply a new theme and update series colors where appropriate. */
   setTheme(t) {
-    const i = this.#n;
+    const e = this.#n;
     this.#n = t;
-    for (const e of this.#t)
-      e.renderer.applyTheme(t, i);
-    this.#i.markDirty(), this.#f();
+    for (const i of this.#t)
+      i.renderer.applyTheme(t, e);
+    this.#i.markDirty(), this.#u();
   }
   getTheme() {
     return this.#n;
   }
   /** BCP 47 locale applied to the built-in time-axis / tooltip / crosshair formatting. */
   setLocale(t) {
-    this.timeScale.setLocale(t), this.#f();
+    this.timeScale.setLocale(t), this.#u();
   }
   getLocale() {
     return this.timeScale.getLocale();
   }
   /** IANA timezone applied to the same built-in date-time formatting. */
   setTimeZone(t) {
-    this.timeScale.setTimeZone(t), this.#f();
+    this.timeScale.setTimeZone(t), this.#u();
   }
   getTimeZone() {
     return this.timeScale.getTimeZone();
   }
   /** Update axis configuration and re-render. */
   setAxis(t) {
-    const i = t.y?.scale ?? null, e = (a) => Mt(i, a);
-    for (const a of this.#t)
-      b(a.renderer) && M({ seriesId: a.id, stacking: a.renderer.stacking, isPlottable: e });
-    const s = this.#Z(), r = i !== this.yScale.getTransform();
-    this.#w = t, this.#p = { min: t.y?.min, max: t.y?.max }, E({ y: t.y, isPlottable: e });
-    const n = performance.now();
-    r && (this.yScale.setTransform(i), this.yScale.tickTracker.reset(), this.#ht() === null && this.#s.snap({ y: { min: 0, max: 0 } }, n)), this.#g = !0, this.#s.onAxisReconfig(n), this.#b(n), this.#et(s), this.#i.markDirty();
+    const e = t.y?.scale ?? null, i = (d) => _(e, d);
+    for (const d of this.#t)
+      !v(d.renderer) || d.scale !== void 0 || L({ seriesId: d.id, stacking: d.renderer.stacking, isPlottable: i });
+    const s = this.#Z(), r = e !== this.yScale.getTransform(), n = t.x?.type ?? "time";
+    n !== this.#r && this.#I("x-type", () => It({ from: this.#r, to: n }));
+    const a = this.timeScale.getBandPadding();
+    this.timeScale.setBandPadding(t.x?.padding);
+    const o = this.timeScale.getBandPadding(), h = a.inner !== o.inner || a.outer !== o.outer;
+    this.#v = t, this.#P.bounds = { min: t.y?.min, max: t.y?.max }, C({ y: t.y, isPlottable: i });
+    const l = performance.now();
+    r && (this.yScale.setTransform(e), this.yScale.tickTracker.reset(), this.#_() === null && this.#e.snap({ y: { min: 0, max: 0 } }, l)), this.#m = !0, this.#e.onAxisReconfig(l), this.#x(l), this.#tt(s), this.#et(), h && this.#r === "category" && this.fitContent(), this.#i.markDirty();
+  }
+  /**
+   * Replace the named Y scales (see {@link ChartOptions.scales}). Added,
+   * removed and edited scales apply in place: a changed transform resets that
+   * scale's ticks, and every scale refits. A deep-equal replay is a no-op.
+   */
+  setScales(t) {
+    const e = t ?? {};
+    if (Ut(e, this.#At)) return;
+    const i = this.#Z(), s = this.#Xt(e);
+    this.#St();
+    const r = performance.now(), n = {};
+    for (const a of s)
+      this.#_(void 0, a) === null && (n[a] = { min: 0, max: 0 });
+    this.#e.snap({ scales: n }, r), this.#m = !0, this.#e.onAxisReconfig(r), this.#x(r), this.#tt(i), this.emit("viewportChange"), this.#u(), this.#i.markDirty();
+  }
+  /**
+   * Create, update and drop named-scale slots to match `next`, in its key
+   * order. Returns the ids of existing scales whose transform changed.
+   */
+  #Xt(t) {
+    const e = /* @__PURE__ */ new Map(), i = [];
+    for (const [s, r] of Object.entries(t)) {
+      const n = r.scale ?? null;
+      let a = this.#a.get(s);
+      if (a === void 0) {
+        const o = new U();
+        o.setTransform(n), o.tickTracker.setFadeMs(this.#g.axis.ticksMs), a = { ...j(o, r), config: r, column: null };
+      } else n !== a.yScale.getTransform() && (a.yScale.setTransform(n), a.yScale.tickTracker.reset(), i.push(s));
+      a.config = { ...r }, a.bounds = { min: r.min, max: r.max }, C({
+        y: r,
+        isPlottable: (o) => _(n, o),
+        path: `scales.${s}`
+      }), e.set(s, a);
+    }
+    return this.#a = e, this.#At = Object.fromEntries([...e].map(([s, r]) => [s, r.config])), this.#e.setYScales([...e.keys()]), i;
+  }
+  /**
+   * Hand out the Y-axis columns: the default axis keeps its side, and each
+   * visible named scale takes its side unless an earlier one holds it —
+   * that one becomes an overlay scale (dev warning).
+   */
+  #St() {
+    const t = /* @__PURE__ */ new Set();
+    this.yAxisWidth > 0 && t.add(this.yAxisPosition);
+    const e = q(this.yAxisPosition);
+    for (const [i, s] of this.#a) {
+      if (s.column = null, this.#j(s.config) <= 0) continue;
+      const r = s.config.position ?? e;
+      if (t.has(r)) {
+        this.#I(`side:${i}`, () => kt({ scaleId: i, side: r }));
+        continue;
+      }
+      t.add(r), s.column = r;
+    }
+  }
+  /** Dev warnings for a series' `scale`: an id `scales` doesn't define, a percent stack on a scale without 0. */
+  #fe(t) {
+    const e = t.scale;
+    e !== void 0 && (this.#a.has(e) || this.#I(`unknown:${e}`, () => wt({ seriesId: t.id, scaleId: e })), tt(t.renderer) === "percent" && !this.getYScale(this.#D(t)).isPlottable(0) && this.#I(`percent:${t.id}`, () => Tt({ seriesId: t.id })));
+  }
+  #I(t, e) {
+    this.#Mt.has(t) || (this.#Mt.add(t), e());
+  }
+  /** Ids of the named Y scales, in declaration order. */
+  getYScaleIds() {
+    return [...this.#a.keys()];
+  }
+  /** The Y scale named `scaleId`; the default scale for `undefined` or an id `scales` doesn't define. */
+  getYScale(t) {
+    return t === void 0 ? this.yScale : this.#a.get(t)?.yScale ?? this.yScale;
+  }
+  /**
+   * The column a scale's axis sits in — always the default axis's for
+   * `undefined`; `null` for an overlay scale or an unknown id.
+   */
+  getYScaleColumn(t) {
+    if (t === void 0) return { position: this.yAxisPosition, width: this.yAxisWidth };
+    const e = this.#a.get(t);
+    return e === void 0 || e.column === null ? null : { position: e.column, width: this.#j(e.config) };
+  }
+  /** The named scale a series maps through, `undefined` for the default scale. */
+  getSeriesScale(t) {
+    const e = this.#t.find((i) => i.id === t);
+    return e === void 0 ? void 0 : this.#D(e);
+  }
+  /** `scale` if `options.scales` defines it, else `undefined` (the default scale). */
+  #ge(t) {
+    return t !== void 0 && this.#a.has(t) ? t : void 0;
+  }
+  #D(t) {
+    return this.#ge(t.scale);
+  }
+  #pe(t) {
+    return t === void 0 ? this.#P : this.#a.get(t) ?? this.#P;
+  }
+  /** The series a scale autoscales from. */
+  #ye(t) {
+    return this.#a.size === 0 ? this.#t : this.#t.filter((e) => this.#D(e) === t);
+  }
+  /** Snap every scale to a fresh fit — what each one holds just changed. */
+  #xe() {
+    this.#m = !0;
+    const t = performance.now();
+    this.#e.onAxisReconfig(t), this.#x(t), this.emit("viewportChange"), this.#i.markDirty();
+  }
+  /**
+   * Install (or clear, with `null`) the value formatter `<YAxis format>` puts
+   * on a scale — its axis labels, crosshair label and `YLabel` read it. `scale`
+   * picks a named scale; an id `scales` doesn't define is a no-op.
+   */
+  setYAxisFormat(t) {
+    t.scale !== void 0 && !this.#a.has(t.scale) || (this.getYScale(t.scale).setFormat(t.format), this.#u());
   }
   /**
    * Apply label-density knobs driven by `<YAxis labelCount=… minLabelSpacing=…>`
    * — kept separate from {@link setAxis} so component props don't force a
-   * Y-animation reset. Triggers a viewportChange + repaint so static charts
-   * react without waiting for pan/zoom.
+   * Y-animation reset. `scale` picks a named scale's axis — an id `scales`
+   * doesn't define is a no-op. Triggers a viewportChange + repaint so static
+   * charts react without waiting for pan/zoom.
    */
   setYAxisLabelDensity(t) {
+    if (t.scale !== void 0 && !this.#a.has(t.scale)) return;
+    const e = this.getYScale(t.scale);
     let i = !1;
-    "labelCount" in t && (this.yScale.setLabelCount(t.labelCount ?? null), i = !0), "minLabelSpacing" in t && (this.yScale.setMinSpacing(t.minLabelSpacing ?? null), i = !0), i && (this.syncScales(), this.emit("viewportChange"), this.#i.markDirty());
+    "labelCount" in t && (e.setLabelCount(t.labelCount ?? null), i = !0), "minLabelSpacing" in t && (e.setMinSpacing(t.minLabelSpacing ?? null), i = !0), i && (this.syncScales(), this.emit("viewportChange"), this.#i.markDirty());
+  }
+  /**
+   * Install (or clear, with `null`) the X label formatter `<XAxis format>`
+   * puts on the axis — its tick labels, the crosshair label, the tooltip and
+   * info-bar headers read it.
+   */
+  setXAxisFormat(t) {
+    this.timeScale.setFormat(t), this.#u();
   }
-  /** Label-density knobs for the time axis — mirror of {@link setYAxisLabelDensity}. */
+  /** Label-density knobs for the X axis — mirror of {@link setYAxisLabelDensity}. */
   setTimeAxisLabelDensity(t) {
-    let i = !1;
-    "labelCount" in t && (this.timeScale.setLabelCount(t.labelCount ?? null), i = !0), "minLabelSpacing" in t && (this.timeScale.setMinSpacing(t.minLabelSpacing ?? null), i = !0), i && (this.syncScales(), this.emit("viewportChange"), this.#i.markDirty());
+    let e = !1;
+    "labelCount" in t && (this.timeScale.setLabelCount(t.labelCount ?? null), e = !0), "minLabelSpacing" in t && (this.timeScale.setMinSpacing(t.minLabelSpacing ?? null), e = !0), e && (this.syncScales(), this.emit("viewportChange"), this.#i.markDirty());
   }
   getMediaSize() {
-    return this.#a.size.media;
+    return this.#l.size.media;
   }
   /** Returns layout metrics for the chart area, Y axis, and time axis. */
   getLayout() {
-    const t = this.#a.size.media, i = this.yAxisWidth, e = this.xAxisHeight;
+    const t = this.#l.size.media, e = this.yAxisWidth, i = this.xAxisHeight, s = t.width - this.#w();
     return {
-      chartArea: { x: this.plotLeft, y: 0, width: t.width - i, height: t.height - e },
-      yAxisWidth: i,
+      chartArea: { x: this.plotLeft, y: 0, width: s, height: t.height - i },
+      yAxisWidth: e,
       yAxisPosition: this.yAxisPosition,
-      xAxisHeight: e
+      xAxisHeight: i
     };
   }
   getDataInterval() {
-    return this.#r;
+    return this.#o;
   }
   /**
    * Update viewport padding at runtime. Refits the visible time range to
@@ -1174,26 +1571,26 @@ class Ai extends At {
    * InfoBar ResizeObserver).
    */
   setPadding(t) {
-    const i = this.#l;
-    this.#l = F(t);
-    const e = this.#l, s = !N(i.left, e.left) || !N(i.right, e.right), r = i.top !== e.top || i.bottom !== e.bottom;
+    const e = this.#d;
+    this.#d = E(t);
+    const i = this.#d, s = !B(e.left, i.left) || !B(e.right, i.right), r = e.top !== i.top || e.bottom !== i.bottom;
     if (s) {
       const { first: n, last: a } = this.getDataBounds();
       if (n !== void 0 && a !== void 0) {
-        const o = this.#a.size.media.width - this.yAxisWidth;
+        const o = this.#l.size.media.width - this.#w();
         this.#O(n, a, o);
       }
     }
     if (s || r) {
-      this.#g = !0;
+      this.#m = !0;
       const n = performance.now();
-      this.#s.onAxisReconfig(n), this.#b(n);
+      this.#e.onAxisReconfig(n), this.#x(n);
     }
     this.syncScales(), this.#i.markDirty(), r && this.emit("viewportChange");
   }
   /** Show or hide the background grid. Takes effect on the next render frame. */
   setGrid(t) {
-    this.#F = t.visible, this.#i.markDirty();
+    this.#G = t.visible, this.#i.markDirty();
   }
   /**
    * Set or clear the edge fade masks (see {@link ChartOptions.fade}).
@@ -1203,14 +1600,14 @@ class Ai extends At {
    * the next render frame.
    */
   setFade(t) {
-    const i = O(t), e = this.#A;
-    i.top === e.top && i.right === e.right && i.left === e.left || (this.#A = i, this.#i.markDirty());
+    const e = Y(t), i = this.#C;
+    e.top === i.top && e.right === i.right && e.left === i.left || (this.#C = e, this.#i.markDirty());
   }
   /** Report the floating header's height (see {@link headerHeight}). The
    *  framework wrappers keep it in sync with the measured Title / InfoBar. */
   setHeaderHeight(t) {
-    const i = Number.isFinite(t) && t > 0 ? t : 0;
-    i !== this.#U && (this.#U = i, this.#f());
+    const e = Number.isFinite(t) && t > 0 ? t : 0;
+    e !== this.#at && (this.#at = e, this.#u());
   }
   /**
    * Set the visual state for one side of the chart. Typically called in
@@ -1221,24 +1618,24 @@ class Ai extends At {
    * The state persists until replaced. `has-more` is accepted for API
    * symmetry and currently renders identically to `idle`.
    */
-  setEdgeState(t, i) {
-    if (this.#S[t] === i) return;
-    const e = this.#S[t] === "loading", s = this.#z[t];
-    this.#z[t] = !1, this.#N[t] = e && !s && (i === "idle" || i === "has-more") ? performance.now() : null, this.#S[t] = i, this.#o.markDirty();
+  setEdgeState(t, e) {
+    if (this.#A[t] === e || !this.checkTimeOnlyFeature("EdgeLoader")) return;
+    const i = this.#A[t] === "loading", s = this.#B[t];
+    this.#B[t] = !1, this.#K[t] = i && !s && (e === "idle" || e === "has-more") ? performance.now() : null, this.#A[t] = e, this.#c.markDirty();
   }
   /** Read the current host-declared state for a given edge. */
   getEdgeState(t) {
-    return this.#S[t];
+    return this.#A[t];
   }
   /**
    * Alpha for a side's `loading` exit fade, or `null` when none is in
    * flight. Self-cleaning: an elapsed fade clears its start stamp.
    */
-  #Dt(t) {
-    const i = this.#N[t];
-    if (i === null) return null;
-    const e = (performance.now() - i) / zt;
-    return e >= 1 ? (this.#N[t] = null, null) : 1 - W(Math.max(0, e));
+  #Zt(t) {
+    const e = this.#K[t];
+    if (e === null) return null;
+    const i = (performance.now() - e) / Jt;
+    return i >= 1 ? (this.#K[t] = null, null) : 1 - W(Math.max(0, i));
   }
   /**
    * Swap the painter used for a side's `loading` spinner — the same
@@ -1246,8 +1643,8 @@ class Ai extends At {
    * (default) falls back to the built-in three-dot spinner. Takes effect
    * immediately if that side is currently in the `loading` state.
    */
-  setEdgeIndicator(t, i) {
-    this.#vt[t] = i, this.#S[t] === "loading" && this.#o.markDirty();
+  setEdgeIndicator(t, e) {
+    e !== null && !this.checkTimeOnlyFeature("EdgeLoader") || (this.#It[t] = e, this.#A[t] === "loading" && this.#c.markDirty());
   }
   /**
    * Resolve the boundary point's Y position and series kind on the primary
@@ -1257,14 +1654,14 @@ class Ai extends At {
    * `open` (the value immediately preceding the boundary); `right` from the
    * last visible candle's `close`.
    */
-  #Ut(t, i) {
-    const e = this.getSeriesIdsByType("time", { visibleOnly: !0, singleLayerOnly: !0 })[0] ?? this.getSeriesIdsByType("time", { visibleOnly: !0 })[0];
-    if (!e) return null;
-    const s = this.getDataAtTime(e, i);
+  #ve(t, e) {
+    const i = this.getSeriesIdsByType("time", { visibleOnly: !0, singleLayerOnly: !0 })[0] ?? this.getSeriesIdsByType("time", { visibleOnly: !0 })[0];
+    if (!i) return null;
+    const s = this.getDataAtTime(i, e);
     if (!s) return null;
-    const r = this.#t.find((n) => n.id === e);
+    const r = this.#t.find((n) => n.id === i);
     return r ? {
-      valueY: this.yScale.valueToY(it(t, s)),
+      valueY: this.getYScale(this.#D(r)).valueToY(dt(t, s)),
       seriesKind: r.renderer.kind
     } : null;
   }
@@ -1274,8 +1671,8 @@ class Ai extends At {
    * placeholder shapes to match the real bars that will render once data
    * lands. `null` when the viewport has no meaningful span yet.
    */
-  #Kt() {
-    const t = this.timeScale.barWidthMedia(this.#r);
+  #Se() {
+    const t = this.timeScale.barWidthMedia(this.#o);
     return Number.isFinite(t) && t > 0 ? t : null;
   }
   /**
@@ -1293,18 +1690,18 @@ class Ai extends At {
    * probed, not kind-gated: a kind check here silently kills hover for the
    * next spatial renderer.
    */
-  #rt(t) {
-    const i = this.#a.size, e = this.#l, s = {
-      top: e.top * i.verticalPixelRatio,
-      bottom: e.bottom * i.verticalPixelRatio
+  #bt(t) {
+    const e = this.#l.size, i = this.#d, s = {
+      top: i.top * e.verticalPixelRatio,
+      bottom: i.bottom * e.verticalPixelRatio
     };
     let r = !1, n = null;
     for (const a of this.#t) {
       if (!a.renderer.hitTest || !a.renderer.setHoverIndex) continue;
       let o = -1;
       if (t) {
-        const l = (t.mediaX - this.plotLeft) * i.horizontalPixelRatio, h = t.mediaY * i.verticalPixelRatio;
-        o = a.renderer.hitTest(l, h, i.bitmap.width, i.bitmap.height, s);
+        const h = (t.mediaX - this.plotLeft) * e.horizontalPixelRatio, l = t.mediaY * e.verticalPixelRatio;
+        o = a.renderer.hitTest(h, l, e.bitmap.width, e.bitmap.height, s);
       }
       a.renderer.setHoverIndex(o) && (r = !0), o >= 0 && !n && (n = { seriesId: a.id, index: o, info: a.renderer.getHoverInfo?.(this.#n) ?? null });
     }
@@ -1317,14 +1714,14 @@ class Ai extends At {
    * Returns the first spatial series (pie, heatmap, or a custom spatial kind)
    * whose `hitTest` claims the position, or `null` if none does.
    */
-  #Pt(t) {
-    const i = this.#a.size, e = this.#l, s = {
-      top: e.top * i.verticalPixelRatio,
-      bottom: e.bottom * i.verticalPixelRatio
-    }, r = (t.mediaX - this.plotLeft) * i.horizontalPixelRatio, n = t.mediaY * i.verticalPixelRatio;
+  #Ut(t) {
+    const e = this.#l.size, i = this.#d, s = {
+      top: i.top * e.verticalPixelRatio,
+      bottom: i.bottom * e.verticalPixelRatio
+    }, r = (t.mediaX - this.plotLeft) * e.horizontalPixelRatio, n = t.mediaY * e.verticalPixelRatio;
     for (const a of this.#t) {
       if (!a.renderer.hitTest) continue;
-      const o = a.renderer.hitTest(r, n, i.bitmap.width, i.bitmap.height, s);
+      const o = a.renderer.hitTest(r, n, e.bitmap.width, e.bitmap.height, s);
       if (o >= 0) return { seriesId: a.id, index: o };
     }
     return null;
@@ -1349,70 +1746,81 @@ class Ai extends At {
    * viewport didn't move, the re-derived values are bit-identical and the
    * method exits without emitting.
    */
-  #jt() {
-    const t = this.#c;
-    if (t === null) return;
-    const { from: i, to: e } = this.timeScale.getRange(), s = this.yScale.getRange(), r = Math.abs(e - i) * 1e-9, n = Math.abs(s.max - s.min) * 1e-9, a = 1e-6;
-    let o;
-    if (this.#K === "pointer") {
-      const l = this.timeScale.xToTime(t.mediaX - this.plotLeft), h = this.yScale.yToValue(t.mediaY);
-      if (!Number.isFinite(l) || !Number.isFinite(h) || Math.abs(l - t.time) <= r && Math.abs(h - t.y) <= n) return;
-      o = { mediaX: t.mediaX, mediaY: t.mediaY, time: l, y: h };
+  #be() {
+    const t = this.#nt;
+    this.#nt = !1;
+    const e = this.#f;
+    if (e === null) return;
+    const { from: i, to: s } = this.timeScale.getRange(), r = this.yScale.getRange(), n = Math.abs(s - i) * 1e-9, a = Math.abs(r.max - r.min) * 1e-9, o = 1e-6;
+    let h;
+    if (this.#ot === "pointer") {
+      const l = this.timeScale.snapToBand(this.timeScale.xToTime(e.mediaX - this.plotLeft)), d = this.yScale.yToValue(e.mediaY);
+      if (!Number.isFinite(l) || !Number.isFinite(d) || Math.abs(l - e.time) <= n && Math.abs(d - e.y) <= a && !t && e.x === this.timeScale.domainValue(e.time)) return;
+      h = { mediaX: e.mediaX, mediaY: e.mediaY, time: l, x: this.timeScale.domainValue(l), y: d };
     } else {
-      if (t.time < i || t.time > e) {
-        this.#c = null, this.#o.markDirty(), this.emit("crosshairMove", null), this.#rt(null);
+      if (e.time < i || e.time > s) {
+        this.#f = null, this.#c.markDirty(), this.emit("crosshairMove", null), this.#bt(null);
         return;
       }
-      const l = this.plotLeft + this.timeScale.timeToX(t.time), h = this.yScale.valueToY(t.y);
-      if (!Number.isFinite(l) || !Number.isFinite(h) || Math.abs(l - t.mediaX) <= a && Math.abs(h - t.mediaY) <= a) return;
-      o = { mediaX: l, mediaY: h, time: t.time, y: t.y };
+      const l = this.plotLeft + this.timeScale.timeToX(e.time), d = this.yScale.valueToY(e.y);
+      if (!Number.isFinite(l) || !Number.isFinite(d) || Math.abs(l - e.mediaX) <= o && Math.abs(d - e.mediaY) <= o && !t && e.x === this.timeScale.domainValue(e.time)) return;
+      h = { mediaX: l, mediaY: d, time: e.time, x: this.timeScale.domainValue(e.time), y: e.y };
     }
-    this.#c = o, this.#o.markDirty(), this.emit("crosshairMove", o), this.#rt(o);
+    this.#f = h, this.#c.markDirty(), this.emit("crosshairMove", h), this.#bt(h);
   }
   /** Tear down the chart: cancel animations, remove listeners, and detach the canvas. */
   destroy() {
     for (const t of this.#t) t.renderer.dispose();
-    this.#t = [], this.#u = [], this.#x = [], this.#y = [], this.#P = null, this.#i.destroy(), this.#o.destroy(), this.#D?.destroy(), this.#a.destroy(), this.#tt?.destroy(), this.#tt = null, this.#Q && this.#k?.destroy(), this.#k = null, this.#Q = !1, this.removeAllListeners();
+    this.#t = [], this.#y = [], this.#T = [], this.#b = [], this.#z = null, this.#i.destroy(), this.#c.destroy(), this.#V?.destroy(), this.#l.destroy(), this.#ut?.destroy(), this.#ut = null, this.#dt && this.#M?.destroy(), this.#M = null, this.#dt = !1, this.removeAllListeners();
   }
   /** The attached performance monitor, or `null` when instrumentation is disabled. */
   getPerfMonitor() {
-    return this.#k;
+    return this.#M;
   }
   /** Compute the earliest and latest timestamps across all series. */
   getDataBounds() {
-    let t, i;
-    for (const e of this.#t) {
-      if (!e.visible || !b(e.renderer)) continue;
-      const s = e.renderer.getTimeBounds();
-      s !== null && ((t === void 0 || s.first < t) && (t = s.first), (i === void 0 || s.last > i) && (i = s.last));
+    let t, e;
+    for (const i of this.#t) {
+      if (!i.visible || !v(i.renderer)) continue;
+      const s = i.renderer.getTimeBounds();
+      s !== null && ((t === void 0 || s.first < t) && (t = s.first), (e === void 0 || s.last > e) && (e = s.last));
     }
-    return { first: t, last: i };
+    return { first: t, last: e };
   }
   /** Set by `setSeriesData`/bulk-replace paths so the next `onDataChanged`
    * snaps the Y range (instead of easing) and `yScale.getRange()` reflects
    * the new domain synchronously. Cleared by `onDataChanged` after each run. */
-  #nt = !1;
+  #kt = !1;
   onDataChanged() {
-    if (this.#L > 0) {
-      this.#q = !0;
+    if (this.#R > 0) {
+      this.#lt = !0;
       return;
     }
     this.updateDataInterval();
-    const { first: t, last: i } = this.getDataBounds();
-    t !== void 0 && (this.#T = t), i !== void 0 && (this.#E = this.#e, this.#e = i);
-    const e = this.#nt;
-    this.#nt = !1;
-    const s = !this.#g && t !== void 0;
-    e && (this.yScale.tickTracker.reset(), this.timeScale.tickTracker.reset()), this.#xt = e;
+    const { first: t, last: e } = this.getDataBounds();
+    t !== void 0 && (this.#S = t), e !== void 0 && (this.#q = this.#s, this.#s = e);
+    const i = this.#kt;
+    this.#kt = !1;
+    const s = !this.#m && t !== void 0;
+    if (i) {
+      this.yScale.tickTracker.reset(), this.timeScale.tickTracker.reset();
+      for (const n of this.#a.values())
+        n.yScale.tickTracker.reset();
+    }
+    this.#Vt = i;
     const r = performance.now();
-    e || s ? (this.#R.seed(r), this.#s.onDataReplaced(r)) : this.#s.onPointAppended(r), this.#s.lastXTarget !== null && (this.#W = !0), t !== void 0 && (this.#g = !0), this.#b(r), this.syncScales(), s ? this.#dt() : this.#i.markDirty(), this.emit("dataUpdate"), this.#f();
+    i || s ? (this.#F.seed(r), this.#e.onDataReplaced(r)) : this.#e.onPointAppended(r), this.#e.lastXTarget !== null && (this.#U = !0), t !== void 0 && (this.#m = !0), this.#x(r), this.syncScales(), s ? this.#wt() : this.#i.markDirty(), this.emit("dataUpdate"), this.#u();
   }
   updateDataInterval() {
+    if (this.#r === "category") {
+      this.#o = 1;
+      return;
+    }
     for (const t of this.#t) {
-      if (!b(t.renderer)) continue;
-      const i = t.renderer.sampleTimes(20);
-      if (i.length >= 2) {
-        this.#r = Ht(i);
+      if (!v(t.renderer)) continue;
+      const e = t.renderer.sampleTimes(20);
+      if (e.length >= 2) {
+        this.#o = qt(e);
         break;
       }
     }
@@ -1422,58 +1830,51 @@ class Ai extends At {
    *  data regardless of the caller's requested kind. Also reset by paths
    *  that intentionally invalidate the current Y baseline (axis bound
    *  change, empty viewport). */
-  #g = !1;
+  #m = !1;
   /** Whether the engine's X slot has received its first emit. Pre-init X
    *  emits are forced to `instant` so first paint snaps to the fitted
    *  range — without this guard the engine would ease from `{0,0}` into
    *  the new target and the very first frame would render with a
    *  zero-width X domain. */
-  #W = !1;
+  #U = !1;
   /**
    * One-shot `setVisibleRange` argument applied on the first data arrival.
    * Captured at chart construction from {@link ChartOptions.viewport.initialRange};
    * cleared the moment it's consumed so subsequent data swaps don't snap
    * back to the initial window.
    */
-  #_;
-  /** Last Y bounds the engine resolved into {@link AnimationState.yRange}.
-   *  Used by {@link renderMain} to detect Y movement frame-to-frame so
-   *  `viewportChange` only emits when the Y range actually shifted — DOM
-   *  axis labels subscribe to that event and re-renders on every tick are
-   *  expensive. Initialised to NaN so the first real Y emit always passes
-   *  the change check. */
-  #at = Number.NaN;
-  #ot = Number.NaN;
+  #it;
   /** Dev warning for values the Y scale can't place — fires once per chart. */
-  #Rt = !1;
+  #_t = !1;
   /**
-   * Sample the visible data window and return the resolved Y bounds in scale
-   * space (see {@link resolveYTarget}), or `null` when no series has data
-   * inside the X destination range.
+   * Sample the visible data window and return the resolved Y bounds of one
+   * scale (`undefined` = default) in its scale space (see {@link resolveYTarget}),
+   * or `null` when none of that scale's series has data inside the X destination range.
    * Sampling runs against `logicalRange` (the X target, not the animating
    * current), so Y stays on a stable target while X eases — both dimensions
    * converge together. Clears {@link #yInited} on empty so the next emit
    * with valid data lands as an instant snap.
    */
-  #ht(t) {
-    const i = t ?? this.#h, e = this.#p.min !== void 0 && this.#p.min !== "auto" && typeof this.#p.min != "number" || this.#p.max !== void 0 && this.#p.max !== "auto" && typeof this.#p.max != "number" ? [] : null, s = this.yScale.getTransform(), r = s === null ? void 0 : this.#Y;
-    r && this.#qt(i);
-    const n = pt({ targetVisible: i, series: this.#t, allValues: e, plottable: r });
-    return n === null ? (this.#g = !1, null) : yt({ raw: n, bounds: this.#p, allValues: e ?? [], transform: s });
+  #_(t, e) {
+    const i = t ?? this.#h, { yScale: s, bounds: r } = this.#pe(e), n = r.min !== void 0 && r.min !== "auto" && typeof r.min != "number" || r.max !== void 0 && r.max !== "auto" && typeof r.max != "number" ? [] : null, a = this.#ye(e), o = s.getTransform(), h = o === null ? void 0 : (d) => s.isPlottable(d);
+    h && this.#ke({ window: i, series: a, yScale: s });
+    const l = Vt({ targetVisible: i, series: a, allValues: n, plottable: h });
+    return l === null ? (e === void 0 && (this.#m = !1), null) : (e !== void 0 && (this.#m = !0), zt({ raw: l, bounds: r, allValues: n ?? [], transform: o }));
   }
   /** Dev-only sweep behind {@link warnUnplottableValues}; stops once it has warned. */
-  #qt(t) {
-    if (!(this.#Rt || process.env.NODE_ENV === "production"))
-      for (const i of this.#t) {
-        if (!i.visible || !b(i.renderer)) continue;
-        const e = i.renderer.getValueRange(t.from, t.to);
-        if (e === null) continue;
-        const s = (i.renderer.stacking === "normal" ? e.min < 0 && !this.yScale.isPlottable(e.min) : !this.yScale.isPlottable(e.min)) ? e.min : this.yScale.isPlottable(e.max) ? null : e.max;
-        if (s !== null) {
-          this.#Rt = !0, ut({ seriesId: i.id, value: s });
-          return;
-        }
+  #ke(t) {
+    if (this.#_t || process.env.NODE_ENV === "production") return;
+    const { window: e, series: i, yScale: s } = t;
+    for (const r of i) {
+      if (!r.visible || !v(r.renderer)) continue;
+      const n = r.renderer.getValueRange(e.from, e.to);
+      if (n === null) continue;
+      const a = (r.renderer.stacking === "normal" || r.renderer.stacking === "percent" ? n.min < 0 && !s.isPlottable(n.min) : !s.isPlottable(n.min)) ? n.min : s.isPlottable(n.max) ? null : n.max;
+      if (a !== null) {
+        this.#_t = !0, At({ seriesId: r.id, value: a });
+        return;
       }
+    }
   }
   /**
    * Engine pull-on-demand X target. Called by the engine's `computeXTarget`
@@ -1493,29 +1894,31 @@ class Ai extends At {
    * - **autoscroll off** → `null` (no X retarget; user has panned away
    *   from the tail).
    */
-  #Jt() {
-    if (this.#T === null || this.#e === null) return null;
-    const { from: t, to: i } = this.#h, e = t === 0 && i === 0, s = this.#a.size.media.width - this.yAxisWidth;
-    if (e) {
-      if (this.#O(this.#T, this.#e, s), this.#_ !== void 0 && (this.setVisibleRange(this.#_), this.#_ = void 0, !this.#m && this.#e !== null)) {
+  #we() {
+    if (this.#S === null || this.#s === null) return null;
+    const { from: t, to: e } = this.#h, i = t === 0 && e === 0, s = this.#l.size.media.width - this.#w();
+    if (this.#r === "category")
+      return this.#O(this.#S, this.#s, s), this.#h;
+    if (i) {
+      if (this.#O(this.#S, this.#s, s), this.#it !== void 0 && (this.setVisibleRange(this.#it), this.#it = void 0, !this.#p && this.#s !== null)) {
         const { to: n } = this.#h;
-        this.#e >= n && this.#e - n <= this.#r * 1.5 && (this.#m = !0);
+        this.#s >= n && this.#s - n <= this.#o * 1.5 && (this.#p = !0);
       }
       return this.#h;
     }
-    if (!this.#m) return null;
-    if (this.#xt)
-      return this.#O(this.#T, this.#e, s), this.#h;
-    const r = ft({
+    if (!this.#p) return null;
+    if (this.#Vt)
+      return this.#O(this.#S, this.#s, s), this.#h;
+    const r = Pt({
       currentLogical: this.#h,
-      lastTime: this.#e,
-      prevDataEnd: this.#E,
-      dataInterval: this.#r,
-      paddingRight: this.#l.right,
+      lastTime: this.#s,
+      prevDataEnd: this.#q,
+      dataInterval: this.#o,
+      paddingRight: this.#d.right,
       chartWidth: s,
-      holdUntilFilled: this.#M
+      holdUntilFilled: this.#L
     });
-    return r.releaseHold && (this.#M = !1), r.reengageAutoScroll && (this.#m = !0), r.newLogical === null ? null : (this.#R.observe(performance.now()), this.#s.setXSettleMs(this.#R.pickSettleMs(this.#d.axis.x.settleMs)), this.#C(r.newLogical, { emitChange: !1, skipValidation: !0 }), this.#E = this.#e, r.newLogical);
+    return r.releaseHold && (this.#L = !1), r.reengageAutoScroll && (this.#p = !0), r.newLogical === null ? null : (this.#F.observe(performance.now()), this.#e.setXSettleMs(this.#F.pickSettleMs(this.#g.axis.x.settleMs)), this.#H(r.newLogical, { emitChange: !1, skipValidation: !0 }), this.#q = this.#s, r.newLogical);
   }
   /**
    * Fit the viewport's logical X range around a data span. Mirrors the
@@ -1523,16 +1926,21 @@ class Ai extends At {
    * forces autoscroll on (data tail is in the new window by construction),
    * commits the new range via `viewport.setRange` (which emits `change`).
    */
-  #O(t, i, e) {
-    const s = this.#l, r = rt({
+  #O(t, e, i) {
+    const s = this.timeScale.bandRange();
+    if (this.#r === "category" && s !== null) {
+      this.#L = !1, this.#p = !0, this.#H(s, { emitChange: !0, skipValidation: !0 });
+      return;
+    }
+    const r = this.#d, n = ft({
       firstTime: t,
-      lastTime: i,
-      dataInterval: this.#r,
-      maxVisibleBars: this.#St,
-      chartWidth: e,
-      padding: { left: s.left, right: s.right }
+      lastTime: e,
+      dataInterval: this.#o,
+      maxVisibleBars: this.#zt,
+      chartWidth: i,
+      padding: { left: r.left, right: r.right }
     });
-    this.#M = !1, this.#m = !0, this.#C(r, { emitChange: !0 });
+    this.#L = !1, this.#p = !0, this.#H(n, { emitChange: !0 });
   }
   /**
    * Commit a programmatic zoom — `fitContent` or `setVisibleRange`. Reads
@@ -1548,15 +1956,15 @@ class Ai extends At {
    *   passes `xEase: true` so X eases instead — viewport and axis converge
    *   on the same frame.
    */
-  #G(t) {
-    const i = this.#h;
-    if (i.to <= i.from) return;
-    const e = performance.now();
-    if (!this.#W || !this.#g) {
-      this.#Ct(e);
+  #st(t) {
+    const e = this.#h;
+    if (e.to <= e.from) return;
+    const i = performance.now();
+    if (!this.#U || !this.#m) {
+      this.#Gt(i);
       return;
     }
-    this.#s.onProgrammaticZoom({ xTarget: i, xEase: t?.xEase }, e), this.#b(e);
+    this.#e.onProgrammaticZoom({ xTarget: e, xEase: t?.xEase }, i), this.#x(i);
   }
   /**
    * Commit the current logical X to the engine on the *gesture* profile:
@@ -1570,15 +1978,15 @@ class Ai extends At {
    * instead of lagging on the long sticky contract. First paint still snaps
    * (same as the programmatic path) so synchronous readers see final values.
    */
-  #Qt() {
+  #Te() {
     const t = this.#h;
     if (t.to <= t.from) return;
-    const i = performance.now();
-    if (!this.#W || !this.#g) {
-      this.#Ct(i);
+    const e = performance.now();
+    if (!this.#U || !this.#m) {
+      this.#Gt(e);
       return;
     }
-    this.#s.onPanZoom({ xTarget: t, yAuto: !0 }, i), this.#b(i);
+    this.#e.onPanZoom({ xTarget: t, yAuto: !0 }, e), this.#x(e);
   }
   /**
    * First-paint snap: land both axes on the current logical X immediately
@@ -1587,9 +1995,13 @@ class Ai extends At {
    * commits — both must snap before the chart has painted once so a
    * synchronous `getYRange()` / `getVisibleRange()` read sees final values.
    */
-  #Ct(t) {
-    const i = this.#h, e = this.#ht(i);
-    this.#W = !0, e !== null && (this.#g = !0), this.#s.snap({ x: i, y: e ?? void 0 }, t), this.#b(t);
+  #Gt(t) {
+    const e = this.#h, i = this.#_(e), s = {};
+    for (const r of this.#a.keys()) {
+      const n = this.#_(e, r);
+      n !== null && (s[r] = n);
+    }
+    this.#U = !0, i !== null && (this.#m = !0), this.#e.snap({ x: e, y: i ?? void 0, scales: s }, t), this.#x(t);
   }
   /**
    * Validate and commit a new logical X range. Mirrors the old
@@ -1609,9 +2021,9 @@ class Ai extends At {
    * see `setVisibleRange`'s gesture path, where a per-frame echo would
    * otherwise re-arm and stall the in-flight Y ease.
    */
-  #C(t, i) {
-    const { from: e, to: s } = t;
-    return !Number.isFinite(e) || !Number.isFinite(s) || s <= e || !i.skipValidation && (s - e) / this.#r < 2 || this.#h.from === e && this.#h.to === s ? !1 : (this.#h = { from: e, to: s }, i.emitChange && (this.syncScales(), this.#i?.markDirty(), this.emit("viewportChange")), !0);
+  #H(t, e) {
+    const { from: i, to: s } = t;
+    return !Number.isFinite(i) || !Number.isFinite(s) || s <= i || !e.skipValidation && (s - i) / this.#o < 2 || this.#h.from === i && this.#h.to === s ? !1 : (this.#h = { from: i, to: s }, e.emitChange && (this.syncScales(), this.#i?.markDirty(), this.emit("viewportChange")), !0);
   }
   /**
    * Apply pixel-padding to the engine's Y (scale space) and return it as
@@ -1620,28 +2032,25 @@ class Ai extends At {
    * that has an explicit (fixed) axis bound. Padding in scale space keeps
    * the pixel gutters even on a log axis.
    */
-  #It(t) {
-    const { min: i, max: e, chartHeight: s } = t, { min: r, max: n } = this.#ti(), a = e - i, o = s > 0 ? this.#l.top / s * a : 0, l = s > 0 ? this.#l.bottom / s * a : 0, h = {
-      min: r ? i : i - l,
-      max: n ? e : e + o
-    }, d = this.yScale.getTransform();
-    if (d === null) return h;
-    const m = d.inverse(h.min), c = d.inverse(h.max), f = this.yScale.isPlottable(m) && m <= d.inverse(i), g = this.yScale.isPlottable(c) && c >= d.inverse(e);
+  #Ae(t) {
+    const { slot: e, min: i, max: s, chartHeight: r } = t, { yScale: n } = e, { min: a, max: o } = this.#Me(e), h = s - i, l = r > 0 ? this.#d.top / r * h : 0, d = r > 0 ? this.#d.bottom / r * h : 0, f = {
+      min: a ? i : i - d,
+      max: o ? s : s + l
+    }, c = n.getTransform();
+    if (c === null) return f;
+    const m = c.inverse(f.min), y = c.inverse(f.max), u = n.isPlottable(m) && m <= c.inverse(i), g = n.isPlottable(y) && y >= c.inverse(s);
     return {
-      min: f ? m : d.inverse(i),
-      max: g ? c : d.inverse(e)
+      min: u ? m : c.inverse(i),
+      max: g ? y : c.inverse(s)
     };
   }
-  /** Which Y edges the user pinned — a pinned edge takes no padding. */
-  #ti() {
+  /** Which Y edges of a scale the user pinned — a pinned edge takes no padding. */
+  #Me(t) {
     return {
-      min: this.#Ht(this.#p.min),
-      max: this.#Ht(this.#p.max)
+      min: J(t.bounds.min, t.yScale),
+      max: J(t.bounds.max, t.yScale)
     };
   }
-  #Ht(t) {
-    return t === void 0 || t === "auto" ? !1 : !(typeof t == "number" && !this.yScale.isPlottable(t));
-  }
   /**
    * Shift the visible time range by `timeDelta` ms. Hard-clamped so at
    * least one data point stays on screen — no rubber-band, no overshoot.
@@ -1652,18 +2061,18 @@ class Ai extends At {
    * as a gesture for visual easing. Public so consumers can drive pan
    * programmatically.
    */
-  pan(t, i = this.#$) {
-    i > 0 && (this.#$ = i), this.#M = !1;
-    const e = ct({
+  pan(t, e = this.#J) {
+    e > 0 && (this.#J = e), this.#L = !1;
+    const i = St({
       currentLogical: this.#h,
       timeDelta: t,
-      chartWidth: i,
-      dataInterval: this.#r,
-      padding: { left: this.#l.left, right: this.#l.right },
-      dataStart: this.#T,
-      dataEnd: this.#e
+      chartWidth: e,
+      dataInterval: this.#o,
+      padding: { left: this.#d.left, right: this.#d.right },
+      dataStart: this.#S,
+      dataEnd: this.#s
     });
-    e.newLogical !== null && (this.#m = !e.autoScrollOff, this.#C(e.newLogical, { emitChange: !0 }), e.edgeReached !== null && (this.#pt[e.edgeReached.side] = e.edgeReached.boundaryTime, this.#yt?.(e.edgeReached)), this.#R.pause(), this.#zt());
+    i.newLogical !== null && (this.#p = !i.autoScrollOff, this.#H(i.newLogical, { emitChange: !0 }), i.edgeReached !== null && (this.#Dt[i.edgeReached.side] = i.edgeReached.boundaryTime, this.#Rt?.(i.edgeReached)), this.#F.pause(), this.#Kt());
   }
   /**
    * Zoom around a time anchor. `factor < 1` zooms in, `> 1` zooms out.
@@ -1680,37 +2089,37 @@ class Ai extends At {
    * and produce a visible jump). Cursor-anchored zoom is intentionally
    * sacrificed in follow-live mode — pan first to inspect history.
    */
-  zoomAt(t, i, e = this.#$) {
-    e > 0 && (this.#$ = e), this.#M = !1;
-    const s = dt({
+  zoomAt(t, e, i = this.#J) {
+    i > 0 && (this.#J = i), this.#L = !1;
+    const s = bt({
       currentLogical: this.#h,
       centerTime: t,
-      factor: i,
-      chartWidth: e,
-      dataInterval: this.#r,
-      padding: { left: this.#l.left, right: this.#l.right },
-      dataStart: this.#T,
-      dataEnd: this.#e
+      factor: e,
+      chartWidth: i,
+      dataInterval: this.#o,
+      padding: { left: this.#d.left, right: this.#d.right },
+      dataStart: this.#S,
+      dataEnd: this.#s
     });
     if (s.newLogical === null) return;
     let r = s.newLogical;
-    if (this.#m && this.#e !== null) {
-      const n = r.to - r.from, a = B(this.#l.right, n, this.#r, e), o = this.#e + a;
-      r = { from: o - n, to: o }, this.#E = this.#e;
+    if (this.#p && this.#s !== null) {
+      const n = r.to - r.from, a = N(this.#d.right, n, this.#o, i), o = this.#s + a;
+      r = { from: o - n, to: o }, this.#q = this.#s;
     }
-    this.#C(r, { emitChange: !0 }), this.#R.pause(), this.#zt();
+    this.#H(r, { emitChange: !0 }), this.#F.pause(), this.#Kt();
   }
   /**
    * Common tail for `pan` / `zoomAt`: routes the just-committed `#logical`
    * to the engine as a gesture so the X spring retargets and the Y spring
    * eases over `animations.axis.y.gesture`.
    */
-  #zt() {
+  #Kt() {
     const t = this.#h;
     if (t.to <= t.from) return;
-    this.#W = !0, this.#g = !0;
-    const i = performance.now();
-    this.#s.onPanZoom({ xTarget: t, yAuto: !0 }, i), this.#b(i);
+    this.#U = !0, this.#m = !0;
+    const e = performance.now();
+    this.#e.onPanZoom({ xTarget: t, yAuto: !0 }, e), this.#x(e);
   }
   /**
    * Tick the engine at the given wall clock and push the resolved X / Y
@@ -1725,11 +2134,27 @@ class Ai extends At {
    * `effectiveNow === startWall` and the prune step keeps zero-duration
    * events long enough for the slot processor to snap them.
    */
-  #b(t) {
-    const i = this.#s.tick(t), e = this.#a.size;
-    if (e.media.width === 0 || e.media.height === 0) return;
-    const s = e.media.height - this.xAxisHeight;
-    this.#B = this.#It({ min: i.yRange.min, max: i.yRange.max, chartHeight: s }), this.#at = i.yRange.min, this.#ot = i.yRange.max, this.syncScales();
+  #x(t) {
+    const e = this.#e.tick(t), i = this.#l.size;
+    if (i.media.width === 0 || i.media.height === 0) return;
+    const s = i.media.height - this.xAxisHeight;
+    for (const { slot: r, range: n } of this.#jt(e))
+      this.#qt({ slot: r, range: n, chartHeight: s });
+    this.syncScales();
+  }
+  /** Each scale's slot with the engine's current Y (scale space) for it. */
+  #jt(t) {
+    const e = [{ slot: this.#P, range: t.yRange }];
+    for (const [i, s] of this.#a) {
+      const r = this.#e.getScaleYRange(i);
+      r !== null && e.push({ slot: s, range: r });
+    }
+    return e;
+  }
+  /** Pad an engine Y (scale space) into the slot's value range and remember it. */
+  #qt(t) {
+    const { slot: e, range: i, chartHeight: s } = t, r = e.range;
+    e.range = this.#Ae({ slot: e, min: i.min, max: i.max, chartHeight: s }), e.prevMin = i.min, e.prevMax = i.max, (r.min !== e.range.min || r.max !== e.range.max) && e !== this.#P && (this.#nt = !0);
   }
   /**
    * Lightweight scale sync: updates timeScale/yScale from current viewport state
@@ -1737,90 +2162,100 @@ class Ai extends At {
    * handler, so DOM axis components always read fresh coordinates on re-render.
    */
   syncScales() {
-    const t = this.#a.size;
+    const t = this.#l.size;
     if (t.media.width === 0 || t.media.height === 0) return;
-    const i = t.media.width - this.yAxisWidth, e = t.media.height - this.xAxisHeight;
+    const e = t.media.width - this.#w(), i = t.media.height - this.xAxisHeight;
     this.timeScale.update(
-      this.#s.getAnimationState().xRange,
-      i,
+      this.#e.getAnimationState().xRange,
+      e,
       t.horizontalPixelRatio,
-      this.#r
-    ), this.yScale.update(this.#B, e, t.verticalPixelRatio);
+      this.#o
+    ), this.yScale.update(this.#P.range, i, t.verticalPixelRatio);
+    for (const s of this.#a.values())
+      s.yScale.update(s.range, i, t.verticalPixelRatio);
   }
   /** Expensive: background, grid, all series. Only on data/viewport/resize change. */
   renderMain(t) {
-    const i = this.#a.size;
-    if (i.media.width === 0 || i.media.height === 0) return;
-    const e = typeof t == "number" ? t : performance.now(), s = this.#s.tick(e);
+    const e = this.#l.size;
+    if (e.media.width === 0 || e.media.height === 0) return;
+    const i = typeof t == "number" ? t : performance.now(), s = this.#e.tick(i);
     s.animating && this.#i.markDirty();
-    const r = s.yRange.min, n = s.yRange.max, a = r !== this.#at || n !== this.#ot;
-    if (a) {
-      const c = i.media.height - this.xAxisHeight;
-      this.#B = this.#It({ min: r, max: n, chartHeight: c }), this.#at = r, this.#ot = n;
-    }
-    if (this.syncScales(), this.#jt(), this.#e !== null && !this.#m) {
-      const c = this.#s.lastXTarget ?? this.#h, f = c.to - c.from;
-      if (f > 0) {
-        const g = this.#a.size.media.width - this.yAxisWidth, u = B(this.#l.right, f, this.#r, g), p = this.#r * 0.5;
-        Math.abs(c.to - (this.#e + u)) < p && (this.#m = !0);
+    const r = e.media.height - this.xAxisHeight;
+    let n = !1;
+    for (const { slot: c, range: m } of this.#jt(s))
+      m.min === c.prevMin && m.max === c.prevMax || (this.#qt({ slot: c, range: m, chartHeight: r }), n = !0);
+    if (this.syncScales(), this.#be(), this.#s !== null && !this.#p) {
+      const c = this.#e.lastXTarget ?? this.#h, m = c.to - c.from;
+      if (m > 0) {
+        const y = this.#l.size.media.width - this.#w(), u = N(this.#d.right, m, this.#o, y), g = this.#o * 0.5;
+        Math.abs(c.to - (this.#s + u)) < g && (this.#p = !0);
       }
     }
-    a && this.emit("viewportChange");
-    let o = !1, l = !1, h = !1;
-    this.#a.useMainLayer((c) => {
-      const { context: f, bitmapSize: g } = c, u = (i.media.width - this.yAxisWidth) * i.horizontalPixelRatio, p = (i.media.height - this.xAxisHeight) * i.verticalPixelRatio, S = this.#I(c);
-      f.clearRect(0, 0, g.width, g.height), f.save(), f.translate(S, 0), f.beginPath(), f.rect(0, 0, this.#Bt(c, u), p), f.clip(), this.yScale.tickTracker.setCurrentTicks(this.yScale.niceTickValues()), this.timeScale.tickTracker.setCurrentTicks(this.timeScale.niceTickValues(this.#r).ticks), this.yScale.tickTracker.tick(e), this.timeScale.tickTracker.tick(e);
-      const A = this.yScale.tickTracker.snapshot(), k = this.timeScale.tickTracker.snapshot();
-      o = A.isAnimating, l = k.isAnimating, (A.isAnimating || k.isAnimating || s.animating) && this.emit("tickFrame");
-      const w = this.#F ? 1 : 0;
-      if ((w === 0 || A.entries.length > 0 || k.entries.length > 0) && w !== this.#H.target) {
-        const v = J() ? 0 : this.#d.axis.gridMs;
-        this.#H.setTarget(w, { now: e, duration: v });
+    n && this.emit("viewportChange");
+    let a = !1, o = !1, h = !1, l = !1;
+    this.#l.useMainLayer((c) => {
+      const { context: m, bitmapSize: y } = c, u = (e.media.width - this.#w()) * e.horizontalPixelRatio, g = (e.media.height - this.xAxisHeight) * e.verticalPixelRatio, S = this.#W(c);
+      m.clearRect(0, 0, y.width, y.height), m.save(), m.translate(S, 0), m.beginPath(), m.rect(0, 0, this.#re(c, u), g), m.clip(), this.yScale.tickTracker.setCurrentTicks(this.yScale.niceTickValues()), this.timeScale.tickTracker.setCurrentTicks(this.timeScale.niceTickValues(this.#o).ticks), this.yScale.tickTracker.tick(i), this.timeScale.tickTracker.tick(i);
+      for (const x of this.#a.values()) {
+        const b = x.yScale.tickTracker;
+        b.setCurrentTicks(x.yScale.niceTickValues()), b.tick(i) && (h = !0);
+      }
+      const w = this.yScale.tickTracker.snapshot(), T = this.timeScale.tickTracker.snapshot();
+      a = w.isAnimating, o = T.isAnimating, (w.isAnimating || T.isAnimating || h || s.animating) && this.emit("tickFrame");
+      const A = this.#G ? 1 : 0;
+      if ((A === 0 || w.entries.length > 0 || T.entries.length > 0) && A !== this.#E.target) {
+        const x = ht() ? 0 : this.#g.axis.gridMs;
+        this.#E.setTarget(A, { now: i, duration: x });
       }
-      h = this.#H.tick(e);
-      const P = this.#H.current, R = {
+      l = this.#E.tick(i);
+      const R = this.#E.current, I = this.#r === "category" ? ie : T, H = {
         scope: c,
         timeScale: this.timeScale,
         yScale: this.yScale,
         theme: this.#n,
-        yTicks: A,
-        timeTicks: k,
-        alpha: P
-      }, L = this.#Nt(c, u);
-      L === 0 && $(R), this.#_t(c, u, p);
-      const C = this.#l, _ = { top: C.top, bottom: C.bottom }, G = this.#wt(s), I = this.#k;
-      for (const v of this.#t) {
-        const T = v.renderer.getAlpha?.() ?? (v.visible ? 1 : 0);
-        if (T <= 0) continue;
-        const z = {
+        yTicks: w,
+        timeTicks: I,
+        alpha: R
+      }, M = this.#ie(c, u);
+      M === 0 && X(H), this.#ce(c, u, g);
+      const V = this.#d, et = { top: V.top, bottom: V.bottom }, it = this.#ft(s), z = this.#M;
+      for (const x of this.#t) {
+        this.#fe(x);
+        const b = x.renderer.getAlpha?.() ?? (x.visible ? 1 : 0);
+        if (b <= 0) continue;
+        const P = this.#D(x), st = this.getYScale(P), O = {
           scope: c,
           timeScale: this.timeScale,
-          yScale: this.yScale,
+          yScale: st,
           theme: this.#n,
-          dataInterval: this.#r,
-          padding: _,
-          state: G,
-          seriesId: v.id
-        }, V = f.globalAlpha;
-        if (T < 1 && (f.globalAlpha = V * T), I) {
-          const U = performance.now();
-          v.renderer.render(z), I.recordSeries(v.id, performance.now() - U, e);
+          dataInterval: this.#o,
+          padding: et,
+          state: P === void 0 ? it : this.#Wt(s, P),
+          seriesId: x.id
+        }, $ = m.globalAlpha;
+        if (b < 1 && (m.globalAlpha = $ * b), z) {
+          const rt = performance.now();
+          x.renderer.render(O), z.recordSeries(x.id, performance.now() - rt, i);
         } else
-          v.renderer.render(z);
-        T < 1 && (f.globalAlpha = V);
+          x.renderer.render(O);
+        b < 1 && (m.globalAlpha = $);
       }
-      f.restore();
-      const H = { left: S, width: u, height: p };
-      L === 0 ? (this.#Wt({ scope: c, pane: H, timeTicks: k, alpha: P }), this.#lt(c, u)) : (this.#lt(c, u), this.#si({ grid: R, pane: H, overhang: L })), this.#Ft(c, u), this.#Vt(c, p);
-    }), this.#it();
+      m.restore();
+      const F = { left: S, width: u, height: g };
+      M === 0 ? (this.#Qt({ scope: c, pane: F, timeTicks: I, alpha: R }), this.#$(c, u, "left"), this.#$(c, u, "right")) : (this.#$(c, u, "left"), this.#Le({ grid: H, pane: F, overhang: M }), this.#$(c, u, "right")), this.#ee(c, u), this.#Jt(c, g);
+    }), this.#pt();
     let d = !1;
     for (const c of this.#t)
       if (c.renderer.needsAnimation) {
         d = !0, this.#i.markDirty();
         break;
       }
-    const m = o || l;
-    (m || h) && this.#i.markDirty(), !s.animating && !d && !m && (this.yScale.tickTracker.markArmed(), this.timeScale.tickTracker.markArmed());
+    const f = a || o || h;
+    if ((f || l) && this.#i.markDirty(), !s.animating && !d && !f) {
+      this.yScale.tickTracker.markArmed(), this.timeScale.tickTracker.markArmed();
+      for (const c of this.#a.values())
+        c.yScale.tickTracker.markArmed();
+    }
   }
   /**
    * Erase the main layer's alpha across the top fade zone so content
@@ -1829,12 +2264,12 @@ class Ai extends At {
    * a paint-over — so the container background behind the canvas (solid or
    * CSS gradient) shows through untouched.
    */
-  #Vt(t, i) {
-    if (this.#A.top <= 0) return;
-    const e = Math.min(Math.round(this.#A.top * t.verticalPixelRatio), Math.round(i));
-    if (e < 1) return;
+  #Jt(t, e) {
+    if (this.#C.top <= 0) return;
+    const i = Math.min(Math.round(this.#C.top * t.verticalPixelRatio), Math.round(e));
+    if (i < 1) return;
     const { context: s } = t;
-    s.save(), s.globalCompositeOperation = "destination-out", s.fillStyle = this.#ni(s, e), s.fillRect(0, 0, t.bitmapSize.width, e), s.restore();
+    s.save(), s.globalCompositeOperation = "destination-out", s.fillStyle = this.#Re(s, i), s.fillRect(0, 0, t.bitmapSize.width, i), s.restore();
   }
   /**
    * Run the vertical gridlines a short stub past the pane floor, dissolving
@@ -1844,23 +2279,23 @@ class Ai extends At {
    * nothing else paints) and faded with the same destination-out ramp the
    * edge masks use, so the taper stays correct over any background.
    */
-  #Wt(t) {
-    const { scope: i, pane: e, timeTicks: s, alpha: r } = t;
-    if (!this.#F && r <= 0.01 || this.xAxisHeight === 0) return;
-    const { context: n, horizontalPixelRatio: a, verticalPixelRatio: o } = i, l = Math.round(e.height), h = Math.round(D * o);
-    if (h < 1) return;
+  #Qt(t) {
+    const { scope: e, pane: i, timeTicks: s, alpha: r } = t;
+    if (!this.#G && r <= 0.01 || this.xAxisHeight === 0) return;
+    const { context: n, horizontalPixelRatio: a, verticalPixelRatio: o } = e, h = Math.round(i.height), l = Math.round(D * o);
+    if (l < 1) return;
     const d = this.#n.grid;
-    n.save(), n.strokeStyle = d.color, d.style === "dashed" ? n.setLineDash([4 * a, 4 * a]) : d.style === "dotted" && n.setLineDash([1 * a, 3 * a]), n.lineDashOffset = l, n.lineWidth = Ct(a);
-    const m = It(a), c = Math.round(e.width);
-    for (const { value: f, opacity: g } of s.entries) {
-      const u = g * r;
+    n.save(), n.strokeStyle = d.color, d.style === "dashed" ? n.setLineDash([4 * a, 4 * a]) : d.style === "dotted" && n.setLineDash([1 * a, 3 * a]), n.lineDashOffset = h, n.lineWidth = Gt(a);
+    const f = Kt(a), c = Math.round(i.width);
+    for (const { value: m, opacity: y } of s.entries) {
+      const u = y * r;
       if (u <= 0.01) continue;
-      const p = Math.round(this.timeScale.timeToBitmapX(f)) + m;
-      if (p < 0 || p > c) continue;
-      const S = e.left + p;
-      n.globalAlpha = u, n.beginPath(), n.moveTo(S, l), n.lineTo(S, l + h), n.stroke();
+      const g = Math.round(this.timeScale.timeToBitmapX(m)) + f;
+      if (g < 0 || g > c) continue;
+      const S = i.left + g;
+      n.globalAlpha = u, n.beginPath(), n.moveTo(S, h), n.lineTo(S, h + l), n.stroke();
     }
-    n.restore(), this.#Ot(i, e.height);
+    n.restore(), this.#te(e, i.height);
   }
   /**
    * Erase ramp over the below-pane overrun strip — the gridline tail stubs
@@ -1868,12 +2303,12 @@ class Ai extends At {
    * erased at the pane floor, total at the strip's bottom edge, so whatever
    * crosses the floor tapers out short of the time-axis labels.
    */
-  #Ot(t, i) {
+  #te(t, e) {
     if (this.xAxisHeight === 0) return;
-    const e = Math.round(i), s = Math.round(D * t.verticalPixelRatio);
+    const i = Math.round(e), s = Math.round(D * t.verticalPixelRatio);
     if (s < 1) return;
     const { context: r } = t;
-    r.save(), r.globalCompositeOperation = "destination-out", r.fillStyle = this.#oi({ context: r, start: e, height: s }), r.fillRect(0, e, t.bitmapSize.width, s), r.restore();
+    r.save(), r.globalCompositeOperation = "destination-out", r.fillStyle = this.#He({ context: r, start: i, height: s }), r.fillRect(0, i, t.bitmapSize.width, s), r.restore();
   }
   /**
    * Crosshair hairlines with the same edge melt the main layer runs: the
@@ -1885,18 +2320,18 @@ class Ai extends At {
    * edge. Erases alpha (destination-out), so it must run while the
    * crosshair is the only content on the layer.
    */
-  #ii(t) {
-    const i = this.#c;
-    if (i === null) return;
-    const { scope: e, chartBitmapWidth: s, chartBitmapHeight: r } = t, { context: n } = e, a = this.#I(e), o = this.#Bt(e, s), l = this.#Nt(e, s), h = this.xAxisHeight > 0 ? Math.round(D * e.verticalPixelRatio) : 0;
-    n.save(), n.translate(a, 0), n.beginPath(), n.rect(-l, 0, o + l, r + h), n.clip(), vt({
-      scope: e,
-      bitmapX: i.mediaX * e.horizontalPixelRatio - a,
-      bitmapY: i.mediaY * e.verticalPixelRatio,
+  #Pe(t) {
+    const e = this.#f;
+    if (e === null) return;
+    const { scope: i, chartBitmapWidth: s, chartBitmapHeight: r } = t, { context: n } = i, a = this.#W(i), o = this.#re(i, s), h = this.#ie(i, s), l = this.xAxisHeight > 0 ? Math.round(D * i.verticalPixelRatio) : 0;
+    n.save(), n.translate(a, 0), n.beginPath(), n.rect(-h, 0, o + h, r + l), n.clip(), Ft({
+      scope: i,
+      bitmapX: e.mediaX * i.horizontalPixelRatio - a,
+      bitmapY: e.mediaY * i.verticalPixelRatio,
       theme: this.#n,
       pane: { width: s, height: r },
-      leftOverhang: l
-    }), n.restore(), this.#Ot(e, r), l === 0 ? this.#lt(e, s) : this.#Et(e, l), this.#Ft(e, s), this.#Vt(e, r);
+      leftOverhang: h
+    }), n.restore(), this.#te(i, r), h === 0 ? this.#$(i, s, "left") : this.#se(i, h), this.#$(i, s, "right"), this.#ee(i, s), this.#Jt(i, r);
   }
   /**
    * Horizontal companion to {@link #applyTopFade}: dissolve content that
@@ -1905,88 +2340,93 @@ class Ai extends At {
    * Runs the full bitmap height so the below-pane gridline tail stubs melt
    * at the edges in step with their lines above.
    */
-  #lt(t, i) {
-    const e = this.#ct(t, i);
-    if (e === null) return;
-    const { context: s } = t, r = Math.min(e.inner, e.outer), n = Math.abs(e.outer - e.inner);
-    s.save(), s.globalCompositeOperation = "destination-out", s.fillStyle = this.#ai({ context: s, zone: e }), s.fillRect(r, 0, n, t.bitmapSize.height), s.restore();
+  #$(t, e, i) {
+    const s = this.#rt(t, e, i);
+    if (s === null) return;
+    const { context: r } = t, n = Math.min(s.inner, s.outer), a = Math.abs(s.outer - s.inner);
+    r.save(), r.globalCompositeOperation = "destination-out", r.fillStyle = this.#Ie({ context: r, side: i, zone: s }), r.fillRect(n, 0, a, t.bitmapSize.height), r.restore();
   }
   /** Dissolve content leaving through a plain canvas edge — the side opposite
    *  the Y axis, or either side on a spatial-only chart — when configured. */
-  #Ft(t, i) {
-    const { context: e } = t;
-    for (const s of this.#ei()) {
-      const r = this.#ri({ scope: t, paneBitmapWidth: i, side: s });
+  #ee(t, e) {
+    const { context: i } = t;
+    for (const s of this.#Ce()) {
+      const r = this.#De({ scope: t, paneBitmapWidth: e, side: s });
       if (r === null) continue;
       const n = Math.min(r.edge, r.inner), a = Math.abs(r.inner - r.edge);
-      e.save(), e.globalCompositeOperation = "destination-out", e.fillStyle = this.#li({ context: e, side: s, zone: r }), e.fillRect(n, 0, a, t.bitmapSize.height), e.restore();
+      i.save(), i.globalCompositeOperation = "destination-out", i.fillStyle = this.#ze({ context: i, side: s, zone: r }), i.fillRect(n, 0, a, t.bitmapSize.height), i.restore();
     }
   }
-  /** Sides whose fade is a plain edge zone rather than the axis-column ramp. */
-  #ei() {
-    return this.#X() ? Ot : this.yAxisPosition === "left" ? Nt : Ft;
+  /** Sides whose fade is a plain edge zone rather than the axis-column ramp —
+   *  neither the default axis's side nor one a named scale's column holds. */
+  #Ce() {
+    if (this.#Q()) return ee;
+    const t = q(this.yAxisPosition);
+    return this.getAxisColumnWidth(t) > 0 ? se : t === "left" ? re : ne;
   }
   /** Bitmap px the gridlines and crosshair run under a left Y-axis column, where
-   *  data can't follow (see {@link #axisFadeZone}). `0` on the right or with the fade off. */
-  #Nt(t, i) {
-    return this.yAxisPosition !== "left" || this.#ct(t, i) === null ? 0 : Math.min(Math.round(X * t.horizontalPixelRatio), this.#I(t));
+   *  data can't follow (see {@link #axisFadeZone}). `0` without one or with its fade off. */
+  #ie(t, e) {
+    return this.#rt(t, e, "left") === null ? 0 : Math.min(Math.round(K * t.horizontalPixelRatio), this.#W(t));
   }
   /** Left-axis grid pass, run after the axis fade: `destination-over` keeps the
    *  gridlines out of the data ramp, then they taper out under the column. */
-  #si(t) {
-    const { grid: i, pane: e, overhang: s } = t, { scope: r } = i, { context: n } = r;
-    n.save(), n.globalCompositeOperation = "destination-over", n.save(), n.translate(e.left, 0), n.beginPath(), n.rect(-s, 0, e.width + s, e.height), n.clip(), $({ ...i, leftOverhang: s }), n.restore(), this.#Wt({ scope: r, pane: e, timeTicks: i.timeTicks, alpha: i.alpha ?? 1 }), n.restore(), this.#Et(r, s);
+  #Le(t) {
+    const { grid: e, pane: i, overhang: s } = t, { scope: r } = e, { context: n } = r;
+    n.save(), n.globalCompositeOperation = "destination-over";
+    const a = this.#rt(r, i.width, "right")?.intrusion ?? 0;
+    n.save(), n.translate(i.left, 0), n.beginPath(), n.rect(-s, 0, i.width + s + a, i.height), n.clip(), X({ ...e, leftOverhang: s }), n.restore(), this.#Qt({ scope: r, pane: i, timeTicks: e.timeTicks, alpha: e.alpha ?? 1 }), n.restore(), this.#se(r, s);
   }
   /** Erase the {@link #gridOverhang} strip: none at the pane edge, total at its outer end. */
-  #Et(t, i) {
-    const e = this.#I(t), s = e - i, { context: r } = t;
-    r.save(), r.globalCompositeOperation = "destination-out", r.fillStyle = this.#hi({ context: r, start: s, end: e }), r.fillRect(s, 0, i, t.bitmapSize.height), r.restore();
+  #se(t, e) {
+    const i = this.#W(t), s = i - e, { context: r } = t;
+    r.save(), r.globalCompositeOperation = "destination-out", r.fillStyle = this.#Ve({ context: r, start: s, end: i }), r.fillRect(s, 0, e, t.bitmapSize.height), r.restore();
   }
   /** Canvas bitmap x of the pane's left edge — whole device pixels, so the
    *  translated pane keeps crisp strokes. */
-  #I(t) {
+  #W(t) {
     return Math.round(this.plotLeft * t.horizontalPixelRatio);
   }
-  /** Pane-local width of the pane clip: the pane plus the axis-side fade
+  /** Pane-local width of the pane clip: the pane plus the right fade
    *  intrusion, so content can slide under a right Y-axis column before the
    *  mask dissolves it. */
-  #Bt(t, i) {
-    const e = this.#ct(t, i)?.intrusion ?? 0;
-    return i + e;
+  #re(t, e) {
+    const i = this.#rt(t, e, "right")?.intrusion ?? 0;
+    return e + i;
   }
   /**
-   * Bitmap geometry of the fade zone on the Y-axis side. On the right the
+   * Bitmap geometry of the fade zone under the Y-axis column on `side`. On the right the
    * ramp finishes just inside the column — {@link AXIS_FADE_END_GAP_PX} past
    * the pane edge, still short of where the label glyphs start — so content
    * is fully erased before it can cross any axis text; everything wider
    * spills back into the pane as the soft lead-in. On the left it finishes
    * at the pane edge. Erasing starts at `inner` and is total at `outer`;
    * `intrusion` is what the pane clip extends by (content past the ramp is
-   * total-erased anyway). `null` when the axis is hidden, its side's fade
+   * total-erased anyway). `null` when no column sits on `side`, its fade
    * is `0`, or the chart is spatial-only.
    */
-  #ct(t, i) {
-    if (this.#X()) return null;
-    const e = this.yAxisPosition === "left", s = t.bitmapSize.width, r = e ? this.#I(t) : Math.max(0, Math.round(s - i));
-    if (r === 0) return null;
-    const n = t.horizontalPixelRatio, a = Math.round(X * n), o = Math.round(Wt * n), l = e ? 0 : Math.min(a, r), h = e ? a + o : l + o, d = e ? this.#A.left : this.#A.right, m = d === null ? h : Math.round(d * n);
+  #rt(t, e, i) {
+    if (this.#Q()) return null;
+    const s = i === "left", r = t.bitmapSize.width, n = this.#W(t), a = s ? n : Math.max(0, Math.round(r - n - e));
+    if (a === 0) return null;
+    const o = t.horizontalPixelRatio, h = Math.round(K * o), l = Math.round(te * o), d = s ? 0 : Math.min(h, a), f = s ? h + l : d + l, c = s ? this.#C.left : this.#C.right, m = c === null ? f : Math.round(c * o);
     if (m < 1) return null;
-    if (e) {
-      const g = r, u = Math.min(m, s - g);
-      return { inner: g + u, outer: g, intrusion: l };
+    if (s) {
+      const g = a, S = Math.min(m, r - g);
+      return { inner: g + S, outer: g, intrusion: d };
     }
-    const c = i + l, f = Math.min(m, c);
-    return { inner: c - f, outer: c, intrusion: l };
+    const y = n + e + d, u = Math.min(m, y);
+    return { inner: y - u, outer: y, intrusion: d };
   }
   /** Bitmap geometry of a plain fade at the `side` canvas edge — total erase
    *  at `edge`, none at `inner`. Off unless that side's fade is configured. */
-  #ri(t) {
-    const { scope: i, paneBitmapWidth: e, side: s } = t, r = this.#A[s];
+  #De(t) {
+    const { scope: e, paneBitmapWidth: i, side: s } = t, r = this.#C[s];
     if (r === null) return null;
-    const n = Math.min(Math.round(r * i.horizontalPixelRatio), Math.round(e));
+    const n = Math.min(Math.round(r * e.horizontalPixelRatio), Math.round(i));
     if (n < 1) return null;
     if (s === "right") {
-      const a = i.bitmapSize.width;
+      const a = e.bitmapSize.width;
       return { edge: a, inner: a - n };
     }
     return { edge: 0, inner: n };
@@ -1995,15 +2435,15 @@ class Ai extends At {
    *  changes (resize, DPR change, `setFade`). Ease-out ramp (`1 - t²`):
    *  near-total erasure across the upper half keeps a floating header
    *  legible, then a soft tail into full opacity at the zone's bottom. */
-  #ni(t, i) {
-    const e = this.#v.top;
-    if (e !== null && e.height === i) return e.gradient;
-    const s = t.createLinearGradient(0, 0, 0, i);
+  #Re(t, e) {
+    const i = this.#k.top;
+    if (i !== null && i.height === e) return i.gradient;
+    const s = t.createLinearGradient(0, 0, 0, e);
     for (let r = 0; r <= 4; r++) {
       const n = r / 4;
       s.addColorStop(n, `rgba(0, 0, 0, ${1 - n * n})`);
     }
-    return this.#v.top = { height: i, gradient: s }, s;
+    return this.#k.top = { height: e, gradient: s }, s;
   }
   /** Axis-column mask — erase grows from 0 at the ramp's inner start to
    *  total at its outer end on an ease-in (`s³`): zero slope *and* zero
@@ -2011,51 +2451,51 @@ class Ai extends At {
    *  candles at rest and the aggressive erasing all happens deep under the
    *  axis column. Nine stops keep the piecewise interpolation smooth across
    *  the zone. */
-  #ai(t) {
-    const { context: i, zone: e } = t, s = this.#v.axis;
-    if (s !== null && s.inner === e.inner && s.outer === e.outer) return s.gradient;
-    const r = i.createLinearGradient(e.inner, 0, e.outer, 0);
-    for (let n = 0; n <= 8; n++) {
-      const a = n / 8;
-      r.addColorStop(a, `rgba(0, 0, 0, ${a * a * a})`);
+  #Ie(t) {
+    const { context: e, side: i, zone: s } = t, r = this.#k.axis[i];
+    if (r !== null && r.inner === s.inner && r.outer === s.outer) return r.gradient;
+    const n = e.createLinearGradient(s.inner, 0, s.outer, 0);
+    for (let a = 0; a <= 8; a++) {
+      const o = a / 8;
+      n.addColorStop(o, `rgba(0, 0, 0, ${o * o * o})`);
     }
-    return this.#v.axis = { inner: e.inner, outer: e.outer, gradient: r }, r;
+    return this.#k.axis[i] = { inner: s.inner, outer: s.outer, gradient: n }, n;
   }
   /** Erase ramp for the gridline tail stubs — nothing erased at the pane
    *  floor, total at the stub tip, ease-in (`t²`) so a stub holds strength
    *  briefly before melting away short of the label glyphs. */
-  #oi(t) {
-    const i = this.#v.tail;
-    if (i !== null && i.start === t.start && i.height === t.height) return i.gradient;
-    const e = t.context.createLinearGradient(0, t.start, 0, t.start + t.height);
+  #He(t) {
+    const e = this.#k.tail;
+    if (e !== null && e.start === t.start && e.height === t.height) return e.gradient;
+    const i = t.context.createLinearGradient(0, t.start, 0, t.start + t.height);
     for (let s = 0; s <= 4; s++) {
       const r = s / 4;
-      e.addColorStop(r, `rgba(0, 0, 0, ${r * r})`);
+      i.addColorStop(r, `rgba(0, 0, 0, ${r * r})`);
     }
-    return this.#v.tail = { start: t.start, height: t.height, gradient: e }, e;
+    return this.#k.tail = { start: t.start, height: t.height, gradient: i }, i;
   }
   /** Gridline overhang ramp — ease-in (`t²`) like the tail stubs. */
-  #hi(t) {
-    const i = this.#v.overhang;
-    if (i !== null && i.start === t.start && i.end === t.end) return i.gradient;
-    const e = t.context.createLinearGradient(t.end, 0, t.start, 0);
+  #Ve(t) {
+    const e = this.#k.overhang;
+    if (e !== null && e.start === t.start && e.end === t.end) return e.gradient;
+    const i = t.context.createLinearGradient(t.end, 0, t.start, 0);
     for (let s = 0; s <= 4; s++) {
       const r = s / 4;
-      e.addColorStop(r, `rgba(0, 0, 0, ${r * r})`);
+      i.addColorStop(r, `rgba(0, 0, 0, ${r * r})`);
     }
-    return this.#v.overhang = { start: t.start, end: t.end, gradient: e }, e;
+    return this.#k.overhang = { start: t.start, end: t.end, gradient: i }, i;
   }
   /** Opposite-edge mask — mirror of the top ramp: total erase at the
    *  canvas edge, fully opaque at the zone's inner boundary. */
-  #li(t) {
-    const { context: i, side: e, zone: s } = t, r = this.#v.edge[e];
+  #ze(t) {
+    const { context: e, side: i, zone: s } = t, r = this.#k.edge[i];
     if (r !== null && r.edge === s.edge && r.inner === s.inner) return r.gradient;
-    const n = i.createLinearGradient(s.edge, 0, s.inner, 0);
+    const n = e.createLinearGradient(s.edge, 0, s.inner, 0);
     for (let a = 0; a <= 4; a++) {
       const o = a / 4;
       n.addColorStop(o, `rgba(0, 0, 0, ${1 - o * o})`);
     }
-    return this.#v.edge[e] = { edge: s.edge, inner: s.inner, gradient: n }, n;
+    return this.#k.edge[i] = { edge: s.edge, inner: s.inner, gradient: n }, n;
   }
   /**
    * Paint a full frame: the main layer, then the overlay synchronously on
@@ -2066,94 +2506,98 @@ class Ai extends At {
    * `markDirty` calls made *during* `renderOverlay` (pulse, edge spinner)
    * land after the consume and re-arm cleanly for the next frame.
    */
-  #dt(t) {
-    this.#ut("main", t, () => this.renderMain(t)), this.#o.consume(), this.#ut("overlay", t, () => this.renderOverlay(t));
+  #wt(t) {
+    this.#Tt("main", t, () => this.renderMain(t)), this.#c.consume(), this.#Tt("overlay", t, () => this.renderOverlay(t));
   }
   /** Run a layer's paint, booking duration + draw calls to the perf monitor
    *  when one is attached — keeps overlay time out of the `main` samples. */
-  #ut(t, i, e) {
-    const s = this.#k;
+  #Tt(t, e, i) {
+    const s = this.#M;
     if (!s) {
-      e();
+      i();
       return;
     }
     s.resetDrawCalls(t);
     const r = performance.now();
-    e(), s.recordFrame(t, performance.now() - r, i ?? r);
+    i(), s.recordFrame(t, performance.now() - r, e ?? r);
   }
   /** Cheap overlay: crosshair, nearest-point dots, pulse animation, edge indicator. */
   renderOverlay(t) {
-    const i = this.#a.size;
-    if (i.media.width === 0 || i.media.height === 0) return;
-    let e = !1;
-    for (const h of this.#t)
-      if (h.visible && h.renderer.overlayNeedsAnimation) {
-        e = !0;
+    const e = this.#l.size;
+    if (e.media.width === 0 || e.media.height === 0) return;
+    let i = !1;
+    for (const l of this.#t)
+      if (l.visible && l.renderer.overlayNeedsAnimation) {
+        i = !0;
         break;
       }
-    this.#u.some((h) => h.pulse) && (e = !0);
+    this.#y.some((l) => l.pulse) && (i = !0);
     const s = {
-      left: this.#z.left && this.#S.left === "loading" ? "idle" : this.#S.left,
-      right: this.#z.right && this.#S.right === "loading" ? "idle" : this.#S.right
+      left: this.#B.left && this.#A.left === "loading" ? "idle" : this.#A.left,
+      right: this.#B.right && this.#A.right === "loading" ? "idle" : this.#A.right
     }, r = {
-      left: this.#Dt("left"),
-      right: this.#Dt("right")
-    }, n = r.left !== null || r.right !== null, a = s.left === "loading" || s.right === "loading" || n, o = s.left !== "idle" || s.right !== "idle" || n, l = !!this.#c || e || o || this.#u.length > 0 || this.#y.length > 0;
-    if (!(!l && !this.#gt)) {
-      if (this.#gt = l, this.#a.useOverlayLayer((h) => {
-        if (!l) return;
-        const d = (i.media.width - this.yAxisWidth) * i.horizontalPixelRatio, m = (i.media.height - this.xAxisHeight) * i.verticalPixelRatio;
-        this.#c && this.#Mt() && this.#ii({ scope: h, chartBitmapWidth: d, chartBitmapHeight: m }), h.context.save(), h.context.translate(this.#I(h), 0), h.context.beginPath(), h.context.rect(0, 0, d, m), h.context.clip();
-        const c = this.#l, f = { top: c.top, bottom: c.bottom }, g = this.getAnimationState();
-        for (const u of this.#t)
-          u.visible && u.renderer.drawOverlay?.({
-            scope: h,
+      left: this.#Zt("left"),
+      right: this.#Zt("right")
+    }, n = r.left !== null || r.right !== null, a = s.left === "loading" || s.right === "loading" || n, o = s.left !== "idle" || s.right !== "idle" || n, h = !!this.#f || i || o || this.#y.length > 0 || this.#b.length > 0;
+    if (!(!h && !this.#Lt)) {
+      if (this.#Lt = h, this.#l.useOverlayLayer((l) => {
+        if (!h) return;
+        const d = (e.media.width - this.#w()) * e.horizontalPixelRatio, f = (e.media.height - this.xAxisHeight) * e.verticalPixelRatio;
+        this.#f && this.#Nt() && this.#Pe({ scope: l, chartBitmapWidth: d, chartBitmapHeight: f }), l.context.save(), l.context.translate(this.#W(l), 0), l.context.beginPath(), l.context.rect(0, 0, d, f), l.context.clip();
+        const c = this.#d, m = { top: c.top, bottom: c.bottom }, y = this.getAnimationState();
+        for (const u of this.#t) {
+          if (!u.visible) continue;
+          const g = this.#D(u);
+          u.renderer.drawOverlay?.({
+            scope: l,
             timeScale: this.timeScale,
-            yScale: this.yScale,
+            yScale: this.getYScale(g),
             theme: this.#n,
-            dataInterval: this.#r,
-            padding: f,
-            crosshair: this.#c,
-            state: g,
+            // Overlays only snap the crosshair dots with it.
+            dataInterval: this.#X(),
+            padding: m,
+            crosshair: this.#f,
+            state: g === void 0 ? y : this.#Wt(y, g),
             seriesId: u.id
           });
-        this.#Gt(h, d, m), this.#Zt(h, d, m), o && et({
-          scope: h,
-          chartMediaWidth: i.media.width - this.yAxisWidth,
-          chartMediaHeight: i.media.height - this.xAxisHeight,
+        }
+        this.#de(l, d, f), this.#le(l, d, f), o && ut({
+          scope: l,
+          chartMediaWidth: e.media.width - this.#w(),
+          chartMediaHeight: e.media.height - this.xAxisHeight,
           timeScale: this.timeScale,
           theme: this.#n,
           edgeStates: s,
           edgeExitFades: r,
-          edgeIndicatorFns: this.#vt,
-          resolveBoundary: (u) => st(u, this.#pt[u], this.getDataBounds()),
-          resolveEdgeAnchor: (u, p) => this.#Ut(u, p),
-          resolveEdgeBarSpacing: () => this.#Kt(),
-          reportPlaceholders: (u, p) => {
-            this.#j[u] = { bars: p, at: performance.now() };
+          edgeIndicatorFns: this.#It,
+          resolveBoundary: (u) => mt(u, this.#Dt[u], this.getDataBounds()),
+          resolveEdgeAnchor: (u, g) => this.#ve(u, g),
+          resolveEdgeBarSpacing: () => this.#Se(),
+          reportPlaceholders: (u, g) => {
+            this.#ht[u] = { bars: g, at: performance.now() };
           }
-        }), h.context.restore();
-      }), e) {
-        const { from: h, to: d } = this.timeScale.getRange();
-        let m = !1;
+        }), l.context.restore();
+      }), i) {
+        const { from: l, to: d } = this.timeScale.getRange();
+        let f = !1;
         for (const c of this.#t)
-          if (!(!c.visible || !c.renderer.overlayNeedsAnimation) && (c.renderer.hasOverlayContentInRange?.(h, d) ?? !0)) {
-            m = !0;
+          if (!(!c.visible || !c.renderer.overlayNeedsAnimation) && (c.renderer.hasOverlayContentInRange?.(l, d) ?? !0)) {
+            f = !0;
             break;
           }
-        if (!m) {
-          for (const c of this.#u)
-            if (c.pulse && c.time >= h && c.time <= d) {
-              m = !0;
+        if (!f) {
+          for (const c of this.#y)
+            if (c.pulse && c.time >= l && c.time <= d) {
+              f = !0;
               break;
             }
         }
-        m && this.#o.markDirty();
+        f && this.#c.markDirty();
       }
-      a && this.#o.markDirty();
+      a && this.#c.markDirty();
     }
   }
 }
 export {
-  Ai as ChartInstance
+  _e as ChartInstance
 };