@invinite-org/chartlang-runtime 1.0.2

package/dist/emit/hline.js

@@ -0,0 +1,59 @@
+// 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 { pushDiagnostic, pushPlot } from "./emissionsQueue.js";
+const OUTSIDE_CTX_MESSAGE = "hline called outside an active script step";
+function hlineImpl(ctx, slotId, price, opts) {
+    const style = {
+        kind: "horizontal-line",
+        lineWidth: opts.lineWidth ?? 1,
+        lineStyle: opts.lineStyle ?? "solid",
+    };
+    if (!ctx.capabilities.plots.has("horizontal-line")) {
+        pushDiagnostic(ctx.emissions, {
+            kind: "diagnostic",
+            severity: "warning",
+            code: "unsupported-plot-kind",
+            message: 'Adapter cannot render plot kind "horizontal-line".',
+            slotId,
+            bar: ctx.barIndex(),
+        });
+        return;
+    }
+    const emission = {
+        kind: "plot",
+        slotId,
+        title: opts.title ?? "",
+        style,
+        bar: ctx.barIndex(),
+        time: ctx.stream.bar.time,
+        value: Number.isFinite(price) ? price : null,
+        color: opts.color ?? null,
+        meta: {},
+        pane: "overlay",
+    };
+    pushPlot(ctx.emissions, emission);
+}
+/**
+ * Implementation signature for {@link hline}. Branches on
+ * `typeof arg1 === "string"` to dispatch the script-facing vs
+ * compiler-injected overload.
+ *
+ * @since 0.1
+ * @example
+ *     // const fn: typeof hline = hline;
+ *     // void fn;
+ */
+export function hline(arg1, arg2, arg3) {
+    if (typeof arg1 !== "string") {
+        throw new Error(OUTSIDE_CTX_MESSAGE);
+    }
+    const ctx = ACTIVE_RUNTIME_CONTEXT.current;
+    if (!ctx)
+        throw new Error(OUTSIDE_CTX_MESSAGE);
+    if (typeof arg2 !== "number") {
+        throw new Error(OUTSIDE_CTX_MESSAGE);
+    }
+    hlineImpl(ctx, arg1, arg2, arg3 ?? {});
+}
+//# sourceMappingURL=hline.js.map

package/dist/emit/hline.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hline.js","sourceRoot":"","sources":["../../src/emit/hline.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,+DAA+D;AAK/D,OAAO,EAAE,sBAAsB,EAAuB,MAAM,sBAAsB,CAAC;AACnF,OAAO,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAE/D,MAAM,mBAAmB,GAAG,4CAA4C,CAAC;AAEzE,SAAS,SAAS,CAAC,GAAmB,EAAE,MAAc,EAAE,KAAa,EAAE,IAAe;IAClF,MAAM,KAAK,GAAc;QACrB,IAAI,EAAE,iBAAiB;QACvB,SAAS,EAAE,IAAI,CAAC,SAAS,IAAI,CAAC;QAC9B,SAAS,EAAE,IAAI,CAAC,SAAS,IAAI,OAAO;KACvC,CAAC;IAEF,IAAI,CAAC,GAAG,CAAC,YAAY,CAAC,KAAK,CAAC,GAAG,CAAC,iBAAiB,CAAC,EAAE,CAAC;QACjD,cAAc,CAAC,GAAG,CAAC,SAAS,EAAE;YAC1B,IAAI,EAAE,YAAY;YAClB,QAAQ,EAAE,SAAS;YACnB,IAAI,EAAE,uBAAuB;YAC7B,OAAO,EAAE,oDAAoD;YAC7D,MAAM;YACN,GAAG,EAAE,GAAG,CAAC,QAAQ,EAAE;SACtB,CAAC,CAAC;QACH,OAAO;IACX,CAAC;IAED,MAAM,QAAQ,GAAiB;QAC3B,IAAI,EAAE,MAAM;QACZ,MAAM;QACN,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,EAAE;QACvB,KAAK;QACL,GAAG,EAAE,GAAG,CAAC,QAAQ,EAAE;QACnB,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI;QACzB,KAAK,EAAE,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI;QAC5C,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,IAAI;QACzB,IAAI,EAAE,EAAE;QACR,IAAI,EAAE,SAAS;KAClB,CAAC;IAEF,QAAQ,CAAC,GAAG,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;AACtC,CAAC;AA0CD;;;;;;;;;GASG;AACH,MAAM,UAAU,KAAK,CAAC,IAAqB,EAAE,IAAyB,EAAE,IAAgB;IACpF,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC3B,MAAM,IAAI,KAAK,CAAC,mBAAmB,CAAC,CAAC;IACzC,CAAC;IACD,MAAM,GAAG,GAAG,sBAAsB,CAAC,OAAO,CAAC;IAC3C,IAAI,CAAC,GAAG;QAAE,MAAM,IAAI,KAAK,CAAC,mBAAmB,CAAC,CAAC;IAC/C,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC3B,MAAM,IAAI,KAAK,CAAC,mBAAmB,CAAC,CAAC;IACzC,CAAC;IACD,SAAS,CAAC,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,IAAI,EAAE,CAAC,CAAC;AAC3C,CAAC"}

package/dist/emit/index.d.ts

@@ -0,0 +1,11 @@
+export { alert } from "./alert.js";
+export { emitAlertCondition } from "./alertConditionEmission.js";
+export { createDrawingHandle, draw, nextSubId, pushDrawing, resetSubIdCounters, } from "./draw/index.js";
+export { pushAlert, pushAlertCondition, pushDiagnostic, pushLog, pushPlot, } from "./emissionsQueue.js";
+export { hashStringStable } from "./hash.js";
+export { hline } from "./hline.js";
+export { buildRuntimeNamespace, emitLog } from "./logEmission.js";
+export { resolvePane } from "./paneResolver.js";
+export { plot } from "./plot.js";
+export { isRuntimeErrorHalt, makeRuntimeErrorHalt } from "./runtimeError.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/emit/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/emit/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AACjE,OAAO,EACH,mBAAmB,EACnB,IAAI,EACJ,SAAS,EACT,WAAW,EACX,kBAAkB,GACrB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACH,SAAS,EACT,kBAAkB,EAClB,cAAc,EACd,OAAO,EACP,QAAQ,GACX,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,qBAAqB,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClE,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/emit/index.js

@@ -0,0 +1,13 @@
+// Copyright (c) 2026 Invinite. Licensed under the MIT License.
+// See the LICENSE file in the repo root for full license text.
+export { alert } from "./alert.js";
+export { emitAlertCondition } from "./alertConditionEmission.js";
+export { createDrawingHandle, draw, nextSubId, pushDrawing, resetSubIdCounters, } from "./draw/index.js";
+export { pushAlert, pushAlertCondition, pushDiagnostic, pushLog, pushPlot, } from "./emissionsQueue.js";
+export { hashStringStable } from "./hash.js";
+export { hline } from "./hline.js";
+export { buildRuntimeNamespace, emitLog } from "./logEmission.js";
+export { resolvePane } from "./paneResolver.js";
+export { plot } from "./plot.js";
+export { isRuntimeErrorHalt, makeRuntimeErrorHalt } from "./runtimeError.js";
+//# sourceMappingURL=index.js.map

package/dist/emit/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/emit/index.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,+DAA+D;AAE/D,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AACjE,OAAO,EACH,mBAAmB,EACnB,IAAI,EACJ,SAAS,EACT,WAAW,EACX,kBAAkB,GACrB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACH,SAAS,EACT,kBAAkB,EAClB,cAAc,EACd,OAAO,EACP,QAAQ,GACX,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,qBAAqB,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClE,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/emit/logEmission.d.ts

@@ -0,0 +1,25 @@
+import type { JsonValue, LogLevel, RuntimeNamespace } from "@invinite-org/chartlang-core";
+import type { RuntimeContext } from "../runtimeContext.js";
+/**
+ * Emit one `runtime.log.*` message for the active compute step.
+ *
+ * @since 0.5
+ * @stable
+ * @example
+ *     // emitLog(ctx, "info", "ready");
+ *     const fn: typeof emitLog = emitLog;
+ *     void fn;
+ */
+export declare function emitLog(ctx: RuntimeContext, level: LogLevel, message: string, meta?: Readonly<Record<string, JsonValue>>): void;
+/**
+ * Build the script-facing runtime namespace bound to a runtime context.
+ *
+ * @since 0.5
+ * @stable
+ * @example
+ *     // const ns = buildRuntimeNamespace(ctx);
+ *     const fn: typeof buildRuntimeNamespace = buildRuntimeNamespace;
+ *     void fn;
+ */
+export declare function buildRuntimeNamespace(ctx: RuntimeContext): RuntimeNamespace;
+//# sourceMappingURL=logEmission.d.ts.map

package/dist/emit/logEmission.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logEmission.d.ts","sourceRoot":"","sources":["../../src/emit/logEmission.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAG1F,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAiE3D;;;;;;;;;GASG;AACH,wBAAgB,OAAO,CACnB,GAAG,EAAE,cAAc,EACnB,KAAK,EAAE,QAAQ,EACf,OAAO,EAAE,MAAM,EACf,IAAI,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,GAC3C,IAAI,CA2BN;AAED;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,cAAc,GAAG,gBAAgB,CAc3E"}

package/dist/emit/logEmission.js

@@ -0,0 +1,127 @@
+// Copyright (c) 2026 Invinite. Licensed under the MIT License.
+// See the LICENSE file in the repo root for full license text.
+import { pushDiagnostic, pushLog } from "./emissionsQueue.js";
+import { makeRuntimeErrorHalt } from "./runtimeError.js";
+const MAX_LOGS_PER_STEP = 1000;
+function isPlainObject(v) {
+    if (typeof v !== "object" || v === null)
+        return false;
+    const proto = Object.getPrototypeOf(v);
+    return proto === Object.prototype || proto === null;
+}
+function isJsonValue(v) {
+    if (v === null)
+        return true;
+    const t = typeof v;
+    if (t === "boolean" || t === "string")
+        return true;
+    if (t === "number")
+        return Number.isFinite(v);
+    if (Array.isArray(v))
+        return v.every(isJsonValue);
+    if (!isPlainObject(v))
+        return false;
+    for (const key of Object.keys(v)) {
+        let child;
+        try {
+            child = Reflect.get(v, key);
+        }
+        catch {
+            return false;
+        }
+        if (!isJsonValue(child))
+            return false;
+    }
+    return true;
+}
+function snapshotJsonValue(value) {
+    if (Array.isArray(value)) {
+        return Object.freeze(value.map((item) => snapshotJsonValue(item)));
+    }
+    if (isPlainObject(value)) {
+        const entries = Object.entries(value).map(([key, item]) => [
+            key,
+            snapshotJsonValue(item),
+        ]);
+        return Object.freeze(Object.fromEntries(entries));
+    }
+    return value;
+}
+function snapshotMeta(meta) {
+    return snapshotJsonValue(meta);
+}
+function diagnoseLogBudget(ctx) {
+    if (ctx.logBudgetExceededDiagnosed)
+        return;
+    ctx.logBudgetExceededDiagnosed = true;
+    pushDiagnostic(ctx.emissions, {
+        kind: "diagnostic",
+        severity: "warning",
+        code: "runtime-log-budget-exceeded",
+        message: "runtime.log.* emitted more than 1000 messages in one compute step; later logs were dropped.",
+        slotId: null,
+        bar: ctx.barIndex(),
+    });
+}
+/**
+ * Emit one `runtime.log.*` message for the active compute step.
+ *
+ * @since 0.5
+ * @stable
+ * @example
+ *     // emitLog(ctx, "info", "ready");
+ *     const fn: typeof emitLog = emitLog;
+ *     void fn;
+ */
+export function emitLog(ctx, level, message, meta) {
+    if (!ctx.capabilities.logs)
+        return;
+    if (ctx.logBudget >= MAX_LOGS_PER_STEP) {
+        diagnoseLogBudget(ctx);
+        return;
+    }
+    if (meta !== undefined && !isJsonValue(meta)) {
+        pushDiagnostic(ctx.emissions, {
+            kind: "diagnostic",
+            severity: "warning",
+            code: "malformed-log-meta",
+            message: "runtime.log.* meta must be JSON-serialisable.",
+            slotId: null,
+            bar: ctx.barIndex(),
+        });
+        return;
+    }
+    const emission = {
+        kind: "log",
+        level,
+        message,
+        ...(meta === undefined ? {} : { meta: snapshotMeta(meta) }),
+        bar: ctx.barIndex(),
+        time: ctx.stream.bar.time,
+    };
+    ctx.logBudget += 1;
+    pushLog(ctx.emissions, emission);
+}
+/**
+ * Build the script-facing runtime namespace bound to a runtime context.
+ *
+ * @since 0.5
+ * @stable
+ * @example
+ *     // const ns = buildRuntimeNamespace(ctx);
+ *     const fn: typeof buildRuntimeNamespace = buildRuntimeNamespace;
+ *     void fn;
+ */
+export function buildRuntimeNamespace(ctx) {
+    return Object.freeze({
+        log: Object.freeze({
+            info: (message, meta) => emitLog(ctx, "info", message, meta),
+            warn: (message, meta) => emitLog(ctx, "warn", message, meta),
+            error: (message, meta) => emitLog(ctx, "error", message, meta),
+        }),
+        error: (message) => {
+            throw makeRuntimeErrorHalt(message);
+        },
+    });
+}
+//# sourceMappingURL=logEmission.js.map

package/dist/emit/logEmission.js.map

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

package/dist/emit/paneResolver.d.ts

@@ -0,0 +1,19 @@
+import type { RuntimeContext } from "../runtimeContext.js";
+/**
+ * Resolve the pane requested by a `plot()` call against the Phase-1
+ * runtime contract: every non-`"overlay"` pane folds back to
+ * `"overlay"` and a `unsupported-pane` diagnostic is pushed.
+ *
+ * Phase 1's canvas2d adapter declares `subPanes: 0`; even adapters
+ * that grow `subPanes >= 1` later get the runtime fold until Phase 2
+ * lights up sub-pane routing. The two branches differ only in the
+ * diagnostic `message` — both still return `"overlay"`.
+ *
+ * @since 0.1
+ * @example
+ *     // import { resolvePane } from "@invinite-org/chartlang-runtime/emit";
+ *     // const pane = resolvePane(undefined, ctx, "demo.ts:1:1#0");
+ *     // pane === "overlay"
+ */
+export declare function resolvePane(requested: string | undefined, ctx: RuntimeContext, slotId: string): "overlay";
+//# sourceMappingURL=paneResolver.d.ts.map

package/dist/emit/paneResolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paneResolver.d.ts","sourceRoot":"","sources":["../../src/emit/paneResolver.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAG3D;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,WAAW,CACvB,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,GAAG,EAAE,cAAc,EACnB,MAAM,EAAE,MAAM,GACf,SAAS,CAuBX"}

package/dist/emit/paneResolver.js

@@ -0,0 +1,45 @@
+// Copyright (c) 2026 Invinite. Licensed under the MIT License.
+// See the LICENSE file in the repo root for full license text.
+import { pushDiagnostic } from "./emissionsQueue.js";
+/**
+ * Resolve the pane requested by a `plot()` call against the Phase-1
+ * runtime contract: every non-`"overlay"` pane folds back to
+ * `"overlay"` and a `unsupported-pane` diagnostic is pushed.
+ *
+ * Phase 1's canvas2d adapter declares `subPanes: 0`; even adapters
+ * that grow `subPanes >= 1` later get the runtime fold until Phase 2
+ * lights up sub-pane routing. The two branches differ only in the
+ * diagnostic `message` — both still return `"overlay"`.
+ *
+ * @since 0.1
+ * @example
+ *     // import { resolvePane } from "@invinite-org/chartlang-runtime/emit";
+ *     // const pane = resolvePane(undefined, ctx, "demo.ts:1:1#0");
+ *     // pane === "overlay"
+ */
+export function resolvePane(requested, ctx, slotId) {
+    const pane = requested ?? "overlay";
+    if (pane === "overlay")
+        return "overlay";
+    if (ctx.capabilities.subPanes >= 1) {
+        pushDiagnostic(ctx.emissions, {
+            kind: "diagnostic",
+            severity: "warning",
+            code: "unsupported-pane",
+            message: `Pane "${pane}" requested but Phase-1 runtime flattens to overlay.`,
+            slotId,
+            bar: ctx.barIndex(),
+        });
+        return "overlay";
+    }
+    pushDiagnostic(ctx.emissions, {
+        kind: "diagnostic",
+        severity: "warning",
+        code: "unsupported-pane",
+        message: `Adapter declares subPanes: 0; pane "${pane}" folded to overlay.`,
+        slotId,
+        bar: ctx.barIndex(),
+    });
+    return "overlay";
+}
+//# sourceMappingURL=paneResolver.js.map

package/dist/emit/paneResolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paneResolver.js","sourceRoot":"","sources":["../../src/emit/paneResolver.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,+DAA+D;AAG/D,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAErD;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,WAAW,CACvB,SAA6B,EAC7B,GAAmB,EACnB,MAAc;IAEd,MAAM,IAAI,GAAG,SAAS,IAAI,SAAS,CAAC;IACpC,IAAI,IAAI,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IACzC,IAAI,GAAG,CAAC,YAAY,CAAC,QAAQ,IAAI,CAAC,EAAE,CAAC;QACjC,cAAc,CAAC,GAAG,CAAC,SAAS,EAAE;YAC1B,IAAI,EAAE,YAAY;YAClB,QAAQ,EAAE,SAAS;YACnB,IAAI,EAAE,kBAAkB;YACxB,OAAO,EAAE,SAAS,IAAI,sDAAsD;YAC5E,MAAM;YACN,GAAG,EAAE,GAAG,CAAC,QAAQ,EAAE;SACtB,CAAC,CAAC;QACH,OAAO,SAAS,CAAC;IACrB,CAAC;IACD,cAAc,CAAC,GAAG,CAAC,SAAS,EAAE;QAC1B,IAAI,EAAE,YAAY;QAClB,QAAQ,EAAE,SAAS;QACnB,IAAI,EAAE,kBAAkB;QACxB,OAAO,EAAE,uCAAuC,IAAI,sBAAsB;QAC1E,MAAM;QACN,GAAG,EAAE,GAAG,CAAC,QAAQ,EAAE;KACtB,CAAC,CAAC;IACH,OAAO,SAAS,CAAC;AACrB,CAAC"}

package/dist/emit/plot.d.ts

@@ -0,0 +1,45 @@
+import type { PlotOpts, Series } from "@invinite-org/chartlang-core";
+/**
+ * Emit a plot line for the current bar (script-facing overload).
+ *
+ * The runtime export is dual-signature: scripts call `plot(value, opts?)`
+ * (the surface declared on `@invinite-org/chartlang-core`'s
+ * `ComputeContext`), and Task 2's compiler transformer rewrites every
+ * callsite to inject the compiler-issued slot id as the leading
+ * argument — see the sibling `plot(slotId, value, opts?)` overload.
+ * A direct invocation without a slot id (i.e. outside a compiled
+ * bundle) throws the sentinel error.
+ *
+ * Plot kind is always `"line"` in Phase 1; `"horizontal-line"` ships
+ * via the sibling {@link hline} primitive. Phase 2+ extends the `kind`
+ * variants additively.
+ *
+ * @since 0.1
+ * @example
+ *     import { defineIndicator, ta, plot } from "@invinite-org/chartlang-core";
+ *     export default defineIndicator({
+ *         name: "EMA(20)",
+ *         apiVersion: 1,
+ *         compute({ bar, ta, plot }) {
+ *             plot(ta.ema(bar.close, 20), { color: "#26a69a", title: "EMA" });
+ *         },
+ *     });
+ */
+export declare function plot(value: number | Series<number>, opts?: PlotOpts): void;
+/**
+ * Emit a plot line for the current bar (compiler-injected overload).
+ *
+ * Task 2's callsite-id transformer rewrites every script-side
+ * `plot(value, opts?)` into `plot(slotId, value, opts?)`. The runtime
+ * branches on `typeof arg1 === "string"` so the compiler-emitted
+ * bundle dispatches here directly.
+ *
+ * @since 0.1
+ * @example
+ *     // Internal — the compiler rewrites every script callsite, e.g.
+ *     // `plot(close)` becomes `plot("demo.chart.ts:5:13#0", close)`.
+ *     // const fn: typeof plot = plot;
+ *     // void fn;
+ */
+export declare function plot(slotId: string, value: number | Series<number>, opts?: PlotOpts): void;
+//# sourceMappingURL=plot.d.ts.map

package/dist/emit/plot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plot.d.ts","sourceRoot":"","sources":["../../src/emit/plot.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,8BAA8B,CAAC;AAwHrE;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,EAAE,QAAQ,GAAG,IAAI,CAAC;AAC5E;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,EAAE,QAAQ,GAAG,IAAI,CAAC"}

package/dist/emit/plot.js

@@ -0,0 +1,126 @@
+// 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 { pushDiagnostic, pushPlot } from "./emissionsQueue.js";
+import { resolvePane } from "./paneResolver.js";
+const OUTSIDE_CTX_MESSAGE = "plot called outside an active script step";
+function isSeriesNumber(v) {
+    return typeof v === "object" && v !== null && "current" in v;
+}
+function isNumberOrSeries(v) {
+    return typeof v === "number" || isSeriesNumber(v);
+}
+function resolveValue(value) {
+    const resolved = typeof value === "number" ? value : value.current;
+    return Number.isFinite(resolved) ? resolved : null;
+}
+function buildStyle(opts) {
+    const style = opts.style;
+    if (style === undefined) {
+        return {
+            kind: "line",
+            lineWidth: opts.lineWidth ?? 1,
+            lineStyle: opts.lineStyle ?? "solid",
+        };
+    }
+    switch (style.kind) {
+        case "histogram":
+            return { kind: "histogram", baseline: style.baseline ?? 0 };
+        case "marker":
+            return { kind: "marker", shape: style.shape, size: style.size };
+        case "shape":
+            return {
+                kind: "shape",
+                shape: style.shape,
+                size: style.size,
+                ...(style.location === undefined ? {} : { location: style.location }),
+            };
+        case "character":
+            return {
+                kind: "character",
+                char: style.char,
+                size: style.size,
+                ...(style.location === undefined ? {} : { location: style.location }),
+            };
+        case "arrow":
+            return { kind: "arrow", direction: style.direction, size: style.size };
+        case "candle-override":
+            return {
+                kind: "candle-override",
+                bull: style.bull,
+                bear: style.bear,
+                ...(style.doji === undefined ? {} : { doji: style.doji }),
+            };
+        case "bar-override":
+            return { kind: "bar-override", color: style.color };
+        case "bg-color":
+            return {
+                kind: "bg-color",
+                color: style.color,
+                ...(style.transp === undefined ? {} : { transp: style.transp }),
+            };
+        case "bar-color":
+            return { kind: "bar-color", color: style.color };
+        case "horizontal-histogram":
+            return { kind: "horizontal-histogram", buckets: style.buckets };
+        case "line":
+        case "step-line":
+        case "horizontal-line":
+            return {
+                kind: style.kind,
+                lineWidth: opts.lineWidth ?? 1,
+                lineStyle: opts.lineStyle ?? "solid",
+            };
+    }
+}
+function plotImpl(ctx, slotId, value, opts) {
+    const style = buildStyle(opts);
+    if (!ctx.capabilities.plots.has(style.kind)) {
+        pushDiagnostic(ctx.emissions, {
+            kind: "diagnostic",
+            severity: "warning",
+            code: "unsupported-plot-kind",
+            message: `Adapter cannot render plot kind "${style.kind}".`,
+            slotId,
+            bar: ctx.barIndex(),
+        });
+        return;
+    }
+    const pane = resolvePane(opts.pane, ctx, slotId);
+    const emission = {
+        kind: "plot",
+        slotId,
+        title: opts.title ?? "",
+        style,
+        bar: ctx.barIndex(),
+        time: ctx.stream.bar.time,
+        value: resolveValue(value),
+        color: opts.color ?? null,
+        meta: {},
+        pane,
+    };
+    pushPlot(ctx.emissions, emission);
+}
+/**
+ * Implementation signature for {@link plot}. Branches on
+ * `typeof arg1 === "string"` to dispatch the script-facing vs
+ * compiler-injected overload.
+ *
+ * @since 0.1
+ * @example
+ *     // const fn: typeof plot = plot;
+ *     // void fn;
+ */
+export function plot(arg1, arg2, arg3) {
+    if (typeof arg1 !== "string") {
+        throw new Error(OUTSIDE_CTX_MESSAGE);
+    }
+    const ctx = ACTIVE_RUNTIME_CONTEXT.current;
+    if (!ctx)
+        throw new Error(OUTSIDE_CTX_MESSAGE);
+    if (!isNumberOrSeries(arg2)) {
+        throw new Error(OUTSIDE_CTX_MESSAGE);
+    }
+    plotImpl(ctx, arg1, arg2, arg3 ?? {});
+}
+//# sourceMappingURL=plot.js.map

package/dist/emit/plot.js.map

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

package/dist/emit/runtimeError.d.ts

@@ -0,0 +1,27 @@
+declare const RUNTIME_ERROR_SENTINEL: unique symbol;
+type RuntimeErrorHalt = Readonly<{
+    sentinel: typeof RUNTIME_ERROR_SENTINEL;
+    message: string;
+}>;
+/**
+ * Create the private sentinel thrown by `runtime.error(...)`.
+ *
+ * @since 0.5
+ * @stable
+ * @example
+ *     const halt = makeRuntimeErrorHalt("invariant");
+ *     void halt;
+ */
+export declare function makeRuntimeErrorHalt(message: string): RuntimeErrorHalt;
+/**
+ * Identify the private `runtime.error(...)` halt sentinel.
+ *
+ * @since 0.5
+ * @stable
+ * @example
+ *     const hit = isRuntimeErrorHalt(makeRuntimeErrorHalt("x"));
+ *     void hit;
+ */
+export declare function isRuntimeErrorHalt(err: unknown): err is RuntimeErrorHalt;
+export {};
+//# sourceMappingURL=runtimeError.d.ts.map

package/dist/emit/runtimeError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtimeError.d.ts","sourceRoot":"","sources":["../../src/emit/runtimeError.ts"],"names":[],"mappings":"AAGA,QAAA,MAAM,sBAAsB,eAA+B,CAAC;AAE5D,KAAK,gBAAgB,GAAG,QAAQ,CAAC;IAC7B,QAAQ,EAAE,OAAO,sBAAsB,CAAC;IACxC,OAAO,EAAE,MAAM,CAAC;CACnB,CAAC,CAAC;AAEH;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,gBAAgB,CAEtE;AAED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,gBAAgB,CASxE"}

package/dist/emit/runtimeError.js

@@ -0,0 +1,33 @@
+// Copyright (c) 2026 Invinite. Licensed under the MIT License.
+// See the LICENSE file in the repo root for full license text.
+const RUNTIME_ERROR_SENTINEL = Symbol("runtime-error-halt");
+/**
+ * Create the private sentinel thrown by `runtime.error(...)`.
+ *
+ * @since 0.5
+ * @stable
+ * @example
+ *     const halt = makeRuntimeErrorHalt("invariant");
+ *     void halt;
+ */
+export function makeRuntimeErrorHalt(message) {
+    return Object.freeze({ sentinel: RUNTIME_ERROR_SENTINEL, message });
+}
+/**
+ * Identify the private `runtime.error(...)` halt sentinel.
+ *
+ * @since 0.5
+ * @stable
+ * @example
+ *     const hit = isRuntimeErrorHalt(makeRuntimeErrorHalt("x"));
+ *     void hit;
+ */
+export function isRuntimeErrorHalt(err) {
+    return (typeof err === "object" &&
+        err !== null &&
+        "sentinel" in err &&
+        err.sentinel === RUNTIME_ERROR_SENTINEL &&
+        "message" in err &&
+        typeof err.message === "string");
+}
+//# sourceMappingURL=runtimeError.js.map

package/dist/emit/runtimeError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtimeError.js","sourceRoot":"","sources":["../../src/emit/runtimeError.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,+DAA+D;AAE/D,MAAM,sBAAsB,GAAG,MAAM,CAAC,oBAAoB,CAAC,CAAC;AAO5D;;;;;;;;GAQG;AACH,MAAM,UAAU,oBAAoB,CAAC,OAAe;IAChD,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,sBAAsB,EAAE,OAAO,EAAE,CAAC,CAAC;AACxE,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,kBAAkB,CAAC,GAAY;IAC3C,OAAO,CACH,OAAO,GAAG,KAAK,QAAQ;QACvB,GAAG,KAAK,IAAI;QACZ,UAAU,IAAI,GAAG;QAChB,GAAuC,CAAC,QAAQ,KAAK,sBAAsB;QAC5E,SAAS,IAAI,GAAG;QAChB,OAAQ,GAAsC,CAAC,OAAO,KAAK,QAAQ,CACtE,CAAC;AACN,CAAC"}

package/dist/execution/dispose.d.ts

@@ -0,0 +1,23 @@
+import type { RunnerState } from "../createScriptRunner.js";
+/**
+ * Tear down the runner's buffers and state. After `dispose`:
+ *
+ * - Every OHLCV ring buffer's `length` is 0 (via `RingBufferLike.reset`).
+ * - The `taSlots` map is empty (Task 7 primitives lose their hidden
+ *   state).
+ * - Runtime `state.*` slots are flushed into `StateStore`, then the
+ *   runner-local slot map is cleared. The backing `StateStore` remains
+ *   host-owned so warm restart can restore the snapshot.
+ * - The four emission arrays are reset to empty (`drain()` after
+ *   `dispose` returns empty arrays).
+ *
+ * `state.barIndex` is NOT reset — `dispose` is one-shot. Re-use after
+ * `dispose` is not supported and not tested.
+ *
+ * @since 0.1
+ * @example
+ *     // import { dispose } from "@invinite-org/chartlang-runtime";
+ *     // dispose(state);
+ */
+export declare function dispose(state: RunnerState): void;
+//# sourceMappingURL=dispose.d.ts.map

package/dist/execution/dispose.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispose.d.ts","sourceRoot":"","sources":["../../src/execution/dispose.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAG5D;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI,CAgChD"}