@wick-charts/vue 0.5.1 → 0.6.1

package/dist/core/dist/chart.js

@@ -1,62 +1,82 @@
-import { AnimationConfig as z, DEFAULT_LINE_PULSE as N } from "./animation/config.js";
-import { createViewportEngine as H } from "./animation/viewport-engine.js";
-import { CanvasManager as W } from "./canvas-manager.js";
-import { drawEdgeIndicators as E, resolveEdgeBoundary as F } from "./chart/edge-indicators.js";
-import { computeFitToData as O } from "./chart/fit-to-data.js";
-import { getLastValue as Y, getPreviousClose as B, getStackedLastValue as X } from "./chart/last-value.js";
-import { resolveMaxVisibleBars as _, resolvePadding as D, resolvePerfOptions as $, isSameHorizontalPadding as T } from "./chart/options.js";
-import { computePan as U, computeZoom as Z } from "./chart/pan-zoom-math.js";
-import { StreamingCadence as G } from "./chart/streaming-cadence.js";
-import { computeStreamingTarget as j } from "./chart/streaming-target.js";
-import { resolvePaddingTime as C } from "./chart/viewport-padding.js";
-import { computeTargetYRange as q, resolveBound as M } from "./chart/y-target.js";
-import { renderCrosshair as J } from "./components/crosshair.js";
-import { renderGrid as K } from "./components/grid.js";
-import { renderMarker as Q } from "./components/marker.js";
-import { renderReferenceLine as tt } from "./components/reference-line.js";
-import { resolveTimeRegionColors as it, renderTimeRegion as et } from "./components/time-region.js";
-import { EventEmitter as st } from "./events.js";
-import { InteractionHandler as rt } from "./interactions/handler.js";
-import { RenderScheduler as R } from "./render-scheduler.js";
-import { XScale as nt } from "./scales/x-scale.js";
-import { YScale as at } from "./scales/y-scale.js";
-import { resolveSeriesDefinition as ht } from "./series/definition.js";
-import { catppuccin as ot } from "./theme/themes/catppuccin.js";
-import { normalizeTime as g, detectInterval as lt } from "./utils/time.js";
-let ct = 0, dt = 0, mt = 0, ut = 0;
-function I(m, t) {
-  return m === t ? !0 : !m || !t || m.length !== t.length ? !1 : m.every((i, e) => i === t[e]);
+import { AnimationConfig as O, DEFAULT_LINE_PULSE as N } from "./animation/config.js";
+import { easeOutCubic as R } from "./animation/easing.js";
+import { createViewportEngine as E } from "./animation/viewport-engine.js";
+import { CanvasManager as Y } from "./canvas-manager.js";
+import { resolveEdgeAnchorValue as X, drawEdgeIndicators as Z, resolveEdgeBoundary as $ } from "./chart/edge-indicators.js";
+import { computeFitToData as _ } from "./chart/fit-to-data.js";
+import { getLastValue as G, getPreviousClose as U, getStackedLastValue as K } from "./chart/last-value.js";
+import { resolveFade as C, resolveMaxVisibleBars as j, resolvePadding as I, resolvePerfOptions as q, isSameHorizontalPadding as P } from "./chart/options.js";
+import { computePan as J, computeZoom as Q } from "./chart/pan-zoom-math.js";
+import { StreamingCadence as tt } from "./chart/streaming-cadence.js";
+import { computeStreamingTarget as it } from "./chart/streaming-target.js";
+import { resolvePaddingTime as H } from "./chart/viewport-padding.js";
+import { computeTargetYRange as et, resolveBound as z } from "./chart/y-target.js";
+import { renderCrosshair as st } from "./components/crosshair.js";
+import { renderGrid as rt } from "./components/grid.js";
+import { renderMarker as nt } from "./components/marker.js";
+import { renderReferenceLine as at } from "./components/reference-line.js";
+import { resolveTimeRegionColors as ht, renderTimeRegion as ot } from "./components/time-region.js";
+import { EventEmitter as lt } from "./events.js";
+import { InteractionHandler as ct } from "./interactions/handler.js";
+import { RenderScheduler as V } from "./render-scheduler.js";
+import { XScale as dt } from "./scales/x-scale.js";
+import { YScale as mt } from "./scales/y-scale.js";
+import { resolveSeriesDefinition as ut } from "./series/definition.js";
+import { isTimeSeriesRenderer as x } from "./series/types.js";
+import { catppuccin as ft } from "./theme/themes/catppuccin.js";
+import { clamp as gt } from "./utils/math.js";
+import { normalizeTime as v, detectInterval as pt } from "./utils/time.js";
+const yt = 200, vt = 1500, bt = 48, xt = 12, A = 9;
+let St = 0, kt = 0, wt = 0, At = 0;
+function W(g, t) {
+  return g === t ? !0 : !g || !t || g.length !== t.length ? !1 : g.every((i, e) => i === t[e]);
 }
-function ft(m, t) {
-  return m === t ? !0 : !m || !t || m.length !== t.length ? !1 : m.every((i, e) => i === t[e]);
+function Mt(g, t) {
+  return g === t ? !0 : !g || !t || g.length !== t.length ? !1 : g.every((i, e) => i === t[e]);
 }
-class Ot extends st {
+class ti extends lt {
   /** Canvas lifecycle and DPR-aware sizing. */
-  #n;
+  #a;
   /** Schedules main-layer redraws (background, grid, series). */
-  #i;
+  #e;
   /** Schedules overlay redraws (crosshair). */
-  #l;
+  #h;
   /** Maps time values to horizontal pixel coordinates. */
   timeScale;
   /** Maps price/value to vertical pixel coordinates. */
   yScale;
   /** Zoom, pan, crosshair — null when interactive=false. */
-  #W;
+  #T;
   /** All registered series (candlestick, line, bar, pie). */
   #t = [];
   /** Point annotations (event markers) drawn on the overlay layer, kept out of the series model. */
   #m = [];
   /** Time-region bands drawn on the main layer behind the series, kept out of the series model. */
-  #v = [];
+  #b = [];
   /** Reference lines (horizontal threshold / vertical event) drawn on the overlay layer, kept out of the series model. */
-  #g = [];
+  #y = [];
+  /**
+   * Overlay-intro latch. Annotations ride the *initial* reveal, then stay put.
+   * `#overlayIntroSeen` flips once we've actually watched an intro in progress
+   * (guards against latching on an empty chart before any data arrives);
+   * `#overlayIntroSettled` freezes the front at `1` afterward so a series added
+   * later — which re-arms `getIntroFront()`'s global min — can't blink settled
+   * markers / reference lines back out.
+   */
+  #rt = !1;
+  #nt = !1;
   /** Active visual theme (colors, fonts, grid style). */
-  #r;
+  #n;
   /** Whether to render the background grid. */
-  #E;
+  #V;
+  /** Resolved edge-fade zones — `right: null` tracks the live Y-axis width. */
+  #k;
+  /** 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. */
+  #w = { top: null, right: null, left: null, tail: null };
   /** Detected time interval between data points (milliseconds). */
-  #a = 6e4;
+  #r = 6e4;
   /** Current crosshair position, null when cursor is outside the chart. */
   #d = null;
   /**
@@ -66,30 +86,45 @@ class Ot extends st {
    * `time`/`y`; `'time'` (programmatic {@link setCrosshair}) keeps
    * `time`/`y` and re-projects the pixel position.
    */
-  #F = "pointer";
+  #X = "pointer";
   /** Whether the last overlay pass painted anything — gates the full-bitmap
    *  clear so an empty overlay isn't cleared again every main frame. */
-  #q = !1;
+  #at = !1;
   /** User-specified Y-axis bounds (auto, fixed, percentage). */
-  #h = {};
+  #l = {};
   /** Cached series ID list — invalidated on add/remove. */
-  #A = null;
+  #D = null;
   /** Axis visibility and sizing configuration. */
-  #I = {};
+  #W = {};
   /** Host-declared state per edge — drives the edge-indicator overlay. */
   #x = { 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. */
+  #B = { left: null, right: null };
   /** Cached boundary timestamps from the last `edgeReached` emission, by side. */
-  #J = { left: null, right: null };
+  #ht = { left: null, right: null };
+  /** Latest placeholder shapes a `loading` indicator reported per side —
+   *  the morph hand-off candidate consumed by {@link prependData}. */
+  #Z = { 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. */
+  #I = { left: !1, right: !1 };
   /** Host-supplied callback fired when the user releases a pan/zoom past a data edge. */
-  #K;
+  #ot;
+  /** Per-side custom painter for the edge `loading` spinner. `null` falls back to the built-in dots. */
+  #lt = { left: null, right: null };
   /** Nesting depth for batch updates. Suppresses recomputes while > 0. */
-  #w = 0;
+  #M = 0;
   /** True when batched operations include data changes (triggers full onDataChanged on end). */
-  #O = !1;
+  #$ = !1;
   /** True when batched operations include visibility changes (triggers Y-range + redraw on end). */
-  #C = !1;
+  #P = !1;
   /** True when batched operations bumped overlay version (emits a single overlayChange on flush). */
-  #Y = !1;
+  #_ = !1;
   /**
    * Monotonic counter bumped on any mutation that affects overlay output —
    * data, visibility, series options, theme. Used by snapshot helpers in
@@ -99,17 +134,17 @@ class Ot extends st {
    *
    * @internal
    */
-  #Q = 0;
+  #ct = 0;
   get yAxisWidth() {
-    const t = this.#I.y;
+    const t = this.#W.y;
     return t?.visible === !1 ? 0 : t?.width ?? 55;
   }
   get xAxisHeight() {
-    const t = this.#I.x;
+    const t = this.#W.x;
     return t?.visible === !1 ? 0 : t?.height ?? 30;
   }
   /** Resolved animation config derived from `options.animations` at construction. */
-  #f;
+  #g;
   /**
    * Single source of truth for the chart's X / Y viewport animation.
    * Push-model API: chart emits intent signals (`onPointAppended`,
@@ -118,13 +153,13 @@ class Ot extends st {
    * matching targets back through `computeXTarget` / `computeYTarget`
    * closures supplied at construction.
    */
-  #e;
+  #s;
   /** 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. */
-  #D;
+  #R;
   /**
    * Mirrors `#dataReplaceSnapPending` for the engine signal that follows
    * inside the same `onDataChanged` call. `#dataReplaceSnapPending` is
@@ -134,18 +169,18 @@ class Ot extends st {
    * field carries the decision across that gap. The closure also reads
    * `#dataStart` / `#dataEnd` directly for the timestamps.
    */
-  #tt = !1;
+  #dt = !1;
   /** Earliest data timestamp registered across all series, `null` before any data has arrived. */
-  #k = null;
+  #A = null;
   /** Latest data timestamp registered across all series, `null` before any data has arrived. */
-  #s = null;
+  #i = 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.
    */
-  #P = null;
+  #F = null;
   /**
    * Warm-up window flag — `setVisibleRange({ from, bars })` arms it and
    * the streaming-target math suppresses pan ticks while the data hasn't
@@ -158,7 +193,7 @@ class Ot extends st {
    * the right edge and trims the left. Resolved once at construction from
    * `options.viewport.maxVisibleBars`.
    */
-  #it;
+  #mt;
   /**
    * Committed logical X range — the "where X should be" target. Engine
    * eases its visual toward this. Pan / zoom / setRange / fitContent /
@@ -167,29 +202,29 @@ class Ot extends st {
    */
   #o = { from: 0, to: 0 };
   /** Padded Y range — engine's raw Y target plus pixel padding from `#padding`. */
-  #V = { min: 0, max: 0 };
+  #O = { 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.
    */
-  #y = !0;
+  #u = !0;
   /** Resolved viewport padding (top/bottom px + left/right pixels-or-intervals). */
   #c;
   /** 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). */
-  #z = 0;
+  #N = 0;
   /** Active performance monitor, or `null` when instrumentation is disabled (the default). */
   #S;
   /** When true, `destroy()` tears down the monitor; false for caller-supplied monitors we must not destroy. */
-  #B = !1;
+  #G = !1;
   /** Visible HUD overlay (mounted by the perf config); non-null only when the caller requested one. */
-  #X = null;
+  #U = null;
   constructor(t, i) {
-    super(), i?.axis && (this.#I = i.axis, this.#h = { min: i.axis.y?.min, max: i.axis.y?.max }), this.#r = i?.theme ?? ot.theme, this.#E = i?.grid?.visible !== !1, this.#f = z.resolve(i?.animations), this.#it = _(i?.viewport?.maxVisibleBars), this.#c = D(i?.padding), this.#D = new G();
-    const e = this.#f.axis.y, s = this.#f.axis.x;
-    this.#e = H({
+    super(), i?.axis && (this.#W = i.axis, this.#l = { min: i.axis.y?.min, max: i.axis.y?.max }), this.#n = i?.theme ?? ft.theme, this.#V = i?.grid?.visible !== !1, this.#k = C(i?.fade), this.#g = O.resolve(i?.animations), this.#mt = j(i?.viewport?.maxVisibleBars), this.#c = I(i?.padding), this.#R = new tt();
+    const e = this.#g.axis.y, s = this.#g.axis.x;
+    this.#s = E({
       initial: { yRange: { min: 0, max: 0 }, xRange: { from: 0, to: 0 } },
       y: {
         curve: e.curve,
@@ -197,28 +232,32 @@ class Ot extends st {
         stickyMs: e.stickyMs,
         stickyFloorMs: e.stickyFloorMs,
         gestureMs: e.gestureMs,
-        toggleMs: this.#f.toggleMs
+        toggleMs: this.#g.toggleMs
       },
       x: {
         curve: s.curve,
         settleMs: s.settleMs,
         gestureMs: s.gestureMs
       },
-      computeXTarget: () => this.#pt(),
-      computeYTarget: ({ xTarget: h }) => this.#nt(h),
-      onWake: () => this.#i?.markDirty()
-    }), this.#K = i?.onEdgeReached, this.#N = i?.viewport?.initialRange;
-    const r = $(i?.perf);
-    this.#S = r.monitor, this.#B = r.ownsMonitor, this.#n = new W(t, this.#S ?? void 0), this.timeScale = new nt(), this.yScale = new at();
-    const n = this.#f.axis.ticksMs;
-    this.timeScale.tickTracker.setFadeMs(n), this.yScale.tickTracker.setFadeMs(n), this.#i = new R((h) => this.#G(h)), this.#l = new R(
-      (h) => this.#j("overlay", h, () => this.renderOverlay(h))
-    ), this.#S && r.hud && (this.#X = r.hud(t, this.#S));
+      computeXTarget: () => this.#Wt(),
+      computeYTarget: ({ xTarget: h }) => this.#xt(h),
+      onWake: () => this.#e?.markDirty()
+    }), this.#ot = i?.onEdgeReached, this.#E = i?.viewport?.initialRange;
+    const r = q(i?.perf);
+    this.#S = r.monitor, this.#G = r.ownsMonitor, this.#a = new Y(t, this.#S ?? void 0), this.timeScale = new dt(), this.yScale = new mt(), this.timeScale.setLocale(i?.locale), this.timeScale.setTimeZone(i?.timeZone);
+    const n = this.#g.axis.ticksMs;
+    this.timeScale.tickTracker.setFadeMs(n), this.yScale.tickTracker.setFadeMs(n), this.#e = new V((h) => this.#et(h)), this.#h = new V(
+      (h) => this.#st("overlay", h, () => this.renderOverlay(h))
+    ), this.#S && r.hud && (this.#U = r.hud(t, this.#S));
     const a = i?.interactive !== !1;
-    this.#W = a ? new rt(this.#n.canvas, this, this.timeScale, this.yScale) : null, this.#n.on("resize", () => {
-      this.syncScales(), this.#G(), this.emit("viewportChange");
-    }), this.syncScales(), this.#W?.on("crosshairMove", (h) => {
-      this.#F = "pointer", this.#d = h, this.#l.markDirty(), this.emit("crosshairMove", h), this.#_(h);
+    this.#T = a ? new ct(this.#a.canvas, this, this.timeScale, this.yScale) : null, this.#a.on("resize", () => {
+      this.syncScales(), this.#et(), this.emit("viewportChange");
+    }), this.syncScales(), this.#T?.on("crosshairMove", (h) => {
+      this.#X = "pointer", this.#d = h, this.#h.markDirty(), this.emit("crosshairMove", h), this.#q(h);
+    }), this.#T?.on("click", (h) => {
+      this.emit("pointClick", { ...h, spatialHit: this.#bt(h) });
+    }), this.#T?.on("dblclick", (h) => {
+      this.fitContent(), this.emit("pointDoubleClick", { ...h, spatialHit: this.#bt(h) });
     });
   }
   /**
@@ -233,9 +272,9 @@ class Ot extends st {
    * `setSeriesVisible` / `setLayerVisible` calls — produce one overlay
    * render instead of N.
    */
-  #b() {
-    if (this.#Q++, this.#w > 0) {
-      this.#Y = !0;
+  #p() {
+    if (this.#ct++, this.#M > 0) {
+      this.#_ = !0;
       return;
     }
     this.emit("overlayChange");
@@ -249,39 +288,39 @@ class Ot extends st {
    * @internal
    */
   getOverlayVersion() {
-    return this.#Q;
+    return this.#ct;
   }
   /**
    * 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.
    */
-  #lt(t) {
+  #Tt(t) {
     if (t && !this.#t.some((e) => e.id === t))
       return t;
     let i;
     do
-      i = `series_${++ct}`;
+      i = `series_${++St}`;
     while (this.#t.some((e) => e.id === i));
     return i;
   }
   addSeries(t, i = {}) {
-    const e = typeof t == "string" ? ht(t) : t;
+    const e = typeof t == "string" ? ut(t) : t;
     if (!e)
       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, ...h } = i, l = s ?? 1, o = {
-      ...this.#f.defaults(e.type),
+      ...this.#g.defaults(e.type),
       ...h,
-      ...this.#f.overrides(e.type)
-    }, u = e.create({ theme: this.#r, layerCount: l }, o), d = a ?? (typeof n == "string" ? [n] : void 0), c = this.#lt(r);
-    return u.onDataChanged?.(() => this.onDataChanged()), this.#t.push({ id: c, labels: d, renderer: u, visible: !0 }), this.#A = null, this.emit("seriesChange"), this.#b(), c;
+      ...this.#g.overrides(e.type)
+    }, u = e.create({ theme: this.#n, layerCount: l }, o), c = a ?? (typeof n == "string" ? [n] : void 0), d = this.#Tt(r);
+    return u.onDataChanged?.(() => this.onDataChanged()), this.#t.push({ id: d, labels: c, renderer: u, visible: !0 }), this.#D = null, this.#j(), this.emit("seriesChange"), this.#p(), d;
   }
   /** Remove a series by ID and clean up its resources. */
   removeSeries(t) {
     const i = this.#t.findIndex((e) => e.id === t);
-    i >= 0 && (this.#t[i].renderer.dispose(), this.#t.splice(i, 1), this.#A = null, this.#i.markDirty(), this.emit("seriesChange"), this.#b());
+    i >= 0 && (this.#t[i].renderer.dispose(), this.#t.splice(i, 1), this.#D = null, this.#j(), this.#e.markDirty(), this.emit("seriesChange"), this.#p());
   }
   // --- Markers (point annotations) -----------------------------------------
   /**
@@ -294,27 +333,27 @@ class Ot extends st {
    * appear in series queries.
    */
   addMarker(t) {
-    const i = `marker_${++dt}`;
-    return this.#m.push(this.#et(i, t)), this.#l.markDirty(), i;
+    const i = `marker_${++kt}`;
+    return this.#m.push(this.#ut(i, t)), this.#h.markDirty(), i;
   }
   /** Replace a marker's config in place. No-op when the id is unknown. */
   updateMarker(t, i) {
     const e = this.#m.findIndex((s) => s.id === t);
-    e !== -1 && (this.#m[e] = this.#et(t, i), this.#l.markDirty());
+    e !== -1 && (this.#m[e] = this.#ut(t, i), this.#h.markDirty());
   }
   /** Remove a marker by id. No-op when the id is unknown. */
   removeMarker(t) {
     const i = this.#m.findIndex((e) => e.id === t);
-    i !== -1 && (this.#m.splice(i, 1), this.#l.markDirty());
+    i !== -1 && (this.#m.splice(i, 1), this.#h.markDirty());
   }
   /** Read-only snapshot of the registered markers (normalized). Mutate via add / update / removeMarker. */
   getMarkers() {
     return this.#m;
   }
-  #et(t, i) {
+  #ut(t, i) {
     return {
       id: t,
-      time: g(i.time),
+      time: v(i.time),
       value: i.value,
       seriesId: i.seriesId,
       shape: i.shape ?? "dot",
@@ -324,41 +363,47 @@ class Ot extends st {
     };
   }
   /** Resolve a marker's Y value: explicit `value`, else snapped to its series at `time`. Null when neither resolves. */
-  #ct(t) {
+  #Dt(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;
   }
   /** Resolve a marker's color: explicit `color`, else the series color, else the theme line color. */
-  #dt(t) {
+  #Rt(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;
     }
-    return this.#r.line.color;
+    return this.#n.line.color;
   }
-  #mt(t) {
+  #Ct(t, i, e) {
     if (this.#m.length === 0) return;
-    const i = performance.now() / (N * 2 * Math.PI) % 1;
-    for (const e of this.#m) {
-      const s = this.#ct(e);
-      s !== null && Q({
+    const s = performance.now() / (N * 2 * Math.PI) % 1, r = this.#K();
+    for (const n of this.#m) {
+      const a = this.#Dt(n);
+      if (a === null) continue;
+      const h = this.#pt(r, n.time);
+      if (h <= 0) continue;
+      const l = t.context.globalAlpha;
+      h < 1 && (t.context.globalAlpha = l * h), nt({
         scope: t,
         timeScale: this.timeScale,
         yScale: this.yScale,
-        theme: this.#r,
+        theme: this.#n,
         marker: {
-          time: e.time,
-          value: s,
-          color: this.#dt(e),
-          shape: e.shape,
-          pulse: e.pulse,
-          label: e.label
+          time: n.time,
+          value: a,
+          color: this.#Rt(n),
+          shape: n.shape,
+          pulse: n.pulse,
+          label: n.label
         },
-        phase: i
-      });
+        phase: s,
+        plotWidth: i,
+        plotHeight: e
+      }), h < 1 && (t.context.globalAlpha = l);
     }
   }
   // --- Time regions (shaded bands) -----------------------------------------
@@ -374,42 +419,42 @@ class Ot extends st {
    * legend.
    */
   addRegion(t) {
-    const i = `region_${++mt}`;
-    return this.#v.push(this.#st(i, t)), this.#i.markDirty(), i;
+    const i = `region_${++wt}`;
+    return this.#b.push(this.#ft(i, t)), this.#e.markDirty(), i;
   }
   /** Replace a region's config in place. No-op when the id is unknown. */
   updateRegion(t, i) {
-    const e = this.#v.findIndex((s) => s.id === t);
-    e !== -1 && (this.#v[e] = this.#st(t, i), this.#i.markDirty());
+    const e = this.#b.findIndex((s) => s.id === t);
+    e !== -1 && (this.#b[e] = this.#ft(t, i), this.#e.markDirty());
   }
   /** Remove a region by id. No-op when the id is unknown. */
   removeRegion(t) {
-    const i = this.#v.findIndex((e) => e.id === t);
-    i !== -1 && (this.#v.splice(i, 1), this.#i.markDirty());
+    const i = this.#b.findIndex((e) => e.id === t);
+    i !== -1 && (this.#b.splice(i, 1), this.#e.markDirty());
   }
   /** Read-only snapshot of the registered regions (normalized). Mutate via add / update / removeRegion. */
   getRegions() {
-    return this.#v;
+    return this.#b;
   }
-  #st(t, i) {
-    const { to: e } = i, s = e === void 0 || e === "now" ? null : g(e);
+  #ft(t, i) {
+    const { to: e } = i, s = e === void 0 || e === "now" ? null : v(e);
     return {
       id: t,
-      from: g(i.from),
+      from: v(i.from),
       to: s,
       fill: i.fill,
       color: i.color,
       label: i.label
     };
   }
-  #ut(t, i, e) {
-    if (this.#v.length !== 0)
-      for (const s of this.#v) {
-        const { color: r, fill: n } = it(s, this.#r);
-        et({
+  #It(t, i, e) {
+    if (this.#b.length !== 0)
+      for (const s of this.#b) {
+        const { color: r, fill: n } = ht(s, this.#n);
+        ot({
           scope: t,
           timeScale: this.timeScale,
-          theme: this.#r,
+          theme: this.#n,
           region: { from: s.from, to: s.to, fill: n, color: r, label: s.label },
           plotWidth: i,
           plotHeight: e
@@ -428,24 +473,24 @@ class Ot extends st {
    * legend.
    */
   addLine(t) {
-    const i = `line_${++ut}`;
-    return this.#g.push(this.#rt(i, t)), this.#l.markDirty(), i;
+    const i = `line_${++At}`;
+    return this.#y.push(this.#gt(i, t)), this.#h.markDirty(), i;
   }
   /** Replace a reference line's config in place. No-op when the id is unknown. */
   updateLine(t, i) {
-    const e = this.#g.findIndex((s) => s.id === t);
-    e !== -1 && (this.#g[e] = this.#rt(t, i), this.#l.markDirty());
+    const e = this.#y.findIndex((s) => s.id === t);
+    e !== -1 && (this.#y[e] = this.#gt(t, i), this.#h.markDirty());
   }
   /** Remove a reference line by id. No-op when the id is unknown. */
   removeLine(t) {
-    const i = this.#g.findIndex((e) => e.id === t);
-    i !== -1 && (this.#g.splice(i, 1), this.#l.markDirty());
+    const i = this.#y.findIndex((e) => e.id === t);
+    i !== -1 && (this.#y.splice(i, 1), this.#h.markDirty());
   }
   /** Read-only snapshot of the registered reference lines (normalized). Mutate via add / update / removeLine. */
   getLines() {
-    return this.#g;
+    return this.#y;
   }
-  #rt(t, i) {
+  #gt(t, i) {
     const { time: e, value: s } = i, r = {
       id: t,
       color: i.color,
@@ -453,27 +498,32 @@ class Ot extends st {
       style: i.style ?? "dashed",
       width: i.width ?? 1
     };
-    return e !== void 0 ? { ...r, orientation: "vertical", coord: g(e) } : { ...r, orientation: "horizontal", coord: s ?? Number.NaN };
-  }
-  #ft(t, i, e) {
-    if (this.#g.length !== 0)
-      for (const s of this.#g)
-        tt({
-          scope: t,
-          timeScale: this.timeScale,
-          yScale: this.yScale,
-          theme: this.#r,
-          line: {
-            orientation: s.orientation,
-            coord: s.coord,
-            color: s.color ?? this.#r.line.color,
-            style: s.style,
-            width: s.width,
-            label: s.label
-          },
-          plotWidth: i,
-          plotHeight: e
-        });
+    return e !== void 0 ? { ...r, orientation: "vertical", coord: v(e) } : { ...r, orientation: "horizontal", coord: s ?? Number.NaN };
+  }
+  #Pt(t, i, e) {
+    if (this.#y.length === 0) return;
+    const s = this.#K();
+    for (const r of this.#y) {
+      const n = s >= 1 ? 1 : r.orientation === "vertical" ? this.#pt(s, r.coord) : R(s);
+      if (n <= 0) continue;
+      const a = t.context.globalAlpha;
+      n < 1 && (t.context.globalAlpha = a * n), at({
+        scope: t,
+        timeScale: this.timeScale,
+        yScale: this.yScale,
+        theme: this.#n,
+        line: {
+          orientation: r.orientation,
+          coord: r.coord,
+          color: r.color ?? this.#n.line.color,
+          style: r.style,
+          width: r.width,
+          label: r.label
+        },
+        plotWidth: i,
+        plotHeight: e
+      }), n < 1 && (t.context.globalAlpha = a);
+    }
   }
   /**
    * Read-only snapshot of the chart's X / Y viewport animation. The same
@@ -482,7 +532,49 @@ class Ot extends st {
    * underlying animator mutates between frames.
    */
   getAnimationState() {
-    return this.#e.getAnimationState();
+    return this.#s.getAnimationState();
+  }
+  /**
+   * Reveal-front position in `[0, 1]` of any in-flight initial-load intro.
+   * With a `seriesId`, that series' own front; without, the minimum across
+   * every visible time series — overlays wait for the slowest reveal. `1`
+   * whenever nothing is introing. Overlay components (the Y-label badge,
+   * annotations) read this to reveal their entrance in step with the draw.
+   */
+  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 i;
+  }
+  /**
+   * Reveal front for annotations (markers / reference lines). The same as
+   * {@link getIntroFront}() during the initial reveal, but latched to `1` once
+   * that first reveal has settled — so introducing another series afterward
+   * doesn't re-hide overlays that already surfaced. Latches only after an intro
+   * 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.
+   */
+  #K() {
+    if (this.#nt) return 1;
+    const t = this.getIntroFront();
+    return t < 1 ? (this.#rt = !0, t) : (this.#rt && (this.#nt = !0), 1);
+  }
+  /**
+   * Entrance alpha for an overlay pinned at `time`, given the intro reveal
+   * `front`. Transparent until the sweep reaches the element's normalized X,
+   * then fades in over a short band — so annotations surface in step with the
+   * series drawing past them. `1` once the intro has settled.
+   */
+  #pt(t, i) {
+    if (t >= 1) return 1;
+    const { from: e, to: s } = this.timeScale.getRange(), r = s - e, n = r > 0 ? (i - e) / r : 0;
+    return gt((t - n) / 0.12, 0, 1);
   }
   /**
    * Replace all data for a series.
@@ -495,13 +587,32 @@ class Ot extends st {
    */
   setSeriesData(t, i, e) {
     const s = this.#t.find((r) => r.id === t);
-    s && (this.#$ = !0, s.renderer.setData(i, e));
+    s && (this.#J = !0, s.renderer.setData(i, e));
   }
   /** 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);
   }
+  /**
+   * Prepend older points to the front of a series — the "load more history on
+   * scroll" path. Unlike {@link setSeriesData}, this deliberately does NOT set
+   * `#dataReplaceSnapPending`: the visible window and the data inside it don't
+   * change, so the viewport must stay put (X) and the Y axis eases if newly
+   * revealed history shifts the range — instead of the full-span re-fit and
+   * instant dual-axis snap a bulk `setSeriesData` replace would force. Routes
+   * through the streaming `onPointAppended` engine signal via `onDataChanged`.
+   *
+   * `points` must be sorted ascending and sit strictly before the current
+   * 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);
+    if (s === void 0 || s.renderer.prependPoints === void 0) return;
+    const r = this.#Z.left;
+    r !== null && s.renderer.setHistoryHandoff !== void 0 && performance.now() - r.at < vt && (s.renderer.setHistoryHandoff(r.bars), this.#I.left = !0, this.#B.left = null, this.#Z.left = null, this.#h.markDirty()), s.renderer.prependPoints(i, e);
+  }
   /** 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);
@@ -526,29 +637,29 @@ class Ot extends st {
   updateSeriesOptions(t, i) {
     const e = this.#t.find((o) => o.id === t);
     if (!e) return;
-    const s = e.labels, r = e.renderer.getLayerColors().slice(), n = this.#f.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(), h = r.length !== a.length || r.some((o, u) => o !== a[u]), l = !I(s, e.labels);
-    (h || l) && this.#b();
+    const s = e.labels, r = e.renderer.getLayerColors().slice(), n = this.#g.overrides(e.renderer.kind);
+    e.renderer.updateOptions({ ...i, ...n }), "label" in i && typeof i.label == "string" && (e.labels = [i.label]), this.#e.markDirty();
+    const a = e.renderer.getLayerColors(), h = r.length !== a.length || r.some((o, u) => o !== a[u]), l = !W(s, e.labels);
+    (h || l) && this.#p();
   }
   /**
    * 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.#w++;
+    this.#M++;
     try {
       t();
     } finally {
-      if (--this.#w <= 0) {
-        if (this.#w = 0, this.#O)
-          this.#O = !1, this.#C = !1, this.onDataChanged();
-        else if (this.#C) {
-          this.#C = !1, this.#u = !0;
+      if (--this.#M <= 0) {
+        if (this.#M = 0, this.#$)
+          this.#$ = !1, this.#P = !1, this.onDataChanged();
+        else if (this.#P) {
+          this.#P = !1, this.#f = !0;
           const i = performance.now();
-          this.#e.onAxisReconfig(i), this.#p(i), this.#i.markDirty();
+          this.#s.onAxisReconfig(i), this.#v(i), this.#e.markDirty();
         }
-        this.#Y && (this.#Y = !1, this.emit("overlayChange"));
+        this.#_ && (this.#_ = !1, this.emit("overlayChange"));
       }
     }
   }
@@ -562,15 +673,15 @@ class Ot extends st {
   setSeriesVisible(t, i) {
     const e = this.#t.find((n) => n.id === t);
     if (!e || e.visible === i) return;
-    e.visible = i, this.#b();
-    const s = this.#f.toggleMs;
-    if (e.renderer.setAlpha?.(i ? 1 : 0, s), this.#i.markDirty(), this.#w > 0) {
-      this.#C = !0;
+    e.visible = i, this.#p(), this.#j();
+    const s = this.#g.toggleMs;
+    if (e.renderer.setAlpha?.(i ? 1 : 0, s), this.#e.markDirty(), this.#M > 0) {
+      this.#P = !0;
       return;
     }
-    this.#u = !0;
+    this.#f = !0;
     const r = performance.now();
-    this.#e.onSeriesVisibilityChanged(r), this.#p(r);
+    this.#s.onSeriesVisibilityChanged(r), this.#v(r);
   }
   /**
    * Whether streaming ticks slide the visible range to track the data tail.
@@ -580,7 +691,7 @@ class Ot extends st {
    * containing the tail.
    */
   getAutoScroll() {
-    return this.#y;
+    return this.#u;
   }
   isSeriesVisible(t) {
     return this.#t.find((i) => i.id === t)?.visible ?? !0;
@@ -598,15 +709,15 @@ class Ot extends st {
   setLayerVisible(t, i, e) {
     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.#b();
-    const r = this.#f.toggleMs;
-    if (s.renderer.setLayerAlpha?.(i, e ? 1 : 0, r), this.#i.markDirty(), this.#w > 0) {
-      this.#C = !0;
+    s.renderer.setLayerVisible(i, e), this.#p();
+    const r = this.#g.toggleMs;
+    if (s.renderer.setLayerAlpha?.(i, e ? 1 : 0, r), this.#e.markDirty(), this.#M > 0) {
+      this.#P = !0;
       return;
     }
-    this.#u = !0;
+    this.#f = !0;
     const n = performance.now();
-    this.#e.onSeriesVisibilityChanged(n), this.#p(n);
+    this.#s.onSeriesVisibilityChanged(n), this.#v(n);
   }
   isLayerVisible(t, i) {
     return this.#t.find((e) => e.id === t)?.renderer.isLayerVisible(i) ?? !0;
@@ -615,11 +726,11 @@ class Ot extends st {
   fitContent() {
     const { first: t, last: i } = this.getDataBounds();
     if (t === void 0 || i === void 0) return;
-    const e = this.#n.size.media.width - this.yAxisWidth;
-    this.#R(t, i, e), this.#H({ xEase: !0 });
+    const e = this.#a.size.media.width - this.yAxisWidth;
+    this.#z(t, i, e), this.#Y({ xEase: !0 });
   }
   getVisibleRange() {
-    return this.#o.from === 0 && this.#o.to === 0 ? this.#e.getAnimationState().xRange : this.#o;
+    return this.#o.from === 0 && this.#o.to === 0 ? this.#s.getAnimationState().xRange : this.#o;
   }
   /**
    * Return the full span of registered data, or `null` before any data has
@@ -627,7 +738,7 @@ class Ot extends st {
    * tracking and is cheaper than recomputing from series stores.
    */
   getDataRange() {
-    return this.#k === null || this.#s === null ? null : { from: this.#k, to: this.#s };
+    return this.#A === null || this.#i === null ? null : { from: this.#A, to: this.#i };
   }
   /**
    * Imperatively set the visible time range. Three forms:
@@ -658,27 +769,27 @@ class Ot extends st {
       if (!Number.isInteger(t) || t < 2) return;
       const { first: n, last: a } = this.getDataBounds();
       if (n === void 0 || a === void 0) return;
-      const h = Math.max(n, a - (t - 1) * this.#a), l = this.#n.size.media.width - this.yAxisWidth;
-      this.#R(h, a, l), this.#H();
+      const h = Math.max(n, a - (t - 1) * this.#r), l = this.#a.size.media.width - this.yAxisWidth;
+      this.#z(h, a, l), this.#Y();
       return;
     }
     if ("bars" in t) {
       if (!Number.isInteger(t.bars) || t.bars < 2) return;
-      const n = g(t.from), a = n + t.bars * this.#a;
-      this.#y = this.#s !== null && this.#s >= n && this.#s <= a, this.#T({ from: n, to: a }, { emitChange: !0 }), this.#L = !0, this.#H();
+      const n = v(t.from), a = n + t.bars * this.#r;
+      this.#u = this.#i !== null && this.#i >= n && this.#i <= a, this.#C({ from: n, to: a }, { emitChange: !0 }), this.#L = !0, this.#Y();
       return;
     }
-    const e = g(t.from), s = g(t.to);
-    this.#y = this.#s !== null && this.#s >= e && this.#s <= s, this.#L = !1;
-    const r = this.#T({ from: e, to: s }, { emitChange: !0 });
+    const e = v(t.from), s = v(t.to);
+    this.#u = this.#i !== null && this.#i >= e && this.#i <= s, this.#L = !1;
+    const r = this.#C({ from: e, to: s }, { emitChange: !0 });
     if (i?.gesture) {
-      r && this.#vt();
+      r && this.#Bt();
       return;
     }
-    this.#H();
+    this.#Y();
   }
   getYRange() {
-    return this.#V;
+    return this.#O;
   }
   getCrosshairPosition() {
     return this.#d;
@@ -719,7 +830,7 @@ class Ot extends st {
   setCrosshair(t) {
     if (t === null) {
       if (this.#d === null) return;
-      this.#d = null, this.#l.markDirty(), this.emit("crosshairMove", null);
+      this.#d = null, this.#h.markDirty(), this.emit("crosshairMove", null);
       return;
     }
     const { time: i } = t;
@@ -731,29 +842,29 @@ class Ot extends st {
     else if (e !== null)
       s = e.y;
     else {
-      const a = this.#V;
+      const a = this.#O;
       s = (a.min + a.max) / 2;
     }
     if (!Number.isFinite(s) || e !== null && e.time === i && e.y === s) return;
     const r = this.timeScale.timeToX(i), n = this.yScale.valueToY(s);
-    this.#F = "time", this.#d = { mediaX: r, mediaY: n, time: i, y: s }, this.#l.markDirty(), this.emit("crosshairMove", this.#d);
+    this.#X = "time", this.#d = { mediaX: r, mediaY: n, time: i, y: s }, this.#h.markDirty(), this.emit("crosshairMove", this.#d);
   }
   /** Get the last visible value and whether the absolute last point is on screen. */
   getLastValue(t) {
-    return Y(t, this.#t, this.#e.getAnimationState().xRange);
+    return G(t, this.#t, this.#s.getAnimationState().xRange);
   }
   /** Get the second-to-last value, useful for computing change. */
   getPreviousClose(t) {
-    return B(t, this.#t);
+    return U(t, this.#t);
   }
   getLastData(t) {
     const i = this.#t.find((e) => e.id === t);
-    return !i || i.renderer.kind === "pie" ? null : i.renderer.getLastDataPoint();
+    return !i || !x(i.renderer) ? null : i.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.#a) ?? null : null;
+    return e ? e.renderer.getDataAtTime?.(i, this.#r) ?? null : null;
   }
   /**
    * Get all layers' data at a given time for multi-layer series (Bar/Line
@@ -763,25 +874,47 @@ class Ot extends st {
    */
   getLayerSnapshots(t, i) {
     const e = this.#t.find((s) => s.id === t);
-    return e?.visible ? e.renderer.getLayerSnapshots?.(i, this.#a) ?? null : null;
+    return e?.visible ? e.renderer.getLayerSnapshots?.(i, this.#r) ?? null : null;
   }
   getSeriesIds() {
-    return this.#A || (this.#A = this.#t.map((t) => t.id)), this.#A.slice();
+    return this.#D || (this.#D = this.#t.map((t) => t.id)), this.#D.slice();
   }
   /**
-   * True if any visible series is non-pie (line / bar / candlestick). Used
-   * to gate crosshair rendering — a pie-only chart has no meaningful x/y
-   * coordinate system, so the dashed hairlines would just be visual noise.
+   * True if any visible series has a time axis (line / bar / candlestick).
+   * Used to gate crosshair rendering — a spatial-only chart (pie, heatmap)
+   * has no meaningful x/y coordinate system, so the dashed hairlines would
+   * just be visual noise.
    */
-  #gt() {
+  #yt() {
     for (const t of this.#t)
-      if (t.visible && t.renderer.kind !== "pie")
+      if (t.visible && x(t.renderer))
         return !0;
     return !1;
   }
   /**
-   * Filter `getSeriesIds()` by renderer type. `'pie'` returns pie series,
-   * `'time'` returns line/bar/candlestick.
+   * 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.
+   */
+  canPanZoom() {
+    return this.#yt();
+  }
+  /**
+   * Push the current pan/zoom capability into the interaction layer (canvas
+   * `touch-action`). Wheel and mouse gates read {@link canPanZoom} live, but
+   * the CSS must be correct *before* a touch gesture starts — call this from
+   * every mutation that can flip {@link canPanZoom}: series add/remove and
+   * series visibility.
+   */
+  #j() {
+    this.#T?.syncPanZoomMode();
+  }
+  /**
+   * Filter `getSeriesIds()` by renderer type. A concrete kind (`'pie'`,
+   * `'heatmap'`, a custom kind, …) returns series of that exact kind;
+   * `'time'` returns every time-axis series (line/bar/candlestick and any
+   * custom time-series kind).
    *
    * - `opts.visibleOnly` — exclude series with `isSeriesVisible=false`; for
    *   multi-layer series also exclude when every layer is hidden.
@@ -791,20 +924,19 @@ class Ot extends st {
   getSeriesIdsByType(t, i) {
     const e = i?.visibleOnly === !0, s = i?.singleLayerOnly === !0, r = [];
     for (const n of this.#t) {
-      const a = n.renderer.kind === "pie";
-      if (t === "pie" && !a || t === "time" && a) continue;
-      const h = n.renderer.getLayerCount();
-      if (!(s && h > 1)) {
+      if (!(t === "time" ? x(n.renderer) : n.renderer.kind === t)) continue;
+      const a = n.renderer.getLayerCount();
+      if (!(s && a > 1)) {
         if (e) {
           if (!n.visible) continue;
-          if (h > 1) {
-            let l = !1;
-            for (let o = 0; o < h; o++)
-              if (n.renderer.isLayerVisible(o)) {
-                l = !0;
+          if (a > 1) {
+            let h = !1;
+            for (let l = 0; l < a; l++)
+              if (n.renderer.isLayerVisible(l)) {
+                h = !0;
                 break;
               }
-            if (!l) continue;
+            if (!h) continue;
           }
         }
         r.push(n.id);
@@ -819,7 +951,22 @@ class Ot extends st {
    * Returns `null` for unknown ids or empty series.
    */
   getStackedLastValue(t) {
-    return X(t, this.#t, this.#e.getAnimationState().xRange);
+    return K(t, this.#t, this.#s.getAnimationState().xRange);
+  }
+  /**
+   * Stacked value at an arbitrary `time` — the cumulative stack top at that
+   * sample, sharing a basis with {@link getStackedLastValue}. Falls back to the
+   * nearest raw sample (close / value) for renderers without a stacked concept
+   * (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);
+    if (s != null) return s;
+    const r = e.renderer.getDataAtTime?.(i, this.#r);
+    return r ? "close" in r ? r.close : r.value : null;
   }
   /**
    * Per-layer last snapshots with each layer's own `time`. Returns `null`
@@ -843,7 +990,7 @@ class Ot extends st {
   /** 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.#r.line.color : null;
+    return i ? i.renderer.getLayerColors()[0] ?? this.#n.line.color : null;
   }
   /** The series' primary name (first layer). Used for single-layer overlays. */
   getSeriesLabel(t) {
@@ -861,7 +1008,7 @@ class Ot extends st {
    */
   setSeriesLabels(t, i) {
     const e = this.#t.find((s) => s.id === t);
-    !e || I(e.labels, i) || (e.labels = i, this.#b());
+    !e || W(e.labels, i) || (e.labels = i, this.#p());
   }
   /**
    * Set the per-layer color overrides carried in `data` (sparse — `undefined`
@@ -872,7 +1019,7 @@ class Ot extends st {
    */
   setLayerColors(t, i) {
     const e = this.#t.find((s) => s.id === t);
-    !e || ft(e.colorOverrides, i) || (e.colorOverrides = i, e.renderer.setColorOverrides?.(i), this.#i.markDirty(), this.#b());
+    !e || Mt(e.colorOverrides, i) || (e.colorOverrides = i, e.renderer.setColorOverrides?.(i), this.#e.markDirty(), this.#p());
   }
   /** Get per-layer colors for a series. Returns null for single-layer non-bar/line series. */
   getSeriesLayers(t) {
@@ -885,29 +1032,43 @@ class Ot extends st {
   }
   /** 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.#r) ?? null;
+    return this.#t.find((i) => i.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.#r) ?? null;
+    return this.#t.find((i) => i.id === t)?.renderer.getHoverInfo?.(this.#n) ?? null;
   }
   /** Apply a new theme and update series colors where appropriate. */
   setTheme(t) {
-    const i = this.#r;
-    this.#r = t;
+    const i = this.#n;
+    this.#n = t;
     for (const e of this.#t)
       e.renderer.applyTheme(t, i);
-    this.#i.markDirty(), this.#b();
+    this.#e.markDirty(), this.#p();
   }
   getTheme() {
-    return this.#r;
+    return this.#n;
+  }
+  /** BCP 47 locale applied to the built-in time-axis / tooltip / crosshair formatting. */
+  setLocale(t) {
+    this.timeScale.setLocale(t), this.#p();
+  }
+  getLocale() {
+    return this.timeScale.getLocale();
+  }
+  /** IANA timezone applied to the same built-in date-time formatting. */
+  setTimeZone(t) {
+    this.timeScale.setTimeZone(t), this.#p();
+  }
+  getTimeZone() {
+    return this.timeScale.getTimeZone();
   }
   /** Update axis configuration and re-render. */
   setAxis(t) {
     const i = this.yAxisWidth, e = this.xAxisHeight;
-    this.#I = t, this.#h = { min: t.y?.min, max: t.y?.max }, this.#u = !0;
+    this.#W = t, this.#l = { min: t.y?.min, max: t.y?.max }, this.#f = !0;
     const s = performance.now();
-    this.#e.onAxisReconfig(s), this.#p(s), (this.yAxisWidth !== i || this.xAxisHeight !== e) && this.syncScales(), this.#i.markDirty();
+    this.#s.onAxisReconfig(s), this.#v(s), (this.yAxisWidth !== i || this.xAxisHeight !== e) && this.syncScales(), this.#e.markDirty();
   }
   /**
    * Apply label-density knobs driven by `<YAxis labelCount=… minLabelSpacing=…>`
@@ -917,19 +1078,19 @@ class Ot extends st {
    */
   setYAxisLabelDensity(t) {
     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 && (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.#e.markDirty());
   }
   /** Label-density knobs for the time 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());
+    "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.#e.markDirty());
   }
   getMediaSize() {
-    return this.#n.size.media;
+    return this.#a.size.media;
   }
   /** Returns layout metrics for the chart area, Y axis, and time axis. */
   getLayout() {
-    const t = this.#n.size.media, i = this.yAxisWidth, e = this.xAxisHeight;
+    const t = this.#a.size.media, i = this.yAxisWidth, e = this.xAxisHeight;
     return {
       chartArea: { x: 0, y: 0, width: t.width - i, height: t.height - e },
       yAxisWidth: i,
@@ -937,7 +1098,7 @@ class Ot extends st {
     };
   }
   getDataInterval() {
-    return this.#a;
+    return this.#r;
   }
   /**
    * Update viewport padding at runtime. Refits the visible time range to
@@ -949,25 +1110,36 @@ class Ot extends st {
    */
   setPadding(t) {
     const i = this.#c;
-    this.#c = D(t);
-    const e = this.#c, s = !T(i.left, e.left) || !T(i.right, e.right), r = i.top !== e.top || i.bottom !== e.bottom;
+    this.#c = I(t);
+    const e = this.#c, s = !P(i.left, e.left) || !P(i.right, e.right), r = i.top !== e.top || i.bottom !== e.bottom;
     if (s) {
       const { first: n, last: a } = this.getDataBounds();
       if (n !== void 0 && a !== void 0) {
-        const h = this.#n.size.media.width - this.yAxisWidth;
-        this.#R(n, a, h);
+        const h = this.#a.size.media.width - this.yAxisWidth;
+        this.#z(n, a, h);
       }
     }
     if (s || r) {
-      this.#u = !0;
+      this.#f = !0;
       const n = performance.now();
-      this.#e.onAxisReconfig(n), this.#p(n);
+      this.#s.onAxisReconfig(n), this.#v(n);
     }
-    this.syncScales(), this.#i.markDirty(), r && this.emit("viewportChange");
+    this.syncScales(), this.#e.markDirty(), r && this.emit("viewportChange");
   }
   /** Show or hide the background grid. Takes effect on the next render frame. */
   setGrid(t) {
-    this.#E = t.visible, this.#i.markDirty();
+    this.#V = t.visible, this.#e.markDirty();
+  }
+  /**
+   * Set or clear the edge fade masks (see {@link ChartOptions.fade}).
+   * Content the main layer draws inside a zone dissolves toward that edge.
+   * `right` omitted re-arms its default (track the Y-axis width); pass
+   * `{ top: 0, right: 0, left: 0 }` to turn every mask off. Takes effect on
+   * the next render frame.
+   */
+  setFade(t) {
+    const i = C(t), e = this.#k;
+    i.top === e.top && i.right === e.right && i.left === e.left || (this.#k = i, this.#e.markDirty());
   }
   /**
    * Set the visual state for one side of the chart. Typically called in
@@ -979,12 +1151,62 @@ class Ot extends st {
    * symmetry and currently renders identically to `idle`.
    */
   setEdgeState(t, i) {
-    this.#x[t] !== i && (this.#x[t] = i, this.#l.markDirty());
+    if (this.#x[t] === i) return;
+    const e = this.#x[t] === "loading", s = this.#I[t];
+    this.#I[t] = !1, this.#B[t] = e && !s && (i === "idle" || i === "has-more") ? performance.now() : null, this.#x[t] = i, this.#h.markDirty();
   }
   /** Read the current host-declared state for a given edge. */
   getEdgeState(t) {
     return this.#x[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.
+   */
+  #vt(t) {
+    const i = this.#B[t];
+    if (i === null) return null;
+    const e = (performance.now() - i) / yt;
+    return e >= 1 ? (this.#B[t] = null, null) : 1 - R(Math.max(0, e));
+  }
+  /**
+   * Swap the painter used for a side's `loading` spinner — the same
+   * pluggable-function contract as the series intro animations. `null`
+   * (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.#lt[t] = i, this.#x[t] === "loading" && this.#h.markDirty();
+  }
+  /**
+   * Resolve the boundary point's Y position and series kind on the primary
+   * visible time series, for a custom edge indicator that wants to start
+   * exactly where the real chart leaves off and match its shape (candle vs.
+   * plain bar/line). `left` continues from the first visible candle's
+   * `open` (the value immediately preceding the boundary); `right` from the
+   * last visible candle's `close`.
+   */
+  #Ht(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);
+    if (!s) return null;
+    const r = this.#t.find((n) => n.id === e);
+    return r ? {
+      valueY: this.yScale.valueToY(X(t, s)),
+      seriesKind: r.renderer.kind
+    } : null;
+  }
+  /**
+   * Resolve the media-pixel spacing between adjacent bars at the chart's
+   * current zoom level, for a custom edge indicator that wants to size its
+   * placeholder shapes to match the real bars that will render once data
+   * lands. `null` when the viewport has no meaningful span yet.
+   */
+  #zt() {
+    const t = this.timeScale.barWidthMedia(this.#r);
+    return Number.isFinite(t) && t > 0 ? t : null;
+  }
   /**
    * Notify chart that a YLabel overlay is mounted / unmounted. Currently a
    * no-op — placeholder for the right-padding reflow that will adjust the
@@ -995,24 +1217,46 @@ class Ot extends st {
   }
   /**
    * Dispatch a crosshair move to every renderer that supports spatial hover
-   * (currently: pie). Any change in hover index schedules a main-layer redraw.
+   * (pie, heatmap — anything implementing hitTest/setHoverIndex). Any change
+   * in hover index schedules a main-layer redraw. Keep this loop capability-
+   * probed, not kind-gated: a kind check here silently kills hover for the
+   * next spatial renderer.
    */
-  #_(t) {
-    const i = this.#n.size, e = this.#c, s = {
+  #q(t) {
+    const i = this.#a.size, e = this.#c, s = {
       top: e.top * i.verticalPixelRatio,
       bottom: e.bottom * i.verticalPixelRatio
     };
-    let r = !1;
-    for (const n of this.#t) {
-      if (!n.renderer.hitTest || !n.renderer.setHoverIndex) continue;
-      let a = -1;
+    let r = !1, n = null;
+    for (const a of this.#t) {
+      if (!a.renderer.hitTest || !a.renderer.setHoverIndex) continue;
+      let h = -1;
       if (t) {
-        const h = t.mediaX * i.horizontalPixelRatio, l = t.mediaY * i.verticalPixelRatio;
-        a = n.renderer.hitTest(h, l, i.bitmap.width, i.bitmap.height, s);
+        const l = t.mediaX * i.horizontalPixelRatio, o = t.mediaY * i.verticalPixelRatio;
+        h = a.renderer.hitTest(l, o, i.bitmap.width, i.bitmap.height, s);
       }
-      n.renderer.setHoverIndex(a) && (r = !0);
+      a.renderer.setHoverIndex(h) && (r = !0), h >= 0 && !n && (n = { seriesId: a.id, index: h, info: a.renderer.getHoverInfo?.(this.#n) ?? null });
+    }
+    r && (this.#e.markDirty(), this.emit("seriesHover", n));
+  }
+  /**
+   * Read-only counterpart to {@link #updateHover} for `pointClick` — same
+   * capability-probed `hitTest` scan, but doesn't touch `setHoverIndex` (a
+   * click shouldn't move the hover state the last pointer move already set).
+   * Returns the first spatial series (pie, heatmap, or a custom spatial kind)
+   * whose `hitTest` claims the position, or `null` if none does.
+   */
+  #bt(t) {
+    const i = this.#a.size, e = this.#c, s = {
+      top: e.top * i.verticalPixelRatio,
+      bottom: e.bottom * i.verticalPixelRatio
+    }, r = t.mediaX * i.horizontalPixelRatio, n = t.mediaY * i.verticalPixelRatio;
+    for (const a of this.#t) {
+      if (!a.renderer.hitTest) continue;
+      const h = a.renderer.hitTest(r, n, i.bitmap.width, i.bitmap.height, s);
+      if (h >= 0) return { seriesId: a.id, index: h };
     }
-    r && this.#i.markDirty();
+    return null;
   }
   /**
    * Re-derive the crosshair after the viewport moved beneath it. A streaming
@@ -1034,30 +1278,30 @@ class Ot extends st {
    * viewport didn't move, the re-derived values are bit-identical and the
    * method exits without emitting.
    */
-  #yt() {
+  #Vt() {
     const t = this.#d;
     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 h;
-    if (this.#F === "pointer") {
+    if (this.#X === "pointer") {
       const l = this.timeScale.xToTime(t.mediaX), o = this.yScale.yToValue(t.mediaY);
       if (!Number.isFinite(l) || !Number.isFinite(o) || Math.abs(l - t.time) <= r && Math.abs(o - t.y) <= n) return;
       h = { mediaX: t.mediaX, mediaY: t.mediaY, time: l, y: o };
     } else {
       if (t.time < i || t.time > e) {
-        this.#d = null, this.#l.markDirty(), this.emit("crosshairMove", null), this.#_(null);
+        this.#d = null, this.#h.markDirty(), this.emit("crosshairMove", null), this.#q(null);
         return;
       }
       const l = this.timeScale.timeToX(t.time), o = this.yScale.valueToY(t.y);
       if (!Number.isFinite(l) || !Number.isFinite(o) || Math.abs(l - t.mediaX) <= a && Math.abs(o - t.mediaY) <= a) return;
       h = { mediaX: l, mediaY: o, time: t.time, y: t.y };
     }
-    this.#d = h, this.#l.markDirty(), this.emit("crosshairMove", h), this.#_(h);
+    this.#d = h, this.#h.markDirty(), this.emit("crosshairMove", h), this.#q(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.#m = [], this.#v = [], this.#g = [], this.#A = null, this.#i.destroy(), this.#l.destroy(), this.#W?.destroy(), this.#n.destroy(), this.#X?.destroy(), this.#X = null, this.#B && this.#S?.destroy(), this.#S = null, this.#B = !1, this.removeAllListeners();
+    this.#t = [], this.#m = [], this.#b = [], this.#y = [], this.#D = null, this.#e.destroy(), this.#h.destroy(), this.#T?.destroy(), this.#a.destroy(), this.#U?.destroy(), this.#U = null, this.#G && this.#S?.destroy(), this.#S = null, this.#G = !1, this.removeAllListeners();
   }
   /** The attached performance monitor, or `null` when instrumentation is disabled. */
   getPerfMonitor() {
@@ -1067,7 +1311,7 @@ class Ot extends st {
   getDataBounds() {
     let t, i;
     for (const e of this.#t) {
-      if (!e.visible || e.renderer.kind === "pie") continue;
+      if (!e.visible || !x(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));
     }
@@ -1076,28 +1320,28 @@ class Ot extends st {
   /** 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. */
-  #$ = !1;
+  #J = !1;
   onDataChanged() {
-    if (this.#w > 0) {
-      this.#O = !0;
+    if (this.#M > 0) {
+      this.#$ = !0;
       return;
     }
     this.updateDataInterval();
     const { first: t, last: i } = this.getDataBounds();
-    t !== void 0 && (this.#k = t), i !== void 0 && (this.#P = this.#s, this.#s = i);
-    const e = this.#$;
-    this.#$ = !1;
-    const s = !this.#u && t !== void 0;
-    e && (this.yScale.tickTracker.reset(), this.timeScale.tickTracker.reset()), this.#tt = e;
+    t !== void 0 && (this.#A = t), i !== void 0 && (this.#F = this.#i, this.#i = i);
+    const e = this.#J;
+    this.#J = !1;
+    const s = !this.#f && t !== void 0;
+    e && (this.yScale.tickTracker.reset(), this.timeScale.tickTracker.reset()), this.#dt = e;
     const r = performance.now();
-    e || s ? (this.#D.seed(r), this.#e.onDataReplaced(r)) : this.#e.onPointAppended(r), this.#e.lastXTarget !== null && (this.#M = !0), t !== void 0 && (this.#u = !0), this.#p(r), this.syncScales(), s ? this.#G() : this.#i.markDirty(), this.emit("dataUpdate"), this.#b();
+    e || s ? (this.#R.seed(r), this.#s.onDataReplaced(r)) : this.#s.onPointAppended(r), this.#s.lastXTarget !== null && (this.#H = !0), t !== void 0 && (this.#f = !0), this.#v(r), this.syncScales(), s ? this.#et() : this.#e.markDirty(), this.emit("dataUpdate"), this.#p();
   }
   updateDataInterval() {
     for (const t of this.#t) {
-      if (t.renderer.kind === "pie") continue;
+      if (!x(t.renderer)) continue;
       const i = t.renderer.sampleTimes(20);
       if (i.length >= 2) {
-        this.#a = lt(i);
+        this.#r = pt(i);
         break;
       }
     }
@@ -1107,28 +1351,28 @@ class Ot extends st {
    *  data regardless of the caller's requested kind. Also reset by paths
    *  that intentionally invalidate the current Y baseline (axis bound
    *  change, empty viewport). */
-  #u = !1;
+  #f = !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. */
-  #M = !1;
+  #H = !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.
    */
-  #N;
+  #E;
   /** 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. */
-  #U = Number.NaN;
-  #Z = Number.NaN;
+  #Q = Number.NaN;
+  #tt = Number.NaN;
   /**
    * Sample the visible data window and return the resolved Y bounds, or
    * `null` when no series has data inside the X destination range.
@@ -1137,11 +1381,11 @@ class Ot extends st {
    * converge together. Clears {@link #yInited} on empty so the next emit
    * with valid data lands as an instant snap.
    */
-  #nt(t) {
-    const i = t ?? this.#o, e = this.#h.min !== void 0 && this.#h.min !== "auto" && typeof this.#h.min != "number" || this.#h.max !== void 0 && this.#h.max !== "auto" && typeof this.#h.max != "number" ? [] : null, s = q(i, this.#t, e);
+  #xt(t) {
+    const i = t ?? this.#o, e = this.#l.min !== void 0 && this.#l.min !== "auto" && typeof this.#l.min != "number" || this.#l.max !== void 0 && this.#l.max !== "auto" && typeof this.#l.max != "number" ? [] : null, s = et(i, this.#t, e);
     if (s === null)
-      return this.#u = !1, null;
-    const r = M(this.#h.min, s.min, s.max, e ?? [], "min"), n = M(this.#h.max, s.max, s.min, e ?? [], "max");
+      return this.#f = !1, null;
+    const r = z(this.#l.min, s.min, s.max, e ?? [], "min"), n = z(this.#l.max, s.max, s.min, e ?? [], "max");
     return { min: r, max: n };
   }
   /**
@@ -1162,24 +1406,29 @@ class Ot extends st {
    * - **autoscroll off** → `null` (no X retarget; user has panned away
    *   from the tail).
    */
-  #pt() {
-    if (this.#k === null || this.#s === null) return null;
-    const { from: t, to: i } = this.#o, e = t === 0 && i === 0, s = this.#n.size.media.width - this.yAxisWidth;
-    if (e)
-      return this.#R(this.#k, this.#s, s), this.#N !== void 0 && (this.setVisibleRange(this.#N), this.#N = void 0), this.#o;
-    if (!this.#y) return null;
-    if (this.#tt)
-      return this.#R(this.#k, this.#s, s), this.#o;
-    const r = j({
+  #Wt() {
+    if (this.#A === null || this.#i === null) return null;
+    const { from: t, to: i } = this.#o, e = t === 0 && i === 0, s = this.#a.size.media.width - this.yAxisWidth;
+    if (e) {
+      if (this.#z(this.#A, this.#i, s), this.#E !== void 0 && (this.setVisibleRange(this.#E), this.#E = void 0, !this.#u && this.#i !== null)) {
+        const { to: n } = this.#o;
+        this.#i >= n && this.#i - n <= this.#r * 1.5 && (this.#u = !0);
+      }
+      return this.#o;
+    }
+    if (!this.#u) return null;
+    if (this.#dt)
+      return this.#z(this.#A, this.#i, s), this.#o;
+    const r = it({
       currentLogical: this.#o,
-      lastTime: this.#s,
-      prevDataEnd: this.#P,
-      dataInterval: this.#a,
+      lastTime: this.#i,
+      prevDataEnd: this.#F,
+      dataInterval: this.#r,
       paddingRight: this.#c.right,
       chartWidth: s,
       holdUntilFilled: this.#L
     });
-    return r.releaseHold && (this.#L = !1), r.reengageAutoScroll && (this.#y = !0), r.newLogical === null ? null : (this.#D.observe(performance.now()), this.#e.setXSettleMs(this.#D.pickSettleMs(this.#f.axis.x.settleMs)), this.#T(r.newLogical, { emitChange: !1, skipValidation: !0 }), this.#P = this.#s, r.newLogical);
+    return r.releaseHold && (this.#L = !1), r.reengageAutoScroll && (this.#u = !0), r.newLogical === null ? null : (this.#R.observe(performance.now()), this.#s.setXSettleMs(this.#R.pickSettleMs(this.#g.axis.x.settleMs)), this.#C(r.newLogical, { emitChange: !1, skipValidation: !0 }), this.#F = this.#i, r.newLogical);
   }
   /**
    * Fit the viewport's logical X range around a data span. Mirrors the
@@ -1187,16 +1436,16 @@ class Ot extends st {
    * forces autoscroll on (data tail is in the new window by construction),
    * commits the new range via `viewport.setRange` (which emits `change`).
    */
-  #R(t, i, e) {
-    const s = this.#c, r = O({
+  #z(t, i, e) {
+    const s = this.#c, r = _({
       firstTime: t,
       lastTime: i,
-      dataInterval: this.#a,
-      maxVisibleBars: this.#it,
+      dataInterval: this.#r,
+      maxVisibleBars: this.#mt,
       chartWidth: e,
       padding: { left: s.left, right: s.right }
     });
-    this.#L = !1, this.#y = !0, this.#T(r, { emitChange: !0 });
+    this.#L = !1, this.#u = !0, this.#C(r, { emitChange: !0 });
   }
   /**
    * Commit a programmatic zoom — `fitContent` or `setVisibleRange`. Reads
@@ -1212,15 +1461,15 @@ class Ot extends st {
    *   passes `xEase: true` so X eases instead — viewport and axis converge
    *   on the same frame.
    */
-  #H(t) {
+  #Y(t) {
     const i = this.#o;
     if (i.to <= i.from) return;
     const e = performance.now();
-    if (!this.#M || !this.#u) {
-      this.#at(e);
+    if (!this.#H || !this.#f) {
+      this.#St(e);
       return;
     }
-    this.#e.onProgrammaticZoom({ xTarget: i, xEase: t?.xEase }, e), this.#p(e);
+    this.#s.onProgrammaticZoom({ xTarget: i, xEase: t?.xEase }, e), this.#v(e);
   }
   /**
    * Commit the current logical X to the engine on the *gesture* profile:
@@ -1234,15 +1483,15 @@ class Ot extends st {
    * instead of lagging on the long sticky contract. First paint still snaps
    * (same as the programmatic path) so synchronous readers see final values.
    */
-  #vt() {
+  #Bt() {
     const t = this.#o;
     if (t.to <= t.from) return;
     const i = performance.now();
-    if (!this.#M || !this.#u) {
-      this.#at(i);
+    if (!this.#H || !this.#f) {
+      this.#St(i);
       return;
     }
-    this.#e.onPanZoom({ xTarget: t, yAuto: !0 }, i), this.#p(i);
+    this.#s.onPanZoom({ xTarget: t, yAuto: !0 }, i), this.#v(i);
   }
   /**
    * First-paint snap: land both axes on the current logical X immediately
@@ -1251,9 +1500,9 @@ class Ot extends st {
    * commits — both must snap before the chart has painted once so a
    * synchronous `getYRange()` / `getVisibleRange()` read sees final values.
    */
-  #at(t) {
-    const i = this.#o, e = this.#nt(i);
-    this.#M = !0, e !== null && (this.#u = !0), this.#e.snap({ x: i, y: e ?? void 0 }, t), this.#p(t);
+  #St(t) {
+    const i = this.#o, e = this.#xt(i);
+    this.#H = !0, e !== null && (this.#f = !0), this.#s.snap({ x: i, y: e ?? void 0 }, t), this.#v(t);
   }
   /**
    * Validate and commit a new logical X range. Mirrors the old
@@ -1273,9 +1522,9 @@ class Ot extends st {
    * see `setVisibleRange`'s gesture path, where a per-frame echo would
    * otherwise re-arm and stall the in-flight Y ease.
    */
-  #T(t, i) {
+  #C(t, i) {
     const { from: e, to: s } = t;
-    return !Number.isFinite(e) || !Number.isFinite(s) || s <= e || !i.skipValidation && (s - e) / this.#a < 2 || this.#o.from === e && this.#o.to === s ? !1 : (this.#o = { from: e, to: s }, i.emitChange && (this.syncScales(), this.#i?.markDirty(), this.emit("viewportChange")), !0);
+    return !Number.isFinite(e) || !Number.isFinite(s) || s <= e || !i.skipValidation && (s - e) / this.#r < 2 || this.#o.from === e && this.#o.to === s ? !1 : (this.#o = { from: e, to: s }, i.emitChange && (this.syncScales(), this.#e?.markDirty(), this.emit("viewportChange")), !0);
   }
   /**
    * Apply pixel-padding to the engine's raw Y target and store the
@@ -1283,9 +1532,9 @@ class Ot extends st {
    * symmetric pad top / bottom from `#padding`, suppressed on the side
    * that has an explicit (fixed) axis bound.
    */
-  #ht(t, i, e, s, r) {
+  #kt(t, i, e, s, r) {
     const n = i - t, a = e > 0 ? this.#c.top / e * n : 0, h = e > 0 ? this.#c.bottom / e * n : 0;
-    this.#V = {
+    this.#O = {
       min: s ? t : t - h,
       max: r ? i : i + a
     };
@@ -1300,18 +1549,18 @@ class Ot extends st {
    * as a gesture for visual easing. Public so consumers can drive pan
    * programmatically.
    */
-  pan(t, i = this.#z) {
-    i > 0 && (this.#z = i), this.#L = !1;
-    const e = U({
+  pan(t, i = this.#N) {
+    i > 0 && (this.#N = i), this.#L = !1;
+    const e = J({
       currentLogical: this.#o,
       timeDelta: t,
       chartWidth: i,
-      dataInterval: this.#a,
+      dataInterval: this.#r,
       padding: { left: this.#c.left, right: this.#c.right },
-      dataStart: this.#k,
-      dataEnd: this.#s
+      dataStart: this.#A,
+      dataEnd: this.#i
     });
-    e.newLogical !== null && (this.#y = !e.autoScrollOff, this.#T(e.newLogical, { emitChange: !0 }), e.edgeReached !== null && (this.#J[e.edgeReached.side] = e.edgeReached.boundaryTime, this.#K?.(e.edgeReached)), this.#D.pause(), this.#ot());
+    e.newLogical !== null && (this.#u = !e.autoScrollOff, this.#C(e.newLogical, { emitChange: !0 }), e.edgeReached !== null && (this.#ht[e.edgeReached.side] = e.edgeReached.boundaryTime, this.#ot?.(e.edgeReached)), this.#R.pause(), this.#wt());
   }
   /**
    * Zoom around a time anchor. `factor < 1` zooms in, `> 1` zooms out.
@@ -1328,37 +1577,37 @@ class Ot extends st {
    * 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.#z) {
-    e > 0 && (this.#z = e), this.#L = !1;
-    const s = Z({
+  zoomAt(t, i, e = this.#N) {
+    e > 0 && (this.#N = e), this.#L = !1;
+    const s = Q({
       currentLogical: this.#o,
       centerTime: t,
       factor: i,
       chartWidth: e,
-      dataInterval: this.#a,
+      dataInterval: this.#r,
       padding: { left: this.#c.left, right: this.#c.right },
-      dataStart: this.#k,
-      dataEnd: this.#s
+      dataStart: this.#A,
+      dataEnd: this.#i
     });
     if (s.newLogical === null) return;
     let r = s.newLogical;
-    if (this.#y && this.#s !== null) {
-      const n = r.to - r.from, a = C(this.#c.right, n, this.#a, e), h = this.#s + a;
-      r = { from: h - n, to: h }, this.#P = this.#s;
+    if (this.#u && this.#i !== null) {
+      const n = r.to - r.from, a = H(this.#c.right, n, this.#r, e), h = this.#i + a;
+      r = { from: h - n, to: h }, this.#F = this.#i;
     }
-    this.#T(r, { emitChange: !0 }), this.#D.pause(), this.#ot();
+    this.#C(r, { emitChange: !0 }), this.#R.pause(), this.#wt();
   }
   /**
    * 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`.
    */
-  #ot() {
+  #wt() {
     const t = this.#o;
     if (t.to <= t.from) return;
-    this.#M = !0, this.#u = !0;
+    this.#H = !0, this.#f = !0;
     const i = performance.now();
-    this.#e.onPanZoom({ xTarget: t, yAuto: !0 }, i), this.#p(i);
+    this.#s.onPanZoom({ xTarget: t, yAuto: !0 }, i), this.#v(i);
   }
   /**
    * Tick the engine at the given wall clock and push the resolved X / Y
@@ -1373,11 +1622,11 @@ class Ot extends st {
    * `effectiveNow === startWall` and the prune step keeps zero-duration
    * events long enough for the slot processor to snap them.
    */
-  #p(t) {
-    const i = this.#e.tick(t), e = this.#n.size;
+  #v(t) {
+    const i = this.#s.tick(t), e = this.#a.size;
     if (e.media.width === 0 || e.media.height === 0) return;
-    const s = this.#h.min !== void 0 && this.#h.min !== "auto", r = this.#h.max !== void 0 && this.#h.max !== "auto", n = e.media.height - this.xAxisHeight;
-    this.#ht(i.yRange.min, i.yRange.max, n, s, r), this.#U = i.yRange.min, this.#Z = i.yRange.max, this.syncScales();
+    const s = this.#l.min !== void 0 && this.#l.min !== "auto", r = this.#l.max !== void 0 && this.#l.max !== "auto", n = e.media.height - this.xAxisHeight;
+    this.#kt(i.yRange.min, i.yRange.max, n, s, r), this.#Q = i.yRange.min, this.#tt = i.yRange.max, this.syncScales();
   }
   /**
    * Lightweight scale sync: updates timeScale/yScale from current viewport state
@@ -1385,80 +1634,247 @@ class Ot extends st {
    * handler, so DOM axis components always read fresh coordinates on re-render.
    */
   syncScales() {
-    const t = this.#n.size;
+    const t = this.#a.size;
     if (t.media.width === 0 || t.media.height === 0) return;
     const i = t.media.width - this.yAxisWidth, e = t.media.height - this.xAxisHeight;
     this.timeScale.update(
-      this.#e.getAnimationState().xRange,
+      this.#s.getAnimationState().xRange,
       i,
       t.horizontalPixelRatio,
-      this.#a
-    ), this.yScale.update(this.#V, e, t.verticalPixelRatio);
+      this.#r
+    ), this.yScale.update(this.#O, e, t.verticalPixelRatio);
   }
   /** Expensive: background, grid, all series. Only on data/viewport/resize change. */
   renderMain(t) {
-    const i = this.#n.size;
+    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.#e.tick(e);
-    s.animating && this.#i.markDirty();
-    const r = s.yRange.min, n = s.yRange.max, a = r !== this.#U || n !== this.#Z;
+    const e = typeof t == "number" ? t : performance.now(), s = this.#s.tick(e);
+    s.animating && this.#e.markDirty();
+    const r = s.yRange.min, n = s.yRange.max, a = r !== this.#Q || n !== this.#tt;
     if (a) {
-      const d = this.#h.min !== void 0 && this.#h.min !== "auto", c = this.#h.max !== void 0 && this.#h.max !== "auto", f = i.media.height - this.xAxisHeight;
-      this.#ht(r, n, f, d, c), this.#U = r, this.#Z = n;
+      const c = this.#l.min !== void 0 && this.#l.min !== "auto", d = this.#l.max !== void 0 && this.#l.max !== "auto", p = i.media.height - this.xAxisHeight;
+      this.#kt(r, n, p, c, d), this.#Q = r, this.#tt = n;
     }
-    if (this.syncScales(), this.#yt(), this.#s !== null && !this.#y) {
-      const d = this.#e.lastXTarget ?? this.#o, c = d.to - d.from;
-      if (c > 0) {
-        const f = this.#n.size.media.width - this.yAxisWidth, p = C(this.#c.right, c, this.#a, f), v = this.#a * 0.5;
-        Math.abs(d.to - (this.#s + p)) < v && (this.#y = !0);
+    if (this.syncScales(), this.#Vt(), this.#i !== null && !this.#u) {
+      const c = this.#s.lastXTarget ?? this.#o, d = c.to - c.from;
+      if (d > 0) {
+        const p = this.#a.size.media.width - this.yAxisWidth, f = H(this.#c.right, d, this.#r, p), m = this.#r * 0.5;
+        Math.abs(c.to - (this.#i + f)) < m && (this.#u = !0);
       }
     }
     a && this.emit("viewportChange");
     let h = !1, l = !1;
-    this.#n.useMainLayer((d) => {
-      const { context: c, bitmapSize: f } = d, p = (i.media.width - this.yAxisWidth) * i.horizontalPixelRatio, v = (i.media.height - this.xAxisHeight) * i.verticalPixelRatio;
-      c.clearRect(0, 0, f.width, f.height), c.save(), c.beginPath(), c.rect(0, 0, p, v), c.clip(), this.yScale.tickTracker.setCurrentTicks(this.yScale.niceTickValues()), this.timeScale.tickTracker.setCurrentTicks(this.timeScale.niceTickValues(this.#a).ticks), this.yScale.tickTracker.tick(e), this.timeScale.tickTracker.tick(e);
-      const b = this.yScale.tickTracker.snapshot(), x = this.timeScale.tickTracker.snapshot();
-      h = b.isAnimating, l = x.isAnimating, (b.isAnimating || x.isAnimating || s.animating) && this.emit("tickFrame"), this.#E && K({
-        scope: d,
+    this.#a.useMainLayer((c) => {
+      const { context: d, bitmapSize: p } = c, f = (i.media.width - this.yAxisWidth) * i.horizontalPixelRatio, m = (i.media.height - this.xAxisHeight) * i.verticalPixelRatio;
+      d.clearRect(0, 0, p.width, p.height), d.save(), d.beginPath();
+      const y = this.#it(c, f);
+      d.rect(0, 0, f + y.intrusion, m), d.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 w = this.yScale.tickTracker.snapshot(), S = this.timeScale.tickTracker.snapshot();
+      h = w.isAnimating, l = S.isAnimating, (w.isAnimating || S.isAnimating || s.animating) && this.emit("tickFrame"), this.#V && rt({
+        scope: c,
         timeScale: this.timeScale,
         yScale: this.yScale,
-        theme: this.#r,
-        yTicks: b,
-        timeTicks: x
-      }), this.#ut(d, p, v);
-      const k = this.#c, P = { top: k.top, bottom: k.bottom }, w = this.#S;
-      for (const y of this.#t) {
-        const S = y.renderer.getAlpha?.() ?? (y.visible ? 1 : 0);
-        if (S <= 0) continue;
-        const L = {
-          scope: d,
+        theme: this.#n,
+        yTicks: w,
+        timeTicks: S
+      }), this.#It(c, f, m);
+      const M = this.#c, B = { top: M.top, bottom: M.bottom }, L = this.#S;
+      for (const b of this.#t) {
+        const k = b.renderer.getAlpha?.() ?? (b.visible ? 1 : 0);
+        if (k <= 0) continue;
+        const T = {
+          scope: c,
           timeScale: this.timeScale,
           yScale: this.yScale,
-          theme: this.#r,
-          dataInterval: this.#a,
-          padding: P,
+          theme: this.#n,
+          dataInterval: this.#r,
+          padding: B,
           state: s,
-          seriesId: y.id
-        }, A = c.globalAlpha;
-        if (S < 1 && (c.globalAlpha = A * S), w) {
-          const V = performance.now();
-          y.renderer.render(L), w.recordSeries(y.id, performance.now() - V, e);
+          seriesId: b.id
+        }, D = d.globalAlpha;
+        if (k < 1 && (d.globalAlpha = D * k), L) {
+          const F = performance.now();
+          b.renderer.render(T), L.recordSeries(b.id, performance.now() - F, e);
         } else
-          y.renderer.render(L);
-        S < 1 && (c.globalAlpha = A);
+          b.renderer.render(T);
+        k < 1 && (d.globalAlpha = D);
       }
-      c.restore();
-    });
+      d.restore(), this.#Ft({
+        scope: c,
+        paneBitmapWidth: f,
+        paneBitmapHeight: m,
+        timeTicks: S
+      }), this.#At(c, m), this.#Lt(c, f);
+    }), this.#K();
     let o = !1;
-    for (const d of this.#t)
-      if (d.renderer.needsAnimation) {
-        o = !0, this.#i.markDirty();
+    for (const c of this.#t)
+      if (c.renderer.needsAnimation) {
+        o = !0, this.#e.markDirty();
         break;
       }
     const u = h || l;
     !s.animating && !o && !u && (this.yScale.tickTracker.markArmed(), this.timeScale.tickTracker.markArmed());
   }
+  /**
+   * Erase the main layer's alpha across the top fade zone so content
+   * dissolves as it approaches the top edge. `destination-out` multiplies
+   * the already-painted pixels by the mask's inverse alpha — an *erase*, not
+   * a paint-over — so the container background behind the canvas (solid or
+   * CSS gradient) shows through untouched.
+   */
+  #At(t, i) {
+    if (this.#k.top <= 0) return;
+    const e = Math.min(Math.round(this.#k.top * t.verticalPixelRatio), Math.round(i));
+    if (e < 1) return;
+    const { context: s } = t;
+    s.save(), s.globalCompositeOperation = "destination-out", s.fillStyle = this.#Nt(s, e), s.fillRect(0, 0, t.bitmapSize.width, e), s.restore();
+  }
+  /**
+   * Run the vertical gridlines a short stub past the pane floor, dissolving
+   * to transparent on the way to the time-axis labels — the bottom-edge
+   * mirror of the horizontal gridlines melting under the Y-axis column.
+   * Drawn outside the pane clip (the stubs live below the pane, where
+   * nothing else paints) and faded with the same destination-out ramp the
+   * edge masks use, so the taper stays correct over any background.
+   */
+  #Ft(t) {
+    if (!this.#V || this.xAxisHeight === 0) return;
+    const { scope: i, paneBitmapWidth: e, paneBitmapHeight: s, timeTicks: r } = t, { context: n, horizontalPixelRatio: a, verticalPixelRatio: h } = i, l = Math.round(s), o = Math.round(A * h);
+    if (o < 1) return;
+    const u = this.#n.grid;
+    n.save(), n.strokeStyle = u.color, u.style === "dashed" ? n.setLineDash([4 * a, 4 * a]) : u.style === "dotted" && n.setLineDash([1 * a, 3 * a]), n.lineDashOffset = l;
+    const c = Math.max(1, Math.round(a)), d = c % 2 === 1 ? 0.5 : 0;
+    n.lineWidth = c;
+    const p = Math.round(e);
+    for (const { value: f, opacity: m } of r.entries) {
+      if (m <= 0.01) continue;
+      const y = Math.round(this.timeScale.timeToBitmapX(f)) + d;
+      y < 0 || y > p || (n.globalAlpha = m, n.beginPath(), n.moveTo(y, l), n.lineTo(y, l + o), n.stroke());
+    }
+    n.restore(), this.#Mt(i, s);
+  }
+  /**
+   * Erase ramp over the below-pane overrun strip — the gridline tail stubs
+   * on the main layer, the crosshair's overrun on the overlay. Nothing
+   * 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.
+   */
+  #Mt(t, i) {
+    if (this.xAxisHeight === 0) return;
+    const e = Math.round(i), s = Math.round(A * t.verticalPixelRatio);
+    if (s < 1) return;
+    const { context: r } = t;
+    r.save(), r.globalCompositeOperation = "destination-out", r.fillStyle = this.#Yt({ context: r, start: e, height: s }), r.fillRect(0, e, t.bitmapSize.width, s), r.restore();
+  }
+  /**
+   * Crosshair hairlines with the same edge melt the main layer runs: the
+   * pane clip widens by the right-fade intrusion and by a gridline-tail's
+   * overrun below the floor, then the shared erase ramps dissolve the
+   * overhangs — the vertical line tapers toward the time-axis labels in
+   * step with the gridline stubs and the horizontal line rides under the
+   * Y-axis column toward its label instead of stopping dead at the pane
+   * edge. Erases alpha (destination-out), so it must run while the
+   * crosshair is the only content on the layer.
+   */
+  #Ot(t) {
+    const i = this.#d;
+    if (i === null) return;
+    const { scope: e, chartBitmapWidth: s, chartBitmapHeight: r } = t, { context: n } = e, a = this.#it(e, s), h = this.xAxisHeight > 0 ? Math.round(A * e.verticalPixelRatio) : 0;
+    n.save(), n.beginPath(), n.rect(0, 0, s + a.intrusion, r + h), n.clip(), st({
+      scope: e,
+      bitmapX: i.mediaX * e.horizontalPixelRatio,
+      bitmapY: i.mediaY * e.verticalPixelRatio,
+      theme: this.#n,
+      pane: { width: s, height: r }
+    }), n.restore(), this.#Mt(e, r), this.#At(e, r), this.#Lt(e, s);
+  }
+  /**
+   * Horizontal companions to {@link #applyTopFade}: dissolve content that
+   * rides under the Y-axis column on the right (the pane clip is widened by
+   * the same zone) and, when configured, content leaving through the left
+   * pane edge. Same destination-out erase — background-safe over gradients.
+   * 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 { context: e } = t, s = t.bitmapSize.height, r = this.#it(t, i);
+    r.width >= 1 && (e.save(), e.globalCompositeOperation = "destination-out", e.fillStyle = this.#Et({ context: e, start: r.start, width: r.width }), e.fillRect(r.start, 0, r.width, s), e.restore());
+    const n = Math.min(Math.round(this.#k.left * t.horizontalPixelRatio), Math.round(i));
+    n >= 1 && (e.save(), e.globalCompositeOperation = "destination-out", e.fillStyle = this.#Xt(e, n), e.fillRect(0, 0, n, s), e.restore());
+  }
+  /**
+   * Bitmap geometry of the right fade zone. The ramp finishes just inside
+   * the Y-axis column — {@link RIGHT_FADE_END_GAP_PX} past the pane edge,
+   * still short of where the right-anchored label glyphs start — so content
+   * is fully erased before it can cross any axis text. Everything wider
+   * spills backward into the pane as the soft lead-in. `width: 0` (axis
+   * hidden, or `right: 0`) means no zone; `intrusion` is what the pane clip
+   * extends by (content past the ramp is total-erased anyway, so the clip
+   * stops with the ramp).
+   */
+  #it(t, i) {
+    const e = { start: 0, width: 0, intrusion: 0 }, s = Math.max(0, Math.round(t.bitmapSize.width - i));
+    if (s === 0) return e;
+    const r = t.horizontalPixelRatio, n = Math.min(Math.round(xt * r), s), a = this.#k.right === null ? n + Math.round(bt * r) : Math.round(this.#k.right * r);
+    if (a < 1) return e;
+    const h = i + n, l = Math.min(a, h);
+    return { start: h - l, width: l, intrusion: n };
+  }
+  /** Memoized mask gradient — rebuilt only when the bitmap zone height
+   *  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. */
+  #Nt(t, i) {
+    const e = this.#w.top;
+    if (e !== null && e.height === i) return e.gradient;
+    const s = t.createLinearGradient(0, 0, 0, i);
+    for (let r = 0; r <= 4; r++) {
+      const n = r / 4;
+      s.addColorStop(n, `rgba(0, 0, 0, ${1 - n * n})`);
+    }
+    return this.#w.top = { height: i, gradient: s }, s;
+  }
+  /** Right-zone 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
+   *  curvature at the entry, so the in-pane lead-in barely dims the newest
+   *  candles at rest and the aggressive erasing all happens deep under the
+   *  axis column. Nine stops keep the piecewise interpolation smooth across
+   *  the zone. */
+  #Et(t) {
+    const i = this.#w.right;
+    if (i !== null && i.start === t.start && i.width === t.width) return i.gradient;
+    const e = t.context.createLinearGradient(t.start, 0, t.start + t.width, 0);
+    for (let s = 0; s <= 8; s++) {
+      const r = s / 8;
+      e.addColorStop(r, `rgba(0, 0, 0, ${r * r * r})`);
+    }
+    return this.#w.right = { start: t.start, width: t.width, gradient: e }, e;
+  }
+  /** 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. */
+  #Yt(t) {
+    const i = this.#w.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);
+    for (let s = 0; s <= 4; s++) {
+      const r = s / 4;
+      e.addColorStop(r, `rgba(0, 0, 0, ${r * r})`);
+    }
+    return this.#w.tail = { start: t.start, height: t.height, gradient: e }, e;
+  }
+  /** Left-zone mask — mirror of the top ramp: total erase at the canvas
+   *  edge, fully opaque at the zone's inner boundary. */
+  #Xt(t, i) {
+    const e = this.#w.left;
+    if (e !== null && e.width === i) return e.gradient;
+    const s = t.createLinearGradient(0, 0, i, 0);
+    for (let r = 0; r <= 4; r++) {
+      const n = r / 4;
+      s.addColorStop(n, `rgba(0, 0, 0, ${1 - n * n})`);
+    }
+    return this.#w.left = { width: i, gradient: s }, s;
+  }
   /**
    * Paint a full frame: the main layer, then the overlay synchronously on
    * top so both land in the same browser paint. The overlay scheduler's
@@ -1468,12 +1884,12 @@ class Ot extends st {
    * `markDirty` calls made *during* `renderOverlay` (pulse, edge spinner)
    * land after the consume and re-arm cleanly for the next frame.
    */
-  #G(t) {
-    this.#j("main", t, () => this.renderMain(t)), this.#l.consume(), this.#j("overlay", t, () => this.renderOverlay(t));
+  #et(t) {
+    this.#st("main", t, () => this.renderMain(t)), this.#h.consume(), this.#st("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. */
-  #j(t, i, e) {
+  #st(t, i, e) {
     const s = this.#S;
     if (!s) {
       e();
@@ -1485,66 +1901,77 @@ class Ot extends st {
   }
   /** Cheap overlay: crosshair, nearest-point dots, pulse animation, edge indicator. */
   renderOverlay(t) {
-    const i = this.#n.size;
+    const i = this.#a.size;
     if (i.media.width === 0 || i.media.height === 0) return;
     let e = !1;
-    for (const a of this.#t)
-      if (a.visible && a.renderer.overlayNeedsAnimation) {
+    for (const o of this.#t)
+      if (o.visible && o.renderer.overlayNeedsAnimation) {
         e = !0;
         break;
       }
-    this.#m.some((a) => a.pulse) && (e = !0);
-    const s = this.#x.left === "loading" || this.#x.right === "loading", r = this.#x.left !== "idle" || this.#x.right !== "idle", n = !!this.#d || e || r || this.#m.length > 0 || this.#g.length > 0;
-    if (!(!n && !this.#q)) {
-      if (this.#q = n, this.#n.useOverlayLayer((a) => {
-        if (!n) return;
-        const h = (i.media.width - this.yAxisWidth) * i.horizontalPixelRatio, l = (i.media.height - this.xAxisHeight) * i.verticalPixelRatio;
-        if (a.context.save(), a.context.beginPath(), a.context.rect(0, 0, h, l), a.context.clip(), this.#d && this.#gt()) {
-          const c = this.#d.mediaX * i.horizontalPixelRatio, f = this.#d.mediaY * i.verticalPixelRatio;
-          J(a, c, f, this.#r);
-        }
-        const o = this.#c, u = { top: o.top, bottom: o.bottom }, d = this.#e.getAnimationState();
-        for (const c of this.#t)
-          c.visible && c.renderer.drawOverlay?.({
-            scope: a,
+    this.#m.some((o) => o.pulse) && (e = !0);
+    const s = {
+      left: this.#I.left && this.#x.left === "loading" ? "idle" : this.#x.left,
+      right: this.#I.right && this.#x.right === "loading" ? "idle" : this.#x.right
+    }, r = {
+      left: this.#vt("left"),
+      right: this.#vt("right")
+    }, n = r.left !== null || r.right !== null, a = s.left === "loading" || s.right === "loading" || n, h = s.left !== "idle" || s.right !== "idle" || n, l = !!this.#d || e || h || this.#m.length > 0 || this.#y.length > 0;
+    if (!(!l && !this.#at)) {
+      if (this.#at = l, this.#a.useOverlayLayer((o) => {
+        if (!l) return;
+        const u = (i.media.width - this.yAxisWidth) * i.horizontalPixelRatio, c = (i.media.height - this.xAxisHeight) * i.verticalPixelRatio;
+        this.#d && this.#yt() && this.#Ot({ scope: o, chartBitmapWidth: u, chartBitmapHeight: c }), o.context.save(), o.context.beginPath(), o.context.rect(0, 0, u, c), o.context.clip();
+        const d = this.#c, p = { top: d.top, bottom: d.bottom }, f = this.#s.getAnimationState();
+        for (const m of this.#t)
+          m.visible && m.renderer.drawOverlay?.({
+            scope: o,
             timeScale: this.timeScale,
             yScale: this.yScale,
-            theme: this.#r,
-            dataInterval: this.#a,
-            padding: u,
+            theme: this.#n,
+            dataInterval: this.#r,
+            padding: p,
             crosshair: this.#d,
-            state: d,
-            seriesId: c.id
+            state: f,
+            seriesId: m.id
           });
-        this.#ft(a, h, l), this.#mt(a), r && E({
-          scope: a,
+        this.#Pt(o, u, c), this.#Ct(o, u, c), h && Z({
+          scope: o,
+          chartMediaWidth: i.media.width - this.yAxisWidth,
           chartMediaHeight: i.media.height - this.xAxisHeight,
           timeScale: this.timeScale,
-          theme: this.#r,
-          edgeStates: this.#x,
-          resolveBoundary: (c) => F(c, this.#J[c], this.getDataBounds())
-        }), a.context.restore();
+          theme: this.#n,
+          edgeStates: s,
+          edgeExitFades: r,
+          edgeIndicatorFns: this.#lt,
+          resolveBoundary: (m) => $(m, this.#ht[m], this.getDataBounds()),
+          resolveEdgeAnchor: (m, y) => this.#Ht(m, y),
+          resolveEdgeBarSpacing: () => this.#zt(),
+          reportPlaceholders: (m, y) => {
+            this.#Z[m] = { bars: y, at: performance.now() };
+          }
+        }), o.context.restore();
       }), e) {
-        const { from: a, to: h } = this.timeScale.getRange();
-        let l = !1;
-        for (const o of this.#t)
-          if (!(!o.visible || !o.renderer.overlayNeedsAnimation) && (o.renderer.hasOverlayContentInRange?.(a, h) ?? !0)) {
-            l = !0;
+        const { from: o, to: u } = this.timeScale.getRange();
+        let c = !1;
+        for (const d of this.#t)
+          if (!(!d.visible || !d.renderer.overlayNeedsAnimation) && (d.renderer.hasOverlayContentInRange?.(o, u) ?? !0)) {
+            c = !0;
             break;
           }
-        if (!l) {
-          for (const o of this.#m)
-            if (o.pulse && o.time >= a && o.time <= h) {
-              l = !0;
+        if (!c) {
+          for (const d of this.#m)
+            if (d.pulse && d.time >= o && d.time <= u) {
+              c = !0;
               break;
             }
         }
-        l && this.#l.markDirty();
+        c && this.#h.markDirty();
       }
-      s && this.#l.markDirty();
+      a && this.#h.markDirty();
     }
   }
 }
 export {
-  Ot as ChartInstance
+  ti as ChartInstance
 };