@invinite-org/chartlang-runtime 1.0.2 → 1.1.1

package/dist/dep/DepOutputStore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DepOutputStore.js","sourceRoot":"","sources":["../../src/dep/DepOutputStore.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,+DAA+D;AAI/D,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAsElD,MAAM,aAAa,GAAG,GAAG,CAAC;AAE1B,SAAS,QAAQ,CAAC,UAAkB,EAAE,KAAa;IAC/C,OAAO,GAAG,UAAU,GAAG,aAAa,GAAG,KAAK,EAAE,CAAC;AACnD,CAAC;AAOD;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,oBAAoB,CAAC,IAGpC;IACG,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC5C,MAAM,OAAO,GAAG,IAAI,GAAG,EAAsB,CAAC;IAC9C,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;QACpC,KAAK,MAAM,MAAM,IAAI,QAAQ,CAAC,OAAO,EAAE,CAAC;YACpC,MAAM,GAAG,GAAG,QAAQ,CAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;YACxD,IAAI,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC;gBAAE,SAAS;YAC/B,MAAM,MAAM,GAAG,IAAI,iBAAiB,CAAC,QAAQ,CAAC,CAAC;YAC/C,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,cAAc,CAAS,MAAM,CAAC,EAAE,CAAC,CAAC;QACvE,CAAC;IACL,CAAC;IAED,SAAS,MAAM,CAAC,UAAkB,EAAE,KAAa;QAC7C,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC,CAAC;QACvD,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACtB,MAAM,IAAI,KAAK,CAAC,eAAe,UAAU,IAAI,KAAK,mBAAmB,CAAC,CAAC;QAC3E,CAAC;QACD,OAAO,KAAK,CAAC;IACjB,CAAC;IAED,OAAO,MAAM,CAAC,MAAM,CAAC;QACjB,IAAI,CAAC,UAAU,EAAE,KAAK,EAAE,KAAK;YACzB,MAAM,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACnD,CAAC;QACD,IAAI,CAAC,UAAU,EAAE,KAAK;YAClB,OAAO,MAAM,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC,IAAI,CAAC;QAC1C,CAAC;QACD,QAAQ;YACJ,+DAA+D;QACnE,CAAC;QACD,OAAO;YACH,KAAK,MAAM,KAAK,IAAI,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;gBACnC,KAAK,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;YACzB,CAAC;YACD,OAAO,CAAC,KAAK,EAAE,CAAC;QACpB,CAAC;KACJ,CAAC,CAAC;AACP,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 { Series } from \"@invinite-org/chartlang-core\";\n\nimport { Float64RingBuffer } from \"../ringBuffer.js\";\nimport { makeSeriesView } from \"../seriesView.js\";\n\n/**\n * One producer's contribution to a {@link DepOutputStore}. `producerId`\n * is the dep's `localId` (private dep) or the sibling's `exportName`\n * (drawn export). `outputs` mirrors the producer manifest's titled\n * `plot(value, { title })` declarations.\n *\n * @since 0.7\n * @stable\n * @example\n *     const decl: DepOutputDeclaration = {\n *         producerId: \"fastTrend\",\n *         outputs: [{ title: \"line\" }],\n *     };\n *     void decl;\n */\nexport type DepOutputDeclaration = Readonly<{\n    readonly producerId: string;\n    readonly outputs: ReadonlyArray<{ readonly title: string }>;\n}>;\n\n/**\n * Per-bar titled-output buffer shared by the primary script and every\n * sibling drawn export within a `CompiledScriptBundle`. Each\n * `(producerId, title)` pair owns a `Float64RingBuffer`; the runtime\n * appends to it once per bar via {@link applyDepEmissionPolicy}, and\n * consumers read it through `__chartlang_depOutput`.\n *\n * The store pre-allocates a buffer for every declared output of every\n * dep + sibling at mount time. Buffer capacity is sized for the\n * consumer's `manifest.maxLookback + 1`, so `series[n]` lookback works\n * up to the script's declared horizon.\n *\n * @since 0.7\n * @stable\n * @example\n *     // import { createDepOutputStore } from \"@invinite-org/chartlang-runtime\";\n *     // const store = createDepOutputStore({\n *     //     producers: [{ producerId: \"fast\", outputs: [{ title: \"line\" }] }],\n *     //     capacity: 32,\n *     // });\n */\nexport type DepOutputStore = Readonly<{\n    /**\n     * Append `value` to the producer's titled buffer for the current\n     * bar. Throws when `(producerId, title)` is not declared. Called by\n     * {@link applyDepEmissionPolicy} after each dep/sibling's compute.\n     */\n    push(producerId: string, title: string, value: number): void;\n    /**\n     * Return the producer's stable `Series<number>` view for `title`.\n     * Throws when `(producerId, title)` is not declared. Called by the\n     * compiler-emitted `__chartlang_depOutput` helper during the\n     * consumer's compute.\n     */\n    read(producerId: string, title: string): Series<number>;\n    /**\n     * Called by the executor before any dep/sibling/primary compute on\n     * a new bar. Reserved for per-bar reset state; the current\n     * implementation has no per-bar bookkeeping but the hook stays\n     * stable so Task 5 can extend it.\n     */\n    beginBar(): void;\n    /**\n     * Drop every entry. Called by `dispose`.\n     */\n    dispose(): void;\n}>;\n\nconst ENTRY_KEY_SEP = \"\u0000\";\n\nfunction entryKey(producerId: string, title: string): string {\n    return `${producerId}${ENTRY_KEY_SEP}${title}`;\n}\n\ntype StoreEntry = Readonly<{\n    readonly buffer: Float64RingBuffer;\n    readonly view: Series<number>;\n}>;\n\n/**\n * Construct a fresh {@link DepOutputStore}. Pre-allocates one buffer +\n * one `Series<number>` Proxy per declared `(producerId, title)`. The\n * proxy identity is stable for the store's lifetime so a\n * `const fast = baseTrend.output(\"line\")` at the top of the consumer's\n * compute keeps seeing the live values.\n *\n * @since 0.7\n * @stable\n * @example\n *     // const store = createDepOutputStore({\n *     //     producers: [{ producerId: \"fast\", outputs: [{ title: \"line\" }] }],\n *     //     capacity: 100,\n *     // });\n *     // store.beginBar();\n *     // store.push(\"fast\", \"line\", 42);\n *     // store.read(\"fast\", \"line\").current; // 42\n */\nexport function createDepOutputStore(args: {\n    readonly producers: ReadonlyArray<DepOutputDeclaration>;\n    readonly capacity: number;\n}): DepOutputStore {\n    const capacity = Math.max(1, args.capacity);\n    const entries = new Map<string, StoreEntry>();\n    for (const producer of args.producers) {\n        for (const output of producer.outputs) {\n            const key = entryKey(producer.producerId, output.title);\n            if (entries.has(key)) continue;\n            const buffer = new Float64RingBuffer(capacity);\n            entries.set(key, { buffer, view: makeSeriesView<number>(buffer) });\n        }\n    }\n\n    function lookup(producerId: string, title: string): StoreEntry {\n        const entry = entries.get(entryKey(producerId, title));\n        if (entry === undefined) {\n            throw new Error(`dep output \"${producerId}.${title}\" is not declared`);\n        }\n        return entry;\n    }\n\n    return Object.freeze({\n        push(producerId, title, value): void {\n            lookup(producerId, title).buffer.append(value);\n        },\n        read(producerId, title): Series<number> {\n            return lookup(producerId, title).view;\n        },\n        beginBar(): void {\n            // Reserved hook — Task 5 will use it for snapshot bookkeeping.\n        },\n        dispose(): void {\n            for (const entry of entries.values()) {\n                entry.buffer.reset();\n            }\n            entries.clear();\n        },\n    });\n}\n"]}

package/dist/dep/DepRunner.d.ts

@@ -0,0 +1,146 @@
+import type { Capabilities } from "@invinite-org/chartlang-adapter-kit";
+import type { Bar, CompiledScriptObject } from "@invinite-org/chartlang-core";
+import type { RunnerState } from "../createScriptRunner.js";
+import type { StreamState } from "../streamState.js";
+import type { EventKind } from "../views/index.js";
+import type { DepOutputStore } from "./DepOutputStore.js";
+/**
+ * One mounted private dep — a `const X = defineIndicator(...)` binding
+ * that another script in the same compiled bundle references via
+ * `X.output("title")`. Owns its own `RunnerState`; shares the parent's
+ * `mainStream` + `secondaryStreams`. Plot emissions are dropped from
+ * the parent's queue and captured into the shared
+ * {@link DepOutputStore}.
+ *
+ * @since 0.7
+ * @stable
+ * @example
+ *     // const dep = createDepRunner({ compiled, localId: "fast", ... });
+ *     // await runDepStep(dep, parent, rawBar, "close", false);
+ *     const x: number = 1;
+ *     void x;
+ */
+export type DepRunner = Readonly<{
+    readonly kind: "dep";
+    readonly localId: string;
+    readonly slotIdPrefix: string;
+    readonly declaredOutputs: ReadonlyArray<string>;
+    readonly state: RunnerState;
+}>;
+/**
+ * One mounted drawn sibling — a `export const X = defineIndicator(...)`
+ * binding whose emissions ARE forwarded to the parent's queue, with
+ * slot ids prefixed by `export:<exportName>/`. Siblings can also expose
+ * outputs consumed by the primary or by other siblings.
+ *
+ * @since 0.7
+ * @stable
+ * @example
+ *     // const sib = createSiblingRunner({ compiled, exportName: "slow", ... });
+ *     // await runSiblingStep(sib, parent, rawBar, "close", false);
+ *     const x: number = 1;
+ *     void x;
+ */
+export type SiblingRunner = Readonly<{
+    readonly kind: "sibling";
+    readonly exportName: string;
+    readonly slotIdPrefix: string;
+    readonly declaredOutputs: ReadonlyArray<string>;
+    readonly state: RunnerState;
+}>;
+/**
+ * Constructor arguments for {@link createDepRunner} /
+ * {@link createSiblingRunner}.
+ *
+ * `mainStream` + `secondaryStreams` are SHARED with the parent runner
+ * (same OHLCV history); `depOutputStore` is also shared so every
+ * sibling + dep + primary read from the same store. `inputOverrides`
+ * is the merged effective-inputs record the compiler attached to the
+ * dep's `DependencyDeclaration`.
+ *
+ * @since 0.7
+ * @stable
+ * @example
+ *     // const args: CreateDepRunnerArgs = {
+ *     //     compiled, localId: "x",
+ *     //     parentCapabilities, mainStream, secondaryStreams,
+ *     //     depOutputStore, inputOverrides: {}, now: Date.now,
+ *     // };
+ *     const x: number = 1;
+ *     void x;
+ */
+export type CreateDepRunnerArgs = Readonly<{
+    readonly compiled: CompiledScriptObject;
+    readonly parentCapabilities: Capabilities;
+    readonly mainStream: StreamState;
+    readonly secondaryStreams: Map<string, StreamState>;
+    readonly depOutputStore: DepOutputStore;
+    readonly inputOverrides: Readonly<Record<string, unknown>>;
+    readonly now: () => number;
+}>;
+/**
+ * Construct a {@link DepRunner} for one private dep entry of a
+ * `CompiledScriptBundle`. The runner shares the parent's `mainStream`
+ * + `secondaryStreams`, owns a fresh `inMemoryStateStore`, and feeds
+ * its plot emissions into the shared `DepOutputStore`.
+ *
+ * @since 0.7
+ * @stable
+ * @example
+ *     // const dep = createDepRunner({ compiled, localId: "fast",
+ *     //     parentCapabilities, mainStream, secondaryStreams,
+ *     //     depOutputStore, inputOverrides: { length: 20 }, now: Date.now });
+ *     const x: number = 1;
+ *     void x;
+ */
+export declare function createDepRunner(args: CreateDepRunnerArgs & {
+    readonly localId: string;
+}): DepRunner;
+/**
+ * Construct a {@link SiblingRunner} for one drawn named-export entry of
+ * a `CompiledScriptBundle`. Shares streams + store with the parent;
+ * emissions forward to the parent with `export:<exportName>/` slot-id
+ * prefixes.
+ *
+ * @since 0.7
+ * @stable
+ * @example
+ *     // const sib = createSiblingRunner({ compiled, exportName: "slow", ... });
+ *     const x: number = 1;
+ *     void x;
+ */
+export declare function createSiblingRunner(args: CreateDepRunnerArgs & {
+    readonly exportName: string;
+}): SiblingRunner;
+/**
+ * Drive one bar of execution for a {@link DepRunner}. Runs the dep's
+ * `compute`, captures its titled-plot output into the shared
+ * `DepOutputStore` via {@link applyDepEmissionPolicy}, namespaces
+ * diagnostics with `dep:<localId>/`, and on halt sets
+ * `parentState.depErroredThisBar = true` so the parent's primary
+ * step drops its emissions for the bar (per task spec §6).
+ *
+ * @since 0.7
+ * @stable
+ * @example
+ *     // await runDepStep(dep, parent, rawBar, "close", false);
+ *     const x: number = 1;
+ *     void x;
+ */
+export declare function runDepStep(dep: DepRunner, parentState: RunnerState, rawBar: Bar, eventKind: EventKind, isTick: boolean): Promise<void>;
+/**
+ * Drive one bar of execution for a {@link SiblingRunner}. Same shape
+ * as {@link runDepStep} but the sibling's emissions are forwarded to
+ * the parent with `export:<exportName>/` slot-id prefixes, and a
+ * sibling halt does NOT clear the primary's emissions — only the
+ * sibling's own bar emissions are lost.
+ *
+ * @since 0.7
+ * @stable
+ * @example
+ *     // await runSiblingStep(sibling, parent, rawBar, "close", false);
+ *     const x: number = 1;
+ *     void x;
+ */
+export declare function runSiblingStep(sibling: SiblingRunner, parentState: RunnerState, rawBar: Bar, eventKind: EventKind, isTick: boolean): Promise<void>;
+//# sourceMappingURL=DepRunner.d.ts.map

package/dist/dep/DepRunner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DepRunner.d.ts","sourceRoot":"","sources":["../../src/dep/DepRunner.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qCAAqC,CAAC;AACxE,OAAO,KAAK,EAAE,GAAG,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AAE9E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAO5D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAO1D;;;;;;;;;;;;;;;GAeG;AACH,MAAM,MAAM,SAAS,GAAG,QAAQ,CAAC;IAC7B,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;IACrB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,eAAe,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAChD,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC;CAC/B,CAAC,CAAC;AAEH;;;;;;;;;;;;;GAaG;AACH,MAAM,MAAM,aAAa,GAAG,QAAQ,CAAC;IACjC,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,eAAe,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAChD,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC;CAC/B,CAAC,CAAC;AAEH;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,MAAM,mBAAmB,GAAG,QAAQ,CAAC;IACvC,QAAQ,CAAC,QAAQ,EAAE,oBAAoB,CAAC;IACxC,QAAQ,CAAC,kBAAkB,EAAE,YAAY,CAAC;IAC1C,QAAQ,CAAC,UAAU,EAAE,WAAW,CAAC;IACjC,QAAQ,CAAC,gBAAgB,EAAE,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IACpD,QAAQ,CAAC,cAAc,EAAE,cAAc,CAAC;IACxC,QAAQ,CAAC,cAAc,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAC3D,QAAQ,CAAC,GAAG,EAAE,MAAM,MAAM,CAAC;CAC9B,CAAC,CAAC;AA6FH;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,eAAe,CAC3B,IAAI,EAAE,mBAAmB,GAAG;IAAE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACzD,SAAS,CASX;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,mBAAmB,CAC/B,IAAI,EAAE,mBAAmB,GAAG;IAAE,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GAC5D,aAAa,CASf;AAuCD;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,UAAU,CAC5B,GAAG,EAAE,SAAS,EACd,WAAW,EAAE,WAAW,EACxB,MAAM,EAAE,GAAG,EACX,SAAS,EAAE,SAAS,EACpB,MAAM,EAAE,OAAO,GAChB,OAAO,CAAC,IAAI,CAAC,CAwBf;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,cAAc,CAChC,OAAO,EAAE,aAAa,EACtB,WAAW,EAAE,WAAW,EACxB,MAAM,EAAE,GAAG,EACX,SAAS,EAAE,SAAS,EACpB,MAAM,EAAE,OAAO,GAChB,OAAO,CAAC,IAAI,CAAC,CAyBf"}

package/dist/dep/DepRunner.js

@@ -0,0 +1,243 @@
+// Copyright (c) 2026 Invinite. Licensed under the MIT License.
+// See the LICENSE file in the repo root for full license text.
+import { pushDiagnostic } from "../emit/emissionsQueue.js";
+import { resolveDefaultPane, resolveScriptPane } from "../emit/paneResolver.js";
+import { resetBarEmissions, runComputeBody } from "../execution/runComputeStep.js";
+import { resolveInputs } from "../inputs/resolveInputs.js";
+import { inMemoryStateStore } from "../stateStore.js";
+import { createRuntimeViews } from "../views/index.js";
+import { applyDepEmissionPolicy, } from "./emissionFilter.js";
+function freshEmissions(barIndex) {
+    return {
+        plots: [],
+        drawings: [],
+        alerts: [],
+        alertConditions: [],
+        logs: [],
+        diagnostics: [],
+        fromBar: barIndex,
+        toBar: barIndex,
+    };
+}
+function buildSubRunnerState(args, slotIdPrefix, isDep) {
+    const stateStore = inMemoryStateStore();
+    const emissions = freshEmissions(0);
+    const alertConditions = new Map((args.compiled.manifest.alertConditions ?? []).map((c) => [c.id, c]));
+    const state = {
+        manifest: args.compiled.manifest,
+        compute: args.compiled.compute,
+        capabilities: args.parentCapabilities,
+        stateStore,
+        persistenceIntervalMs: Number.POSITIVE_INFINITY,
+        now: args.now,
+        mainStream: args.mainStream,
+        runtimeContext: {
+            stream: args.mainStream,
+            stateStore,
+            lastPersistTime: 0,
+            capabilities: args.parentCapabilities,
+            emissions,
+            barIndex: () => state.barIndex,
+            isTick: false,
+            drawingSlots: new Map(),
+            drawingSubIdCounters: new Map(),
+            drawingBucketCounters: {
+                lines: 0,
+                labels: 0,
+                boxes: 0,
+                polylines: 0,
+                other: 0,
+            },
+            scriptMaxDrawings: args.compiled.manifest.maxDrawings ?? null,
+            stateSlots: new Map(),
+            secondaryStreams: args.secondaryStreams,
+            requestSecurityBars: new Map(),
+            requestSecurityAlignments: new Map(),
+            requestSecurityAscendingBars: new Map(),
+            requestLowerTfViews: new Map(),
+            diagnosedRequestKeys: new Set(),
+            alertConditions,
+            diagnosedAlertConditionKeys: new Set(),
+            logBudget: 0,
+            logBudgetExceededDiagnosed: false,
+            resolvedInputs: Object.freeze({}),
+            defaultPane: resolveDefaultPane(args.compiled.manifest),
+            scriptPane: resolveScriptPane(args.compiled.manifest),
+            // Overrides target the primary script's slots only in v1;
+            // dep-output plots are not host-overridable.
+            plotOverrides: Object.freeze({}),
+            diagnosedInputKeys: new Set(),
+            views: createRuntimeViews(),
+            slotIdPrefix,
+            isDep,
+            depOutputStore: args.depOutputStore,
+        },
+        emissions,
+        depRunners: [],
+        siblingRunners: [],
+        depOutputStore: args.depOutputStore,
+        depErroredThisBar: false,
+        barIndex: 0,
+    };
+    state.runtimeContext.resolvedInputs = resolveInputs(args.compiled.manifest, args.inputOverrides, state.runtimeContext);
+    return state;
+}
+function declaredOutputTitles(compiled) {
+    return (compiled.manifest.outputs ?? []).map((o) => o.title);
+}
+/**
+ * Construct a {@link DepRunner} for one private dep entry of a
+ * `CompiledScriptBundle`. The runner shares the parent's `mainStream`
+ * + `secondaryStreams`, owns a fresh `inMemoryStateStore`, and feeds
+ * its plot emissions into the shared `DepOutputStore`.
+ *
+ * @since 0.7
+ * @stable
+ * @example
+ *     // const dep = createDepRunner({ compiled, localId: "fast",
+ *     //     parentCapabilities, mainStream, secondaryStreams,
+ *     //     depOutputStore, inputOverrides: { length: 20 }, now: Date.now });
+ *     const x: number = 1;
+ *     void x;
+ */
+export function createDepRunner(args) {
+    const slotIdPrefix = `dep:${args.localId}/`;
+    return Object.freeze({
+        kind: "dep",
+        localId: args.localId,
+        slotIdPrefix,
+        declaredOutputs: declaredOutputTitles(args.compiled),
+        state: buildSubRunnerState(args, slotIdPrefix, true),
+    });
+}
+/**
+ * Construct a {@link SiblingRunner} for one drawn named-export entry of
+ * a `CompiledScriptBundle`. Shares streams + store with the parent;
+ * emissions forward to the parent with `export:<exportName>/` slot-id
+ * prefixes.
+ *
+ * @since 0.7
+ * @stable
+ * @example
+ *     // const sib = createSiblingRunner({ compiled, exportName: "slow", ... });
+ *     const x: number = 1;
+ *     void x;
+ */
+export function createSiblingRunner(args) {
+    const slotIdPrefix = `export:${args.exportName}/`;
+    return Object.freeze({
+        kind: "sibling",
+        exportName: args.exportName,
+        slotIdPrefix,
+        declaredOutputs: declaredOutputTitles(args.compiled),
+        state: buildSubRunnerState(args, slotIdPrefix, false),
+    });
+}
+function depRunnerLike(dep) {
+    return {
+        kind: "dep",
+        localId: dep.localId,
+        slotIdPrefix: dep.slotIdPrefix,
+        declaredOutputs: dep.declaredOutputs,
+        emissions: dep.state.emissions,
+    };
+}
+function siblingRunnerLike(sib) {
+    return {
+        kind: "sibling",
+        exportName: sib.exportName,
+        slotIdPrefix: sib.slotIdPrefix,
+        declaredOutputs: sib.declaredOutputs,
+        emissions: sib.state.emissions,
+    };
+}
+async function executeSubStep(state, eventKind, isTick) {
+    resetBarEmissions(state);
+    try {
+        const outcome = await runComputeBody({ state, eventKind, isTick });
+        return outcome.kind === "halt"
+            ? { halted: true, message: outcome.message }
+            : { halted: false, message: "" };
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return { halted: true, message };
+    }
+}
+/**
+ * Drive one bar of execution for a {@link DepRunner}. Runs the dep's
+ * `compute`, captures its titled-plot output into the shared
+ * `DepOutputStore` via {@link applyDepEmissionPolicy}, namespaces
+ * diagnostics with `dep:<localId>/`, and on halt sets
+ * `parentState.depErroredThisBar = true` so the parent's primary
+ * step drops its emissions for the bar (per task spec §6).
+ *
+ * @since 0.7
+ * @stable
+ * @example
+ *     // await runDepStep(dep, parent, rawBar, "close", false);
+ *     const x: number = 1;
+ *     void x;
+ */
+export async function runDepStep(dep, parentState, rawBar, eventKind, isTick) {
+    if (parentState.depOutputStore === null) {
+        throw new Error("runDepStep called on a runner with no dep output store");
+    }
+    void rawBar;
+    const result = await executeSubStep(dep.state, eventKind, isTick);
+    if (result.halted) {
+        // Use an empty slot id so the filter's prefix call produces the
+        // runner's slotIdPrefix (`dep:<localId>/`) — preserves the
+        // distinguished slotId in the parent's diagnostic queue.
+        pushDiagnostic(dep.state.emissions, {
+            kind: "diagnostic",
+            severity: "error",
+            code: "dep-error",
+            message: result.message,
+            slotId: "",
+            bar: dep.state.barIndex,
+        });
+        parentState.depErroredThisBar = true;
+    }
+    if (!isTick) {
+        dep.state.barIndex += 1;
+    }
+    applyDepEmissionPolicy(depRunnerLike(dep), parentState.emissions, parentState.depOutputStore);
+}
+/**
+ * Drive one bar of execution for a {@link SiblingRunner}. Same shape
+ * as {@link runDepStep} but the sibling's emissions are forwarded to
+ * the parent with `export:<exportName>/` slot-id prefixes, and a
+ * sibling halt does NOT clear the primary's emissions — only the
+ * sibling's own bar emissions are lost.
+ *
+ * @since 0.7
+ * @stable
+ * @example
+ *     // await runSiblingStep(sibling, parent, rawBar, "close", false);
+ *     const x: number = 1;
+ *     void x;
+ */
+export async function runSiblingStep(sibling, parentState, rawBar, eventKind, isTick) {
+    if (parentState.depOutputStore === null) {
+        throw new Error("runSiblingStep called on a runner with no dep output store");
+    }
+    void rawBar;
+    const result = await executeSubStep(sibling.state, eventKind, isTick);
+    if (result.halted) {
+        pushDiagnostic(sibling.state.emissions, {
+            kind: "diagnostic",
+            severity: "error",
+            code: "dep-error",
+            message: result.message,
+            slotId: "",
+            bar: sibling.state.barIndex,
+        });
+        // sibling halt does NOT set parentState.depErroredThisBar.
+    }
+    if (!isTick) {
+        sibling.state.barIndex += 1;
+    }
+    applyDepEmissionPolicy(siblingRunnerLike(sibling), parentState.emissions, parentState.depOutputStore);
+}
+//# sourceMappingURL=DepRunner.js.map

package/dist/dep/DepRunner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DepRunner.js","sourceRoot":"","sources":["../../src/dep/DepRunner.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 { Capabilities } from \"@invinite-org/chartlang-adapter-kit\";\nimport type { Bar, CompiledScriptObject } from \"@invinite-org/chartlang-core\";\n\nimport type { RunnerState } from \"../createScriptRunner.js\";\nimport { pushDiagnostic } from \"../emit/emissionsQueue.js\";\nimport { resolveDefaultPane, resolveScriptPane } from \"../emit/paneResolver.js\";\nimport { resetBarEmissions, runComputeBody } from \"../execution/runComputeStep.js\";\nimport { resolveInputs } from \"../inputs/resolveInputs.js\";\nimport type { MutableRunnerEmissions } from \"../runtimeContext.js\";\nimport { inMemoryStateStore } from \"../stateStore.js\";\nimport type { StreamState } from \"../streamState.js\";\nimport { createRuntimeViews } from \"../views/index.js\";\nimport type { EventKind } from \"../views/index.js\";\nimport type { DepOutputStore } from \"./DepOutputStore.js\";\nimport {\n    type DepRunnerLike,\n    type SiblingRunnerLike,\n    applyDepEmissionPolicy,\n} from \"./emissionFilter.js\";\n\n/**\n * One mounted private dep — a `const X = defineIndicator(...)` binding\n * that another script in the same compiled bundle references via\n * `X.output(\"title\")`. Owns its own `RunnerState`; shares the parent's\n * `mainStream` + `secondaryStreams`. Plot emissions are dropped from\n * the parent's queue and captured into the shared\n * {@link DepOutputStore}.\n *\n * @since 0.7\n * @stable\n * @example\n *     // const dep = createDepRunner({ compiled, localId: \"fast\", ... });\n *     // await runDepStep(dep, parent, rawBar, \"close\", false);\n *     const x: number = 1;\n *     void x;\n */\nexport type DepRunner = Readonly<{\n    readonly kind: \"dep\";\n    readonly localId: string;\n    readonly slotIdPrefix: string;\n    readonly declaredOutputs: ReadonlyArray<string>;\n    readonly state: RunnerState;\n}>;\n\n/**\n * One mounted drawn sibling — a `export const X = defineIndicator(...)`\n * binding whose emissions ARE forwarded to the parent's queue, with\n * slot ids prefixed by `export:<exportName>/`. Siblings can also expose\n * outputs consumed by the primary or by other siblings.\n *\n * @since 0.7\n * @stable\n * @example\n *     // const sib = createSiblingRunner({ compiled, exportName: \"slow\", ... });\n *     // await runSiblingStep(sib, parent, rawBar, \"close\", false);\n *     const x: number = 1;\n *     void x;\n */\nexport type SiblingRunner = Readonly<{\n    readonly kind: \"sibling\";\n    readonly exportName: string;\n    readonly slotIdPrefix: string;\n    readonly declaredOutputs: ReadonlyArray<string>;\n    readonly state: RunnerState;\n}>;\n\n/**\n * Constructor arguments for {@link createDepRunner} /\n * {@link createSiblingRunner}.\n *\n * `mainStream` + `secondaryStreams` are SHARED with the parent runner\n * (same OHLCV history); `depOutputStore` is also shared so every\n * sibling + dep + primary read from the same store. `inputOverrides`\n * is the merged effective-inputs record the compiler attached to the\n * dep's `DependencyDeclaration`.\n *\n * @since 0.7\n * @stable\n * @example\n *     // const args: CreateDepRunnerArgs = {\n *     //     compiled, localId: \"x\",\n *     //     parentCapabilities, mainStream, secondaryStreams,\n *     //     depOutputStore, inputOverrides: {}, now: Date.now,\n *     // };\n *     const x: number = 1;\n *     void x;\n */\nexport type CreateDepRunnerArgs = Readonly<{\n    readonly compiled: CompiledScriptObject;\n    readonly parentCapabilities: Capabilities;\n    readonly mainStream: StreamState;\n    readonly secondaryStreams: Map<string, StreamState>;\n    readonly depOutputStore: DepOutputStore;\n    readonly inputOverrides: Readonly<Record<string, unknown>>;\n    readonly now: () => number;\n}>;\n\nfunction freshEmissions(barIndex: number): MutableRunnerEmissions {\n    return {\n        plots: [],\n        drawings: [],\n        alerts: [],\n        alertConditions: [],\n        logs: [],\n        diagnostics: [],\n        fromBar: barIndex,\n        toBar: barIndex,\n    };\n}\n\nfunction buildSubRunnerState(\n    args: CreateDepRunnerArgs,\n    slotIdPrefix: string,\n    isDep: boolean,\n): RunnerState {\n    const stateStore = inMemoryStateStore();\n    const emissions = freshEmissions(0);\n    const alertConditions = new Map(\n        (args.compiled.manifest.alertConditions ?? []).map((c) => [c.id, c]),\n    );\n    const state: RunnerState = {\n        manifest: args.compiled.manifest,\n        compute: args.compiled.compute,\n        capabilities: args.parentCapabilities,\n        stateStore,\n        persistenceIntervalMs: Number.POSITIVE_INFINITY,\n        now: args.now,\n        mainStream: args.mainStream,\n        runtimeContext: {\n            stream: args.mainStream,\n            stateStore,\n            lastPersistTime: 0,\n            capabilities: args.parentCapabilities,\n            emissions,\n            barIndex: () => state.barIndex,\n            isTick: false,\n            drawingSlots: new Map(),\n            drawingSubIdCounters: new Map(),\n            drawingBucketCounters: {\n                lines: 0,\n                labels: 0,\n                boxes: 0,\n                polylines: 0,\n                other: 0,\n            },\n            scriptMaxDrawings: args.compiled.manifest.maxDrawings ?? null,\n            stateSlots: new Map(),\n            secondaryStreams: args.secondaryStreams,\n            requestSecurityBars: new Map(),\n            requestSecurityAlignments: new Map(),\n            requestSecurityAscendingBars: new Map(),\n            requestLowerTfViews: new Map(),\n            diagnosedRequestKeys: new Set(),\n            alertConditions,\n            diagnosedAlertConditionKeys: new Set(),\n            logBudget: 0,\n            logBudgetExceededDiagnosed: false,\n            resolvedInputs: Object.freeze({}),\n            defaultPane: resolveDefaultPane(args.compiled.manifest),\n            scriptPane: resolveScriptPane(args.compiled.manifest),\n            // Overrides target the primary script's slots only in v1;\n            // dep-output plots are not host-overridable.\n            plotOverrides: Object.freeze({}),\n            diagnosedInputKeys: new Set(),\n            views: createRuntimeViews(),\n            slotIdPrefix,\n            isDep,\n            depOutputStore: args.depOutputStore,\n        },\n        emissions,\n        depRunners: [],\n        siblingRunners: [],\n        depOutputStore: args.depOutputStore,\n        depErroredThisBar: false,\n        barIndex: 0,\n    };\n    state.runtimeContext.resolvedInputs = resolveInputs(\n        args.compiled.manifest,\n        args.inputOverrides,\n        state.runtimeContext,\n    );\n    return state;\n}\n\nfunction declaredOutputTitles(compiled: CompiledScriptObject): ReadonlyArray<string> {\n    return (compiled.manifest.outputs ?? []).map((o) => o.title);\n}\n\n/**\n * Construct a {@link DepRunner} for one private dep entry of a\n * `CompiledScriptBundle`. The runner shares the parent's `mainStream`\n * + `secondaryStreams`, owns a fresh `inMemoryStateStore`, and feeds\n * its plot emissions into the shared `DepOutputStore`.\n *\n * @since 0.7\n * @stable\n * @example\n *     // const dep = createDepRunner({ compiled, localId: \"fast\",\n *     //     parentCapabilities, mainStream, secondaryStreams,\n *     //     depOutputStore, inputOverrides: { length: 20 }, now: Date.now });\n *     const x: number = 1;\n *     void x;\n */\nexport function createDepRunner(\n    args: CreateDepRunnerArgs & { readonly localId: string },\n): DepRunner {\n    const slotIdPrefix = `dep:${args.localId}/`;\n    return Object.freeze({\n        kind: \"dep\" as const,\n        localId: args.localId,\n        slotIdPrefix,\n        declaredOutputs: declaredOutputTitles(args.compiled),\n        state: buildSubRunnerState(args, slotIdPrefix, true),\n    });\n}\n\n/**\n * Construct a {@link SiblingRunner} for one drawn named-export entry of\n * a `CompiledScriptBundle`. Shares streams + store with the parent;\n * emissions forward to the parent with `export:<exportName>/` slot-id\n * prefixes.\n *\n * @since 0.7\n * @stable\n * @example\n *     // const sib = createSiblingRunner({ compiled, exportName: \"slow\", ... });\n *     const x: number = 1;\n *     void x;\n */\nexport function createSiblingRunner(\n    args: CreateDepRunnerArgs & { readonly exportName: string },\n): SiblingRunner {\n    const slotIdPrefix = `export:${args.exportName}/`;\n    return Object.freeze({\n        kind: \"sibling\" as const,\n        exportName: args.exportName,\n        slotIdPrefix,\n        declaredOutputs: declaredOutputTitles(args.compiled),\n        state: buildSubRunnerState(args, slotIdPrefix, false),\n    });\n}\n\nfunction depRunnerLike(dep: DepRunner): DepRunnerLike {\n    return {\n        kind: \"dep\",\n        localId: dep.localId,\n        slotIdPrefix: dep.slotIdPrefix,\n        declaredOutputs: dep.declaredOutputs,\n        emissions: dep.state.emissions,\n    };\n}\n\nfunction siblingRunnerLike(sib: SiblingRunner): SiblingRunnerLike {\n    return {\n        kind: \"sibling\",\n        exportName: sib.exportName,\n        slotIdPrefix: sib.slotIdPrefix,\n        declaredOutputs: sib.declaredOutputs,\n        emissions: sib.state.emissions,\n    };\n}\n\nasync function executeSubStep(\n    state: RunnerState,\n    eventKind: EventKind,\n    isTick: boolean,\n): Promise<{ readonly halted: boolean; readonly message: string }> {\n    resetBarEmissions(state);\n    try {\n        const outcome = await runComputeBody({ state, eventKind, isTick });\n        return outcome.kind === \"halt\"\n            ? { halted: true, message: outcome.message }\n            : { halted: false, message: \"\" };\n    } catch (err) {\n        const message = err instanceof Error ? err.message : String(err);\n        return { halted: true, message };\n    }\n}\n\n/**\n * Drive one bar of execution for a {@link DepRunner}. Runs the dep's\n * `compute`, captures its titled-plot output into the shared\n * `DepOutputStore` via {@link applyDepEmissionPolicy}, namespaces\n * diagnostics with `dep:<localId>/`, and on halt sets\n * `parentState.depErroredThisBar = true` so the parent's primary\n * step drops its emissions for the bar (per task spec §6).\n *\n * @since 0.7\n * @stable\n * @example\n *     // await runDepStep(dep, parent, rawBar, \"close\", false);\n *     const x: number = 1;\n *     void x;\n */\nexport async function runDepStep(\n    dep: DepRunner,\n    parentState: RunnerState,\n    rawBar: Bar,\n    eventKind: EventKind,\n    isTick: boolean,\n): Promise<void> {\n    if (parentState.depOutputStore === null) {\n        throw new Error(\"runDepStep called on a runner with no dep output store\");\n    }\n    void rawBar;\n    const result = await executeSubStep(dep.state, eventKind, isTick);\n    if (result.halted) {\n        // Use an empty slot id so the filter's prefix call produces the\n        // runner's slotIdPrefix (`dep:<localId>/`) — preserves the\n        // distinguished slotId in the parent's diagnostic queue.\n        pushDiagnostic(dep.state.emissions, {\n            kind: \"diagnostic\",\n            severity: \"error\",\n            code: \"dep-error\",\n            message: result.message,\n            slotId: \"\",\n            bar: dep.state.barIndex,\n        });\n        parentState.depErroredThisBar = true;\n    }\n    if (!isTick) {\n        dep.state.barIndex += 1;\n    }\n    applyDepEmissionPolicy(depRunnerLike(dep), parentState.emissions, parentState.depOutputStore);\n}\n\n/**\n * Drive one bar of execution for a {@link SiblingRunner}. Same shape\n * as {@link runDepStep} but the sibling's emissions are forwarded to\n * the parent with `export:<exportName>/` slot-id prefixes, and a\n * sibling halt does NOT clear the primary's emissions — only the\n * sibling's own bar emissions are lost.\n *\n * @since 0.7\n * @stable\n * @example\n *     // await runSiblingStep(sibling, parent, rawBar, \"close\", false);\n *     const x: number = 1;\n *     void x;\n */\nexport async function runSiblingStep(\n    sibling: SiblingRunner,\n    parentState: RunnerState,\n    rawBar: Bar,\n    eventKind: EventKind,\n    isTick: boolean,\n): Promise<void> {\n    if (parentState.depOutputStore === null) {\n        throw new Error(\"runSiblingStep called on a runner with no dep output store\");\n    }\n    void rawBar;\n    const result = await executeSubStep(sibling.state, eventKind, isTick);\n    if (result.halted) {\n        pushDiagnostic(sibling.state.emissions, {\n            kind: \"diagnostic\",\n            severity: \"error\",\n            code: \"dep-error\",\n            message: result.message,\n            slotId: \"\",\n            bar: sibling.state.barIndex,\n        });\n        // sibling halt does NOT set parentState.depErroredThisBar.\n    }\n    if (!isTick) {\n        sibling.state.barIndex += 1;\n    }\n    applyDepEmissionPolicy(\n        siblingRunnerLike(sibling),\n        parentState.emissions,\n        parentState.depOutputStore,\n    );\n}\n"]}

package/dist/dep/depOutput.d.ts

@@ -0,0 +1,50 @@
+import type { Series } from "@invinite-org/chartlang-core";
+/**
+ * The well-known property on `globalThis` the compiler-emitted bundle's
+ * inline shim looks for. Set once by {@link installDepOutputGlobal}.
+ *
+ * @since 0.7
+ * @stable
+ * @example
+ *     // import { DEP_OUTPUT_GLOBAL_KEY } from "@invinite-org/chartlang-runtime/internal";
+ *     // const fn = (globalThis as Record<string, unknown>)[DEP_OUTPUT_GLOBAL_KEY];
+ *     // void fn;
+ */
+export declare const DEP_OUTPUT_GLOBAL_KEY: "__chartlang_depOutput";
+/**
+ * Runtime helper invoked by the compiler-emitted bundle in place of
+ * every consumer-side `<binding>.output("title")` call. Tasks 2 + 3
+ * rewrite each call site to
+ * `__chartlang_depOutput(slotId, localId, title)`; the runtime returns
+ * the producer's stable `Series<number>` view from the active runner's
+ * `DepOutputStore`.
+ *
+ * The helper is exposed via the `@invinite-org/chartlang-runtime/internal`
+ * subpath only — user scripts can't import it. {@link installDepOutputGlobal}
+ * also assigns it to `globalThis.__chartlang_depOutput` so the bundle's
+ * inline shim picks it up automatically.
+ *
+ * @since 0.7
+ * @stable
+ * @example
+ *     // import { __chartlang_depOutput } from "@invinite-org/chartlang-runtime/internal";
+ *     // const line = __chartlang_depOutput("demo.chart.ts:5:13#0", "fast", "line");
+ *     // void line;
+ */
+export declare function __chartlang_depOutput(slotId: string, localId: string, title: string): Series<number>;
+/**
+ * Install {@link __chartlang_depOutput} on `globalThis` under the
+ * {@link DEP_OUTPUT_GLOBAL_KEY} property. Compiler-emitted bundles
+ * reference the global via an inline shim; the runtime calls
+ * `installDepOutputGlobal` from `createScriptRunner` when mounting a
+ * `CompiledScriptBundle`. The assignment is idempotent — subsequent
+ * calls leave the existing value untouched.
+ *
+ * @since 0.7
+ * @stable
+ * @example
+ *     // import { installDepOutputGlobal } from "@invinite-org/chartlang-runtime/internal";
+ *     // installDepOutputGlobal();
+ */
+export declare function installDepOutputGlobal(): void;
+//# sourceMappingURL=depOutput.d.ts.map

package/dist/dep/depOutput.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"depOutput.d.ts","sourceRoot":"","sources":["../../src/dep/depOutput.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,8BAA8B,CAAC;AAO3D;;;;;;;;;;GAUG;AACH,eAAO,MAAM,qBAAqB,EAAG,uBAAgC,CAAC;AAatE;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,qBAAqB,CACjC,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,GACd,MAAM,CAAC,MAAM,CAAC,CAsBhB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,sBAAsB,IAAI,IAAI,CAK7C"}

package/dist/dep/depOutput.js

@@ -0,0 +1,92 @@
+// Copyright (c) 2026 Invinite. Licensed under the MIT License.
+// See the LICENSE file in the repo root for full license text.
+import { pushDiagnostic } from "../emit/emissionsQueue.js";
+import { Float64RingBuffer } from "../ringBuffer.js";
+import { ACTIVE_RUNTIME_CONTEXT } from "../runtimeContext.js";
+import { makeSeriesView } from "../seriesView.js";
+/**
+ * The well-known property on `globalThis` the compiler-emitted bundle's
+ * inline shim looks for. Set once by {@link installDepOutputGlobal}.
+ *
+ * @since 0.7
+ * @stable
+ * @example
+ *     // import { DEP_OUTPUT_GLOBAL_KEY } from "@invinite-org/chartlang-runtime/internal";
+ *     // const fn = (globalThis as Record<string, unknown>)[DEP_OUTPUT_GLOBAL_KEY];
+ *     // void fn;
+ */
+export const DEP_OUTPUT_GLOBAL_KEY = "__chartlang_depOutput";
+const OUTSIDE_CTX_MESSAGE = "__chartlang_depOutput called outside an active script step";
+const NO_STORE_MESSAGE = "__chartlang_depOutput called on a runner with no dep output store";
+/**
+ * Sentinel `Series<number>` whose every read returns `NaN`. Returned by
+ * the helper when the consumer asks for an output that the producer
+ * never declared (compile-time error from Task 2; runtime sanity
+ * fallback). The buffer never receives a write, so all reads stay NaN.
+ */
+const NAN_SERIES = makeSeriesView(new Float64RingBuffer(1));
+/**
+ * Runtime helper invoked by the compiler-emitted bundle in place of
+ * every consumer-side `<binding>.output("title")` call. Tasks 2 + 3
+ * rewrite each call site to
+ * `__chartlang_depOutput(slotId, localId, title)`; the runtime returns
+ * the producer's stable `Series<number>` view from the active runner's
+ * `DepOutputStore`.
+ *
+ * The helper is exposed via the `@invinite-org/chartlang-runtime/internal`
+ * subpath only — user scripts can't import it. {@link installDepOutputGlobal}
+ * also assigns it to `globalThis.__chartlang_depOutput` so the bundle's
+ * inline shim picks it up automatically.
+ *
+ * @since 0.7
+ * @stable
+ * @example
+ *     // import { __chartlang_depOutput } from "@invinite-org/chartlang-runtime/internal";
+ *     // const line = __chartlang_depOutput("demo.chart.ts:5:13#0", "fast", "line");
+ *     // void line;
+ */
+export function __chartlang_depOutput(slotId, localId, title) {
+    const ctx = ACTIVE_RUNTIME_CONTEXT.current;
+    if (ctx === null) {
+        throw new Error(OUTSIDE_CTX_MESSAGE);
+    }
+    const store = ctx.depOutputStore;
+    if (store === undefined || store === null) {
+        throw new Error(NO_STORE_MESSAGE);
+    }
+    try {
+        return store.read(localId, title);
+    }
+    catch {
+        pushDiagnostic(ctx.emissions, {
+            kind: "diagnostic",
+            severity: "error",
+            code: "dep-unknown-output",
+            message: `dep "${localId}" did not declare output "${title}"`,
+            slotId,
+            bar: ctx.barIndex(),
+        });
+        return NAN_SERIES;
+    }
+}
+/**
+ * Install {@link __chartlang_depOutput} on `globalThis` under the
+ * {@link DEP_OUTPUT_GLOBAL_KEY} property. Compiler-emitted bundles
+ * reference the global via an inline shim; the runtime calls
+ * `installDepOutputGlobal` from `createScriptRunner` when mounting a
+ * `CompiledScriptBundle`. The assignment is idempotent — subsequent
+ * calls leave the existing value untouched.
+ *
+ * @since 0.7
+ * @stable
+ * @example
+ *     // import { installDepOutputGlobal } from "@invinite-org/chartlang-runtime/internal";
+ *     // installDepOutputGlobal();
+ */
+export function installDepOutputGlobal() {
+    const holder = globalThis;
+    if (holder[DEP_OUTPUT_GLOBAL_KEY] === undefined) {
+        holder[DEP_OUTPUT_GLOBAL_KEY] = __chartlang_depOutput;
+    }
+}
+//# sourceMappingURL=depOutput.js.map

package/dist/dep/depOutput.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"depOutput.js","sourceRoot":"","sources":["../../src/dep/depOutput.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,+DAA+D;AAI/D,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAElD;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,uBAAgC,CAAC;AAEtE,MAAM,mBAAmB,GAAG,4DAA4D,CAAC;AACzF,MAAM,gBAAgB,GAAG,mEAAmE,CAAC;AAE7F;;;;;GAKG;AACH,MAAM,UAAU,GAAmB,cAAc,CAAS,IAAI,iBAAiB,CAAC,CAAC,CAAC,CAAC,CAAC;AAEpF;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,qBAAqB,CACjC,MAAc,EACd,OAAe,EACf,KAAa;IAEb,MAAM,GAAG,GAAG,sBAAsB,CAAC,OAAO,CAAC;IAC3C,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CAAC,mBAAmB,CAAC,CAAC;IACzC,CAAC;IACD,MAAM,KAAK,GAAG,GAAG,CAAC,cAAc,CAAC;IACjC,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QACxC,MAAM,IAAI,KAAK,CAAC,gBAAgB,CAAC,CAAC;IACtC,CAAC;IACD,IAAI,CAAC;QACD,OAAO,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IACtC,CAAC;IAAC,MAAM,CAAC;QACL,cAAc,CAAC,GAAG,CAAC,SAAS,EAAE;YAC1B,IAAI,EAAE,YAAY;YAClB,QAAQ,EAAE,OAAO;YACjB,IAAI,EAAE,oBAAoB;YAC1B,OAAO,EAAE,QAAQ,OAAO,6BAA6B,KAAK,GAAG;YAC7D,MAAM;YACN,GAAG,EAAE,GAAG,CAAC,QAAQ,EAAE;SACtB,CAAC,CAAC;QACH,OAAO,UAAU,CAAC;IACtB,CAAC;AACL,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,sBAAsB;IAClC,MAAM,MAAM,GAAG,UAAqC,CAAC;IACrD,IAAI,MAAM,CAAC,qBAAqB,CAAC,KAAK,SAAS,EAAE,CAAC;QAC9C,MAAM,CAAC,qBAAqB,CAAC,GAAG,qBAAqB,CAAC;IAC1D,CAAC;AACL,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 { Series } from \"@invinite-org/chartlang-core\";\n\nimport { pushDiagnostic } from \"../emit/emissionsQueue.js\";\nimport { Float64RingBuffer } from \"../ringBuffer.js\";\nimport { ACTIVE_RUNTIME_CONTEXT } from \"../runtimeContext.js\";\nimport { makeSeriesView } from \"../seriesView.js\";\n\n/**\n * The well-known property on `globalThis` the compiler-emitted bundle's\n * inline shim looks for. Set once by {@link installDepOutputGlobal}.\n *\n * @since 0.7\n * @stable\n * @example\n *     // import { DEP_OUTPUT_GLOBAL_KEY } from \"@invinite-org/chartlang-runtime/internal\";\n *     // const fn = (globalThis as Record<string, unknown>)[DEP_OUTPUT_GLOBAL_KEY];\n *     // void fn;\n */\nexport const DEP_OUTPUT_GLOBAL_KEY = \"__chartlang_depOutput\" as const;\n\nconst OUTSIDE_CTX_MESSAGE = \"__chartlang_depOutput called outside an active script step\";\nconst NO_STORE_MESSAGE = \"__chartlang_depOutput called on a runner with no dep output store\";\n\n/**\n * Sentinel `Series<number>` whose every read returns `NaN`. Returned by\n * the helper when the consumer asks for an output that the producer\n * never declared (compile-time error from Task 2; runtime sanity\n * fallback). The buffer never receives a write, so all reads stay NaN.\n */\nconst NAN_SERIES: Series<number> = makeSeriesView<number>(new Float64RingBuffer(1));\n\n/**\n * Runtime helper invoked by the compiler-emitted bundle in place of\n * every consumer-side `<binding>.output(\"title\")` call. Tasks 2 + 3\n * rewrite each call site to\n * `__chartlang_depOutput(slotId, localId, title)`; the runtime returns\n * the producer's stable `Series<number>` view from the active runner's\n * `DepOutputStore`.\n *\n * The helper is exposed via the `@invinite-org/chartlang-runtime/internal`\n * subpath only — user scripts can't import it. {@link installDepOutputGlobal}\n * also assigns it to `globalThis.__chartlang_depOutput` so the bundle's\n * inline shim picks it up automatically.\n *\n * @since 0.7\n * @stable\n * @example\n *     // import { __chartlang_depOutput } from \"@invinite-org/chartlang-runtime/internal\";\n *     // const line = __chartlang_depOutput(\"demo.chart.ts:5:13#0\", \"fast\", \"line\");\n *     // void line;\n */\nexport function __chartlang_depOutput(\n    slotId: string,\n    localId: string,\n    title: string,\n): Series<number> {\n    const ctx = ACTIVE_RUNTIME_CONTEXT.current;\n    if (ctx === null) {\n        throw new Error(OUTSIDE_CTX_MESSAGE);\n    }\n    const store = ctx.depOutputStore;\n    if (store === undefined || store === null) {\n        throw new Error(NO_STORE_MESSAGE);\n    }\n    try {\n        return store.read(localId, title);\n    } catch {\n        pushDiagnostic(ctx.emissions, {\n            kind: \"diagnostic\",\n            severity: \"error\",\n            code: \"dep-unknown-output\",\n            message: `dep \"${localId}\" did not declare output \"${title}\"`,\n            slotId,\n            bar: ctx.barIndex(),\n        });\n        return NAN_SERIES;\n    }\n}\n\n/**\n * Install {@link __chartlang_depOutput} on `globalThis` under the\n * {@link DEP_OUTPUT_GLOBAL_KEY} property. Compiler-emitted bundles\n * reference the global via an inline shim; the runtime calls\n * `installDepOutputGlobal` from `createScriptRunner` when mounting a\n * `CompiledScriptBundle`. The assignment is idempotent — subsequent\n * calls leave the existing value untouched.\n *\n * @since 0.7\n * @stable\n * @example\n *     // import { installDepOutputGlobal } from \"@invinite-org/chartlang-runtime/internal\";\n *     // installDepOutputGlobal();\n */\nexport function installDepOutputGlobal(): void {\n    const holder = globalThis as Record<string, unknown>;\n    if (holder[DEP_OUTPUT_GLOBAL_KEY] === undefined) {\n        holder[DEP_OUTPUT_GLOBAL_KEY] = __chartlang_depOutput;\n    }\n}\n"]}