@wick-charts/vue 0.4.2 → 0.5.1

package/dist/core/dist/chart.js

@@ -0,0 +1,1550 @@
+import { AnimationConfig as z, DEFAULT_LINE_PULSE as N } from "./animation/config.js";
+import { createViewportEngine as H } from "./animation/viewport-engine.js";
+import { CanvasManager as W } from "./canvas-manager.js";
+import { drawEdgeIndicators as E, resolveEdgeBoundary as F } from "./chart/edge-indicators.js";
+import { computeFitToData as O } from "./chart/fit-to-data.js";
+import { getLastValue as Y, getPreviousClose as B, getStackedLastValue as X } from "./chart/last-value.js";
+import { resolveMaxVisibleBars as _, resolvePadding as D, resolvePerfOptions as $, isSameHorizontalPadding as T } from "./chart/options.js";
+import { computePan as U, computeZoom as Z } from "./chart/pan-zoom-math.js";
+import { StreamingCadence as G } from "./chart/streaming-cadence.js";
+import { computeStreamingTarget as j } from "./chart/streaming-target.js";
+import { resolvePaddingTime as C } from "./chart/viewport-padding.js";
+import { computeTargetYRange as q, resolveBound as M } from "./chart/y-target.js";
+import { renderCrosshair as J } from "./components/crosshair.js";
+import { renderGrid as K } from "./components/grid.js";
+import { renderMarker as Q } from "./components/marker.js";
+import { renderReferenceLine as tt } from "./components/reference-line.js";
+import { resolveTimeRegionColors as it, renderTimeRegion as et } from "./components/time-region.js";
+import { EventEmitter as st } from "./events.js";
+import { InteractionHandler as rt } from "./interactions/handler.js";
+import { RenderScheduler as R } from "./render-scheduler.js";
+import { XScale as nt } from "./scales/x-scale.js";
+import { YScale as at } from "./scales/y-scale.js";
+import { resolveSeriesDefinition as ht } from "./series/definition.js";
+import { catppuccin as ot } from "./theme/themes/catppuccin.js";
+import { normalizeTime as g, detectInterval as lt } from "./utils/time.js";
+let ct = 0, dt = 0, mt = 0, ut = 0;
+function I(m, t) {
+  return m === t ? !0 : !m || !t || m.length !== t.length ? !1 : m.every((i, e) => i === t[e]);
+}
+function ft(m, t) {
+  return m === t ? !0 : !m || !t || m.length !== t.length ? !1 : m.every((i, e) => i === t[e]);
+}
+class Ot extends st {
+  /** Canvas lifecycle and DPR-aware sizing. */
+  #n;
+  /** Schedules main-layer redraws (background, grid, series). */
+  #i;
+  /** Schedules overlay redraws (crosshair). */
+  #l;
+  /** Maps time values to horizontal pixel coordinates. */
+  timeScale;
+  /** Maps price/value to vertical pixel coordinates. */
+  yScale;
+  /** Zoom, pan, crosshair — null when interactive=false. */
+  #W;
+  /** All registered series (candlestick, line, bar, pie). */
+  #t = [];
+  /** Point annotations (event markers) drawn on the overlay layer, kept out of the series model. */
+  #m = [];
+  /** Time-region bands drawn on the main layer behind the series, kept out of the series model. */
+  #v = [];
+  /** Reference lines (horizontal threshold / vertical event) drawn on the overlay layer, kept out of the series model. */
+  #g = [];
+  /** Active visual theme (colors, fonts, grid style). */
+  #r;
+  /** Whether to render the background grid. */
+  #E;
+  /** Detected time interval between data points (milliseconds). */
+  #a = 6e4;
+  /** Current crosshair position, null when cursor is outside the chart. */
+  #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.
+   */
+  #F = "pointer";
+  /** Whether the last overlay pass painted anything — gates the full-bitmap
+   *  clear so an empty overlay isn't cleared again every main frame. */
+  #q = !1;
+  /** User-specified Y-axis bounds (auto, fixed, percentage). */
+  #h = {};
+  /** Cached series ID list — invalidated on add/remove. */
+  #A = null;
+  /** Axis visibility and sizing configuration. */
+  #I = {};
+  /** Host-declared state per edge — drives the edge-indicator overlay. */
+  #x = { left: "idle", right: "idle" };
+  /** Cached boundary timestamps from the last `edgeReached` emission, by side. */
+  #J = { left: null, right: null };
+  /** Host-supplied callback fired when the user releases a pan/zoom past a data edge. */
+  #K;
+  /** Nesting depth for batch updates. Suppresses recomputes while > 0. */
+  #w = 0;
+  /** True when batched operations include data changes (triggers full onDataChanged on end). */
+  #O = !1;
+  /** True when batched operations include visibility changes (triggers Y-range + redraw on end). */
+  #C = !1;
+  /** True when batched operations bumped overlay version (emits a single overlayChange on flush). */
+  #Y = !1;
+  /**
+   * Monotonic counter bumped on any mutation that affects overlay output —
+   * data, visibility, series options, theme. Used by snapshot helpers in
+   * `@wick-charts/core` as a cache key, so `buildHoverSnapshots` /
+   * `buildLastSnapshots` return the same reference between ticks when
+   * nothing observable has changed.
+   *
+   * @internal
+   */
+  #Q = 0;
+  get yAxisWidth() {
+    const t = this.#I.y;
+    return t?.visible === !1 ? 0 : t?.width ?? 55;
+  }
+  get xAxisHeight() {
+    const t = this.#I.x;
+    return t?.visible === !1 ? 0 : t?.height ?? 30;
+  }
+  /** Resolved animation config derived from `options.animations` at construction. */
+  #f;
+  /**
+   * Single source of truth for the chart's X / Y viewport animation.
+   * Push-model API: chart emits intent signals (`onPointAppended`,
+   * `onSeriesVisibilityChanged`, `onPanZoom`, `onProgrammaticZoom`,
+   * `onAxisReconfig`, `onDataReplaced`, `snap`); the engine pulls the
+   * matching targets back through `computeXTarget` / `computeYTarget`
+   * closures supplied at construction.
+   */
+  #e;
+  /** EMA-smoothed real-wall-clock cadence between streaming appends. The
+   *  X spring's `setSettleMs` is fed from this so the settle time stays just
+   *  longer than the producer's tick interval — the spring never quite
+   *  settles between ticks, so velocity carries continuously and the slide
+   *  doesn't pulse. */
+  #D;
+  /**
+   * Mirrors `#dataReplaceSnapPending` for the engine signal that follows
+   * inside the same `onDataChanged` call. `#dataReplaceSnapPending` is
+   * consumed at the top of `onDataChanged` (so a stray streaming append
+   * couldn't re-trigger the snap), but the `computeXTarget` closure runs
+   * later and still needs to know whether to refit the X window. This
+   * field carries the decision across that gap. The closure also reads
+   * `#dataStart` / `#dataEnd` directly for the timestamps.
+   */
+  #tt = !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;
+  /**
+   * 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;
+  /**
+   * 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;
+  /**
+   * Cap for fit-to-data. When the data span exceeds this, the fit anchors
+   * the right edge and trims the left. Resolved once at construction from
+   * `options.viewport.maxVisibleBars`.
+   */
+  #it;
+  /**
+   * Committed logical X range — the "where X should be" target. Engine
+   * eases its visual toward this. Pan / zoom / setRange / fitContent /
+   * streaming-target writes go here. Initialized to `{0,0}` and treated
+   * as "uninitialized" by `#computeXTarget` until first paint.
+   */
+  #o = { from: 0, to: 0 };
+  /** Padded Y range — engine's raw Y target plus pixel padding from `#padding`. */
+  #V = { min: 0, max: 0 };
+  /**
+   * Auto-scroll flag — when `true`, streaming ticks slide X to track the
+   * data tail. Pan flips this off when the gesture pushes the tail off
+   * screen; chart's per-frame autoscroll check re-engages it when a
+   * follow-up pan brings the tail back into view.
+   */
+  #y = !0;
+  /** Resolved viewport padding (top/bottom px + left/right pixels-or-intervals). */
+  #c;
+  /** Cached chart width — passed by interactions on every call; kept for the rare
+   *  call that omits it (e.g. programmatic `chart.pan(...)` without explicit width). */
+  #z = 0;
+  /** Active performance monitor, or `null` when instrumentation is disabled (the default). */
+  #S;
+  /** When true, `destroy()` tears down the monitor; false for caller-supplied monitors we must not destroy. */
+  #B = !1;
+  /** Visible HUD overlay (mounted by the perf config); non-null only when the caller requested one. */
+  #X = null;
+  constructor(t, i) {
+    super(), i?.axis && (this.#I = i.axis, this.#h = { min: i.axis.y?.min, max: i.axis.y?.max }), this.#r = i?.theme ?? ot.theme, this.#E = i?.grid?.visible !== !1, this.#f = z.resolve(i?.animations), this.#it = _(i?.viewport?.maxVisibleBars), this.#c = D(i?.padding), this.#D = new G();
+    const e = this.#f.axis.y, s = this.#f.axis.x;
+    this.#e = H({
+      initial: { yRange: { min: 0, max: 0 }, xRange: { from: 0, to: 0 } },
+      y: {
+        curve: e.curve,
+        settleMs: e.settleMs,
+        stickyMs: e.stickyMs,
+        stickyFloorMs: e.stickyFloorMs,
+        gestureMs: e.gestureMs,
+        toggleMs: this.#f.toggleMs
+      },
+      x: {
+        curve: s.curve,
+        settleMs: s.settleMs,
+        gestureMs: s.gestureMs
+      },
+      computeXTarget: () => this.#pt(),
+      computeYTarget: ({ xTarget: h }) => this.#nt(h),
+      onWake: () => this.#i?.markDirty()
+    }), this.#K = i?.onEdgeReached, this.#N = i?.viewport?.initialRange;
+    const r = $(i?.perf);
+    this.#S = r.monitor, this.#B = r.ownsMonitor, this.#n = new W(t, this.#S ?? void 0), this.timeScale = new nt(), this.yScale = new at();
+    const n = this.#f.axis.ticksMs;
+    this.timeScale.tickTracker.setFadeMs(n), this.yScale.tickTracker.setFadeMs(n), this.#i = new R((h) => this.#G(h)), this.#l = new R(
+      (h) => this.#j("overlay", h, () => this.renderOverlay(h))
+    ), this.#S && r.hud && (this.#X = r.hud(t, this.#S));
+    const a = i?.interactive !== !1;
+    this.#W = a ? new rt(this.#n.canvas, this, this.timeScale, this.yScale) : null, this.#n.on("resize", () => {
+      this.syncScales(), this.#G(), this.emit("viewportChange");
+    }), this.syncScales(), this.#W?.on("crosshairMove", (h) => {
+      this.#F = "pointer", this.#d = h, this.#l.markDirty(), this.emit("crosshairMove", h), this.#_(h);
+    });
+  }
+  /**
+   * Bump overlay version + emit `overlayChange`. Call from every mutation
+   * path whose output overlay components care about: data, series list,
+   * per-series/layer visibility, options, theme.
+   *
+   * Inside `batch(...)` the version still increments per call (so the
+   * snapshot cache invalidates at least once per logical change), but the
+   * `overlayChange` emission is coalesced to a single event on flush.
+   * That lets Legend-style isolate toggles — which batch multiple
+   * `setSeriesVisible` / `setLayerVisible` calls — produce one overlay
+   * render instead of N.
+   */
+  #b() {
+    if (this.#Q++, this.#w > 0) {
+      this.#Y = !0;
+      return;
+    }
+    this.emit("overlayChange");
+  }
+  /**
+   * Monotonic counter incremented on any mutation that affects overlay
+   * output. Snapshot helpers (`buildHoverSnapshots`, `buildLastSnapshots`)
+   * key their structural-equality cache on this value — same version +
+   * same `(time, sort, cacheKey)` returns the same frozen reference.
+   *
+   * @internal
+   */
+  getOverlayVersion() {
+    return this.#Q;
+  }
+  /**
+   * Return a series ID: use the provided hint if it's non-empty and not already taken,
+   * otherwise generate a new auto ID. Auto-generated IDs never collide with each other
+   * or with user-provided IDs because they use a monotonically increasing counter.
+   */
+  #lt(t) {
+    if (t && !this.#t.some((e) => e.id === t))
+      return t;
+    let i;
+    do
+      i = `series_${++ct}`;
+    while (this.#t.some((e) => e.id === i));
+    return i;
+  }
+  addSeries(t, i = {}) {
+    const e = typeof t == "string" ? ht(t) : t;
+    if (!e)
+      throw new Error(
+        `[wick-charts] Unknown series type '${String(t)}'. The string form of addSeries resolves through the series registry — call registerBuiltinSeries() once at startup, or pass the definition directly: chart.addSeries(LineSeriesDef, options).`
+      );
+    const { layers: s, id: r, label: n, labels: a, ...h } = i, l = s ?? 1, o = {
+      ...this.#f.defaults(e.type),
+      ...h,
+      ...this.#f.overrides(e.type)
+    }, u = e.create({ theme: this.#r, layerCount: l }, o), d = a ?? (typeof n == "string" ? [n] : void 0), c = this.#lt(r);
+    return u.onDataChanged?.(() => this.onDataChanged()), this.#t.push({ id: c, labels: d, renderer: u, visible: !0 }), this.#A = null, this.emit("seriesChange"), this.#b(), c;
+  }
+  /** Remove a series by ID and clean up its resources. */
+  removeSeries(t) {
+    const i = this.#t.findIndex((e) => e.id === t);
+    i >= 0 && (this.#t[i].renderer.dispose(), this.#t.splice(i, 1), this.#A = null, this.#i.markDirty(), this.emit("seriesChange"), this.#b());
+  }
+  // --- Markers (point annotations) -----------------------------------------
+  /**
+   * Pin a point annotation to `time` (X) and `value` (Y), or to a series via
+   * `seriesId` (Y snaps to the nearest data point at `time`). Returns the marker
+   * id for later {@link updateMarker} / {@link removeMarker}.
+   *
+   * Markers render on the overlay layer and stay out of the series model — they
+   * are excluded from tooltips, the legend, and the Y-range autoscale, and never
+   * appear in series queries.
+   */
+  addMarker(t) {
+    const i = `marker_${++dt}`;
+    return this.#m.push(this.#et(i, t)), this.#l.markDirty(), i;
+  }
+  /** Replace a marker's config in place. No-op when the id is unknown. */
+  updateMarker(t, i) {
+    const e = this.#m.findIndex((s) => s.id === t);
+    e !== -1 && (this.#m[e] = this.#et(t, i), this.#l.markDirty());
+  }
+  /** Remove a marker by id. No-op when the id is unknown. */
+  removeMarker(t) {
+    const i = this.#m.findIndex((e) => e.id === t);
+    i !== -1 && (this.#m.splice(i, 1), this.#l.markDirty());
+  }
+  /** Read-only snapshot of the registered markers (normalized). Mutate via add / update / removeMarker. */
+  getMarkers() {
+    return this.#m;
+  }
+  #et(t, i) {
+    return {
+      id: t,
+      time: g(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. */
+  #ct(t) {
+    if (t.value !== void 0 && Number.isFinite(t.value)) return t.value;
+    if (t.seriesId === void 0) return null;
+    const i = this.getDataAtTime(t.seriesId, t.time);
+    return i ? "close" in i ? i.close : i.value : null;
+  }
+  /** Resolve a marker's color: explicit `color`, else the series color, else the theme line color. */
+  #dt(t) {
+    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;
+  }
+  #mt(t) {
+    if (this.#m.length === 0) return;
+    const i = performance.now() / (N * 2 * Math.PI) % 1;
+    for (const e of this.#m) {
+      const s = this.#ct(e);
+      s !== null && Q({
+        scope: t,
+        timeScale: this.timeScale,
+        yScale: this.yScale,
+        theme: this.#r,
+        marker: {
+          time: e.time,
+          value: s,
+          color: this.#dt(e),
+          shape: e.shape,
+          pulse: e.pulse,
+          label: e.label
+        },
+        phase: i
+      });
+    }
+  }
+  // --- Time regions (shaded bands) -----------------------------------------
+  /**
+   * Shade the time interval `[from, to]` with a translucent vertical band —
+   * an anomaly window, a maintenance window, a highlighted session. Omit `to`
+   * (or pass `'now'`) for an open-ended band that extends to the right edge of
+   * the plot — the "still firing" case. Returns the region id for later
+   * {@link updateRegion} / {@link removeRegion}.
+   *
+   * Regions render on the main layer *behind* the series and stay out of the
+   * series model — they never affect the Y-range autoscale, tooltips, or the
+   * legend.
+   */
+  addRegion(t) {
+    const i = `region_${++mt}`;
+    return this.#v.push(this.#st(i, t)), this.#i.markDirty(), i;
+  }
+  /** Replace a region's config in place. No-op when the id is unknown. */
+  updateRegion(t, i) {
+    const e = this.#v.findIndex((s) => s.id === t);
+    e !== -1 && (this.#v[e] = this.#st(t, i), this.#i.markDirty());
+  }
+  /** Remove a region by id. No-op when the id is unknown. */
+  removeRegion(t) {
+    const i = this.#v.findIndex((e) => e.id === t);
+    i !== -1 && (this.#v.splice(i, 1), this.#i.markDirty());
+  }
+  /** Read-only snapshot of the registered regions (normalized). Mutate via add / update / removeRegion. */
+  getRegions() {
+    return this.#v;
+  }
+  #st(t, i) {
+    const { to: e } = i, s = e === void 0 || e === "now" ? null : g(e);
+    return {
+      id: t,
+      from: g(i.from),
+      to: s,
+      fill: i.fill,
+      color: i.color,
+      label: i.label
+    };
+  }
+  #ut(t, i, e) {
+    if (this.#v.length !== 0)
+      for (const s of this.#v) {
+        const { color: r, fill: n } = it(s, this.#r);
+        et({
+          scope: t,
+          timeScale: this.timeScale,
+          theme: this.#r,
+          region: { from: s.from, to: s.to, fill: n, color: r, label: s.label },
+          plotWidth: i,
+          plotHeight: e
+        });
+      }
+  }
+  // --- Reference lines (thresholds / event boundaries) ---------------------
+  /**
+   * Draw a reference line across the plot — a horizontal threshold / baseline
+   * pinned to a `value`, or a vertical event boundary pinned to a `time`
+   * (mutually exclusive). Returns the line id for later {@link updateLine} /
+   * {@link removeLine}.
+   *
+   * Lines render on the overlay layer *above* the series and stay out of the
+   * series model — they never affect the Y-range autoscale, tooltips, or the
+   * legend.
+   */
+  addLine(t) {
+    const i = `line_${++ut}`;
+    return this.#g.push(this.#rt(i, t)), this.#l.markDirty(), i;
+  }
+  /** Replace a reference line's config in place. No-op when the id is unknown. */
+  updateLine(t, i) {
+    const e = this.#g.findIndex((s) => s.id === t);
+    e !== -1 && (this.#g[e] = this.#rt(t, i), this.#l.markDirty());
+  }
+  /** Remove a reference line by id. No-op when the id is unknown. */
+  removeLine(t) {
+    const i = this.#g.findIndex((e) => e.id === t);
+    i !== -1 && (this.#g.splice(i, 1), this.#l.markDirty());
+  }
+  /** Read-only snapshot of the registered reference lines (normalized). Mutate via add / update / removeLine. */
+  getLines() {
+    return this.#g;
+  }
+  #rt(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 };
+  }
+  #ft(t, i, e) {
+    if (this.#g.length !== 0)
+      for (const s of this.#g)
+        tt({
+          scope: t,
+          timeScale: this.timeScale,
+          yScale: this.yScale,
+          theme: this.#r,
+          line: {
+            orientation: s.orientation,
+            coord: s.coord,
+            color: s.color ?? this.#r.line.color,
+            style: s.style,
+            width: s.width,
+            label: s.label
+          },
+          plotWidth: i,
+          plotHeight: e
+        });
+  }
+  /**
+   * Read-only snapshot of the chart's X / Y viewport animation. The same
+   * shape (`xRange`, `yRange`, `animating`) every frame — call this inside
+   * the current render pass rather than caching the reference, as the
+   * underlying animator mutates between frames.
+   */
+  getAnimationState() {
+    return this.#e.getAnimationState();
+  }
+  /**
+   * Replace all data for a series.
+   *
+   * - Single-layer series (candlestick, single-layer line/bar, pie): pass `data` directly.
+   * - Multi-layer series (line/bar with multiple layers): pass `layerIndex` to target a specific layer.
+   *
+   * For line/bar accepts `TimePointInput[]` (time may be `Date`); for candlestick accepts `OHLCInput[]`;
+   * for pie accepts `PieSliceData[]`. Time fields are normalized internally.
+   */
+  setSeriesData(t, i, e) {
+    const s = this.#t.find((r) => r.id === t);
+    s && (this.#$ = !0, s.renderer.setData(i, e));
+  }
+  /** Append a new data point to the end of a series (real-time tick). */
+  appendData(t, i, e) {
+    const s = this.#t.find((r) => r.id === t);
+    s === void 0 || s.renderer.appendPoint === void 0 || s.renderer.appendPoint(i, e);
+  }
+  /** Update the last data point of a series in place (e.g. live candle update). */
+  updateData(t, i, e) {
+    this.#t.find((s) => s.id === t)?.renderer.updateLastPoint?.(i, e);
+  }
+  /**
+   * Keep only the most recent `count` points of a series — drop the oldest
+   * tail when the series exceeds the cap. Smooth Y-range chase (no snap):
+   * unlike {@link setSeriesData}, this does NOT set the bulk-replace snap
+   * flag, so streaming windows can roll without per-tick Y jitter.
+   *
+   * Idempotent: a no-op when the series is already at or below `count`.
+   * Use after {@link appendData} in a rolling-window stream:
+   * ```ts
+   * chart.appendData('feed', point);
+   * chart.keepLast('feed', 100);
+   * ```
+   */
+  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(t, i) {
+    const e = this.#t.find((o) => o.id === t);
+    if (!e) return;
+    const s = e.labels, r = e.renderer.getLayerColors().slice(), n = this.#f.overrides(e.renderer.kind);
+    e.renderer.updateOptions({ ...i, ...n }), "label" in i && typeof i.label == "string" && (e.labels = [i.label]), this.#i.markDirty();
+    const a = e.renderer.getLayerColors(), h = r.length !== a.length || r.some((o, u) => o !== a[u]), l = !I(s, e.labels);
+    (h || l) && this.#b();
+  }
+  /**
+   * Batch multiple updates: suppress recomputes until `fn` returns. Exceptions
+   * inside `fn` still flush the batch so counters don't leak across calls.
+   */
+  batch(t) {
+    this.#w++;
+    try {
+      t();
+    } finally {
+      if (--this.#w <= 0) {
+        if (this.#w = 0, this.#O)
+          this.#O = !1, this.#C = !1, this.onDataChanged();
+        else if (this.#C) {
+          this.#C = !1, this.#u = !0;
+          const i = performance.now();
+          this.#e.onAxisReconfig(i), this.#p(i), this.#i.markDirty();
+        }
+        this.#Y && (this.#Y = !1, this.emit("overlayChange"));
+      }
+    }
+  }
+  /** Show or hide a series. The series cross-fades over
+   *  `animations.toggle`; the Y range re-fits on the same schedule
+   *  (one-shot duration override) so the fade and the axis adjustment
+   *  finish on the same frame. Hidden series are excluded from Y-range
+   *  computation immediately so the axis can start moving while the line
+   *  fades out in parallel.
+   */
+  setSeriesVisible(t, i) {
+    const e = this.#t.find((n) => n.id === t);
+    if (!e || e.visible === i) return;
+    e.visible = i, this.#b();
+    const s = this.#f.toggleMs;
+    if (e.renderer.setAlpha?.(i ? 1 : 0, s), this.#i.markDirty(), this.#w > 0) {
+      this.#C = !0;
+      return;
+    }
+    this.#u = !0;
+    const r = performance.now();
+    this.#e.onSeriesVisibilityChanged(r), this.#p(r);
+  }
+  /**
+   * Whether streaming ticks slide the visible range to track the data tail.
+   * Flipped off by a pan that pushes the tail off screen; re-engaged when
+   * a follow-up pan brings the tail back into the destination window or
+   * when {@link fitContent} / {@link setVisibleRange} commits a range
+   * containing the tail.
+   */
+  getAutoScroll() {
+    return this.#y;
+  }
+  isSeriesVisible(t) {
+    return this.#t.find((i) => i.id === t)?.visible ?? !0;
+  }
+  /**
+   * Show or hide a specific layer within a multi-layer series.
+   *
+   * Symmetric with {@link setSeriesVisible}: drives both the renderer's
+   * per-layer alpha fade and the engine's Y re-fit through `toggleMs` so the
+   * line fade and the axis adjustment finish on the same frame. Hidden layers
+   * are excluded from Y-range computation immediately (via the renderer's
+   * `getValueRange` reading `store.isVisible()`); the alpha fade keeps the
+   * layer's geometry on screen until the engine's Y ease settles.
+   */
+  setLayerVisible(t, i, e) {
+    const s = this.#t.find((a) => a.id === t);
+    if (!s || s.renderer.getLayerCount() <= 1 || s.renderer.isLayerVisible(i) === e) return;
+    s.renderer.setLayerVisible(i, e), this.#b();
+    const r = this.#f.toggleMs;
+    if (s.renderer.setLayerAlpha?.(i, e ? 1 : 0, r), this.#i.markDirty(), this.#w > 0) {
+      this.#C = !0;
+      return;
+    }
+    this.#u = !0;
+    const n = performance.now();
+    this.#e.onSeriesVisibilityChanged(n), this.#p(n);
+  }
+  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: t, last: i } = this.getDataBounds();
+    if (t === void 0 || i === void 0) return;
+    const e = this.#n.size.media.width - this.yAxisWidth;
+    this.#R(t, i, e), this.#H({ xEase: !0 });
+  }
+  getVisibleRange() {
+    return this.#o.from === 0 && this.#o.to === 0 ? this.#e.getAnimationState().xRange : this.#o;
+  }
+  /**
+   * Return the full span of registered data, or `null` before any data has
+   * arrived. `{ from: dataStart, to: dataEnd }` mirrors the chart's own
+   * tracking and is cheaper than recomputing from series stores.
+   */
+  getDataRange() {
+    return this.#k === null || this.#s === null ? null : { from: this.#k, to: this.#s };
+  }
+  /**
+   * Imperatively set the visible time range. Three forms:
+   *
+   * - `number N` — show the last N bars from the data tail (anchor right).
+   *   Resolved against current data bounds and data interval; keeps
+   *   auto-scroll on. No-op if data hasn't loaded yet.
+   * - `{ from, to }` — explicit time range. `from`/`to` accept either
+   *   epoch milliseconds or `Date`. Cancels any in-flight animation and
+   *   applies immediately. Auto-scroll stays on only if the tail is
+   *   inside the new range (mirrors pan semantics).
+   * - `{ from, bars }` — anchor the visible window at `from` and extend
+   *   right by `bars` data intervals. Useful for warm-up windows where
+   *   seed points sit on the left and a stream fills the gap on the
+   *   right. `from` accepts a `Date` too.
+   *
+   * Typical use: on mount, zoom to the last N bars while keeping the full
+   * buffer available for pan-back history inspection.
+   *
+   * `opts.gesture` (explicit `{ from, to }` form only) eases X and Y on the
+   * same fast, velocity-matched profile a user pan/zoom uses instead of the
+   * default programmatic settle (snap X, sticky-Y ease). Use it for
+   * multi-chart sync so a synced pane tracks the originating gesture in
+   * lockstep rather than lagging behind on the long sticky contract.
+   */
+  setVisibleRange(t, i) {
+    if (typeof t == "number") {
+      if (!Number.isInteger(t) || t < 2) return;
+      const { first: n, last: a } = this.getDataBounds();
+      if (n === void 0 || a === void 0) return;
+      const h = Math.max(n, a - (t - 1) * this.#a), l = this.#n.size.media.width - this.yAxisWidth;
+      this.#R(h, a, l), this.#H();
+      return;
+    }
+    if ("bars" in t) {
+      if (!Number.isInteger(t.bars) || t.bars < 2) return;
+      const n = g(t.from), a = n + t.bars * this.#a;
+      this.#y = this.#s !== null && this.#s >= n && this.#s <= a, this.#T({ from: n, to: a }, { emitChange: !0 }), this.#L = !0, this.#H();
+      return;
+    }
+    const e = g(t.from), s = g(t.to);
+    this.#y = this.#s !== null && this.#s >= e && this.#s <= s, this.#L = !1;
+    const r = this.#T({ from: e, to: s }, { emitChange: !0 });
+    if (i?.gesture) {
+      r && this.#vt();
+      return;
+    }
+    this.#H();
+  }
+  getYRange() {
+    return this.#V;
+  }
+  getCrosshairPosition() {
+    return this.#d;
+  }
+  /**
+   * Programmatically set or clear the crosshair. Same effect as the user
+   * hovering over `(timeToX(time), valueToY(y))` — emits `crosshairMove`,
+   * marks the overlay layer dirty, and lets `<Crosshair>` / `<Tooltip>`
+   * react via their normal store subscriptions.
+   *
+   * Pass `null` to clear (mirrors the pointer-leave path).
+   *
+   * `y` is optional. Resolution order when omitted:
+   *   1. **current crosshair's y** — preserves whatever the chart already
+   *      has (real cursor y, or a previously-synthesised value). This is
+   *      what makes the cross-chart broadcast pattern work: when an echo
+   *      arrives at the chart that originated the hover, the existing y
+   *      stays in place and the idempotency check below short-circuits the
+   *      loop. Without preservation, the echo would overwrite the source's
+   *      real cursor y with the midpoint default and the tooltip would
+   *      jitter between cursor and midpoint every mouse-move.
+   *   2. **midpoint of the current Y range** — fallback when there is no
+   *      current crosshair (first programmatic set on a chart that hasn't
+   *      been hovered yet).
+   *
+   * Idempotent: a call that produces the same `(time, y)` pair as the
+   * 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(t) {
+    if (t === null) {
+      if (this.#d === null) return;
+      this.#d = null, this.#l.markDirty(), this.emit("crosshairMove", null);
+      return;
+    }
+    const { time: i } = t;
+    if (!Number.isFinite(i)) return;
+    const e = this.#d;
+    let s;
+    if (t.y !== void 0)
+      s = t.y;
+    else if (e !== null)
+      s = e.y;
+    else {
+      const a = this.#V;
+      s = (a.min + a.max) / 2;
+    }
+    if (!Number.isFinite(s) || e !== null && e.time === i && e.y === s) return;
+    const r = this.timeScale.timeToX(i), n = this.yScale.valueToY(s);
+    this.#F = "time", this.#d = { mediaX: r, mediaY: n, time: i, y: s }, this.#l.markDirty(), this.emit("crosshairMove", this.#d);
+  }
+  /** Get the last visible value and whether the absolute last point is on screen. */
+  getLastValue(t) {
+    return Y(t, this.#t, this.#e.getAnimationState().xRange);
+  }
+  /** Get the second-to-last value, useful for computing change. */
+  getPreviousClose(t) {
+    return B(t, this.#t);
+  }
+  getLastData(t) {
+    const i = this.#t.find((e) => e.id === t);
+    return !i || i.renderer.kind === "pie" ? null : i.renderer.getLastDataPoint();
+  }
+  /** Find the data point closest to the given timestamp within one data interval. */
+  getDataAtTime(t, i) {
+    const e = this.#t.find((s) => s.id === t);
+    return e ? e.renderer.getDataAtTime?.(i, this.#a) ?? null : null;
+  }
+  /**
+   * Get all layers' data at a given time for multi-layer series (Bar/Line
+   * with stacking). Each entry carries the owning `layerIndex` and the
+   * snapped sample time — callers must not derive layer identity from the
+   * array index, because hidden layers are filtered out.
+   */
+  getLayerSnapshots(t, i) {
+    const e = this.#t.find((s) => s.id === t);
+    return e?.visible ? e.renderer.getLayerSnapshots?.(i, this.#a) ?? null : null;
+  }
+  getSeriesIds() {
+    return this.#A || (this.#A = this.#t.map((t) => t.id)), this.#A.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.
+   */
+  #gt() {
+    for (const t of this.#t)
+      if (t.visible && t.renderer.kind !== "pie")
+        return !0;
+    return !1;
+  }
+  /**
+   * Filter `getSeriesIds()` by renderer type. `'pie'` returns pie series,
+   * `'time'` returns line/bar/candlestick.
+   *
+   * - `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(t, i) {
+    const e = i?.visibleOnly === !0, s = i?.singleLayerOnly === !0, r = [];
+    for (const n of this.#t) {
+      const a = n.renderer.kind === "pie";
+      if (t === "pie" && !a || t === "time" && a) continue;
+      const h = n.renderer.getLayerCount();
+      if (!(s && h > 1)) {
+        if (e) {
+          if (!n.visible) continue;
+          if (h > 1) {
+            let l = !1;
+            for (let o = 0; o < h; o++)
+              if (n.renderer.isLayerVisible(o)) {
+                l = !0;
+                break;
+              }
+            if (!l) continue;
+          }
+        }
+        r.push(n.id);
+      }
+    }
+    return r;
+  }
+  /**
+   * Cumulative top last-value for stacked series — the point a YLabel badge
+   * anchors to on the rendered stack head. Falls back to `getLastValue` for
+   * series without stacked concepts (Candlestick, single-layer Line/Bar).
+   * Returns `null` for unknown ids or empty series.
+   */
+  getStackedLastValue(t) {
+    return X(t, this.#t, this.#e.getAnimationState().xRange);
+  }
+  /**
+   * Per-layer last snapshots with each layer's own `time`. Returns `null`
+   * for single-layer renderers or when no visible layer has data. Used by
+   * overlay components that must display every layer in last-mode even
+   * when layers advance at different rates (ragged streams).
+   */
+  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
+   * renderer state without exporting a public `getRenderer(id)` (which would
+   * leak an implementation detail). Named to discourage use outside of tests.
+   *
+   * @internal
+   */
+  listSeriesForTest() {
+    return this.#t.map((t) => ({ id: t.id, renderer: t.renderer }));
+  }
+  /** Get the primary display color for a series. */
+  getSeriesColor(t) {
+    const i = this.#t.find((e) => e.id === t);
+    return i ? i.renderer.getLayerColors()[0] ?? this.#r.line.color : null;
+  }
+  /** The series' primary name (first layer). Used for single-layer overlays. */
+  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(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,
+   * legend, and info bar. Called by the framework wrappers as the carried
+   * per-layer labels in `data` change. No-ops (and skips the overlay bump) when
+   * the labels are unchanged, so it's safe to call on every data tick.
+   */
+  setSeriesLabels(t, i) {
+    const e = this.#t.find((s) => s.id === t);
+    !e || I(e.labels, i) || (e.labels = i, this.#b());
+  }
+  /**
+   * Set the per-layer color overrides carried in `data` (sparse — `undefined`
+   * leaves that layer on the theme base). A {@link ValueColor} per layer: a
+   * string (uniform) or a function of value (per bar / per segment). Handed to
+   * the renderer, which keeps them separate from the theme base so a theme swap
+   * preserves them. Called by the framework wrappers; no-ops when unchanged.
+   */
+  setLayerColors(t, i) {
+    const e = this.#t.find((s) => s.id === t);
+    !e || ft(e.colorOverrides, i) || (e.colorOverrides = i, e.renderer.setColorOverrides?.(i), this.#i.markDirty(), this.#b());
+  }
+  /** Get per-layer colors for a series. Returns null for single-layer non-bar/line series. */
+  getSeriesLayers(t) {
+    const i = this.#t.find((r) => r.id === t);
+    if (!i) return null;
+    const e = i.renderer.getLayerCount();
+    if (e <= 1) return null;
+    const s = i.renderer.getLayerColors();
+    return Array.from({ length: e }, (r, n) => ({ color: s[n % s.length] }));
+  }
+  /** Get all slices with computed colors and percentages. Returns null for series without slice data (e.g. candlestick, line, bar). */
+  getSliceInfo(t) {
+    return this.#t.find((i) => i.id === t)?.renderer.getSliceInfo?.(this.#r) ?? null;
+  }
+  /** Get hover info (label/value/percent/color) for the currently hovered element, or null. */
+  getHoverInfo(t) {
+    return this.#t.find((i) => i.id === t)?.renderer.getHoverInfo?.(this.#r) ?? null;
+  }
+  /** Apply a new theme and update series colors where appropriate. */
+  setTheme(t) {
+    const i = this.#r;
+    this.#r = t;
+    for (const e of this.#t)
+      e.renderer.applyTheme(t, i);
+    this.#i.markDirty(), this.#b();
+  }
+  getTheme() {
+    return this.#r;
+  }
+  /** Update axis configuration and re-render. */
+  setAxis(t) {
+    const i = this.yAxisWidth, e = this.xAxisHeight;
+    this.#I = t, this.#h = { min: t.y?.min, max: t.y?.max }, this.#u = !0;
+    const s = performance.now();
+    this.#e.onAxisReconfig(s), this.#p(s), (this.yAxisWidth !== i || this.xAxisHeight !== e) && this.syncScales(), this.#i.markDirty();
+  }
+  /**
+   * Apply label-density knobs driven by `<YAxis labelCount=… minLabelSpacing=…>`
+   * — kept separate from {@link setAxis} so component props don't force a
+   * Y-animation reset. Triggers a viewportChange + repaint so static charts
+   * react without waiting for pan/zoom.
+   */
+  setYAxisLabelDensity(t) {
+    let i = !1;
+    "labelCount" in t && (this.yScale.setLabelCount(t.labelCount ?? null), i = !0), "minLabelSpacing" in t && (this.yScale.setMinSpacing(t.minLabelSpacing ?? null), i = !0), i && (this.syncScales(), this.emit("viewportChange"), this.#i.markDirty());
+  }
+  /** Label-density knobs for the time axis — mirror of {@link setYAxisLabelDensity}. */
+  setTimeAxisLabelDensity(t) {
+    let i = !1;
+    "labelCount" in t && (this.timeScale.setLabelCount(t.labelCount ?? null), i = !0), "minLabelSpacing" in t && (this.timeScale.setMinSpacing(t.minLabelSpacing ?? null), i = !0), i && (this.syncScales(), this.emit("viewportChange"), this.#i.markDirty());
+  }
+  getMediaSize() {
+    return this.#n.size.media;
+  }
+  /** Returns layout metrics for the chart area, Y axis, and time axis. */
+  getLayout() {
+    const t = this.#n.size.media, i = this.yAxisWidth, e = this.xAxisHeight;
+    return {
+      chartArea: { x: 0, y: 0, width: t.width - i, height: t.height - e },
+      yAxisWidth: i,
+      xAxisHeight: e
+    };
+  }
+  getDataInterval() {
+    return this.#a;
+  }
+  /**
+   * Update viewport padding at runtime. Refits the visible time range to
+   * current data bounds **only when horizontal padding (left/right) changes**
+   * — vertical padding only affects the Y-range computation, so touching it
+   * shouldn't reset the user's zoom / auto-scroll state. This matters when
+   * a wrapper re-applies padding reactively (e.g. in response to a Title /
+   * InfoBar ResizeObserver).
+   */
+  setPadding(t) {
+    const i = this.#c;
+    this.#c = D(t);
+    const e = this.#c, s = !T(i.left, e.left) || !T(i.right, e.right), r = i.top !== e.top || i.bottom !== e.bottom;
+    if (s) {
+      const { first: n, last: a } = this.getDataBounds();
+      if (n !== void 0 && a !== void 0) {
+        const h = this.#n.size.media.width - this.yAxisWidth;
+        this.#R(n, a, h);
+      }
+    }
+    if (s || r) {
+      this.#u = !0;
+      const n = performance.now();
+      this.#e.onAxisReconfig(n), this.#p(n);
+    }
+    this.syncScales(), this.#i.markDirty(), r && this.emit("viewportChange");
+  }
+  /** Show or hide the background grid. Takes effect on the next render frame. */
+  setGrid(t) {
+    this.#E = t.visible, this.#i.markDirty();
+  }
+  /**
+   * Set the visual state for one side of the chart. Typically called in
+   * response to the `onEdgeReached` callback:
+   *   - `loading` while a history fetch is in flight,
+   *   - `no-data` once the fetch confirmed there's nothing more,
+   *   - `idle` when the host no longer wants any edge affordance.
+   * The state persists until replaced. `has-more` is accepted for API
+   * symmetry and currently renders identically to `idle`.
+   */
+  setEdgeState(t, i) {
+    this.#x[t] !== i && (this.#x[t] = i, this.#l.markDirty());
+  }
+  /** Read the current host-declared state for a given edge. */
+  getEdgeState(t) {
+    return this.#x[t];
+  }
+  /**
+   * Notify chart that a YLabel overlay is mounted / unmounted. Currently a
+   * no-op — placeholder for the right-padding reflow that will adjust the
+   * chart area to make room for the badge.
+   * TODO: implement reflow.
+   */
+  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.
+   */
+  #_(t) {
+    const i = this.#n.size, e = this.#c, s = {
+      top: e.top * i.verticalPixelRatio,
+      bottom: e.bottom * i.verticalPixelRatio
+    };
+    let r = !1;
+    for (const n of this.#t) {
+      if (!n.renderer.hitTest || !n.renderer.setHoverIndex) continue;
+      let a = -1;
+      if (t) {
+        const h = t.mediaX * i.horizontalPixelRatio, l = t.mediaY * i.verticalPixelRatio;
+        a = n.renderer.hitTest(h, l, i.bitmap.width, i.bitmap.height, s);
+      }
+      n.renderer.setHoverIndex(a) && (r = !0);
+    }
+    r && this.#i.markDirty();
+  }
+  /**
+   * 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.
+   */
+  #yt() {
+    const t = this.#d;
+    if (t === null) return;
+    const { from: i, to: e } = this.timeScale.getRange(), s = this.yScale.getRange(), r = Math.abs(e - i) * 1e-9, n = Math.abs(s.max - s.min) * 1e-9, a = 1e-6;
+    let h;
+    if (this.#F === "pointer") {
+      const l = this.timeScale.xToTime(t.mediaX), o = this.yScale.yToValue(t.mediaY);
+      if (!Number.isFinite(l) || !Number.isFinite(o) || Math.abs(l - t.time) <= r && Math.abs(o - t.y) <= n) return;
+      h = { mediaX: t.mediaX, mediaY: t.mediaY, time: l, y: o };
+    } else {
+      if (t.time < i || t.time > e) {
+        this.#d = null, this.#l.markDirty(), this.emit("crosshairMove", null), this.#_(null);
+        return;
+      }
+      const l = this.timeScale.timeToX(t.time), o = this.yScale.valueToY(t.y);
+      if (!Number.isFinite(l) || !Number.isFinite(o) || Math.abs(l - t.mediaX) <= a && Math.abs(o - t.mediaY) <= a) return;
+      h = { mediaX: l, mediaY: o, time: t.time, y: t.y };
+    }
+    this.#d = h, this.#l.markDirty(), this.emit("crosshairMove", h), this.#_(h);
+  }
+  /** Tear down the chart: cancel animations, remove listeners, and detach the canvas. */
+  destroy() {
+    for (const t of this.#t) t.renderer.dispose();
+    this.#t = [], this.#m = [], this.#v = [], this.#g = [], this.#A = null, this.#i.destroy(), this.#l.destroy(), this.#W?.destroy(), this.#n.destroy(), this.#X?.destroy(), this.#X = null, this.#B && this.#S?.destroy(), this.#S = null, this.#B = !1, this.removeAllListeners();
+  }
+  /** The attached performance monitor, or `null` when instrumentation is disabled. */
+  getPerfMonitor() {
+    return this.#S;
+  }
+  /** Compute the earliest and latest timestamps across all series. */
+  getDataBounds() {
+    let t, i;
+    for (const e of this.#t) {
+      if (!e.visible || e.renderer.kind === "pie") continue;
+      const s = e.renderer.getTimeBounds();
+      s !== null && ((t === void 0 || s.first < t) && (t = s.first), (i === void 0 || s.last > i) && (i = s.last));
+    }
+    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. */
+  #$ = !1;
+  onDataChanged() {
+    if (this.#w > 0) {
+      this.#O = !0;
+      return;
+    }
+    this.updateDataInterval();
+    const { first: t, last: i } = this.getDataBounds();
+    t !== void 0 && (this.#k = t), i !== void 0 && (this.#P = this.#s, this.#s = i);
+    const e = this.#$;
+    this.#$ = !1;
+    const s = !this.#u && t !== void 0;
+    e && (this.yScale.tickTracker.reset(), this.timeScale.tickTracker.reset()), this.#tt = e;
+    const r = performance.now();
+    e || s ? (this.#D.seed(r), this.#e.onDataReplaced(r)) : this.#e.onPointAppended(r), this.#e.lastXTarget !== null && (this.#M = !0), t !== void 0 && (this.#u = !0), this.#p(r), this.syncScales(), s ? this.#G() : this.#i.markDirty(), this.emit("dataUpdate"), this.#b();
+  }
+  updateDataInterval() {
+    for (const t of this.#t) {
+      if (t.renderer.kind === "pie") continue;
+      const i = t.renderer.sampleTimes(20);
+      if (i.length >= 2) {
+        this.#a = lt(i);
+        break;
+      }
+    }
+  }
+  /** Whether the Y range has been initialized (first snap vs smooth lerp).
+   *  Pre-init Y emits are forced to `instant` so the first paint snaps to
+   *  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;
+  /** Whether the engine's X slot has received its first emit. Pre-init X
+   *  emits are forced to `instant` so first paint snaps to the fitted
+   *  range — without this guard the engine would ease from `{0,0}` into
+   *  the new target and the very first frame would render with a
+   *  zero-width X domain. */
+  #M = !1;
+  /**
+   * One-shot `setVisibleRange` argument applied on the first data arrival.
+   * Captured at chart construction from {@link ChartOptions.viewport.initialRange};
+   * cleared the moment it's consumed so subsequent data swaps don't snap
+   * back to the initial window.
+   */
+  #N;
+  /** Last Y bounds the engine resolved into {@link AnimationState.yRange}.
+   *  Used by {@link renderMain} to detect Y movement frame-to-frame so
+   *  `viewportChange` only emits when the Y range actually shifted — DOM
+   *  axis labels subscribe to that event and re-renders on every tick are
+   *  expensive. Initialised to NaN so the first real Y emit always passes
+   *  the change check. */
+  #U = Number.NaN;
+  #Z = Number.NaN;
+  /**
+   * Sample the visible data window and return the resolved Y bounds, or
+   * `null` when no series has data inside the X destination range.
+   * Sampling runs against `logicalRange` (the X target, not the animating
+   * current), so Y stays on a stable target while X eases — both dimensions
+   * converge together. Clears {@link #yInited} on empty so the next emit
+   * with valid data lands as an instant snap.
+   */
+  #nt(t) {
+    const i = t ?? this.#o, e = this.#h.min !== void 0 && this.#h.min !== "auto" && typeof this.#h.min != "number" || this.#h.max !== void 0 && this.#h.max !== "auto" && typeof this.#h.max != "number" ? [] : null, s = q(i, this.#t, e);
+    if (s === null)
+      return this.#u = !1, null;
+    const r = M(this.#h.min, s.min, s.max, e ?? [], "min"), n = M(this.#h.max, s.max, s.min, e ?? [], "max");
+    return { min: r, max: n };
+  }
+  /**
+   * Engine pull-on-demand X target. Called by the engine's `computeXTarget`
+   * closure during `engine.onPointAppended` / `engine.onDataReplaced`.
+   * Reads `#dataStart` / `#dataEnd` (refreshed by `onDataChanged` just
+   * before the engine signal) plus `#pendingFitToData` flag, then dispatches:
+   *
+   * - **uninit (viewport never committed)** → fit to data, apply any
+   *   one-shot `initialVisibleRange`, return the new logical range.
+   *   First-paint fit.
+   * - **bulk replace + autoscroll** (`#pendingFitToData`) → fit to data,
+   *   return logical. `chart.setSeriesData(...)` lands here.
+   * - **streaming append + autoscroll** → `computeStreamingTarget` (preserves
+   *   any pan offset across ticks via `#prevDataEnd`). The engine's X spring
+   *   absorbs the new target — velocity carries across retargets so a burst
+   *   of ticks doesn't restart easing on each one.
+   * - **autoscroll off** → `null` (no X retarget; user has panned away
+   *   from the tail).
+   */
+  #pt() {
+    if (this.#k === null || this.#s === null) return null;
+    const { from: t, to: i } = this.#o, e = t === 0 && i === 0, s = this.#n.size.media.width - this.yAxisWidth;
+    if (e)
+      return this.#R(this.#k, this.#s, s), this.#N !== void 0 && (this.setVisibleRange(this.#N), this.#N = void 0), this.#o;
+    if (!this.#y) return null;
+    if (this.#tt)
+      return this.#R(this.#k, this.#s, s), this.#o;
+    const r = j({
+      currentLogical: this.#o,
+      lastTime: this.#s,
+      prevDataEnd: this.#P,
+      dataInterval: this.#a,
+      paddingRight: this.#c.right,
+      chartWidth: s,
+      holdUntilFilled: this.#L
+    });
+    return r.releaseHold && (this.#L = !1), r.reengageAutoScroll && (this.#y = !0), r.newLogical === null ? null : (this.#D.observe(performance.now()), this.#e.setXSettleMs(this.#D.pickSettleMs(this.#f.axis.x.settleMs)), this.#T(r.newLogical, { emitChange: !1, skipValidation: !0 }), this.#P = this.#s, r.newLogical);
+  }
+  /**
+   * Fit the viewport's logical X range around a data span. Mirrors the
+   * old `viewport.fitToData` side effects: clears the warm-up hold,
+   * forces autoscroll on (data tail is in the new window by construction),
+   * commits the new range via `viewport.setRange` (which emits `change`).
+   */
+  #R(t, i, e) {
+    const s = this.#c, r = O({
+      firstTime: t,
+      lastTime: i,
+      dataInterval: this.#a,
+      maxVisibleBars: this.#it,
+      chartWidth: e,
+      padding: { left: s.left, right: s.right }
+    });
+    this.#L = !1, this.#y = !0, this.#T(r, { emitChange: !0 });
+  }
+  /**
+   * Commit a programmatic zoom — `fitContent` or `setVisibleRange`. Reads
+   * the viewport's just-committed logical range as the X target; pulls
+   * the matching Y target via the engine's `computeYTarget` callback so
+   * the axis re-fits to the new window without the chart having to wire
+   * Y separately.
+   *
+   * - First paint (`#xInited` or `#yInited` not yet set) → both axes snap
+   *   so consumers reading `chart.getYRange()` / `chart.getVisibleRange()`
+   *   synchronously after mount see the final values.
+   * - Otherwise X snaps and Y eases on the sticky baseline. `fitContent`
+   *   passes `xEase: true` so X eases instead — viewport and axis converge
+   *   on the same frame.
+   */
+  #H(t) {
+    const i = this.#o;
+    if (i.to <= i.from) return;
+    const e = performance.now();
+    if (!this.#M || !this.#u) {
+      this.#at(e);
+      return;
+    }
+    this.#e.onProgrammaticZoom({ xTarget: i, xEase: t?.xEase }, e), this.#p(e);
+  }
+  /**
+   * Commit the current logical X to the engine on the *gesture* profile:
+   * X and Y both ease over `animations.axis.{x,y}.gesture` via `onPanZoom`,
+   * exactly the path a user pan/zoom takes. Contrast {@link
+   * #commitProgrammaticZoom}, which snaps X and eases Y on the slower
+   * sticky-Y baseline.
+   *
+   * Used by `setVisibleRange(..., { gesture: true })` for multi-chart sync,
+   * so a synced pane re-fits its Y in lockstep with the originating gesture
+   * instead of lagging on the long sticky contract. First paint still snaps
+   * (same as the programmatic path) so synchronous readers see final values.
+   */
+  #vt() {
+    const t = this.#o;
+    if (t.to <= t.from) return;
+    const i = performance.now();
+    if (!this.#M || !this.#u) {
+      this.#at(i);
+      return;
+    }
+    this.#e.onPanZoom({ xTarget: t, yAuto: !0 }, i), this.#p(i);
+  }
+  /**
+   * First-paint snap: land both axes on the current logical X immediately
+   * (Y via {@link #computeYTarget}) and flip the init flags so later commits
+   * ease instead of snapping. Shared by the programmatic and gesture zoom
+   * commits — both must snap before the chart has painted once so a
+   * synchronous `getYRange()` / `getVisibleRange()` read sees final values.
+   */
+  #at(t) {
+    const i = this.#o, e = this.#nt(i);
+    this.#M = !0, e !== null && (this.#u = !0), this.#e.snap({ x: i, y: e ?? void 0 }, t), this.#p(t);
+  }
+  /**
+   * Validate and commit a new logical X range. Mirrors the old
+   * `Viewport.applyLogical` contract: silently no-ops on invalid input
+   * (`to <= from`, fewer than 2 bars), then writes `#logical` and (if
+   * `opts.emitChange` is true) wakes the render loop + emits
+   * `viewportChange` for DOM subscribers.
+   *
+   * Streaming-target writes pass `emitChange: false` because the engine
+   * drives the animation: `engine.onWake` already markedDirty, and the
+   * follow-up `renderMain` syncs scales — a redundant `viewportChange`
+   * emit here would just trigger a wasted React re-render per stream tick.
+   *
+   * Returns `true` when the range actually changed (passed validation and
+   * differed from the current logical), `false` on a no-op. Callers that
+   * drive the engine afterwards can skip a redundant retarget on `false` —
+   * see `setVisibleRange`'s gesture path, where a per-frame echo would
+   * otherwise re-arm and stall the in-flight Y ease.
+   */
+  #T(t, i) {
+    const { from: e, to: s } = t;
+    return !Number.isFinite(e) || !Number.isFinite(s) || s <= e || !i.skipValidation && (s - e) / this.#a < 2 || this.#o.from === e && this.#o.to === s ? !1 : (this.#o = { from: e, to: s }, i.emitChange && (this.syncScales(), this.#i?.markDirty(), this.emit("viewportChange")), !0);
+  }
+  /**
+   * Apply pixel-padding to the engine's raw Y target and store the
+   * result in `#yRange`. Mirrors the old `Viewport.setYRange` contract:
+   * symmetric pad top / bottom from `#padding`, suppressed on the side
+   * that has an explicit (fixed) axis bound.
+   */
+  #ht(t, i, e, s, r) {
+    const n = i - t, a = e > 0 ? this.#c.top / e * n : 0, h = e > 0 ? this.#c.bottom / e * n : 0;
+    this.#V = {
+      min: s ? t : t - h,
+      max: r ? i : i + a
+    };
+  }
+  /**
+   * Shift the visible time range by `timeDelta` ms. Hard-clamped so at
+   * least one data point stays on screen — no rubber-band, no overshoot.
+   * A pan that moves the viewport off the live-tail position flips
+   * autoscroll off. Fires `edgeReached` whenever the clamp trims the
+   * gesture (i.e., the user pushed past the boundary), so consumers can
+   * trigger history loads. Forwards the committed target to the engine
+   * as a gesture for visual easing. Public so consumers can drive pan
+   * programmatically.
+   */
+  pan(t, i = this.#z) {
+    i > 0 && (this.#z = i), this.#L = !1;
+    const e = U({
+      currentLogical: this.#o,
+      timeDelta: t,
+      chartWidth: i,
+      dataInterval: this.#a,
+      padding: { left: this.#c.left, right: this.#c.right },
+      dataStart: this.#k,
+      dataEnd: this.#s
+    });
+    e.newLogical !== null && (this.#y = !e.autoScrollOff, this.#T(e.newLogical, { emitChange: !0 }), e.edgeReached !== null && (this.#J[e.edgeReached.side] = e.edgeReached.boundaryTime, this.#K?.(e.edgeReached)), this.#D.pause(), this.#ot());
+  }
+  /**
+   * Zoom around a time anchor. `factor < 1` zooms in, `> 1` zooms out.
+   * In historical mode the window anchors to `centerTime` (cursor-driven).
+   * Zoom-out is hard-capped at the padded data span. Forwards the committed
+   * target to the engine as a gesture for visual easing. Public so consumers
+   * can drive zoom programmatically.
+   *
+   * Sticky-follow: while `#autoScroll` is on, the new window is repositioned
+   * so its right edge sits at `dataEnd + paddingRight` (follow position).
+   * Span (zoom level) from `computeZoom` is preserved; only the position
+   * is locked to the tail. This avoids the next-tick `computeStreamingTarget`
+   * offset clamp (which would otherwise slide X left to the follow position
+   * and produce a visible jump). Cursor-anchored zoom is intentionally
+   * sacrificed in follow-live mode — pan first to inspect history.
+   */
+  zoomAt(t, i, e = this.#z) {
+    e > 0 && (this.#z = e), this.#L = !1;
+    const s = Z({
+      currentLogical: this.#o,
+      centerTime: t,
+      factor: i,
+      chartWidth: e,
+      dataInterval: this.#a,
+      padding: { left: this.#c.left, right: this.#c.right },
+      dataStart: this.#k,
+      dataEnd: this.#s
+    });
+    if (s.newLogical === null) return;
+    let r = s.newLogical;
+    if (this.#y && this.#s !== null) {
+      const n = r.to - r.from, a = C(this.#c.right, n, this.#a, e), h = this.#s + a;
+      r = { from: h - n, to: h }, this.#P = this.#s;
+    }
+    this.#T(r, { emitChange: !0 }), this.#D.pause(), this.#ot();
+  }
+  /**
+   * Common tail for `pan` / `zoomAt`: routes the just-committed `#logical`
+   * to the engine as a gesture so the X spring retargets and the Y spring
+   * eases over `animations.axis.y.gesture`.
+   */
+  #ot() {
+    const t = this.#o;
+    if (t.to <= t.from) return;
+    this.#M = !0, this.#u = !0;
+    const i = performance.now();
+    this.#e.onPanZoom({ xTarget: t, yAuto: !0 }, i), this.#p(i);
+  }
+  /**
+   * Tick the engine at the given wall clock and push the resolved X / Y
+   * ranges into the viewport + scales. Called from every emit path so that
+   * synchronous readers (`chart.getYRange()`, `chart.getVisibleRange()`
+   * immediately after `setSeriesData` / `setSeriesVisible`) see the new
+   * values without waiting for the next RAF — matches the legacy contract
+   * pinned by `data-update-sync`, `visibility-batch`, and the `y-label`
+   * repositioning tests.
+   *
+   * The caller passes the same wall it used as the event's `startWall` so
+   * `effectiveNow === startWall` and the prune step keeps zero-duration
+   * events long enough for the slot processor to snap them.
+   */
+  #p(t) {
+    const i = this.#e.tick(t), e = this.#n.size;
+    if (e.media.width === 0 || e.media.height === 0) return;
+    const s = this.#h.min !== void 0 && this.#h.min !== "auto", r = this.#h.max !== void 0 && this.#h.max !== "auto", n = e.media.height - this.xAxisHeight;
+    this.#ht(i.yRange.min, i.yRange.max, n, s, r), this.#U = i.yRange.min, this.#Z = i.yRange.max, this.syncScales();
+  }
+  /**
+   * Lightweight scale sync: updates timeScale/yScale from current viewport state
+   * without advancing the Y smoothing animation. Called from the viewport 'change'
+   * handler, so DOM axis components always read fresh coordinates on re-render.
+   */
+  syncScales() {
+    const t = this.#n.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,
+      i,
+      t.horizontalPixelRatio,
+      this.#a
+    ), this.yScale.update(this.#V, e, t.verticalPixelRatio);
+  }
+  /** Expensive: background, grid, all series. Only on data/viewport/resize change. */
+  renderMain(t) {
+    const i = this.#n.size;
+    if (i.media.width === 0 || i.media.height === 0) return;
+    const e = typeof t == "number" ? t : performance.now(), s = this.#e.tick(e);
+    s.animating && this.#i.markDirty();
+    const r = s.yRange.min, n = s.yRange.max, a = r !== this.#U || n !== this.#Z;
+    if (a) {
+      const d = this.#h.min !== void 0 && this.#h.min !== "auto", c = this.#h.max !== void 0 && this.#h.max !== "auto", f = i.media.height - this.xAxisHeight;
+      this.#ht(r, n, f, d, c), this.#U = r, this.#Z = n;
+    }
+    if (this.syncScales(), this.#yt(), this.#s !== null && !this.#y) {
+      const d = this.#e.lastXTarget ?? this.#o, c = d.to - d.from;
+      if (c > 0) {
+        const f = this.#n.size.media.width - this.yAxisWidth, p = C(this.#c.right, c, this.#a, f), v = this.#a * 0.5;
+        Math.abs(d.to - (this.#s + p)) < v && (this.#y = !0);
+      }
+    }
+    a && this.emit("viewportChange");
+    let h = !1, l = !1;
+    this.#n.useMainLayer((d) => {
+      const { context: c, bitmapSize: f } = d, p = (i.media.width - this.yAxisWidth) * i.horizontalPixelRatio, v = (i.media.height - this.xAxisHeight) * i.verticalPixelRatio;
+      c.clearRect(0, 0, f.width, f.height), c.save(), c.beginPath(), c.rect(0, 0, p, v), c.clip(), this.yScale.tickTracker.setCurrentTicks(this.yScale.niceTickValues()), this.timeScale.tickTracker.setCurrentTicks(this.timeScale.niceTickValues(this.#a).ticks), this.yScale.tickTracker.tick(e), this.timeScale.tickTracker.tick(e);
+      const b = this.yScale.tickTracker.snapshot(), x = this.timeScale.tickTracker.snapshot();
+      h = b.isAnimating, l = x.isAnimating, (b.isAnimating || x.isAnimating || s.animating) && this.emit("tickFrame"), this.#E && K({
+        scope: d,
+        timeScale: this.timeScale,
+        yScale: this.yScale,
+        theme: this.#r,
+        yTicks: b,
+        timeTicks: x
+      }), this.#ut(d, p, v);
+      const k = this.#c, P = { top: k.top, bottom: k.bottom }, w = this.#S;
+      for (const y of this.#t) {
+        const S = y.renderer.getAlpha?.() ?? (y.visible ? 1 : 0);
+        if (S <= 0) continue;
+        const L = {
+          scope: d,
+          timeScale: this.timeScale,
+          yScale: this.yScale,
+          theme: this.#r,
+          dataInterval: this.#a,
+          padding: P,
+          state: s,
+          seriesId: y.id
+        }, A = c.globalAlpha;
+        if (S < 1 && (c.globalAlpha = A * S), w) {
+          const V = performance.now();
+          y.renderer.render(L), w.recordSeries(y.id, performance.now() - V, e);
+        } else
+          y.renderer.render(L);
+        S < 1 && (c.globalAlpha = A);
+      }
+      c.restore();
+    });
+    let o = !1;
+    for (const d of this.#t)
+      if (d.renderer.needsAnimation) {
+        o = !0, this.#i.markDirty();
+        break;
+      }
+    const u = h || 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
+   * top so both land in the same browser paint. The overlay scheduler's
+   * queued frame (a crosshair move, the pulse re-arm from the previous
+   * frame) is consumed first — the synchronous paint below replaces it, so
+   * the overlay is no longer cleared + repainted twice in the same frame.
+   * `markDirty` calls made *during* `renderOverlay` (pulse, edge spinner)
+   * land after the consume and re-arm cleanly for the next frame.
+   */
+  #G(t) {
+    this.#j("main", t, () => this.renderMain(t)), this.#l.consume(), this.#j("overlay", t, () => this.renderOverlay(t));
+  }
+  /** Run a layer's paint, booking duration + draw calls to the perf monitor
+   *  when one is attached — keeps overlay time out of the `main` samples. */
+  #j(t, i, e) {
+    const s = this.#S;
+    if (!s) {
+      e();
+      return;
+    }
+    s.resetDrawCalls(t);
+    const r = performance.now();
+    e(), s.recordFrame(t, performance.now() - r, i ?? r);
+  }
+  /** Cheap overlay: crosshair, nearest-point dots, pulse animation, edge indicator. */
+  renderOverlay(t) {
+    const i = this.#n.size;
+    if (i.media.width === 0 || i.media.height === 0) return;
+    let e = !1;
+    for (const a of this.#t)
+      if (a.visible && a.renderer.overlayNeedsAnimation) {
+        e = !0;
+        break;
+      }
+    this.#m.some((a) => a.pulse) && (e = !0);
+    const s = this.#x.left === "loading" || this.#x.right === "loading", r = this.#x.left !== "idle" || this.#x.right !== "idle", n = !!this.#d || e || r || this.#m.length > 0 || this.#g.length > 0;
+    if (!(!n && !this.#q)) {
+      if (this.#q = n, this.#n.useOverlayLayer((a) => {
+        if (!n) return;
+        const h = (i.media.width - this.yAxisWidth) * i.horizontalPixelRatio, l = (i.media.height - this.xAxisHeight) * i.verticalPixelRatio;
+        if (a.context.save(), a.context.beginPath(), a.context.rect(0, 0, h, l), a.context.clip(), this.#d && this.#gt()) {
+          const c = this.#d.mediaX * i.horizontalPixelRatio, f = this.#d.mediaY * i.verticalPixelRatio;
+          J(a, c, f, this.#r);
+        }
+        const o = this.#c, u = { top: o.top, bottom: o.bottom }, d = this.#e.getAnimationState();
+        for (const c of this.#t)
+          c.visible && c.renderer.drawOverlay?.({
+            scope: a,
+            timeScale: this.timeScale,
+            yScale: this.yScale,
+            theme: this.#r,
+            dataInterval: this.#a,
+            padding: u,
+            crosshair: this.#d,
+            state: d,
+            seriesId: c.id
+          });
+        this.#ft(a, h, l), this.#mt(a), r && E({
+          scope: a,
+          chartMediaHeight: i.media.height - this.xAxisHeight,
+          timeScale: this.timeScale,
+          theme: this.#r,
+          edgeStates: this.#x,
+          resolveBoundary: (c) => F(c, this.#J[c], this.getDataBounds())
+        }), a.context.restore();
+      }), e) {
+        const { from: a, to: h } = this.timeScale.getRange();
+        let l = !1;
+        for (const o of this.#t)
+          if (!(!o.visible || !o.renderer.overlayNeedsAnimation) && (o.renderer.hasOverlayContentInRange?.(a, h) ?? !0)) {
+            l = !0;
+            break;
+          }
+        if (!l) {
+          for (const o of this.#m)
+            if (o.pulse && o.time >= a && o.time <= h) {
+              l = !0;
+              break;
+            }
+        }
+        l && this.#l.markDirty();
+      }
+      s && this.#l.markDirty();
+    }
+  }
+}
+export {
+  Ot as ChartInstance
+};