@wick-charts/vue 0.5.1 → 0.6.0

package/dist/core/dist/chart.js

@@ -1,62 +1,76 @@
-import { AnimationConfig as z, DEFAULT_LINE_PULSE as N } from "./animation/config.js";
-import { createViewportEngine as H } from "./animation/viewport-engine.js";
+import { AnimationConfig as F, DEFAULT_LINE_PULSE as E } from "./animation/config.js";
+import { easeOutCubic as L } from "./animation/easing.js";
+import { createViewportEngine as N } 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 { resolveEdgeAnchorValue as O, drawEdgeIndicators as Y, resolveEdgeBoundary as B } from "./chart/edge-indicators.js";
+import { computeFitToData as X } from "./chart/fit-to-data.js";
+import { getLastValue as Z, getPreviousClose as _, getStackedLastValue as U } from "./chart/last-value.js";
+import { resolveMaxVisibleBars as $, resolvePadding as C, resolvePerfOptions as G, isSameHorizontalPadding as R } from "./chart/options.js";
+import { computePan as q, computeZoom as K } from "./chart/pan-zoom-math.js";
+import { StreamingCadence as j } from "./chart/streaming-cadence.js";
+import { computeStreamingTarget as J } from "./chart/streaming-target.js";
+import { resolvePaddingTime as M } from "./chart/viewport-padding.js";
+import { computeTargetYRange as Q, resolveBound as I } from "./chart/y-target.js";
+import { renderCrosshair as tt } from "./components/crosshair.js";
+import { renderGrid as it } from "./components/grid.js";
+import { renderMarker as et } from "./components/marker.js";
+import { renderReferenceLine as st } from "./components/reference-line.js";
+import { resolveTimeRegionColors as rt, renderTimeRegion as nt } from "./components/time-region.js";
+import { EventEmitter as at } from "./events.js";
+import { InteractionHandler as ht } from "./interactions/handler.js";
+import { RenderScheduler as P } from "./render-scheduler.js";
+import { XScale as ot } from "./scales/x-scale.js";
+import { YScale as lt } from "./scales/y-scale.js";
+import { resolveSeriesDefinition as ct } from "./series/definition.js";
+import { isTimeSeriesRenderer as S } from "./series/types.js";
+import { catppuccin as dt } from "./theme/themes/catppuccin.js";
+import { clamp as mt } from "./utils/math.js";
+import { normalizeTime as y, detectInterval as ut } from "./utils/time.js";
+const ft = 200, gt = 1500;
+let pt = 0, yt = 0, vt = 0, bt = 0;
+function H(f, t) {
+  return f === t ? !0 : !f || !t || f.length !== t.length ? !1 : f.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 St(f, t) {
+  return f === t ? !0 : !f || !t || f.length !== t.length ? !1 : f.every((i, e) => i === t[e]);
 }
-class Ot extends st {
+class qt extends at {
   /** 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;
+  #C;
   /** 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.
+   */
+  #tt = !1;
+  #it = !1;
   /** Active visual theme (colors, fonts, grid style). */
-  #r;
+  #n;
   /** Whether to render the background grid. */
-  #E;
+  #O;
   /** 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 +80,45 @@ class Ot extends st {
    * `time`/`y`; `'time'` (programmatic {@link setCrosshair}) keeps
    * `time`/`y` and re-projects the pixel position.
    */
-  #F = "pointer";
+  #Y = "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;
+  #et = !1;
   /** User-specified Y-axis bounds (auto, fixed, percentage). */
-  #h = {};
+  #l = {};
   /** Cached series ID list — invalidated on add/remove. */
-  #A = null;
+  #T = null;
   /** Axis visibility and sizing configuration. */
-  #I = {};
+  #H = {};
   /** Host-declared state per edge — drives the edge-indicator overlay. */
-  #x = { left: "idle", right: "idle" };
+  #S = { 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. */
+  #V = { left: null, right: null };
   /** Cached boundary timestamps from the last `edgeReached` emission, by side. */
-  #J = { left: null, right: null };
+  #st = { left: null, right: null };
+  /** Latest placeholder shapes a `loading` indicator reported per side —
+   *  the morph hand-off candidate consumed by {@link prependData}. */
+  #B = { 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. */
+  #R = { left: !1, right: !1 };
   /** Host-supplied callback fired when the user releases a pan/zoom past a data edge. */
-  #K;
+  #rt;
+  /** Per-side custom painter for the edge `loading` spinner. `null` falls back to the built-in dots. */
+  #nt = { left: null, right: null };
   /** Nesting depth for batch updates. Suppresses recomputes while > 0. */
-  #w = 0;
+  #A = 0;
   /** True when batched operations include data changes (triggers full onDataChanged on end). */
-  #O = !1;
+  #X = !1;
   /** True when batched operations include visibility changes (triggers Y-range + redraw on end). */
-  #C = !1;
+  #M = !1;
   /** True when batched operations bumped overlay version (emits a single overlayChange on flush). */
-  #Y = !1;
+  #Z = !1;
   /**
    * Monotonic counter bumped on any mutation that affects overlay output —
    * data, visibility, series options, theme. Used by snapshot helpers in
@@ -99,17 +128,17 @@ class Ot extends st {
    *
    * @internal
    */
-  #Q = 0;
+  #at = 0;
   get yAxisWidth() {
-    const t = this.#I.y;
+    const t = this.#H.y;
     return t?.visible === !1 ? 0 : t?.width ?? 55;
   }
   get xAxisHeight() {
-    const t = this.#I.x;
+    const t = this.#H.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,7 +147,7 @@ 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
@@ -134,31 +163,31 @@ class Ot extends st {
    * field carries the decision across that gap. The closure also reads
    * `#dataStart` / `#dataEnd` directly for the timestamps.
    */
-  #tt = !1;
+  #ht = !1;
   /** Earliest data timestamp registered across all series, `null` before any data has arrived. */
   #k = 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;
+  #z = null;
   /**
    * Warm-up window flag — `setVisibleRange({ from, bars })` arms it and
    * the streaming-target math suppresses pan ticks while the data hasn't
    * reached the right edge yet. Cleared by user interaction or once the
    * data fills the window.
    */
-  #L = !1;
+  #w = !1;
   /**
    * Cap for fit-to-data. When the data span exceeds this, the fit anchors
    * the right edge and trims the left. Resolved once at construction from
    * `options.viewport.maxVisibleBars`.
    */
-  #it;
+  #ot;
   /**
    * Committed logical X range — the "where X should be" target. Engine
    * eases its visual toward this. Pan / zoom / setRange / fitContent /
@@ -167,29 +196,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 };
+  #F = { 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;
+  #E = 0;
   /** Active performance monitor, or `null` when instrumentation is disabled (the default). */
-  #S;
+  #x;
   /** When true, `destroy()` tears down the monitor; false for caller-supplied monitors we must not destroy. */
-  #B = !1;
+  #_ = !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.#H = i.axis, this.#l = { min: i.axis.y?.min, max: i.axis.y?.max }), this.#n = i?.theme ?? dt.theme, this.#O = i?.grid?.visible !== !1, this.#g = F.resolve(i?.animations), this.#ot = $(i?.viewport?.maxVisibleBars), this.#c = C(i?.padding), this.#D = new j();
+    const e = this.#g.axis.y, s = this.#g.axis.x;
+    this.#s = N({
       initial: { yRange: { min: 0, max: 0 }, xRange: { from: 0, to: 0 } },
       y: {
         curve: e.curve,
@@ -197,28 +226,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));
-    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);
+      computeXTarget: () => this.#Rt(),
+      computeYTarget: ({ xTarget: a }) => this.#gt(a),
+      onWake: () => this.#e?.markDirty()
+    }), this.#rt = i?.onEdgeReached, this.#N = i?.viewport?.initialRange;
+    const r = G(i?.perf);
+    this.#x = r.monitor, this.#_ = r.ownsMonitor, this.#a = new W(t, this.#x ?? void 0), this.timeScale = new ot(), this.yScale = new lt(), 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 P((a) => this.#J(a)), this.#h = new P(
+      (a) => this.#Q("overlay", a, () => this.renderOverlay(a))
+    ), this.#x && r.hud && (this.#U = r.hud(t, this.#x));
+    const h = i?.interactive !== !1;
+    this.#C = h ? new ht(this.#a.canvas, this, this.timeScale, this.yScale) : null, this.#a.on("resize", () => {
+      this.syncScales(), this.#J(), this.emit("viewportChange");
+    }), this.syncScales(), this.#C?.on("crosshairMove", (a) => {
+      this.#Y = "pointer", this.#d = a, this.#h.markDirty(), this.emit("crosshairMove", a), this.#G(a);
+    }), this.#C?.on("click", (a) => {
+      this.emit("pointClick", { ...a, spatialHit: this.#ft(a) });
+    }), this.#C?.on("dblclick", (a) => {
+      this.fitContent(), this.emit("pointDoubleClick", { ...a, spatialHit: this.#ft(a) });
     });
   }
   /**
@@ -233,9 +266,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.#at++, this.#A > 0) {
+      this.#Z = !0;
       return;
     }
     this.emit("overlayChange");
@@ -249,39 +282,39 @@ class Ot extends st {
    * @internal
    */
   getOverlayVersion() {
-    return this.#Q;
+    return this.#at;
   }
   /**
    * 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) {
+  #bt(t) {
     if (t && !this.#t.some((e) => e.id === t))
       return t;
     let i;
     do
-      i = `series_${++ct}`;
+      i = `series_${++pt}`;
     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" ? ct(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),
-      ...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;
+    const { layers: s, id: r, label: n, labels: h, ...a } = i, l = s ?? 1, o = {
+      ...this.#g.defaults(e.type),
+      ...a,
+      ...this.#g.overrides(e.type)
+    }, u = e.create({ theme: this.#n, layerCount: l }, o), d = h ?? (typeof n == "string" ? [n] : void 0), c = this.#bt(r);
+    return u.onDataChanged?.(() => this.onDataChanged()), this.#t.push({ id: c, labels: d, renderer: u, visible: !0 }), this.#T = null, this.emit("seriesChange"), this.#p(), c;
   }
   /** 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.#T = null, this.#e.markDirty(), this.emit("seriesChange"), this.#p());
   }
   // --- Markers (point annotations) -----------------------------------------
   /**
@@ -294,27 +327,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_${++yt}`;
+    return this.#m.push(this.#lt(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.#lt(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) {
+  #lt(t, i) {
     return {
       id: t,
-      time: g(i.time),
+      time: y(i.time),
       value: i.value,
       seriesId: i.seriesId,
       shape: i.shape ?? "dot",
@@ -324,41 +357,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) {
+  #St(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) {
+  #xt(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) {
+  #kt(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() / (E * 2 * Math.PI) % 1, r = this.#$();
+    for (const n of this.#m) {
+      const h = this.#St(n);
+      if (h === null) continue;
+      const a = this.#mt(r, n.time);
+      if (a <= 0) continue;
+      const l = t.context.globalAlpha;
+      a < 1 && (t.context.globalAlpha = l * a), et({
         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: h,
+          color: this.#xt(n),
+          shape: n.shape,
+          pulse: n.pulse,
+          label: n.label
         },
-        phase: i
-      });
+        phase: s,
+        plotWidth: i,
+        plotHeight: e
+      }), a < 1 && (t.context.globalAlpha = l);
     }
   }
   // --- Time regions (shaded bands) -----------------------------------------
@@ -374,42 +413,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_${++vt}`;
+    return this.#b.push(this.#ct(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.#ct(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);
+  #ct(t, i) {
+    const { to: e } = i, s = e === void 0 || e === "now" ? null : y(e);
     return {
       id: t,
-      from: g(i.from),
+      from: y(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({
+  #At(t, i, e) {
+    if (this.#b.length !== 0)
+      for (const s of this.#b) {
+        const { color: r, fill: n } = rt(s, this.#n);
+        nt({
           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 +467,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_${++bt}`;
+    return this.#y.push(this.#dt(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.#dt(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) {
+  #dt(t, i) {
     const { time: e, value: s } = i, r = {
       id: t,
       color: i.color,
@@ -453,27 +492,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: y(e) } : { ...r, orientation: "horizontal", coord: s ?? Number.NaN };
+  }
+  #wt(t, i, e) {
+    if (this.#y.length === 0) return;
+    const s = this.#$();
+    for (const r of this.#y) {
+      const n = s >= 1 ? 1 : r.orientation === "vertical" ? this.#mt(s, r.coord) : L(s);
+      if (n <= 0) continue;
+      const h = t.context.globalAlpha;
+      n < 1 && (t.context.globalAlpha = h * n), st({
+        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 = h);
+    }
   }
   /**
    * Read-only snapshot of the chart's X / Y viewport animation. The same
@@ -482,7 +526,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.
+   */
+  #$() {
+    if (this.#it) return 1;
+    const t = this.getIntroFront();
+    return t < 1 ? (this.#tt = !0, t) : (this.#tt && (this.#it = !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.
+   */
+  #mt(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 mt((t - n) / 0.12, 0, 1);
   }
   /**
    * Replace all data for a series.
@@ -495,13 +581,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.#q = !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.#B.left;
+    r !== null && s.renderer.setHistoryHandoff !== void 0 && performance.now() - r.at < gt && (s.renderer.setHistoryHandoff(r.bars), this.#R.left = !0, this.#V.left = null, this.#B.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 +631,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 h = e.renderer.getLayerColors(), a = r.length !== h.length || r.some((o, u) => o !== h[u]), l = !H(s, e.labels);
+    (a || 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.#A++;
     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.#A <= 0) {
+        if (this.#A = 0, this.#X)
+          this.#X = !1, this.#M = !1, this.onDataChanged();
+        else if (this.#M) {
+          this.#M = !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.#Z && (this.#Z = !1, this.emit("overlayChange"));
       }
     }
   }
@@ -562,15 +667,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();
+    const s = this.#g.toggleMs;
+    if (e.renderer.setAlpha?.(i ? 1 : 0, s), this.#e.markDirty(), this.#A > 0) {
+      this.#M = !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 +685,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;
@@ -596,17 +701,17 @@ class Ot extends st {
    * layer's geometry on screen until the engine's Y ease settles.
    */
   setLayerVisible(t, i, e) {
-    const s = this.#t.find((a) => a.id === t);
+    const s = this.#t.find((h) => h.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.#A > 0) {
+      this.#M = !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 +720,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.#P(t, i, e), this.#W({ 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 +732,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.#k === null || this.#i === null ? null : { from: this.#k, to: this.#i };
   }
   /**
    * Imperatively set the visible time range. Three forms:
@@ -656,29 +761,29 @@ class Ot extends st {
   setVisibleRange(t, i) {
     if (typeof t == "number") {
       if (!Number.isInteger(t) || t < 2) return;
-      const { first: n, last: a } = this.getDataBounds();
-      if (n === void 0 || a === void 0) return;
-      const 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 { first: n, last: h } = this.getDataBounds();
+      if (n === void 0 || h === void 0) return;
+      const a = Math.max(n, h - (t - 1) * this.#r), l = this.#a.size.media.width - this.yAxisWidth;
+      this.#P(a, h, l), this.#W();
       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 = y(t.from), h = n + t.bars * this.#r;
+      this.#u = this.#i !== null && this.#i >= n && this.#i <= h, this.#L({ from: n, to: h }, { emitChange: !0 }), this.#w = !0, this.#W();
       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 = y(t.from), s = y(t.to);
+    this.#u = this.#i !== null && this.#i >= e && this.#i <= s, this.#w = !1;
+    const r = this.#L({ from: e, to: s }, { emitChange: !0 });
     if (i?.gesture) {
-      r && this.#vt();
+      r && this.#Mt();
       return;
     }
-    this.#H();
+    this.#W();
   }
   getYRange() {
-    return this.#V;
+    return this.#F;
   }
   getCrosshairPosition() {
     return this.#d;
@@ -719,7 +824,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 +836,29 @@ class Ot extends st {
     else if (e !== null)
       s = e.y;
     else {
-      const a = this.#V;
-      s = (a.min + a.max) / 2;
+      const h = this.#F;
+      s = (h.min + h.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.#Y = "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 Z(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 _(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 || !S(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 +868,28 @@ 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.#T || (this.#T = this.#t.map((t) => t.id)), this.#T.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() {
+  #Tt() {
     for (const t of this.#t)
-      if (t.visible && t.renderer.kind !== "pie")
+      if (t.visible && S(t.renderer))
         return !0;
     return !1;
   }
   /**
-   * Filter `getSeriesIds()` by renderer type. `'pie'` returns pie series,
-   * `'time'` returns line/bar/candlestick.
+   * 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 +899,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;
+      if (!(t === "time" ? S(n.renderer) : n.renderer.kind === t)) continue;
       const h = n.renderer.getLayerCount();
       if (!(s && h > 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;
+            let a = !1;
+            for (let l = 0; l < h; l++)
+              if (n.renderer.isLayerVisible(l)) {
+                a = !0;
                 break;
               }
-            if (!l) continue;
+            if (!a) continue;
           }
         }
         r.push(n.id);
@@ -819,7 +926,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 U(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 +965,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 +983,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 || H(e.labels, i) || (e.labels = i, this.#p());
   }
   /**
    * Set the per-layer color overrides carried in `data` (sparse — `undefined`
@@ -872,7 +994,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 || St(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 +1007,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.#H = 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 +1053,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 +1073,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 +1085,25 @@ 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 = C(t);
+    const e = this.#c, s = !R(i.left, e.left) || !R(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 { first: n, last: h } = this.getDataBounds();
+      if (n !== void 0 && h !== void 0) {
+        const a = this.#a.size.media.width - this.yAxisWidth;
+        this.#P(n, h, a);
       }
     }
     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.#O = t.visible, this.#e.markDirty();
   }
   /**
    * Set the visual state for one side of the chart. Typically called in
@@ -979,11 +1115,61 @@ 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.#S[t] === i) return;
+    const e = this.#S[t] === "loading", s = this.#R[t];
+    this.#R[t] = !1, this.#V[t] = e && !s && (i === "idle" || i === "has-more") ? performance.now() : null, this.#S[t] = i, this.#h.markDirty();
   }
   /** Read the current host-declared state for a given edge. */
   getEdgeState(t) {
-    return this.#x[t];
+    return this.#S[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.
+   */
+  #ut(t) {
+    const i = this.#V[t];
+    if (i === null) return null;
+    const e = (performance.now() - i) / ft;
+    return e >= 1 ? (this.#V[t] = null, null) : 1 - L(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.#nt[t] = i, this.#S[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`.
+   */
+  #Dt(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(O(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.
+   */
+  #Lt() {
+    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
@@ -995,24 +1181,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 = {
+  #G(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 r = !1, n = null;
+    for (const h of this.#t) {
+      if (!h.renderer.hitTest || !h.renderer.setHoverIndex) continue;
       let a = -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;
+        a = h.renderer.hitTest(l, o, i.bitmap.width, i.bitmap.height, s);
       }
-      n.renderer.setHoverIndex(a) && (r = !0);
+      h.renderer.setHoverIndex(a) && (r = !0), a >= 0 && !n && (n = { seriesId: h.id, index: a, info: h.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.
+   */
+  #ft(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 h of this.#t) {
+      if (!h.renderer.hitTest) continue;
+      const a = h.renderer.hitTest(r, n, i.bitmap.width, i.bitmap.height, s);
+      if (a >= 0) return { seriesId: h.id, index: a };
     }
-    r && this.#i.markDirty();
+    return null;
   }
   /**
    * Re-derive the crosshair after the viewport moved beneath it. A streaming
@@ -1034,40 +1242,40 @@ class Ot extends st {
    * viewport didn't move, the re-derived values are bit-identical and the
    * method exits without emitting.
    */
-  #yt() {
+  #Ct() {
     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") {
+    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, h = 1e-6;
+    let a;
+    if (this.#Y === "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 };
+      a = { 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.#G(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 };
+      if (!Number.isFinite(l) || !Number.isFinite(o) || Math.abs(l - t.mediaX) <= h && Math.abs(o - t.mediaY) <= h) return;
+      a = { mediaX: l, mediaY: o, time: t.time, y: t.y };
     }
-    this.#d = h, this.#l.markDirty(), this.emit("crosshairMove", h), this.#_(h);
+    this.#d = a, this.#h.markDirty(), this.emit("crosshairMove", a), this.#G(a);
   }
   /** 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.#T = null, this.#e.destroy(), this.#h.destroy(), this.#C?.destroy(), this.#a.destroy(), this.#U?.destroy(), this.#U = null, this.#_ && this.#x?.destroy(), this.#x = null, this.#_ = !1, this.removeAllListeners();
   }
   /** The attached performance monitor, or `null` when instrumentation is disabled. */
   getPerfMonitor() {
-    return this.#S;
+    return this.#x;
   }
   /** Compute the earliest and latest timestamps across all series. */
   getDataBounds() {
     let t, i;
     for (const e of this.#t) {
-      if (!e.visible || e.renderer.kind === "pie") continue;
+      if (!e.visible || !S(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 +1284,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;
+  #q = !1;
   onDataChanged() {
-    if (this.#w > 0) {
-      this.#O = !0;
+    if (this.#A > 0) {
+      this.#X = !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.#k = t), i !== void 0 && (this.#z = this.#i, this.#i = i);
+    const e = this.#q;
+    this.#q = !1;
+    const s = !this.#f && t !== void 0;
+    e && (this.yScale.tickTracker.reset(), this.timeScale.tickTracker.reset()), this.#ht = 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.#D.seed(r), this.#s.onDataReplaced(r)) : this.#s.onPointAppended(r), this.#s.lastXTarget !== null && (this.#I = !0), t !== void 0 && (this.#f = !0), this.#v(r), this.syncScales(), s ? this.#J() : this.#e.markDirty(), this.emit("dataUpdate"), this.#p();
   }
   updateDataInterval() {
     for (const t of this.#t) {
-      if (t.renderer.kind === "pie") continue;
+      if (!S(t.renderer)) continue;
       const i = t.renderer.sampleTimes(20);
       if (i.length >= 2) {
-        this.#a = lt(i);
+        this.#r = ut(i);
         break;
       }
     }
@@ -1107,13 +1315,13 @@ 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;
+  #I = !1;
   /**
    * One-shot `setVisibleRange` argument applied on the first data arrival.
    * Captured at chart construction from {@link ChartOptions.viewport.initialRange};
@@ -1127,8 +1335,8 @@ class Ot extends st {
    *  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;
+  #K = Number.NaN;
+  #j = 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 +1345,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);
+  #gt(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 = Q(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 = I(this.#l.min, s.min, s.max, e ?? [], "min"), n = I(this.#l.max, s.max, s.min, e ?? [], "max");
     return { min: r, max: n };
   }
   /**
@@ -1162,24 +1370,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({
+  #Rt() {
+    if (this.#k === 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.#P(this.#k, this.#i, s), this.#N !== void 0 && (this.setVisibleRange(this.#N), this.#N = 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.#ht)
+      return this.#P(this.#k, this.#i, s), this.#o;
+    const r = J({
       currentLogical: this.#o,
-      lastTime: this.#s,
-      prevDataEnd: this.#P,
-      dataInterval: this.#a,
+      lastTime: this.#i,
+      prevDataEnd: this.#z,
+      dataInterval: this.#r,
       paddingRight: this.#c.right,
       chartWidth: s,
-      holdUntilFilled: this.#L
+      holdUntilFilled: this.#w
     });
-    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.#w = !1), r.reengageAutoScroll && (this.#u = !0), r.newLogical === null ? null : (this.#D.observe(performance.now()), this.#s.setXSettleMs(this.#D.pickSettleMs(this.#g.axis.x.settleMs)), this.#L(r.newLogical, { emitChange: !1, skipValidation: !0 }), this.#z = this.#i, r.newLogical);
   }
   /**
    * Fit the viewport's logical X range around a data span. Mirrors the
@@ -1187,16 +1400,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({
+  #P(t, i, e) {
+    const s = this.#c, r = X({
       firstTime: t,
       lastTime: i,
-      dataInterval: this.#a,
-      maxVisibleBars: this.#it,
+      dataInterval: this.#r,
+      maxVisibleBars: this.#ot,
       chartWidth: e,
       padding: { left: s.left, right: s.right }
     });
-    this.#L = !1, this.#y = !0, this.#T(r, { emitChange: !0 });
+    this.#w = !1, this.#u = !0, this.#L(r, { emitChange: !0 });
   }
   /**
    * Commit a programmatic zoom — `fitContent` or `setVisibleRange`. Reads
@@ -1212,15 +1425,15 @@ class Ot extends st {
    *   passes `xEase: true` so X eases instead — viewport and axis converge
    *   on the same frame.
    */
-  #H(t) {
+  #W(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.#I || !this.#f) {
+      this.#pt(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 +1447,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() {
+  #Mt() {
     const t = this.#o;
     if (t.to <= t.from) return;
     const i = performance.now();
-    if (!this.#M || !this.#u) {
-      this.#at(i);
+    if (!this.#I || !this.#f) {
+      this.#pt(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 +1464,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);
+  #pt(t) {
+    const i = this.#o, e = this.#gt(i);
+    this.#I = !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 +1486,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) {
+  #L(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,11 +1496,11 @@ 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) {
-    const n = i - t, a = e > 0 ? this.#c.top / e * n : 0, h = e > 0 ? this.#c.bottom / e * n : 0;
-    this.#V = {
-      min: s ? t : t - h,
-      max: r ? i : i + a
+  #yt(t, i, e, s, r) {
+    const n = i - t, h = e > 0 ? this.#c.top / e * n : 0, a = e > 0 ? this.#c.bottom / e * n : 0;
+    this.#F = {
+      min: s ? t : t - a,
+      max: r ? i : i + h
     };
   }
   /**
@@ -1300,18 +1513,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.#E) {
+    i > 0 && (this.#E = i), this.#w = !1;
+    const e = q({
       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
+      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.#L(e.newLogical, { emitChange: !0 }), e.edgeReached !== null && (this.#st[e.edgeReached.side] = e.edgeReached.boundaryTime, this.#rt?.(e.edgeReached)), this.#D.pause(), this.#vt());
   }
   /**
    * Zoom around a time anchor. `factor < 1` zooms in, `> 1` zooms out.
@@ -1328,37 +1541,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.#E) {
+    e > 0 && (this.#E = e), this.#w = !1;
+    const s = K({
       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
+      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, h = M(this.#c.right, n, this.#r, e), a = this.#i + h;
+      r = { from: a - n, to: a }, this.#z = this.#i;
     }
-    this.#T(r, { emitChange: !0 }), this.#D.pause(), this.#ot();
+    this.#L(r, { emitChange: !0 }), this.#D.pause(), this.#vt();
   }
   /**
    * 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() {
+  #vt() {
     const t = this.#o;
     if (t.to <= t.from) return;
-    this.#M = !0, this.#u = !0;
+    this.#I = !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 +1586,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.#yt(i.yRange.min, i.yRange.max, n, s, r), this.#K = i.yRange.min, this.#j = i.yRange.max, this.syncScales();
   }
   /**
    * Lightweight scale sync: updates timeScale/yScale from current viewport state
@@ -1385,78 +1598,78 @@ 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.#F, 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;
-    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 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, h = r !== this.#K || n !== this.#j;
+    if (h) {
+      const d = this.#l.min !== void 0 && this.#l.min !== "auto", c = this.#l.max !== void 0 && this.#l.max !== "auto", p = i.media.height - this.xAxisHeight;
+      this.#yt(r, n, p, d, c), this.#K = r, this.#j = n;
     }
-    if (this.syncScales(), this.#yt(), this.#s !== null && !this.#y) {
-      const d = this.#e.lastXTarget ?? this.#o, c = d.to - d.from;
+    if (this.syncScales(), this.#Ct(), this.#i !== null && !this.#u) {
+      const d = this.#s.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);
+        const p = this.#a.size.media.width - this.yAxisWidth, v = M(this.#c.right, c, this.#r, p), m = this.#r * 0.5;
+        Math.abs(d.to - (this.#i + v)) < 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({
+    h && this.emit("viewportChange");
+    let a = !1, l = !1;
+    this.#a.useMainLayer((d) => {
+      const { context: c, bitmapSize: p } = d, v = (i.media.width - this.yAxisWidth) * i.horizontalPixelRatio, m = (i.media.height - this.xAxisHeight) * i.verticalPixelRatio;
+      c.clearRect(0, 0, p.width, p.height), c.save(), c.beginPath(), c.rect(0, 0, v, m), c.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 g = this.yScale.tickTracker.snapshot(), k = this.timeScale.tickTracker.snapshot();
+      a = g.isAnimating, l = k.isAnimating, (g.isAnimating || k.isAnimating || s.animating) && this.emit("tickFrame"), this.#O && it({
         scope: d,
         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 = {
+        theme: this.#n,
+        yTicks: g,
+        timeTicks: k
+      }), this.#At(d, v, m);
+      const A = this.#c, V = { top: A.top, bottom: A.bottom }, w = this.#x;
+      for (const b of this.#t) {
+        const x = b.renderer.getAlpha?.() ?? (b.visible ? 1 : 0);
+        if (x <= 0) continue;
+        const T = {
           scope: d,
           timeScale: this.timeScale,
           yScale: this.yScale,
-          theme: this.#r,
-          dataInterval: this.#a,
-          padding: P,
+          theme: this.#n,
+          dataInterval: this.#r,
+          padding: V,
           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 = c.globalAlpha;
+        if (x < 1 && (c.globalAlpha = D * x), w) {
+          const z = performance.now();
+          b.renderer.render(T), w.recordSeries(b.id, performance.now() - z, e);
         } else
-          y.renderer.render(L);
-        S < 1 && (c.globalAlpha = A);
+          b.renderer.render(T);
+        x < 1 && (c.globalAlpha = D);
       }
       c.restore();
-    });
+    }), this.#$();
     let o = !1;
     for (const d of this.#t)
       if (d.renderer.needsAnimation) {
-        o = !0, this.#i.markDirty();
+        o = !0, this.#e.markDirty();
         break;
       }
-    const u = h || l;
+    const u = a || l;
     !s.animating && !o && !u && (this.yScale.tickTracker.markArmed(), this.timeScale.tickTracker.markArmed());
   }
   /**
@@ -1468,13 +1681,13 @@ 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));
+  #J(t) {
+    this.#Q("main", t, () => this.renderMain(t)), this.#h.consume(), this.#Q("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) {
-    const s = this.#S;
+  #Q(t, i, e) {
+    const s = this.#x;
     if (!s) {
       e();
       return;
@@ -1485,66 +1698,80 @@ 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);
+    this.#m.some((o) => o.pulse) && (e = !0);
+    const s = {
+      left: this.#R.left && this.#S.left === "loading" ? "idle" : this.#S.left,
+      right: this.#R.right && this.#S.right === "loading" ? "idle" : this.#S.right
+    }, r = {
+      left: this.#ut("left"),
+      right: this.#ut("right")
+    }, n = r.left !== null || r.right !== null, h = s.left === "loading" || s.right === "loading" || n, a = s.left !== "idle" || s.right !== "idle" || n, l = !!this.#d || e || a || this.#m.length > 0 || this.#y.length > 0;
+    if (!(!l && !this.#et)) {
+      if (this.#et = l, this.#a.useOverlayLayer((o) => {
+        if (!l) return;
+        const u = (i.media.width - this.yAxisWidth) * i.horizontalPixelRatio, d = (i.media.height - this.xAxisHeight) * i.verticalPixelRatio;
+        if (o.context.save(), o.context.beginPath(), o.context.rect(0, 0, u, d), o.context.clip(), this.#d && this.#Tt()) {
+          const m = this.#d.mediaX * i.horizontalPixelRatio, g = this.#d.mediaY * i.verticalPixelRatio;
+          tt(o, m, g, this.#n);
         }
-        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,
+        const c = this.#c, p = { top: c.top, bottom: c.bottom }, v = 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: v,
+            seriesId: m.id
           });
-        this.#ft(a, h, l), this.#mt(a), r && E({
-          scope: a,
+        this.#wt(o, u, d), this.#kt(o, u, d), a && Y({
+          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.#nt,
+          resolveBoundary: (m) => B(m, this.#st[m], this.getDataBounds()),
+          resolveEdgeAnchor: (m, g) => this.#Dt(m, g),
+          resolveEdgeBarSpacing: () => this.#Lt(),
+          reportPlaceholders: (m, g) => {
+            this.#B[m] = { bars: g, 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 d = !1;
+        for (const c of this.#t)
+          if (!(!c.visible || !c.renderer.overlayNeedsAnimation) && (c.renderer.hasOverlayContentInRange?.(o, u) ?? !0)) {
+            d = !0;
             break;
           }
-        if (!l) {
-          for (const o of this.#m)
-            if (o.pulse && o.time >= a && o.time <= h) {
-              l = !0;
+        if (!d) {
+          for (const c of this.#m)
+            if (c.pulse && c.time >= o && c.time <= u) {
+              d = !0;
               break;
             }
         }
-        l && this.#l.markDirty();
+        d && this.#h.markDirty();
       }
-      s && this.#l.markDirty();
+      h && this.#h.markDirty();
     }
   }
 }
 export {
-  Ot as ChartInstance
+  qt as ChartInstance
 };