@invinite-org/chartlang-runtime 1.0.2

package/dist/state/stateNamespace.js

@@ -0,0 +1,56 @@
+// Copyright (c) 2026 Invinite. Licensed under the MIT License.
+// See the LICENSE file in the repo root for full license text.
+import { ACTIVE_RUNTIME_CONTEXT } from "../runtimeContext.js";
+import { asMutableSlot, StateSlot } from "./stateSlot.js";
+const stateKey = (slotId) => `${slotId}:state`;
+function getCtx(name) {
+    const ctx = ACTIVE_RUNTIME_CONTEXT.current;
+    if (ctx === null) {
+        throw new Error(`${name} called outside an active script step`);
+    }
+    return ctx;
+}
+function getOrAllocate(name, slotId, init, tickPersistent) {
+    const ctx = getCtx(name);
+    const key = stateKey(slotId);
+    const existing = ctx.stateSlots.get(key);
+    if (existing !== undefined) {
+        return asMutableSlot(existing);
+    }
+    const stored = ctx.stateStore.get(key);
+    const slot = new StateSlot(stored?.committed ?? init, tickPersistent);
+    if (stored !== undefined) {
+        slot.tentative = stored.tentative;
+    }
+    ctx.stateSlots.set(key, slot);
+    return asMutableSlot(slot);
+}
+/**
+ * Build the runtime `state` namespace installed on `ComputeContext`.
+ * Each function accepts the compiler-injected `slotId` as its first
+ * parameter, then the script-facing init value.
+ *
+ * @since 0.4
+ * @stable
+ * @example
+ *     const ns = buildStateNamespace();
+ *     void ns.float;
+ */
+export function buildStateNamespace() {
+    const ns = {
+        float: (slotId, init) => getOrAllocate("state.float", slotId, init, false),
+        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),
+        tick: {
+            float: (slotId, init) => getOrAllocate("state.tick.float", slotId, init, true),
+            int: (slotId, init) => getOrAllocate("state.tick.int", slotId, init, true),
+            bool: (slotId, init) => getOrAllocate("state.tick.bool", slotId, init, true),
+            string: (slotId, init) => getOrAllocate("state.tick.string", slotId, init, true),
+        },
+    };
+    Object.freeze(ns.tick);
+    Object.freeze(ns);
+    return ns;
+}
+//# sourceMappingURL=stateNamespace.js.map

package/dist/state/stateNamespace.js.map

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

package/dist/state/stateSlot.d.ts

@@ -0,0 +1,59 @@
+import type { MutableSlot } from "@invinite-org/chartlang-core";
+/**
+ * Optional PLAN §6.9 state-slot marshal hooks. Phase-4 `state.*`
+ * primitives use the identity default because their values are already
+ * JSON-clean; future primitives with typed-array internals can provide
+ * explicit hooks.
+ *
+ * @since 0.5
+ * @stable
+ * @example
+ *     const hooks: StateSlotSerialisers<number> = {
+ *         serialiseState: (value) => value,
+ *         deserialiseState: (value) => Number(value),
+ *     };
+ *     void hooks;
+ */
+export type StateSlotSerialisers<T> = {
+    readonly serialiseState?: (value: T) => unknown;
+    readonly deserialiseState?: (value: unknown) => T;
+};
+/**
+ * Internal runtime slot behind script-facing {@link MutableSlot}
+ * proxies. `tickPersistent: true` models `state.tick.*`, whose writes
+ * commit immediately; `false` models `state.*`, whose writes remain
+ * tentative until bar close.
+ *
+ * @since 0.4
+ * @stable
+ * @example
+ *     const slot = new StateSlot(0, false);
+ *     slot.set(5);
+ *     slot.onBarClose();
+ *     const pair = { committed: slot.committed, tentative: slot.tentative };
+ *     void pair;
+ */
+export declare class StateSlot<T> {
+    readonly tickPersistent: boolean;
+    private readonly serialisers;
+    committed: T;
+    tentative: T;
+    constructor(init: T, tickPersistent: boolean, serialisers?: StateSlotSerialisers<T>);
+    get(): T;
+    set(value: T): void;
+    onBarClose(): void;
+    onBarTick(): void;
+    serialise(value: T): unknown;
+}
+/**
+ * Build the script-facing mutable proxy for a runtime state slot.
+ *
+ * @since 0.4
+ * @stable
+ * @example
+ *     const slot = asMutableSlot(new StateSlot(1, false));
+ *     slot.value = 2;
+ *     void slot.value;
+ */
+export declare function asMutableSlot<T>(slot: StateSlot<T>): MutableSlot<T>;
+//# sourceMappingURL=stateSlot.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"stateSlot.d.ts","sourceRoot":"","sources":["../../src/state/stateSlot.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAEhE;;;;;;;;;;;;;;GAcG;AACH,MAAM,MAAM,oBAAoB,CAAC,CAAC,IAAI;IAClC,QAAQ,CAAC,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,OAAO,CAAC;IAChD,QAAQ,CAAC,gBAAgB,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,CAAC,CAAC;CACrD,CAAC;AAEF;;;;;;;;;;;;;;GAcG;AACH,qBAAa,SAAS,CAAC,CAAC;aAMA,cAAc,EAAE,OAAO;IACvC,OAAO,CAAC,QAAQ,CAAC,WAAW;IANhC,SAAS,EAAE,CAAC,CAAC;IACb,SAAS,EAAE,CAAC,CAAC;gBAGT,IAAI,EAAE,CAAC,EACS,cAAc,EAAE,OAAO,EACtB,WAAW,GAAE,oBAAoB,CAAC,CAAC,CAAM;IAM9D,GAAG,IAAI,CAAC;IAIR,GAAG,CAAC,KAAK,EAAE,CAAC,GAAG,IAAI;IAQnB,UAAU,IAAI,IAAI;IAMlB,SAAS,IAAI,IAAI;IAMjB,SAAS,CAAC,KAAK,EAAE,CAAC,GAAG,OAAO;CAG/B;AAED;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,CASnE"}

package/dist/state/stateSlot.js

@@ -0,0 +1,74 @@
+// Copyright (c) 2026 Invinite. Licensed under the MIT License.
+// See the LICENSE file in the repo root for full license text.
+/**
+ * Internal runtime slot behind script-facing {@link MutableSlot}
+ * proxies. `tickPersistent: true` models `state.tick.*`, whose writes
+ * commit immediately; `false` models `state.*`, whose writes remain
+ * tentative until bar close.
+ *
+ * @since 0.4
+ * @stable
+ * @example
+ *     const slot = new StateSlot(0, false);
+ *     slot.set(5);
+ *     slot.onBarClose();
+ *     const pair = { committed: slot.committed, tentative: slot.tentative };
+ *     void pair;
+ */
+export class StateSlot {
+    tickPersistent;
+    serialisers;
+    committed;
+    tentative;
+    constructor(init, tickPersistent, serialisers = {}) {
+        this.tickPersistent = tickPersistent;
+        this.serialisers = serialisers;
+        this.committed = init;
+        this.tentative = init;
+    }
+    get() {
+        return this.tickPersistent ? this.committed : this.tentative;
+    }
+    set(value) {
+        if (this.tickPersistent) {
+            this.committed = value;
+        }
+        else {
+            this.tentative = value;
+        }
+    }
+    onBarClose() {
+        if (!this.tickPersistent) {
+            this.committed = this.tentative;
+        }
+    }
+    onBarTick() {
+        if (!this.tickPersistent) {
+            this.tentative = this.committed;
+        }
+    }
+    serialise(value) {
+        return this.serialisers.serialiseState?.(value) ?? value;
+    }
+}
+/**
+ * Build the script-facing mutable proxy for a runtime state slot.
+ *
+ * @since 0.4
+ * @stable
+ * @example
+ *     const slot = asMutableSlot(new StateSlot(1, false));
+ *     slot.value = 2;
+ *     void slot.value;
+ */
+export function asMutableSlot(slot) {
+    return {
+        get value() {
+            return slot.get();
+        },
+        set value(value) {
+            slot.set(value);
+        },
+    };
+}
+//# sourceMappingURL=stateSlot.js.map

package/dist/state/stateSlot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stateSlot.js","sourceRoot":"","sources":["../../src/state/stateSlot.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,+DAA+D;AAwB/D;;;;;;;;;;;;;;GAcG;AACH,MAAM,OAAO,SAAS;IAME;IACC;IANrB,SAAS,CAAI;IACb,SAAS,CAAI;IAEb,YACI,IAAO,EACS,cAAuB,EACtB,cAAuC,EAAE;QAD1C,mBAAc,GAAd,cAAc,CAAS;QACtB,gBAAW,GAAX,WAAW,CAA8B;QAE1D,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;QACtB,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;IAC1B,CAAC;IAED,GAAG;QACC,OAAO,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC;IACjE,CAAC;IAED,GAAG,CAAC,KAAQ;QACR,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;YACtB,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC;QAC3B,CAAC;aAAM,CAAC;YACJ,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC;QAC3B,CAAC;IACL,CAAC;IAED,UAAU;QACN,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,CAAC;YACvB,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC;QACpC,CAAC;IACL,CAAC;IAED,SAAS;QACL,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,CAAC;YACvB,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC;QACpC,CAAC;IACL,CAAC;IAED,SAAS,CAAC,KAAQ;QACd,OAAO,IAAI,CAAC,WAAW,CAAC,cAAc,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC;IAC7D,CAAC;CACJ;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,aAAa,CAAI,IAAkB;IAC/C,OAAO;QACH,IAAI,KAAK;YACL,OAAO,IAAI,CAAC,GAAG,EAAE,CAAC;QACtB,CAAC;QACD,IAAI,KAAK,CAAC,KAAQ;YACd,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACpB,CAAC;KACJ,CAAC;AACN,CAAC"}

package/dist/stateStore.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Per-script slot store the runtime hands stateful primitives. Phase 1
+ * ships only the in-memory default — `inMemoryStateStore()` — keyed
+ * by the compiler-assigned slot id from PLAN.md §5.5. Phase 5 layers a
+ * `PersistentStateStore` sub-interface on top with snapshot
+ * `load` / `save` / `clear` methods (see PLAN.md §6.9). Implementations
+ * (IDB-backed for browsers, caller-supplied for servers) satisfy the
+ * Phase-5 sub-interface; the Phase-1 surface stays stable and
+ * additive.
+ *
+ * @since 0.1
+ * @example
+ *     // import { inMemoryStateStore } from "@invinite-org/chartlang-runtime";
+ *     // const store = inMemoryStateStore();
+ *     // store.set<{ count: number }>("ta:ema:slot#0", { count: 1 });
+ *     // store.has("ta:ema:slot#0"); // true
+ *     // store.get<{ count: number }>("ta:ema:slot#0"); // { count: 1 }
+ */
+export type StateStore = {
+    get<T>(slotId: string): T | undefined;
+    set<T>(slotId: string, value: T): void;
+    has(slotId: string): boolean;
+    clear(): void;
+};
+/**
+ * Default Phase-1 `StateStore` — a process-local `Map<string, unknown>`
+ * with last-write-wins semantics. Used by the CLI, the conformance
+ * suite, and the host-worker until Phase 5 wires the IDB backing.
+ *
+ * @since 0.1
+ * @example
+ *     // import { inMemoryStateStore } from "@invinite-org/chartlang-runtime";
+ *     // const store = inMemoryStateStore();
+ *     // store.set("slot#0", 42);
+ *     // store.get<number>("slot#0"); // 42
+ *     // store.clear();
+ *     // store.has("slot#0"); // false
+ */
+export declare function inMemoryStateStore(): StateStore;
+//# sourceMappingURL=stateStore.d.ts.map

package/dist/stateStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stateStore.d.ts","sourceRoot":"","sources":["../src/stateStore.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,MAAM,UAAU,GAAG;IACrB,GAAG,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS,CAAC;IACtC,GAAG,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI,CAAC;IACvC,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC;IAC7B,KAAK,IAAI,IAAI,CAAC;CACjB,CAAC;AAEF;;;;;;;;;;;;;GAaG;AACH,wBAAgB,kBAAkB,IAAI,UAAU,CAgB/C"}

package/dist/stateStore.js

@@ -0,0 +1,34 @@
+// Copyright (c) 2026 Invinite. Licensed under the MIT License.
+// See the LICENSE file in the repo root for full license text.
+/**
+ * Default Phase-1 `StateStore` — a process-local `Map<string, unknown>`
+ * with last-write-wins semantics. Used by the CLI, the conformance
+ * suite, and the host-worker until Phase 5 wires the IDB backing.
+ *
+ * @since 0.1
+ * @example
+ *     // import { inMemoryStateStore } from "@invinite-org/chartlang-runtime";
+ *     // const store = inMemoryStateStore();
+ *     // store.set("slot#0", 42);
+ *     // store.get<number>("slot#0"); // 42
+ *     // store.clear();
+ *     // store.has("slot#0"); // false
+ */
+export function inMemoryStateStore() {
+    const store = new Map();
+    return {
+        get(id) {
+            return store.get(id);
+        },
+        set(id, value) {
+            store.set(id, value);
+        },
+        has(id) {
+            return store.has(id);
+        },
+        clear() {
+            store.clear();
+        },
+    };
+}
+//# sourceMappingURL=stateStore.js.map

package/dist/stateStore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stateStore.js","sourceRoot":"","sources":["../src/stateStore.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,+DAA+D;AA2B/D;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,kBAAkB;IAC9B,MAAM,KAAK,GAAG,IAAI,GAAG,EAAmB,CAAC;IACzC,OAAO;QACH,GAAG,CAAI,EAAU;YACb,OAAO,KAAK,CAAC,GAAG,CAAC,EAAE,CAAkB,CAAC;QAC1C,CAAC;QACD,GAAG,CAAI,EAAU,EAAE,KAAQ;YACvB,KAAK,CAAC,GAAG,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;QACzB,CAAC;QACD,GAAG,CAAC,EAAU;YACV,OAAO,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACzB,CAAC;QACD,KAAK;YACD,KAAK,CAAC,KAAK,EAAE,CAAC;QAClB,CAAC;KACJ,CAAC;AACN,CAAC"}

package/dist/streamState.d.ts

@@ -0,0 +1,178 @@
+import type { Bar, BarViewport, Series, StreamSnapshot } from "@invinite-org/chartlang-core";
+import { Float64RingBuffer } from "./ringBuffer.js";
+/**
+ * The per-stream OHLCV ring-buffer set. Each field is a
+ * `Float64RingBuffer` of identical capacity. Derived sources
+ * (`hl2`, `hlc3`, `ohlc4`, `hlcc4`) are pre-computed by Task 6's
+ * execution loop alongside the raw OHLCV fields so primitives can
+ * read them as plain `Series<number>` without re-computing per
+ * lookup.
+ *
+ * @since 0.1
+ * @example
+ *     // import { createStreamState } from "@invinite-org/chartlang-runtime";
+ *     // const { ohlcv } = createStreamState({
+ *     //     interval: "1D",
+ *     //     capacity: 5,
+ *     //     symbol: "AAPL",
+ *     // });
+ *     // ohlcv.close.capacity; // 5
+ */
+export type OhlcvBuffers = {
+    readonly time: Float64RingBuffer;
+    readonly open: Float64RingBuffer;
+    readonly high: Float64RingBuffer;
+    readonly low: Float64RingBuffer;
+    readonly close: Float64RingBuffer;
+    readonly volume: Float64RingBuffer;
+    readonly hl2: Float64RingBuffer;
+    readonly hlc3: Float64RingBuffer;
+    readonly ohlc4: Float64RingBuffer;
+    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.
+ *
+ * `symbol` and `interval` are constant for a given `StreamState`
+ * instance; the rest are NaN / 0 before the first bar lands.
+ *
+ * @since 0.1
+ * @example
+ *     // import { createStreamState } from "@invinite-org/chartlang-runtime";
+ *     // const { bar } = createStreamState({
+ *     //     interval: "1D",
+ *     //     capacity: 5,
+ *     //     symbol: "AAPL",
+ *     // });
+ *     // bar.symbol;   // "AAPL"
+ *     // bar.interval; // "1D"
+ *     // bar.close;    // NaN 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;
+    symbol: string;
+    interval: string;
+    viewport: BarViewport;
+};
+/**
+ * Everything the runtime owns for a single interval stream — the OHLCV
+ * ring buffers, the mutable `BarView`, cached `Series<number>` Proxies
+ * for each source field (one identity per buffer for the lifetime of
+ * the stream), and a `taSlots` map keyed by compiler-assigned slot id
+ * that stateful primitives in Task 7 use as their hidden-state
+ * scratchpad.
+ *
+ * Phase 1 ships single-stream scripts; secondary streams via
+ * `request.security` arrive in Phase 5 and reuse this exact shape per
+ * interval.
+ *
+ * @since 0.1
+ * @example
+ *     // import { createStreamState } from "@invinite-org/chartlang-runtime";
+ *     // const stream = createStreamState({
+ *     //     interval: "1D",
+ *     //     capacity: 21,
+ *     //     symbol: "AAPL",
+ *     // });
+ *     // stream.taSlots.size; // 0
+ */
+export type StreamState = {
+    readonly interval: string;
+    readonly ohlcv: OhlcvBuffers;
+    readonly bar: BarView;
+    readonly seriesViews: {
+        readonly time: Series<number>;
+        readonly open: Series<number>;
+        readonly high: Series<number>;
+        readonly low: Series<number>;
+        readonly close: Series<number>;
+        readonly volume: Series<number>;
+        readonly hl2: Series<number>;
+        readonly hlc3: Series<number>;
+        readonly ohlc4: Series<number>;
+        readonly hlcc4: Series<number>;
+    };
+    readonly taSlots: Map<string, unknown>;
+    serialiseSnapshot(): StreamSnapshot;
+    restoreFromSnapshot(snapshot: StreamSnapshot): void;
+};
+/**
+ * Construct a fresh `StreamState`. The ring-buffer capacity is the
+ * compiler-emitted `manifest.maxLookback + 1` per PLAN.md §6.6
+ * (caller must enforce `capacity >= 1`). All buffers start empty;
+ * the `BarView` starts with `NaN` prices, `0` time and volume, and the
+ * supplied `symbol` / `interval` constants. `taSlots` is an empty map.
+ *
+ * @since 0.1
+ * @example
+ *     // import { createStreamState } from "@invinite-org/chartlang-runtime";
+ *     // const stream = createStreamState({
+ *     //     interval: "5m",
+ *     //     capacity: 12,
+ *     //     symbol: "BTCUSD",
+ *     // });
+ *     // stream.bar.close;          // NaN
+ *     // stream.ohlcv.close.length; // 0
+ */
+export declare function createStreamState(args: {
+    interval: string;
+    capacity: number;
+    symbol: string;
+}): StreamState;
+/**
+ * Append a finalised candle to a stream — extends the OHLCV ring buffers
+ * by one bar and writes every field of the mutable `BarView` (including
+ * `time` / `open`). Used by both the main close path and secondary
+ * stream history.
+ *
+ * @since 0.5
+ * @example
+ *     // appendBarToStream(stream, rawBar);
+ */
+export declare function appendBarToStream(stream: StreamState, rawBar: Bar): void;
+/**
+ * Replace the head of every OHLCV ring buffer in a stream and write
+ * every field of the `BarView`. Used by the secondary-stream replace
+ * path — falls back to {@link appendBarToStream} for the empty-buffer
+ * case so the first secondary bar arrives correctly even when delivered
+ * as a replace.
+ *
+ * @since 0.5
+ * @example
+ *     // replaceStreamHead(stream, rawBar);
+ */
+export declare function replaceStreamHead(stream: StreamState, rawBar: Bar): void;
+/**
+ * Replace the head of the close-side OHLCV ring buffers (close, high,
+ * low, volume, derived sources) for a tick within the in-progress bar.
+ * `time` and `open` are intentionally untouched — see
+ * `packages/runtime/CLAUDE.md` "onBarTick does NOT touch time / open"
+ * invariant. Mirrors the partial `BarView` update.
+ *
+ * @since 0.5
+ * @example
+ *     // replaceTickHead(stream, tickBar);
+ */
+export declare function replaceTickHead(stream: StreamState, rawBar: Bar): void;
+/**
+ * Refresh the stream's fallback visible range to the latest `limit`
+ * bars ending at the current head.
+ *
+ * @since 0.5
+ * @example
+ *     // updateFallbackViewport(stream);
+ */
+export declare function updateFallbackViewport(stream: StreamState, limit?: number): void;
+//# sourceMappingURL=streamState.d.ts.map

package/dist/streamState.d.ts.map

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