@363045841yyt/klinechart-core 0.8.11-alpha.0 → 0.8.12

package/dist/components/anchoredVwap/createAnchoredVwapController.js

@@ -0,0 +1,282 @@
+/**
+ * Anchored VWAP controller — framework-agnostic, signal-based, multi-anchor.
+ *
+ * Mirrors the dispose-guard pattern from
+ * `createIndicatorSelectorController` and `createVolumeProfileController` so
+ * React/Vue/Angular adapters bridge identically. The controller is pure
+ * data — no DOM, no rendering, no canvas.
+ *
+ * Why multi-anchor with per-anchor running sums:
+ *   TradingView's lower tiers cap the number of simultaneous anchors at
+ *   3 because each AVWAP is recomputed from scratch on every new bar. By
+ *   keeping per-anchor `sumVwp` / `sumVol` / `sumSqDev` totals we drop
+ *   `appendBar` from O(bars-since-anchor) to O(1) per anchor — anchors
+ *   become cheap enough to keep many open at once.
+ *
+ * Equivalence guarantee:
+ *   The point produced by `appendBar` is bit-for-bit identical (to
+ *   floating-point precision) to the point that `computeAnchoredVwap`
+ *   would produce on the same bar at the same anchor — same operands
+ *   added in the same order. The controller test
+ *   `appendBar incrementally matches full recompute` pins this.
+ */
+import { createSignal } from '../../reactivity';
+import { computeAnchoredVwap } from './computeAnchoredVwap';
+export function createAnchoredVwapController(opts) {
+    // -------------------------------------------------------------------
+    // Internal mutable state — never exposed directly.
+    // -------------------------------------------------------------------
+    // Defensive copy: the caller may reuse the array they pass us. We
+    // capture a snapshot so `appendBar` can extend it without surprising
+    // the caller.
+    let bars = opts?.initialBars
+        ? opts.initialBars.slice()
+        : [];
+    const anchorStates = new Map();
+    // -------------------------------------------------------------------
+    // Public signal — re-emitted on every structural change.
+    // -------------------------------------------------------------------
+    const anchors = createSignal([]);
+    /**
+     * Rebuild the public signal value from the current `anchorStates`. We
+     * pass a fresh array reference each time so `Object.is` in
+     * `signal.set` triggers a notify.
+     */
+    function publish() {
+        const next = [];
+        for (const a of anchorStates.values()) {
+            next.push({
+                definition: a.definition,
+                // Snapshot the series so consumers see an immutable
+                // view; future `appendBar` mutations on `a.series` will
+                // only be observed by the next `publish`.
+                series: a.series.slice(),
+            });
+        }
+        anchors.set(next);
+    }
+    // -------------------------------------------------------------------
+    // Math helpers — share one definition of the per-bar arithmetic so
+    // `appendBar` and `recomputeAnchor` cannot drift.
+    // -------------------------------------------------------------------
+    /**
+     * Recompute an anchor's series from scratch by walking the bars from
+     * `definition.barIndex`. Also resets the running sums so subsequent
+     * `appendBar` calls extend the same totals.
+     *
+     * `null` is a sentinel meaning "anchor is out of range for the
+     * current bars" — the caller drops a point-free entry.
+     */
+    function recomputeAnchor(state) {
+        const def = state.definition;
+        // Out-of-range anchor: leave the running sums at zero and emit an
+        // empty series. We deliberately do NOT throw — callers might be
+        // mid-stream and an out-of-range anchor is a valid transient
+        // state (e.g. user dragged the anchor past the loaded window).
+        if (bars.length === 0 ||
+            def.barIndex < 0 ||
+            def.barIndex >= bars.length) {
+            state.sumVwp = 0;
+            state.sumVol = 0;
+            state.sumSqDev = 0;
+            state.series = [];
+            return;
+        }
+        // Use the shared pure function so behaviour stays identical.
+        const series = computeAnchoredVwap(bars, def.barIndex, def.includeBands);
+        // Reconstruct the running sums by replaying the same arithmetic
+        // — we need them for the next `appendBar`. This is the only
+        // place where the controller duplicates the math; the cost is
+        // unavoidable because `computeAnchoredVwap` does not expose its
+        // internal sums.
+        let sumVwp = 0;
+        let sumVol = 0;
+        let sumSqDev = 0;
+        for (let i = def.barIndex; i < bars.length; i++) {
+            const bar = bars[i];
+            if (bar === undefined)
+                continue;
+            const v = bar.volume;
+            if (v > 0) {
+                const tp = (bar.high + bar.low + bar.close) / 3;
+                sumVwp += tp * v;
+                sumVol += v;
+                // Prevailing AVWAP at this bar — same operands as the
+                // pure function, same addition order.
+                if (def.includeBands && sumVol > 0) {
+                    const vwap = sumVwp / sumVol;
+                    const diff = tp - vwap;
+                    sumSqDev += diff * diff * v;
+                }
+            }
+        }
+        state.sumVwp = sumVwp;
+        state.sumVol = sumVol;
+        state.sumSqDev = sumSqDev;
+        state.series = series.slice();
+    }
+    /**
+     * Extend an anchor's series by one bar incrementally — O(1) per call.
+     * The new bar's absolute index in `bars` is the caller's
+     * responsibility to compute; we take it as a parameter so
+     * `appendBar` can be straight-line.
+     */
+    function extendAnchorByOne(state, bar, absIndex) {
+        const def = state.definition;
+        // Skip anchors that haven't started yet (anchor is in the future
+        // relative to this new bar).
+        if (absIndex < def.barIndex)
+            return;
+        // Skip anchors with no anchor inside the loaded window.
+        if (def.barIndex < 0)
+            return;
+        const v = bar.volume;
+        const tp = (bar.high + bar.low + bar.close) / 3;
+        if (v > 0) {
+            state.sumVwp += tp * v;
+            state.sumVol += v;
+        }
+        let vwap = Number.NaN;
+        if (state.sumVol > 0) {
+            vwap = state.sumVwp / state.sumVol;
+        }
+        // Bands: prevailing AVWAP at this bar — same arithmetic as
+        // `recomputeAnchor` and `computeAnchoredVwap`.
+        if (def.includeBands &&
+            v > 0 &&
+            state.sumVol > 0 &&
+            Number.isFinite(vwap)) {
+            const diff = tp - vwap;
+            state.sumSqDev += diff * diff * v;
+        }
+        let upper1 = vwap;
+        let lower1 = vwap;
+        let upper2 = vwap;
+        let lower2 = vwap;
+        if (def.includeBands &&
+            state.sumVol > 0 &&
+            Number.isFinite(vwap)) {
+            const variance = state.sumSqDev / state.sumVol;
+            const stdDev = Math.sqrt(variance > 0 ? variance : 0);
+            upper1 = vwap + stdDev;
+            lower1 = vwap - stdDev;
+            upper2 = vwap + 2 * stdDev;
+            lower2 = vwap - 2 * stdDev;
+        }
+        state.series.push({
+            barIndex: absIndex,
+            vwap,
+            upper1,
+            lower1,
+            upper2,
+            lower2,
+            cumulativeVolume: state.sumVol,
+        });
+    }
+    // -------------------------------------------------------------------
+    // Lifecycle — kick off any initial anchors (none today, but reserved).
+    // -------------------------------------------------------------------
+    if (bars.length > 0) {
+        // No anchors yet — publish empty so subscribers see a defined
+        // starting value.
+        publish();
+    }
+    // -------------------------------------------------------------------
+    // Public mutators
+    // -------------------------------------------------------------------
+    function setBars(nextBars) {
+        bars = nextBars.slice();
+        for (const state of anchorStates.values()) {
+            recomputeAnchor(state);
+        }
+        publish();
+    }
+    function addAnchor(def) {
+        // Replace-in-place on id collision. The brief allows either
+        // semantics; we choose replace because UIs that drag an anchor
+        // onto an existing one expect the existing one to update, not
+        // to throw.
+        const state = {
+            definition: { ...def },
+            sumVwp: 0,
+            sumVol: 0,
+            sumSqDev: 0,
+            series: [],
+        };
+        recomputeAnchor(state);
+        anchorStates.set(def.id, state);
+        publish();
+        return def.id;
+    }
+    function removeAnchor(id) {
+        const existed = anchorStates.delete(id);
+        if (existed)
+            publish();
+        return existed;
+    }
+    function updateAnchor(id, patch) {
+        const state = anchorStates.get(id);
+        if (state === undefined)
+            return false;
+        const prev = state.definition;
+        // Merge into a fresh definition object — never mutate the
+        // existing one (immutability convention).
+        const nextDef = {
+            ...prev,
+            ...patch,
+            id: prev.id,
+        };
+        state.definition = nextDef;
+        // Recompute only when the math-affecting fields change.
+        const mathDirty = (patch.barIndex !== undefined &&
+            patch.barIndex !== prev.barIndex) ||
+            (patch.includeBands !== undefined &&
+                patch.includeBands !== prev.includeBands);
+        if (mathDirty) {
+            recomputeAnchor(state);
+        }
+        publish();
+        return true;
+    }
+    function appendBar(bar) {
+        const absIndex = bars.length;
+        bars.push(bar);
+        for (const state of anchorStates.values()) {
+            extendAnchorByOne(state, bar, absIndex);
+        }
+        publish();
+    }
+    // -------------------------------------------------------------------
+    // Dispose — silence mutators (same pattern as the rest of the codebase)
+    // -------------------------------------------------------------------
+    let disposed = false;
+    function dispose() {
+        if (disposed)
+            return;
+        disposed = true;
+    }
+    function guard(fn, fallback) {
+        return ((...args) => {
+            if (disposed)
+                return fallback;
+            return fn(...args);
+        });
+    }
+    const guardedSetBars = guard(setBars, undefined);
+    const guardedAppendBar = guard(appendBar, undefined);
+    return {
+        anchors,
+        // Canonical verbs (API audit BLOCKER-001 harmonisation): `setData`
+        // for full replacement + `append` for single-item extension. Old
+        // names preserved as aliases for the deprecation window.
+        setData: guardedSetBars,
+        append: guardedAppendBar,
+        setBars: guardedSetBars,
+        addAnchor: guard(addAnchor, null),
+        removeAnchor: guard(removeAnchor, false),
+        updateAnchor: guard(updateAnchor, false),
+        appendBar: guardedAppendBar,
+        dispose,
+    };
+}
+//# sourceMappingURL=createAnchoredVwapController.js.map

package/dist/components/anchoredVwap/createAnchoredVwapController.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createAnchoredVwapController.js","sourceRoot":"","sources":["../../../src/components/anchoredVwap/createAnchoredVwapController.ts"],"names":[],"mappings":"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"}

package/dist/components/anchoredVwap/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Public surface of the Anchored VWAP module.
+ *
+ * Consumers should import from this barrel. The barrel is re-exported from
+ * `packages/core/src/index.ts` so the public package surface stays a single
+ * import line.
+ */
+export { computeAnchoredVwap } from './computeAnchoredVwap';
+export { createAnchoredVwapController } from './createAnchoredVwapController';
+export type { ActiveAnchor, AnchorDefinition, AnchoredVwapController, AVWAPBar, AVWAPPoint, } from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/components/anchoredVwap/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/anchoredVwap/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAA;AAC3D,OAAO,EAAE,4BAA4B,EAAE,MAAM,gCAAgC,CAAA;AAC7E,YAAY,EACR,YAAY,EACZ,gBAAgB,EAChB,sBAAsB,EACtB,QAAQ,EACR,UAAU,GACb,MAAM,SAAS,CAAA"}

package/dist/components/anchoredVwap/index.js

@@ -0,0 +1,10 @@
+/**
+ * Public surface of the Anchored VWAP module.
+ *
+ * Consumers should import from this barrel. The barrel is re-exported from
+ * `packages/core/src/index.ts` so the public package surface stays a single
+ * import line.
+ */
+export { computeAnchoredVwap } from './computeAnchoredVwap';
+export { createAnchoredVwapController } from './createAnchoredVwapController';
+//# sourceMappingURL=index.js.map

package/dist/components/anchoredVwap/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/components/anchoredVwap/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAA;AAC3D,OAAO,EAAE,4BAA4B,EAAE,MAAM,gCAAgC,CAAA"}

package/dist/components/anchoredVwap/types.d.ts

@@ -0,0 +1,171 @@
+/**
+ * Anchored VWAP — public type contract.
+ *
+ * Anchored VWAP (AVWAP) is a volume-weighted average price calculation that
+ * starts from a specific, user-chosen anchor bar rather than rolling over a
+ * fixed window. Institutional traders anchor to earnings prints, swing
+ * highs/lows, session opens, or macro events and read the resulting line as
+ * a "fair price" reference from that moment forward. The ±1σ / ±2σ bands
+ * around the AVWAP form a volume-weighted standard-deviation envelope that
+ * is widely used for mean-reversion entries and exits.
+ *
+ * TradingView restricts the **number** of simultaneous AVWAP anchors on
+ * lower tiers; this controller is multi-anchor by design — every anchor
+ * tracks its own cumulative sums so incremental `appendBar` is O(1) per
+ * anchor per bar.
+ *
+ * This module owns the **data model + math only**. Rendering belongs to the
+ * `@klinechart-quant/core` Renderer/Scene layer (or a Vue/React adapter).
+ *
+ * See `docs/ROADMAP.md` §3 for the broader controller layering this fits
+ * into. The dispose-guard pattern follows
+ * `createIndicatorSelectorController.ts`.
+ */
+import type { Signal } from '../../reactivity';
+/**
+ * Minimum bar shape consumed by `computeAnchoredVwap`. Matches the
+ * cross-renderer KLineData subset used elsewhere in core. We intentionally
+ * do NOT require `open` or `timestamp` so callers can stream from any
+ * source.
+ */
+export interface AVWAPBar {
+    high: number;
+    low: number;
+    close: number;
+    volume: number;
+}
+/**
+ * A single point of an Anchored VWAP series — one entry per bar from the
+ * anchor index (inclusive) through the end of the input.
+ *
+ * `barIndex` is the absolute bar index in the original input array (NOT a
+ * series-relative offset). Renderers map it directly onto their X-axis.
+ *
+ * When bands are disabled (`includeBands: false`) the four band fields are
+ * set equal to `vwap` so consumers do not need a `null` check.
+ *
+ * When a bar contributes no volume and there is no prior AVWAP (i.e. the
+ * anchor bar itself has `volume === 0`), every numeric field of the
+ * resulting point is `NaN`. See `computeAnchoredVwap.ts` for the
+ * carry-forward rules.
+ */
+export interface AVWAPPoint {
+    /** Absolute bar index in the input series. */
+    barIndex: number;
+    /** Volume-weighted average price from anchor up to this bar. */
+    vwap: number;
+    /** vwap + 1σ. Equals vwap when bands are disabled. */
+    upper1: number;
+    /** vwap − 1σ. Equals vwap when bands are disabled. */
+    lower1: number;
+    /** vwap + 2σ. Equals vwap when bands are disabled. */
+    upper2: number;
+    /** vwap − 2σ. Equals vwap when bands are disabled. */
+    lower2: number;
+    /** Running sum of volume from the anchor to this bar. Useful for
+     *  diagnostics, exhaustion checks, and adapter overlays. */
+    cumulativeVolume: number;
+}
+/**
+ * Definition of an anchor instance. Multiple anchors can be active at the
+ * same time (e.g. one per session, one per earnings, one per swing low).
+ *
+ * `id` must be unique within the controller; the controller treats a
+ * collision on `addAnchor` as a replace-in-place to keep the API
+ * idempotent.
+ */
+export interface AnchorDefinition {
+    /** Stable id. Caller-supplied; treat as opaque. */
+    id: string;
+    /** Human-readable label (e.g. "Earnings Beat 2024-Q1"). */
+    label: string;
+    /** Anchor position as an index into the controller's bar series. */
+    barIndex: number;
+    /** Optional colour hint for the adapter — not used by the math. */
+    color?: string;
+    /** Whether to compute the ±1σ / ±2σ bands for this anchor. */
+    includeBands: boolean;
+}
+/**
+ * An anchor together with its computed AVWAP series. The series is a
+ * snapshot — calling `setBars`, `appendBar`, or `updateAnchor` produces a
+ * fresh array (immutability convention).
+ */
+export interface ActiveAnchor {
+    definition: AnchorDefinition;
+    series: ReadonlyArray<AVWAPPoint>;
+}
+/**
+ * Framework-agnostic controller — mirrors the shape of
+ * `VolumeProfileController` and `IndicatorSelectorController` (signals for
+ * state, plain functions for mutations, idempotent `dispose`).
+ *
+ * Why this design:
+ *  - Multi-anchor: every anchor tracks its own running sums so
+ *    `appendBar` is O(anchors) per tick, not O(anchors × bars).
+ *  - Signal-based: any adapter (React `useSyncExternalStore`, Vue effect,
+ *    Angular `toSignal`) can bridge without coupling to a framework.
+ *  - Dispose-guard: mutators become silent no-ops after `dispose`, so a
+ *    component that unmounts mid-stream cannot leak updates into a stale
+ *    listener.
+ */
+export interface AnchoredVwapController {
+    /** All currently active anchors with their up-to-date series. */
+    readonly anchors: Signal<ReadonlyArray<ActiveAnchor>>;
+    /**
+     * Replace the underlying bar series and recompute every active anchor
+     * from scratch — canonical method, aligned with the cross-controller
+     * `setData()` convention (MtfController). Closes API audit BLOCKER-001
+     * (5-verb intake proliferation).
+     */
+    setData(bars: ReadonlyArray<AVWAPBar>): void;
+    /**
+     * @deprecated since 0.1.0-alpha.1 — use {@link AnchoredVwapController.setData}.
+     * Preserved as a non-removing alias for at least 6 months.
+     */
+    setBars(bars: ReadonlyArray<AVWAPBar>): void;
+    /**
+     * Add an anchor and compute its series immediately. Returns the
+     * anchor's id (the same one passed in `def.id`). If an anchor with the
+     * same id already exists it is **replaced** — that keeps the API
+     * idempotent and matches what UIs expect when the user drags an anchor
+     * onto an existing one.
+     *
+     * Returns `null` after dispose.
+     */
+    addAnchor(def: AnchorDefinition): string | null;
+    /**
+     * Remove an anchor by id. Returns `true` when an anchor was actually
+     * removed, `false` when the id was unknown (or after dispose).
+     */
+    removeAnchor(id: string): boolean;
+    /**
+     * Patch an anchor in place. Any of `label`, `barIndex`, `color`, and
+     * `includeBands` may change; the series is recomputed whenever
+     * `barIndex` or `includeBands` changes (a pure label change is a
+     * lightweight metadata swap).
+     *
+     * Returns `false` when the id is unknown (or after dispose).
+     */
+    updateAnchor(id: string, patch: Partial<Omit<AnchorDefinition, 'id'>>): boolean;
+    /**
+     * Append a single new bar — canonical method, aligned with the
+     * cross-controller `append()` convention (MtfController). Each anchor's
+     * series is extended **incrementally** by one point — the running
+     * cumulative sums make this O(1) per anchor per call. A full
+     * `computeAnchoredVwap` after N appends produces the same result; see
+     * the controller test that pins this equivalence.
+     */
+    append(bar: AVWAPBar): void;
+    /**
+     * @deprecated since 0.1.0-alpha.1 — use {@link AnchoredVwapController.append}.
+     * Preserved as a non-removing alias for at least 6 months.
+     */
+    appendBar(bar: AVWAPBar): void;
+    /**
+     * Stop emitting. Subsequent mutator calls are silent no-ops; previously
+     * attached subscribers receive no further notifications. Idempotent.
+     */
+    dispose(): void;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/components/anchoredVwap/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/components/anchoredVwap/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAA;AAE9C;;;;;GAKG;AACH,MAAM,WAAW,QAAQ;IACrB,IAAI,EAAE,MAAM,CAAA;IACZ,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;CACjB;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,WAAW,UAAU;IACvB,8CAA8C;IAC9C,QAAQ,EAAE,MAAM,CAAA;IAChB,gEAAgE;IAChE,IAAI,EAAE,MAAM,CAAA;IACZ,sDAAsD;IACtD,MAAM,EAAE,MAAM,CAAA;IACd,sDAAsD;IACtD,MAAM,EAAE,MAAM,CAAA;IACd,sDAAsD;IACtD,MAAM,EAAE,MAAM,CAAA;IACd,sDAAsD;IACtD,MAAM,EAAE,MAAM,CAAA;IACd;gEAC4D;IAC5D,gBAAgB,EAAE,MAAM,CAAA;CAC3B;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,gBAAgB;IAC7B,mDAAmD;IACnD,EAAE,EAAE,MAAM,CAAA;IACV,2DAA2D;IAC3D,KAAK,EAAE,MAAM,CAAA;IACb,oEAAoE;IACpE,QAAQ,EAAE,MAAM,CAAA;IAChB,mEAAmE;IACnE,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,8DAA8D;IAC9D,YAAY,EAAE,OAAO,CAAA;CACxB;AAED;;;;GAIG;AACH,MAAM,WAAW,YAAY;IACzB,UAAU,EAAE,gBAAgB,CAAA;IAC5B,MAAM,EAAE,aAAa,CAAC,UAAU,CAAC,CAAA;CACpC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,sBAAsB;IACnC,iEAAiE;IACjE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,aAAa,CAAC,YAAY,CAAC,CAAC,CAAA;IAErD;;;;;OAKG;IACH,OAAO,CAAC,IAAI,EAAE,aAAa,CAAC,QAAQ,CAAC,GAAG,IAAI,CAAA;IAE5C;;;OAGG;IACH,OAAO,CAAC,IAAI,EAAE,aAAa,CAAC,QAAQ,CAAC,GAAG,IAAI,CAAA;IAE5C;;;;;;;;OAQG;IACH,SAAS,CAAC,GAAG,EAAE,gBAAgB,GAAG,MAAM,GAAG,IAAI,CAAA;IAE/C;;;OAGG;IACH,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAA;IAEjC;;;;;;;OAOG;IACH,YAAY,CACR,EAAE,EAAE,MAAM,EACV,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,gBAAgB,EAAE,IAAI,CAAC,CAAC,GAC7C,OAAO,CAAA;IAEV;;;;;;;OAOG;IACH,MAAM,CAAC,GAAG,EAAE,QAAQ,GAAG,IAAI,CAAA;IAE3B;;;OAGG;IACH,SAAS,CAAC,GAAG,EAAE,QAAQ,GAAG,IAAI,CAAA;IAE9B;;;OAGG;IACH,OAAO,IAAI,IAAI,CAAA;CAClB"}

package/dist/components/anchoredVwap/types.js

@@ -0,0 +1,25 @@
+/**
+ * Anchored VWAP — public type contract.
+ *
+ * Anchored VWAP (AVWAP) is a volume-weighted average price calculation that
+ * starts from a specific, user-chosen anchor bar rather than rolling over a
+ * fixed window. Institutional traders anchor to earnings prints, swing
+ * highs/lows, session opens, or macro events and read the resulting line as
+ * a "fair price" reference from that moment forward. The ±1σ / ±2σ bands
+ * around the AVWAP form a volume-weighted standard-deviation envelope that
+ * is widely used for mean-reversion entries and exits.
+ *
+ * TradingView restricts the **number** of simultaneous AVWAP anchors on
+ * lower tiers; this controller is multi-anchor by design — every anchor
+ * tracks its own cumulative sums so incremental `appendBar` is O(1) per
+ * anchor per bar.
+ *
+ * This module owns the **data model + math only**. Rendering belongs to the
+ * `@klinechart-quant/core` Renderer/Scene layer (or a Vue/React adapter).
+ *
+ * See `docs/ROADMAP.md` §3 for the broader controller layering this fits
+ * into. The dispose-guard pattern follows
+ * `createIndicatorSelectorController.ts`.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/components/anchoredVwap/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/components/anchoredVwap/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG"}

package/dist/components/crosshairSync/createCrosshairSync.d.ts

@@ -0,0 +1,94 @@
+/**
+ * Crosshair sync — broadcasts crosshair position across multiple
+ * chart panes so a hover in one pane lights up the same time index
+ * in every other pane.
+ *
+ * Why this is the controller, not just a callback:
+ *
+ *   - Multi-pane layouts (price + volume + 1+ indicator panes) are
+ *     standard for finance charts. TradingView's multi-pane crosshair
+ *     is one of its iconic UX features.
+ *   - Each pane has its own scale/transform. The universal coordinate
+ *     they share is the **time index** — the integer-valued position
+ *     within the bar array. Sync on index, not pixel; the rendering
+ *     pane converts back to its own x coordinate.
+ *   - Loop prevention: a pane that consumed a sync event must not
+ *     re-emit it. We track the source identifier so the pane that
+ *     drove the update doesn't recurse.
+ *
+ * Pure data, signal-based, framework-agnostic — same shape as the
+ * rest of `@klinechart-quant/core`.
+ *
+ *   const sync = createCrosshairSync()
+ *   sync.register('price')
+ *   sync.register('volume')
+ *   sync.register('rsi')
+ *
+ *   priceContainer.addEventListener('pointermove', e => {
+ *     const idx = timeScale.xToBarIndex(e.offsetX)
+ *     sync.move('price', idx)
+ *   })
+ *
+ *   sync.position.subscribe(() => {
+ *     const p = sync.position.peek()
+ *     if (p === null) hideCrosshair()
+ *     else if (p.source !== 'volume') drawCrosshairInVolume(p.index)
+ *   })
+ */
+import { type Signal } from '../../reactivity';
+/**
+ * Current crosshair position broadcast across registered panes.
+ * `null` means no pane has the crosshair active (host left every chart
+ * or `clear()` was called).
+ */
+export interface CrosshairPosition {
+    /** Integer index into the canonical bar array. */
+    readonly index: number;
+    /**
+     * Pane id of the pane that produced this update. Consumers MUST
+     * compare to skip handling their own emissions (loop prevention).
+     */
+    readonly source: string;
+}
+export interface CrosshairSync {
+    /**
+     * Current position. `null` when no crosshair is active.
+     *
+     * NOTE: this is a `Signal<...>` — reading `position()` inside an
+     * `effect` tracks the subscription; reading `position.peek()` does
+     * not. Manual `subscribe` returns an unsubscribe function.
+     */
+    readonly position: Signal<CrosshairPosition | null>;
+    /**
+     * Number of currently registered panes. Helpful for the
+     * "single-pane no-op" branch in adapters.
+     */
+    readonly paneCount: Signal<number>;
+    /**
+     * Register a pane that participates in the sync. Idempotent —
+     * re-registering the same id is a no-op.
+     */
+    register(paneId: string): void;
+    /**
+     * Unregister a pane. If the unregistered pane is the source of the
+     * current position, the position is cleared (the producer is gone).
+     */
+    unregister(paneId: string): void;
+    /**
+     * Producer-side update — pane `paneId` is reporting that its
+     * crosshair is on bar `index`. Subscribers receive the new
+     * position; `paneId` is recorded as `source` for loop prevention.
+     *
+     * Calling `move` from a pane that has not been registered throws
+     * `KLineChartError('NOT_REGISTERED')` — the wiring contract is
+     * easy to mess up and silent ignores would mask bugs.
+     */
+    move(paneId: string, index: number): void;
+    /** Clears the position. All panes see `position = null`. */
+    clear(): void;
+    /** Reset to empty registry + null position. */
+    reset(): void;
+    dispose(): void;
+}
+export declare function createCrosshairSync(): CrosshairSync;
+//# sourceMappingURL=createCrosshairSync.d.ts.map

package/dist/components/crosshairSync/createCrosshairSync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createCrosshairSync.d.ts","sourceRoot":"","sources":["../../../src/components/crosshairSync/createCrosshairSync.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AAEH,OAAO,EAAgB,KAAK,MAAM,EAAE,MAAM,kBAAkB,CAAA;AAO5D;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAC9B,kDAAkD;IAClD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB;;;OAGG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAC1B;AAED,MAAM,WAAW,aAAa;IAC1B;;;;;;OAMG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAAA;IACnD;;;OAGG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC,MAAM,CAAC,CAAA;IAElC;;;OAGG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;IAC9B;;;OAGG;IACH,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;IAChC;;;;;;;;OAQG;IACH,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IACzC,4DAA4D;IAC5D,KAAK,IAAI,IAAI,CAAA;IACb,+CAA+C;IAC/C,KAAK,IAAI,IAAI,CAAA;IACb,OAAO,IAAI,IAAI,CAAA;CAClB;AAMD,wBAAgB,mBAAmB,IAAI,aAAa,CAgFnD"}