@wick-charts/vue 0.5.0 → 0.6.0

package/dist/core/dist/chart.js

@@ -1,87 +1,124 @@
-import { AnimationConfig as z, DEFAULT_LINE_PULSE as H } from "./animation/config.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 $ } from "./chart/edge-indicators.js";
-import { computeFitToData as O } from "./chart/fit-to-data.js";
-import { getLastValue as B, getPreviousClose as F, getStackedLastValue as Y } from "./chart/last-value.js";
-import { resolveMaxVisibleBars as X, resolvePadding as D, resolvePerfOptions as _, isSameHorizontalPadding as C } 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 T } from "./chart/viewport-padding.js";
-import { computeTargetYRange as q, resolveBound as R } 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 M } from "./render-scheduler.js";
-import { XScale as nt } from "./scales/x-scale.js";
-import { YScale as ht } from "./scales/y-scale.js";
-import { resolveSeriesDefinition as at } 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 dt = 0, ct = 0, mt = 0, ut = 0;
-function I(m, i) {
-  return m === i ? !0 : !m || !i || m.length !== i.length ? !1 : m.every((t, e) => t === i[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, i) {
-  return m === i ? !0 : !m || !i || m.length !== i.length ? !1 : m.every((t, e) => t === i[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). */
-  #d;
+  #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. */
-  #c = [];
+  #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). */
-  #h = 6e4;
+  #r = 6e4;
   /** Current crosshair position, null when cursor is outside the chart. */
-  #m = null;
+  #d = null;
+  /**
+   * What the crosshair is anchored to, deciding which half of the position
+   * survives a viewport move (see {@link #syncCrosshairToViewport}):
+   * `'pointer'` (real hover) keeps `mediaX`/`mediaY` and re-resolves
+   * `time`/`y`; `'time'` (programmatic {@link setCrosshair}) keeps
+   * `time`/`y` and re-projects the pixel position.
+   */
+  #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. */
-  #G = !1;
+  #et = !1;
   /** User-specified Y-axis bounds (auto, fixed, percentage). */
-  #a = {};
+  #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. */
-  #b = { 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. */
-  #q;
+  #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). */
-  #$ = !1;
+  #X = !1;
   /** True when batched operations include visibility changes (triggers Y-range + redraw on end). */
-  #T = !1;
+  #M = !1;
   /** True when batched operations bumped overlay version (emits a single overlayChange on flush). */
-  #O = !1;
+  #Z = !1;
   /**
    * Monotonic counter bumped on any mutation that affects overlay output —
    * data, visibility, series options, theme. Used by snapshot helpers in
@@ -91,17 +128,17 @@ class Ot extends st {
    *
    * @internal
    */
-  #J = 0;
+  #at = 0;
   get yAxisWidth() {
-    const i = this.#I.y;
-    return i?.visible === !1 ? 0 : i?.width ?? 55;
+    const t = this.#H.y;
+    return t?.visible === !1 ? 0 : t?.width ?? 55;
   }
   get xAxisHeight() {
-    const i = this.#I.x;
-    return i?.visible === !1 ? 0 : i?.height ?? 30;
+    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`,
@@ -110,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
@@ -126,31 +163,31 @@ class Ot extends st {
    * field carries the decision across that gap. The closure also reads
    * `#dataStart` / `#dataEnd` directly for the timestamps.
    */
-  #K = !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`.
    */
-  #Q;
+  #ot;
   /**
    * Committed logical X range — the "where X should be" target. Engine
    * eases its visual toward this. Pan / zoom / setRange / fitContent /
@@ -159,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.
    */
-  #p = !0;
+  #u = !0;
   /** Resolved viewport padding (top/bottom px + left/right pixels-or-intervals). */
-  #l;
+  #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). */
   #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. */
-  #F = null;
-  constructor(i, t) {
-    super(), t?.axis && (this.#I = t.axis, this.#a = { min: t.axis.y?.min, max: t.axis.y?.max }), this.#r = t?.theme ?? ot.theme, this.#E = t?.grid?.visible !== !1, this.#f = z.resolve(t?.animations), this.#Q = X(t?.viewport?.maxVisibleBars), this.#l = D(t?.padding), this.#D = new G();
-    const e = this.#f.axis.y, s = this.#f.axis.x;
-    this.#e = N({
+  #U = null;
+  constructor(t, i) {
+    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,
@@ -189,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.#gt(),
-      computeYTarget: ({ xTarget: a }) => this.#st(a),
-      onWake: () => this.#i?.markDirty()
-    }), this.#q = t?.onEdgeReached, this.#H = t?.viewport?.initialRange;
-    const r = _(t?.perf);
-    this.#x = r.monitor, this.#B = r.ownsMonitor, this.#n = new W(i, this.#x ?? void 0), this.timeScale = new nt(), this.yScale = new ht();
-    const n = this.#f.axis.ticksMs;
-    this.timeScale.tickTracker.setFadeMs(n), this.yScale.tickTracker.setFadeMs(n), this.#i = new M((a) => this.#U(a)), this.#d = new M(
-      (a) => this.#Z("overlay", a, () => this.renderOverlay(a))
-    ), this.#x && r.hud && (this.#F = r.hud(i, this.#x));
-    const h = t?.interactive !== !1;
-    this.#W = h ? new rt(this.#n.canvas, this, this.timeScale, this.yScale) : null, this.#n.on("resize", () => {
-      this.syncScales(), this.#U(), this.emit("viewportChange");
-    }), this.syncScales(), this.#W?.on("crosshairMove", (a) => {
-      this.#m = a, this.#d.markDirty(), this.emit("crosshairMove", a), this.#ft(a);
+      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) });
     });
   }
   /**
@@ -225,9 +266,9 @@ class Ot extends st {
    * `setSeriesVisible` / `setLayerVisible` calls — produce one overlay
    * render instead of N.
    */
-  #S() {
-    if (this.#J++, this.#w > 0) {
-      this.#O = !0;
+  #p() {
+    if (this.#at++, this.#A > 0) {
+      this.#Z = !0;
       return;
     }
     this.emit("overlayChange");
@@ -241,39 +282,39 @@ class Ot extends st {
    * @internal
    */
   getOverlayVersion() {
-    return this.#J;
+    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.
    */
-  #at(i) {
-    if (i && !this.#t.some((e) => e.id === i))
-      return i;
-    let t;
+  #bt(t) {
+    if (t && !this.#t.some((e) => e.id === t))
+      return t;
+    let i;
     do
-      t = `series_${++dt}`;
-    while (this.#t.some((e) => e.id === t));
-    return t;
+      i = `series_${++pt}`;
+    while (this.#t.some((e) => e.id === i));
+    return i;
   }
-  addSeries(i, t = {}) {
-    const e = typeof i == "string" ? at(i) : i;
+  addSeries(t, i = {}) {
+    const e = typeof t == "string" ? ct(t) : t;
     if (!e)
       throw new Error(
-        `[wick-charts] Unknown series type '${String(i)}'. The string form of addSeries resolves through the series registry — call registerBuiltinSeries() once at startup, or pass the definition directly: chart.addSeries(LineSeriesDef, options).`
+        `[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: h, ...a } = t, d = s ?? 1, l = {
-      ...this.#f.defaults(e.type),
+    const { layers: s, id: r, label: n, labels: h, ...a } = i, l = s ?? 1, o = {
+      ...this.#g.defaults(e.type),
       ...a,
-      ...this.#f.overrides(e.type)
-    }, u = e.create({ theme: this.#r, layerCount: d }, l), c = h ?? (typeof n == "string" ? [n] : void 0), o = this.#at(r);
-    return u.onDataChanged?.(() => this.onDataChanged()), this.#t.push({ id: o, labels: c, renderer: u, visible: !0 }), this.#A = null, this.emit("seriesChange"), this.#S(), o;
+      ...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(i) {
-    const t = this.#t.findIndex((e) => e.id === i);
-    t >= 0 && (this.#t[t].renderer.dispose(), this.#t.splice(t, 1), this.#A = null, this.#i.markDirty(), this.emit("seriesChange"), this.#S());
+  removeSeries(t) {
+    const i = this.#t.findIndex((e) => e.id === t);
+    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) -----------------------------------------
   /**
@@ -285,72 +326,78 @@ class Ot extends st {
    * are excluded from tooltips, the legend, and the Y-range autoscale, and never
    * appear in series queries.
    */
-  addMarker(i) {
-    const t = `marker_${++ct}`;
-    return this.#c.push(this.#tt(t, i)), this.#d.markDirty(), t;
+  addMarker(t) {
+    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(i, t) {
-    const e = this.#c.findIndex((s) => s.id === i);
-    e !== -1 && (this.#c[e] = this.#tt(i, t), this.#d.markDirty());
+  updateMarker(t, i) {
+    const e = this.#m.findIndex((s) => s.id === t);
+    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(i) {
-    const t = this.#c.findIndex((e) => e.id === i);
-    t !== -1 && (this.#c.splice(t, 1), this.#d.markDirty());
+  removeMarker(t) {
+    const i = this.#m.findIndex((e) => e.id === t);
+    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.#c;
+    return this.#m;
   }
-  #tt(i, t) {
+  #lt(t, i) {
     return {
-      id: i,
-      time: g(t.time),
-      value: t.value,
-      seriesId: t.seriesId,
-      shape: t.shape ?? "dot",
-      pulse: t.pulse ?? !1,
-      label: t.label,
-      color: t.color
+      id: t,
+      time: y(i.time),
+      value: i.value,
+      seriesId: i.seriesId,
+      shape: i.shape ?? "dot",
+      pulse: i.pulse ?? !1,
+      label: i.label,
+      color: i.color
     };
   }
   /** Resolve a marker's Y value: explicit `value`, else snapped to its series at `time`. Null when neither resolves. */
-  #ot(i) {
-    if (i.value !== void 0 && Number.isFinite(i.value)) return i.value;
-    if (i.seriesId === void 0) return null;
-    const t = this.getDataAtTime(i.seriesId, i.time);
-    return t ? "close" in t ? t.close : t.value : null;
+  #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. */
-  #lt(i) {
-    if (i.color !== void 0) return i.color;
-    if (i.seriesId !== void 0) {
-      const t = this.getSeriesColor(i.seriesId);
-      if (t !== null) return 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;
-  }
-  #dt(i) {
-    if (this.#c.length === 0) return;
-    const t = performance.now() / (H * 2 * Math.PI) % 1;
-    for (const e of this.#c) {
-      const s = this.#ot(e);
-      s !== null && Q({
-        scope: i,
+    return this.#n.line.color;
+  }
+  #kt(t, i, e) {
+    if (this.#m.length === 0) return;
+    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.#lt(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: t
-      });
+        phase: s,
+        plotWidth: i,
+        plotHeight: e
+      }), a < 1 && (t.context.globalAlpha = l);
     }
   }
   // --- Time regions (shaded bands) -----------------------------------------
@@ -365,45 +412,45 @@ class Ot extends st {
    * series model — they never affect the Y-range autoscale, tooltips, or the
    * legend.
    */
-  addRegion(i) {
-    const t = `region_${++mt}`;
-    return this.#v.push(this.#it(t, i)), this.#i.markDirty(), t;
+  addRegion(t) {
+    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(i, t) {
-    const e = this.#v.findIndex((s) => s.id === i);
-    e !== -1 && (this.#v[e] = this.#it(i, t), this.#i.markDirty());
+  updateRegion(t, i) {
+    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(i) {
-    const t = this.#v.findIndex((e) => e.id === i);
-    t !== -1 && (this.#v.splice(t, 1), this.#i.markDirty());
+  removeRegion(t) {
+    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;
   }
-  #it(i, t) {
-    const { to: e } = t, 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: i,
-      from: g(t.from),
+      id: t,
+      from: y(i.from),
       to: s,
-      fill: t.fill,
-      color: t.color,
-      label: t.label
+      fill: i.fill,
+      color: i.color,
+      label: i.label
     };
   }
-  #ct(i, t, e) {
-    if (this.#v.length !== 0)
-      for (const s of this.#v) {
-        const { color: r, fill: n } = it(s, this.#r);
-        et({
-          scope: i,
+  #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: t,
+          plotWidth: i,
           plotHeight: e
         });
       }
@@ -419,53 +466,58 @@ class Ot extends st {
    * series model — they never affect the Y-range autoscale, tooltips, or the
    * legend.
    */
-  addLine(i) {
-    const t = `line_${++ut}`;
-    return this.#g.push(this.#et(t, i)), this.#d.markDirty(), t;
+  addLine(t) {
+    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(i, t) {
-    const e = this.#g.findIndex((s) => s.id === i);
-    e !== -1 && (this.#g[e] = this.#et(i, t), this.#d.markDirty());
+  updateLine(t, i) {
+    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(i) {
-    const t = this.#g.findIndex((e) => e.id === i);
-    t !== -1 && (this.#g.splice(t, 1), this.#d.markDirty());
+  removeLine(t) {
+    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;
-  }
-  #et(i, t) {
-    const { time: e, value: s } = t, r = {
-      id: i,
-      color: t.color,
-      label: t.label,
-      style: t.style ?? "dashed",
-      width: t.width ?? 1
+    return this.#y;
+  }
+  #dt(t, i) {
+    const { time: e, value: s } = i, r = {
+      id: t,
+      color: i.color,
+      label: i.label,
+      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 };
-  }
-  #mt(i, t, e) {
-    if (this.#g.length !== 0)
-      for (const s of this.#g)
-        tt({
-          scope: i,
-          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: t,
-          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
@@ -474,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.
@@ -485,18 +579,37 @@ class Ot extends st {
    * For line/bar accepts `TimePointInput[]` (time may be `Date`); for candlestick accepts `OHLCInput[]`;
    * for pie accepts `PieSliceData[]`. Time fields are normalized internally.
    */
-  setSeriesData(i, t, e) {
-    const s = this.#t.find((r) => r.id === i);
-    s && (this.#Y = !0, s.renderer.setData(t, e));
+  setSeriesData(t, i, e) {
+    const s = this.#t.find((r) => r.id === t);
+    s && (this.#q = !0, s.renderer.setData(i, e));
   }
   /** Append a new data point to the end of a series (real-time tick). */
-  appendData(i, t, e) {
-    const s = this.#t.find((r) => r.id === i);
-    s === void 0 || s.renderer.appendPoint === void 0 || s.renderer.appendPoint(t, e);
+  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(i, t, e) {
-    this.#t.find((s) => s.id === i)?.renderer.updateLastPoint?.(t, e);
+  updateData(t, i, e) {
+    this.#t.find((s) => s.id === t)?.renderer.updateLastPoint?.(i, e);
   }
   /**
    * Keep only the most recent `count` points of a series — drop the oldest
@@ -511,36 +624,36 @@ class Ot extends st {
    * chart.keepLast('feed', 100);
    * ```
    */
-  keepLast(i, t, e) {
-    this.#t.find((s) => s.id === i)?.renderer.keepLast?.(t, e);
+  keepLast(t, i, e) {
+    this.#t.find((s) => s.id === t)?.renderer.keepLast?.(i, e);
   }
   /** Update visual options (color, width, etc.) for an existing series. */
-  updateSeriesOptions(i, t) {
-    const e = this.#t.find((l) => l.id === i);
+  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({ ...t, ...n }), "label" in t && typeof t.label == "string" && (e.labels = [t.label]), this.#i.markDirty();
-    const h = e.renderer.getLayerColors(), a = r.length !== h.length || r.some((l, u) => l !== h[u]), d = !I(s, e.labels);
-    (a || d) && this.#S();
+    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(i) {
-    this.#w++;
+  batch(t) {
+    this.#A++;
     try {
-      i();
+      t();
     } finally {
-      if (--this.#w <= 0) {
-        if (this.#w = 0, this.#$)
-          this.#$ = !1, this.#T = !1, this.onDataChanged();
-        else if (this.#T) {
-          this.#T = !1, this.#u = !0;
-          const t = performance.now();
-          this.#e.onAxisReconfig(t), this.#y(t), this.#i.markDirty();
+      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.#s.onAxisReconfig(i), this.#v(i), this.#e.markDirty();
         }
-        this.#O && (this.#O = !1, this.emit("overlayChange"));
+        this.#Z && (this.#Z = !1, this.emit("overlayChange"));
       }
     }
   }
@@ -551,18 +664,18 @@ class Ot extends st {
    *  computation immediately so the axis can start moving while the line
    *  fades out in parallel.
    */
-  setSeriesVisible(i, t) {
-    const e = this.#t.find((n) => n.id === i);
-    if (!e || e.visible === t) return;
-    e.visible = t, this.#S();
-    const s = this.#f.toggleMs;
-    if (e.renderer.setAlpha?.(t ? 1 : 0, s), this.#i.markDirty(), this.#w > 0) {
-      this.#T = !0;
+  setSeriesVisible(t, i) {
+    const e = this.#t.find((n) => n.id === t);
+    if (!e || e.visible === i) return;
+    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.#y(r);
+    this.#s.onSeriesVisibilityChanged(r), this.#v(r);
   }
   /**
    * Whether streaming ticks slide the visible range to track the data tail.
@@ -572,10 +685,10 @@ class Ot extends st {
    * containing the tail.
    */
   getAutoScroll() {
-    return this.#p;
+    return this.#u;
   }
-  isSeriesVisible(i) {
-    return this.#t.find((t) => t.id === i)?.visible ?? !0;
+  isSeriesVisible(t) {
+    return this.#t.find((i) => i.id === t)?.visible ?? !0;
   }
   /**
    * Show or hide a specific layer within a multi-layer series.
@@ -587,31 +700,31 @@ class Ot extends st {
    * `getValueRange` reading `store.isVisible()`); the alpha fade keeps the
    * layer's geometry on screen until the engine's Y ease settles.
    */
-  setLayerVisible(i, t, e) {
-    const s = this.#t.find((h) => h.id === i);
-    if (!s || s.renderer.getLayerCount() <= 1 || s.renderer.isLayerVisible(t) === e) return;
-    s.renderer.setLayerVisible(t, e), this.#S();
-    const r = this.#f.toggleMs;
-    if (s.renderer.setLayerAlpha?.(t, e ? 1 : 0, r), this.#i.markDirty(), this.#w > 0) {
-      this.#T = !0;
+  setLayerVisible(t, i, e) {
+    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.#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.#y(n);
+    this.#s.onSeriesVisibilityChanged(n), this.#v(n);
   }
-  isLayerVisible(i, t) {
-    return this.#t.find((e) => e.id === i)?.renderer.isLayerVisible(t) ?? !0;
+  isLayerVisible(t, i) {
+    return this.#t.find((e) => e.id === t)?.renderer.isLayerVisible(i) ?? !0;
   }
   /** Auto-fit the viewport to show all data across every series. */
   fitContent() {
-    const { first: i, last: t } = this.getDataBounds();
-    if (i === void 0 || t === void 0) return;
-    const e = this.#n.size.media.width - this.yAxisWidth;
-    this.#M(i, t, e), this.#N({ xEase: !0 });
+    const { first: t, last: i } = this.getDataBounds();
+    if (t === void 0 || i === void 0) return;
+    const e = this.#a.size.media.width - this.yAxisWidth;
+    this.#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
@@ -619,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:
@@ -645,35 +758,35 @@ class Ot extends st {
    * multi-chart sync so a synced pane tracks the originating gesture in
    * lockstep rather than lagging behind on the long sticky contract.
    */
-  setVisibleRange(i, t) {
-    if (typeof i == "number") {
-      if (!Number.isInteger(i) || i < 2) return;
+  setVisibleRange(t, i) {
+    if (typeof t == "number") {
+      if (!Number.isInteger(t) || t < 2) return;
       const { first: n, last: h } = this.getDataBounds();
       if (n === void 0 || h === void 0) return;
-      const a = Math.max(n, h - (i - 1) * this.#h), d = this.#n.size.media.width - this.yAxisWidth;
-      this.#M(a, h, d), this.#N();
+      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 i) {
-      if (!Number.isInteger(i.bars) || i.bars < 2) return;
-      const n = g(i.from), h = n + i.bars * this.#h;
-      this.#p = this.#s !== null && this.#s >= n && this.#s <= h, this.#C({ from: n, to: h }, { emitChange: !0 }), this.#L = !0, this.#N();
+    if ("bars" in t) {
+      if (!Number.isInteger(t.bars) || t.bars < 2) return;
+      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(i.from), s = g(i.to);
-    this.#p = this.#s !== null && this.#s >= e && this.#s <= s, this.#L = !1;
-    const r = this.#C({ from: e, to: s }, { emitChange: !0 });
-    if (t?.gesture) {
-      r && this.#pt();
+    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.#Mt();
       return;
     }
-    this.#N();
+    this.#W();
   }
   getYRange() {
-    return this.#V;
+    return this.#F;
   }
   getCrosshairPosition() {
-    return this.#m;
+    return this.#d;
   }
   /**
    * Programmatically set or clear the crosshair. Same effect as the user
@@ -700,45 +813,52 @@ class Ot extends st {
    * current crosshair is a no-op (no emit). Combined with the y-preservation
    * above, this lets N charts broadcast their hover to each other without
    * a feedback-loop guard.
+   *
+   * The echo protection assumes the broadcast is **synchronous** (call
+   * `setCrosshair` directly from the `crosshairMove` listener). An echo
+   * routed through an async hop — a state store, a React render — can
+   * arrive with a stale `time` while the origin chart streams, miss the
+   * idempotency check, and flip that chart to time-anchored until the next
+   * real pointer move (see {@link #syncCrosshairToViewport}).
    */
-  setCrosshair(i) {
-    if (i === null) {
-      if (this.#m === null) return;
-      this.#m = null, this.#d.markDirty(), this.emit("crosshairMove", null);
+  setCrosshair(t) {
+    if (t === null) {
+      if (this.#d === null) return;
+      this.#d = null, this.#h.markDirty(), this.emit("crosshairMove", null);
       return;
     }
-    const { time: t } = i;
-    if (!Number.isFinite(t)) return;
-    const e = this.#m;
+    const { time: i } = t;
+    if (!Number.isFinite(i)) return;
+    const e = this.#d;
     let s;
-    if (i.y !== void 0)
-      s = i.y;
+    if (t.y !== void 0)
+      s = t.y;
     else if (e !== null)
       s = e.y;
     else {
-      const h = this.#V;
+      const h = this.#F;
       s = (h.min + h.max) / 2;
     }
-    if (!Number.isFinite(s) || e !== null && e.time === t && e.y === s) return;
-    const r = this.timeScale.timeToX(t), n = this.yScale.valueToY(s);
-    this.#m = { mediaX: r, mediaY: n, time: t, y: s }, this.#d.markDirty(), this.emit("crosshairMove", this.#m);
+    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.#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(i) {
-    return B(i, this.#t, this.#e.getAnimationState().xRange);
+  getLastValue(t) {
+    return Z(t, this.#t, this.#s.getAnimationState().xRange);
   }
   /** Get the second-to-last value, useful for computing change. */
-  getPreviousClose(i) {
-    return F(i, this.#t);
+  getPreviousClose(t) {
+    return _(t, this.#t);
   }
-  getLastData(i) {
-    const t = this.#t.find((e) => e.id === i);
-    return !t || t.renderer.kind === "pie" ? null : t.renderer.getLastDataPoint();
+  getLastData(t) {
+    const i = this.#t.find((e) => e.id === t);
+    return !i || !S(i.renderer) ? null : i.renderer.getLastDataPoint();
   }
   /** Find the data point closest to the given timestamp within one data interval. */
-  getDataAtTime(i, t) {
-    const e = this.#t.find((s) => s.id === i);
-    return e ? e.renderer.getDataAtTime?.(t, this.#h) ?? null : null;
+  getDataAtTime(t, i) {
+    const e = this.#t.find((s) => s.id === t);
+    return e ? e.renderer.getDataAtTime?.(i, this.#r) ?? null : null;
   }
   /**
    * Get all layers' data at a given time for multi-layer series (Bar/Line
@@ -746,50 +866,52 @@ class Ot extends st {
    * snapped sample time — callers must not derive layer identity from the
    * array index, because hidden layers are filtered out.
    */
-  getLayerSnapshots(i, t) {
-    const e = this.#t.find((s) => s.id === i);
-    return e?.visible ? e.renderer.getLayerSnapshots?.(t, this.#h) ?? null : null;
+  getLayerSnapshots(t, i) {
+    const e = this.#t.find((s) => s.id === t);
+    return e?.visible ? e.renderer.getLayerSnapshots?.(i, this.#r) ?? null : null;
   }
   getSeriesIds() {
-    return this.#A || (this.#A = this.#t.map((i) => i.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.
    */
-  #ut() {
-    for (const i of this.#t)
-      if (i.visible && i.renderer.kind !== "pie")
+  #Tt() {
+    for (const t of this.#t)
+      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.
    * - `opts.singleLayerOnly` — exclude series with more than one layer.
    *   Useful for YLabel fallback priority (stick to a single line first).
    */
-  getSeriesIdsByType(i, t) {
-    const e = t?.visibleOnly === !0, s = t?.singleLayerOnly === !0, r = [];
+  getSeriesIdsByType(t, i) {
+    const e = i?.visibleOnly === !0, s = i?.singleLayerOnly === !0, r = [];
     for (const n of this.#t) {
-      const h = n.renderer.kind === "pie";
-      if (i === "pie" && !h || i === "time" && h) continue;
-      const a = n.renderer.getLayerCount();
-      if (!(s && a > 1)) {
+      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 (a > 1) {
-            let d = !1;
-            for (let l = 0; l < a; l++)
+          if (h > 1) {
+            let a = !1;
+            for (let l = 0; l < h; l++)
               if (n.renderer.isLayerVisible(l)) {
-                d = !0;
+                a = !0;
                 break;
               }
-            if (!d) continue;
+            if (!a) continue;
           }
         }
         r.push(n.id);
@@ -803,8 +925,23 @@ class Ot extends st {
    * series without stacked concepts (Candlestick, single-layer Line/Bar).
    * Returns `null` for unknown ids or empty series.
    */
-  getStackedLastValue(i) {
-    return Y(i, this.#t, this.#e.getAnimationState().xRange);
+  getStackedLastValue(t) {
+    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`
@@ -812,8 +949,8 @@ class Ot extends st {
    * overlay components that must display every layer in last-mode even
    * when layers advance at different rates (ragged streams).
    */
-  getLayerLastSnapshots(i) {
-    return this.#t.find((t) => t.id === i)?.renderer.getLayerLastSnapshots?.() ?? null;
+  getLayerLastSnapshots(t) {
+    return this.#t.find((i) => i.id === t)?.renderer.getLayerLastSnapshots?.() ?? null;
   }
   /**
    * Shallow view of the internal series entries so unit tests can introspect
@@ -823,20 +960,20 @@ class Ot extends st {
    * @internal
    */
   listSeriesForTest() {
-    return this.#t.map((i) => ({ id: i.id, renderer: i.renderer }));
+    return this.#t.map((t) => ({ id: t.id, renderer: t.renderer }));
   }
   /** Get the primary display color for a series. */
-  getSeriesColor(i) {
-    const t = this.#t.find((e) => e.id === i);
-    return t ? t.renderer.getLayerColors()[0] ?? this.#r.line.color : null;
+  getSeriesColor(t) {
+    const i = this.#t.find((e) => e.id === t);
+    return i ? i.renderer.getLayerColors()[0] ?? this.#n.line.color : null;
   }
   /** The series' primary name (first layer). Used for single-layer overlays. */
-  getSeriesLabel(i) {
-    return this.#t.find((t) => t.id === i)?.labels?.[0];
+  getSeriesLabel(t) {
+    return this.#t.find((i) => i.id === t)?.labels?.[0];
   }
   /** The display name of one layer, or `undefined` when that layer is unnamed. */
-  getLayerLabel(i, t) {
-    return this.#t.find((e) => e.id === i)?.labels?.[t];
+  getLayerLabel(t, i) {
+    return this.#t.find((e) => e.id === t)?.labels?.[i];
   }
   /**
    * Set every layer's display name at once (index = layer). Drives the tooltip,
@@ -844,9 +981,9 @@ class Ot extends st {
    * per-layer labels in `data` change. No-ops (and skips the overlay bump) when
    * the labels are unchanged, so it's safe to call on every data tick.
    */
-  setSeriesLabels(i, t) {
-    const e = this.#t.find((s) => s.id === i);
-    !e || I(e.labels, t) || (e.labels = t, this.#S());
+  setSeriesLabels(t, i) {
+    const e = this.#t.find((s) => s.id === t);
+    !e || H(e.labels, i) || (e.labels = i, this.#p());
   }
   /**
    * Set the per-layer color overrides carried in `data` (sparse — `undefined`
@@ -855,44 +992,58 @@ class Ot extends st {
    * the renderer, which keeps them separate from the theme base so a theme swap
    * preserves them. Called by the framework wrappers; no-ops when unchanged.
    */
-  setLayerColors(i, t) {
-    const e = this.#t.find((s) => s.id === i);
-    !e || ft(e.colorOverrides, t) || (e.colorOverrides = t, e.renderer.setColorOverrides?.(t), this.#i.markDirty(), this.#S());
+  setLayerColors(t, i) {
+    const e = this.#t.find((s) => s.id === t);
+    !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(i) {
-    const t = this.#t.find((r) => r.id === i);
-    if (!t) return null;
-    const e = t.renderer.getLayerCount();
+  getSeriesLayers(t) {
+    const i = this.#t.find((r) => r.id === t);
+    if (!i) return null;
+    const e = i.renderer.getLayerCount();
     if (e <= 1) return null;
-    const s = t.renderer.getLayerColors();
+    const s = i.renderer.getLayerColors();
     return Array.from({ length: e }, (r, n) => ({ color: s[n % s.length] }));
   }
   /** Get all slices with computed colors and percentages. Returns null for series without slice data (e.g. candlestick, line, bar). */
-  getSliceInfo(i) {
-    return this.#t.find((t) => t.id === i)?.renderer.getSliceInfo?.(this.#r) ?? null;
+  getSliceInfo(t) {
+    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(i) {
-    return this.#t.find((t) => t.id === i)?.renderer.getHoverInfo?.(this.#r) ?? null;
+  getHoverInfo(t) {
+    return this.#t.find((i) => i.id === t)?.renderer.getHoverInfo?.(this.#n) ?? null;
   }
   /** Apply a new theme and update series colors where appropriate. */
-  setTheme(i) {
-    const t = this.#r;
-    this.#r = i;
+  setTheme(t) {
+    const i = this.#n;
+    this.#n = t;
     for (const e of this.#t)
-      e.renderer.applyTheme(i, t);
-    this.#i.markDirty(), this.#S();
+      e.renderer.applyTheme(t, i);
+    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(i) {
-    const t = this.yAxisWidth, e = this.xAxisHeight;
-    this.#I = i, this.#a = { min: i.y?.min, max: i.y?.max }, this.#u = !0;
+  setAxis(t) {
+    const i = this.yAxisWidth, e = this.xAxisHeight;
+    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.#y(s), (this.yAxisWidth !== t || 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=…>`
@@ -900,29 +1051,29 @@ class Ot extends st {
    * Y-animation reset. Triggers a viewportChange + repaint so static charts
    * react without waiting for pan/zoom.
    */
-  setYAxisLabelDensity(i) {
-    let t = !1;
-    "labelCount" in i && (this.yScale.setLabelCount(i.labelCount ?? null), t = !0), "minLabelSpacing" in i && (this.yScale.setMinSpacing(i.minLabelSpacing ?? null), t = !0), t && (this.syncScales(), this.emit("viewportChange"), this.#i.markDirty());
+  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.#e.markDirty());
   }
   /** Label-density knobs for the time axis — mirror of {@link setYAxisLabelDensity}. */
-  setTimeAxisLabelDensity(i) {
-    let t = !1;
-    "labelCount" in i && (this.timeScale.setLabelCount(i.labelCount ?? null), t = !0), "minLabelSpacing" in i && (this.timeScale.setMinSpacing(i.minLabelSpacing ?? null), t = !0), t && (this.syncScales(), this.emit("viewportChange"), this.#i.markDirty());
+  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.#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 i = this.#n.size.media, t = this.yAxisWidth, e = this.xAxisHeight;
+    const t = this.#a.size.media, i = this.yAxisWidth, e = this.xAxisHeight;
     return {
-      chartArea: { x: 0, y: 0, width: i.width - t, height: i.height - e },
-      yAxisWidth: t,
+      chartArea: { x: 0, y: 0, width: t.width - i, height: t.height - e },
+      yAxisWidth: i,
       xAxisHeight: e
     };
   }
   getDataInterval() {
-    return this.#h;
+    return this.#r;
   }
   /**
    * Update viewport padding at runtime. Refits the visible time range to
@@ -932,27 +1083,27 @@ class Ot extends st {
    * a wrapper re-applies padding reactively (e.g. in response to a Title /
    * InfoBar ResizeObserver).
    */
-  setPadding(i) {
-    const t = this.#l;
-    this.#l = D(i);
-    const e = this.#l, s = !C(t.left, e.left) || !C(t.right, e.right), r = t.top !== e.top || t.bottom !== e.bottom;
+  setPadding(t) {
+    const i = this.#c;
+    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: h } = this.getDataBounds();
       if (n !== void 0 && h !== void 0) {
-        const a = this.#n.size.media.width - this.yAxisWidth;
-        this.#M(n, h, a);
+        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.#y(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(i) {
-    this.#E = i.visible, this.#i.markDirty();
+  setGrid(t) {
+    this.#O = t.visible, this.#e.markDirty();
   }
   /**
    * Set the visual state for one side of the chart. Typically called in
@@ -963,12 +1114,62 @@ class Ot extends st {
    * The state persists until replaced. `has-more` is accepted for API
    * symmetry and currently renders identically to `idle`.
    */
-  setEdgeState(i, t) {
-    this.#b[i] !== t && (this.#b[i] = t, this.#d.markDirty());
+  setEdgeState(t, i) {
+    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(i) {
-    return this.#b[i];
+  getEdgeState(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
@@ -976,33 +1177,95 @@ class Ot extends st {
    * chart area to make room for the badge.
    * TODO: implement reflow.
    */
-  setYLabel(i) {
+  setYLabel(t) {
   }
   /**
    * 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.
    */
-  #ft(i) {
-    const t = this.#n.size, e = this.#l, s = {
-      top: e.top * t.verticalPixelRatio,
-      bottom: e.bottom * t.verticalPixelRatio
+  #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 h = -1;
-      if (i) {
-        const a = i.mediaX * t.horizontalPixelRatio, d = i.mediaY * t.verticalPixelRatio;
-        h = n.renderer.hitTest(a, d, t.bitmap.width, t.bitmap.height, s);
+    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 l = t.mediaX * i.horizontalPixelRatio, o = t.mediaY * i.verticalPixelRatio;
+        a = h.renderer.hitTest(l, o, i.bitmap.width, i.bitmap.height, s);
+      }
+      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 };
+    }
+    return null;
+  }
+  /**
+   * Re-derive the crosshair after the viewport moved beneath it. A streaming
+   * auto-scroll, wheel zoom, or animated Y re-fit shifts the pixel↔data
+   * mapping while the cursor stays put — without this, the stored position
+   * goes stale: the tooltip freezes on the old time/values while the data
+   * (and any snap dots anchored to it) slides away underneath.
+   *
+   * Which half of the position is truth depends on {@link #crosshairAnchor}:
+   * a pointer-anchored crosshair stays under the cursor and re-resolves
+   * `time`/`y`; a time-anchored one keeps `time`/`y` and re-projects the
+   * pixel position so it tracks its data point across the screen. A
+   * time-anchored point whose time scrolls out of the visible range clears
+   * the crosshair entirely (mirroring pointer-leave) — otherwise the
+   * edge-clamped tooltip would pin to the chart border, live-updating for
+   * an invisible point.
+   *
+   * Called once per painted main frame (after `syncScales`). When the
+   * viewport didn't move, the re-derived values are bit-identical and the
+   * method exits without emitting.
+   */
+  #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, 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;
+      a = { mediaX: t.mediaX, mediaY: t.mediaY, time: l, y: o };
+    } else {
+      if (t.time < i || t.time > e) {
+        this.#d = null, this.#h.markDirty(), this.emit("crosshairMove", null), this.#G(null);
+        return;
       }
-      n.renderer.setHoverIndex(h) && (r = !0);
+      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) <= h && Math.abs(o - t.mediaY) <= h) return;
+      a = { mediaX: l, mediaY: o, time: t.time, y: t.y };
     }
-    r && this.#i.markDirty();
+    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 i of this.#t) i.renderer.dispose();
-    this.#t = [], this.#c = [], this.#v = [], this.#g = [], this.#A = null, this.#i.destroy(), this.#d.destroy(), this.#W?.destroy(), this.#n.destroy(), this.#F?.destroy(), this.#F = null, this.#B && this.#x?.destroy(), this.#x = null, this.#B = !1, this.removeAllListeners();
+    for (const t of this.#t) t.renderer.dispose();
+    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() {
@@ -1010,39 +1273,39 @@ class Ot extends st {
   }
   /** Compute the earliest and latest timestamps across all series. */
   getDataBounds() {
-    let i, t;
+    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 && ((i === void 0 || s.first < i) && (i = s.first), (t === void 0 || s.last > t) && (t = s.last));
+      s !== null && ((t === void 0 || s.first < t) && (t = s.first), (i === void 0 || s.last > i) && (i = s.last));
     }
-    return { first: i, last: t };
+    return { first: t, last: i };
   }
   /** 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. */
-  #Y = !1;
+  #q = !1;
   onDataChanged() {
-    if (this.#w > 0) {
-      this.#$ = !0;
+    if (this.#A > 0) {
+      this.#X = !0;
       return;
     }
     this.updateDataInterval();
-    const { first: i, last: t } = this.getDataBounds();
-    i !== void 0 && (this.#k = i), t !== void 0 && (this.#P = this.#s, this.#s = t);
-    const e = this.#Y;
-    this.#Y = !1;
-    const s = !this.#u && i !== void 0;
-    e && (this.yScale.tickTracker.reset(), this.timeScale.tickTracker.reset()), this.#K = e;
+    const { first: t, last: i } = this.getDataBounds();
+    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.#R = !0), i !== void 0 && (this.#u = !0), this.#y(r), this.syncScales(), s ? this.#U() : this.#i.markDirty(), this.emit("dataUpdate"), this.#S();
+    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 i of this.#t) {
-      if (i.renderer.kind === "pie") continue;
-      const t = i.renderer.sampleTimes(20);
-      if (t.length >= 2) {
-        this.#h = lt(t);
+    for (const t of this.#t) {
+      if (!S(t.renderer)) continue;
+      const i = t.renderer.sampleTimes(20);
+      if (i.length >= 2) {
+        this.#r = ut(i);
         break;
       }
     }
@@ -1052,28 +1315,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. */
-  #R = !1;
+  #I = !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.
    */
-  #H;
+  #N;
   /** 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. */
-  #X = Number.NaN;
-  #_ = 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.
@@ -1082,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.
    */
-  #st(i) {
-    const t = i ?? this.#o, e = this.#a.min !== void 0 && this.#a.min !== "auto" && typeof this.#a.min != "number" || this.#a.max !== void 0 && this.#a.max !== "auto" && typeof this.#a.max != "number" ? [] : null, s = q(t, 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 = R(this.#a.min, s.min, s.max, e ?? [], "min"), n = R(this.#a.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 };
   }
   /**
@@ -1107,24 +1370,29 @@ class Ot extends st {
    * - **autoscroll off** → `null` (no X retarget; user has panned away
    *   from the tail).
    */
-  #gt() {
-    if (this.#k === null || this.#s === null) return null;
-    const { from: i, to: t } = this.#o, e = i === 0 && t === 0, s = this.#n.size.media.width - this.yAxisWidth;
-    if (e)
-      return this.#M(this.#k, this.#s, s), this.#H !== void 0 && (this.setVisibleRange(this.#H), this.#H = void 0), this.#o;
-    if (!this.#p) return null;
-    if (this.#K)
-      return this.#M(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.#h,
-      paddingRight: this.#l.right,
+      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.#p = !0), r.newLogical === null ? null : (this.#D.observe(performance.now()), this.#e.setXSettleMs(this.#D.pickSettleMs(this.#f.axis.x.settleMs)), this.#C(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
@@ -1132,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`).
    */
-  #M(i, t, e) {
-    const s = this.#l, r = O({
-      firstTime: i,
-      lastTime: t,
-      dataInterval: this.#h,
-      maxVisibleBars: this.#Q,
+  #P(t, i, e) {
+    const s = this.#c, r = X({
+      firstTime: t,
+      lastTime: i,
+      dataInterval: this.#r,
+      maxVisibleBars: this.#ot,
       chartWidth: e,
       padding: { left: s.left, right: s.right }
     });
-    this.#L = !1, this.#p = !0, this.#C(r, { emitChange: !0 });
+    this.#w = !1, this.#u = !0, this.#L(r, { emitChange: !0 });
   }
   /**
    * Commit a programmatic zoom — `fitContent` or `setVisibleRange`. Reads
@@ -1157,15 +1425,15 @@ class Ot extends st {
    *   passes `xEase: true` so X eases instead — viewport and axis converge
    *   on the same frame.
    */
-  #N(i) {
-    const t = this.#o;
-    if (t.to <= t.from) return;
+  #W(t) {
+    const i = this.#o;
+    if (i.to <= i.from) return;
     const e = performance.now();
-    if (!this.#R || !this.#u) {
-      this.#rt(e);
+    if (!this.#I || !this.#f) {
+      this.#pt(e);
       return;
     }
-    this.#e.onProgrammaticZoom({ xTarget: t, xEase: i?.xEase }, e), this.#y(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:
@@ -1179,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.
    */
-  #pt() {
-    const i = this.#o;
-    if (i.to <= i.from) return;
-    const t = performance.now();
-    if (!this.#R || !this.#u) {
-      this.#rt(t);
+  #Mt() {
+    const t = this.#o;
+    if (t.to <= t.from) return;
+    const i = performance.now();
+    if (!this.#I || !this.#f) {
+      this.#pt(i);
       return;
     }
-    this.#e.onPanZoom({ xTarget: i, yAuto: !0 }, t), this.#y(t);
+    this.#s.onPanZoom({ xTarget: t, yAuto: !0 }, i), this.#v(i);
   }
   /**
    * First-paint snap: land both axes on the current logical X immediately
@@ -1196,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.
    */
-  #rt(i) {
-    const t = this.#o, e = this.#st(t);
-    this.#R = !0, e !== null && (this.#u = !0), this.#e.snap({ x: t, y: e ?? void 0 }, i), this.#y(i);
+  #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
@@ -1218,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.
    */
-  #C(i, t) {
-    const { from: e, to: s } = i;
-    return !Number.isFinite(e) || !Number.isFinite(s) || s <= e || !t.skipValidation && (s - e) / this.#h < 2 || this.#o.from === e && this.#o.to === s ? !1 : (this.#o = { from: e, to: s }, t.emitChange && (this.syncScales(), this.#i?.markDirty(), this.emit("viewportChange")), !0);
+  #L(t, i) {
+    const { from: e, to: s } = t;
+    return !Number.isFinite(e) || !Number.isFinite(s) || s <= e || !i.skipValidation && (s - e) / this.#r < 2 || this.#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
@@ -1228,11 +1496,11 @@ class Ot extends st {
    * symmetric pad top / bottom from `#padding`, suppressed on the side
    * that has an explicit (fixed) axis bound.
    */
-  #nt(i, t, e, s, r) {
-    const n = t - i, h = e > 0 ? this.#l.top / e * n : 0, a = e > 0 ? this.#l.bottom / e * n : 0;
-    this.#V = {
-      min: s ? i : i - a,
-      max: r ? t : t + h
+  #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
     };
   }
   /**
@@ -1245,18 +1513,18 @@ class Ot extends st {
    * as a gesture for visual easing. Public so consumers can drive pan
    * programmatically.
    */
-  pan(i, t = this.#z) {
-    t > 0 && (this.#z = t), 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: i,
-      chartWidth: t,
-      dataInterval: this.#h,
-      padding: { left: this.#l.left, right: this.#l.right },
+      timeDelta: t,
+      chartWidth: i,
+      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.#p = !e.autoScrollOff, this.#C(e.newLogical, { emitChange: !0 }), e.edgeReached !== null && (this.#j[e.edgeReached.side] = e.edgeReached.boundaryTime, this.#q?.(e.edgeReached)), this.#D.pause(), this.#ht());
+    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.
@@ -1273,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(i, t, 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: i,
-      factor: t,
+      centerTime: t,
+      factor: i,
       chartWidth: e,
-      dataInterval: this.#h,
-      padding: { left: this.#l.left, right: this.#l.right },
+      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.#p && this.#s !== null) {
-      const n = r.to - r.from, h = T(this.#l.right, n, this.#h, e), a = this.#s + h;
-      r = { from: a - n, to: a }, 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.#C(r, { emitChange: !0 }), this.#D.pause(), this.#ht();
+    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`.
    */
-  #ht() {
-    const i = this.#o;
-    if (i.to <= i.from) return;
-    this.#R = !0, this.#u = !0;
-    const t = performance.now();
-    this.#e.onPanZoom({ xTarget: i, yAuto: !0 }, t), this.#y(t);
+  #vt() {
+    const t = this.#o;
+    if (t.to <= t.from) return;
+    this.#I = !0, this.#f = !0;
+    const i = performance.now();
+    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
@@ -1318,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.
    */
-  #y(i) {
-    const t = this.#e.tick(i), 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.#a.min !== void 0 && this.#a.min !== "auto", r = this.#a.max !== void 0 && this.#a.max !== "auto", n = e.media.height - this.xAxisHeight;
-    this.#nt(t.yRange.min, t.yRange.max, n, s, r), this.#X = t.yRange.min, this.#_ = t.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
@@ -1330,79 +1598,79 @@ class Ot extends st {
    * handler, so DOM axis components always read fresh coordinates on re-render.
    */
   syncScales() {
-    const i = this.#n.size;
-    if (i.media.width === 0 || i.media.height === 0) return;
-    const t = i.media.width - this.yAxisWidth, e = i.media.height - this.xAxisHeight;
+    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,
-      t,
-      i.horizontalPixelRatio,
-      this.#h
-    ), this.yScale.update(this.#V, e, i.verticalPixelRatio);
+      this.#s.getAnimationState().xRange,
+      i,
+      t.horizontalPixelRatio,
+      this.#r
+    ), this.yScale.update(this.#F, e, t.verticalPixelRatio);
   }
   /** Expensive: background, grid, all series. Only on data/viewport/resize change. */
-  renderMain(i) {
-    const t = this.#n.size;
-    if (t.media.width === 0 || t.media.height === 0) return;
-    const e = typeof i == "number" ? i : performance.now(), s = this.#e.tick(e);
-    s.animating && this.#i.markDirty();
-    const r = s.yRange.min, n = s.yRange.max, h = r !== this.#X || n !== this.#_;
+  renderMain(t) {
+    const i = this.#a.size;
+    if (i.media.width === 0 || i.media.height === 0) return;
+    const e = typeof t == "number" ? t : performance.now(), s = this.#s.tick(e);
+    s.animating && this.#e.markDirty();
+    const r = s.yRange.min, n = s.yRange.max, h = r !== this.#K || n !== this.#j;
     if (h) {
-      const c = this.#a.min !== void 0 && this.#a.min !== "auto", o = this.#a.max !== void 0 && this.#a.max !== "auto", f = t.media.height - this.xAxisHeight;
-      this.#nt(r, n, f, c, o), this.#X = r, this.#_ = n;
+      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.#s !== null && !this.#p) {
-      const c = this.#e.lastXTarget ?? this.#o, o = c.to - c.from;
-      if (o > 0) {
-        const f = this.#n.size.media.width - this.yAxisWidth, y = T(this.#l.right, o, this.#h, f), v = this.#h * 0.5;
-        Math.abs(c.to - (this.#s + y)) < v && (this.#p = !0);
+    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 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);
       }
     }
     h && this.emit("viewportChange");
-    let a = !1, d = !1;
-    this.#n.useMainLayer((c) => {
-      const { context: o, bitmapSize: f } = c, y = (t.media.width - this.yAxisWidth) * t.horizontalPixelRatio, v = (t.media.height - this.xAxisHeight) * t.verticalPixelRatio;
-      o.clearRect(0, 0, f.width, f.height), o.save(), o.beginPath(), o.rect(0, 0, y, v), o.clip(), this.yScale.tickTracker.setCurrentTicks(this.yScale.niceTickValues()), this.timeScale.tickTracker.setCurrentTicks(this.timeScale.niceTickValues(this.#h).ticks), this.yScale.tickTracker.tick(e), this.timeScale.tickTracker.tick(e);
-      const S = this.yScale.tickTracker.snapshot(), b = this.timeScale.tickTracker.snapshot();
-      a = S.isAnimating, d = b.isAnimating, (S.isAnimating || b.isAnimating || s.animating) && this.emit("tickFrame"), this.#E && K({
-        scope: c,
+    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: S,
-        timeTicks: b
-      }), this.#ct(c, y, v);
-      const k = this.#l, P = { top: k.top, bottom: k.bottom }, w = this.#x;
-      for (const p of this.#t) {
-        const x = p.renderer.getAlpha?.() ?? (p.visible ? 1 : 0);
+        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 L = {
-          scope: c,
+        const T = {
+          scope: d,
           timeScale: this.timeScale,
           yScale: this.yScale,
-          theme: this.#r,
-          dataInterval: this.#h,
-          padding: P,
+          theme: this.#n,
+          dataInterval: this.#r,
+          padding: V,
           state: s,
-          seriesId: p.id
-        }, A = o.globalAlpha;
-        if (x < 1 && (o.globalAlpha = A * x), w) {
-          const V = performance.now();
-          p.renderer.render(L), w.recordSeries(p.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
-          p.renderer.render(L);
-        x < 1 && (o.globalAlpha = A);
+          b.renderer.render(T);
+        x < 1 && (c.globalAlpha = D);
       }
-      o.restore();
-    });
-    let l = !1;
-    for (const c of this.#t)
-      if (c.renderer.needsAnimation) {
-        l = !0, this.#i.markDirty();
+      c.restore();
+    }), this.#$();
+    let o = !1;
+    for (const d of this.#t)
+      if (d.renderer.needsAnimation) {
+        o = !0, this.#e.markDirty();
         break;
       }
-    const u = a || d;
-    !s.animating && !l && !u && (this.yScale.tickTracker.markArmed(), this.timeScale.tickTracker.markArmed());
+    const u = a || l;
+    !s.animating && !o && !u && (this.yScale.tickTracker.markArmed(), this.timeScale.tickTracker.markArmed());
   }
   /**
    * Paint a full frame: the main layer, then the overlay synchronously on
@@ -1413,83 +1681,97 @@ class Ot extends st {
    * `markDirty` calls made *during* `renderOverlay` (pulse, edge spinner)
    * land after the consume and re-arm cleanly for the next frame.
    */
-  #U(i) {
-    this.#Z("main", i, () => this.renderMain(i)), this.#d.consume(), this.#Z("overlay", i, () => this.renderOverlay(i));
+  #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. */
-  #Z(i, t, e) {
+  #Q(t, i, e) {
     const s = this.#x;
     if (!s) {
       e();
       return;
     }
-    s.resetDrawCalls(i);
+    s.resetDrawCalls(t);
     const r = performance.now();
-    e(), s.recordFrame(i, performance.now() - r, t ?? r);
+    e(), s.recordFrame(t, performance.now() - r, i ?? r);
   }
   /** Cheap overlay: crosshair, nearest-point dots, pulse animation, edge indicator. */
-  renderOverlay(i) {
-    const t = this.#n.size;
-    if (t.media.width === 0 || t.media.height === 0) return;
+  renderOverlay(t) {
+    const i = this.#a.size;
+    if (i.media.width === 0 || i.media.height === 0) return;
     let e = !1;
-    for (const h of this.#t)
-      if (h.visible && h.renderer.overlayNeedsAnimation) {
+    for (const o of this.#t)
+      if (o.visible && o.renderer.overlayNeedsAnimation) {
         e = !0;
         break;
       }
-    this.#c.some((h) => h.pulse) && (e = !0);
-    const s = this.#b.left === "loading" || this.#b.right === "loading", r = this.#b.left !== "idle" || this.#b.right !== "idle", n = !!this.#m || e || r || this.#c.length > 0 || this.#g.length > 0;
-    if (!(!n && !this.#G)) {
-      if (this.#G = n, this.#n.useOverlayLayer((h) => {
-        if (!n) return;
-        const a = (t.media.width - this.yAxisWidth) * t.horizontalPixelRatio, d = (t.media.height - this.xAxisHeight) * t.verticalPixelRatio;
-        if (h.context.save(), h.context.beginPath(), h.context.rect(0, 0, a, d), h.context.clip(), this.#m && this.#ut()) {
-          const o = this.#m.mediaX * t.horizontalPixelRatio, f = this.#m.mediaY * t.verticalPixelRatio;
-          J(h, o, 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 l = this.#l, u = { top: l.top, bottom: l.bottom }, c = this.#e.getAnimationState();
-        for (const o of this.#t)
-          o.visible && o.renderer.drawOverlay?.({
-            scope: h,
+        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.#h,
-            padding: u,
-            crosshair: this.#m,
-            state: c,
-            seriesId: o.id
+            theme: this.#n,
+            dataInterval: this.#r,
+            padding: p,
+            crosshair: this.#d,
+            state: v,
+            seriesId: m.id
           });
-        this.#mt(h, a, d), this.#dt(h), r && E({
-          scope: h,
-          chartMediaHeight: t.media.height - this.xAxisHeight,
+        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.#b,
-          resolveBoundary: (o) => $(o, this.#j[o], this.getDataBounds())
-        }), h.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: h, to: a } = this.timeScale.getRange();
+        const { from: o, to: u } = this.timeScale.getRange();
         let d = !1;
-        for (const l of this.#t)
-          if (!(!l.visible || !l.renderer.overlayNeedsAnimation) && (l.renderer.hasOverlayContentInRange?.(h, a) ?? !0)) {
+        for (const c of this.#t)
+          if (!(!c.visible || !c.renderer.overlayNeedsAnimation) && (c.renderer.hasOverlayContentInRange?.(o, u) ?? !0)) {
             d = !0;
             break;
           }
         if (!d) {
-          for (const l of this.#c)
-            if (l.pulse && l.time >= h && l.time <= a) {
+          for (const c of this.#m)
+            if (c.pulse && c.time >= o && c.time <= u) {
               d = !0;
               break;
             }
         }
-        d && this.#d.markDirty();
+        d && this.#h.markDirty();
       }
-      s && this.#d.markDirty();
+      h && this.#h.markDirty();
     }
   }
 }
 export {
-  Ot as ChartInstance
+  qt as ChartInstance
 };