@invinite-org/chartlang-runtime 1.0.2

package/dist/emit/draw/pushDrawing.d.ts

@@ -0,0 +1,45 @@
+import type { DrawingEmission } from "@invinite-org/chartlang-adapter-kit";
+import type { RuntimeContext } from "../../runtimeContext.js";
+/**
+ * Push a {@link DrawingEmission} through the §10/§7.4 enforcement
+ * pipeline:
+ *
+ * 1. **Capability gate** — drop with `unsupported-drawing-kind` if
+ *    `ctx.capabilities.drawings` does not include `e.drawingKind`.
+ * 2. **Wire-shape validation** — drop with `malformed-emission`
+ *    (or `unsupported-drawing-kind` for unknown kinds) if
+ *    `validateEmission` rejects the payload. Adapter-kit ships
+ *    per-kind validators (Task 2 + per-port tasks 5–18); unknown
+ *    kinds fail at step 1 before reaching here.
+ * 3. **Bucket budget** — on `op: "create"`, drop with
+ *    `drawing-budget-exceeded` if the bucket counter has reached
+ *    its effective cap (`min(scriptMaxDrawings, adapter cap)`).
+ *    On success, increment the counter. On `op: "remove"`,
+ *    decrement (clamped at zero). `op: "update"` is free.
+ * 4. **Per-bar `(handleId, bar)` dedup** — replace any prior
+ *    in-bar emission for the same handle (last-write-wins).
+ *
+ * On any drop path, the original emission does not reach
+ * `ctx.emissions.drawings`; a diagnostic with the appropriate code
+ * lands on `ctx.emissions.diagnostics` instead.
+ *
+ * @since 0.3
+ * @stable
+ * @example
+ *     // import { pushDrawing } from "@invinite-org/chartlang-runtime";
+ *     // pushDrawing(ctx, {
+ *     //     kind: "drawing",
+ *     //     handleId: "x.chart.ts:1:1#0",
+ *     //     drawingKind: "line",
+ *     //     op: "create",
+ *     //     state: {
+ *     //         kind: "line",
+ *     //         anchors: [{ time: 0, price: 0 }, { time: 1, price: 1 }],
+ *     //         style: {},
+ *     //     },
+ *     //     bar: 0,
+ *     //     time: 0,
+ *     // });
+ */
+export declare function pushDrawing(ctx: RuntimeContext, e: DrawingEmission): void;
+//# sourceMappingURL=pushDrawing.d.ts.map

package/dist/emit/draw/pushDrawing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pushDrawing.d.ts","sourceRoot":"","sources":["../../../src/emit/draw/pushDrawing.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qCAAqC,CAAC;AAI3E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAS9D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,cAAc,EAAE,CAAC,EAAE,eAAe,GAAG,IAAI,CAwDzE"}

package/dist/emit/draw/pushDrawing.js

@@ -0,0 +1,107 @@
+// Copyright (c) 2026 Invinite. Licensed under the MIT License.
+// See the LICENSE file in the repo root for full license text.
+import { validateEmission } from "@invinite-org/chartlang-adapter-kit";
+import { bucketFor } from "@invinite-org/chartlang-core";
+import { pushDiagnostic } from "../emissionsQueue.js";
+function effectiveBudget(ctx, bucket) {
+    const adapterCap = ctx.capabilities.maxDrawingsPerScript[bucket];
+    const scriptCap = ctx.scriptMaxDrawings?.[bucket] ?? Number.POSITIVE_INFINITY;
+    return Math.min(adapterCap, scriptCap);
+}
+/**
+ * Push a {@link DrawingEmission} through the §10/§7.4 enforcement
+ * pipeline:
+ *
+ * 1. **Capability gate** — drop with `unsupported-drawing-kind` if
+ *    `ctx.capabilities.drawings` does not include `e.drawingKind`.
+ * 2. **Wire-shape validation** — drop with `malformed-emission`
+ *    (or `unsupported-drawing-kind` for unknown kinds) if
+ *    `validateEmission` rejects the payload. Adapter-kit ships
+ *    per-kind validators (Task 2 + per-port tasks 5–18); unknown
+ *    kinds fail at step 1 before reaching here.
+ * 3. **Bucket budget** — on `op: "create"`, drop with
+ *    `drawing-budget-exceeded` if the bucket counter has reached
+ *    its effective cap (`min(scriptMaxDrawings, adapter cap)`).
+ *    On success, increment the counter. On `op: "remove"`,
+ *    decrement (clamped at zero). `op: "update"` is free.
+ * 4. **Per-bar `(handleId, bar)` dedup** — replace any prior
+ *    in-bar emission for the same handle (last-write-wins).
+ *
+ * On any drop path, the original emission does not reach
+ * `ctx.emissions.drawings`; a diagnostic with the appropriate code
+ * lands on `ctx.emissions.diagnostics` instead.
+ *
+ * @since 0.3
+ * @stable
+ * @example
+ *     // import { pushDrawing } from "@invinite-org/chartlang-runtime";
+ *     // pushDrawing(ctx, {
+ *     //     kind: "drawing",
+ *     //     handleId: "x.chart.ts:1:1#0",
+ *     //     drawingKind: "line",
+ *     //     op: "create",
+ *     //     state: {
+ *     //         kind: "line",
+ *     //         anchors: [{ time: 0, price: 0 }, { time: 1, price: 1 }],
+ *     //         style: {},
+ *     //     },
+ *     //     bar: 0,
+ *     //     time: 0,
+ *     // });
+ */
+export function pushDrawing(ctx, e) {
+    if (!ctx.capabilities.drawings.has(e.drawingKind)) {
+        pushDiagnostic(ctx.emissions, {
+            kind: "diagnostic",
+            severity: "warning",
+            code: "unsupported-drawing-kind",
+            message: `Adapter cannot render drawing kind "${e.drawingKind}".`,
+            slotId: e.handleId,
+            bar: e.bar,
+        });
+        return;
+    }
+    const validation = validateEmission(e);
+    if (!validation.ok) {
+        pushDiagnostic(ctx.emissions, {
+            kind: "diagnostic",
+            severity: "warning",
+            code: validation.code,
+            message: validation.message,
+            slotId: e.handleId,
+            bar: e.bar,
+        });
+        return;
+    }
+    const bucket = bucketFor(e.drawingKind);
+    if (e.op === "create") {
+        const used = ctx.drawingBucketCounters[bucket];
+        const cap = effectiveBudget(ctx, bucket);
+        if (used >= cap) {
+            pushDiagnostic(ctx.emissions, {
+                kind: "diagnostic",
+                severity: "warning",
+                code: "drawing-budget-exceeded",
+                message: `Bucket '${bucket}' budget (${cap}) exhausted; drawing dropped.`,
+                slotId: e.handleId,
+                bar: e.bar,
+            });
+            return;
+        }
+        ctx.drawingBucketCounters[bucket] = used + 1;
+    }
+    else if (e.op === "remove") {
+        const used = ctx.drawingBucketCounters[bucket];
+        ctx.drawingBucketCounters[bucket] = Math.max(0, used - 1);
+    }
+    const drawings = ctx.emissions.drawings;
+    for (let i = drawings.length - 1; i >= 0; i -= 1) {
+        const existing = drawings[i];
+        if (existing.handleId === e.handleId && existing.bar === e.bar) {
+            drawings[i] = e;
+            return;
+        }
+    }
+    drawings.push(e);
+}
+//# sourceMappingURL=pushDrawing.js.map

package/dist/emit/draw/pushDrawing.js.map

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

package/dist/emit/draw/subIdAllocator.d.ts

@@ -0,0 +1,34 @@
+import type { RuntimeContext } from "../../runtimeContext.js";
+/**
+ * Return the next sub-id for a given compiler-injected `slotId` within
+ * the current bar, then increment the counter. The first call inside a
+ * bar yields `0`; the N-th call at the same callsite yields `N-1`.
+ *
+ * A script's `for (let i = 0; i < N; i++) draw.text(...)` loop produces
+ * N stable handles keyed `<slotId>#0` ... `<slotId>#N-1`.
+ * {@link resetSubIdCounters} clears every counter at the top of every
+ * `onBarClose` / `onBarTick`, so iteration `i` across bars at the same
+ * callsite yields the same sub-id — that's the cross-bar handle
+ * stability contract from PLAN.md §10.3.
+ *
+ * @since 0.3
+ * @stable
+ * @example
+ *     // import { nextSubId } from "@invinite-org/chartlang-runtime";
+ *     // const subId = nextSubId(ctx, "demo.chart.ts:5:13#0");
+ */
+export declare function nextSubId(ctx: RuntimeContext, slotId: string): number;
+/**
+ * Clear every sub-id counter on the context. Called by the execution
+ * loop at the top of `onBarClose` and `onBarTick` so callsite iteration
+ * order is identical across bars — handles allocated by iteration `i`
+ * in bar `N` and bar `N+1` share the same `slotId#i`.
+ *
+ * @since 0.3
+ * @stable
+ * @example
+ *     // import { resetSubIdCounters } from "@invinite-org/chartlang-runtime";
+ *     // resetSubIdCounters(ctx);
+ */
+export declare function resetSubIdCounters(ctx: RuntimeContext): void;
+//# sourceMappingURL=subIdAllocator.d.ts.map

package/dist/emit/draw/subIdAllocator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subIdAllocator.d.ts","sourceRoot":"","sources":["../../../src/emit/draw/subIdAllocator.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAE9D;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAKrE;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,cAAc,GAAG,IAAI,CAE5D"}

package/dist/emit/draw/subIdAllocator.js

@@ -0,0 +1,42 @@
+// Copyright (c) 2026 Invinite. Licensed under the MIT License.
+// See the LICENSE file in the repo root for full license text.
+/**
+ * Return the next sub-id for a given compiler-injected `slotId` within
+ * the current bar, then increment the counter. The first call inside a
+ * bar yields `0`; the N-th call at the same callsite yields `N-1`.
+ *
+ * A script's `for (let i = 0; i < N; i++) draw.text(...)` loop produces
+ * N stable handles keyed `<slotId>#0` ... `<slotId>#N-1`.
+ * {@link resetSubIdCounters} clears every counter at the top of every
+ * `onBarClose` / `onBarTick`, so iteration `i` across bars at the same
+ * callsite yields the same sub-id — that's the cross-bar handle
+ * stability contract from PLAN.md §10.3.
+ *
+ * @since 0.3
+ * @stable
+ * @example
+ *     // import { nextSubId } from "@invinite-org/chartlang-runtime";
+ *     // const subId = nextSubId(ctx, "demo.chart.ts:5:13#0");
+ */
+export function nextSubId(ctx, slotId) {
+    const counters = ctx.drawingSubIdCounters;
+    const current = counters.get(slotId) ?? 0;
+    counters.set(slotId, current + 1);
+    return current;
+}
+/**
+ * Clear every sub-id counter on the context. Called by the execution
+ * loop at the top of `onBarClose` and `onBarTick` so callsite iteration
+ * order is identical across bars — handles allocated by iteration `i`
+ * in bar `N` and bar `N+1` share the same `slotId#i`.
+ *
+ * @since 0.3
+ * @stable
+ * @example
+ *     // import { resetSubIdCounters } from "@invinite-org/chartlang-runtime";
+ *     // resetSubIdCounters(ctx);
+ */
+export function resetSubIdCounters(ctx) {
+    ctx.drawingSubIdCounters.clear();
+}
+//# sourceMappingURL=subIdAllocator.js.map

package/dist/emit/draw/subIdAllocator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"subIdAllocator.js","sourceRoot":"","sources":["../../../src/emit/draw/subIdAllocator.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,+DAA+D;AAI/D;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,SAAS,CAAC,GAAmB,EAAE,MAAc;IACzD,MAAM,QAAQ,GAAG,GAAG,CAAC,oBAAoB,CAAC;IAC1C,MAAM,OAAO,GAAG,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAC1C,QAAQ,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,GAAG,CAAC,CAAC,CAAC;IAClC,OAAO,OAAO,CAAC;AACnB,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,kBAAkB,CAAC,GAAmB;IAClD,GAAG,CAAC,oBAAoB,CAAC,KAAK,EAAE,CAAC;AACrC,CAAC"}

package/dist/emit/draw/table/table.d.ts

@@ -0,0 +1,39 @@
+import type { DrawingHandle, TableOpts } from "@invinite-org/chartlang-core";
+/**
+ * Draw a CSS-pixel viewport-anchored table. Unlike world-space
+ * drawings, `draw.table` carries no `WorldPoint` anchor; adapters
+ * resolve `position` against the visible viewport per PLAN.md §10.2.
+ *
+ * @anchors `position` — CSS viewport anchor; `cells` — 2D grid payload
+ * @anchorCount 0 (viewport anchored)
+ * @bucket other
+ * @since 0.5
+ * @stable
+ * @example
+ *     import { defineIndicator } from "@invinite-org/chartlang-core";
+ *     export default defineIndicator({
+ *         name: "draw.table demo",
+ *         apiVersion: 1,
+ *         compute({ draw }) {
+ *             draw.table({
+ *                 position: "top-right",
+ *                 cells: [[{ text: "P&L" }, { text: "+12.5%", textColor: "#16a34a" }]],
+ *             });
+ *         },
+ *     });
+ */
+export declare function table(opts: TableOpts): DrawingHandle;
+/**
+ * Compiler-injected overload — the callsite-id transformer rewrites
+ * every script-side `draw.table(opts)` into
+ * `draw.table(slotId, opts)`.
+ *
+ * @since 0.5
+ * @stable
+ * @example
+ *     // Internal — the compiler rewrites every script callsite.
+ *     // const fn: typeof table = table;
+ *     // void fn;
+ */
+export declare function table(slotId: string, opts: TableOpts): DrawingHandle;
+//# sourceMappingURL=table.d.ts.map

package/dist/emit/draw/table/table.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"table.d.ts","sourceRoot":"","sources":["../../../../src/emit/draw/table/table.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAc,MAAM,8BAA8B,CAAC;AAuBzF;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,KAAK,CAAC,IAAI,EAAE,SAAS,GAAG,aAAa,CAAC;AACtD;;;;;;;;;;;GAWG;AACH,wBAAgB,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,GAAG,aAAa,CAAC"}

package/dist/emit/draw/table/table.js

@@ -0,0 +1,39 @@
+// 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 { createDrawingHandle } from "../handle.js";
+import { nextSubId } from "../subIdAllocator.js";
+const OUTSIDE_CTX_MESSAGE = "draw.table called outside an active script step";
+function tableImpl(slotId, opts) {
+    const ctx = ACTIVE_RUNTIME_CONTEXT.current;
+    if (ctx === null)
+        throw new Error(OUTSIDE_CTX_MESSAGE);
+    const subId = nextSubId(ctx, slotId);
+    const state = {
+        kind: "table",
+        position: opts.position,
+        cells: opts.cells,
+        ...(opts.borderColor === undefined ? {} : { borderColor: opts.borderColor }),
+        ...(opts.borderWidth === undefined ? {} : { borderWidth: opts.borderWidth }),
+        ...(opts.frame === undefined ? {} : { frame: opts.frame }),
+    };
+    return createDrawingHandle(slotId, subId, "table", state);
+}
+/**
+ * Implementation signature for {@link table}. Branches on
+ * `typeof arg1 === "string"` to dispatch the script-facing vs
+ * compiler-injected overload.
+ *
+ * @since 0.5
+ * @stable
+ * @example
+ *     // const fn: typeof table = table;
+ *     // void fn;
+ */
+export function table(arg1, arg2) {
+    if (typeof arg1 !== "string" || arg2 === undefined) {
+        throw new Error(OUTSIDE_CTX_MESSAGE);
+    }
+    return tableImpl(arg1, arg2);
+}
+//# sourceMappingURL=table.js.map

package/dist/emit/draw/table/table.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"table.js","sourceRoot":"","sources":["../../../../src/emit/draw/table/table.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,+DAA+D;AAI/D,OAAO,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AACpE,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAEjD,MAAM,mBAAmB,GAAG,iDAAiD,CAAC;AAE9E,SAAS,SAAS,CAAC,MAAc,EAAE,IAAe;IAC9C,MAAM,GAAG,GAAG,sBAAsB,CAAC,OAAO,CAAC;IAC3C,IAAI,GAAG,KAAK,IAAI;QAAE,MAAM,IAAI,KAAK,CAAC,mBAAmB,CAAC,CAAC;IACvD,MAAM,KAAK,GAAG,SAAS,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IACrC,MAAM,KAAK,GAAe;QACtB,IAAI,EAAE,OAAO;QACb,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,GAAG,CAAC,IAAI,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE,CAAC;QAC5E,GAAG,CAAC,IAAI,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE,CAAC;QAC5E,GAAG,CAAC,IAAI,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC;KAC7D,CAAC;IACF,OAAO,mBAAmB,CAAC,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;AAC9D,CAAC;AAuCD;;;;;;;;;;GAUG;AACH,MAAM,UAAU,KAAK,CAAC,IAAwB,EAAE,IAAgB;IAC5D,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACjD,MAAM,IAAI,KAAK,CAAC,mBAAmB,CAAC,CAAC;IACzC,CAAC;IACD,OAAO,SAAS,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;AACjC,CAAC"}

package/dist/emit/emissionsQueue.d.ts

@@ -0,0 +1,65 @@
+import { type AlertEmission, type AlertConditionEmission, type LogEmission, type PlotEmission, type RuntimeDiagnostic } from "@invinite-org/chartlang-adapter-kit";
+import type { MutableRunnerEmissions } from "../runtimeContext.js";
+/**
+ * Push a `PlotEmission` onto the runner's mutable plot queue. The
+ * payload is first validated through Task 4's `validateEmission`; on
+ * failure a `malformed-emission` diagnostic is pushed and the plot is
+ * dropped. On success, the queue is searched backwards for a
+ * `(slotId, bar)` match — if found, the existing entry is replaced
+ * in place (last-write-wins per PLAN §7.4). Otherwise the new emission
+ * is appended.
+ *
+ * @since 0.1
+ * @example
+ *     // import { pushPlot } from "@invinite-org/chartlang-runtime/emit";
+ *     // pushPlot(queue, plotEmission);
+ */
+export declare function pushPlot(queue: MutableRunnerEmissions, e: PlotEmission): void;
+/**
+ * Push an `AlertEmission` onto the runner's mutable alert queue. Same
+ * validate-then-dedup contract as {@link pushPlot}: a `(slotId, bar)`
+ * collision replaces the existing entry; a validation failure pushes
+ * a `malformed-emission` diagnostic and drops the alert.
+ *
+ * @since 0.1
+ * @example
+ *     // import { pushAlert } from "@invinite-org/chartlang-runtime/emit";
+ *     // pushAlert(queue, alertEmission);
+ */
+export declare function pushAlert(queue: MutableRunnerEmissions, e: AlertEmission): void;
+/**
+ * Push an `AlertConditionEmission` onto the runner's mutable queue after
+ * adapter-kit validation. Unlike `alert`, alert conditions intentionally
+ * preserve both `fired: true` and `fired: false` transitions for UI state.
+ *
+ * @since 0.5
+ * @example
+ *     // import { pushAlertCondition } from "@invinite-org/chartlang-runtime/emit";
+ *     // pushAlertCondition(queue, emission);
+ */
+export declare function pushAlertCondition(queue: MutableRunnerEmissions, e: AlertConditionEmission): void;
+/**
+ * Push a `LogEmission` onto the runner's mutable queue after adapter-kit
+ * validation. Logs preserve order and are not deduped.
+ *
+ * @since 0.5
+ * @example
+ *     // import { pushLog } from "@invinite-org/chartlang-runtime/emit";
+ *     // pushLog(queue, emission);
+ */
+export declare function pushLog(queue: MutableRunnerEmissions, e: LogEmission): void;
+/**
+ * Append a `RuntimeDiagnostic` to the runner's diagnostic queue. No
+ * validation — diagnostics are the failure sink, so recursively
+ * validating them would loop. Every other emission path routes
+ * through here when something goes wrong.
+ *
+ * @since 0.1
+ * @example
+ *     // import { pushDiagnostic } from "@invinite-org/chartlang-runtime/emit";
+ *     // pushDiagnostic(queue, { kind: "diagnostic", severity: "warning",
+ *     //     code: "unsupported-plot-kind", message: "drop",
+ *     //     slotId: "x.ts:1:1#0", bar: 0 });
+ */
+export declare function pushDiagnostic(queue: MutableRunnerEmissions, d: RuntimeDiagnostic): void;
+//# sourceMappingURL=emissionsQueue.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"emissionsQueue.d.ts","sourceRoot":"","sources":["../../src/emit/emissionsQueue.ts"],"names":[],"mappings":"AAGA,OAAO,EACH,KAAK,aAAa,EAClB,KAAK,sBAAsB,EAC3B,KAAK,WAAW,EAChB,KAAK,YAAY,EACjB,KAAK,iBAAiB,EAEzB,MAAM,qCAAqC,CAAC;AAE7C,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAEnE;;;;;;;;;;;;;GAaG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,sBAAsB,EAAE,CAAC,EAAE,YAAY,GAAG,IAAI,CAqB7E;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,sBAAsB,EAAE,CAAC,EAAE,aAAa,GAAG,IAAI,CAqB/E;AAED;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,sBAAsB,EAAE,CAAC,EAAE,sBAAsB,GAAG,IAAI,CAgBjG;AAED;;;;;;;;GAQG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,sBAAsB,EAAE,CAAC,EAAE,WAAW,GAAG,IAAI,CAc3E;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,sBAAsB,EAAE,CAAC,EAAE,iBAAiB,GAAG,IAAI,CAExF"}

package/dist/emit/emissionsQueue.js

@@ -0,0 +1,140 @@
+// Copyright (c) 2026 Invinite. Licensed under the MIT License.
+// See the LICENSE file in the repo root for full license text.
+import { validateEmission, } from "@invinite-org/chartlang-adapter-kit";
+/**
+ * Push a `PlotEmission` onto the runner's mutable plot queue. The
+ * payload is first validated through Task 4's `validateEmission`; on
+ * failure a `malformed-emission` diagnostic is pushed and the plot is
+ * dropped. On success, the queue is searched backwards for a
+ * `(slotId, bar)` match — if found, the existing entry is replaced
+ * in place (last-write-wins per PLAN §7.4). Otherwise the new emission
+ * is appended.
+ *
+ * @since 0.1
+ * @example
+ *     // import { pushPlot } from "@invinite-org/chartlang-runtime/emit";
+ *     // pushPlot(queue, plotEmission);
+ */
+export function pushPlot(queue, e) {
+    const result = validateEmission(e);
+    if (!result.ok) {
+        pushDiagnostic(queue, {
+            kind: "diagnostic",
+            severity: "warning",
+            code: "malformed-emission",
+            message: result.message,
+            slotId: e.slotId,
+            bar: e.bar,
+        });
+        return;
+    }
+    for (let i = queue.plots.length - 1; i >= 0; i -= 1) {
+        const existing = queue.plots[i];
+        if (existing.slotId === e.slotId && existing.bar === e.bar) {
+            queue.plots[i] = e;
+            return;
+        }
+    }
+    queue.plots.push(e);
+}
+/**
+ * Push an `AlertEmission` onto the runner's mutable alert queue. Same
+ * validate-then-dedup contract as {@link pushPlot}: a `(slotId, bar)`
+ * collision replaces the existing entry; a validation failure pushes
+ * a `malformed-emission` diagnostic and drops the alert.
+ *
+ * @since 0.1
+ * @example
+ *     // import { pushAlert } from "@invinite-org/chartlang-runtime/emit";
+ *     // pushAlert(queue, alertEmission);
+ */
+export function pushAlert(queue, e) {
+    const result = validateEmission(e);
+    if (!result.ok) {
+        pushDiagnostic(queue, {
+            kind: "diagnostic",
+            severity: "warning",
+            code: "malformed-emission",
+            message: result.message,
+            slotId: e.slotId,
+            bar: e.bar,
+        });
+        return;
+    }
+    for (let i = queue.alerts.length - 1; i >= 0; i -= 1) {
+        const existing = queue.alerts[i];
+        if (existing.slotId === e.slotId && existing.bar === e.bar) {
+            queue.alerts[i] = e;
+            return;
+        }
+    }
+    queue.alerts.push(e);
+}
+/**
+ * Push an `AlertConditionEmission` onto the runner's mutable queue after
+ * adapter-kit validation. Unlike `alert`, alert conditions intentionally
+ * preserve both `fired: true` and `fired: false` transitions for UI state.
+ *
+ * @since 0.5
+ * @example
+ *     // import { pushAlertCondition } from "@invinite-org/chartlang-runtime/emit";
+ *     // pushAlertCondition(queue, emission);
+ */
+export function pushAlertCondition(queue, e) {
+    const result = validateEmission(e);
+    if (!result.ok) {
+        pushDiagnostic(queue, {
+            kind: "diagnostic",
+            severity: "warning",
+            code: "malformed-emission",
+            message: result.message,
+            slotId: null,
+            bar: e.bar,
+        });
+        return;
+    }
+    const target = queue.alertConditions ?? [];
+    queue.alertConditions = target;
+    target.push(e);
+}
+/**
+ * Push a `LogEmission` onto the runner's mutable queue after adapter-kit
+ * validation. Logs preserve order and are not deduped.
+ *
+ * @since 0.5
+ * @example
+ *     // import { pushLog } from "@invinite-org/chartlang-runtime/emit";
+ *     // pushLog(queue, emission);
+ */
+export function pushLog(queue, e) {
+    const result = validateEmission(e);
+    if (!result.ok) {
+        pushDiagnostic(queue, {
+            kind: "diagnostic",
+            severity: "warning",
+            code: "malformed-emission",
+            message: result.message,
+            slotId: null,
+            bar: e.bar,
+        });
+        return;
+    }
+    queue.logs.push(e);
+}
+/**
+ * Append a `RuntimeDiagnostic` to the runner's diagnostic queue. No
+ * validation — diagnostics are the failure sink, so recursively
+ * validating them would loop. Every other emission path routes
+ * through here when something goes wrong.
+ *
+ * @since 0.1
+ * @example
+ *     // import { pushDiagnostic } from "@invinite-org/chartlang-runtime/emit";
+ *     // pushDiagnostic(queue, { kind: "diagnostic", severity: "warning",
+ *     //     code: "unsupported-plot-kind", message: "drop",
+ *     //     slotId: "x.ts:1:1#0", bar: 0 });
+ */
+export function pushDiagnostic(queue, d) {
+    queue.diagnostics.push(d);
+}
+//# sourceMappingURL=emissionsQueue.js.map

package/dist/emit/emissionsQueue.js.map

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

package/dist/emit/hash.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Stable, deterministic FNV-1a 32-bit hash of a UTF-16 code-unit string.
+ * Returns the hash as a lowercase 8-character hex string. Same input
+ * yields the same output across machines, runs, and Node versions — the
+ * property `alert.dedupeKey` relies on for cross-host idempotency.
+ *
+ * @since 0.1
+ * @example
+ *     // import { hashStringStable } from "@invinite-org/chartlang-runtime/emit";
+ *     // hashStringStable("hello"); // "4f9f2cab"
+ */
+export declare function hashStringStable(s: string): string;
+//# sourceMappingURL=hash.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hash.d.ts","sourceRoot":"","sources":["../../src/emit/hash.ts"],"names":[],"mappings":"AAMA;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAOlD"}

package/dist/emit/hash.js

@@ -0,0 +1,24 @@
+// Copyright (c) 2026 Invinite. Licensed under the MIT License.
+// See the LICENSE file in the repo root for full license text.
+const FNV_OFFSET_BASIS_32 = 0x811c9dc5;
+const FNV_PRIME_32 = 0x01000193;
+/**
+ * Stable, deterministic FNV-1a 32-bit hash of a UTF-16 code-unit string.
+ * Returns the hash as a lowercase 8-character hex string. Same input
+ * yields the same output across machines, runs, and Node versions — the
+ * property `alert.dedupeKey` relies on for cross-host idempotency.
+ *
+ * @since 0.1
+ * @example
+ *     // import { hashStringStable } from "@invinite-org/chartlang-runtime/emit";
+ *     // hashStringStable("hello"); // "4f9f2cab"
+ */
+export function hashStringStable(s) {
+    let h = FNV_OFFSET_BASIS_32;
+    for (let i = 0; i < s.length; i += 1) {
+        h ^= s.charCodeAt(i);
+        h = Math.imul(h, FNV_PRIME_32);
+    }
+    return (h >>> 0).toString(16).padStart(8, "0");
+}
+//# sourceMappingURL=hash.js.map

package/dist/emit/hash.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hash.js","sourceRoot":"","sources":["../../src/emit/hash.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,+DAA+D;AAE/D,MAAM,mBAAmB,GAAG,UAAU,CAAC;AACvC,MAAM,YAAY,GAAG,UAAU,CAAC;AAEhC;;;;;;;;;;GAUG;AACH,MAAM,UAAU,gBAAgB,CAAC,CAAS;IACtC,IAAI,CAAC,GAAG,mBAAmB,CAAC;IAC5B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QACnC,CAAC,IAAI,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;QACrB,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,EAAE,YAAY,CAAC,CAAC;IACnC,CAAC;IACD,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;AACnD,CAAC"}

package/dist/emit/hline.d.ts

@@ -0,0 +1,42 @@
+import type { HLineOpts } from "@invinite-org/chartlang-core";
+/**
+ * Emit a horizontal-line plot pinned at the supplied `price`
+ * (script-facing overload).
+ *
+ * Same dual-signature contract as {@link plot}: scripts call
+ * `hline(price, opts?)`; the compiler's callsite-id transformer (Task 2)
+ * rewrites every call to `hline(slotId, price, opts?)` (the sibling
+ * overload). Direct invocation without a slot id throws the sentinel
+ * error.
+ *
+ * `hline` is fixed to `pane: "overlay"` — horizontal lines never
+ * route to a sub-pane in any phase. The `kind` discriminator is
+ * always `"horizontal-line"`; adapters that don't declare the
+ * capability drop with `unsupported-plot-kind`.
+ *
+ * @since 0.1
+ * @example
+ *     import { defineIndicator, hline } from "@invinite-org/chartlang-core";
+ *     export default defineIndicator({
+ *         name: "RSI bounds",
+ *         apiVersion: 1,
+ *         compute() {
+ *             hline(70, { color: "#ef4444", title: "Overbought" });
+ *             hline(30, { color: "#10b981", title: "Oversold" });
+ *         },
+ *     });
+ */
+export declare function hline(price: number, opts?: HLineOpts): void;
+/**
+ * Emit a horizontal-line plot for the current bar (compiler-injected
+ * overload). Task 2's transformer rewrites script-side `hline(price)`
+ * into `hline(slotId, price)`.
+ *
+ * @since 0.1
+ * @example
+ *     // Internal — the compiler rewrites every script callsite.
+ *     // const fn: typeof hline = hline;
+ *     // void fn;
+ */
+export declare function hline(slotId: string, price: number, opts?: HLineOpts): void;
+//# sourceMappingURL=hline.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hline.d.ts","sourceRoot":"","sources":["../../src/emit/hline.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AA2C9D;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,SAAS,GAAG,IAAI,CAAC;AAC7D;;;;;;;;;;GAUG;AACH,wBAAgB,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,SAAS,GAAG,IAAI,CAAC"}