@invinite-org/chartlang-runtime 1.1.0 → 1.2.0

package/dist/request/securityExprRunner.d.ts

@@ -0,0 +1,133 @@
+import type { Bar, ScriptManifest, SecurityBar, SecurityExpr } from "@invinite-org/chartlang-core";
+import { type RuntimeContext } from "../runtimeContext.js";
+import { Float64RingBuffer } from "../ringBuffer.js";
+import { type StreamState } from "../streamState.js";
+/**
+ * One mounted higher-timeframe expression unit. The compiler records each
+ * `request.security({ interval }, (bar) => …)` callsite in
+ * `manifest.securityExpressions`; the runtime mounts one runner per entry.
+ *
+ * The runner owns a dedicated fold {@link StreamState} clocked on the HTF
+ * `interval`, a `Float64RingBuffer` output buffer (one sampled value per HTF
+ * bar), a fold {@link SecurityBar} view backed by the fold stream's head, and
+ * a private {@link RuntimeContext} (`stream = foldStream`,
+ * `slotIdPrefix = "security:<slotId>/"`) so `ta.*` inside the callback
+ * accumulate on the HTF clock without colliding with the main stream.
+ *
+ * `callback` is captured lazily the first time the main compute body calls
+ * `request.security(slotId, opts, expr)`. `processedHtfCount` tracks how many
+ * HTF bars have already been folded into `output` so replay catches up history
+ * exactly once.
+ *
+ * @since 0.7
+ * @stable
+ * @example
+ *     // const runner = createSecurityExprRunner({ slotId: "s#0", interval: "1W",
+ *     //     capacity: 64, parent });
+ *     const slotId = "s#0";
+ *     void slotId;
+ */
+export type SecurityExprRunner = {
+    readonly slotId: string;
+    readonly interval: string;
+    readonly foldStream: StreamState;
+    readonly foldBar: SecurityBar;
+    readonly ctx: RuntimeContext;
+    readonly output: Float64RingBuffer;
+    callback?: SecurityExpr;
+    processedHtfCount: number;
+};
+/**
+ * The pair of lookup maps the runtime threads onto its {@link RuntimeContext}:
+ * `bySlot` keyed by `slotId` (overload dispatch + capture) and `byInterval`
+ * keyed by `IntervalDescriptor.value` (the fan-out from a secondary close).
+ *
+ * @since 0.7
+ * @stable
+ * @example
+ *     const registry: SecurityExprRegistry = {
+ *         bySlot: new Map(),
+ *         byInterval: new Map(),
+ *     };
+ *     void registry;
+ */
+export type SecurityExprRegistry = {
+    readonly bySlot: Map<string, SecurityExprRunner>;
+    readonly byInterval: ReadonlyMap<string, ReadonlyArray<SecurityExprRunner>>;
+};
+/**
+ * Construct one {@link SecurityExprRunner}. The fold stream and output buffer
+ * share the secondary stream's `capacity` so a deep-lookback callback
+ * (`ta.sma(bar.close, 50)`) has enough HTF history to warm up.
+ *
+ * @since 0.7
+ * @stable
+ * @example
+ *     // const runner = createSecurityExprRunner({ slotId: "s#0",
+ *     //     interval: "1W", capacity: 64, parent });
+ *     const interval = "1W";
+ *     void interval;
+ */
+export declare function createSecurityExprRunner(args: {
+    readonly slotId: string;
+    readonly interval: string;
+    readonly capacity: number;
+    readonly parent: RuntimeContext;
+}): SecurityExprRunner;
+/**
+ * Mount one runner per `manifest.securityExpressions` entry and return the
+ * `bySlot` / `byInterval` lookup maps. Returns empty maps when the manifest
+ * declares no expression callsites (the common single-timeframe case), so the
+ * secondary-close drive pays a single empty-map check.
+ *
+ * @since 0.7
+ * @stable
+ * @example
+ *     // const registry = buildSecurityExprRunners(manifest, ctx, 64);
+ *     const built = "bySlot + byInterval";
+ *     void built;
+ */
+export declare function buildSecurityExprRunners(manifest: ScriptManifest, parent: RuntimeContext, capacity: number): SecurityExprRegistry;
+/**
+ * Drive every runner registered on `interval` for one secondary event. A
+ * `"close"` folds the bar into the fold stream and appends one sampled output;
+ * a `"tick"` replaces the fold head and the output head without advancing
+ * length. Runners whose callback is not yet captured are skipped — the first
+ * main compute replays their backlog via {@link captureAndCatchUp}.
+ *
+ * @since 0.7
+ * @stable
+ * @example
+ *     // driveSecurityExpressions(ctx, "1W", "close", weeklyBar);
+ *     const mode = "close";
+ *     void mode;
+ */
+export declare function driveSecurityExpressions(parent: RuntimeContext, interval: string, mode: "close" | "tick", bar: Bar): void;
+/**
+ * Store the callback the first time main compute provides it, then replay the
+ * real secondary stream oldest→newest through the runner's fold stream until
+ * `processedHtfCount === secondary.length`. Idempotent once the backlog is
+ * drained, so later calls in the same bar are no-ops.
+ *
+ * @since 0.7
+ * @stable
+ * @example
+ *     // captureAndCatchUp(runner, expr, secondaryStream);
+ *     const replayed = "oldest -> newest";
+ *     void replayed;
+ */
+export declare function captureAndCatchUp(runner: SecurityExprRunner, expr: SecurityExpr, secondary: StreamState): void;
+/**
+ * Materialise a `Float64RingBuffer`'s values oldest→newest. Used as the
+ * `htfSeries` source when aligning a runner's output buffer to the main
+ * timeline.
+ *
+ * @since 0.7
+ * @stable
+ * @example
+ *     // const values = ascendingValues(runner.output);
+ *     const order = "oldest -> newest";
+ *     void order;
+ */
+export declare function ascendingValues(buffer: Float64RingBuffer): ReadonlyArray<number>;
+//# sourceMappingURL=securityExprRunner.d.ts.map

package/dist/request/securityExprRunner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"securityExprRunner.d.ts","sourceRoot":"","sources":["../../src/request/securityExprRunner.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACR,GAAG,EACH,cAAc,EACd,WAAW,EACX,YAAY,EAEf,MAAM,8BAA8B,CAAC;AAEtC,OAAO,EAA0B,KAAK,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACnF,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAGrD,OAAO,EACH,KAAK,WAAW,EAInB,MAAM,mBAAmB,CAAC;AAI3B;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAC7B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,WAAW,CAAC;IACjC,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC;IAC9B,QAAQ,CAAC,GAAG,EAAE,cAAc,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAC;IACnC,QAAQ,CAAC,EAAE,YAAY,CAAC;IACxB,iBAAiB,EAAE,MAAM,CAAC;CAC7B,CAAC;AAEF;;;;;;;;;;;;;GAaG;AACH,MAAM,MAAM,oBAAoB,GAAG;IAC/B,QAAQ,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;IACjD,QAAQ,CAAC,UAAU,EAAE,WAAW,CAAC,MAAM,EAAE,aAAa,CAAC,kBAAkB,CAAC,CAAC,CAAC;CAC/E,CAAC;AAoEF;;;;;;;;;;;;GAYG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE;IAC3C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;CACnC,GAAG,kBAAkB,CAYrB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,wBAAwB,CACpC,QAAQ,EAAE,cAAc,EACxB,MAAM,EAAE,cAAc,EACtB,QAAQ,EAAE,MAAM,GACjB,oBAAoB,CAmBtB;AAqCD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,wBAAwB,CACpC,MAAM,EAAE,cAAc,EACtB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,OAAO,GAAG,MAAM,EACtB,GAAG,EAAE,GAAG,GACT,IAAI,CAUN;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,iBAAiB,CAC7B,MAAM,EAAE,kBAAkB,EAC1B,IAAI,EAAE,YAAY,EAClB,SAAS,EAAE,WAAW,GACvB,IAAI,CAON;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,iBAAiB,GAAG,aAAa,CAAC,MAAM,CAAC,CAMhF"}

package/dist/request/securityExprRunner.js

@@ -0,0 +1,235 @@
+// Copyright (c) 2026 Invinite. Licensed under the MIT License.
+// See the LICENSE file in the repo root for full license text.
+import { ACTIVE_RUNTIME_CONTEXT } from "../runtimeContext.js";
+import { Float64RingBuffer } from "../ringBuffer.js";
+import { advanceSeriesSlots, commitSeriesSlots, resetSeriesHeads } from "../state/index.js";
+import { inMemoryStateStore } from "../stateStore.js";
+import { appendBarToStream, createStreamState, replaceStreamHead, } from "../streamState.js";
+import { createRuntimeViews } from "../views/index.js";
+import { barFromStream, makeConstantStringSeries } from "./streamBars.js";
+function makeFoldBar(foldStream, interval) {
+    const { seriesViews } = foldStream;
+    return Object.freeze({
+        time: seriesViews.time,
+        open: seriesViews.open,
+        high: seriesViews.high,
+        low: seriesViews.low,
+        close: seriesViews.close,
+        volume: seriesViews.volume,
+        hl2: seriesViews.hl2,
+        hlc3: seriesViews.hlc3,
+        ohlc4: seriesViews.ohlc4,
+        hlcc4: seriesViews.hlcc4,
+        symbol: makeConstantStringSeries(""),
+        interval: makeConstantStringSeries(interval),
+    });
+}
+function buildExprContext(parent, slotId, foldStream) {
+    return {
+        stream: foldStream,
+        stateStore: inMemoryStateStore(),
+        lastPersistTime: 0,
+        capabilities: parent.capabilities,
+        // A throwaway bag — the callback may not emit (Task 2 forbids
+        // non-`ta` refs), but an isolated queue guards if it somehow does.
+        emissions: {
+            plots: [],
+            drawings: [],
+            alerts: [],
+            alertConditions: [],
+            logs: [],
+            diagnostics: [],
+            fromBar: 0,
+            toBar: 0,
+        },
+        barIndex: () => foldStream.ohlcv.close.length - 1,
+        isTick: false,
+        drawingSlots: new Map(),
+        drawingSubIdCounters: new Map(),
+        drawingBucketCounters: { lines: 0, labels: 0, boxes: 0, polylines: 0, other: 0 },
+        scriptMaxDrawings: null,
+        stateSlots: new Map(),
+        seriesSlots: new Map(),
+        secondaryStreams: parent.secondaryStreams,
+        requestSecurityBars: new Map(),
+        requestSecurityAlignments: new Map(),
+        requestSecurityAscendingBars: new Map(),
+        requestLowerTfViews: new Map(),
+        diagnosedRequestKeys: new Set(),
+        logBudget: 0,
+        logBudgetExceededDiagnosed: false,
+        resolvedInputs: parent.resolvedInputs,
+        defaultPane: parent.defaultPane,
+        scriptPane: parent.scriptPane,
+        plotOverrides: Object.freeze({}),
+        diagnosedInputKeys: new Set(),
+        views: createRuntimeViews(),
+        slotIdPrefix: `security:${slotId}/`,
+    };
+}
+/**
+ * Construct one {@link SecurityExprRunner}. The fold stream and output buffer
+ * share the secondary stream's `capacity` so a deep-lookback callback
+ * (`ta.sma(bar.close, 50)`) has enough HTF history to warm up.
+ *
+ * @since 0.7
+ * @stable
+ * @example
+ *     // const runner = createSecurityExprRunner({ slotId: "s#0",
+ *     //     interval: "1W", capacity: 64, parent });
+ *     const interval = "1W";
+ *     void interval;
+ */
+export function createSecurityExprRunner(args) {
+    const { slotId, interval, capacity, parent } = args;
+    const foldStream = createStreamState({ interval, capacity, symbol: "" });
+    return {
+        slotId,
+        interval,
+        foldStream,
+        foldBar: makeFoldBar(foldStream, interval),
+        ctx: buildExprContext(parent, slotId, foldStream),
+        output: new Float64RingBuffer(capacity),
+        processedHtfCount: 0,
+    };
+}
+/**
+ * Mount one runner per `manifest.securityExpressions` entry and return the
+ * `bySlot` / `byInterval` lookup maps. Returns empty maps when the manifest
+ * declares no expression callsites (the common single-timeframe case), so the
+ * secondary-close drive pays a single empty-map check.
+ *
+ * @since 0.7
+ * @stable
+ * @example
+ *     // const registry = buildSecurityExprRunners(manifest, ctx, 64);
+ *     const built = "bySlot + byInterval";
+ *     void built;
+ */
+export function buildSecurityExprRunners(manifest, parent, capacity) {
+    const bySlot = new Map();
+    const byInterval = new Map();
+    for (const descriptor of manifest.securityExpressions ?? []) {
+        const runner = createSecurityExprRunner({
+            slotId: descriptor.slotId,
+            interval: descriptor.interval,
+            capacity,
+            parent,
+        });
+        bySlot.set(descriptor.slotId, runner);
+        const list = byInterval.get(descriptor.interval);
+        if (list === undefined) {
+            byInterval.set(descriptor.interval, [runner]);
+        }
+        else {
+            list.push(runner);
+        }
+    }
+    return { bySlot, byInterval };
+}
+function sampleOutput(result) {
+    return typeof result === "number" ? result : result.current;
+}
+function evaluate(runner, callback, isTick) {
+    const previous = ACTIVE_RUNTIME_CONTEXT.current;
+    ACTIVE_RUNTIME_CONTEXT.current = runner.ctx;
+    runner.ctx.isTick = isTick;
+    // `state.series` inside the callback accumulates on the HTF clock, so it
+    // advances/commits in lockstep with the fold stream — the same close/tick
+    // discipline `runComputeBody` applies to the main compute.
+    if (isTick)
+        resetSeriesHeads(runner.ctx);
+    else
+        advanceSeriesSlots(runner.ctx);
+    try {
+        return sampleOutput(callback(runner.foldBar));
+    }
+    finally {
+        if (!isTick)
+            commitSeriesSlots(runner.ctx);
+        runner.ctx.isTick = false;
+        ACTIVE_RUNTIME_CONTEXT.current = previous;
+    }
+}
+function foldClose(runner, bar) {
+    if (runner.callback === undefined)
+        return;
+    appendBarToStream(runner.foldStream, bar);
+    runner.output.append(evaluate(runner, runner.callback, false));
+    runner.processedHtfCount += 1;
+}
+function foldTick(runner, bar) {
+    if (runner.callback === undefined)
+        return;
+    replaceStreamHead(runner.foldStream, bar);
+    runner.output.replaceHead(evaluate(runner, runner.callback, true));
+}
+/**
+ * Drive every runner registered on `interval` for one secondary event. A
+ * `"close"` folds the bar into the fold stream and appends one sampled output;
+ * a `"tick"` replaces the fold head and the output head without advancing
+ * length. Runners whose callback is not yet captured are skipped — the first
+ * main compute replays their backlog via {@link captureAndCatchUp}.
+ *
+ * @since 0.7
+ * @stable
+ * @example
+ *     // driveSecurityExpressions(ctx, "1W", "close", weeklyBar);
+ *     const mode = "close";
+ *     void mode;
+ */
+export function driveSecurityExpressions(parent, interval, mode, bar) {
+    const runners = parent.securityExprRunnersByInterval?.get(interval);
+    if (runners === undefined)
+        return;
+    for (const runner of runners) {
+        if (mode === "close") {
+            foldClose(runner, bar);
+        }
+        else {
+            foldTick(runner, bar);
+        }
+    }
+}
+/**
+ * Store the callback the first time main compute provides it, then replay the
+ * real secondary stream oldest→newest through the runner's fold stream until
+ * `processedHtfCount === secondary.length`. Idempotent once the backlog is
+ * drained, so later calls in the same bar are no-ops.
+ *
+ * @since 0.7
+ * @stable
+ * @example
+ *     // captureAndCatchUp(runner, expr, secondaryStream);
+ *     const replayed = "oldest -> newest";
+ *     void replayed;
+ */
+export function captureAndCatchUp(runner, expr, secondary) {
+    if (runner.callback === undefined)
+        runner.callback = expr;
+    const length = secondary.ohlcv.close.length;
+    while (runner.processedHtfCount < length) {
+        const age = length - 1 - runner.processedHtfCount;
+        foldClose(runner, barFromStream(secondary, age));
+    }
+}
+/**
+ * Materialise a `Float64RingBuffer`'s values oldest→newest. Used as the
+ * `htfSeries` source when aligning a runner's output buffer to the main
+ * timeline.
+ *
+ * @since 0.7
+ * @stable
+ * @example
+ *     // const values = ascendingValues(runner.output);
+ *     const order = "oldest -> newest";
+ *     void order;
+ */
+export function ascendingValues(buffer) {
+    const values = [];
+    for (let age = buffer.length - 1; age >= 0; age -= 1) {
+        values.push(buffer.at(age));
+    }
+    return values;
+}
+//# sourceMappingURL=securityExprRunner.js.map

package/dist/request/securityExprRunner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"securityExprRunner.js","sourceRoot":"","sources":["../../src/request/securityExprRunner.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,+DAA+D;AAU/D,OAAO,EAAE,sBAAsB,EAAuB,MAAM,sBAAsB,CAAC;AACnF,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAC5F,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAEH,iBAAiB,EACjB,iBAAiB,EACjB,iBAAiB,GACpB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,wBAAwB,EAAE,MAAM,iBAAiB,CAAC;AAyD1E,SAAS,WAAW,CAAC,UAAuB,EAAE,QAAgB;IAC1D,MAAM,EAAE,WAAW,EAAE,GAAG,UAAU,CAAC;IACnC,OAAO,MAAM,CAAC,MAAM,CAAC;QACjB,IAAI,EAAE,WAAW,CAAC,IAAI;QACtB,IAAI,EAAE,WAAW,CAAC,IAAI;QACtB,IAAI,EAAE,WAAW,CAAC,IAAI;QACtB,GAAG,EAAE,WAAW,CAAC,GAAG;QACpB,KAAK,EAAE,WAAW,CAAC,KAAK;QACxB,MAAM,EAAE,WAAW,CAAC,MAAM;QAC1B,GAAG,EAAE,WAAW,CAAC,GAAG;QACpB,IAAI,EAAE,WAAW,CAAC,IAAI;QACtB,KAAK,EAAE,WAAW,CAAC,KAAK;QACxB,KAAK,EAAE,WAAW,CAAC,KAAK;QACxB,MAAM,EAAE,wBAAwB,CAAC,EAAE,CAAC;QACpC,QAAQ,EAAE,wBAAwB,CAAC,QAAQ,CAAC;KAC/C,CAAC,CAAC;AACP,CAAC;AAED,SAAS,gBAAgB,CACrB,MAAsB,EACtB,MAAc,EACd,UAAuB;IAEvB,OAAO;QACH,MAAM,EAAE,UAAU;QAClB,UAAU,EAAE,kBAAkB,EAAE;QAChC,eAAe,EAAE,CAAC;QAClB,YAAY,EAAE,MAAM,CAAC,YAAY;QACjC,8DAA8D;QAC9D,mEAAmE;QACnE,SAAS,EAAE;YACP,KAAK,EAAE,EAAE;YACT,QAAQ,EAAE,EAAE;YACZ,MAAM,EAAE,EAAE;YACV,eAAe,EAAE,EAAE;YACnB,IAAI,EAAE,EAAE;YACR,WAAW,EAAE,EAAE;YACf,OAAO,EAAE,CAAC;YACV,KAAK,EAAE,CAAC;SACX;QACD,QAAQ,EAAE,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC;QACjD,MAAM,EAAE,KAAK;QACb,YAAY,EAAE,IAAI,GAAG,EAAE;QACvB,oBAAoB,EAAE,IAAI,GAAG,EAAE;QAC/B,qBAAqB,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE;QAChF,iBAAiB,EAAE,IAAI;QACvB,UAAU,EAAE,IAAI,GAAG,EAAE;QACrB,WAAW,EAAE,IAAI,GAAG,EAAE;QACtB,gBAAgB,EAAE,MAAM,CAAC,gBAAgB;QACzC,mBAAmB,EAAE,IAAI,GAAG,EAAE;QAC9B,yBAAyB,EAAE,IAAI,GAAG,EAAE;QACpC,4BAA4B,EAAE,IAAI,GAAG,EAAE;QACvC,mBAAmB,EAAE,IAAI,GAAG,EAAE;QAC9B,oBAAoB,EAAE,IAAI,GAAG,EAAE;QAC/B,SAAS,EAAE,CAAC;QACZ,0BAA0B,EAAE,KAAK;QACjC,cAAc,EAAE,MAAM,CAAC,cAAc;QACrC,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,aAAa,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;QAChC,kBAAkB,EAAE,IAAI,GAAG,EAAE;QAC7B,KAAK,EAAE,kBAAkB,EAAE;QAC3B,YAAY,EAAE,YAAY,MAAM,GAAG;KACtC,CAAC;AACN,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,wBAAwB,CAAC,IAKxC;IACG,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IACpD,MAAM,UAAU,GAAG,iBAAiB,CAAC,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,CAAC;IACzE,OAAO;QACH,MAAM;QACN,QAAQ;QACR,UAAU;QACV,OAAO,EAAE,WAAW,CAAC,UAAU,EAAE,QAAQ,CAAC;QAC1C,GAAG,EAAE,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,CAAC;QACjD,MAAM,EAAE,IAAI,iBAAiB,CAAC,QAAQ,CAAC;QACvC,iBAAiB,EAAE,CAAC;KACvB,CAAC;AACN,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,wBAAwB,CACpC,QAAwB,EACxB,MAAsB,EACtB,QAAgB;IAEhB,MAAM,MAAM,GAAG,IAAI,GAAG,EAA8B,CAAC;IACrD,MAAM,UAAU,GAAG,IAAI,GAAG,EAAgC,CAAC;IAC3D,KAAK,MAAM,UAAU,IAAI,QAAQ,CAAC,mBAAmB,IAAI,EAAE,EAAE,CAAC;QAC1D,MAAM,MAAM,GAAG,wBAAwB,CAAC;YACpC,MAAM,EAAE,UAAU,CAAC,MAAM;YACzB,QAAQ,EAAE,UAAU,CAAC,QAAQ;YAC7B,QAAQ;YACR,MAAM;SACT,CAAC,CAAC;QACH,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACtC,MAAM,IAAI,GAAG,UAAU,CAAC,GAAG,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;QACjD,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACrB,UAAU,CAAC,GAAG,CAAC,UAAU,CAAC,QAAQ,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC;QAClD,CAAC;aAAM,CAAC;YACJ,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACtB,CAAC;IACL,CAAC;IACD,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC;AAClC,CAAC;AAED,SAAS,YAAY,CAAC,MAA+B;IACjD,OAAO,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC;AAChE,CAAC;AAED,SAAS,QAAQ,CAAC,MAA0B,EAAE,QAAsB,EAAE,MAAe;IACjF,MAAM,QAAQ,GAAG,sBAAsB,CAAC,OAAO,CAAC;IAChD,sBAAsB,CAAC,OAAO,GAAG,MAAM,CAAC,GAAG,CAAC;IAC5C,MAAM,CAAC,GAAG,CAAC,MAAM,GAAG,MAAM,CAAC;IAC3B,yEAAyE;IACzE,0EAA0E;IAC1E,2DAA2D;IAC3D,IAAI,MAAM;QAAE,gBAAgB,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;;QACpC,kBAAkB,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IACpC,IAAI,CAAC;QACD,OAAO,YAAY,CAAC,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;IAClD,CAAC;YAAS,CAAC;QACP,IAAI,CAAC,MAAM;YAAE,iBAAiB,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAC3C,MAAM,CAAC,GAAG,CAAC,MAAM,GAAG,KAAK,CAAC;QAC1B,sBAAsB,CAAC,OAAO,GAAG,QAAQ,CAAC;IAC9C,CAAC;AACL,CAAC;AAED,SAAS,SAAS,CAAC,MAA0B,EAAE,GAAQ;IACnD,IAAI,MAAM,CAAC,QAAQ,KAAK,SAAS;QAAE,OAAO;IAC1C,iBAAiB,CAAC,MAAM,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC;IAC1C,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAC;IAC/D,MAAM,CAAC,iBAAiB,IAAI,CAAC,CAAC;AAClC,CAAC;AAED,SAAS,QAAQ,CAAC,MAA0B,EAAE,GAAQ;IAClD,IAAI,MAAM,CAAC,QAAQ,KAAK,SAAS;QAAE,OAAO;IAC1C,iBAAiB,CAAC,MAAM,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC;IAC1C,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC,CAAC;AACvE,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,wBAAwB,CACpC,MAAsB,EACtB,QAAgB,EAChB,IAAsB,EACtB,GAAQ;IAER,MAAM,OAAO,GAAG,MAAM,CAAC,6BAA6B,EAAE,GAAG,CAAC,QAAQ,CAAC,CAAC;IACpE,IAAI,OAAO,KAAK,SAAS;QAAE,OAAO;IAClC,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC3B,IAAI,IAAI,KAAK,OAAO,EAAE,CAAC;YACnB,SAAS,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QAC3B,CAAC;aAAM,CAAC;YACJ,QAAQ,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QAC1B,CAAC;IACL,CAAC;AACL,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,iBAAiB,CAC7B,MAA0B,EAC1B,IAAkB,EAClB,SAAsB;IAEtB,IAAI,MAAM,CAAC,QAAQ,KAAK,SAAS;QAAE,MAAM,CAAC,QAAQ,GAAG,IAAI,CAAC;IAC1D,MAAM,MAAM,GAAG,SAAS,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC;IAC5C,OAAO,MAAM,CAAC,iBAAiB,GAAG,MAAM,EAAE,CAAC;QACvC,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,GAAG,MAAM,CAAC,iBAAiB,CAAC;QAClD,SAAS,CAAC,MAAM,EAAE,aAAa,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC,CAAC;IACrD,CAAC;AACL,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,eAAe,CAAC,MAAyB;IACrD,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,KAAK,IAAI,GAAG,GAAG,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,GAAG,IAAI,CAAC,EAAE,GAAG,IAAI,CAAC,EAAE,CAAC;QACnD,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAChC,CAAC;IACD,OAAO,MAAM,CAAC;AAClB,CAAC","sourcesContent":["// Copyright (c) 2026 Invinite. Licensed under the MIT License.\n// See the LICENSE file in the repo root for full license text.\n\nimport type {\n    Bar,\n    ScriptManifest,\n    SecurityBar,\n    SecurityExpr,\n    Series,\n} from \"@invinite-org/chartlang-core\";\n\nimport { ACTIVE_RUNTIME_CONTEXT, type RuntimeContext } from \"../runtimeContext.js\";\nimport { Float64RingBuffer } from \"../ringBuffer.js\";\nimport { advanceSeriesSlots, commitSeriesSlots, resetSeriesHeads } from \"../state/index.js\";\nimport { inMemoryStateStore } from \"../stateStore.js\";\nimport {\n    type StreamState,\n    appendBarToStream,\n    createStreamState,\n    replaceStreamHead,\n} from \"../streamState.js\";\nimport { createRuntimeViews } from \"../views/index.js\";\nimport { barFromStream, makeConstantStringSeries } from \"./streamBars.js\";\n\n/**\n * One mounted higher-timeframe expression unit. The compiler records each\n * `request.security({ interval }, (bar) => …)` callsite in\n * `manifest.securityExpressions`; the runtime mounts one runner per entry.\n *\n * The runner owns a dedicated fold {@link StreamState} clocked on the HTF\n * `interval`, a `Float64RingBuffer` output buffer (one sampled value per HTF\n * bar), a fold {@link SecurityBar} view backed by the fold stream's head, and\n * a private {@link RuntimeContext} (`stream = foldStream`,\n * `slotIdPrefix = \"security:<slotId>/\"`) so `ta.*` inside the callback\n * accumulate on the HTF clock without colliding with the main stream.\n *\n * `callback` is captured lazily the first time the main compute body calls\n * `request.security(slotId, opts, expr)`. `processedHtfCount` tracks how many\n * HTF bars have already been folded into `output` so replay catches up history\n * exactly once.\n *\n * @since 0.7\n * @stable\n * @example\n *     // const runner = createSecurityExprRunner({ slotId: \"s#0\", interval: \"1W\",\n *     //     capacity: 64, parent });\n *     const slotId = \"s#0\";\n *     void slotId;\n */\nexport type SecurityExprRunner = {\n    readonly slotId: string;\n    readonly interval: string;\n    readonly foldStream: StreamState;\n    readonly foldBar: SecurityBar;\n    readonly ctx: RuntimeContext;\n    readonly output: Float64RingBuffer;\n    callback?: SecurityExpr;\n    processedHtfCount: number;\n};\n\n/**\n * The pair of lookup maps the runtime threads onto its {@link RuntimeContext}:\n * `bySlot` keyed by `slotId` (overload dispatch + capture) and `byInterval`\n * keyed by `IntervalDescriptor.value` (the fan-out from a secondary close).\n *\n * @since 0.7\n * @stable\n * @example\n *     const registry: SecurityExprRegistry = {\n *         bySlot: new Map(),\n *         byInterval: new Map(),\n *     };\n *     void registry;\n */\nexport type SecurityExprRegistry = {\n    readonly bySlot: Map<string, SecurityExprRunner>;\n    readonly byInterval: ReadonlyMap<string, ReadonlyArray<SecurityExprRunner>>;\n};\n\nfunction makeFoldBar(foldStream: StreamState, interval: string): SecurityBar {\n    const { seriesViews } = foldStream;\n    return Object.freeze({\n        time: seriesViews.time,\n        open: seriesViews.open,\n        high: seriesViews.high,\n        low: seriesViews.low,\n        close: seriesViews.close,\n        volume: seriesViews.volume,\n        hl2: seriesViews.hl2,\n        hlc3: seriesViews.hlc3,\n        ohlc4: seriesViews.ohlc4,\n        hlcc4: seriesViews.hlcc4,\n        symbol: makeConstantStringSeries(\"\"),\n        interval: makeConstantStringSeries(interval),\n    });\n}\n\nfunction buildExprContext(\n    parent: RuntimeContext,\n    slotId: string,\n    foldStream: StreamState,\n): RuntimeContext {\n    return {\n        stream: foldStream,\n        stateStore: inMemoryStateStore(),\n        lastPersistTime: 0,\n        capabilities: parent.capabilities,\n        // A throwaway bag — the callback may not emit (Task 2 forbids\n        // non-`ta` refs), but an isolated queue guards if it somehow does.\n        emissions: {\n            plots: [],\n            drawings: [],\n            alerts: [],\n            alertConditions: [],\n            logs: [],\n            diagnostics: [],\n            fromBar: 0,\n            toBar: 0,\n        },\n        barIndex: () => foldStream.ohlcv.close.length - 1,\n        isTick: false,\n        drawingSlots: new Map(),\n        drawingSubIdCounters: new Map(),\n        drawingBucketCounters: { lines: 0, labels: 0, boxes: 0, polylines: 0, other: 0 },\n        scriptMaxDrawings: null,\n        stateSlots: new Map(),\n        seriesSlots: new Map(),\n        secondaryStreams: parent.secondaryStreams,\n        requestSecurityBars: new Map(),\n        requestSecurityAlignments: new Map(),\n        requestSecurityAscendingBars: new Map(),\n        requestLowerTfViews: new Map(),\n        diagnosedRequestKeys: new Set(),\n        logBudget: 0,\n        logBudgetExceededDiagnosed: false,\n        resolvedInputs: parent.resolvedInputs,\n        defaultPane: parent.defaultPane,\n        scriptPane: parent.scriptPane,\n        plotOverrides: Object.freeze({}),\n        diagnosedInputKeys: new Set(),\n        views: createRuntimeViews(),\n        slotIdPrefix: `security:${slotId}/`,\n    };\n}\n\n/**\n * Construct one {@link SecurityExprRunner}. The fold stream and output buffer\n * share the secondary stream's `capacity` so a deep-lookback callback\n * (`ta.sma(bar.close, 50)`) has enough HTF history to warm up.\n *\n * @since 0.7\n * @stable\n * @example\n *     // const runner = createSecurityExprRunner({ slotId: \"s#0\",\n *     //     interval: \"1W\", capacity: 64, parent });\n *     const interval = \"1W\";\n *     void interval;\n */\nexport function createSecurityExprRunner(args: {\n    readonly slotId: string;\n    readonly interval: string;\n    readonly capacity: number;\n    readonly parent: RuntimeContext;\n}): SecurityExprRunner {\n    const { slotId, interval, capacity, parent } = args;\n    const foldStream = createStreamState({ interval, capacity, symbol: \"\" });\n    return {\n        slotId,\n        interval,\n        foldStream,\n        foldBar: makeFoldBar(foldStream, interval),\n        ctx: buildExprContext(parent, slotId, foldStream),\n        output: new Float64RingBuffer(capacity),\n        processedHtfCount: 0,\n    };\n}\n\n/**\n * Mount one runner per `manifest.securityExpressions` entry and return the\n * `bySlot` / `byInterval` lookup maps. Returns empty maps when the manifest\n * declares no expression callsites (the common single-timeframe case), so the\n * secondary-close drive pays a single empty-map check.\n *\n * @since 0.7\n * @stable\n * @example\n *     // const registry = buildSecurityExprRunners(manifest, ctx, 64);\n *     const built = \"bySlot + byInterval\";\n *     void built;\n */\nexport function buildSecurityExprRunners(\n    manifest: ScriptManifest,\n    parent: RuntimeContext,\n    capacity: number,\n): SecurityExprRegistry {\n    const bySlot = new Map<string, SecurityExprRunner>();\n    const byInterval = new Map<string, SecurityExprRunner[]>();\n    for (const descriptor of manifest.securityExpressions ?? []) {\n        const runner = createSecurityExprRunner({\n            slotId: descriptor.slotId,\n            interval: descriptor.interval,\n            capacity,\n            parent,\n        });\n        bySlot.set(descriptor.slotId, runner);\n        const list = byInterval.get(descriptor.interval);\n        if (list === undefined) {\n            byInterval.set(descriptor.interval, [runner]);\n        } else {\n            list.push(runner);\n        }\n    }\n    return { bySlot, byInterval };\n}\n\nfunction sampleOutput(result: Series<number> | number): number {\n    return typeof result === \"number\" ? result : result.current;\n}\n\nfunction evaluate(runner: SecurityExprRunner, callback: SecurityExpr, isTick: boolean): number {\n    const previous = ACTIVE_RUNTIME_CONTEXT.current;\n    ACTIVE_RUNTIME_CONTEXT.current = runner.ctx;\n    runner.ctx.isTick = isTick;\n    // `state.series` inside the callback accumulates on the HTF clock, so it\n    // advances/commits in lockstep with the fold stream — the same close/tick\n    // discipline `runComputeBody` applies to the main compute.\n    if (isTick) resetSeriesHeads(runner.ctx);\n    else advanceSeriesSlots(runner.ctx);\n    try {\n        return sampleOutput(callback(runner.foldBar));\n    } finally {\n        if (!isTick) commitSeriesSlots(runner.ctx);\n        runner.ctx.isTick = false;\n        ACTIVE_RUNTIME_CONTEXT.current = previous;\n    }\n}\n\nfunction foldClose(runner: SecurityExprRunner, bar: Bar): void {\n    if (runner.callback === undefined) return;\n    appendBarToStream(runner.foldStream, bar);\n    runner.output.append(evaluate(runner, runner.callback, false));\n    runner.processedHtfCount += 1;\n}\n\nfunction foldTick(runner: SecurityExprRunner, bar: Bar): void {\n    if (runner.callback === undefined) return;\n    replaceStreamHead(runner.foldStream, bar);\n    runner.output.replaceHead(evaluate(runner, runner.callback, true));\n}\n\n/**\n * Drive every runner registered on `interval` for one secondary event. A\n * `\"close\"` folds the bar into the fold stream and appends one sampled output;\n * a `\"tick\"` replaces the fold head and the output head without advancing\n * length. Runners whose callback is not yet captured are skipped — the first\n * main compute replays their backlog via {@link captureAndCatchUp}.\n *\n * @since 0.7\n * @stable\n * @example\n *     // driveSecurityExpressions(ctx, \"1W\", \"close\", weeklyBar);\n *     const mode = \"close\";\n *     void mode;\n */\nexport function driveSecurityExpressions(\n    parent: RuntimeContext,\n    interval: string,\n    mode: \"close\" | \"tick\",\n    bar: Bar,\n): void {\n    const runners = parent.securityExprRunnersByInterval?.get(interval);\n    if (runners === undefined) return;\n    for (const runner of runners) {\n        if (mode === \"close\") {\n            foldClose(runner, bar);\n        } else {\n            foldTick(runner, bar);\n        }\n    }\n}\n\n/**\n * Store the callback the first time main compute provides it, then replay the\n * real secondary stream oldest→newest through the runner's fold stream until\n * `processedHtfCount === secondary.length`. Idempotent once the backlog is\n * drained, so later calls in the same bar are no-ops.\n *\n * @since 0.7\n * @stable\n * @example\n *     // captureAndCatchUp(runner, expr, secondaryStream);\n *     const replayed = \"oldest -> newest\";\n *     void replayed;\n */\nexport function captureAndCatchUp(\n    runner: SecurityExprRunner,\n    expr: SecurityExpr,\n    secondary: StreamState,\n): void {\n    if (runner.callback === undefined) runner.callback = expr;\n    const length = secondary.ohlcv.close.length;\n    while (runner.processedHtfCount < length) {\n        const age = length - 1 - runner.processedHtfCount;\n        foldClose(runner, barFromStream(secondary, age));\n    }\n}\n\n/**\n * Materialise a `Float64RingBuffer`'s values oldest→newest. Used as the\n * `htfSeries` source when aligning a runner's output buffer to the main\n * timeline.\n *\n * @since 0.7\n * @stable\n * @example\n *     // const values = ascendingValues(runner.output);\n *     const order = \"oldest -> newest\";\n *     void order;\n */\nexport function ascendingValues(buffer: Float64RingBuffer): ReadonlyArray<number> {\n    const values: number[] = [];\n    for (let age = buffer.length - 1; age >= 0; age -= 1) {\n        values.push(buffer.at(age));\n    }\n    return values;\n}\n"]}

package/dist/request/streamBars.d.ts

@@ -1,6 +1,19 @@
-import type { Bar } from "@invinite-org/chartlang-core";
+import type { Bar, Series } from "@invinite-org/chartlang-core";
 import type { RuntimeContext } from "../runtimeContext.js";
 import type { StreamState } from "../streamState.js";
+/**
+ * A `Series<string>` whose every head-relative read returns a fixed `value`.
+ * Backs the `symbol` / `interval` fields of a materialised {@link SecurityBar}
+ * (both the data form's live bar and the expression form's fold bar), where the
+ * scalar is constant across history.
+ *
+ * @since 0.7
+ * @stable
+ * @example
+ *     const s = makeConstantStringSeries("1W");
+ *     void s.current; // "1W"
+ */
+export declare function makeConstantStringSeries(value: string): Series<string>;
 /**
  * Materialise the bar at ring-buffer `age` from a stream state.
  *

package/dist/request/streamBars.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"streamBars.d.ts","sourceRoot":"","sources":["../../src/request/streamBars.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,8BAA8B,CAAC;AAExD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,WAAW,EAAE,GAAG,EAAE,MAAM,GAAG,GAAG,CAmBnE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,cAAc,EAAE,MAAM,EAAE,WAAW,GAAG,aAAa,CAAC,GAAG,CAAC,CAS7F"}
+{"version":3,"file":"streamBars.d.ts","sourceRoot":"","sources":["../../src/request/streamBars.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,GAAG,EAAS,MAAM,EAAc,MAAM,8BAA8B,CAAC;AAGnF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD;;;;;;;;;;;GAWG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,CAkBtE;AAED;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,WAAW,EAAE,GAAG,EAAE,MAAM,GAAG,GAAG,CAyBnE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,cAAc,EAAE,MAAM,EAAE,WAAW,GAAG,aAAa,CAAC,GAAG,CAAC,CAS7F"}

package/dist/request/streamBars.js

@@ -1,5 +1,38 @@
 // Copyright (c) 2026 Invinite. Licensed under the MIT License.
 // See the LICENSE file in the repo root for full license text.
+import { resolveBarPoint } from "../barPoint.js";
+/**
+ * A `Series<string>` whose every head-relative read returns a fixed `value`.
+ * Backs the `symbol` / `interval` fields of a materialised {@link SecurityBar}
+ * (both the data form's live bar and the expression form's fold bar), where the
+ * scalar is constant across history.
+ *
+ * @since 0.7
+ * @stable
+ * @example
+ *     const s = makeConstantStringSeries("1W");
+ *     void s.current; // "1W"
+ */
+export function makeConstantStringSeries(value) {
+    const target = {
+        get current() {
+            return value;
+        },
+        get length() {
+            return 0;
+        },
+    };
+    return new Proxy(Object.freeze(target), {
+        get(obj, prop, receiver) {
+            if (typeof prop === "string") {
+                const n = Number(prop);
+                if (Number.isInteger(n) && n >= 0)
+                    return value;
+            }
+            return Reflect.get(obj, prop, receiver);
+        },
+    });
+}
 /**
  * Materialise the bar at ring-buffer `age` from a stream state.
  *
@@ -15,8 +48,9 @@ export function barFromStream(stream, age) {
     const high = stream.ohlcv.high.at(age);
     const low = stream.ohlcv.low.at(age);
     const close = stream.ohlcv.close.at(age);
+    const barTime = stream.ohlcv.time.at(age);
     return {
-        time: stream.ohlcv.time.at(age),
+        time: barTime,
         open,
         high,
         low,
@@ -28,6 +62,10 @@ export function barFromStream(stream, age) {
         hlc3: (high + low + close) / 3,
         ohlc4: (open + high + low + close) / 4,
         hlcc4: (high + low + close + close) / 4,
+        // Anchored at this materialised bar's own `age`: a negative offset
+        // reads `time.at(age - offset)` (further back in this stream's
+        // history) so a snapshot bar's offsets stay relative to itself.
+        point: (offset, price) => resolveBarPoint(stream.ohlcv.time, stream.bar.interval, barTime, offset - age, price),
     };
 }
 /**

package/dist/request/streamBars.js.map

@@ -1 +1 @@
-{"version":3,"file":"streamBars.js","sourceRoot":"","sources":["../../src/request/streamBars.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,+DAA+D;AAO/D;;;;;;;;;GASG;AACH,MAAM,UAAU,aAAa,CAAC,MAAmB,EAAE,GAAW;IAC1D,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC;IACvC,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC;IACvC,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC;IACrC,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC;IACzC,OAAO;QACH,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,GAAG,CAAC;QAC/B,IAAI;QACJ,IAAI;QACJ,GAAG;QACH,KAAK;QACL,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,GAAG,CAAC;QACnC,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,MAAM;QACzB,QAAQ,EAAE,MAAM,CAAC,GAAG,CAAC,QAAQ;QAC7B,GAAG,EAAE,CAAC,IAAI,GAAG,GAAG,CAAC,GAAG,CAAC;QACrB,IAAI,EAAE,CAAC,IAAI,GAAG,GAAG,GAAG,KAAK,CAAC,GAAG,CAAC;QAC9B,KAAK,EAAE,CAAC,IAAI,GAAG,IAAI,GAAG,GAAG,GAAG,KAAK,CAAC,GAAG,CAAC;QACtC,KAAK,EAAE,CAAC,IAAI,GAAG,GAAG,GAAG,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC;KAC1C,CAAC;AACN,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,gBAAgB,CAAC,GAAmB,EAAE,MAAmB;IACrE,MAAM,MAAM,GAAG,GAAG,CAAC,4BAA4B,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAC5D,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,MAAM,CAAC;IACxC,MAAM,IAAI,GAAU,EAAE,CAAC;IACvB,KAAK,IAAI,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,GAAG,IAAI,CAAC,EAAE,GAAG,IAAI,CAAC,EAAE,CAAC;QAC/D,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC;IAC1C,CAAC;IACD,GAAG,CAAC,4BAA4B,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IACnD,OAAO,IAAI,CAAC;AAChB,CAAC"}
+{"version":3,"file":"streamBars.js","sourceRoot":"","sources":["../../src/request/streamBars.ts"],"names":[],"mappings":"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","sourcesContent":["// Copyright (c) 2026 Invinite. Licensed under the MIT License.\n// See the LICENSE file in the repo root for full license text.\n\nimport type { Bar, Price, Series, WorldPoint } from \"@invinite-org/chartlang-core\";\n\nimport { resolveBarPoint } from \"../barPoint.js\";\nimport type { RuntimeContext } from \"../runtimeContext.js\";\nimport type { StreamState } from \"../streamState.js\";\n\n/**\n * A `Series<string>` whose every head-relative read returns a fixed `value`.\n * Backs the `symbol` / `interval` fields of a materialised {@link SecurityBar}\n * (both the data form's live bar and the expression form's fold bar), where the\n * scalar is constant across history.\n *\n * @since 0.7\n * @stable\n * @example\n *     const s = makeConstantStringSeries(\"1W\");\n *     void s.current; // \"1W\"\n */\nexport function makeConstantStringSeries(value: string): Series<string> {\n    const target = {\n        get current() {\n            return value;\n        },\n        get length() {\n            return 0;\n        },\n    };\n    return new Proxy(Object.freeze(target), {\n        get(obj, prop, receiver) {\n            if (typeof prop === \"string\") {\n                const n = Number(prop);\n                if (Number.isInteger(n) && n >= 0) return value;\n            }\n            return Reflect.get(obj, prop, receiver);\n        },\n    }) as Series<string>;\n}\n\n/**\n * Materialise the bar at ring-buffer `age` from a stream state.\n *\n * @since 0.6\n * @stable\n * @example\n *     // const bar = barFromStream(stream, 0);\n *     const age = 0;\n *     void age;\n */\nexport function barFromStream(stream: StreamState, age: number): Bar {\n    const open = stream.ohlcv.open.at(age);\n    const high = stream.ohlcv.high.at(age);\n    const low = stream.ohlcv.low.at(age);\n    const close = stream.ohlcv.close.at(age);\n    const barTime = stream.ohlcv.time.at(age);\n    return {\n        time: barTime,\n        open,\n        high,\n        low,\n        close,\n        volume: stream.ohlcv.volume.at(age),\n        symbol: stream.bar.symbol,\n        interval: stream.bar.interval,\n        hl2: (high + low) / 2,\n        hlc3: (high + low + close) / 3,\n        ohlc4: (open + high + low + close) / 4,\n        hlcc4: (high + low + close + close) / 4,\n        // Anchored at this materialised bar's own `age`: a negative offset\n        // reads `time.at(age - offset)` (further back in this stream's\n        // history) so a snapshot bar's offsets stay relative to itself.\n        point: (offset: number, price: Price): WorldPoint =>\n            resolveBarPoint(stream.ohlcv.time, stream.bar.interval, barTime, offset - age, price),\n    };\n}\n\n/**\n * Return a stream's bars in ascending time order, memoised per step on\n * `ctx.requestSecurityAscendingBars` (cleared each bar close).\n *\n * @since 0.6\n * @stable\n * @example\n *     // const bars = ascendingBarsFor(ctx, ctx.stream);\n *     const memo = \"requestSecurityAscendingBars\";\n *     void memo;\n */\nexport function ascendingBarsFor(ctx: RuntimeContext, stream: StreamState): ReadonlyArray<Bar> {\n    const cached = ctx.requestSecurityAscendingBars.get(stream);\n    if (cached !== undefined) return cached;\n    const bars: Bar[] = [];\n    for (let age = stream.ohlcv.close.length - 1; age >= 0; age -= 1) {\n        bars.push(barFromStream(stream, age));\n    }\n    ctx.requestSecurityAscendingBars.set(stream, bars);\n    return bars;\n}\n"]}

package/dist/ringBuffer.d.ts

@@ -1,7 +1,7 @@
 /**
  * Shared contract for the two ring-buffer flavours the runtime ships
  * (`RingBuffer<T>` for object payloads, `Float64RingBuffer` for numeric
- * payloads). Mirrors PLAN.md §6.6 — `at(n)` returns `undefined` on
+ * payloads). Both share one read contract — `at(n)` returns `undefined` on
  * out-of-range reads in the generic shape; `Float64RingBuffer` narrows
  * the return to `number` with `NaN` as the OOR sentinel.
  *
@@ -54,7 +54,7 @@ export declare class RingBuffer<T> implements RingBufferLike<T> {
 /**
  * Numeric ring buffer backed by a `Float64Array`. Reads are direct
  * memory hits — no boxing, no map lookup. Out-of-range reads return
- * `NaN` (the language-wide warmup sentinel per PLAN.md §6.3), which
+ * `NaN` (the language-wide warmup sentinel), which
  * is the correct value for unwarmed indicator slots.
  *
  * `at(n)` narrows the shared `RingBufferLike<T>`'s `T | undefined`

package/dist/ringBuffer.js

@@ -59,7 +59,7 @@ export class RingBuffer {
 /**
  * Numeric ring buffer backed by a `Float64Array`. Reads are direct
  * memory hits — no boxing, no map lookup. Out-of-range reads return
- * `NaN` (the language-wide warmup sentinel per PLAN.md §6.3), which
+ * `NaN` (the language-wide warmup sentinel), which
  * is the correct value for unwarmed indicator slots.
  *
  * `at(n)` narrows the shared `RingBufferLike<T>`'s `T | undefined`

package/dist/ringBuffer.js.map

@@ -1 +1 @@
-{"version":3,"file":"ringBuffer.js","sourceRoot":"","sources":["../src/ringBuffer.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,+DAA+D;AAwB/D;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,OAAO,UAAU;IAKS;IAJpB,GAAG,CAAuB;IAC1B,IAAI,GAAG,CAAC,CAAC,CAAC;IACV,MAAM,GAAG,CAAC,CAAC;IAEnB,YAA4B,QAAgB;QAAhB,aAAQ,GAAR,QAAQ,CAAQ;QACxC,IAAI,CAAC,GAAG,GAAG,IAAI,KAAK,CAAgB,QAAQ,CAAC,CAAC;IAClD,CAAC;IAED,MAAM,CAAC,CAAI;QACP,IAAI,CAAC,IAAI,GAAG,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC;QAC5C,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACxB,IAAI,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,QAAQ;YAAE,IAAI,CAAC,MAAM,IAAI,CAAC,CAAC;IACtD,CAAC;IAED,WAAW,CAAC,CAAI;QACZ,IAAI,IAAI,CAAC,IAAI,KAAK,CAAC,CAAC,EAAE,CAAC;YACnB,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;YACf,OAAO;QACX,CAAC;QACD,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC5B,CAAC;IAED,EAAE,CAAC,CAAS;QACR,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,MAAM;YAAE,OAAO,SAAS,CAAC;QAChD,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC;IACrE,CAAC;IAED,IAAI,MAAM;QACN,OAAO,IAAI,CAAC,MAAM,CAAC;IACvB,CAAC;IAED,KAAK;QACD,IAAI,CAAC,GAAG,GAAG,IAAI,KAAK,CAAgB,IAAI,CAAC,QAAQ,CAAC,CAAC;QACnD,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC;QACf,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;IACpB,CAAC;CACJ;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,OAAO,iBAAiB;IAKE;IAJpB,GAAG,CAAe;IAClB,IAAI,GAAG,CAAC,CAAC,CAAC;IACV,MAAM,GAAG,CAAC,CAAC;IAEnB,YAA4B,QAAgB;QAAhB,aAAQ,GAAR,QAAQ,CAAQ;QACxC,IAAI,CAAC,GAAG,GAAG,IAAI,YAAY,CAAC,QAAQ,CAAC,CAAC;IAC1C,CAAC;IAED,MAAM,CAAC,CAAS;QACZ,IAAI,CAAC,IAAI,GAAG,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC;QAC5C,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACxB,IAAI,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,QAAQ;YAAE,IAAI,CAAC,MAAM,IAAI,CAAC,CAAC;IACtD,CAAC;IAED,WAAW,CAAC,CAAS;QACjB,IAAI,IAAI,CAAC,IAAI,KAAK,CAAC,CAAC,EAAE,CAAC;YACnB,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;YACf,OAAO;QACX,CAAC;QACD,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC5B,CAAC;IAED,EAAE,CAAC,CAAS;QACR,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,MAAM;YAAE,OAAO,MAAM,CAAC,GAAG,CAAC;QACjD,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC;IACrE,CAAC;IAED,IAAI,MAAM;QACN,OAAO,IAAI,CAAC,MAAM,CAAC;IACvB,CAAC;IAED,uBAAuB;QAKnB,MAAM,MAAM,GAAyB,EAAE,CAAC;QACxC,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC;YAC3B,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;QACpD,CAAC;QACD,OAAO,MAAM,CAAC,MAAM,CAAC;YACjB,SAAS,EAAE,IAAI,CAAC,IAAI;YACpB,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC;SAChC,CAAC,CAAC;IACP,CAAC;IAED,yBAAyB,CACrB,IAIE;QAEF,IACI,IAAI,CAAC,MAAM,CAAC,MAAM,KAAK,IAAI,CAAC,QAAQ;YACpC,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,SAAS,CAAC;YACjC,IAAI,CAAC,SAAS,GAAG,CAAC,CAAC;YACnB,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,QAAQ;YAC/B,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC;YAC9B,IAAI,CAAC,MAAM,GAAG,CAAC;YACf,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,QAAQ;YAC3B,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,IAAI,IAAI,CAAC,SAAS,KAAK,CAAC,CAAC,CAAC;YAC5C,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,IAAI,IAAI,CAAC,SAAS,GAAG,CAAC,CAAC,EACzC,CAAC;YACC,MAAM,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAC;QACpD,CAAC;QACD,MAAM,IAAI,GAAG,IAAI,YAAY,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC7C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;YAC7C,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;YAC7B,IAAI,CAAC,CAAC,CAAC,GAAG,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC;QAClD,CAAC;QACD,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC;QAChB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC;QAC3B,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;IAC9B,CAAC;IAED,KAAK;QACD,IAAI,CAAC,GAAG,GAAG,IAAI,YAAY,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC3C,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC;QACf,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;IACpB,CAAC;CACJ"}
+{"version":3,"file":"ringBuffer.js","sourceRoot":"","sources":["../src/ringBuffer.ts"],"names":[],"mappings":"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","sourcesContent":["// Copyright (c) 2026 Invinite. Licensed under the MIT License.\n// See the LICENSE file in the repo root for full license text.\n\n/**\n * Shared contract for the two ring-buffer flavours the runtime ships\n * (`RingBuffer<T>` for object payloads, `Float64RingBuffer` for numeric\n * payloads). Both share one read contract — `at(n)` returns `undefined` on\n * out-of-range reads in the generic shape; `Float64RingBuffer` narrows\n * the return to `number` with `NaN` as the OOR sentinel.\n *\n * @since 0.1\n * @example\n *     const buf: RingBufferLike<number> = new Float64RingBuffer(8);\n *     buf.append(42);\n *     buf.at(0); // 42\n */\nexport interface RingBufferLike<T> {\n    readonly capacity: number;\n    readonly length: number;\n    append(v: T): void;\n    replaceHead(v: T): void;\n    at(n: number): T | undefined;\n    reset(): void;\n}\n\n/**\n * Generic ring buffer over an `Array<T>`. Backs object-valued\n * `Series<T>` (e.g. Phase-3 drawing handles). For numeric series use\n * `Float64RingBuffer` — it avoids the array-pointer indirection on\n * every read.\n *\n * Out-of-range `at(n)` returns `undefined`. `replaceHead` on an empty\n * buffer behaves like `append` so the first call after construction\n * does not need a special-case branch in callers.\n *\n * @since 0.1\n * @example\n *     const buf = new RingBuffer<string>(3);\n *     buf.append(\"a\");\n *     buf.append(\"b\");\n *     buf.append(\"c\");\n *     buf.append(\"d\"); // overwrites \"a\"\n *     buf.at(0); // \"d\"\n *     buf.at(2); // \"b\"\n */\nexport class RingBuffer<T> implements RingBufferLike<T> {\n    private buf: Array<T | undefined>;\n    private head = -1;\n    private filled = 0;\n\n    constructor(public readonly capacity: number) {\n        this.buf = new Array<T | undefined>(capacity);\n    }\n\n    append(v: T): void {\n        this.head = (this.head + 1) % this.capacity;\n        this.buf[this.head] = v;\n        if (this.filled < this.capacity) this.filled += 1;\n    }\n\n    replaceHead(v: T): void {\n        if (this.head === -1) {\n            this.append(v);\n            return;\n        }\n        this.buf[this.head] = v;\n    }\n\n    at(n: number): T | undefined {\n        if (n < 0 || n >= this.filled) return undefined;\n        return this.buf[(this.head - n + this.capacity) % this.capacity];\n    }\n\n    get length(): number {\n        return this.filled;\n    }\n\n    reset(): void {\n        this.buf = new Array<T | undefined>(this.capacity);\n        this.head = -1;\n        this.filled = 0;\n    }\n}\n\n/**\n * Numeric ring buffer backed by a `Float64Array`. Reads are direct\n * memory hits — no boxing, no map lookup. Out-of-range reads return\n * `NaN` (the language-wide warmup sentinel), which\n * is the correct value for unwarmed indicator slots.\n *\n * `at(n)` narrows the shared `RingBufferLike<T>`'s `T | undefined`\n * return to plain `number` in a covariant return position; callers\n * that hold this concrete class see `number`, callers that hold\n * the wider interface see `number | undefined`.\n *\n * @since 0.1\n * @example\n *     const buf = new Float64RingBuffer(4);\n *     buf.append(1.0);\n *     buf.append(2.0);\n *     buf.at(0); // 2\n *     buf.at(5); // NaN\n */\nexport class Float64RingBuffer implements RingBufferLike<number> {\n    private buf: Float64Array;\n    private head = -1;\n    private filled = 0;\n\n    constructor(public readonly capacity: number) {\n        this.buf = new Float64Array(capacity);\n    }\n\n    append(v: number): void {\n        this.head = (this.head + 1) % this.capacity;\n        this.buf[this.head] = v;\n        if (this.filled < this.capacity) this.filled += 1;\n    }\n\n    replaceHead(v: number): void {\n        if (this.head === -1) {\n            this.append(v);\n            return;\n        }\n        this.buf[this.head] = v;\n    }\n\n    at(n: number): number {\n        if (n < 0 || n >= this.filled) return Number.NaN;\n        return this.buf[(this.head - n + this.capacity) % this.capacity];\n    }\n\n    get length(): number {\n        return this.filled;\n    }\n\n    serialiseSnapshotBuffer(): Readonly<{\n        headIndex: number;\n        filled: number;\n        values: ReadonlyArray<number | null>;\n    }> {\n        const values: Array<number | null> = [];\n        for (const value of this.buf) {\n            values.push(Number.isNaN(value) ? null : value);\n        }\n        return Object.freeze({\n            headIndex: this.head,\n            filled: this.filled,\n            values: Object.freeze(values),\n        });\n    }\n\n    restoreFromSnapshotBuffer(\n        args: Readonly<{\n            headIndex: number;\n            filled: number;\n            values: ReadonlyArray<number | null>;\n        }>,\n    ): void {\n        if (\n            args.values.length !== this.capacity ||\n            !Number.isInteger(args.headIndex) ||\n            args.headIndex < -1 ||\n            args.headIndex >= this.capacity ||\n            !Number.isInteger(args.filled) ||\n            args.filled < 0 ||\n            args.filled > this.capacity ||\n            (args.filled === 0 && args.headIndex !== -1) ||\n            (args.filled > 0 && args.headIndex < 0)\n        ) {\n            throw new Error(\"invalid ring buffer snapshot\");\n        }\n        const next = new Float64Array(this.capacity);\n        for (let i = 0; i < args.values.length; i += 1) {\n            const value = args.values[i];\n            next[i] = value === null ? Number.NaN : value;\n        }\n        this.buf = next;\n        this.head = args.headIndex;\n        this.filled = args.filled;\n    }\n\n    reset(): void {\n        this.buf = new Float64Array(this.capacity);\n        this.head = -1;\n        this.filled = 0;\n    }\n}\n"]}