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

package/dist/components/crosshairSync/createCrosshairSync.js

@@ -0,0 +1,118 @@
+/**
+ * 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 { createSignal } from '../../reactivity';
+import { KLineChartError } from '../../errors';
+// ---------------------------------------------------------------------------
+// Factory
+// ---------------------------------------------------------------------------
+export function createCrosshairSync() {
+    const position = createSignal(null);
+    const paneCount = createSignal(0);
+    const panes = new Set();
+    let disposed = false;
+    function publishPaneCount() {
+        paneCount.set(panes.size);
+    }
+    function register(paneId) {
+        if (disposed)
+            return;
+        if (paneId === '' || typeof paneId !== 'string') {
+            throw new KLineChartError('INVALID_PARAM', `CrosshairSync.register: paneId must be a non-empty string`);
+        }
+        if (panes.has(paneId))
+            return;
+        panes.add(paneId);
+        publishPaneCount();
+    }
+    function unregister(paneId) {
+        if (disposed)
+            return;
+        if (!panes.has(paneId))
+            return;
+        panes.delete(paneId);
+        publishPaneCount();
+        const cur = position.peek();
+        if (cur !== null && cur.source === paneId) {
+            position.set(null);
+        }
+    }
+    function move(paneId, index) {
+        if (disposed)
+            return;
+        if (!panes.has(paneId)) {
+            throw new KLineChartError('NOT_REGISTERED', `CrosshairSync.move: pane ${JSON.stringify(paneId)} is not registered — call register(${JSON.stringify(paneId)}) before move()`);
+        }
+        if (!Number.isFinite(index)) {
+            throw new KLineChartError('INVALID_PARAM', `CrosshairSync.move: index must be finite, got ${index}`);
+        }
+        // Normalise to integer. Sub-bar precision lives in the per-pane
+        // pixel layer, not in the shared index broadcast.
+        const idx = Math.round(index);
+        const cur = position.peek();
+        // Coalesce identical updates so subscribers don't fire on no-ops.
+        if (cur !== null && cur.index === idx && cur.source === paneId)
+            return;
+        position.set({ index: idx, source: paneId });
+    }
+    function clear() {
+        if (disposed)
+            return;
+        if (position.peek() === null)
+            return;
+        position.set(null);
+    }
+    function reset() {
+        if (disposed)
+            return;
+        panes.clear();
+        publishPaneCount();
+        if (position.peek() !== null)
+            position.set(null);
+    }
+    function dispose() {
+        if (disposed)
+            return;
+        disposed = true;
+        panes.clear();
+        // No notify on dispose — subscribers should listen for their own
+        // host lifecycle. Setting paneCount/position now would notify
+        // dead subscribers in some host frameworks.
+    }
+    return { position, paneCount, register, unregister, move, clear, reset, dispose };
+}
+//# sourceMappingURL=createCrosshairSync.js.map

package/dist/components/crosshairSync/createCrosshairSync.js.map

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

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

@@ -0,0 +1,2 @@
+export { createCrosshairSync, type CrosshairSync, type CrosshairPosition, } from './createCrosshairSync';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/crosshairSync/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,mBAAmB,EACnB,KAAK,aAAa,EAClB,KAAK,iBAAiB,GACzB,MAAM,uBAAuB,CAAA"}

package/dist/components/crosshairSync/index.js

@@ -0,0 +1,2 @@
+export { createCrosshairSync, } from './createCrosshairSync';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/components/crosshairSync/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,mBAAmB,GAGtB,MAAM,uBAAuB,CAAA"}

package/dist/components/footprint/aggressor.d.ts

@@ -0,0 +1,89 @@
+/**
+ * Aggressor classification — three heuristics for tagging a print as
+ * buyer-initiated ("buy", aggressor lifted the ASK) or seller-initiated
+ * ("sell", aggressor hit the BID).
+ *
+ * Future hook: Bulk Volume Classification (BVC) by Easley/Lopez de Prado/O'Hara
+ * 2012 is more robust in HFT-fragmented markets where the tick rule's serial
+ * correlation assumptions break. BVC is planned as a v2 classifier under the
+ * same `AggressorResult` interface.
+ *
+ * Each classifier exports the same `AggressorResult` shape so the controller
+ * can compose them in a fallback chain (explicit → heuristic) without
+ * branching on classifier identity.
+ *
+ * See `docs/ROADMAP.md` §3.3 for the rationale — order of preference is
+ * always explicit > Lee-Ready > tick rule.
+ */
+import type { AggressorSide, Trade, TradeWithFlag } from './types';
+/**
+ * Output of every classifier.
+ *
+ * `side` is `'unknown'` only when there is genuinely no information to act
+ * on (e.g. the first trade in a tick-rule sequence). The controller should
+ * treat `'unknown'` as "drop this trade from the aggregate", NOT as a
+ * silent default to 'buy' or 'sell'.
+ *
+ * `inferred=false` means the side came from an exchange flag (zero error).
+ * `inferred=true` means it was estimated; downstream UI should mark such
+ * bars as approximate.
+ */
+export type { AggressorSide, Trade, TradeWithFlag };
+export interface AggressorResult {
+    side: AggressorSide | 'unknown';
+    inferred: boolean;
+}
+/**
+ * Read Binance-style `isBuyerMaker`. When the buyer is the maker (passive),
+ * the seller was the aggressor — so we report `'sell'`. When the buyer is
+ * NOT the maker, the buyer was the aggressor — `'buy'`.
+ *
+ * Returns `null` (not an `AggressorResult`) when the flag is missing so the
+ * caller can distinguish "no data" from "we classified it as unknown". This
+ * lets the controller fall back to the configured heuristic only when truly
+ * needed.
+ */
+export declare function classifyExplicit(trade: TradeWithFlag): AggressorResult | null;
+/**
+ * State carried across consecutive trades for the tick rule. The classifier
+ * MUTATES this in place — callers should keep one instance per stream
+ * (per-symbol if multiplexing).
+ */
+export interface TickRuleState {
+    prevPrice: number | null;
+    prevSide: AggressorSide | null;
+}
+/**
+ * Classic tick test (Lee & Ready 1991 §2):
+ *
+ *   price > prevPrice → 'buy'     (uptick)
+ *   price < prevPrice → 'sell'    (downtick)
+ *   price == prevPrice → repeats prevSide  (zero-tick)
+ *   first trade (prevPrice null) → 'unknown'
+ *
+ * The state is MUTATED so subsequent calls inherit the running context.
+ */
+export declare function classifyTickRule(state: TickRuleState, trade: Trade): AggressorResult;
+/**
+ * Lee-Ready uses the same carry-over fields as the tick rule — the two
+ * heuristics can share a single state record because Lee-Ready falls back
+ * to the tick rule on a quote-mid hit.
+ */
+export interface LeeReadyState extends TickRuleState {
+}
+/**
+ * Lee-Ready (1991) quote test:
+ *
+ *   If bid and ask are both finite:
+ *     mid = (bid + ask) / 2
+ *     price > mid → 'buy'
+ *     price < mid → 'sell'
+ *     price == mid → tick-rule fallback (zero spread or mid-cross)
+ *   Else (bid/ask missing or non-finite) → tick-rule fallback.
+ *
+ * The state MUTATES exactly like `classifyTickRule` — when the quote test
+ * resolves, we still update `prevPrice`/`prevSide` so a subsequent
+ * tick-rule fallback has the latest context.
+ */
+export declare function classifyLeeReady(state: LeeReadyState, trade: Trade, bid: number, ask: number): AggressorResult;
+//# sourceMappingURL=aggressor.d.ts.map

package/dist/components/footprint/aggressor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"aggressor.d.ts","sourceRoot":"","sources":["../../../src/components/footprint/aggressor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AAElE;;;;;;;;;;;GAWG;AACH,YAAY,EAAE,aAAa,EAAE,KAAK,EAAE,aAAa,EAAE,CAAA;AACnD,MAAM,WAAW,eAAe;IAC5B,IAAI,EAAE,aAAa,GAAG,SAAS,CAAA;IAC/B,QAAQ,EAAE,OAAO,CAAA;CACpB;AAMD;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAC5B,KAAK,EAAE,aAAa,GACrB,eAAe,GAAG,IAAI,CAMxB;AAMD;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC1B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,QAAQ,EAAE,aAAa,GAAG,IAAI,CAAA;CACjC;AAED;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAC5B,KAAK,EAAE,aAAa,EACpB,KAAK,EAAE,KAAK,GACb,eAAe,CAsBjB;AAMD;;;;GAIG;AACH,MAAM,WAAW,aAAc,SAAQ,aAAa;CAAG;AAEvD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,gBAAgB,CAC5B,KAAK,EAAE,aAAa,EACpB,KAAK,EAAE,KAAK,EACZ,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,MAAM,GACZ,eAAe,CAqBjB"}

package/dist/components/footprint/aggressor.js

@@ -0,0 +1,106 @@
+/**
+ * Aggressor classification — three heuristics for tagging a print as
+ * buyer-initiated ("buy", aggressor lifted the ASK) or seller-initiated
+ * ("sell", aggressor hit the BID).
+ *
+ * Future hook: Bulk Volume Classification (BVC) by Easley/Lopez de Prado/O'Hara
+ * 2012 is more robust in HFT-fragmented markets where the tick rule's serial
+ * correlation assumptions break. BVC is planned as a v2 classifier under the
+ * same `AggressorResult` interface.
+ *
+ * Each classifier exports the same `AggressorResult` shape so the controller
+ * can compose them in a fallback chain (explicit → heuristic) without
+ * branching on classifier identity.
+ *
+ * See `docs/ROADMAP.md` §3.3 for the rationale — order of preference is
+ * always explicit > Lee-Ready > tick rule.
+ */
+// ---------------------------------------------------------------------------
+// 1. Explicit (exchange-provided flag)
+// ---------------------------------------------------------------------------
+/**
+ * Read Binance-style `isBuyerMaker`. When the buyer is the maker (passive),
+ * the seller was the aggressor — so we report `'sell'`. When the buyer is
+ * NOT the maker, the buyer was the aggressor — `'buy'`.
+ *
+ * Returns `null` (not an `AggressorResult`) when the flag is missing so the
+ * caller can distinguish "no data" from "we classified it as unknown". This
+ * lets the controller fall back to the configured heuristic only when truly
+ * needed.
+ */
+export function classifyExplicit(trade) {
+    if (trade.isBuyerMaker === undefined)
+        return null;
+    return {
+        side: trade.isBuyerMaker ? 'sell' : 'buy',
+        inferred: false,
+    };
+}
+/**
+ * Classic tick test (Lee & Ready 1991 §2):
+ *
+ *   price > prevPrice → 'buy'     (uptick)
+ *   price < prevPrice → 'sell'    (downtick)
+ *   price == prevPrice → repeats prevSide  (zero-tick)
+ *   first trade (prevPrice null) → 'unknown'
+ *
+ * The state is MUTATED so subsequent calls inherit the running context.
+ */
+export function classifyTickRule(state, trade) {
+    const prev = state.prevPrice;
+    let side;
+    if (prev === null) {
+        side = 'unknown';
+    }
+    else if (trade.price > prev) {
+        side = 'buy';
+    }
+    else if (trade.price < prev) {
+        side = 'sell';
+    }
+    else {
+        // zero-tick: inherit previous decision; 'unknown' if no prior side.
+        side = state.prevSide ?? 'unknown';
+    }
+    // Update running state. We commit a known side; we deliberately do NOT
+    // overwrite `prevSide` with 'unknown', otherwise a single missing-price
+    // trade would poison the carry-over for the rest of the stream.
+    state.prevPrice = trade.price;
+    if (side === 'buy' || side === 'sell')
+        state.prevSide = side;
+    return { side, inferred: true };
+}
+/**
+ * Lee-Ready (1991) quote test:
+ *
+ *   If bid and ask are both finite:
+ *     mid = (bid + ask) / 2
+ *     price > mid → 'buy'
+ *     price < mid → 'sell'
+ *     price == mid → tick-rule fallback (zero spread or mid-cross)
+ *   Else (bid/ask missing or non-finite) → tick-rule fallback.
+ *
+ * The state MUTATES exactly like `classifyTickRule` — when the quote test
+ * resolves, we still update `prevPrice`/`prevSide` so a subsequent
+ * tick-rule fallback has the latest context.
+ */
+export function classifyLeeReady(state, trade, bid, ask) {
+    const quotesUsable = Number.isFinite(bid) && Number.isFinite(ask);
+    if (!quotesUsable) {
+        return classifyTickRule(state, trade);
+    }
+    const mid = (bid + ask) / 2;
+    if (trade.price > mid) {
+        state.prevPrice = trade.price;
+        state.prevSide = 'buy';
+        return { side: 'buy', inferred: true };
+    }
+    if (trade.price < mid) {
+        state.prevPrice = trade.price;
+        state.prevSide = 'sell';
+        return { side: 'sell', inferred: true };
+    }
+    // price == mid → fall back to tick rule (which updates state).
+    return classifyTickRule(state, trade);
+}
+//# sourceMappingURL=aggressor.js.map

package/dist/components/footprint/aggressor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"aggressor.js","sourceRoot":"","sources":["../../../src/components/footprint/aggressor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAsBH,8EAA8E;AAC9E,uCAAuC;AACvC,8EAA8E;AAE9E;;;;;;;;;GASG;AACH,MAAM,UAAU,gBAAgB,CAC5B,KAAoB;IAEpB,IAAI,KAAK,CAAC,YAAY,KAAK,SAAS;QAAE,OAAO,IAAI,CAAA;IACjD,OAAO;QACH,IAAI,EAAE,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK;QACzC,QAAQ,EAAE,KAAK;KAClB,CAAA;AACL,CAAC;AAgBD;;;;;;;;;GASG;AACH,MAAM,UAAU,gBAAgB,CAC5B,KAAoB,EACpB,KAAY;IAEZ,MAAM,IAAI,GAAG,KAAK,CAAC,SAAS,CAAA;IAC5B,IAAI,IAA+B,CAAA;IAEnC,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;QAChB,IAAI,GAAG,SAAS,CAAA;IACpB,CAAC;SAAM,IAAI,KAAK,CAAC,KAAK,GAAG,IAAI,EAAE,CAAC;QAC5B,IAAI,GAAG,KAAK,CAAA;IAChB,CAAC;SAAM,IAAI,KAAK,CAAC,KAAK,GAAG,IAAI,EAAE,CAAC;QAC5B,IAAI,GAAG,MAAM,CAAA;IACjB,CAAC;SAAM,CAAC;QACJ,oEAAoE;QACpE,IAAI,GAAG,KAAK,CAAC,QAAQ,IAAI,SAAS,CAAA;IACtC,CAAC;IAED,uEAAuE;IACvE,wEAAwE;IACxE,gEAAgE;IAChE,KAAK,CAAC,SAAS,GAAG,KAAK,CAAC,KAAK,CAAA;IAC7B,IAAI,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,MAAM;QAAE,KAAK,CAAC,QAAQ,GAAG,IAAI,CAAA;IAE5D,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAA;AACnC,CAAC;AAaD;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,gBAAgB,CAC5B,KAAoB,EACpB,KAAY,EACZ,GAAW,EACX,GAAW;IAEX,MAAM,YAAY,GAAG,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAA;IAEjE,IAAI,CAAC,YAAY,EAAE,CAAC;QAChB,OAAO,gBAAgB,CAAC,KAAK,EAAE,KAAK,CAAC,CAAA;IACzC,CAAC;IAED,MAAM,GAAG,GAAG,CAAC,GAAG,GAAG,GAAG,CAAC,GAAG,CAAC,CAAA;IAE3B,IAAI,KAAK,CAAC,KAAK,GAAG,GAAG,EAAE,CAAC;QACpB,KAAK,CAAC,SAAS,GAAG,KAAK,CAAC,KAAK,CAAA;QAC7B,KAAK,CAAC,QAAQ,GAAG,KAAK,CAAA;QACtB,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAA;IAC1C,CAAC;IACD,IAAI,KAAK,CAAC,KAAK,GAAG,GAAG,EAAE,CAAC;QACpB,KAAK,CAAC,SAAS,GAAG,KAAK,CAAC,KAAK,CAAA;QAC7B,KAAK,CAAC,QAAQ,GAAG,MAAM,CAAA;QACvB,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAA;IAC3C,CAAC;IACD,+DAA+D;IAC/D,OAAO,gBAAgB,CAAC,KAAK,EAAE,KAAK,CAAC,CAAA;AACzC,CAAC"}

package/dist/components/footprint/createFootprintController.d.ts

@@ -0,0 +1,29 @@
+/**
+ * FootprintController — framework-agnostic, signal-based.
+ *
+ * Streams trades in, materialises a `FootprintBar[]` out. Composes:
+ *
+ *   - `classifyExplicit`  (try exchange flag first)
+ *   - `classifyTickRule` / `classifyLeeReady` (fallback per config)
+ *   - `computeDelta`, `computeDiagonalImbalances`, `computeCumulativeDelta`
+ *
+ * Internal storage is hot-path-friendly:
+ *
+ *   buckets: Map<barIndex, Map<priceTickKey, { askVol, bidVol }>>
+ *
+ * Materialisation (sorting + array build) is deferred to `bars` / `cumulativeDelta`
+ * signal reads. A `dirty` flag invalidates the cache on every `ingestTrade`.
+ *
+ * Classifier state carry-over: the `TickRuleState` / `LeeReadyState` records
+ * are MAINTAINED ACROSS BAR BOUNDARIES — i.e. the last trade's price/side of
+ * bar N is used as the prior for the first trade of bar N+1. This is the
+ * documented choice (see ROADMAP §3.3): per-bar reset would flag every bar's
+ * first trade as `unknown`, which inflates dropped volume and breaks the
+ * Lee-Ready zero-tick fallback at every minute boundary. The tested behaviour
+ * relies on this carry-over.
+ *
+ * Dispose-guard pattern mirrors `createIndicatorSelectorController.ts`.
+ */
+import type { FootprintConfig, FootprintController } from './types';
+export declare function createFootprintController(init: Partial<FootprintConfig>): FootprintController;
+//# sourceMappingURL=createFootprintController.d.ts.map

package/dist/components/footprint/createFootprintController.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createFootprintController.d.ts","sourceRoot":"","sources":["../../../src/components/footprint/createFootprintController.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAiBH,OAAO,KAAK,EAGR,eAAe,EACf,mBAAmB,EAGtB,MAAM,SAAS,CAAA;AAsChB,wBAAgB,yBAAyB,CACrC,IAAI,EAAE,OAAO,CAAC,eAAe,CAAC,GAC/B,mBAAmB,CAwPrB"}

package/dist/components/footprint/createFootprintController.js

@@ -0,0 +1,264 @@
+/**
+ * FootprintController — framework-agnostic, signal-based.
+ *
+ * Streams trades in, materialises a `FootprintBar[]` out. Composes:
+ *
+ *   - `classifyExplicit`  (try exchange flag first)
+ *   - `classifyTickRule` / `classifyLeeReady` (fallback per config)
+ *   - `computeDelta`, `computeDiagonalImbalances`, `computeCumulativeDelta`
+ *
+ * Internal storage is hot-path-friendly:
+ *
+ *   buckets: Map<barIndex, Map<priceTickKey, { askVol, bidVol }>>
+ *
+ * Materialisation (sorting + array build) is deferred to `bars` / `cumulativeDelta`
+ * signal reads. A `dirty` flag invalidates the cache on every `ingestTrade`.
+ *
+ * Classifier state carry-over: the `TickRuleState` / `LeeReadyState` records
+ * are MAINTAINED ACROSS BAR BOUNDARIES — i.e. the last trade's price/side of
+ * bar N is used as the prior for the first trade of bar N+1. This is the
+ * documented choice (see ROADMAP §3.3): per-bar reset would flag every bar's
+ * first trade as `unknown`, which inflates dropped volume and breaks the
+ * Lee-Ready zero-tick fallback at every minute boundary. The tested behaviour
+ * relies on this carry-over.
+ *
+ * Dispose-guard pattern mirrors `createIndicatorSelectorController.ts`.
+ */
+import { createSignal } from '../../reactivity';
+import { KLineChartError } from '../../errors';
+import { classifyExplicit, classifyLeeReady, classifyTickRule, } from './aggressor';
+import { computeCumulativeDelta, computeDelta, computeDiagonalImbalances, } from './perBarStats';
+// ---------------------------------------------------------------------------
+// Defaults & validation
+// ---------------------------------------------------------------------------
+const DEFAULT_CONFIG = {
+    tickSize: 0.01,
+    barIntervalMs: 60_000,
+    imbalanceRatio: 3,
+    fallbackClassifier: 'tick-rule',
+};
+function validateConfig(c) {
+    if (!(c.tickSize > 0)) {
+        throw new KLineChartError('FOOTPRINT_TICKSIZE_INVALID', 'FootprintController: tickSize must be > 0');
+    }
+    if (!(c.barIntervalMs > 0) || !Number.isFinite(c.barIntervalMs)) {
+        throw new KLineChartError('FOOTPRINT_BAR_INTERVAL_INVALID', 'FootprintController: barIntervalMs must be > 0');
+    }
+    if (!(c.imbalanceRatio > 0)) {
+        throw new KLineChartError('FOOTPRINT_RATIO_INVALID', 'FootprintController: imbalanceRatio must be > 0');
+    }
+}
+// ---------------------------------------------------------------------------
+// Factory
+// ---------------------------------------------------------------------------
+export function createFootprintController(init) {
+    const initialConfig = { ...DEFAULT_CONFIG, ...init };
+    validateConfig(initialConfig);
+    const config = createSignal(initialConfig);
+    const bars = createSignal([]);
+    const cumulativeDelta = createSignal([]);
+    // ---- Internal state ------------------------------------------------
+    /**
+     * barIndex → (priceTickKey → mutable cell).
+     *
+     * We use Maps so insertion order is preserved per-bar (for debug-time
+     * inspection); the public materialisation sorts deterministically.
+     */
+    let buckets = new Map();
+    /**
+     * Classifier carry-over. One record shared by tick rule and Lee-Ready —
+     * they have the same field surface. NEVER reset on bar boundary
+     * (see header comment).
+     */
+    const tickState = {
+        prevPrice: null,
+        prevSide: null,
+    };
+    /** Set to true on every successful `ingestTrade`; cleared on materialise. */
+    let dirty = false;
+    /** Disposal guard. */
+    let disposed = false;
+    // ---- Helpers -------------------------------------------------------
+    function classify(trade, bid, ask) {
+        // 1. Try the explicit exchange flag first (zero error).
+        const explicit = classifyExplicit(trade);
+        if (explicit !== null) {
+            // Even when we don't consume the heuristic, advance the
+            // carry-over so a later fallback-classified trade still has a
+            // useful prevPrice/prevSide. We commit prevSide only for known
+            // explicit sides.
+            tickState.prevPrice = trade.price;
+            tickState.prevSide = explicit.side === 'unknown' ? null : explicit.side;
+            return explicit;
+        }
+        // 2. Fall back to the configured heuristic.
+        const mode = config.peek().fallbackClassifier;
+        if (mode === 'lee-ready') {
+            // If quotes are missing, classifyLeeReady will degrade to the
+            // tick rule itself — same state record.
+            const b = bid ?? Number.NaN;
+            const a = ask ?? Number.NaN;
+            return classifyLeeReady(tickState, trade, b, a);
+        }
+        return classifyTickRule(tickState, trade);
+    }
+    function bucketFor(barIndex) {
+        let bar = buckets.get(barIndex);
+        if (bar === undefined) {
+            bar = new Map();
+            buckets.set(barIndex, bar);
+        }
+        return bar;
+    }
+    function cellFor(bar, priceTickKey) {
+        let cell = bar.get(priceTickKey);
+        if (cell === undefined) {
+            cell = { askVol: 0, bidVol: 0 };
+            bar.set(priceTickKey, cell);
+        }
+        return cell;
+    }
+    /**
+     * Build the materialised view from `buckets`. Sorts bars ascending by
+     * barIndex; within each bar, sorts cells ascending by price.
+     */
+    function materialise() {
+        const cfg = config.peek();
+        const sortedBarIndices = [...buckets.keys()].sort((a, b) => a - b);
+        const outBars = [];
+        const perBarDeltas = [];
+        for (const barIndex of sortedBarIndices) {
+            const internal = buckets.get(barIndex);
+            if (internal === undefined)
+                continue;
+            const sortedKeys = [...internal.keys()].sort((a, b) => a - b);
+            const cells = sortedKeys.map((k) => {
+                const c = internal.get(k);
+                return {
+                    price: k * cfg.tickSize,
+                    askVol: c.askVol,
+                    bidVol: c.bidVol,
+                };
+            });
+            const delta = computeDelta(cells);
+            let totalVolume = 0;
+            for (let i = 0; i < cells.length; i++) {
+                const cell = cells[i];
+                if (cell === undefined)
+                    continue;
+                totalVolume += cell.askVol + cell.bidVol;
+            }
+            const imbalances = computeDiagonalImbalances(cells, cfg.imbalanceRatio);
+            const startTime = barIndex * cfg.barIntervalMs;
+            const endTime = startTime + cfg.barIntervalMs - 1;
+            outBars.push({
+                barIndex,
+                startTime,
+                endTime,
+                cells,
+                delta,
+                totalVolume,
+                imbalances,
+            });
+            perBarDeltas.push(delta);
+        }
+        return { bars: outBars, cumulative: computeCumulativeDelta(perBarDeltas) };
+    }
+    function publishIfDirty() {
+        if (!dirty)
+            return;
+        const { bars: nextBars, cumulative } = materialise();
+        bars.set(nextBars);
+        cumulativeDelta.set(cumulative);
+        dirty = false;
+    }
+    // ---- Mutators ------------------------------------------------------
+    function ingestTrade(trade, bid, ask) {
+        if (disposed)
+            return;
+        // Defensive: reject malformed trades. We do not throw — a single bad
+        // print should not poison the live stream.
+        if (!Number.isFinite(trade.price) || !Number.isFinite(trade.size)) {
+            return;
+        }
+        if (!Number.isFinite(trade.timestamp))
+            return;
+        if (trade.size <= 0)
+            return;
+        const result = classify(trade, bid, ask);
+        if (result.side === 'unknown') {
+            // Drop from the aggregate (the documented contract). We've still
+            // updated tickState inside `classify` so the next trade has
+            // context.
+            return;
+        }
+        const cfg = config.peek();
+        const barIndex = Math.floor(trade.timestamp / cfg.barIntervalMs);
+        const priceTickKey = Math.round(trade.price / cfg.tickSize);
+        const bar = bucketFor(barIndex);
+        const cell = cellFor(bar, priceTickKey);
+        if (result.side === 'buy') {
+            cell.askVol += trade.size;
+        }
+        else {
+            cell.bidVol += trade.size;
+        }
+        dirty = true;
+        publishIfDirty();
+    }
+    function setConfig(next) {
+        if (disposed)
+            return;
+        const cur = config.peek();
+        const merged = { ...cur, ...next };
+        validateConfig(merged);
+        // Changing tickSize or barIntervalMs invalidates the buckets — the
+        // priceTickKey and barIndex of every accumulated cell would be wrong
+        // under the new partitioning. Clear them and let the caller re-feed
+        // history if needed.
+        const partitionChanged = merged.tickSize !== cur.tickSize ||
+            merged.barIntervalMs !== cur.barIntervalMs;
+        if (partitionChanged) {
+            buckets = new Map();
+            // We do NOT reset tickState — the next trade's carry-over is
+            // still valid because the classifier only depends on price
+            // history, not on the bucket partitioning.
+        }
+        config.set(merged);
+        // Re-materialise. If partition changed, bars/cumulative now empty.
+        // If only imbalanceRatio changed, we still want to re-flag.
+        dirty = true;
+        publishIfDirty();
+    }
+    function reset() {
+        if (disposed)
+            return;
+        buckets = new Map();
+        tickState.prevPrice = null;
+        tickState.prevSide = null;
+        bars.set([]);
+        cumulativeDelta.set([]);
+        dirty = false;
+    }
+    function dispose() {
+        if (disposed)
+            return;
+        disposed = true;
+        // Mutators check `disposed` so no further writes will fire — existing
+        // subscribers receive no further notifications.
+    }
+    return {
+        config,
+        bars,
+        cumulativeDelta,
+        // Canonical verb (API audit BLOCKER-001 harmonisation across
+        // VolumeProfile / OrderBookHeatmap / Footprint). Wired to the same
+        // implementation as `ingestTrade` so existing consumers keep working.
+        ingest: ingestTrade,
+        ingestTrade,
+        setConfig,
+        reset,
+        dispose,
+    };
+}
+//# sourceMappingURL=createFootprintController.js.map

package/dist/components/footprint/createFootprintController.js.map

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

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

@@ -0,0 +1,7 @@
+export type { AggressorSide, Trade, TradeWithFlag, FootprintBar, FootprintConfig, FootprintController, } from './types';
+export type { AggressorResult, TickRuleState, LeeReadyState } from './aggressor';
+export { classifyExplicit, classifyTickRule, classifyLeeReady, } from './aggressor';
+export type { FootprintBarCell, FootprintImbalance } from './perBarStats';
+export { computeDelta, computeCumulativeDelta, computeDiagonalImbalances, } from './perBarStats';
+export { createFootprintController } from './createFootprintController';
+//# sourceMappingURL=index.d.ts.map