@invinite-org/chartlang-runtime 1.1.1 → 1.3.0

package/dist/ringBuffer.d.ts

@@ -91,5 +91,24 @@ export declare class Float64RingBuffer implements RingBufferLike<number> {
         values: ReadonlyArray<number | null>;
     }>): void;
     reset(): void;
+    /**
+     * Overwrite this ring's entire state with a copy of `other`'s. A single
+     * `Float64Array.prototype.set()` memcpy plus a head/filled copy — `O(capacity)`
+     * with a small constant, not an element loop. `state.array`'s two-ring tick
+     * discipline (`packages/runtime/src/state/arrayStateSlot.ts`) calls this every
+     * tick to roll the tentative ring back to committed (and on close to commit it),
+     * so the typed-array `set()` is load-bearing for the hot path. Both rings in a
+     * slot share `capacity`, so this never reshapes the backing array.
+     *
+     * @since 1.3
+     * @stable
+     * @example
+     *     const a = new Float64RingBuffer(4);
+     *     const b = new Float64RingBuffer(4);
+     *     a.append(1);
+     *     b.copyFrom(a);
+     *     b.at(0); // 1
+     */
+    copyFrom(other: Float64RingBuffer): void;
 }
 //# sourceMappingURL=ringBuffer.d.ts.map

package/dist/ringBuffer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ringBuffer.d.ts","sourceRoot":"","sources":["../src/ringBuffer.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,cAAc,CAAC,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,MAAM,CAAC,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC;IACnB,WAAW,CAAC,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC;IACxB,EAAE,CAAC,CAAC,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS,CAAC;IAC7B,KAAK,IAAI,IAAI,CAAC;CACjB;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,UAAU,CAAC,CAAC,CAAE,YAAW,cAAc,CAAC,CAAC,CAAC;aAKvB,QAAQ,EAAE,MAAM;IAJ5C,OAAO,CAAC,GAAG,CAAuB;IAClC,OAAO,CAAC,IAAI,CAAM;IAClB,OAAO,CAAC,MAAM,CAAK;gBAES,QAAQ,EAAE,MAAM;IAI5C,MAAM,CAAC,CAAC,EAAE,CAAC,GAAG,IAAI;IAMlB,WAAW,CAAC,CAAC,EAAE,CAAC,GAAG,IAAI;IAQvB,EAAE,CAAC,CAAC,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS;IAK5B,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED,KAAK,IAAI,IAAI;CAKhB;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,iBAAkB,YAAW,cAAc,CAAC,MAAM,CAAC;aAKhC,QAAQ,EAAE,MAAM;IAJ5C,OAAO,CAAC,GAAG,CAAe;IAC1B,OAAO,CAAC,IAAI,CAAM;IAClB,OAAO,CAAC,MAAM,CAAK;gBAES,QAAQ,EAAE,MAAM;IAI5C,MAAM,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI;IAMvB,WAAW,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI;IAQ5B,EAAE,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM;IAKrB,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED,uBAAuB,IAAI,QAAQ,CAAC;QAChC,SAAS,EAAE,MAAM,CAAC;QAClB,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,EAAE,aAAa,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;KACxC,CAAC;IAYF,yBAAyB,CACrB,IAAI,EAAE,QAAQ,CAAC;QACX,SAAS,EAAE,MAAM,CAAC;QAClB,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,EAAE,aAAa,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;KACxC,CAAC,GACH,IAAI;IAwBP,KAAK,IAAI,IAAI;CAKhB"}
+{"version":3,"file":"ringBuffer.d.ts","sourceRoot":"","sources":["../src/ringBuffer.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,cAAc,CAAC,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,MAAM,CAAC,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC;IACnB,WAAW,CAAC,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC;IACxB,EAAE,CAAC,CAAC,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS,CAAC;IAC7B,KAAK,IAAI,IAAI,CAAC;CACjB;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,UAAU,CAAC,CAAC,CAAE,YAAW,cAAc,CAAC,CAAC,CAAC;aAKvB,QAAQ,EAAE,MAAM;IAJ5C,OAAO,CAAC,GAAG,CAAuB;IAClC,OAAO,CAAC,IAAI,CAAM;IAClB,OAAO,CAAC,MAAM,CAAK;gBAES,QAAQ,EAAE,MAAM;IAI5C,MAAM,CAAC,CAAC,EAAE,CAAC,GAAG,IAAI;IAMlB,WAAW,CAAC,CAAC,EAAE,CAAC,GAAG,IAAI;IAQvB,EAAE,CAAC,CAAC,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS;IAK5B,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED,KAAK,IAAI,IAAI;CAKhB;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,iBAAkB,YAAW,cAAc,CAAC,MAAM,CAAC;aAKhC,QAAQ,EAAE,MAAM;IAJ5C,OAAO,CAAC,GAAG,CAAe;IAC1B,OAAO,CAAC,IAAI,CAAM;IAClB,OAAO,CAAC,MAAM,CAAK;gBAES,QAAQ,EAAE,MAAM;IAI5C,MAAM,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI;IAMvB,WAAW,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI;IAQ5B,EAAE,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM;IAKrB,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED,uBAAuB,IAAI,QAAQ,CAAC;QAChC,SAAS,EAAE,MAAM,CAAC;QAClB,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,EAAE,aAAa,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;KACxC,CAAC;IAYF,yBAAyB,CACrB,IAAI,EAAE,QAAQ,CAAC;QACX,SAAS,EAAE,MAAM,CAAC;QAClB,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,EAAE,aAAa,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;KACxC,CAAC,GACH,IAAI;IAwBP,KAAK,IAAI,IAAI;IAMb;;;;;;;;;;;;;;;;;OAiBG;IACH,QAAQ,CAAC,KAAK,EAAE,iBAAiB,GAAG,IAAI;CAK3C"}

package/dist/ringBuffer.js

@@ -142,5 +142,28 @@ export class Float64RingBuffer {
         this.head = -1;
         this.filled = 0;
     }
+    /**
+     * Overwrite this ring's entire state with a copy of `other`'s. A single
+     * `Float64Array.prototype.set()` memcpy plus a head/filled copy — `O(capacity)`
+     * with a small constant, not an element loop. `state.array`'s two-ring tick
+     * discipline (`packages/runtime/src/state/arrayStateSlot.ts`) calls this every
+     * tick to roll the tentative ring back to committed (and on close to commit it),
+     * so the typed-array `set()` is load-bearing for the hot path. Both rings in a
+     * slot share `capacity`, so this never reshapes the backing array.
+     *
+     * @since 1.3
+     * @stable
+     * @example
+     *     const a = new Float64RingBuffer(4);
+     *     const b = new Float64RingBuffer(4);
+     *     a.append(1);
+     *     b.copyFrom(a);
+     *     b.at(0); // 1
+     */
+    copyFrom(other) {
+        this.buf.set(other.buf);
+        this.head = other.head;
+        this.filled = other.filled;
+    }
 }
 //# sourceMappingURL=ringBuffer.js.map

package/dist/ringBuffer.js.map

@@ -1 +1 @@
-{"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"]}
+{"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    /**\n     * Overwrite this ring's entire state with a copy of `other`'s. A single\n     * `Float64Array.prototype.set()` memcpy plus a head/filled copy — `O(capacity)`\n     * with a small constant, not an element loop. `state.array`'s two-ring tick\n     * discipline (`packages/runtime/src/state/arrayStateSlot.ts`) calls this every\n     * tick to roll the tentative ring back to committed (and on close to commit it),\n     * so the typed-array `set()` is load-bearing for the hot path. Both rings in a\n     * slot share `capacity`, so this never reshapes the backing array.\n     *\n     * @since 1.3\n     * @stable\n     * @example\n     *     const a = new Float64RingBuffer(4);\n     *     const b = new Float64RingBuffer(4);\n     *     a.append(1);\n     *     b.copyFrom(a);\n     *     b.at(0); // 1\n     */\n    copyFrom(other: Float64RingBuffer): void {\n        this.buf.set(other.buf);\n        this.head = other.head;\n        this.filled = other.filled;\n    }\n}\n"]}

package/dist/runtimeContext.d.ts

@@ -2,6 +2,9 @@ import type { AlertConditionEmission, AlertEmission, Capabilities, DrawingEmissi
 import type { AlertConditionDefinition, Bar, DrawingBucket, DrawingCounts, DrawingKind, DrawingState, SecurityBar, Series } from "@invinite-org/chartlang-core";
 import type { DepOutputStore } from "./dep/DepOutputStore.js";
 import type { PersistentStateStore } from "./persistentStateStore.js";
+import type { SecurityExprRunner } from "./request/securityExprRunner.js";
+import type { ArrayStateSlot } from "./state/arrayStateSlot.js";
+import type { SeriesSlot } from "./state/seriesSlot.js";
 import type { StateSlot } from "./state/stateSlot.js";
 import type { StateStore } from "./stateStore.js";
 import type { StreamState } from "./streamState.js";
@@ -14,6 +17,15 @@ import type { RuntimeViews } from "./views/index.js";
  * it and re-emit the full payload. `removed: true`
  * is sticky — further `update` / `remove` on the handle no-op.
  *
+ * `z` is the presentation-only render-order key `handle.ts`'s `splitZ`
+ * lifted out of the drawing's `state.style` (default `0`). It is stored
+ * **beside** `state` — never inside `state` / `state.style` — because
+ * the wire carries it as the top-level {@link DrawingEmission.z} field,
+ * not as part of {@link DrawingState}. It persists across bars; an
+ * `update` that does not re-specify a non-zero `z` retains it, a
+ * re-specified non-zero `z` overrides, and a cross-bar re-entry
+ * re-specifies it from the new call.
+ *
  * @since 0.3
  * @stable
  * @example
@@ -21,6 +33,7 @@ import type { RuntimeViews } from "./views/index.js";
  *     //     handleId: "x.chart.ts:1:1#0",
  *     //     kind: "line",
  *     //     state: { kind: "line", anchors: [...], style: {} },
+ *     //     z: 0,
  *     //     removed: false,
  *     // };
  */
@@ -28,6 +41,7 @@ export type DrawingSlot = {
     readonly handleId: string;
     readonly kind: DrawingKind;
     state: DrawingState;
+    z: number;
     removed: boolean;
 };
 /**
@@ -139,20 +153,55 @@ export type RuntimeContext = {
      */
     readonly stateSlots: Map<string, StateSlot<unknown>>;
     /**
-     * Secondary candle streams keyed by `IntervalDescriptor.value`.
-     * Mutated only by `createScriptRunner` mount/restore/routing. @since 0.5
+     * Runtime `state.series` slot store keyed by
+     * `${slotIdPrefix ?? ""}${slotId}:series`. Each holds a history ring +
+     * the identity-stable script-facing view + the last committed head.
+     * The ring advances once per close (script-invisible lockstep), so
+     * `s[1]` is always one committed bar back. Cleared on `dispose` after
+     * the final snapshot captures it. @since 0.9
+     */
+    readonly seriesSlots: Map<string, SeriesSlot>;
+    /**
+     * Runtime `state.array` slot store keyed by
+     * `${slotIdPrefix ?? ""}${slotId}:array`. Each holds two
+     * `Float64RingBuffer`s (committed + tentative) behind an identity-stable
+     * bounded-FIFO handle. A parallel map (vs folding into `stateSlots`)
+     * mirrors the `state.series` precedent — both collection primitives share
+     * the two-ring shape and snapshot directly from the live map with no
+     * `StateStore` flush. Cleared on `dispose`. @since 1.3
+     */
+    readonly arraySlots: Map<string, ArrayStateSlot>;
+    /**
+     * The chart's own symbol, resolved once at mount from the adapter
+     * `syminfo.ticker` (`""` when the adapter supplies none). A
+     * `request.security` call that omits `symbol` — or passes this exact
+     * ticker — resolves to it and collapses to the bare-interval
+     * {@link feedKey}, so the chart-symbol path is byte-identical to the
+     * pre-multi-symbol baseline. Only a *different* symbol allocates a
+     * `"<symbol>@<interval>"` feed. @since 1.3
+     */
+    readonly chartSymbol: string;
+    /**
+     * Secondary candle streams keyed by the composite
+     * `feedKey(symbol, interval)` (the shared core helper). A symbol-omitted
+     * feed collapses to the bare interval — `feedKey(undefined, "1D") === "1D"`
+     * — so the chart-symbol path is byte-identical to the pre-multi-symbol
+     * baseline; a non-chart symbol keys as `"<symbol>@<interval>"`. Mutated only
+     * by `createScriptRunner` mount/restore/routing. @since 0.5
      */
     readonly secondaryStreams: Map<string, StreamState>;
     /**
-     * Per-`request.security` slot cache keyed by `slotId|interval`. Phase 4
+     * Per-`request.security` slot cache keyed by `slotId|feedKey`. Phase 4
      * stores NaN fallback bars here; Phase 5 replaces the value producer with
-     * aligned secondary stream series while preserving stable identity.
+     * aligned secondary stream series while preserving stable identity. The
+     * `feedKey` collapses to the bare interval for chart-symbol requests, so
+     * the omitted-symbol cache key is byte-identical to the baseline.
      * @since 0.4
      */
     readonly requestSecurityBars: Map<string, SecurityBar>;
     /**
      * Per-compute aligned numeric arrays keyed by
-     * `slotId|interval|sourceKey`. Cleared on main-stream close/tick before
+     * `slotId|feedKey|sourceKey`. Cleared on main-stream close/tick before
      * `compute` so `request.security` re-aligns against the latest
      * secondary buffers. @since 0.5
      */
@@ -167,6 +216,34 @@ export type RuntimeContext = {
      * {@link requestSecurityAlignments}. @since 0.5
      */
     readonly requestSecurityAscendingBars: Map<StreamState, ReadonlyArray<Bar>>;
+    /**
+     * Mounted HTF expression runners keyed by `slotId`. One entry per
+     * `manifest.securityExpressions` callsite. `request.security(slotId,
+     * opts, expr)` dispatches the expression overload off this registry
+     * (rather than `expr !== undefined`) and captures the callback here.
+     * Absent on dep / sibling contexts and single-timeframe scripts.
+     * Cleared on `dispose`. @since 0.7
+     */
+    securityExprRunners?: Map<string, SecurityExprRunner>;
+    /**
+     * Per-feed index into {@link securityExprRunners}, keyed by the composite
+     * `feedKey(symbol, interval)`. `driveSecurityExpressions` fans a secondary
+     * close / tick (tagged with that same composite key on
+     * `CandleEvent.streamKey`) out to every runner on that feed. A
+     * symbol-omitted callsite collapses to the bare interval, byte-identical to
+     * the pre-multi-symbol baseline. Absent when no expression callsites are
+     * declared. Cleared on `dispose`. @since 0.7
+     */
+    securityExprRunnersByFeed?: ReadonlyMap<string, ReadonlyArray<SecurityExprRunner>>;
+    /**
+     * Per-compute aligned expression-output series cache keyed by
+     * `slotId|feedKey`. Holds the stable `Series<number>` Proxy each
+     * expression-form `request.security` returns; cleared each bar
+     * (alongside {@link requestSecurityAlignments}) so the proxy re-aligns
+     * the runner's output buffer against the latest secondary buffers.
+     * @since 0.7
+     */
+    requestSecurityExprSeries?: Map<string, Series<number>>;
     /**
      * Per-`request.lowerTf` slot cache keyed by `slotId|interval`. Values are
      * stable `Series<ReadonlyArray<Bar>>` proxies over the latest LTF bucket
@@ -178,6 +255,14 @@ export type RuntimeContext = {
      * `code|slotId|interval|kind`. Cleared on `dispose`. @since 0.4
      */
     readonly diagnosedRequestKeys: Set<string>;
+    /**
+     * Runtime diagnostic dedupe for `time.*` / `session.*` DST-zone
+     * fallbacks, keyed by `tz-dst-unsupported|<tz>`. The calendar accessors
+     * are `slot: false` (no slotId to key on), so they dedupe on the
+     * timezone string here — a DST zone warns at most once per distinct tz
+     * per mount. Cleared on `dispose`. @since 1.5
+     */
+    readonly diagnosedTzKeys: Set<string>;
     /**
      * Manifest-declared alert conditions keyed by condition id. Used by
      * `signal(conditionId, fired)` to reject unknown ids without

package/dist/runtimeContext.d.ts.map

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

package/dist/runtimeContext.js.map

@@ -1 +1 @@
-{"version":3,"file":"runtimeContext.js","sourceRoot":"","sources":["../src/runtimeContext.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,+DAA+D;AA2S/D;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAuC;IACtE,OAAO,EAAE,IAAI;CAChB,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    AlertConditionEmission,\n    AlertEmission,\n    Capabilities,\n    DrawingEmission,\n    LogEmission,\n    PlotEmission,\n    PlotOverride,\n    RuntimeDiagnostic,\n} from \"@invinite-org/chartlang-adapter-kit\";\nimport type {\n    AlertConditionDefinition,\n    Bar,\n    DrawingBucket,\n    DrawingCounts,\n    DrawingKind,\n    DrawingState,\n    SecurityBar,\n    Series,\n} from \"@invinite-org/chartlang-core\";\n\nimport type { DepOutputStore } from \"./dep/DepOutputStore.js\";\nimport type { PersistentStateStore } from \"./persistentStateStore.js\";\nimport type { StateSlot } from \"./state/stateSlot.js\";\nimport type { StateStore } from \"./stateStore.js\";\nimport type { StreamState } from \"./streamState.js\";\nimport type { RuntimeViews } from \"./views/index.js\";\n\n/**\n * Per-handle drawing slot the runtime persists across bars. The key is\n * `slotId#subId` (compiler-injected callsite id + per-bar sub-id from\n * {@link nextSubId}). `state` holds the last full {@link DrawingState}\n * emitted for the handle; subsequent `update(patch)` calls merge into\n * it and re-emit the full payload. `removed: true`\n * is sticky — further `update` / `remove` on the handle no-op.\n *\n * @since 0.3\n * @stable\n * @example\n *     // const slot: DrawingSlot = {\n *     //     handleId: \"x.chart.ts:1:1#0\",\n *     //     kind: \"line\",\n *     //     state: { kind: \"line\", anchors: [...], style: {} },\n *     //     removed: false,\n *     // };\n */\nexport type DrawingSlot = {\n    readonly handleId: string;\n    readonly kind: DrawingKind;\n    state: DrawingState;\n    removed: boolean;\n};\n\n/**\n * Mutable counterpart of `RunnerEmissions` (from adapter-kit) that the\n * runtime accumulates into per bar. Task 6's execution loop pushes\n * here during `compute`; `drain()` snapshots into the readonly\n * `RunnerEmissions` shape the adapter receives.\n *\n * @since 0.1\n * @example\n *     // const emissions: MutableRunnerEmissions = {\n *     //     plots: [],\n *     //     drawings: [],\n *     //     alerts: [],\n *     //     diagnostics: [],\n *     //     fromBar: 0,\n *     //     toBar: 0,\n *     // };\n */\nexport type MutableRunnerEmissions = {\n    plots: PlotEmission[];\n    drawings: DrawingEmission[];\n    alerts: AlertEmission[];\n    alertConditions?: AlertConditionEmission[];\n    logs: LogEmission[];\n    diagnostics: RuntimeDiagnostic[];\n    fromBar: number;\n    toBar: number;\n};\n\n/**\n * The contract Task 6's execution loop hands to stateful primitives\n * (Tasks 7-8) inside a single `compute` step. Tasks 7-8 read this\n * through {@link ACTIVE_RUNTIME_CONTEXT} — the runtime sets `.current`\n * around `compute` in a `try/finally`, so primitives can find their\n * series, slot store, capability bag, emission destination, and bar\n * index without an explicit argument.\n *\n * `isTick` discriminates `onBarTick` calls (head-replace mode) from\n * `onBarClose` / `onHistory` (append mode). Stateful primitives in\n * Task 7 use it to swap append vs replace-head behaviour.\n *\n * `stateSlots` stores Phase-4 `state.*` / `state.tick.*` slots keyed by\n * `${slotId}:state`; values flush into `stateStore` at close/dispose.\n *\n * `views` is a mutable container whose fields are replaced with fresh frozen\n * `barstate.*`, `syminfo.*`, and `timeframe.*` snapshots as the runner\n * advances.\n *\n * `resolvedInputs` is the frozen bag handed to `compute({ inputs })`,\n * resolved once at mount from manifest defaults plus adapter overrides.\n *\n * @since 0.1\n * @example\n *     // const ctx: RuntimeContext = {\n *     //     stream, stateStore, capabilities, emissions,\n *     //     barIndex: () => 0,\n *     //     isTick: false,\n *     // };\n */\nexport type RuntimeContext = {\n    readonly stream: StreamState;\n    readonly stateStore: StateStore;\n    readonly persistentStateStore?: PersistentStateStore;\n    lastPersistTime: number;\n    readonly capabilities: Capabilities;\n    readonly emissions: MutableRunnerEmissions;\n    readonly barIndex: () => number;\n    isTick: boolean;\n    /**\n     * Per-handle drawing slot store keyed by `slotId#subId`. Allocated\n     * on first `op: \"create\"`; mutated by `update(patch)` to merge the\n     * patch into the slot's `state`; flagged `removed: true` on\n     * `remove()`. Cleared on `dispose`. Persists across bars.\n     * @since 0.3\n     */\n    readonly drawingSlots: Map<string, DrawingSlot>;\n    /**\n     * Per-callsite per-bar sub-id counter. Each `draw.<kind>(...)` call\n     * inside a bar reads `nextSubId(ctx, slotId)`; the counter resets\n     * at the top of each `onBarClose` / `onBarTick` so iteration `i` at\n     * the same callsite yields the same `slotId#i` across bars.\n     * Cleared on `dispose`. @since 0.3\n     */\n    readonly drawingSubIdCounters: Map<string, number>;\n    /**\n     * Live per-bucket allocation tally for the current script. Each\n     * `op: \"create\"` increments the relevant bucket; each\n     * `op: \"remove\"` decrements (clamped at 0). `op: \"update\"` is\n     * free. `pushDrawing` drops the emission with\n     * `drawing-budget-exceeded` once a bucket hits its effective\n     * budget (min of adapter cap + `scriptMaxDrawings`). Reset to\n     * zero on `dispose`. @since 0.3\n     */\n    readonly drawingBucketCounters: Record<DrawingBucket, number>;\n    /**\n     * The script's per-bucket cap from `defineIndicator({ maxDrawings:\n     * ... })` / `defineDrawing({ maxDrawings: ... })`. `null` when\n     * omitted — `pushDrawing` then enforces the adapter cap alone.\n     * Effective budget is `min(scriptMaxDrawings[b],\n     * capabilities.maxDrawingsPerScript[b])`. @since 0.3\n     */\n    readonly scriptMaxDrawings: DrawingCounts | null;\n    /**\n     * Runtime `state.*` / `state.tick.*` slot store keyed by\n     * `${slotIdPrefix ?? \"\"}${slotId}:state`. Non-tick slots keep\n     * committed/tentative values; tick slots commit writes immediately.\n     * Cleared on `dispose` after flushing snapshots to `stateStore`.\n     * @since 0.4\n     */\n    readonly stateSlots: Map<string, StateSlot<unknown>>;\n    /**\n     * Secondary candle streams keyed by `IntervalDescriptor.value`.\n     * Mutated only by `createScriptRunner` mount/restore/routing. @since 0.5\n     */\n    readonly secondaryStreams: Map<string, StreamState>;\n    /**\n     * Per-`request.security` slot cache keyed by `slotId|interval`. Phase 4\n     * stores NaN fallback bars here; Phase 5 replaces the value producer with\n     * aligned secondary stream series while preserving stable identity.\n     * @since 0.4\n     */\n    readonly requestSecurityBars: Map<string, SecurityBar>;\n    /**\n     * Per-compute aligned numeric arrays keyed by\n     * `slotId|interval|sourceKey`. Cleared on main-stream close/tick before\n     * `compute` so `request.security` re-aligns against the latest\n     * secondary buffers. @since 0.5\n     */\n    readonly requestSecurityAlignments: Map<string, ReadonlyArray<number>>;\n    /**\n     * Per-compute cache of ascending `Bar[]` materialisations keyed by the\n     * source `StreamState`. Shared by `request.security` and `request.lowerTf`\n     * (via `request/streamBars.ts:ascendingBarsFor`) so a stable bar-array\n     * identity is reused across every consumer in a bar — the `getOrAlign` /\n     * `getOrBucket` WeakMap caches actually hit and the same ring buffer is\n     * walked once per bar instead of 10×. Cleared alongside\n     * {@link requestSecurityAlignments}. @since 0.5\n     */\n    readonly requestSecurityAscendingBars: Map<StreamState, ReadonlyArray<Bar>>;\n    /**\n     * Per-`request.lowerTf` slot cache keyed by `slotId|interval`. Values are\n     * stable `Series<ReadonlyArray<Bar>>` proxies over the latest LTF bucket\n     * materialisation. @since 0.6\n     */\n    readonly requestLowerTfViews: Map<string, Series<ReadonlyArray<Bar>>>;\n    /**\n     * Runtime diagnostic dedupe for `request.*` capability gates, keyed by\n     * `code|slotId|interval|kind`. Cleared on `dispose`. @since 0.4\n     */\n    readonly diagnosedRequestKeys: Set<string>;\n    /**\n     * Manifest-declared alert conditions keyed by condition id. Used by\n     * `signal(conditionId, fired)` to reject unknown ids without\n     * re-reading the manifest each bar. @since 0.5\n     */\n    readonly alertConditions?: ReadonlyMap<string, AlertConditionDefinition>;\n    /**\n     * Dedupe for alert-condition capability/unknown-id diagnostics, keyed\n     * by `code|conditionId`. Cleared on dispose. @since 0.5\n     */\n    readonly diagnosedAlertConditionKeys?: Set<string>;\n    /**\n     * Number of `runtime.log.*` emissions accepted in the active compute\n     * step. Reset at the start of each close/tick. @since 0.5\n     */\n    logBudget: number;\n    /**\n     * Per-step dedupe flag for `runtime-log-budget-exceeded`. Reset with\n     * `logBudget` at the start of each close/tick. @since 0.5\n     */\n    logBudgetExceededDiagnosed: boolean;\n    /**\n     * Frozen effective input values keyed by script input name. Resolved once\n     * at mount and reused by every compute step. @since 0.4\n     */\n    resolvedInputs: Readonly<Record<string, unknown>>;\n    /**\n     * Mount-time script pane default. The runner sets it from\n     * `manifest.overlay`:\n     *   - `overlay` absent / `true` → `\"overlay\"`.\n     *   - `overlay === false` → `\"script:<sanitised(manifest.name)>\"`.\n     * `resolvePane` reads this value when a `plot()` / `hline()` call\n     * has no explicit `pane` opt.\n     * @since 0.2\n     */\n    readonly defaultPane: string;\n    /**\n     * Stable non-overlay pane key for this script. Explicit\n     * `pane: \"new\"` resolves here even when `defaultPane === \"overlay\"`\n     * so every `\"new\"` plot in a script joins one script-owned subpane.\n     * @since 0.2\n     */\n    readonly scriptPane: string;\n    /**\n     * Host-supplied per-slot presentation overrides, keyed by\n     * `PlotEmission.slotId`. Applied at emit time by `applyPlotOverride`.\n     * Mutable — `setPlotOverrides` swaps it live (presentation-only, so\n     * it does not break the frozen-input determinism guarantee). Entries\n     * themselves are frozen. @since 0.8\n     */\n    plotOverrides: Readonly<Record<string, PlotOverride>>;\n    /**\n     * Runtime diagnostic dedupe for mount-time input override failures,\n     * keyed by manifest input key. Cleared on `dispose`. @since 0.4\n     */\n    readonly diagnosedInputKeys: Set<string>;\n    /**\n     * Runtime `barstate.*`, `syminfo.*`, and `timeframe.*` views. The\n     * container is mutable; each assigned view snapshot is frozen.\n     * @since 0.4\n     */\n    readonly views: RuntimeViews;\n    /**\n     * Prefix prepended when emissions from this context flow into the\n     * parent runner's queues, and mirrored into every `stateSlots` /\n     * `StateStore` key written by `state.*` / `state.tick.*` so each\n     * runner's persisted state is isolated. `\"dep:<localId>/\"` for\n     * private dep runners, `\"export:<exportName>/\"` for sibling\n     * runners, and `\"\"` (or absent) for primary single-script and\n     * bundle-primary runners.\n     *\n     * @since 0.7\n     */\n    slotIdPrefix?: string;\n    /**\n     * `true` when this context belongs to a private dep runner — its\n     * emissions are dropped (or captured into the dep output store) by\n     * `applyDepEmissionPolicy`. `false` / absent for primary and\n     * sibling runners.\n     *\n     * @since 0.7\n     */\n    isDep?: boolean;\n    /**\n     * Per-bar titled-output buffer shared by the primary and every\n     * sibling of a `CompiledScriptBundle`. Populated by\n     * `applyDepEmissionPolicy` after each dep/sibling's compute; read\n     * by `__chartlang_depOutput` during the consumer's compute. `null`\n     * / absent for single-script runners with no deps.\n     *\n     * @since 0.7\n     */\n    depOutputStore?: DepOutputStore | null;\n};\n\n/**\n * Process-wide context slot. Task 6's `createScriptRunner` mutates\n * `.current` inside `try { ... } finally { current = null }` around\n * every `compute` invocation; Tasks 7-8 read it inside primitive\n * implementations. JavaScript's single-threaded execution model\n * guarantees only one `compute` runs at a time, so this ambient\n * slot is safe.\n *\n * The export is intentionally just a holder — no class, no methods,\n * no validation. Responsibility for setting and clearing lives in\n * Task 6.\n *\n * @since 0.1\n * @example\n *     // import { ACTIVE_RUNTIME_CONTEXT }\n *     //     from \"@invinite-org/chartlang-runtime\";\n *     // ACTIVE_RUNTIME_CONTEXT.current; // null at module load\n */\nexport const ACTIVE_RUNTIME_CONTEXT: { current: RuntimeContext | null } = {\n    current: null,\n};\n"]}
+{"version":3,"file":"runtimeContext.js","sourceRoot":"","sources":["../src/runtimeContext.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,+DAA+D;AAgY/D;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAuC;IACtE,OAAO,EAAE,IAAI;CAChB,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    AlertConditionEmission,\n    AlertEmission,\n    Capabilities,\n    DrawingEmission,\n    LogEmission,\n    PlotEmission,\n    PlotOverride,\n    RuntimeDiagnostic,\n} from \"@invinite-org/chartlang-adapter-kit\";\nimport type {\n    AlertConditionDefinition,\n    Bar,\n    DrawingBucket,\n    DrawingCounts,\n    DrawingKind,\n    DrawingState,\n    SecurityBar,\n    Series,\n} from \"@invinite-org/chartlang-core\";\n\nimport type { DepOutputStore } from \"./dep/DepOutputStore.js\";\nimport type { PersistentStateStore } from \"./persistentStateStore.js\";\nimport type { SecurityExprRunner } from \"./request/securityExprRunner.js\";\nimport type { ArrayStateSlot } from \"./state/arrayStateSlot.js\";\nimport type { SeriesSlot } from \"./state/seriesSlot.js\";\nimport type { StateSlot } from \"./state/stateSlot.js\";\nimport type { StateStore } from \"./stateStore.js\";\nimport type { StreamState } from \"./streamState.js\";\nimport type { RuntimeViews } from \"./views/index.js\";\n\n/**\n * Per-handle drawing slot the runtime persists across bars. The key is\n * `slotId#subId` (compiler-injected callsite id + per-bar sub-id from\n * {@link nextSubId}). `state` holds the last full {@link DrawingState}\n * emitted for the handle; subsequent `update(patch)` calls merge into\n * it and re-emit the full payload. `removed: true`\n * is sticky — further `update` / `remove` on the handle no-op.\n *\n * `z` is the presentation-only render-order key `handle.ts`'s `splitZ`\n * lifted out of the drawing's `state.style` (default `0`). It is stored\n * **beside** `state` — never inside `state` / `state.style` — because\n * the wire carries it as the top-level {@link DrawingEmission.z} field,\n * not as part of {@link DrawingState}. It persists across bars; an\n * `update` that does not re-specify a non-zero `z` retains it, a\n * re-specified non-zero `z` overrides, and a cross-bar re-entry\n * re-specifies it from the new call.\n *\n * @since 0.3\n * @stable\n * @example\n *     // const slot: DrawingSlot = {\n *     //     handleId: \"x.chart.ts:1:1#0\",\n *     //     kind: \"line\",\n *     //     state: { kind: \"line\", anchors: [...], style: {} },\n *     //     z: 0,\n *     //     removed: false,\n *     // };\n */\nexport type DrawingSlot = {\n    readonly handleId: string;\n    readonly kind: DrawingKind;\n    state: DrawingState;\n    z: number;\n    removed: boolean;\n};\n\n/**\n * Mutable counterpart of `RunnerEmissions` (from adapter-kit) that the\n * runtime accumulates into per bar. Task 6's execution loop pushes\n * here during `compute`; `drain()` snapshots into the readonly\n * `RunnerEmissions` shape the adapter receives.\n *\n * @since 0.1\n * @example\n *     // const emissions: MutableRunnerEmissions = {\n *     //     plots: [],\n *     //     drawings: [],\n *     //     alerts: [],\n *     //     diagnostics: [],\n *     //     fromBar: 0,\n *     //     toBar: 0,\n *     // };\n */\nexport type MutableRunnerEmissions = {\n    plots: PlotEmission[];\n    drawings: DrawingEmission[];\n    alerts: AlertEmission[];\n    alertConditions?: AlertConditionEmission[];\n    logs: LogEmission[];\n    diagnostics: RuntimeDiagnostic[];\n    fromBar: number;\n    toBar: number;\n};\n\n/**\n * The contract Task 6's execution loop hands to stateful primitives\n * (Tasks 7-8) inside a single `compute` step. Tasks 7-8 read this\n * through {@link ACTIVE_RUNTIME_CONTEXT} — the runtime sets `.current`\n * around `compute` in a `try/finally`, so primitives can find their\n * series, slot store, capability bag, emission destination, and bar\n * index without an explicit argument.\n *\n * `isTick` discriminates `onBarTick` calls (head-replace mode) from\n * `onBarClose` / `onHistory` (append mode). Stateful primitives in\n * Task 7 use it to swap append vs replace-head behaviour.\n *\n * `stateSlots` stores Phase-4 `state.*` / `state.tick.*` slots keyed by\n * `${slotId}:state`; values flush into `stateStore` at close/dispose.\n *\n * `views` is a mutable container whose fields are replaced with fresh frozen\n * `barstate.*`, `syminfo.*`, and `timeframe.*` snapshots as the runner\n * advances.\n *\n * `resolvedInputs` is the frozen bag handed to `compute({ inputs })`,\n * resolved once at mount from manifest defaults plus adapter overrides.\n *\n * @since 0.1\n * @example\n *     // const ctx: RuntimeContext = {\n *     //     stream, stateStore, capabilities, emissions,\n *     //     barIndex: () => 0,\n *     //     isTick: false,\n *     // };\n */\nexport type RuntimeContext = {\n    readonly stream: StreamState;\n    readonly stateStore: StateStore;\n    readonly persistentStateStore?: PersistentStateStore;\n    lastPersistTime: number;\n    readonly capabilities: Capabilities;\n    readonly emissions: MutableRunnerEmissions;\n    readonly barIndex: () => number;\n    isTick: boolean;\n    /**\n     * Per-handle drawing slot store keyed by `slotId#subId`. Allocated\n     * on first `op: \"create\"`; mutated by `update(patch)` to merge the\n     * patch into the slot's `state`; flagged `removed: true` on\n     * `remove()`. Cleared on `dispose`. Persists across bars.\n     * @since 0.3\n     */\n    readonly drawingSlots: Map<string, DrawingSlot>;\n    /**\n     * Per-callsite per-bar sub-id counter. Each `draw.<kind>(...)` call\n     * inside a bar reads `nextSubId(ctx, slotId)`; the counter resets\n     * at the top of each `onBarClose` / `onBarTick` so iteration `i` at\n     * the same callsite yields the same `slotId#i` across bars.\n     * Cleared on `dispose`. @since 0.3\n     */\n    readonly drawingSubIdCounters: Map<string, number>;\n    /**\n     * Live per-bucket allocation tally for the current script. Each\n     * `op: \"create\"` increments the relevant bucket; each\n     * `op: \"remove\"` decrements (clamped at 0). `op: \"update\"` is\n     * free. `pushDrawing` drops the emission with\n     * `drawing-budget-exceeded` once a bucket hits its effective\n     * budget (min of adapter cap + `scriptMaxDrawings`). Reset to\n     * zero on `dispose`. @since 0.3\n     */\n    readonly drawingBucketCounters: Record<DrawingBucket, number>;\n    /**\n     * The script's per-bucket cap from `defineIndicator({ maxDrawings:\n     * ... })` / `defineDrawing({ maxDrawings: ... })`. `null` when\n     * omitted — `pushDrawing` then enforces the adapter cap alone.\n     * Effective budget is `min(scriptMaxDrawings[b],\n     * capabilities.maxDrawingsPerScript[b])`. @since 0.3\n     */\n    readonly scriptMaxDrawings: DrawingCounts | null;\n    /**\n     * Runtime `state.*` / `state.tick.*` slot store keyed by\n     * `${slotIdPrefix ?? \"\"}${slotId}:state`. Non-tick slots keep\n     * committed/tentative values; tick slots commit writes immediately.\n     * Cleared on `dispose` after flushing snapshots to `stateStore`.\n     * @since 0.4\n     */\n    readonly stateSlots: Map<string, StateSlot<unknown>>;\n    /**\n     * Runtime `state.series` slot store keyed by\n     * `${slotIdPrefix ?? \"\"}${slotId}:series`. Each holds a history ring +\n     * the identity-stable script-facing view + the last committed head.\n     * The ring advances once per close (script-invisible lockstep), so\n     * `s[1]` is always one committed bar back. Cleared on `dispose` after\n     * the final snapshot captures it. @since 0.9\n     */\n    readonly seriesSlots: Map<string, SeriesSlot>;\n    /**\n     * Runtime `state.array` slot store keyed by\n     * `${slotIdPrefix ?? \"\"}${slotId}:array`. Each holds two\n     * `Float64RingBuffer`s (committed + tentative) behind an identity-stable\n     * bounded-FIFO handle. A parallel map (vs folding into `stateSlots`)\n     * mirrors the `state.series` precedent — both collection primitives share\n     * the two-ring shape and snapshot directly from the live map with no\n     * `StateStore` flush. Cleared on `dispose`. @since 1.3\n     */\n    readonly arraySlots: Map<string, ArrayStateSlot>;\n    /**\n     * The chart's own symbol, resolved once at mount from the adapter\n     * `syminfo.ticker` (`\"\"` when the adapter supplies none). A\n     * `request.security` call that omits `symbol` — or passes this exact\n     * ticker — resolves to it and collapses to the bare-interval\n     * {@link feedKey}, so the chart-symbol path is byte-identical to the\n     * pre-multi-symbol baseline. Only a *different* symbol allocates a\n     * `\"<symbol>@<interval>\"` feed. @since 1.3\n     */\n    readonly chartSymbol: string;\n    /**\n     * Secondary candle streams keyed by the composite\n     * `feedKey(symbol, interval)` (the shared core helper). A symbol-omitted\n     * feed collapses to the bare interval — `feedKey(undefined, \"1D\") === \"1D\"`\n     * — so the chart-symbol path is byte-identical to the pre-multi-symbol\n     * baseline; a non-chart symbol keys as `\"<symbol>@<interval>\"`. Mutated only\n     * by `createScriptRunner` mount/restore/routing. @since 0.5\n     */\n    readonly secondaryStreams: Map<string, StreamState>;\n    /**\n     * Per-`request.security` slot cache keyed by `slotId|feedKey`. Phase 4\n     * stores NaN fallback bars here; Phase 5 replaces the value producer with\n     * aligned secondary stream series while preserving stable identity. The\n     * `feedKey` collapses to the bare interval for chart-symbol requests, so\n     * the omitted-symbol cache key is byte-identical to the baseline.\n     * @since 0.4\n     */\n    readonly requestSecurityBars: Map<string, SecurityBar>;\n    /**\n     * Per-compute aligned numeric arrays keyed by\n     * `slotId|feedKey|sourceKey`. Cleared on main-stream close/tick before\n     * `compute` so `request.security` re-aligns against the latest\n     * secondary buffers. @since 0.5\n     */\n    readonly requestSecurityAlignments: Map<string, ReadonlyArray<number>>;\n    /**\n     * Per-compute cache of ascending `Bar[]` materialisations keyed by the\n     * source `StreamState`. Shared by `request.security` and `request.lowerTf`\n     * (via `request/streamBars.ts:ascendingBarsFor`) so a stable bar-array\n     * identity is reused across every consumer in a bar — the `getOrAlign` /\n     * `getOrBucket` WeakMap caches actually hit and the same ring buffer is\n     * walked once per bar instead of 10×. Cleared alongside\n     * {@link requestSecurityAlignments}. @since 0.5\n     */\n    readonly requestSecurityAscendingBars: Map<StreamState, ReadonlyArray<Bar>>;\n    /**\n     * Mounted HTF expression runners keyed by `slotId`. One entry per\n     * `manifest.securityExpressions` callsite. `request.security(slotId,\n     * opts, expr)` dispatches the expression overload off this registry\n     * (rather than `expr !== undefined`) and captures the callback here.\n     * Absent on dep / sibling contexts and single-timeframe scripts.\n     * Cleared on `dispose`. @since 0.7\n     */\n    securityExprRunners?: Map<string, SecurityExprRunner>;\n    /**\n     * Per-feed index into {@link securityExprRunners}, keyed by the composite\n     * `feedKey(symbol, interval)`. `driveSecurityExpressions` fans a secondary\n     * close / tick (tagged with that same composite key on\n     * `CandleEvent.streamKey`) out to every runner on that feed. A\n     * symbol-omitted callsite collapses to the bare interval, byte-identical to\n     * the pre-multi-symbol baseline. Absent when no expression callsites are\n     * declared. Cleared on `dispose`. @since 0.7\n     */\n    securityExprRunnersByFeed?: ReadonlyMap<string, ReadonlyArray<SecurityExprRunner>>;\n    /**\n     * Per-compute aligned expression-output series cache keyed by\n     * `slotId|feedKey`. Holds the stable `Series<number>` Proxy each\n     * expression-form `request.security` returns; cleared each bar\n     * (alongside {@link requestSecurityAlignments}) so the proxy re-aligns\n     * the runner's output buffer against the latest secondary buffers.\n     * @since 0.7\n     */\n    requestSecurityExprSeries?: Map<string, Series<number>>;\n    /**\n     * Per-`request.lowerTf` slot cache keyed by `slotId|interval`. Values are\n     * stable `Series<ReadonlyArray<Bar>>` proxies over the latest LTF bucket\n     * materialisation. @since 0.6\n     */\n    readonly requestLowerTfViews: Map<string, Series<ReadonlyArray<Bar>>>;\n    /**\n     * Runtime diagnostic dedupe for `request.*` capability gates, keyed by\n     * `code|slotId|interval|kind`. Cleared on `dispose`. @since 0.4\n     */\n    readonly diagnosedRequestKeys: Set<string>;\n    /**\n     * Runtime diagnostic dedupe for `time.*` / `session.*` DST-zone\n     * fallbacks, keyed by `tz-dst-unsupported|<tz>`. The calendar accessors\n     * are `slot: false` (no slotId to key on), so they dedupe on the\n     * timezone string here — a DST zone warns at most once per distinct tz\n     * per mount. Cleared on `dispose`. @since 1.5\n     */\n    readonly diagnosedTzKeys: Set<string>;\n    /**\n     * Manifest-declared alert conditions keyed by condition id. Used by\n     * `signal(conditionId, fired)` to reject unknown ids without\n     * re-reading the manifest each bar. @since 0.5\n     */\n    readonly alertConditions?: ReadonlyMap<string, AlertConditionDefinition>;\n    /**\n     * Dedupe for alert-condition capability/unknown-id diagnostics, keyed\n     * by `code|conditionId`. Cleared on dispose. @since 0.5\n     */\n    readonly diagnosedAlertConditionKeys?: Set<string>;\n    /**\n     * Number of `runtime.log.*` emissions accepted in the active compute\n     * step. Reset at the start of each close/tick. @since 0.5\n     */\n    logBudget: number;\n    /**\n     * Per-step dedupe flag for `runtime-log-budget-exceeded`. Reset with\n     * `logBudget` at the start of each close/tick. @since 0.5\n     */\n    logBudgetExceededDiagnosed: boolean;\n    /**\n     * Frozen effective input values keyed by script input name. Resolved once\n     * at mount and reused by every compute step. @since 0.4\n     */\n    resolvedInputs: Readonly<Record<string, unknown>>;\n    /**\n     * Mount-time script pane default. The runner sets it from\n     * `manifest.overlay`:\n     *   - `overlay` absent / `true` → `\"overlay\"`.\n     *   - `overlay === false` → `\"script:<sanitised(manifest.name)>\"`.\n     * `resolvePane` reads this value when a `plot()` / `hline()` call\n     * has no explicit `pane` opt.\n     * @since 0.2\n     */\n    readonly defaultPane: string;\n    /**\n     * Stable non-overlay pane key for this script. Explicit\n     * `pane: \"new\"` resolves here even when `defaultPane === \"overlay\"`\n     * so every `\"new\"` plot in a script joins one script-owned subpane.\n     * @since 0.2\n     */\n    readonly scriptPane: string;\n    /**\n     * Host-supplied per-slot presentation overrides, keyed by\n     * `PlotEmission.slotId`. Applied at emit time by `applyPlotOverride`.\n     * Mutable — `setPlotOverrides` swaps it live (presentation-only, so\n     * it does not break the frozen-input determinism guarantee). Entries\n     * themselves are frozen. @since 0.8\n     */\n    plotOverrides: Readonly<Record<string, PlotOverride>>;\n    /**\n     * Runtime diagnostic dedupe for mount-time input override failures,\n     * keyed by manifest input key. Cleared on `dispose`. @since 0.4\n     */\n    readonly diagnosedInputKeys: Set<string>;\n    /**\n     * Runtime `barstate.*`, `syminfo.*`, and `timeframe.*` views. The\n     * container is mutable; each assigned view snapshot is frozen.\n     * @since 0.4\n     */\n    readonly views: RuntimeViews;\n    /**\n     * Prefix prepended when emissions from this context flow into the\n     * parent runner's queues, and mirrored into every `stateSlots` /\n     * `StateStore` key written by `state.*` / `state.tick.*` so each\n     * runner's persisted state is isolated. `\"dep:<localId>/\"` for\n     * private dep runners, `\"export:<exportName>/\"` for sibling\n     * runners, and `\"\"` (or absent) for primary single-script and\n     * bundle-primary runners.\n     *\n     * @since 0.7\n     */\n    slotIdPrefix?: string;\n    /**\n     * `true` when this context belongs to a private dep runner — its\n     * emissions are dropped (or captured into the dep output store) by\n     * `applyDepEmissionPolicy`. `false` / absent for primary and\n     * sibling runners.\n     *\n     * @since 0.7\n     */\n    isDep?: boolean;\n    /**\n     * Per-bar titled-output buffer shared by the primary and every\n     * sibling of a `CompiledScriptBundle`. Populated by\n     * `applyDepEmissionPolicy` after each dep/sibling's compute; read\n     * by `__chartlang_depOutput` during the consumer's compute. `null`\n     * / absent for single-script runners with no deps.\n     *\n     * @since 0.7\n     */\n    depOutputStore?: DepOutputStore | null;\n};\n\n/**\n * Process-wide context slot. Task 6's `createScriptRunner` mutates\n * `.current` inside `try { ... } finally { current = null }` around\n * every `compute` invocation; Tasks 7-8 read it inside primitive\n * implementations. JavaScript's single-threaded execution model\n * guarantees only one `compute` runs at a time, so this ambient\n * slot is safe.\n *\n * The export is intentionally just a holder — no class, no methods,\n * no validation. Responsibility for setting and clearing lives in\n * Task 6.\n *\n * @since 0.1\n * @example\n *     // import { ACTIVE_RUNTIME_CONTEXT }\n *     //     from \"@invinite-org/chartlang-runtime\";\n *     // ACTIVE_RUNTIME_CONTEXT.current; // null at module load\n */\nexport const ACTIVE_RUNTIME_CONTEXT: { current: RuntimeContext | null } = {\n    current: null,\n};\n"]}

package/dist/seriesView.d.ts

@@ -10,6 +10,14 @@ import type { RingBufferLike } from "./ringBuffer.js";
  * Property reads dispatch as follows:
  * - `series.current` → `buf.at(0)`
  * - `series.length` → `buf.length`
+ * - `series.valueOf` / `series[Symbol.toPrimitive]` → a function returning
+ *   `buf.at(0)`, so a numeric series coerces to its **current** value in any
+ *   value context (`series * 2`, `series > x`, `` `${series}` ``,
+ *   `Math.max(series, …)`). This is what lets `bar.close` be used both as a
+ *   scalar and indexed as a series. Coercion is harmless for non-numeric
+ *   buffers — nothing coerces those. Note `Number.isFinite(series)` is still
+ *   `false` (it does not coerce) and `series === 42` is `false` (object vs
+ *   number); use `series.current` / `+series` there.
  * - `series[n]` (string coerces to a non-negative integer) → `buf.at(n)`
  * - any other key → `undefined`
  *
@@ -30,30 +38,47 @@ import type { RingBufferLike } from "./ringBuffer.js";
  */
 export declare function makeSeriesView<T>(buf: RingBufferLike<T>): Series<T>;
 /**
- * Offset-shifted variant of {@link makeSeriesView}. `offset === 0`
- * returns the same Proxy shape (and is the identity-preserving fast
- * path callers should special-case at the call site). For
- * `offset === k > 0`, `view.current === buf.at(k)` — i.e. the value
- * `k` bars ago, matching `lib/applyOffset`'s
- * `out[i] = values[i − offset]` semantics. For `offset === -k`,
- * `view.current === buf.at(-k)` — an OOR read returning the underlying
- * sentinel (NaN for `Float64RingBuffer`, `undefined` for object
- * `RingBuffer`).
+ * Offset-tagging variant of {@link makeSeriesView}. It returns the
+ * **unshifted** view (delegating to {@link makeSeriesView}) and, for a
+ * non-zero `offset`, records `view → offset` in a module-level
+ * `WeakMap` side-table read by `plot()` via {@link seriesOffsetOf}. The
+ * offset is **presentation-only** — `view.current` is `buf.at(0)`, not a
+ * value `offset` bars ago — so both shift directions are expressible and
+ * alerts / `state.*` see the unshifted value. `offset === 0` records
+ * nothing (byte-identical to a plain {@link makeSeriesView}).
  *
- * The shift is applied on every read — no allocation, no per-bar
- * work. Callers cache the returned Proxy per `(slot, offset)` pair so
- * the view's identity stays stable across bars.
+ * Callers cache the returned view per `(slot, offset)` pair so the
+ * view's identity — and therefore its recorded offset — stays stable
+ * across bars.
  *
  * @since 0.2
+ * @stable
  * @example
- *     // import { Float64RingBuffer, makeShiftedSeriesView }
+ *     // import { Float64RingBuffer, makeShiftedSeriesView, seriesOffsetOf }
  *     //     from "@invinite-org/chartlang-runtime";
  *     // const buf = new Float64RingBuffer(8);
  *     // buf.append(10); buf.append(20); buf.append(30);
- *     // const view = makeShiftedSeriesView<number>(buf, 1);
- *     // view.current; // 20 (one bar ago)
- *     // view[0];      // 20
- *     // view[1];      // 10
+ *     // const view = makeShiftedSeriesView<number>(buf, 5);
+ *     // view.current;          // 30 (unshifted — the offset does NOT lag the read)
+ *     // seriesOffsetOf(view);  // 5 (presentation x-shift carried to the emission)
  */
 export declare function makeShiftedSeriesView<T>(buf: RingBufferLike<T>, offset: number): Series<T>;
+/**
+ * Read the presentation x-shift recorded for `series` by
+ * {@link makeShiftedSeriesView}, or `0` when the series is untagged (a
+ * plain {@link makeSeriesView} view, an `offset === 0` view, or any
+ * non-runtime Series). `plot()` calls this to populate
+ * `PlotEmission.xShift`; a `0` result omits the field so a no-offset
+ * plot stays byte-identical to today.
+ *
+ * @since 0.2
+ * @stable
+ * @example
+ *     // import { Float64RingBuffer, makeShiftedSeriesView, seriesOffsetOf }
+ *     //     from "@invinite-org/chartlang-runtime";
+ *     // const buf = new Float64RingBuffer(8);
+ *     // const shifted = makeShiftedSeriesView<number>(buf, -3);
+ *     // seriesOffsetOf(shifted); // -3
+ */
+export declare function seriesOffsetOf(series: Series<unknown>): number;
 //# sourceMappingURL=seriesView.d.ts.map

package/dist/seriesView.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"seriesView.d.ts","sourceRoot":"","sources":["../src/seriesView.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,8BAA8B,CAAC;AAE3D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEtD;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAAE,GAAG,EAAE,cAAc,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAoBnE;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,qBAAqB,CAAC,CAAC,EAAE,GAAG,EAAE,cAAc,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC,CAqB1F"}
+{"version":3,"file":"seriesView.d.ts","sourceRoot":"","sources":["../src/seriesView.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,8BAA8B,CAAC;AAE3D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEtD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAAE,GAAG,EAAE,cAAc,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAuBnE;AAcD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,qBAAqB,CAAC,CAAC,EAAE,GAAG,EAAE,cAAc,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC,CAI1F;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,CAAC,OAAO,CAAC,GAAG,MAAM,CAE9D"}

package/dist/seriesView.js

@@ -10,6 +10,14 @@
  * Property reads dispatch as follows:
  * - `series.current` → `buf.at(0)`
  * - `series.length` → `buf.length`
+ * - `series.valueOf` / `series[Symbol.toPrimitive]` → a function returning
+ *   `buf.at(0)`, so a numeric series coerces to its **current** value in any
+ *   value context (`series * 2`, `series > x`, `` `${series}` ``,
+ *   `Math.max(series, …)`). This is what lets `bar.close` be used both as a
+ *   scalar and indexed as a series. Coercion is harmless for non-numeric
+ *   buffers — nothing coerces those. Note `Number.isFinite(series)` is still
+ *   `false` (it does not coerce) and `series === 42` is `false` (object vs
+ *   number); use `series.current` / `+series` there.
  * - `series[n]` (string coerces to a non-negative integer) → `buf.at(n)`
  * - any other key → `undefined`
  *
@@ -35,6 +43,10 @@ export function makeSeriesView(buf) {
                 return buf.at(0);
             if (prop === "length")
                 return buf.length;
+            if (prop === "valueOf")
+                return () => buf.at(0);
+            if (prop === Symbol.toPrimitive)
+                return () => buf.at(0);
             if (typeof prop === "string") {
                 const n = Number(prop);
                 if (Number.isInteger(n) && n >= 0)
@@ -45,6 +57,8 @@ export function makeSeriesView(buf) {
         has(_target, prop) {
             if (prop === "current" || prop === "length")
                 return true;
+            if (prop === "valueOf" || prop === Symbol.toPrimitive)
+                return true;
             if (typeof prop === "string") {
                 const n = Number(prop);
                 return Number.isInteger(n) && n >= 0;
@@ -54,56 +68,65 @@ export function makeSeriesView(buf) {
     });
 }
 /**
- * Offset-shifted variant of {@link makeSeriesView}. `offset === 0`
- * returns the same Proxy shape (and is the identity-preserving fast
- * path callers should special-case at the call site). For
- * `offset === k > 0`, `view.current === buf.at(k)` — i.e. the value
- * `k` bars ago, matching `lib/applyOffset`'s
- * `out[i] = values[i − offset]` semantics. For `offset === -k`,
- * `view.current === buf.at(-k)` — an OOR read returning the underlying
- * sentinel (NaN for `Float64RingBuffer`, `undefined` for object
- * `RingBuffer`).
+ * Module-level side-table recording the **presentation x-shift** declared
+ * for an offset-tagged Series view. `offset` is no longer a value-read
+ * transform (Option A, bidirectional-plot-offset): the series value is
+ * always the unshifted `buf.at(0)`; the recorded offset rides the plot
+ * emission as `PlotEmission.xShift` so the adapter renders the series
+ * shifted (`+n` right / future, `−n` left / past) without changing the
+ * numbers alerts and `state.*` see. Keyed weakly on the view object so a
+ * dropped slot's tag is collected with it.
+ */
+const seriesOffsets = new WeakMap();
+/**
+ * Offset-tagging variant of {@link makeSeriesView}. It returns the
+ * **unshifted** view (delegating to {@link makeSeriesView}) and, for a
+ * non-zero `offset`, records `view → offset` in a module-level
+ * `WeakMap` side-table read by `plot()` via {@link seriesOffsetOf}. The
+ * offset is **presentation-only** — `view.current` is `buf.at(0)`, not a
+ * value `offset` bars ago — so both shift directions are expressible and
+ * alerts / `state.*` see the unshifted value. `offset === 0` records
+ * nothing (byte-identical to a plain {@link makeSeriesView}).
  *
- * The shift is applied on every read — no allocation, no per-bar
- * work. Callers cache the returned Proxy per `(slot, offset)` pair so
- * the view's identity stays stable across bars.
+ * Callers cache the returned view per `(slot, offset)` pair so the
+ * view's identity — and therefore its recorded offset — stays stable
+ * across bars.
  *
  * @since 0.2
+ * @stable
  * @example
- *     // import { Float64RingBuffer, makeShiftedSeriesView }
+ *     // import { Float64RingBuffer, makeShiftedSeriesView, seriesOffsetOf }
  *     //     from "@invinite-org/chartlang-runtime";
  *     // const buf = new Float64RingBuffer(8);
  *     // buf.append(10); buf.append(20); buf.append(30);
- *     // const view = makeShiftedSeriesView<number>(buf, 1);
- *     // view.current; // 20 (one bar ago)
- *     // view[0];      // 20
- *     // view[1];      // 10
+ *     // const view = makeShiftedSeriesView<number>(buf, 5);
+ *     // view.current;          // 30 (unshifted — the offset does NOT lag the read)
+ *     // seriesOffsetOf(view);  // 5 (presentation x-shift carried to the emission)
  */
 export function makeShiftedSeriesView(buf, offset) {
-    if (offset === 0)
-        return makeSeriesView(buf);
-    return new Proxy({}, {
-        get(_target, prop) {
-            if (prop === "current")
-                return buf.at(offset);
-            if (prop === "length")
-                return buf.length;
-            if (typeof prop === "string") {
-                const n = Number(prop);
-                if (Number.isInteger(n) && n >= 0)
-                    return buf.at(n + offset);
-            }
-            return undefined;
-        },
-        has(_target, prop) {
-            if (prop === "current" || prop === "length")
-                return true;
-            if (typeof prop === "string") {
-                const n = Number(prop);
-                return Number.isInteger(n) && n >= 0;
-            }
-            return false;
-        },
-    });
+    const view = makeSeriesView(buf);
+    if (offset !== 0)
+        seriesOffsets.set(view, offset);
+    return view;
+}
+/**
+ * Read the presentation x-shift recorded for `series` by
+ * {@link makeShiftedSeriesView}, or `0` when the series is untagged (a
+ * plain {@link makeSeriesView} view, an `offset === 0` view, or any
+ * non-runtime Series). `plot()` calls this to populate
+ * `PlotEmission.xShift`; a `0` result omits the field so a no-offset
+ * plot stays byte-identical to today.
+ *
+ * @since 0.2
+ * @stable
+ * @example
+ *     // import { Float64RingBuffer, makeShiftedSeriesView, seriesOffsetOf }
+ *     //     from "@invinite-org/chartlang-runtime";
+ *     // const buf = new Float64RingBuffer(8);
+ *     // const shifted = makeShiftedSeriesView<number>(buf, -3);
+ *     // seriesOffsetOf(shifted); // -3
+ */
+export function seriesOffsetOf(series) {
+    return seriesOffsets.get(series) ?? 0;
 }
 //# sourceMappingURL=seriesView.js.map