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

package/dist/components/mtfOverlay/createMtfController.js

@@ -0,0 +1,134 @@
+import { KLineChartError } from '../../errors';
+/**
+ * Multi-Timeframe overlay controller.
+ *
+ * Composes `resampleBars` + `alignToBaseIndex` + a user-supplied `compute`
+ * function per series. Holds the base bar buffer + base interval + a Map of
+ * active series, exposes a single reactive `series` signal.
+ *
+ * v1 implementation: full re-resample + full compute on every mutation. The
+ * incremental "only re-do the last bucket on `appendBaseBar`" optimization
+ * is documented as a follow-up — landing it does not change observable
+ * behavior, only frame-time cost. Tests pin the observable shape.
+ */
+import { createSignal } from '../../reactivity';
+import { resampleBars } from './resampleBars';
+import { alignToBaseIndex } from './alignToBaseIndex';
+export function createMtfController(init = {}) {
+    let disposed = false;
+    let baseBars = init.initialBars ?? [];
+    let baseIntervalMs = init.baseIntervalMs ?? null;
+    const definitions = new Map();
+    const seriesSignal = createSignal([]);
+    const computeOne = (def) => {
+        // No bars or no base interval set → empty aligned values (length 0,
+        // matching the empty base buffer).
+        if (baseBars.length === 0 || baseIntervalMs === null) {
+            return { definition: def, alignedValues: [] };
+        }
+        const resampled = resampleBars(baseBars, baseIntervalMs, def.targetIntervalMs);
+        const values = def.compute(resampled);
+        if (values.length !== resampled.length) {
+            throw new KLineChartError('MTF_CONFIG_INVALID', `MtfController: compute fn for series "${def.id}" returned ` +
+                `${values.length} values for ${resampled.length} resampled bars; ` +
+                `length must match`);
+        }
+        const aligned = alignToBaseIndex(baseBars, resampled, values, def.targetIntervalMs);
+        return { definition: def, alignedValues: aligned };
+    };
+    const recomputeAll = () => {
+        const all = [];
+        for (const def of definitions.values()) {
+            all.push(computeOne(def));
+        }
+        seriesSignal.set(all);
+    };
+    const guard = () => !disposed;
+    const validateInterval = (targetMs) => {
+        if (!Number.isFinite(targetMs) || targetMs <= 0) {
+            throw new KLineChartError('MTF_CONFIG_INVALID', 'MtfController: targetIntervalMs must be > 0');
+        }
+        if (baseIntervalMs !== null && targetMs % baseIntervalMs !== 0) {
+            throw new KLineChartError('MTF_CONFIG_INVALID', `MtfController: targetIntervalMs (${targetMs}) must be an ` +
+                `integer multiple of baseIntervalMs (${baseIntervalMs})`);
+        }
+    };
+    const inner = {
+        series: seriesSignal,
+        setBaseBars(bars, intervalMs) {
+            if (!guard())
+                return;
+            if (!Number.isFinite(intervalMs) || intervalMs <= 0) {
+                throw new KLineChartError('MTF_CONFIG_INVALID', 'MtfController.setBaseBars: baseIntervalMs must be > 0');
+            }
+            // If any series has a target that no longer cleanly divides, throw
+            // up front rather than letting resampleBars throw later.
+            for (const def of definitions.values()) {
+                if (def.targetIntervalMs % intervalMs !== 0) {
+                    throw new KLineChartError('MTF_CONFIG_INVALID', `MtfController.setBaseBars: existing series "${def.id}" ` +
+                        `targetIntervalMs (${def.targetIntervalMs}) does not cleanly ` +
+                        `divide new baseIntervalMs (${intervalMs})`);
+                }
+            }
+            baseBars = bars;
+            baseIntervalMs = intervalMs;
+            recomputeAll();
+        },
+        addSeries(def) {
+            if (!guard())
+                return def.id;
+            if (definitions.has(def.id)) {
+                throw new KLineChartError('MTF_CONFIG_INVALID', `MtfController.addSeries: id "${def.id}" already in use`);
+            }
+            validateInterval(def.targetIntervalMs);
+            definitions.set(def.id, def);
+            recomputeAll();
+            return def.id;
+        },
+        removeSeries(id) {
+            if (!guard())
+                return false;
+            const had = definitions.delete(id);
+            if (had)
+                recomputeAll();
+            return had;
+        },
+        updateSeries(id, patch) {
+            if (!guard())
+                return false;
+            const existing = definitions.get(id);
+            if (existing === undefined)
+                return false;
+            const next = {
+                ...existing,
+                ...patch,
+                id: existing.id, // protect against accidental id mutation
+            };
+            if (patch.targetIntervalMs !== undefined) {
+                validateInterval(patch.targetIntervalMs);
+            }
+            definitions.set(id, next);
+            recomputeAll();
+            return true;
+        },
+        appendBaseBar(bar) {
+            if (!guard())
+                return;
+            baseBars = [...baseBars, bar];
+            recomputeAll();
+        },
+        dispose() {
+            disposed = true;
+            definitions.clear();
+        },
+    };
+    // Canonical verbs (API audit BLOCKER-001): `setData` for full
+    // replacement, `append` for single-item extension. Old names
+    // preserved as aliases on the inner object for the deprecation window.
+    return {
+        ...inner,
+        setData: inner.setBaseBars,
+        append: inner.appendBaseBar,
+    };
+}
+//# sourceMappingURL=createMtfController.js.map

package/dist/components/mtfOverlay/createMtfController.js.map

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

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

@@ -0,0 +1,19 @@
+/**
+ * Multi-Timeframe (MTF) overlay barrel.
+ *
+ * Public surface:
+ *   - `resampleBars`: aggregate base-tf bars into higher-tf buckets
+ *   - `alignToBaseIndex`: forward-fill higher-tf values onto base-bar indices
+ *     (no-lookahead semantics, see file docstring)
+ *   - `createMtfController`: composes the above + a user-supplied `compute`
+ *     into a reactive multi-series controller
+ *
+ * The controller is intentionally indicator-agnostic — any indicator (EMA,
+ * RSI, custom) can be lifted to MTF by passing a `compute` fn that takes
+ * resampled bars and returns one number per bar.
+ */
+export type { BaseBar, ResampledBar, MtfSeriesDefinition, ActiveMtfSeries, MtfController, } from './types';
+export { resampleBars } from './resampleBars';
+export { alignToBaseIndex } from './alignToBaseIndex';
+export { createMtfController, type CreateMtfControllerInit } from './createMtfController';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/mtfOverlay/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,YAAY,EACR,OAAO,EACP,YAAY,EACZ,mBAAmB,EACnB,eAAe,EACf,aAAa,GAChB,MAAM,SAAS,CAAA;AAEhB,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAC7C,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AACrD,OAAO,EAAE,mBAAmB,EAAE,KAAK,uBAAuB,EAAE,MAAM,uBAAuB,CAAA"}

package/dist/components/mtfOverlay/index.js

@@ -0,0 +1,18 @@
+/**
+ * Multi-Timeframe (MTF) overlay barrel.
+ *
+ * Public surface:
+ *   - `resampleBars`: aggregate base-tf bars into higher-tf buckets
+ *   - `alignToBaseIndex`: forward-fill higher-tf values onto base-bar indices
+ *     (no-lookahead semantics, see file docstring)
+ *   - `createMtfController`: composes the above + a user-supplied `compute`
+ *     into a reactive multi-series controller
+ *
+ * The controller is intentionally indicator-agnostic — any indicator (EMA,
+ * RSI, custom) can be lifted to MTF by passing a `compute` fn that takes
+ * resampled bars and returns one number per bar.
+ */
+export { resampleBars } from './resampleBars';
+export { alignToBaseIndex } from './alignToBaseIndex';
+export { createMtfController } from './createMtfController';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/components/mtfOverlay/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAUH,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAC7C,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AACrD,OAAO,EAAE,mBAAmB,EAAgC,MAAM,uBAAuB,CAAA"}

package/dist/components/mtfOverlay/resampleBars.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Resample a base-timeframe bar series to a higher timeframe.
+ *
+ * Two design choices worth pinning:
+ *
+ * 1. We bucket by **floor(timestamp / targetIntervalMs) * targetIntervalMs**,
+ *    not by counting base bars. This is robust to gaps in the input — a
+ *    1-minute series that skips 09:33 (the bar simply isn't there) will still
+ *    correctly group 09:30..09:34 into one 5m bucket and produce no synthetic
+ *    bar for 09:33.
+ *
+ * 2. The final bucket is allowed to be **partial** (contain fewer base bars
+ *    than `targetIntervalMs / baseIntervalMs`). This is the right default for
+ *    live charts: the forming bar must appear in the output so its EMA / RSI
+ *    can be plotted. Callers that want "closed bars only" should drop the
+ *    last element if `bucketEnd > lastBucketStart + targetIntervalMs - baseIntervalMs`
+ *    (or equivalently, if `sourceEnd - sourceStart + 1 < bucketSize`).
+ *
+ * Aggregation rules:
+ *   - timestamp = floor(firstBar.timestamp / targetIntervalMs) * targetIntervalMs
+ *   - open  = firstBar.open
+ *   - close = lastBar.close
+ *   - high  = max over [start, end]
+ *   - low   = min over [start, end]
+ *   - volume = sum over [start, end]
+ *   - sourceStart, sourceEnd = inclusive base-index range
+ */
+import type { BaseBar, ResampledBar } from './types';
+/**
+ * @internal — building block used by `createMtfController`. Reachable today
+ *   via the top-level `@klinechart-quant/core` barrel but **NOT
+ *   part of the supported public API**. typedoc / api-extractor
+ *   hide it from generated docs. Prefer the controller factory
+ *   for stable user code. Closes API audit BLOCKER-002.
+ */
+export declare function resampleBars(bars: ReadonlyArray<BaseBar>, baseIntervalMs: number, targetIntervalMs: number): ReadonlyArray<ResampledBar>;
+//# sourceMappingURL=resampleBars.d.ts.map

package/dist/components/mtfOverlay/resampleBars.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resampleBars.d.ts","sourceRoot":"","sources":["../../../src/components/mtfOverlay/resampleBars.ts"],"names":[],"mappings":"AACA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AAEpD;;;;;;GAMG;AACH,wBAAgB,YAAY,CACxB,IAAI,EAAE,aAAa,CAAC,OAAO,CAAC,EAC5B,cAAc,EAAE,MAAM,EACtB,gBAAgB,EAAE,MAAM,GACzB,aAAa,CAAC,YAAY,CAAC,CA2F7B"}

package/dist/components/mtfOverlay/resampleBars.js

@@ -0,0 +1,93 @@
+import { KLineChartError } from '../../errors';
+/**
+ * @internal — building block used by `createMtfController`. Reachable today
+ *   via the top-level `@klinechart-quant/core` barrel but **NOT
+ *   part of the supported public API**. typedoc / api-extractor
+ *   hide it from generated docs. Prefer the controller factory
+ *   for stable user code. Closes API audit BLOCKER-002.
+ */
+export function resampleBars(bars, baseIntervalMs, targetIntervalMs) {
+    if (!Number.isFinite(baseIntervalMs) || baseIntervalMs <= 0) {
+        throw new KLineChartError('MTF_CONFIG_INVALID', 'resampleBars: baseIntervalMs must be a positive finite number');
+    }
+    if (!Number.isFinite(targetIntervalMs) || targetIntervalMs <= 0) {
+        throw new KLineChartError('MTF_CONFIG_INVALID', 'resampleBars: targetIntervalMs must be a positive finite number');
+    }
+    if (targetIntervalMs % baseIntervalMs !== 0) {
+        throw new KLineChartError('MTF_CONFIG_INVALID', `resampleBars: targetIntervalMs (${targetIntervalMs}) must be an integer ` +
+            `multiple of baseIntervalMs (${baseIntervalMs}); got remainder ` +
+            `${targetIntervalMs % baseIntervalMs}`);
+    }
+    if (bars.length === 0)
+        return [];
+    // Fast path: no aggregation required. Caller may still want shape parity
+    // (each base bar gets sourceStart === sourceEnd === its own index), so we
+    // wrap each base bar as a 1-source-bar `ResampledBar`.
+    if (targetIntervalMs === baseIntervalMs) {
+        const out = new Array(bars.length);
+        for (let i = 0; i < bars.length; i++) {
+            const b = bars[i];
+            out[i] = {
+                timestamp: b.timestamp,
+                open: b.open,
+                high: b.high,
+                low: b.low,
+                close: b.close,
+                volume: b.volume,
+                sourceStart: i,
+                sourceEnd: i,
+            };
+        }
+        return out;
+    }
+    const out = [];
+    let bucketStart = -1; // inclusive index in `bars`
+    let bucketTs = 0;
+    let open = 0;
+    let high = -Infinity;
+    let low = Infinity;
+    let close = 0;
+    let volume = 0;
+    const flush = (endIdx) => {
+        if (bucketStart < 0)
+            return;
+        out.push({
+            timestamp: bucketTs,
+            open,
+            high,
+            low,
+            close,
+            volume,
+            sourceStart: bucketStart,
+            sourceEnd: endIdx,
+        });
+    };
+    for (let i = 0; i < bars.length; i++) {
+        const bar = bars[i];
+        const ts = Math.floor(bar.timestamp / targetIntervalMs) * targetIntervalMs;
+        if (bucketStart < 0 || ts !== bucketTs) {
+            // Boundary crossed (or first iteration). Flush the previous bucket.
+            if (bucketStart >= 0)
+                flush(i - 1);
+            bucketStart = i;
+            bucketTs = ts;
+            open = bar.open;
+            high = bar.high;
+            low = bar.low;
+            close = bar.close;
+            volume = bar.volume;
+            continue;
+        }
+        // Same bucket: fold this bar in.
+        if (bar.high > high)
+            high = bar.high;
+        if (bar.low < low)
+            low = bar.low;
+        close = bar.close;
+        volume += bar.volume;
+    }
+    // Final bucket — may be partial (fewer than targetIntervalMs/baseIntervalMs bars).
+    flush(bars.length - 1);
+    return out;
+}
+//# sourceMappingURL=resampleBars.js.map

package/dist/components/mtfOverlay/resampleBars.js.map

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

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

@@ -0,0 +1,132 @@
+/**
+ * Public types for the Multi-Timeframe (MTF) overlay module.
+ *
+ * Naming: "base" = the chart's primary timeframe (e.g. 5m), "higher tf" =
+ * the resampled timeframe an MTF series lives on (e.g. 1h). The module never
+ * downscales — you can only lift values from a coarser tf onto a finer one.
+ *
+ * Time semantics:
+ *   - Every `timestamp` is in milliseconds since the Unix epoch.
+ *   - A base bar's `timestamp` is the OPEN of that bar's interval (aligned
+ *     to `baseIntervalMs` boundary, implicitly).
+ *   - A resampled (higher-tf) bar's `timestamp` is the OPEN of its bucket,
+ *     computed as `floor(firstBaseBar.timestamp / targetIntervalMs) * targetIntervalMs`.
+ *   - A higher-tf bar's interval is `[timestamp, timestamp + targetIntervalMs)`.
+ *
+ * The MTF controller does NOT bring its own indicator math. The caller
+ * supplies a `compute` function that takes resampled bars and returns one
+ * number per resampled bar. Any indicator (EMA, RSI, custom) can be lifted
+ * to MTF by writing such a compute fn.
+ */
+import type { Signal } from '../../reactivity';
+/**
+ * One bar of the BASE timeframe (the chart's primary candle stream).
+ *
+ * `timestamp` is the bar's OPEN, expected to be aligned to `baseIntervalMs`.
+ * The module does not enforce alignment — it trusts the caller's stream.
+ */
+export interface BaseBar {
+    timestamp: number;
+    open: number;
+    high: number;
+    low: number;
+    close: number;
+    volume: number;
+}
+/**
+ * A bar produced by aggregating `[sourceStart, sourceEnd]` (inclusive
+ * indices into the input base-bar array) up to a higher timeframe.
+ *
+ * `sourceEnd === sourceStart` is allowed (single-base-bar bucket) — see
+ * the "partial last bucket" semantics in `resampleBars`.
+ */
+export interface ResampledBar extends BaseBar {
+    /** First base-bar index aggregated into this bucket (inclusive). */
+    sourceStart: number;
+    /** Last base-bar index aggregated into this bucket (inclusive). */
+    sourceEnd: number;
+}
+/**
+ * Definition of one MTF series. The controller owns the resampling and the
+ * alignment; the caller owns the indicator math (`compute`).
+ */
+export interface MtfSeriesDefinition {
+    /** Stable user-facing identifier. Re-using an existing id is rejected. */
+    id: string;
+    /** Display label, e.g. `"EMA(20) 1h"`. The controller never reads this. */
+    label: string;
+    /** Higher-tf bucket size in ms. Must be a positive multiple of base tf. */
+    targetIntervalMs: number;
+    /**
+     * Pure function: resampled bars → per-bar value array of the same length.
+     * Called once per `setBaseBars`, `addSeries`, `updateSeries`, and once per
+     * `appendBaseBar`. MUST NOT mutate the input.
+     */
+    compute: (resampledBars: ReadonlyArray<ResampledBar>) => ReadonlyArray<number>;
+}
+/**
+ * One active MTF series in the controller's snapshot.
+ *
+ * `alignedValues.length === baseBars.length` always holds after any state
+ * transition. Leading entries are `null` for base bars that fall before the
+ * first higher-tf bucket opens.
+ */
+export interface ActiveMtfSeries {
+    definition: MtfSeriesDefinition;
+    /**
+     * Forward-filled values aligned to the base bar index. Same length as the
+     * controller's base-bar buffer. `null` only where no higher-tf bar covers
+     * the base bar's timestamp (i.e. before the first bucket opens).
+     */
+    alignedValues: ReadonlyArray<number | null>;
+}
+/**
+ * Reactive MTF controller. The `series` signal updates synchronously on every
+ * state-mutating call (`setBaseBars`, `addSeries`, `removeSeries`,
+ * `updateSeries`, `appendBaseBar`). After `dispose()`, mutation calls become
+ * no-ops and the signal stops firing.
+ */
+export interface MtfController {
+    /** Current snapshot of every series with aligned values. */
+    readonly series: Signal<ReadonlyArray<ActiveMtfSeries>>;
+    /**
+     * Replace the base bar buffer in one shot and recompute every series —
+     * canonical method, aligned with the cross-controller `setData()`
+     * convention (AnchoredVwapController). Closes API audit BLOCKER-001.
+     * `baseIntervalMs` must evenly divide every series' `targetIntervalMs`.
+     */
+    setData(bars: ReadonlyArray<BaseBar>, baseIntervalMs: number): void;
+    /**
+     * @deprecated since 0.1.0-alpha.1 — use {@link MtfController.setData}.
+     * Preserved as a non-removing alias for at least 6 months.
+     */
+    setBaseBars(bars: ReadonlyArray<BaseBar>, baseIntervalMs: number): void;
+    /**
+     * Register a new series. Returns the series id.
+     * Throws if `def.id` is already in use or `targetIntervalMs` is not a
+     * positive multiple of the current `baseIntervalMs` (when bars are set).
+     */
+    addSeries(def: MtfSeriesDefinition): string;
+    /** Remove a series by id. Returns true if removed, false if not found. */
+    removeSeries(id: string): boolean;
+    /**
+     * Patch a series in place. Returns true if found.
+     * Re-runs `compute` whenever `targetIntervalMs` or `compute` changes.
+     */
+    updateSeries(id: string, patch: Partial<Omit<MtfSeriesDefinition, 'id'>>): boolean;
+    /**
+     * Append one base bar at the tail — canonical method, aligned with the
+     * cross-controller `append()` convention (AnchoredVwapController).
+     * Triggers a single per-series compute over the updated resampled
+     * bars — NOT a from-scratch recompute over the whole base buffer.
+     */
+    append(bar: BaseBar): void;
+    /**
+     * @deprecated since 0.1.0-alpha.1 — use {@link MtfController.append}.
+     * Preserved as a non-removing alias for at least 6 months.
+     */
+    appendBaseBar(bar: BaseBar): void;
+    /** Tear down. After this, all mutators are no-ops; the signal stops. */
+    dispose(): void;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/components/mtfOverlay/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAA;AAE9C;;;;;GAKG;AACH,MAAM,WAAW,OAAO;IACpB,SAAS,EAAE,MAAM,CAAA;IACjB,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;CACjB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,YAAa,SAAQ,OAAO;IACzC,oEAAoE;IACpE,WAAW,EAAE,MAAM,CAAA;IACnB,mEAAmE;IACnE,SAAS,EAAE,MAAM,CAAA;CACpB;AAED;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IAChC,0EAA0E;IAC1E,EAAE,EAAE,MAAM,CAAA;IACV,2EAA2E;IAC3E,KAAK,EAAE,MAAM,CAAA;IACb,2EAA2E;IAC3E,gBAAgB,EAAE,MAAM,CAAA;IACxB;;;;OAIG;IACH,OAAO,EAAE,CAAC,aAAa,EAAE,aAAa,CAAC,YAAY,CAAC,KAAK,aAAa,CAAC,MAAM,CAAC,CAAA;CACjF;AAED;;;;;;GAMG;AACH,MAAM,WAAW,eAAe;IAC5B,UAAU,EAAE,mBAAmB,CAAA;IAC/B;;;;OAIG;IACH,aAAa,EAAE,aAAa,CAAC,MAAM,GAAG,IAAI,CAAC,CAAA;CAC9C;AAED;;;;;GAKG;AACH,MAAM,WAAW,aAAa;IAC1B,4DAA4D;IAC5D,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,aAAa,CAAC,eAAe,CAAC,CAAC,CAAA;IAEvD;;;;;OAKG;IACH,OAAO,CAAC,IAAI,EAAE,aAAa,CAAC,OAAO,CAAC,EAAE,cAAc,EAAE,MAAM,GAAG,IAAI,CAAA;IAEnE;;;OAGG;IACH,WAAW,CAAC,IAAI,EAAE,aAAa,CAAC,OAAO,CAAC,EAAE,cAAc,EAAE,MAAM,GAAG,IAAI,CAAA;IAEvE;;;;OAIG;IACH,SAAS,CAAC,GAAG,EAAE,mBAAmB,GAAG,MAAM,CAAA;IAE3C,0EAA0E;IAC1E,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAA;IAEjC;;;OAGG;IACH,YAAY,CACR,EAAE,EAAE,MAAM,EACV,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,mBAAmB,EAAE,IAAI,CAAC,CAAC,GAChD,OAAO,CAAA;IAEV;;;;;OAKG;IACH,MAAM,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI,CAAA;IAE1B;;;OAGG;IACH,aAAa,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI,CAAA;IAEjC,wEAAwE;IACxE,OAAO,IAAI,IAAI,CAAA;CAClB"}

package/dist/components/mtfOverlay/types.js

@@ -0,0 +1,22 @@
+/**
+ * Public types for the Multi-Timeframe (MTF) overlay module.
+ *
+ * Naming: "base" = the chart's primary timeframe (e.g. 5m), "higher tf" =
+ * the resampled timeframe an MTF series lives on (e.g. 1h). The module never
+ * downscales — you can only lift values from a coarser tf onto a finer one.
+ *
+ * Time semantics:
+ *   - Every `timestamp` is in milliseconds since the Unix epoch.
+ *   - A base bar's `timestamp` is the OPEN of that bar's interval (aligned
+ *     to `baseIntervalMs` boundary, implicitly).
+ *   - A resampled (higher-tf) bar's `timestamp` is the OPEN of its bucket,
+ *     computed as `floor(firstBaseBar.timestamp / targetIntervalMs) * targetIntervalMs`.
+ *   - A higher-tf bar's interval is `[timestamp, timestamp + targetIntervalMs)`.
+ *
+ * The MTF controller does NOT bring its own indicator math. The caller
+ * supplies a `compute` function that takes resampled bars and returns one
+ * number per resampled bar. Any indicator (EMA, RSI, custom) can be lifted
+ * to MTF by writing such a compute fn.
+ */
+export {};
+//# sourceMappingURL=types.js.map

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

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

package/dist/components/orderBookHeatmap/createHeatmapController.d.ts

@@ -0,0 +1,21 @@
+/**
+ * HeatmapController — composes the order-book accumulator, snapshot ring,
+ * and delta archive into a single reactive surface.
+ *
+ * Timing (this is load-bearing): we do **not** schedule snapshots via
+ * `setInterval`. The controller treats incoming delta timestamps as the
+ * wall clock. When `ingestDelta` sees a delta whose timestamp is more than
+ * `snapshotIntervalMs` after the previous snapshot, it pushes a snapshot
+ * before applying the new delta. Two upsides:
+ *
+ *   1. Deterministic tests — no fake timers required.
+ *   2. Correct under bursty traffic — snapshot cadence follows market time,
+ *      not real time, so replay and live observation see the same grid.
+ *
+ * The `state` signal updates once per delta ingested. It exposes the
+ * **latest** snapshot (for read-time convenience) plus the cumulative
+ * snapshot / delta counts so adapters can use it as a render trigger.
+ */
+import type { HeatmapController, HeatmapControllerConfig } from './types';
+export declare function createHeatmapController(init?: Partial<HeatmapControllerConfig>): HeatmapController;
+//# sourceMappingURL=createHeatmapController.d.ts.map

package/dist/components/orderBookHeatmap/createHeatmapController.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createHeatmapController.d.ts","sourceRoot":"","sources":["../../../src/components/orderBookHeatmap/createHeatmapController.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAQH,OAAO,KAAK,EAGR,iBAAiB,EACjB,uBAAuB,EAM1B,MAAM,SAAS,CAAA;AAUhB,wBAAgB,uBAAuB,CACnC,IAAI,CAAC,EAAE,OAAO,CAAC,uBAAuB,CAAC,GACxC,iBAAiB,CA8MnB"}