@invinite-org/chartlang-runtime 1.1.1 → 1.2.0

package/dist/state/seriesSlot.d.ts

@@ -0,0 +1,105 @@
+import type { NumberSeriesSlot } from "@invinite-org/chartlang-core";
+import type { Float64RingBuffer } from "../ringBuffer.js";
+/**
+ * Runtime slot behind a script-facing `state.series(init)` handle. The
+ * `buffer` is the history ring (index 0 = live head); the `view` is the
+ * identity-stable {@link NumberSeriesSlot} the script reads and writes;
+ * `committedHead` snapshots the head as of the last bar close so a tick
+ * can reset the live head before the script refines it.
+ *
+ * Unlike the scalar `StateSlot`, there is no tentative/committed value
+ * split — the head IS the tentative value and history IS committed (a bar
+ * advances the ring on close). `committedHead` exists only so a tick's
+ * `resetSeriesSlotHead` can undo a prior tick's `replaceHead`.
+ *
+ * @since 0.9
+ * @stable
+ * @example
+ *     // const slot = createSeriesSlot(new Float64RingBuffer(8), 0);
+ *     // slot.view.value = 42;
+ *     // slot.view[0]; // 42
+ */
+export type SeriesSlot = {
+    readonly kind: "state.series";
+    readonly buffer: Float64RingBuffer;
+    readonly view: NumberSeriesSlot;
+    committedHead: number;
+};
+/**
+ * Build the identity-stable {@link NumberSeriesSlot} view over a ring
+ * buffer. Series reads (`[n]`, `current`, `length`, `valueOf`,
+ * `Symbol.toPrimitive`) delegate to a reused {@link makeSeriesView}; the
+ * `value` property is added on top — `get` → `buffer.at(0)` (live head),
+ * `set` → `buffer.replaceHead(v)` (write-through to the live head). The
+ * object's identity is stable across bars, so a script can keep
+ * `const s = state.series(0)` at the top of `compute`.
+ *
+ * @since 0.9
+ * @stable
+ * @example
+ *     // const view = makeSeriesSlotView(buffer);
+ *     // view.value = 7; // replaceHead
+ *     // +view;          // 7  (valueOf → buffer.at(0))
+ *     // view[1];        // one committed bar back
+ */
+export declare function makeSeriesSlotView(buffer: Float64RingBuffer): NumberSeriesSlot;
+/**
+ * Allocate a fresh {@link SeriesSlot}: seed the live head with `init`
+ * (matching `state.float(init)` — a never-written series reads `init` on
+ * its allocation bar), set `committedHead = init`, and build the
+ * identity-stable view. Later bars the script does not write become `NaN`
+ * gaps because the close hook advances the ring with `append(NaN)`.
+ *
+ * @since 0.9
+ * @stable
+ * @example
+ *     // const slot = createSeriesSlot(new Float64RingBuffer(8), 0);
+ *     // slot.view[0]; // 0 (the seeded init on the allocation bar)
+ */
+export declare function createSeriesSlot(buffer: Float64RingBuffer, init: number): SeriesSlot;
+/**
+ * Rebuild a {@link SeriesSlot} over an already-restored ring buffer
+ * (snapshot path). The view identity is recreated — acceptable, same as
+ * `ta.*` restore.
+ *
+ * @since 0.9
+ * @stable
+ * @example
+ *     // const slot = restoreSeriesSlot(restoredBuffer, committedHead);
+ *     // slot.view[1];
+ */
+export declare function restoreSeriesSlot(buffer: Float64RingBuffer, committedHead: number): SeriesSlot;
+/**
+ * Advance the ring for a new close bar: append a fresh `NaN` head so the
+ * prior committed head slides to index 1. Runs once per close, before the
+ * script's compute, for every already-allocated slot.
+ *
+ * @since 0.9
+ * @stable
+ * @example
+ *     // advanceSeriesSlot(slot); // slot.view[0] is now NaN until written
+ */
+export declare function advanceSeriesSlot(slot: SeriesSlot): void;
+/**
+ * Commit the live head as the bar-close value, so the next close's
+ * `advanceSeriesSlot` retains it and a subsequent tick's
+ * `resetSeriesSlotHead` restores it. Runs once per close, after compute.
+ *
+ * @since 0.9
+ * @stable
+ * @example
+ *     // commitSeriesSlot(slot); // slot.committedHead = slot.view[0]
+ */
+export declare function commitSeriesSlot(slot: SeriesSlot): void;
+/**
+ * Reset the live head to the last committed value at the start of a tick,
+ * so a tick that re-writes refines from the committed baseline and a tick
+ * that does not write reads the committed head. Does NOT advance length.
+ *
+ * @since 0.9
+ * @stable
+ * @example
+ *     // resetSeriesSlotHead(slot); // slot.view[0] = slot.committedHead
+ */
+export declare function resetSeriesSlotHead(slot: SeriesSlot): void;
+//# sourceMappingURL=seriesSlot.d.ts.map

package/dist/state/seriesSlot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"seriesSlot.d.ts","sourceRoot":"","sources":["../../src/state/seriesSlot.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAErE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAG1D;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,MAAM,UAAU,GAAG;IACrB,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAC;IACnC,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;IAChC,aAAa,EAAE,MAAM,CAAC;CACzB,CAAC;AAEF;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,iBAAiB,GAAG,gBAAgB,CAmB9E;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,iBAAiB,EAAE,IAAI,EAAE,MAAM,GAAG,UAAU,CAQpF;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,GAAG,UAAU,CAO9F;AAED;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI,CAExD;AAED;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI,CAEvD;AAED;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI,CAE1D"}

package/dist/state/seriesSlot.js

@@ -0,0 +1,123 @@
+// Copyright (c) 2026 Invinite. Licensed under the MIT License.
+// See the LICENSE file in the repo root for full license text.
+import { makeSeriesView } from "../seriesView.js";
+/**
+ * Build the identity-stable {@link NumberSeriesSlot} view over a ring
+ * buffer. Series reads (`[n]`, `current`, `length`, `valueOf`,
+ * `Symbol.toPrimitive`) delegate to a reused {@link makeSeriesView}; the
+ * `value` property is added on top — `get` → `buffer.at(0)` (live head),
+ * `set` → `buffer.replaceHead(v)` (write-through to the live head). The
+ * object's identity is stable across bars, so a script can keep
+ * `const s = state.series(0)` at the top of `compute`.
+ *
+ * @since 0.9
+ * @stable
+ * @example
+ *     // const view = makeSeriesSlotView(buffer);
+ *     // view.value = 7; // replaceHead
+ *     // +view;          // 7  (valueOf → buffer.at(0))
+ *     // view[1];        // one committed bar back
+ */
+export function makeSeriesSlotView(buffer) {
+    const reads = makeSeriesView(buffer);
+    return new Proxy(reads, {
+        get(target, prop, receiver) {
+            if (prop === "value")
+                return buffer.at(0);
+            return Reflect.get(target, prop, receiver);
+        },
+        set(_target, prop, value) {
+            if (prop === "value") {
+                buffer.replaceHead(value);
+                return true;
+            }
+            return false;
+        },
+        has(target, prop) {
+            if (prop === "value")
+                return true;
+            return Reflect.has(target, prop);
+        },
+    });
+}
+/**
+ * Allocate a fresh {@link SeriesSlot}: seed the live head with `init`
+ * (matching `state.float(init)` — a never-written series reads `init` on
+ * its allocation bar), set `committedHead = init`, and build the
+ * identity-stable view. Later bars the script does not write become `NaN`
+ * gaps because the close hook advances the ring with `append(NaN)`.
+ *
+ * @since 0.9
+ * @stable
+ * @example
+ *     // const slot = createSeriesSlot(new Float64RingBuffer(8), 0);
+ *     // slot.view[0]; // 0 (the seeded init on the allocation bar)
+ */
+export function createSeriesSlot(buffer, init) {
+    buffer.append(init);
+    return {
+        kind: "state.series",
+        buffer,
+        view: makeSeriesSlotView(buffer),
+        committedHead: init,
+    };
+}
+/**
+ * Rebuild a {@link SeriesSlot} over an already-restored ring buffer
+ * (snapshot path). The view identity is recreated — acceptable, same as
+ * `ta.*` restore.
+ *
+ * @since 0.9
+ * @stable
+ * @example
+ *     // const slot = restoreSeriesSlot(restoredBuffer, committedHead);
+ *     // slot.view[1];
+ */
+export function restoreSeriesSlot(buffer, committedHead) {
+    return {
+        kind: "state.series",
+        buffer,
+        view: makeSeriesSlotView(buffer),
+        committedHead,
+    };
+}
+/**
+ * Advance the ring for a new close bar: append a fresh `NaN` head so the
+ * prior committed head slides to index 1. Runs once per close, before the
+ * script's compute, for every already-allocated slot.
+ *
+ * @since 0.9
+ * @stable
+ * @example
+ *     // advanceSeriesSlot(slot); // slot.view[0] is now NaN until written
+ */
+export function advanceSeriesSlot(slot) {
+    slot.buffer.append(Number.NaN);
+}
+/**
+ * Commit the live head as the bar-close value, so the next close's
+ * `advanceSeriesSlot` retains it and a subsequent tick's
+ * `resetSeriesSlotHead` restores it. Runs once per close, after compute.
+ *
+ * @since 0.9
+ * @stable
+ * @example
+ *     // commitSeriesSlot(slot); // slot.committedHead = slot.view[0]
+ */
+export function commitSeriesSlot(slot) {
+    slot.committedHead = slot.buffer.at(0);
+}
+/**
+ * Reset the live head to the last committed value at the start of a tick,
+ * so a tick that re-writes refines from the committed baseline and a tick
+ * that does not write reads the committed head. Does NOT advance length.
+ *
+ * @since 0.9
+ * @stable
+ * @example
+ *     // resetSeriesSlotHead(slot); // slot.view[0] = slot.committedHead
+ */
+export function resetSeriesSlotHead(slot) {
+    slot.buffer.replaceHead(slot.committedHead);
+}
+//# sourceMappingURL=seriesSlot.js.map

package/dist/state/seriesSlot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"seriesSlot.js","sourceRoot":"","sources":["../../src/state/seriesSlot.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,+DAA+D;AAK/D,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AA4BlD;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,kBAAkB,CAAC,MAAyB;IACxD,MAAM,KAAK,GAAG,cAAc,CAAS,MAAM,CAAC,CAAC;IAC7C,OAAO,IAAI,KAAK,CAAC,KAAyB,EAAE;QACxC,GAAG,CAAC,MAAM,EAAE,IAAI,EAAE,QAAQ;YACtB,IAAI,IAAI,KAAK,OAAO;gBAAE,OAAO,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;YAC1C,OAAO,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC;QAC/C,CAAC;QACD,GAAG,CAAC,OAAO,EAAE,IAAI,EAAE,KAAK;YACpB,IAAI,IAAI,KAAK,OAAO,EAAE,CAAC;gBACnB,MAAM,CAAC,WAAW,CAAC,KAAe,CAAC,CAAC;gBACpC,OAAO,IAAI,CAAC;YAChB,CAAC;YACD,OAAO,KAAK,CAAC;QACjB,CAAC;QACD,GAAG,CAAC,MAAM,EAAE,IAAI;YACZ,IAAI,IAAI,KAAK,OAAO;gBAAE,OAAO,IAAI,CAAC;YAClC,OAAO,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QACrC,CAAC;KACJ,CAAC,CAAC;AACP,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAAyB,EAAE,IAAY;IACpE,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACpB,OAAO;QACH,IAAI,EAAE,cAAc;QACpB,MAAM;QACN,IAAI,EAAE,kBAAkB,CAAC,MAAM,CAAC;QAChC,aAAa,EAAE,IAAI;KACtB,CAAC;AACN,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,iBAAiB,CAAC,MAAyB,EAAE,aAAqB;IAC9E,OAAO;QACH,IAAI,EAAE,cAAc;QACpB,MAAM;QACN,IAAI,EAAE,kBAAkB,CAAC,MAAM,CAAC;QAChC,aAAa;KAChB,CAAC;AACN,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAAgB;IAC9C,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;AACnC,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAgB;IAC7C,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;AAC3C,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,mBAAmB,CAAC,IAAgB;IAChD,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;AAChD,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 { NumberSeriesSlot } from \"@invinite-org/chartlang-core\";\n\nimport type { Float64RingBuffer } from \"../ringBuffer.js\";\nimport { makeSeriesView } from \"../seriesView.js\";\n\n/**\n * Runtime slot behind a script-facing `state.series(init)` handle. The\n * `buffer` is the history ring (index 0 = live head); the `view` is the\n * identity-stable {@link NumberSeriesSlot} the script reads and writes;\n * `committedHead` snapshots the head as of the last bar close so a tick\n * can reset the live head before the script refines it.\n *\n * Unlike the scalar `StateSlot`, there is no tentative/committed value\n * split — the head IS the tentative value and history IS committed (a bar\n * advances the ring on close). `committedHead` exists only so a tick's\n * `resetSeriesSlotHead` can undo a prior tick's `replaceHead`.\n *\n * @since 0.9\n * @stable\n * @example\n *     // const slot = createSeriesSlot(new Float64RingBuffer(8), 0);\n *     // slot.view.value = 42;\n *     // slot.view[0]; // 42\n */\nexport type SeriesSlot = {\n    readonly kind: \"state.series\";\n    readonly buffer: Float64RingBuffer;\n    readonly view: NumberSeriesSlot;\n    committedHead: number;\n};\n\n/**\n * Build the identity-stable {@link NumberSeriesSlot} view over a ring\n * buffer. Series reads (`[n]`, `current`, `length`, `valueOf`,\n * `Symbol.toPrimitive`) delegate to a reused {@link makeSeriesView}; the\n * `value` property is added on top — `get` → `buffer.at(0)` (live head),\n * `set` → `buffer.replaceHead(v)` (write-through to the live head). The\n * object's identity is stable across bars, so a script can keep\n * `const s = state.series(0)` at the top of `compute`.\n *\n * @since 0.9\n * @stable\n * @example\n *     // const view = makeSeriesSlotView(buffer);\n *     // view.value = 7; // replaceHead\n *     // +view;          // 7  (valueOf → buffer.at(0))\n *     // view[1];        // one committed bar back\n */\nexport function makeSeriesSlotView(buffer: Float64RingBuffer): NumberSeriesSlot {\n    const reads = makeSeriesView<number>(buffer);\n    return new Proxy(reads as NumberSeriesSlot, {\n        get(target, prop, receiver) {\n            if (prop === \"value\") return buffer.at(0);\n            return Reflect.get(target, prop, receiver);\n        },\n        set(_target, prop, value) {\n            if (prop === \"value\") {\n                buffer.replaceHead(value as number);\n                return true;\n            }\n            return false;\n        },\n        has(target, prop) {\n            if (prop === \"value\") return true;\n            return Reflect.has(target, prop);\n        },\n    });\n}\n\n/**\n * Allocate a fresh {@link SeriesSlot}: seed the live head with `init`\n * (matching `state.float(init)` — a never-written series reads `init` on\n * its allocation bar), set `committedHead = init`, and build the\n * identity-stable view. Later bars the script does not write become `NaN`\n * gaps because the close hook advances the ring with `append(NaN)`.\n *\n * @since 0.9\n * @stable\n * @example\n *     // const slot = createSeriesSlot(new Float64RingBuffer(8), 0);\n *     // slot.view[0]; // 0 (the seeded init on the allocation bar)\n */\nexport function createSeriesSlot(buffer: Float64RingBuffer, init: number): SeriesSlot {\n    buffer.append(init);\n    return {\n        kind: \"state.series\",\n        buffer,\n        view: makeSeriesSlotView(buffer),\n        committedHead: init,\n    };\n}\n\n/**\n * Rebuild a {@link SeriesSlot} over an already-restored ring buffer\n * (snapshot path). The view identity is recreated — acceptable, same as\n * `ta.*` restore.\n *\n * @since 0.9\n * @stable\n * @example\n *     // const slot = restoreSeriesSlot(restoredBuffer, committedHead);\n *     // slot.view[1];\n */\nexport function restoreSeriesSlot(buffer: Float64RingBuffer, committedHead: number): SeriesSlot {\n    return {\n        kind: \"state.series\",\n        buffer,\n        view: makeSeriesSlotView(buffer),\n        committedHead,\n    };\n}\n\n/**\n * Advance the ring for a new close bar: append a fresh `NaN` head so the\n * prior committed head slides to index 1. Runs once per close, before the\n * script's compute, for every already-allocated slot.\n *\n * @since 0.9\n * @stable\n * @example\n *     // advanceSeriesSlot(slot); // slot.view[0] is now NaN until written\n */\nexport function advanceSeriesSlot(slot: SeriesSlot): void {\n    slot.buffer.append(Number.NaN);\n}\n\n/**\n * Commit the live head as the bar-close value, so the next close's\n * `advanceSeriesSlot` retains it and a subsequent tick's\n * `resetSeriesSlotHead` restores it. Runs once per close, after compute.\n *\n * @since 0.9\n * @stable\n * @example\n *     // commitSeriesSlot(slot); // slot.committedHead = slot.view[0]\n */\nexport function commitSeriesSlot(slot: SeriesSlot): void {\n    slot.committedHead = slot.buffer.at(0);\n}\n\n/**\n * Reset the live head to the last committed value at the start of a tick,\n * so a tick that re-writes refines from the committed baseline and a tick\n * that does not write reads the committed head. Does NOT advance length.\n *\n * @since 0.9\n * @stable\n * @example\n *     // resetSeriesSlotHead(slot); // slot.view[0] = slot.committedHead\n */\nexport function resetSeriesSlotHead(slot: SeriesSlot): void {\n    slot.buffer.replaceHead(slot.committedHead);\n}\n"]}

package/dist/state/stateNamespace.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"stateNamespace.d.ts","sourceRoot":"","sources":["../../src/state/stateNamespace.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAe,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAsDhF;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,IAAI,cAAc,CAwBpD"}
+{"version":3,"file":"stateNamespace.d.ts","sourceRoot":"","sources":["../../src/state/stateNamespace.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAiC,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAoFlG;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,IAAI,cAAc,CA0BpD"}

package/dist/state/stateNamespace.js

@@ -1,6 +1,8 @@
 // Copyright (c) 2026 Invinite. Licensed under the MIT License.
 // See the LICENSE file in the repo root for full license text.
+import { Float64RingBuffer } from "../ringBuffer.js";
 import { ACTIVE_RUNTIME_CONTEXT } from "../runtimeContext.js";
+import { createSeriesSlot } from "./seriesSlot.js";
 import { asMutableSlot, StateSlot } from "./stateSlot.js";
 /**
  * Compose the runtime's `state.*` slot key from the compiler-injected
@@ -14,6 +16,16 @@ import { asMutableSlot, StateSlot } from "./stateSlot.js";
  * @internal
  */
 const stateKey = (ctx, slotId) => `${ctx.slotIdPrefix ?? ""}${slotId}:state`;
+/**
+ * Compose the runtime's `state.series` slot key — the `:series` suffix
+ * (vs `:state`) lets the snapshot restore router tell a series slot from a
+ * scalar `state.*` slot. The `slotIdPrefix` isolation rule is identical to
+ * {@link stateKey}.
+ *
+ * @since 0.9
+ * @internal
+ */
+const seriesKey = (ctx, slotId) => `${ctx.slotIdPrefix ?? ""}${slotId}:series`;
 function getCtx(name) {
     const ctx = ACTIVE_RUNTIME_CONTEXT.current;
     if (ctx === null) {
@@ -36,6 +48,21 @@ function getOrAllocate(name, slotId, init, tickPersistent) {
     ctx.stateSlots.set(key, slot);
     return asMutableSlot(slot);
 }
+function getOrAllocateSeries(slotId, init) {
+    const ctx = getCtx("state.series");
+    const key = seriesKey(ctx, slotId);
+    const existing = ctx.seriesSlots.get(key);
+    if (existing !== undefined) {
+        return existing.view;
+    }
+    // Size the ring to the runner's global capacity (`maxLookback + 1`, or
+    // the 5000-slot dynamic fallback). Warm restart rehydrates `seriesSlots`
+    // up front via `restoreSeriesSlots`, so a restored slot is found above
+    // and this seed path only runs for a genuinely first-seen callsite.
+    const slot = createSeriesSlot(new Float64RingBuffer(ctx.stream.ohlcv.close.capacity), init);
+    ctx.seriesSlots.set(key, slot);
+    return slot.view;
+}
 /**
  * Build the runtime `state` namespace installed on `ComputeContext`.
  * Each function accepts the compiler-injected `slotId` as its first
@@ -53,6 +80,7 @@ export function buildStateNamespace() {
         int: (slotId, init) => getOrAllocate("state.int", slotId, init, false),
         bool: (slotId, init) => getOrAllocate("state.bool", slotId, init, false),
         string: (slotId, init) => getOrAllocate("state.string", slotId, init, false),
+        series: (slotId, init) => getOrAllocateSeries(slotId, init),
         tick: {
             float: (slotId, init) => getOrAllocate("state.tick.float", slotId, init, true),
             int: (slotId, init) => getOrAllocate("state.tick.int", slotId, init, true),

package/dist/state/stateNamespace.js.map

@@ -1 +1 @@
-{"version":3,"file":"stateNamespace.js","sourceRoot":"","sources":["../../src/state/stateNamespace.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 { MutableSlot, StateNamespace } from \"@invinite-org/chartlang-core\";\n\nimport { ACTIVE_RUNTIME_CONTEXT, type RuntimeContext } from \"../runtimeContext.js\";\nimport { asMutableSlot, StateSlot } from \"./stateSlot.js\";\n\ntype StoredStateSlot<T> = {\n    readonly committed: T;\n    readonly tentative: T;\n};\n\n/**\n * Compose the runtime's `state.*` slot key from the compiler-injected\n * `slotId` plus the active context's `slotIdPrefix`. The primary runner\n * has an absent / empty prefix — its keys stay byte-identical to the\n * Phase-1 `${slotId}:state` shape so single-script snapshots load\n * unchanged. `DepRunner` contexts carry `dep:<localId>/`,\n * `SiblingRunner` contexts carry `export:<exportName>/`.\n *\n * @since 0.7\n * @internal\n */\nconst stateKey = (ctx: RuntimeContext, slotId: string): string =>\n    `${ctx.slotIdPrefix ?? \"\"}${slotId}:state`;\n\nfunction getCtx(name: string): RuntimeContext {\n    const ctx = ACTIVE_RUNTIME_CONTEXT.current;\n    if (ctx === null) {\n        throw new Error(`${name} called outside an active script step`);\n    }\n    return ctx;\n}\n\nfunction getOrAllocate<T>(\n    name: string,\n    slotId: string,\n    init: T,\n    tickPersistent: boolean,\n): MutableSlot<T> {\n    const ctx = getCtx(name);\n    const key = stateKey(ctx, slotId);\n    const existing = ctx.stateSlots.get(key);\n    if (existing !== undefined) {\n        return asMutableSlot(existing as StateSlot<T>);\n    }\n\n    const stored = ctx.stateStore.get<StoredStateSlot<T>>(key);\n    const slot = new StateSlot<T>(stored?.committed ?? init, tickPersistent);\n    if (stored !== undefined) {\n        slot.tentative = stored.tentative;\n    }\n    ctx.stateSlots.set(key, slot as StateSlot<unknown>);\n    return asMutableSlot(slot);\n}\n\n/**\n * Build the runtime `state` namespace installed on `ComputeContext`.\n * Each function accepts the compiler-injected `slotId` as its first\n * parameter, then the script-facing init value.\n *\n * @since 0.4\n * @stable\n * @example\n *     const ns = buildStateNamespace();\n *     void ns.float;\n */\nexport function buildStateNamespace(): StateNamespace {\n    const ns = {\n        float: (slotId: string, init: number): MutableSlot<number> =>\n            getOrAllocate(\"state.float\", slotId, init, false),\n        int: (slotId: string, init: number): MutableSlot<number> =>\n            getOrAllocate(\"state.int\", slotId, init, false),\n        bool: (slotId: string, init: boolean): MutableSlot<boolean> =>\n            getOrAllocate(\"state.bool\", slotId, init, false),\n        string: (slotId: string, init: string): MutableSlot<string> =>\n            getOrAllocate(\"state.string\", slotId, init, false),\n        tick: {\n            float: (slotId: string, init: number): MutableSlot<number> =>\n                getOrAllocate(\"state.tick.float\", slotId, init, true),\n            int: (slotId: string, init: number): MutableSlot<number> =>\n                getOrAllocate(\"state.tick.int\", slotId, init, true),\n            bool: (slotId: string, init: boolean): MutableSlot<boolean> =>\n                getOrAllocate(\"state.tick.bool\", slotId, init, true),\n            string: (slotId: string, init: string): MutableSlot<string> =>\n                getOrAllocate(\"state.tick.string\", slotId, init, true),\n        },\n    };\n    Object.freeze(ns.tick);\n    Object.freeze(ns);\n    return ns as unknown as StateNamespace;\n}\n"]}
+{"version":3,"file":"stateNamespace.js","sourceRoot":"","sources":["../../src/state/stateNamespace.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 { MutableSlot, NumberSeriesSlot, StateNamespace } from \"@invinite-org/chartlang-core\";\n\nimport { Float64RingBuffer } from \"../ringBuffer.js\";\nimport { ACTIVE_RUNTIME_CONTEXT, type RuntimeContext } from \"../runtimeContext.js\";\nimport { createSeriesSlot } from \"./seriesSlot.js\";\nimport { asMutableSlot, StateSlot } from \"./stateSlot.js\";\n\ntype StoredStateSlot<T> = {\n    readonly committed: T;\n    readonly tentative: T;\n};\n\n/**\n * Compose the runtime's `state.*` slot key from the compiler-injected\n * `slotId` plus the active context's `slotIdPrefix`. The primary runner\n * has an absent / empty prefix — its keys stay byte-identical to the\n * Phase-1 `${slotId}:state` shape so single-script snapshots load\n * unchanged. `DepRunner` contexts carry `dep:<localId>/`,\n * `SiblingRunner` contexts carry `export:<exportName>/`.\n *\n * @since 0.7\n * @internal\n */\nconst stateKey = (ctx: RuntimeContext, slotId: string): string =>\n    `${ctx.slotIdPrefix ?? \"\"}${slotId}:state`;\n\n/**\n * Compose the runtime's `state.series` slot key — the `:series` suffix\n * (vs `:state`) lets the snapshot restore router tell a series slot from a\n * scalar `state.*` slot. The `slotIdPrefix` isolation rule is identical to\n * {@link stateKey}.\n *\n * @since 0.9\n * @internal\n */\nconst seriesKey = (ctx: RuntimeContext, slotId: string): string =>\n    `${ctx.slotIdPrefix ?? \"\"}${slotId}:series`;\n\nfunction getCtx(name: string): RuntimeContext {\n    const ctx = ACTIVE_RUNTIME_CONTEXT.current;\n    if (ctx === null) {\n        throw new Error(`${name} called outside an active script step`);\n    }\n    return ctx;\n}\n\nfunction getOrAllocate<T>(\n    name: string,\n    slotId: string,\n    init: T,\n    tickPersistent: boolean,\n): MutableSlot<T> {\n    const ctx = getCtx(name);\n    const key = stateKey(ctx, slotId);\n    const existing = ctx.stateSlots.get(key);\n    if (existing !== undefined) {\n        return asMutableSlot(existing as StateSlot<T>);\n    }\n\n    const stored = ctx.stateStore.get<StoredStateSlot<T>>(key);\n    const slot = new StateSlot<T>(stored?.committed ?? init, tickPersistent);\n    if (stored !== undefined) {\n        slot.tentative = stored.tentative;\n    }\n    ctx.stateSlots.set(key, slot as StateSlot<unknown>);\n    return asMutableSlot(slot);\n}\n\nfunction getOrAllocateSeries(slotId: string, init: number): NumberSeriesSlot {\n    const ctx = getCtx(\"state.series\");\n    const key = seriesKey(ctx, slotId);\n    const existing = ctx.seriesSlots.get(key);\n    if (existing !== undefined) {\n        return existing.view;\n    }\n    // Size the ring to the runner's global capacity (`maxLookback + 1`, or\n    // the 5000-slot dynamic fallback). Warm restart rehydrates `seriesSlots`\n    // up front via `restoreSeriesSlots`, so a restored slot is found above\n    // and this seed path only runs for a genuinely first-seen callsite.\n    const slot = createSeriesSlot(new Float64RingBuffer(ctx.stream.ohlcv.close.capacity), init);\n    ctx.seriesSlots.set(key, slot);\n    return slot.view;\n}\n\n/**\n * Build the runtime `state` namespace installed on `ComputeContext`.\n * Each function accepts the compiler-injected `slotId` as its first\n * parameter, then the script-facing init value.\n *\n * @since 0.4\n * @stable\n * @example\n *     const ns = buildStateNamespace();\n *     void ns.float;\n */\nexport function buildStateNamespace(): StateNamespace {\n    const ns = {\n        float: (slotId: string, init: number): MutableSlot<number> =>\n            getOrAllocate(\"state.float\", slotId, init, false),\n        int: (slotId: string, init: number): MutableSlot<number> =>\n            getOrAllocate(\"state.int\", slotId, init, false),\n        bool: (slotId: string, init: boolean): MutableSlot<boolean> =>\n            getOrAllocate(\"state.bool\", slotId, init, false),\n        string: (slotId: string, init: string): MutableSlot<string> =>\n            getOrAllocate(\"state.string\", slotId, init, false),\n        series: (slotId: string, init: number): NumberSeriesSlot =>\n            getOrAllocateSeries(slotId, init),\n        tick: {\n            float: (slotId: string, init: number): MutableSlot<number> =>\n                getOrAllocate(\"state.tick.float\", slotId, init, true),\n            int: (slotId: string, init: number): MutableSlot<number> =>\n                getOrAllocate(\"state.tick.int\", slotId, init, true),\n            bool: (slotId: string, init: boolean): MutableSlot<boolean> =>\n                getOrAllocate(\"state.tick.bool\", slotId, init, true),\n            string: (slotId: string, init: string): MutableSlot<string> =>\n                getOrAllocate(\"state.tick.string\", slotId, init, true),\n        },\n    };\n    Object.freeze(ns.tick);\n    Object.freeze(ns);\n    return ns as unknown as StateNamespace;\n}\n"]}

package/dist/streamState.d.ts

@@ -1,4 +1,4 @@
-import type { Bar, BarViewport, Series, StreamSnapshot } from "@invinite-org/chartlang-core";
+import type { Bar, BarViewport, Price, PriceSeries, Series, StreamSnapshot, VolumeSeries, WorldPoint } from "@invinite-org/chartlang-core";
 import { Float64RingBuffer } from "./ringBuffer.js";
 /**
  * The per-stream OHLCV ring-buffer set. Each field is a
@@ -31,13 +31,17 @@ export type OhlcvBuffers = {
     readonly hlcc4: Float64RingBuffer;
 };
 /**
- * Mutable scalar view of the current bar. Identity stays stable across
- * the run — Task 6's execution loop mutates the fields in place per
- * bar so scripts that destructure `bar` in `compute` keep seeing fresh
- * values without rebinding.
+ * View of the current bar handed to `compute`. Identity stays stable across
+ * the run. The OHLCV + derived price/volume fields are the stream's cached
+ * number-coercible `Series` views (one identity per ring buffer) — they read
+ * the live buffer head, so a script can both use `bar.close` as a scalar
+ * (`bar.close * 2`) and index it (`bar.close[1]`) without the runtime copying
+ * scalars per bar. `time` stays a mutable scalar (the timestamp axis the
+ * emit/draw pipeline consumes as a raw number); `symbol` / `interval` are
+ * constant strings for a given `StreamState`.
  *
- * `symbol` and `interval` are constant for a given `StreamState`
- * instance; the rest are NaN / 0 before the first bar lands.
+ * Before the first bar the buffers are empty, so `bar.close[0]` / `+bar.close`
+ * read `NaN` and `bar.close.length` is `0`.
  *
  * @since 0.1
  * @example
@@ -47,24 +51,26 @@ export type OhlcvBuffers = {
  *     //     capacity: 5,
  *     //     symbol: "AAPL",
  *     // });
- *     // bar.symbol;   // "AAPL"
- *     // bar.interval; // "1D"
- *     // bar.close;    // NaN until the first bar
+ *     // bar.symbol;       // "AAPL"
+ *     // bar.interval;     // "1D"
+ *     // +bar.close;       // NaN until the first bar
+ *     // bar.close.length; // 0 until the first bar
  */
 export type BarView = {
     time: number;
-    open: number;
-    high: number;
-    low: number;
-    close: number;
-    volume: number;
-    hl2: number;
-    hlc3: number;
-    ohlc4: number;
-    hlcc4: number;
+    open: PriceSeries;
+    high: PriceSeries;
+    low: PriceSeries;
+    close: PriceSeries;
+    volume: VolumeSeries;
+    hl2: PriceSeries;
+    hlc3: PriceSeries;
+    ohlc4: PriceSeries;
+    hlcc4: PriceSeries;
     symbol: string;
     interval: string;
     viewport: BarViewport;
+    point(offset: number, price: Price): WorldPoint;
 };
 /**
  * Everything the runtime owns for a single interval stream — the OHLCV

package/dist/streamState.d.ts.map

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

package/dist/streamState.js

@@ -1,5 +1,6 @@
 // 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";
 import { Float64RingBuffer } from "./ringBuffer.js";
 import { makeSeriesView } from "./seriesView.js";
 function deriveBarSources(rawBar) {
@@ -90,21 +91,6 @@ export function createStreamState(args) {
         ohlc4: new Float64RingBuffer(capacity),
         hlcc4: new Float64RingBuffer(capacity),
     };
-    const bar = {
-        time: 0,
-        open: Number.NaN,
-        high: Number.NaN,
-        low: Number.NaN,
-        close: Number.NaN,
-        volume: 0,
-        hl2: Number.NaN,
-        hlc3: Number.NaN,
-        ohlc4: Number.NaN,
-        hlcc4: Number.NaN,
-        symbol,
-        interval,
-        viewport: Object.freeze({ fromTime: 0, toTime: 0 }),
-    };
     const seriesViews = {
         time: makeSeriesView(ohlcv.time),
         open: makeSeriesView(ohlcv.open),
@@ -117,6 +103,31 @@ export function createStreamState(args) {
         ohlc4: makeSeriesView(ohlcv.ohlc4),
         hlcc4: makeSeriesView(ohlcv.hlcc4),
     };
+    // The OHLCV + derived bar fields ARE the cached series views (one identity
+    // per ring buffer): the views are number-coercible, so `bar.close` works
+    // as a scalar (`+bar.close` / arithmetic reads the live head) and as an
+    // index (`bar.close[1]` reads a prior bar). No per-bar scalar copy is
+    // needed — the views read the buffer head directly, including mid-tick.
+    const bar = {
+        time: 0,
+        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,
+        interval,
+        viewport: Object.freeze({ fromTime: 0, toTime: 0 }),
+        // Closes over the stream's time history + the live scalar `bar.time` /
+        // `bar.interval` so offset-anchored drawings resolve against the real /
+        // extrapolated time at compute time. The `WorldPoint` it returns is the
+        // only persisted anchor frame — `bar.point` adds no new wire shape.
+        point: (offset, price) => resolveBarPoint(ohlcv.time, bar.interval, bar.time, offset, price),
+    };
     const stream = {
         interval,
         ohlcv,
@@ -150,31 +161,13 @@ export function createStreamState(args) {
                 });
             }
             recomputeDerivedBuffers(ohlcv, snapshot);
+            // The OHLCV + derived `bar.*` fields are the series views over the
+            // ring buffers just restored above, so they reflect the restored
+            // head with no scalar copy. Only the scalar `time` / `interval`
+            // need writing.
             const current = snapshot.headIndex;
-            if (snapshot.filled === 0 || current < 0) {
-                bar.time = 0;
-                bar.open = Number.NaN;
-                bar.high = Number.NaN;
-                bar.low = Number.NaN;
-                bar.close = Number.NaN;
-                bar.volume = 0;
-                bar.hl2 = Number.NaN;
-                bar.hlc3 = Number.NaN;
-                bar.ohlc4 = Number.NaN;
-                bar.hlcc4 = Number.NaN;
-            }
-            else {
-                bar.time = valueAt(snapshot.buffers.time, current);
-                bar.open = valueAt(snapshot.buffers.open, current);
-                bar.high = valueAt(snapshot.buffers.high, current);
-                bar.low = valueAt(snapshot.buffers.low, current);
-                bar.close = valueAt(snapshot.buffers.close, current);
-                bar.volume = valueAt(snapshot.buffers.volume, current);
-                bar.hl2 = (bar.high + bar.low) / 2;
-                bar.hlc3 = (bar.high + bar.low + bar.close) / 3;
-                bar.ohlc4 = (bar.open + bar.high + bar.low + bar.close) / 4;
-                bar.hlcc4 = (bar.high + bar.low + bar.close + bar.close) / 4;
-            }
+            bar.time =
+                snapshot.filled === 0 || current < 0 ? 0 : valueAt(snapshot.buffers.time, current);
             bar.interval = snapshot.interval;
         },
     };
@@ -203,16 +196,10 @@ export function appendBarToStream(stream, rawBar) {
     ohlcv.hlc3.append(values.hlc3);
     ohlcv.ohlc4.append(values.ohlc4);
     ohlcv.hlcc4.append(values.hlcc4);
+    // OHLCV + derived bar fields read the buffer head live (they ARE the
+    // series views), so only the scalar `time` / `symbol` / `interval` are
+    // copied onto the `BarView`.
     bar.time = rawBar.time;
-    bar.open = rawBar.open;
-    bar.high = rawBar.high;
-    bar.low = rawBar.low;
-    bar.close = rawBar.close;
-    bar.volume = rawBar.volume;
-    bar.hl2 = values.hl2;
-    bar.hlc3 = values.hlc3;
-    bar.ohlc4 = values.ohlc4;
-    bar.hlcc4 = values.hlcc4;
     bar.symbol = rawBar.symbol;
     bar.interval = rawBar.interval;
 }
@@ -244,16 +231,8 @@ export function replaceStreamHead(stream, rawBar) {
     ohlcv.hlc3.replaceHead(values.hlc3);
     ohlcv.ohlc4.replaceHead(values.ohlc4);
     ohlcv.hlcc4.replaceHead(values.hlcc4);
+    // See appendBarToStream — the OHLCV/derived views read the head live.
     bar.time = rawBar.time;
-    bar.open = rawBar.open;
-    bar.high = rawBar.high;
-    bar.low = rawBar.low;
-    bar.close = rawBar.close;
-    bar.volume = rawBar.volume;
-    bar.hl2 = values.hl2;
-    bar.hlc3 = values.hlc3;
-    bar.ohlc4 = values.ohlc4;
-    bar.hlcc4 = values.hlcc4;
     bar.symbol = rawBar.symbol;
     bar.interval = rawBar.interval;
 }
@@ -270,7 +249,7 @@ export function replaceStreamHead(stream, rawBar) {
  */
 export function replaceTickHead(stream, rawBar) {
     const values = deriveBarSources(rawBar);
-    const { ohlcv, bar } = stream;
+    const { ohlcv } = stream;
     ohlcv.close.replaceHead(rawBar.close);
     ohlcv.high.replaceHead(rawBar.high);
     ohlcv.low.replaceHead(rawBar.low);
@@ -279,14 +258,9 @@ export function replaceTickHead(stream, rawBar) {
     ohlcv.hlc3.replaceHead(values.hlc3);
     ohlcv.ohlc4.replaceHead(values.ohlc4);
     ohlcv.hlcc4.replaceHead(values.hlcc4);
-    bar.close = rawBar.close;
-    bar.high = rawBar.high;
-    bar.low = rawBar.low;
-    bar.volume = rawBar.volume;
-    bar.hl2 = values.hl2;
-    bar.hlc3 = values.hlc3;
-    bar.ohlc4 = values.ohlc4;
-    bar.hlcc4 = values.hlcc4;
+    // The close-side / derived `bar.*` fields are the series views over these
+    // buffers, so replacing the buffer head is the whole update — no scalar
+    // copy. `time` / `open` are intentionally untouched (tick invariant).
 }
 /**
  * Refresh the stream's fallback visible range to the latest `limit`