@363045841yyt/klinechart-core 0.8.14 → 0.9.0-alpha.0

package/dist/features/input/keyboard.js.map

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

package/dist/features/mcp/chartBridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chartBridge.d.ts","sourceRoot":"","sources":["../../../src/features/mcp/chartBridge.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAwB,qBAAqB,EAAE,eAAe,EAAE,MAAM,SAAS,CAAA;AAE3F,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAA;IACb,UAAU,EAAE,eAAe,CAAA;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,MAAM,CAAC,EAAE,KAAK,GAAG,EAAE,MAAM,KAAK,SAAS,CAAA;CACxC;AAED,MAAM,MAAM,gBAAgB,GAAG,WAAW,GAAG,cAAc,GAAG,OAAO,GAAG,cAAc,CAAA;AAEtF,KAAK,cAAc,GAAG,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAA;AAElD,qBAAa,WAAW;IACtB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAQ;IACvC,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAQ;IAC1C,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAQ;IAC1C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAiB;IAE5C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgC;IACvD,OAAO,CAAC,EAAE,CAAyB;IACnC,OAAO,CAAC,eAAe,CAAiC;IACxD,OAAO,CAAC,eAAe,CAAiC;IACxD,OAAO,CAAC,iBAAiB,CAAI;IAC7B,OAAO,CAAC,SAAS,CAAQ;IAEzB,OAAO,CAAC,SAAS,CAAmD;IAEpE,WAAW,CAAC,EAAE,MAAM,IAAI,CAAA;IACxB,cAAc,CAAC,EAAE,MAAM,IAAI,CAAA;IAC3B,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,KAAK,KAAK,IAAI,CAAA;IAC9B,aAAa,CAAC,EAAE,MAAM,IAAI,CAAA;gBAEd,OAAO,EAAE,kBAAkB;IAWvC,OAAO,CAAC,KAAK,CAAQ;IAEf,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAgE9B,UAAU,IAAI,IAAI;IAOlB,OAAO,IAAI,IAAI;IAOf,OAAO,CAAC,aAAa;YAmBP,gBAAgB;IAU9B,OAAO,CAAC,UAAU;IAUlB,eAAe,CAAC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAAC,GAAG,IAAI;IAU1E,OAAO,CAAC,cAAc;IAiBtB,OAAO,CAAC,aAAa;IAOrB,OAAO,CAAC,iBAAiB;IA2BzB,OAAO,CAAC,eAAe;IAOvB,OAAO,CAAC,IAAI;IAIZ,EAAE,CAAC,KAAK,EAAE,gBAAgB,EAAE,OAAO,EAAE,cAAc,GAAG,MAAM,IAAI;IAQhE,GAAG,CAAC,KAAK,EAAE,gBAAgB,EAAE,OAAO,EAAE,cAAc,GAAG,IAAI;CAG5D"}

package/dist/features/mcp/chartBridge.js

@@ -0,0 +1,186 @@
+import { Effect, Fiber, pipe, Schedule } from 'effect';
+import { KLineChartError } from '../../errors';
+import { generateUUID } from '../../foundation/utils/uuid';
+export class ChartBridge {
+    sessionId;
+    autoReconnect;
+    reconnectDelay;
+    maxReconnectDelay;
+    heartbeatInterval;
+    onToolCall;
+    wsImpl;
+    ws = null;
+    _heartbeatFiber = null;
+    _reconnectFiber = null;
+    _reconnectAttempt = 0;
+    destroyed = false;
+    listeners = new Map();
+    onConnected;
+    onDisconnected;
+    onError;
+    onStateChange;
+    constructor(options) {
+        this.sessionId = options.sessionId ?? generateUUID();
+        this.autoReconnect = options.autoReconnect ?? true;
+        this.reconnectDelay = options.reconnectDelay ?? 3000;
+        this.maxReconnectDelay = options.maxReconnectDelay ?? 30_000;
+        this.heartbeatInterval = options.heartbeatInterval ?? 30_000;
+        this.onToolCall = options.onToolCall;
+        this.wsImpl = options.wsImpl ?? WebSocket;
+        this.wsUrl = options.wsUrl;
+    }
+    wsUrl;
+    async connect() {
+        if (this.destroyed)
+            return;
+        this.disconnect();
+        await Effect.runPromise(pipe(Effect.async((resume) => {
+            try {
+                const ws = new this.wsImpl(this.wsUrl);
+                ws.onopen = () => {
+                    this._reconnectAttempt = 0;
+                    this.ws = ws;
+                    console.info(`[ChartBridge] WS opened → sending register (sessionId=${this.sessionId})`);
+                    ws.send(JSON.stringify({ type: 'register', sessionId: this.sessionId }));
+                    this.startHeartbeat();
+                    this.onConnected?.();
+                    this.emit('connected');
+                    resume(Effect.succeed(undefined));
+                };
+                ws.onmessage = (event) => {
+                    let msg;
+                    try {
+                        msg = JSON.parse(event.data);
+                    }
+                    catch {
+                        return;
+                    }
+                    this.handleMessage(msg);
+                };
+                ws.onclose = () => {
+                    console.warn(`[ChartBridge] WS closed, autoReconnect=${this.autoReconnect}`);
+                    this.ws = null;
+                    this.stopHeartbeat();
+                    this.onDisconnected?.();
+                    this.emit('disconnected');
+                    if (this.autoReconnect && !this.destroyed) {
+                        this.scheduleReconnect();
+                    }
+                };
+                ws.onerror = () => {
+                    console.error(`[ChartBridge] WS error — connection failed`);
+                    const err = new KLineChartError('FETCH_FAILED', 'WebSocket connection failed');
+                    this.onError?.(err);
+                    this.emit('error', err);
+                    resume(Effect.fail(err));
+                };
+            }
+            catch (err) {
+                resume(Effect.fail(err));
+            }
+        }), Effect.timeout('15 seconds'), Effect.mapError((err) => {
+            if (err instanceof KLineChartError)
+                return err;
+            return new KLineChartError('FETCH_FAILED', `Connection failed: ${String(err)}`);
+        })));
+    }
+    disconnect() {
+        this.ws?.close();
+        this.ws = null;
+        this.cancelReconnect();
+        this.stopHeartbeat();
+    }
+    destroy() {
+        this.destroyed = true;
+        this._reconnectAttempt = 0;
+        this.disconnect();
+        this.listeners.clear();
+    }
+    handleMessage(msg) {
+        switch (msg.type) {
+            case 'registered':
+                break;
+            case 'tool:call': {
+                const call = msg.call;
+                const requestId = msg.requestId;
+                this.dispatchToolCall(requestId, call);
+                break;
+            }
+            case 'ping': {
+                this.ws?.send(JSON.stringify({ type: 'pong' }));
+                break;
+            }
+        }
+    }
+    async dispatchToolCall(requestId, call) {
+        const result = await this.onToolCall(call);
+        this.sendResult(requestId, result);
+        if (this.onStateChange) {
+            this.onStateChange();
+        }
+        this.emit('stateChanged');
+    }
+    sendResult(requestId, result) {
+        this.ws?.send(JSON.stringify({
+            type: 'tool:result',
+            requestId,
+            result,
+        }));
+    }
+    sendStateUpdate(descriptions) {
+        this.ws?.send(JSON.stringify({
+            type: 'state:update',
+            sessionId: this.sessionId,
+            descriptions,
+        }));
+    }
+    startHeartbeat() {
+        this.stopHeartbeat();
+        this._heartbeatFiber = Effect.runFork(pipe(Effect.repeat(Effect.sync(() => {
+            if (this.ws?.readyState === 1) {
+                this.ws.send(JSON.stringify({ type: 'ping' }));
+            }
+        }), Schedule.fixed(this.heartbeatInterval)), Effect.asVoid));
+    }
+    stopHeartbeat() {
+        if (this._heartbeatFiber) {
+            Fiber.interrupt(this._heartbeatFiber);
+            this._heartbeatFiber = null;
+        }
+    }
+    scheduleReconnect() {
+        this.cancelReconnect();
+        const attempt = this._reconnectAttempt;
+        this._reconnectAttempt = attempt + 1;
+        const base = this.reconnectDelay;
+        const exponential = Math.min(base * Math.pow(2, attempt), this.maxReconnectDelay);
+        const jitter = 0.5 + Math.random() * 0.5;
+        const delay = Math.round(exponential * jitter);
+        this._reconnectFiber = Effect.runFork(pipe(Effect.sleep(delay), Effect.tap(() => Effect.sync(() => {
+            if (!this.destroyed) {
+                console.info(`[ChartBridge] reconnect scheduled in ${delay}ms (attempt ${attempt + 1})`);
+                this.connect().catch(() => { });
+            }
+        }))));
+    }
+    cancelReconnect() {
+        if (this._reconnectFiber) {
+            Fiber.interrupt(this._reconnectFiber);
+            this._reconnectFiber = null;
+        }
+    }
+    emit(event, ...args) {
+        this.listeners.get(event)?.forEach((fn) => fn(...args));
+    }
+    on(event, handler) {
+        if (!this.listeners.has(event)) {
+            this.listeners.set(event, new Set());
+        }
+        this.listeners.get(event).add(handler);
+        return () => this.listeners.get(event)?.delete(handler);
+    }
+    off(event, handler) {
+        this.listeners.get(event)?.delete(handler);
+    }
+}
+//# sourceMappingURL=chartBridge.js.map

package/dist/features/mcp/chartBridge.js.map

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

package/dist/features/mcp/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/features/mcp/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,KAAK,kBAAkB,EAAE,KAAK,gBAAgB,EAAE,MAAM,eAAe,CAAA;AAC3F,YAAY,EAAE,QAAQ,EAAE,UAAU,EAAE,qBAAqB,EAAE,eAAe,EAAE,MAAM,SAAS,CAAA"}

package/dist/features/mcp/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/features/mcp/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAkD,MAAM,eAAe,CAAA"}

package/dist/features/mcp/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/features/mcp/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAC/B;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,OAAO,CAAA;IAChB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,IAAI,CAAC,EAAE,OAAO,CAAA;CACf;AAED,MAAM,MAAM,eAAe,GAAG,CAAC,IAAI,EAAE,QAAQ,KAAK,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,CAAA;AAElF,MAAM,WAAW,qBAAqB;IACpC,YAAY,EAAE,MAAM,CAAA;IACpB,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC,CAAC,CAAA;IACjE,QAAQ,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAA;CACjC"}

package/dist/features/mcp/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/features/mcp/types.ts"],"names":[],"mappings":""}

package/dist/features/replay/createReplayController.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createReplayController.d.ts","sourceRoot":"","sources":["../../../src/features/replay/createReplayController.ts"],"names":[],"mappings":"AA0BA,OAAO,KAAK,EACV,gBAAgB,EAChB,oBAAoB,EAIrB,MAAM,SAAS,CAAA;AAwDhB,wBAAgB,sBAAsB,CAAC,IAAI,CAAC,EAAE,oBAAoB,GAAG,gBAAgB,CA8MpF"}

package/dist/features/replay/createReplayController.js

@@ -0,0 +1,249 @@
+import { KLineChartError } from '../../errors';
+/**
+ * createReplayController — framework-agnostic Bar Replay state machine.
+ *
+ * Owns: position, mode, pacing, speed, [start, end] range.
+ * Doesn't own: the data series, the calendar, the frame loop. Those are
+ * supplied by the surrounding chart adapter.
+ *
+ * Why we expose it via a single `state` signal (rather than five separate
+ * signals): every replay mutation is a transaction over the playhead — the
+ * mode flip on auto-pause, the clamp on `setRange`, etc. Emitting a single
+ * snapshot keeps subscribers (React/Vue) from rendering intermediate states.
+ *
+ * Open design question (deferred from v1):
+ *   Should "reverse play" (speed < 0) be supported in v2?
+ *   The cleanest extension is to drop the `speed <= 0` guard, accept negative
+ *   multipliers in `tick()` math (already symmetric), and add an
+ *   `autoStartReached` clamp that mirrors `autoEndReached`. The on-disk
+ *   contract (the `ReplayState` shape) does not need to change. We defer it
+ *   because reverse playback is meaningless for live-data sessions and the
+ *   indicator runtime currently assumes monotonic time — flipping that
+ *   assumption is a larger cross-package change than this PR.
+ */
+import { createSignal } from '../../foundation/reactivity/signal';
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+/** Default bar interval used by wall-clock pacing when the host did not
+ *  supply one via `init.barIntervalMs`. Picked to match the most common
+ *  intraday chart (1-minute bars). */
+const DEFAULT_BAR_INTERVAL_MS = 60_000;
+/** For `tick` pacing, this is the nominal wall-time spent on one bar at
+ *  speed=1. 100ms means a 60-bar tick replay takes 6 seconds at 1x — fast
+ *  enough to feel like "tick playback", slow enough to follow visually. */
+const TICK_PACING_MS_PER_BAR = 100;
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function clamp(value, lo, hi) {
+    if (value < lo)
+        return lo;
+    if (value > hi)
+        return hi;
+    return value;
+}
+function assertValidRange(start, end) {
+    if (!Number.isFinite(start) || !Number.isFinite(end)) {
+        throw new KLineChartError('REPLAY_CONFIG_INVALID', `Replay range must be finite numbers: got start=${String(start)}, end=${String(end)}`);
+    }
+    if (end < start) {
+        throw new KLineChartError('REPLAY_CONFIG_INVALID', `Replay range end (${end}) must be >= start (${start})`);
+    }
+}
+function assertValidSpeed(speed) {
+    if (!Number.isFinite(speed) || speed <= 0) {
+        // Reverse playback (negative speed) is deliberately rejected in v1.
+        // See the header comment for the extension path.
+        throw new KLineChartError('REPLAY_CONFIG_INVALID', `Replay speed must be a positive finite number; got ${String(speed)}`);
+    }
+}
+// ---------------------------------------------------------------------------
+// Factory
+// ---------------------------------------------------------------------------
+export function createReplayController(init) {
+    // -------------------------------------------------------------------
+    // Initial state — validate eagerly so misconfiguration surfaces at
+    // construction rather than on first tick.
+    // -------------------------------------------------------------------
+    const start = init?.start ?? 0;
+    const end = init?.end ?? 0;
+    assertValidRange(start, end);
+    const pacing = init?.pacing ?? 'bar';
+    const speed = init?.speed ?? 1;
+    assertValidSpeed(speed);
+    const barIntervalMs = init?.barIntervalMs ?? DEFAULT_BAR_INTERVAL_MS;
+    if (!Number.isFinite(barIntervalMs) || barIntervalMs <= 0) {
+        throw new KLineChartError('REPLAY_CONFIG_INVALID', `barIntervalMs must be a positive finite number; got ${String(barIntervalMs)}`);
+    }
+    const state = createSignal({
+        position: start,
+        start,
+        end,
+        mode: 'paused',
+        pacing,
+        speed,
+    });
+    // -------------------------------------------------------------------
+    // Internal commit helper. All mutations funnel through here so the
+    // immutability invariant and auto-pause check live in one place.
+    // -------------------------------------------------------------------
+    function commit(patch) {
+        const prev = state.peek();
+        const next = { ...prev, ...patch };
+        // Re-clamp position whenever it or the range changed.
+        if (patch.position !== undefined || patch.start !== undefined || patch.end !== undefined) {
+            next.position = clamp(next.position, next.start, next.end);
+        }
+        // Auto-pause when the playhead arrives at the right edge while
+        // playing. This is the natural end-of-tape transition; without it,
+        // the frame loop would happily tick forever against a clamped
+        // value and waste battery.
+        if (next.mode === 'playing' && next.position >= next.end) {
+            next.position = next.end;
+            next.mode = 'paused';
+        }
+        // Object.is short-circuits identical structural snapshots so a
+        // no-op commit (e.g. seekTo(currentPosition)) doesn't notify.
+        if (prev.position === next.position &&
+            prev.start === next.start &&
+            prev.end === next.end &&
+            prev.mode === next.mode &&
+            prev.pacing === next.pacing &&
+            prev.speed === next.speed) {
+            return;
+        }
+        state.set(next);
+    }
+    // -------------------------------------------------------------------
+    // Public mutators
+    // -------------------------------------------------------------------
+    function setRange(nextStart, nextEnd) {
+        assertValidRange(nextStart, nextEnd);
+        commit({ start: nextStart, end: nextEnd });
+    }
+    function seekTo(position) {
+        if (!Number.isFinite(position))
+            return;
+        commit({ position });
+    }
+    function seekBy(delta) {
+        if (!Number.isFinite(delta))
+            return;
+        const cur = state.peek().position;
+        commit({ position: cur + delta });
+    }
+    function stepForward() {
+        seekBy(1);
+    }
+    function stepBackward() {
+        seekBy(-1);
+    }
+    function play() {
+        const cur = state.peek();
+        // If we're already at the end, calling play() should not flip to
+        // 'playing' only to immediately auto-pause — that would be a
+        // confusing observable transition for subscribers. Stay paused.
+        if (cur.position >= cur.end)
+            return;
+        commit({ mode: 'playing' });
+    }
+    function pause() {
+        commit({ mode: 'paused' });
+    }
+    function toggle() {
+        const cur = state.peek();
+        if (cur.mode === 'playing') {
+            pause();
+        }
+        else {
+            play();
+        }
+    }
+    function setPacing(p) {
+        commit({ pacing: p });
+    }
+    function setSpeed(s) {
+        assertValidSpeed(s);
+        commit({ speed: s });
+    }
+    // -------------------------------------------------------------------
+    // Frame-loop driver
+    //
+    // `tick()` is deliberately stateless w.r.t. internal clock
+    // accumulation: each call applies the full advance derived from
+    // `deltaMs` directly to `position`. We DO carry fractional position
+    // values forward through the signal itself, so sub-bar progress is
+    // visible to subscribers (useful for smooth scrubbing animations and
+    // for sub-bar interpolation in the renderer).
+    //
+    // Rationale: a stateful internal accumulator would hide state from
+    // the signal, defeating the "fully observable" property that
+    // distinguishes us from TradingView. Anyone driving the controller
+    // can save/restore the entire replay session by snapshotting the
+    // state signal — no hidden bookkeeping.
+    // -------------------------------------------------------------------
+    function tick(deltaMs) {
+        if (!Number.isFinite(deltaMs) || deltaMs <= 0)
+            return false;
+        const cur = state.peek();
+        if (cur.mode !== 'playing')
+            return false;
+        let advance = 0;
+        switch (cur.pacing) {
+            case 'bar':
+                // Bar pacing is keyboard-driven: tick() never auto-advances.
+                return false;
+            case 'wallclock':
+                advance = (deltaMs / barIntervalMs) * cur.speed;
+                break;
+            case 'tick':
+                advance = (deltaMs / TICK_PACING_MS_PER_BAR) * cur.speed;
+                break;
+        }
+        if (advance === 0)
+            return false;
+        const prevPosition = cur.position;
+        commit({ position: cur.position + advance });
+        // commit() may have clamped or auto-paused; the only way position
+        // genuinely did not change is if we were already at end and the
+        // clamp swallowed the advance.
+        return state.peek().position !== prevPosition;
+    }
+    // -------------------------------------------------------------------
+    // Disposal — same guard pattern as createIndicatorSelectorController.
+    // -------------------------------------------------------------------
+    let disposed = false;
+    function dispose() {
+        if (disposed)
+            return;
+        disposed = true;
+    }
+    function guard(fn) {
+        return (...args) => {
+            if (disposed)
+                return undefined;
+            return fn(...args);
+        };
+    }
+    return {
+        state,
+        setRange: guard(setRange),
+        seekTo: guard(seekTo),
+        seekBy: guard(seekBy),
+        stepForward: guard(stepForward),
+        stepBackward: guard(stepBackward),
+        play: guard(play),
+        pause: guard(pause),
+        toggle: guard(toggle),
+        setPacing: guard(setPacing),
+        setSpeed: guard(setSpeed),
+        tick: (deltaMs) => {
+            if (disposed)
+                return false;
+            return tick(deltaMs);
+        },
+        dispose,
+    };
+}
+//# sourceMappingURL=createReplayController.js.map

package/dist/features/replay/createReplayController.js.map

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

package/dist/features/replay/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/features/replay/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,UAAU,EACV,YAAY,EACZ,WAAW,EACX,gBAAgB,EAChB,oBAAoB,EACpB,sBAAsB,GACvB,MAAM,SAAS,CAAA;AAChB,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAA;AACjE,OAAO,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAA;AACzF,YAAY,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA"}

package/dist/features/replay/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/features/replay/index.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAA;AACjE,OAAO,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAA"}

package/dist/features/replay/timeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeline.d.ts","sourceRoot":"","sources":["../../../src/features/replay/timeline.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH;+DAC+D;AAC/D,MAAM,MAAM,WAAW,GAAG,aAAa,CAAC,MAAM,CAAC,CAAA;AAE/C;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAO1F;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,WAAW,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAsBpF;AAED;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,WAAW,GAAG,MAAM,GAAG,IAAI,CAkBvE"}

package/dist/features/replay/timeline.js.map

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

package/dist/features/replay/types.d.ts

@@ -0,0 +1,94 @@
+/**
+ * Bar Replay — public types.
+ *
+ * The replay subsystem models a playhead that scrubs through a finite bar
+ * series. Three pacing strategies are supported:
+ *
+ *   - `bar`       step-by-bar; `tick()` is a no-op, callers drive position
+ *                 via `stepForward` / `stepBackward` (keyboard-driven).
+ *   - `wallclock` real-time playback; `tick(deltaMs)` advances by
+ *                 `(deltaMs / msPerBar) * speed` bars. `speed` is a
+ *                 multiplier (1 = realtime, 10 = 10x).
+ *   - `tick`      synthetic tick replay; `tick(deltaMs)` advances by
+ *                 `(deltaMs / 100) * speed` bars (100ms per nominal step).
+ *
+ * Why this matters: TradingView's Bar Replay is wall-clock only and hides its
+ * state. Ours is observable via the `state` signal — any backtest engine,
+ * recording session, or sibling controller can subscribe and react to
+ * playhead changes deterministically.
+ */
+import type { Signal } from '../../foundation/reactivity/signal';
+export type ReplayMode = 'paused' | 'playing';
+export type ReplayPacing = 'bar' | 'wallclock' | 'tick';
+export interface ReplayState {
+    /** Position in the full data series; fractional values are allowed and
+     *  represent sub-bar progress for wall-clock / tick pacing. Callers that
+     *  need an integer bar index should `Math.floor(position)`. */
+    position: number;
+    /** Inclusive lower bound of the playhead (clamp floor). */
+    start: number;
+    /** Inclusive upper bound of the playhead (clamp ceiling). Typically
+     *  `totalBars - 1`. */
+    end: number;
+    mode: ReplayMode;
+    pacing: ReplayPacing;
+    /** Pacing-dependent rate:
+     *  - `wallclock`: multiplier (1.0 = realtime).
+     *  - `bar`:       reserved; ignored by `tick()`.
+     *  - `tick`:      multiplier (1.0 = 1 bar per 100ms). */
+    speed: number;
+}
+export interface ReplayControllerInit {
+    start?: number;
+    end?: number;
+    pacing?: ReplayPacing;
+    speed?: number;
+    /** Bar interval in milliseconds. Used by wall-clock pacing to compute
+     *  how many bars one wall-second represents. Defaults to 60_000 (1m). */
+    barIntervalMs?: number;
+}
+export interface ReplayController {
+    /** Reactive view of the entire replay state. Subscribers fire after any
+     *  mutation that changes the state object (Object.is equality). */
+    readonly state: Signal<ReplayState>;
+    /** Set the inclusive `[start, end]` range. The current position is
+     *  re-clamped into the new range. Throws if `end < start`. */
+    setRange(start: number, end: number): void;
+    /** Seek the playhead to an absolute position; clamped to `[start, end]`. */
+    seekTo(position: number): void;
+    /** Seek by a relative delta; clamped to `[start, end]`. */
+    seekBy(delta: number): void;
+    /** Advance exactly one bar (`position += 1`), clamped to `end`. If the
+     *  step lands on `end`, mode transitions to `paused`. */
+    stepForward(): void;
+    /** Retreat exactly one bar (`position -= 1`), clamped to `start`. */
+    stepBackward(): void;
+    /** Begin playback from the current position using the configured
+     *  pacing/speed. If already at `end`, this is a no-op. */
+    play(): void;
+    pause(): void;
+    /** Toggle between `playing` and `paused`. */
+    toggle(): void;
+    setPacing(p: ReplayPacing): void;
+    /** Set the speed multiplier. Throws on `speed <= 0` (reverse play not
+     *  supported in v1 — see Open Question in the controller header). */
+    setSpeed(s: number): void;
+    /** Frame-loop hook. The chart's render loop calls this with the elapsed
+     *  wall-clock time since the last frame; the controller decides whether
+     *  to advance `position` based on `mode`, `pacing`, and `speed`.
+     *
+     *  Returns `true` if `position` (and therefore `state`) changed, so the
+     *  caller can request a re-render. Returns `false` for no-op frames
+     *  (paused, bar-pacing, or sub-bar accumulation that didn't cross a
+     *  whole-bar boundary — though in this v1 we keep `tick()` stateless and
+     *  always commit the fractional advance, so any non-zero advance returns
+     *  `true`). */
+    tick(deltaMs: number): boolean;
+    /** Tear down. After `dispose()`, all mutators become silent no-ops and
+     *  the `state` signal stops emitting. */
+    dispose(): void;
+}
+/** Factory shape — matches the exported function. Re-stated here so callers
+ *  importing only the types file can type-check controller construction. */
+export type CreateReplayController = (init?: ReplayControllerInit) => ReplayController;
+//# sourceMappingURL=types.d.ts.map

package/dist/features/replay/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/features/replay/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oCAAoC,CAAA;AAEhE,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,SAAS,CAAA;AAC7C,MAAM,MAAM,YAAY,GAAG,KAAK,GAAG,WAAW,GAAG,MAAM,CAAA;AAEvD,MAAM,WAAW,WAAW;IAC1B;;mEAE+D;IAC/D,QAAQ,EAAE,MAAM,CAAA;IAChB,2DAA2D;IAC3D,KAAK,EAAE,MAAM,CAAA;IACb;2BACuB;IACvB,GAAG,EAAE,MAAM,CAAA;IACX,IAAI,EAAE,UAAU,CAAA;IAChB,MAAM,EAAE,YAAY,CAAA;IACpB;;;6DAGyD;IACzD,KAAK,EAAE,MAAM,CAAA;CACd;AAED,MAAM,WAAW,oBAAoB;IACnC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,MAAM,CAAC,EAAE,YAAY,CAAA;IACrB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd;6EACyE;IACzE,aAAa,CAAC,EAAE,MAAM,CAAA;CACvB;AAED,MAAM,WAAW,gBAAgB;IAC/B;uEACmE;IACnE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,WAAW,CAAC,CAAA;IAEnC;kEAC8D;IAC9D,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;IAE1C,4EAA4E;IAC5E,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IAC9B,2DAA2D;IAC3D,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B;6DACyD;IACzD,WAAW,IAAI,IAAI,CAAA;IACnB,qEAAqE;IACrE,YAAY,IAAI,IAAI,CAAA;IAEpB;8DAC0D;IAC1D,IAAI,IAAI,IAAI,CAAA;IACZ,KAAK,IAAI,IAAI,CAAA;IACb,6CAA6C;IAC7C,MAAM,IAAI,IAAI,CAAA;IAEd,SAAS,CAAC,CAAC,EAAE,YAAY,GAAG,IAAI,CAAA;IAChC;yEACqE;IACrE,QAAQ,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAEzB;;;;;;;;;mBASe;IACf,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAA;IAE9B;6CACyC;IACzC,OAAO,IAAI,IAAI,CAAA;CAChB;AAED;4EAC4E;AAC5E,MAAM,MAAM,sBAAsB,GAAG,CAAC,IAAI,CAAC,EAAE,oBAAoB,KAAK,gBAAgB,CAAA"}

package/dist/features/replay/types.js.map

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