@invinite-org/chartlang-runtime 1.1.1 → 1.3.0

package/dist/emit/barcolor.js

@@ -0,0 +1,40 @@
+// 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 { plotImpl } from "./plot.js";
+const OUTSIDE_CTX_MESSAGE = "barcolor called outside an active script step";
+/**
+ * Lower a `barcolor(color, opts?)` call to the `PlotOpts` a verbose
+ * `plot(NaN, { style: { kind: "bar-color", color }, title })` would carry. The
+ * static `bar-color` style still carries the color (fallback for adapters
+ * that ignore the dynamic channel); the live per-bar color is additionally
+ * routed to {@link plotImpl}'s `dynamicColor` arg so it rides the wire as
+ * `PlotEmission.colorValue`. The `bar-color` style carries no transparency, so
+ * only `title` is spread conditionally (omitted ⇒ absent on the wire).
+ */
+function barColorOpts(color, opts) {
+    return {
+        style: { kind: "bar-color", color },
+        ...(opts.title === undefined ? {} : { title: opts.title }),
+    };
+}
+/**
+ * Implementation signature for {@link barcolor}. Branches on
+ * `typeof arg1 === "string"` to dispatch the script-facing vs
+ * compiler-injected overload.
+ *
+ * @since 1.4
+ * @example
+ *     // const fn: typeof barcolor = barcolor;
+ *     // void fn;
+ */
+export function barcolor(arg1, arg2, arg3) {
+    if (typeof arg1 !== "string" || typeof arg2 !== "string") {
+        throw new Error(OUTSIDE_CTX_MESSAGE);
+    }
+    const ctx = ACTIVE_RUNTIME_CONTEXT.current;
+    if (!ctx)
+        throw new Error(OUTSIDE_CTX_MESSAGE);
+    plotImpl(ctx, arg1, Number.NaN, barColorOpts(arg2, arg3 ?? {}), arg2);
+}
+//# sourceMappingURL=barcolor.js.map

package/dist/emit/barcolor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"barcolor.js","sourceRoot":"","sources":["../../src/emit/barcolor.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,+DAA+D;AAI/D,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAErC,MAAM,mBAAmB,GAAG,+CAA+C,CAAC;AAE5E;;;;;;;;GAQG;AACH,SAAS,YAAY,CAAC,KAAY,EAAE,IAAkB;IAClD,OAAO;QACH,KAAK,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE;QACnC,GAAG,CAAC,IAAI,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC;KAC7D,CAAC;AACN,CAAC;AA4CD;;;;;;;;;GASG;AACH,MAAM,UAAU,QAAQ,CACpB,IAAoB,EACpB,IAA2B,EAC3B,IAAmB;IAEnB,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;QACvD,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,QAAQ,CAAC,GAAG,EAAE,IAAI,EAAE,MAAM,CAAC,GAAG,EAAE,YAAY,CAAC,IAAI,EAAE,IAAI,IAAI,EAAE,CAAC,EAAE,IAAI,CAAC,CAAC;AAC1E,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 { BarColorOpts, Color, PlotOpts } from \"@invinite-org/chartlang-core\";\n\nimport { ACTIVE_RUNTIME_CONTEXT } from \"../runtimeContext.js\";\nimport { plotImpl } from \"./plot.js\";\n\nconst OUTSIDE_CTX_MESSAGE = \"barcolor called outside an active script step\";\n\n/**\n * Lower a `barcolor(color, opts?)` call to the `PlotOpts` a verbose\n * `plot(NaN, { style: { kind: \"bar-color\", color }, title })` would carry. The\n * static `bar-color` style still carries the color (fallback for adapters\n * that ignore the dynamic channel); the live per-bar color is additionally\n * routed to {@link plotImpl}'s `dynamicColor` arg so it rides the wire as\n * `PlotEmission.colorValue`. The `bar-color` style carries no transparency, so\n * only `title` is spread conditionally (omitted ⇒ absent on the wire).\n */\nfunction barColorOpts(color: Color, opts: BarColorOpts): PlotOpts {\n    return {\n        style: { kind: \"bar-color\", color },\n        ...(opts.title === undefined ? {} : { title: opts.title }),\n    };\n}\n\n/**\n * Tint the candle / bar for the current bar — the runtime impl of the\n * Pine-ergonomic `barcolor` alias (script-facing overload).\n *\n * Same dual-signature contract as {@link plot}: scripts call\n * `barcolor(color, opts?)`; the compiler's callsite-id transformer rewrites\n * every call to `barcolor(slotId, color, opts?)` (the sibling overload).\n * Direct invocation without a slot id throws the sentinel error.\n *\n * `barcolor` is Pine-ergonomic sugar — it builds the `bar-color` `PlotStyle`\n * and dispatches to the shared {@link plotImpl} with `value = NaN` (→ wire\n * `value: null`). The per-bar color rides the wire as\n * `PlotEmission.colorValue` (the dynamic-color channel), so a single call\n * recolors every bar by that bar's evaluated color; the static `style.color`\n * remains the fallback. Adapters that do not declare the `bar-color`\n * capability drop it with `unsupported-plot-kind`.\n *\n * @since 1.4\n * @example\n *     import { defineIndicator, barcolor } from \"@invinite-org/chartlang-core\";\n *     export default defineIndicator({\n *         name: \"Tint\",\n *         apiVersion: 1,\n *         compute({ bar }) {\n *             barcolor(bar.close > bar.open ? \"#16a34a\" : \"#dc2626\");\n *         },\n *     });\n */\nexport function barcolor(color: Color, opts?: BarColorOpts): void;\n/**\n * Tint the candle / bar for the current bar (compiler-injected overload).\n * The callsite-id transformer rewrites script-side `barcolor(color, opts?)`\n * into `barcolor(slotId, color, opts?)`.\n *\n * @since 1.4\n * @example\n *     // Internal — the compiler rewrites every script callsite, e.g.\n *     // `barcolor(\"#000\")` becomes `barcolor(\"demo.chart.ts:5:9#0\", \"#000\")`.\n *     // const fn: typeof barcolor = barcolor;\n *     // void fn;\n */\nexport function barcolor(slotId: string, color: Color, opts?: BarColorOpts): void;\n/**\n * Implementation signature for {@link barcolor}. Branches on\n * `typeof arg1 === \"string\"` to dispatch the script-facing vs\n * compiler-injected overload.\n *\n * @since 1.4\n * @example\n *     // const fn: typeof barcolor = barcolor;\n *     // void fn;\n */\nexport function barcolor(\n    arg1: string | Color,\n    arg2?: Color | BarColorOpts,\n    arg3?: BarColorOpts,\n): void {\n    if (typeof arg1 !== \"string\" || typeof arg2 !== \"string\") {\n        throw new Error(OUTSIDE_CTX_MESSAGE);\n    }\n    const ctx = ACTIVE_RUNTIME_CONTEXT.current;\n    if (!ctx) throw new Error(OUTSIDE_CTX_MESSAGE);\n    plotImpl(ctx, arg1, Number.NaN, barColorOpts(arg2, arg3 ?? {}), arg2);\n}\n"]}

package/dist/emit/bgcolor.d.ts

@@ -0,0 +1,44 @@
+import type { BgColorOpts, Color } from "@invinite-org/chartlang-core";
+/**
+ * Paint the pane background for the current bar — the runtime impl of the
+ * Pine-ergonomic `bgcolor` alias (script-facing overload).
+ *
+ * Same dual-signature contract as {@link plot}: scripts call
+ * `bgcolor(color, opts?)`; the compiler's callsite-id transformer rewrites
+ * every call to `bgcolor(slotId, color, opts?)` (the sibling overload).
+ * Direct invocation without a slot id throws the sentinel error.
+ *
+ * `bgcolor` is Pine-ergonomic sugar — it builds the `bg-color` `PlotStyle`
+ * and dispatches to the shared {@link plotImpl} with `value = NaN` (→ wire
+ * `value: null`). The per-bar color rides the wire as
+ * `PlotEmission.colorValue` (the dynamic-color channel), so a single call
+ * recolors every bar by that bar's evaluated color; the static `style.color`
+ * remains the fallback. Adapters that do not declare the `bg-color`
+ * capability drop it with `unsupported-plot-kind`.
+ *
+ * @since 1.4
+ * @example
+ *     import { defineIndicator, bgcolor } from "@invinite-org/chartlang-core";
+ *     export default defineIndicator({
+ *         name: "Heat",
+ *         apiVersion: 1,
+ *         compute({ bar }) {
+ *             bgcolor(bar.close > bar.open ? "#16a34a" : "#dc2626", { transp: 80 });
+ *         },
+ *     });
+ */
+export declare function bgcolor(color: Color, opts?: BgColorOpts): void;
+/**
+ * Paint the pane background for the current bar (compiler-injected overload).
+ * The callsite-id transformer rewrites script-side `bgcolor(color, opts?)`
+ * into `bgcolor(slotId, color, opts?)`.
+ *
+ * @since 1.4
+ * @example
+ *     // Internal — the compiler rewrites every script callsite, e.g.
+ *     // `bgcolor("#000")` becomes `bgcolor("demo.chart.ts:5:9#0", "#000")`.
+ *     // const fn: typeof bgcolor = bgcolor;
+ *     // void fn;
+ */
+export declare function bgcolor(slotId: string, color: Color, opts?: BgColorOpts): void;
+//# sourceMappingURL=bgcolor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"bgcolor.d.ts","sourceRoot":"","sources":["../../src/emit/bgcolor.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,KAAK,EAAY,MAAM,8BAA8B,CAAC;AA4BjF;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,CAAC,EAAE,WAAW,GAAG,IAAI,CAAC;AAChE;;;;;;;;;;;GAWG;AACH,wBAAgB,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,CAAC,EAAE,WAAW,GAAG,IAAI,CAAC"}

package/dist/emit/bgcolor.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 { ACTIVE_RUNTIME_CONTEXT } from "../runtimeContext.js";
+import { plotImpl } from "./plot.js";
+const OUTSIDE_CTX_MESSAGE = "bgcolor called outside an active script step";
+/**
+ * Lower a `bgcolor(color, opts?)` call to the `PlotOpts` a verbose
+ * `plot(NaN, { style: { kind: "bg-color", color, transp }, title })` would
+ * carry. The static `bg-color` style still carries the color (fallback for
+ * adapters that ignore the dynamic channel); the live per-bar color is
+ * additionally routed to {@link plotImpl}'s `dynamicColor` arg so it rides
+ * the wire as `PlotEmission.colorValue`. `transp` / `title` are spread
+ * conditionally (omitted ⇒ absent on the wire), matching the author style arm
+ * and `exactOptionalPropertyTypes`.
+ */
+function bgColorOpts(color, opts) {
+    return {
+        style: {
+            kind: "bg-color",
+            color,
+            ...(opts.transp === undefined ? {} : { transp: opts.transp }),
+        },
+        ...(opts.title === undefined ? {} : { title: opts.title }),
+    };
+}
+/**
+ * Implementation signature for {@link bgcolor}. Branches on
+ * `typeof arg1 === "string"` to dispatch the script-facing vs
+ * compiler-injected overload.
+ *
+ * @since 1.4
+ * @example
+ *     // const fn: typeof bgcolor = bgcolor;
+ *     // void fn;
+ */
+export function bgcolor(arg1, arg2, arg3) {
+    if (typeof arg1 !== "string" || typeof arg2 !== "string") {
+        throw new Error(OUTSIDE_CTX_MESSAGE);
+    }
+    const ctx = ACTIVE_RUNTIME_CONTEXT.current;
+    if (!ctx)
+        throw new Error(OUTSIDE_CTX_MESSAGE);
+    plotImpl(ctx, arg1, Number.NaN, bgColorOpts(arg2, arg3 ?? {}), arg2);
+}
+//# sourceMappingURL=bgcolor.js.map

package/dist/emit/bgcolor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bgcolor.js","sourceRoot":"","sources":["../../src/emit/bgcolor.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,+DAA+D;AAI/D,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAErC,MAAM,mBAAmB,GAAG,8CAA8C,CAAC;AAE3E;;;;;;;;;GASG;AACH,SAAS,WAAW,CAAC,KAAY,EAAE,IAAiB;IAChD,OAAO;QACH,KAAK,EAAE;YACH,IAAI,EAAE,UAAU;YAChB,KAAK;YACL,GAAG,CAAC,IAAI,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC;SAChE;QACD,GAAG,CAAC,IAAI,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC;KAC7D,CAAC;AACN,CAAC;AA4CD;;;;;;;;;GASG;AACH,MAAM,UAAU,OAAO,CACnB,IAAoB,EACpB,IAA0B,EAC1B,IAAkB;IAElB,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;QACvD,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,QAAQ,CAAC,GAAG,EAAE,IAAI,EAAE,MAAM,CAAC,GAAG,EAAE,WAAW,CAAC,IAAI,EAAE,IAAI,IAAI,EAAE,CAAC,EAAE,IAAI,CAAC,CAAC;AACzE,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 { BgColorOpts, Color, PlotOpts } from \"@invinite-org/chartlang-core\";\n\nimport { ACTIVE_RUNTIME_CONTEXT } from \"../runtimeContext.js\";\nimport { plotImpl } from \"./plot.js\";\n\nconst OUTSIDE_CTX_MESSAGE = \"bgcolor called outside an active script step\";\n\n/**\n * Lower a `bgcolor(color, opts?)` call to the `PlotOpts` a verbose\n * `plot(NaN, { style: { kind: \"bg-color\", color, transp }, title })` would\n * carry. The static `bg-color` style still carries the color (fallback for\n * adapters that ignore the dynamic channel); the live per-bar color is\n * additionally routed to {@link plotImpl}'s `dynamicColor` arg so it rides\n * the wire as `PlotEmission.colorValue`. `transp` / `title` are spread\n * conditionally (omitted ⇒ absent on the wire), matching the author style arm\n * and `exactOptionalPropertyTypes`.\n */\nfunction bgColorOpts(color: Color, opts: BgColorOpts): PlotOpts {\n    return {\n        style: {\n            kind: \"bg-color\",\n            color,\n            ...(opts.transp === undefined ? {} : { transp: opts.transp }),\n        },\n        ...(opts.title === undefined ? {} : { title: opts.title }),\n    };\n}\n\n/**\n * Paint the pane background for the current bar — the runtime impl of the\n * Pine-ergonomic `bgcolor` alias (script-facing overload).\n *\n * Same dual-signature contract as {@link plot}: scripts call\n * `bgcolor(color, opts?)`; the compiler's callsite-id transformer rewrites\n * every call to `bgcolor(slotId, color, opts?)` (the sibling overload).\n * Direct invocation without a slot id throws the sentinel error.\n *\n * `bgcolor` is Pine-ergonomic sugar — it builds the `bg-color` `PlotStyle`\n * and dispatches to the shared {@link plotImpl} with `value = NaN` (→ wire\n * `value: null`). The per-bar color rides the wire as\n * `PlotEmission.colorValue` (the dynamic-color channel), so a single call\n * recolors every bar by that bar's evaluated color; the static `style.color`\n * remains the fallback. Adapters that do not declare the `bg-color`\n * capability drop it with `unsupported-plot-kind`.\n *\n * @since 1.4\n * @example\n *     import { defineIndicator, bgcolor } from \"@invinite-org/chartlang-core\";\n *     export default defineIndicator({\n *         name: \"Heat\",\n *         apiVersion: 1,\n *         compute({ bar }) {\n *             bgcolor(bar.close > bar.open ? \"#16a34a\" : \"#dc2626\", { transp: 80 });\n *         },\n *     });\n */\nexport function bgcolor(color: Color, opts?: BgColorOpts): void;\n/**\n * Paint the pane background for the current bar (compiler-injected overload).\n * The callsite-id transformer rewrites script-side `bgcolor(color, opts?)`\n * into `bgcolor(slotId, color, opts?)`.\n *\n * @since 1.4\n * @example\n *     // Internal — the compiler rewrites every script callsite, e.g.\n *     // `bgcolor(\"#000\")` becomes `bgcolor(\"demo.chart.ts:5:9#0\", \"#000\")`.\n *     // const fn: typeof bgcolor = bgcolor;\n *     // void fn;\n */\nexport function bgcolor(slotId: string, color: Color, opts?: BgColorOpts): void;\n/**\n * Implementation signature for {@link bgcolor}. Branches on\n * `typeof arg1 === \"string\"` to dispatch the script-facing vs\n * compiler-injected overload.\n *\n * @since 1.4\n * @example\n *     // const fn: typeof bgcolor = bgcolor;\n *     // void fn;\n */\nexport function bgcolor(\n    arg1: string | Color,\n    arg2?: Color | BgColorOpts,\n    arg3?: BgColorOpts,\n): void {\n    if (typeof arg1 !== \"string\" || typeof arg2 !== \"string\") {\n        throw new Error(OUTSIDE_CTX_MESSAGE);\n    }\n    const ctx = ACTIVE_RUNTIME_CONTEXT.current;\n    if (!ctx) throw new Error(OUTSIDE_CTX_MESSAGE);\n    plotImpl(ctx, arg1, Number.NaN, bgColorOpts(arg2, arg3 ?? {}), arg2);\n}\n"]}

package/dist/emit/draw/boxes/fillBetween.d.ts

@@ -0,0 +1,45 @@
+import type { DrawingHandle, FillBetweenStyle, WorldPoint } from "@invinite-org/chartlang-core";
+/**
+ * Fill the ribbon between two edges. The native equivalent of Pine
+ * `linefill.new(line1, line2, color)` and `fill(plot1, plot2, color)`.
+ * The filled region is the closed polygon `edgeA` forward then `edgeB`
+ * reversed; the two edges need not share x-coordinates or length.
+ *
+ * @anchors `edgeA`, `edgeB` — two `WorldPoint` lists (the band edges)
+ * @anchorCount variable — each edge needs 2..10000 finite anchors
+ * @bucket polylines
+ * @warmup none — guard warmup in-script: an edge with fewer than 2 finite
+ *   anchors (empty, single-point, or a `NaN` coordinate) is dropped with a
+ *   `malformed-emission` diagnostic, so accumulate then gate on `length >= 2`
+ *   as the example does.
+ * @since 0.4
+ * @stable
+ * @example
+ *     import { type WorldPoint, defineIndicator } from "@invinite-org/chartlang-core";
+ *     const top: WorldPoint[] = [];
+ *     const bottom: WorldPoint[] = [];
+ *     export default defineIndicator({
+ *         name: "draw.fillBetween demo",
+ *         apiVersion: 1,
+ *         compute({ bar, draw }) {
+ *             top.push({ time: bar.time, price: bar.high });
+ *             bottom.push({ time: bar.time, price: bar.low });
+ *             if (top.length >= 2) {
+ *                 draw.fillBetween(top, bottom, { fill: "#3b82f6", fillAlpha: 0.2 });
+ *             }
+ *         },
+ *     });
+ */
+export declare function fillBetween(edgeA: ReadonlyArray<WorldPoint>, edgeB: ReadonlyArray<WorldPoint>, opts?: FillBetweenStyle): DrawingHandle;
+/**
+ * Compiler-injected overload.
+ *
+ * @since 0.4
+ * @stable
+ * @example
+ *     // Internal — the compiler rewrites every script callsite.
+ *     // const fn: typeof fillBetween = fillBetween;
+ *     // void fn;
+ */
+export declare function fillBetween(slotId: string, edgeA: ReadonlyArray<WorldPoint>, edgeB: ReadonlyArray<WorldPoint>, opts?: FillBetweenStyle): DrawingHandle;
+//# sourceMappingURL=fillBetween.d.ts.map

package/dist/emit/draw/boxes/fillBetween.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fillBetween.d.ts","sourceRoot":"","sources":["../../../../src/emit/draw/boxes/fillBetween.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACR,aAAa,EAEb,gBAAgB,EAChB,UAAU,EACb,MAAM,8BAA8B,CAAC;AAqBtC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAgB,WAAW,CACvB,KAAK,EAAE,aAAa,CAAC,UAAU,CAAC,EAChC,KAAK,EAAE,aAAa,CAAC,UAAU,CAAC,EAChC,IAAI,CAAC,EAAE,gBAAgB,GACxB,aAAa,CAAC;AACjB;;;;;;;;;GASG;AACH,wBAAgB,WAAW,CACvB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,aAAa,CAAC,UAAU,CAAC,EAChC,KAAK,EAAE,aAAa,CAAC,UAAU,CAAC,EAChC,IAAI,CAAC,EAAE,gBAAgB,GACxB,aAAa,CAAC"}

package/dist/emit/draw/boxes/fillBetween.js

@@ -0,0 +1,36 @@
+// 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.fillBetween called outside an active script step";
+function fillBetweenImpl(slotId, edgeA, edgeB, opts) {
+    const ctx = ACTIVE_RUNTIME_CONTEXT.current;
+    if (ctx === null)
+        throw new Error(OUTSIDE_CTX_MESSAGE);
+    const subId = nextSubId(ctx, slotId);
+    const state = { kind: "fill-between", edgeA, edgeB, style: opts };
+    return createDrawingHandle(slotId, subId, "fill-between", state);
+}
+/**
+ * Implementation signature for {@link fillBetween}. Branches on
+ * `typeof arg1 === "string"` to dispatch the script-facing vs
+ * compiler-injected overload.
+ *
+ * @since 0.4
+ * @stable
+ * @example
+ *     // const fn: typeof fillBetween = fillBetween;
+ *     // void fn;
+ */
+export function fillBetween(arg1, arg2, arg3, arg4) {
+    if (typeof arg1 !== "string" ||
+        arg2 === undefined ||
+        !Array.isArray(arg2) ||
+        arg3 === undefined ||
+        !Array.isArray(arg3)) {
+        throw new Error(OUTSIDE_CTX_MESSAGE);
+    }
+    return fillBetweenImpl(arg1, arg2, arg3, arg4 ?? {});
+}
+//# sourceMappingURL=fillBetween.js.map

package/dist/emit/draw/boxes/fillBetween.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fillBetween.js","sourceRoot":"","sources":["../../../../src/emit/draw/boxes/fillBetween.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,+DAA+D;AAS/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,uDAAuD,CAAC;AAEpF,SAAS,eAAe,CACpB,MAAc,EACd,KAAgC,EAChC,KAAgC,EAChC,IAAsB;IAEtB,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,GAAqB,EAAE,IAAI,EAAE,cAAc,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;IACpF,OAAO,mBAAmB,CAAC,MAAM,EAAE,KAAK,EAAE,cAAc,EAAE,KAAK,CAAC,CAAC;AACrE,CAAC;AAsDD;;;;;;;;;;GAUG;AACH,MAAM,UAAU,WAAW,CACvB,IAAwC,EACxC,IAAgC,EAChC,IAAmD,EACnD,IAAuB;IAEvB,IACI,OAAO,IAAI,KAAK,QAAQ;QACxB,IAAI,KAAK,SAAS;QAClB,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC;QACpB,IAAI,KAAK,SAAS;QAClB,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EACtB,CAAC;QACC,MAAM,IAAI,KAAK,CAAC,mBAAmB,CAAC,CAAC;IACzC,CAAC;IACD,OAAO,eAAe,CAAC,IAAI,EAAE,IAAI,EAAE,IAAiC,EAAE,IAAI,IAAI,EAAE,CAAC,CAAC;AACtF,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 {\n    DrawingHandle,\n    FillBetweenState,\n    FillBetweenStyle,\n    WorldPoint,\n} from \"@invinite-org/chartlang-core\";\n\nimport { ACTIVE_RUNTIME_CONTEXT } from \"../../../runtimeContext.js\";\nimport { createDrawingHandle } from \"../handle.js\";\nimport { nextSubId } from \"../subIdAllocator.js\";\n\nconst OUTSIDE_CTX_MESSAGE = \"draw.fillBetween called outside an active script step\";\n\nfunction fillBetweenImpl(\n    slotId: string,\n    edgeA: ReadonlyArray<WorldPoint>,\n    edgeB: ReadonlyArray<WorldPoint>,\n    opts: FillBetweenStyle,\n): DrawingHandle {\n    const ctx = ACTIVE_RUNTIME_CONTEXT.current;\n    if (ctx === null) throw new Error(OUTSIDE_CTX_MESSAGE);\n    const subId = nextSubId(ctx, slotId);\n    const state: FillBetweenState = { kind: \"fill-between\", edgeA, edgeB, style: opts };\n    return createDrawingHandle(slotId, subId, \"fill-between\", state);\n}\n\n/**\n * Fill the ribbon between two edges. The native equivalent of Pine\n * `linefill.new(line1, line2, color)` and `fill(plot1, plot2, color)`.\n * The filled region is the closed polygon `edgeA` forward then `edgeB`\n * reversed; the two edges need not share x-coordinates or length.\n *\n * @anchors `edgeA`, `edgeB` — two `WorldPoint` lists (the band edges)\n * @anchorCount variable — each edge needs 2..10000 finite anchors\n * @bucket polylines\n * @warmup none — guard warmup in-script: an edge with fewer than 2 finite\n *   anchors (empty, single-point, or a `NaN` coordinate) is dropped with a\n *   `malformed-emission` diagnostic, so accumulate then gate on `length >= 2`\n *   as the example does.\n * @since 0.4\n * @stable\n * @example\n *     import { type WorldPoint, defineIndicator } from \"@invinite-org/chartlang-core\";\n *     const top: WorldPoint[] = [];\n *     const bottom: WorldPoint[] = [];\n *     export default defineIndicator({\n *         name: \"draw.fillBetween demo\",\n *         apiVersion: 1,\n *         compute({ bar, draw }) {\n *             top.push({ time: bar.time, price: bar.high });\n *             bottom.push({ time: bar.time, price: bar.low });\n *             if (top.length >= 2) {\n *                 draw.fillBetween(top, bottom, { fill: \"#3b82f6\", fillAlpha: 0.2 });\n *             }\n *         },\n *     });\n */\nexport function fillBetween(\n    edgeA: ReadonlyArray<WorldPoint>,\n    edgeB: ReadonlyArray<WorldPoint>,\n    opts?: FillBetweenStyle,\n): DrawingHandle;\n/**\n * Compiler-injected overload.\n *\n * @since 0.4\n * @stable\n * @example\n *     // Internal — the compiler rewrites every script callsite.\n *     // const fn: typeof fillBetween = fillBetween;\n *     // void fn;\n */\nexport function fillBetween(\n    slotId: string,\n    edgeA: ReadonlyArray<WorldPoint>,\n    edgeB: ReadonlyArray<WorldPoint>,\n    opts?: FillBetweenStyle,\n): DrawingHandle;\n/**\n * Implementation signature for {@link fillBetween}. Branches on\n * `typeof arg1 === \"string\"` to dispatch the script-facing vs\n * compiler-injected overload.\n *\n * @since 0.4\n * @stable\n * @example\n *     // const fn: typeof fillBetween = fillBetween;\n *     // void fn;\n */\nexport function fillBetween(\n    arg1: string | ReadonlyArray<WorldPoint>,\n    arg2?: ReadonlyArray<WorldPoint>,\n    arg3?: ReadonlyArray<WorldPoint> | FillBetweenStyle,\n    arg4?: FillBetweenStyle,\n): DrawingHandle {\n    if (\n        typeof arg1 !== \"string\" ||\n        arg2 === undefined ||\n        !Array.isArray(arg2) ||\n        arg3 === undefined ||\n        !Array.isArray(arg3)\n    ) {\n        throw new Error(OUTSIDE_CTX_MESSAGE);\n    }\n    return fillBetweenImpl(arg1, arg2, arg3 as ReadonlyArray<WorldPoint>, arg4 ?? {});\n}\n"]}

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

@@ -14,6 +14,15 @@ import type { DrawingHandle, DrawingKind, DrawingState } from "@invinite-org/cha
  *
  * The handle's `id` is `slotId#subId` — stable across bars.
  *
+ * `z` is the presentation-only render-order key the `draw.*` opts bag
+ * carried (core's `ZOrdered` mixin) folded into `state.style`. It is
+ * {@link splitZ | lifted out} of `state.style` so it rides the wire as
+ * the top-level {@link DrawingEmission.z} field, **never** inside
+ * `DrawingState` (Task 3 forbids `z` in `state`), and is persisted on
+ * the slot. An `update` that does not re-specify a non-zero `z` retains
+ * the last value; a re-specified non-zero `z` overrides; `remove`
+ * carries the last-known `z`.
+ *
  * @since 0.3
  * @stable
  * @example

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

@@ -1 +1 @@
-{"version":3,"file":"handle.d.ts","sourceRoot":"","sources":["../../../src/emit/draw/handle.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAoC7F;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,wBAAgB,mBAAmB,CAC/B,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,WAAW,EACjB,YAAY,EAAE,YAAY,GAC3B,aAAa,CAsDf"}
+{"version":3,"file":"handle.d.ts","sourceRoot":"","sources":["../../../src/emit/draw/handle.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAyE7F;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AACH,wBAAgB,mBAAmB,CAC/B,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,WAAW,EACjB,YAAY,EAAE,YAAY,GAC3B,aAAa,CAoEf"}

package/dist/emit/draw/handle.js

@@ -1,6 +1,6 @@
 // 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 { ACTIVE_RUNTIME_CONTEXT, } from "../../runtimeContext.js";
 import { pushDrawing } from "./pushDrawing.js";
 const OUTSIDE_CTX_MESSAGE = "draw called outside an active script step";
 function mergeState(prev, patch) {
@@ -13,7 +13,34 @@ function mergeState(prev, patch) {
     // discriminants stay pinned to `prev.kind`.
     return { ...prev, ...patch, kind: prev.kind };
 }
-function emit(ctx, handleId, kind, op, state) {
+/**
+ * Lift the presentation-only `z` (render-order key) **out** of a
+ * drawing's `state.style` and hand it back to the caller, returning a
+ * state with `z` removed from a **shallow clone** of `style` (the
+ * caller's style object is never mutated). Every `draw.*` option bag
+ * carries `z` via core's `ZOrdered` mixin, and the per-kind impls fold
+ * that bag into `state.style`, so `z` arrives nested at `state.style.z`.
+ * `z` is a **top-level** `DrawingEmission` field, not part of
+ * `DrawingState`, so it must not ride the wire inside `state` — strip it
+ * here. Returns `z: 0` (the omit-when-`0` default) for states with no
+ * `style` (e.g. `group`) or no `z`, leaving the state object **untouched**
+ * in that case so a no-`z` drawing stays byte-identical to the
+ * pre-feature baseline.
+ */
+function splitZ(state) {
+    if (!("style" in state) || state.style === undefined) {
+        return { state, z: 0 };
+    }
+    const style = state.style;
+    if (style.z === undefined) {
+        return { state, z: 0 };
+    }
+    // Shallow-clone style with `z` removed — never mutate the caller's
+    // object. `rest` is z-free, so the wire `state.style` carries no `z`.
+    const { z, ...rest } = style;
+    return { state: { ...state, style: rest }, z };
+}
+function emit(ctx, handleId, kind, op, state, z) {
     pushDrawing(ctx, {
         kind: "drawing",
         handleId,
@@ -22,6 +49,10 @@ function emit(ctx, handleId, kind, op, state) {
         state,
         bar: ctx.barIndex(),
         time: ctx.stream.bar.time,
+        // `z` is presentation-only and top-level (never inside `state`);
+        // omit it when `0` so a no-`z` drawing is byte-identical to the
+        // pre-feature baseline — mirrors `PlotEmission.xShift` / `.z`.
+        ...(z === 0 ? {} : { z }),
     });
 }
 /**
@@ -39,6 +70,15 @@ function emit(ctx, handleId, kind, op, state) {
  *
  * The handle's `id` is `slotId#subId` — stable across bars.
  *
+ * `z` is the presentation-only render-order key the `draw.*` opts bag
+ * carried (core's `ZOrdered` mixin) folded into `state.style`. It is
+ * {@link splitZ | lifted out} of `state.style` so it rides the wire as
+ * the top-level {@link DrawingEmission.z} field, **never** inside
+ * `DrawingState` (Task 3 forbids `z` in `state`), and is persisted on
+ * the slot. An `update` that does not re-specify a non-zero `z` retains
+ * the last value; a re-specified non-zero `z` overrides; `remove`
+ * carries the last-known `z`.
+ *
  * @since 0.3
  * @stable
  * @example
@@ -64,23 +104,30 @@ export function createDrawingHandle(slotId, subId, kind, initialState) {
         throw new Error(OUTSIDE_CTX_MESSAGE);
     const handleId = `${slotId}#${subId}`;
     const existing = ctx.drawingSlots.get(handleId);
+    // Lift `z` out of `state.style` so it rides the emission top-level,
+    // not inside `DrawingState`. The remaining `style` (z removed) is
+    // what persists in the slot.
+    const initial = splitZ(initialState);
     let slot;
     let op;
     if (existing === undefined) {
-        slot = { handleId, kind, state: initialState, removed: false };
+        slot = { handleId, kind, state: initial.state, z: initial.z, removed: false };
         ctx.drawingSlots.set(handleId, slot);
         op = "create";
     }
     else {
         // Cross-bar re-entry. Merge initialState into the existing slot
         // (script-author may pass new anchors / style); resurrect if it
-        // was previously removed.
-        existing.state = mergeState(existing.state, initialState);
+        // was previously removed. A re-specified `z` (non-default)
+        // overrides the retained one; an omitted/`0` `z` keeps the last.
+        existing.state = mergeState(existing.state, initial.state);
+        if (initial.z !== 0)
+            existing.z = initial.z;
         existing.removed = false;
         slot = existing;
         op = "update";
     }
-    emit(ctx, handleId, kind, op, slot.state);
+    emit(ctx, handleId, kind, op, slot.state, slot.z);
     return {
         id: handleId,
         update(patch) {
@@ -95,8 +142,15 @@ export function createDrawingHandle(slotId, subId, kind, initialState) {
             const s = liveCtx.drawingSlots.get(handleId);
             if (s === undefined || s.removed)
                 return;
-            s.state = mergeState(s.state, patch);
-            emit(liveCtx, handleId, kind, "update", s.state);
+            // A patch may re-specify `z` inside `style`; split it out so
+            // it never merges into `state.style`. A re-specified
+            // non-default `z` overrides; an omitted/`0` `z` retains the
+            // slot's last value.
+            const split = splitZ(mergeState(s.state, patch));
+            s.state = split.state;
+            if (split.z !== 0)
+                s.z = split.z;
+            emit(liveCtx, handleId, kind, "update", s.state, s.z);
         },
         remove() {
             const liveCtx = ACTIVE_RUNTIME_CONTEXT.current;
@@ -109,9 +163,10 @@ export function createDrawingHandle(slotId, subId, kind, initialState) {
             // mid-run, so a previously-created handle's "remove" always
             // reaches `pushDrawing`. The slot stays flagged even if a
             // future drop path swallows the emission — a removed handle
-            // must never re-emit.
+            // must never re-emit. `remove` carries the last-known `z`
+            // (harmless — no render).
             s.removed = true;
-            emit(liveCtx, handleId, kind, "remove", s.state);
+            emit(liveCtx, handleId, kind, "remove", s.state, s.z);
         },
     };
 }

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

@@ -1 +1 @@
-{"version":3,"file":"handle.js","sourceRoot":"","sources":["../../../src/emit/draw/handle.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 { DrawingHandle, DrawingKind, DrawingState } from \"@invinite-org/chartlang-core\";\n\nimport { ACTIVE_RUNTIME_CONTEXT, type RuntimeContext } from \"../../runtimeContext.js\";\nimport { pushDrawing } from \"./pushDrawing.js\";\n\nconst OUTSIDE_CTX_MESSAGE = \"draw called outside an active script step\";\n\nfunction mergeState(prev: DrawingState, patch: Partial<DrawingState>): DrawingState {\n    // Spread the patch over `prev` and force `kind` back to the\n    // previous variant. A cross-variant patch from a script is a type\n    // error at the script's callsite — the runtime defends against it\n    // here so the runtime cannot accidentally emit a drift between\n    // `drawingKind` and `state.kind`. The cast is safe because every\n    // variant of `DrawingState` shares the shape `{ kind, ... }` and\n    // discriminants stay pinned to `prev.kind`.\n    return { ...prev, ...patch, kind: prev.kind } as DrawingState;\n}\n\nfunction emit(\n    ctx: RuntimeContext,\n    handleId: string,\n    kind: DrawingKind,\n    op: \"create\" | \"update\" | \"remove\",\n    state: DrawingState,\n): void {\n    pushDrawing(ctx, {\n        kind: \"drawing\",\n        handleId,\n        drawingKind: kind,\n        op,\n        state,\n        bar: ctx.barIndex(),\n        time: ctx.stream.bar.time,\n    });\n}\n\n/**\n * Construct a {@link DrawingHandle} for `slotId#subId` in the active\n * runtime context. Allocates the slot in `ctx.drawingSlots` on the\n * first call (`op: \"create\"`); subsequent calls at the same callsite\n * across bars find the existing slot and emit `op: \"update\"` with the\n * full merged state.\n *\n * `update(patch)` merges the patch with the current slot state and\n * re-emits the FULL merged state under `op: \"update\"`. `remove()`\n * emits one final `op: \"remove\"` with the\n * last-known state and flags the slot `removed: true`; subsequent\n * `update` / `remove` calls on the returned handle are no-ops.\n *\n * The handle's `id` is `slotId#subId` — stable across bars.\n *\n * @since 0.3\n * @stable\n * @example\n *     // import {\n *     //     createDrawingHandle,\n *     // } from \"@invinite-org/chartlang-runtime\";\n *     // const h = createDrawingHandle(\n *     //     \"demo.chart.ts:5:13#0\",\n *     //     0,\n *     //     \"line\",\n *     //     {\n *     //         kind: \"line\",\n *     //         anchors: [{ time: 0, price: 0 }, { time: 1, price: 1 }],\n *     //         style: {},\n *     //     },\n *     // );\n *     // h.update({ style: { color: \"#3b82f6\" } });\n *     // h.remove();\n */\nexport function createDrawingHandle(\n    slotId: string,\n    subId: number,\n    kind: DrawingKind,\n    initialState: DrawingState,\n): DrawingHandle {\n    const ctx = ACTIVE_RUNTIME_CONTEXT.current;\n    if (ctx === null) throw new Error(OUTSIDE_CTX_MESSAGE);\n\n    const handleId = `${slotId}#${subId}`;\n    const existing = ctx.drawingSlots.get(handleId);\n\n    let slot: { handleId: string; kind: DrawingKind; state: DrawingState; removed: boolean };\n    let op: \"create\" | \"update\";\n    if (existing === undefined) {\n        slot = { handleId, kind, state: initialState, removed: false };\n        ctx.drawingSlots.set(handleId, slot);\n        op = \"create\";\n    } else {\n        // Cross-bar re-entry. Merge initialState into the existing slot\n        // (script-author may pass new anchors / style); resurrect if it\n        // was previously removed.\n        existing.state = mergeState(existing.state, initialState);\n        existing.removed = false;\n        slot = existing;\n        op = \"update\";\n    }\n\n    emit(ctx, handleId, kind, op, slot.state);\n\n    return {\n        id: handleId,\n        update(patch: Partial<DrawingState>): void {\n            // `ACTIVE_RUNTIME_CONTEXT.current` can be null when the\n            // host calls `handle.update(...)` outside a compute step\n            // (e.g. from an async callback). Drop silently in that\n            // case — the handle's slot still persists and the next\n            // in-step `update` will fire.\n            const liveCtx = ACTIVE_RUNTIME_CONTEXT.current;\n            if (liveCtx === null) return;\n            const s = liveCtx.drawingSlots.get(handleId);\n            if (s === undefined || s.removed) return;\n            s.state = mergeState(s.state, patch);\n            emit(liveCtx, handleId, kind, \"update\", s.state);\n        },\n        remove(): void {\n            const liveCtx = ACTIVE_RUNTIME_CONTEXT.current;\n            if (liveCtx === null) return;\n            const s = liveCtx.drawingSlots.get(handleId);\n            if (s === undefined || s.removed) return;\n            // Flag-before-emit is safe: capabilities are invariant\n            // mid-run, so a previously-created handle's \"remove\" always\n            // reaches `pushDrawing`. The slot stays flagged even if a\n            // future drop path swallows the emission — a removed handle\n            // must never re-emit.\n            s.removed = true;\n            emit(liveCtx, handleId, kind, \"remove\", s.state);\n        },\n    };\n}\n"]}
+{"version":3,"file":"handle.js","sourceRoot":"","sources":["../../../src/emit/draw/handle.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 { DrawingHandle, DrawingKind, DrawingState } from \"@invinite-org/chartlang-core\";\n\nimport {\n    ACTIVE_RUNTIME_CONTEXT,\n    type DrawingSlot,\n    type RuntimeContext,\n} from \"../../runtimeContext.js\";\nimport { pushDrawing } from \"./pushDrawing.js\";\n\nconst OUTSIDE_CTX_MESSAGE = \"draw called outside an active script step\";\n\nfunction mergeState(prev: DrawingState, patch: Partial<DrawingState>): DrawingState {\n    // Spread the patch over `prev` and force `kind` back to the\n    // previous variant. A cross-variant patch from a script is a type\n    // error at the script's callsite — the runtime defends against it\n    // here so the runtime cannot accidentally emit a drift between\n    // `drawingKind` and `state.kind`. The cast is safe because every\n    // variant of `DrawingState` shares the shape `{ kind, ... }` and\n    // discriminants stay pinned to `prev.kind`.\n    return { ...prev, ...patch, kind: prev.kind } as DrawingState;\n}\n\n/**\n * Lift the presentation-only `z` (render-order key) **out** of a\n * drawing's `state.style` and hand it back to the caller, returning a\n * state with `z` removed from a **shallow clone** of `style` (the\n * caller's style object is never mutated). Every `draw.*` option bag\n * carries `z` via core's `ZOrdered` mixin, and the per-kind impls fold\n * that bag into `state.style`, so `z` arrives nested at `state.style.z`.\n * `z` is a **top-level** `DrawingEmission` field, not part of\n * `DrawingState`, so it must not ride the wire inside `state` — strip it\n * here. Returns `z: 0` (the omit-when-`0` default) for states with no\n * `style` (e.g. `group`) or no `z`, leaving the state object **untouched**\n * in that case so a no-`z` drawing stays byte-identical to the\n * pre-feature baseline.\n */\nfunction splitZ(state: DrawingState): { state: DrawingState; z: number } {\n    if (!(\"style\" in state) || state.style === undefined) {\n        return { state, z: 0 };\n    }\n    const style: { z?: number } = state.style;\n    if (style.z === undefined) {\n        return { state, z: 0 };\n    }\n    // Shallow-clone style with `z` removed — never mutate the caller's\n    // object. `rest` is z-free, so the wire `state.style` carries no `z`.\n    const { z, ...rest } = style;\n    return { state: { ...state, style: rest } as DrawingState, z };\n}\n\nfunction emit(\n    ctx: RuntimeContext,\n    handleId: string,\n    kind: DrawingKind,\n    op: \"create\" | \"update\" | \"remove\",\n    state: DrawingState,\n    z: number,\n): void {\n    pushDrawing(ctx, {\n        kind: \"drawing\",\n        handleId,\n        drawingKind: kind,\n        op,\n        state,\n        bar: ctx.barIndex(),\n        time: ctx.stream.bar.time,\n        // `z` is presentation-only and top-level (never inside `state`);\n        // omit it when `0` so a no-`z` drawing is byte-identical to the\n        // pre-feature baseline — mirrors `PlotEmission.xShift` / `.z`.\n        ...(z === 0 ? {} : { z }),\n    });\n}\n\n/**\n * Construct a {@link DrawingHandle} for `slotId#subId` in the active\n * runtime context. Allocates the slot in `ctx.drawingSlots` on the\n * first call (`op: \"create\"`); subsequent calls at the same callsite\n * across bars find the existing slot and emit `op: \"update\"` with the\n * full merged state.\n *\n * `update(patch)` merges the patch with the current slot state and\n * re-emits the FULL merged state under `op: \"update\"`. `remove()`\n * emits one final `op: \"remove\"` with the\n * last-known state and flags the slot `removed: true`; subsequent\n * `update` / `remove` calls on the returned handle are no-ops.\n *\n * The handle's `id` is `slotId#subId` — stable across bars.\n *\n * `z` is the presentation-only render-order key the `draw.*` opts bag\n * carried (core's `ZOrdered` mixin) folded into `state.style`. It is\n * {@link splitZ | lifted out} of `state.style` so it rides the wire as\n * the top-level {@link DrawingEmission.z} field, **never** inside\n * `DrawingState` (Task 3 forbids `z` in `state`), and is persisted on\n * the slot. An `update` that does not re-specify a non-zero `z` retains\n * the last value; a re-specified non-zero `z` overrides; `remove`\n * carries the last-known `z`.\n *\n * @since 0.3\n * @stable\n * @example\n *     // import {\n *     //     createDrawingHandle,\n *     // } from \"@invinite-org/chartlang-runtime\";\n *     // const h = createDrawingHandle(\n *     //     \"demo.chart.ts:5:13#0\",\n *     //     0,\n *     //     \"line\",\n *     //     {\n *     //         kind: \"line\",\n *     //         anchors: [{ time: 0, price: 0 }, { time: 1, price: 1 }],\n *     //         style: {},\n *     //     },\n *     // );\n *     // h.update({ style: { color: \"#3b82f6\" } });\n *     // h.remove();\n */\nexport function createDrawingHandle(\n    slotId: string,\n    subId: number,\n    kind: DrawingKind,\n    initialState: DrawingState,\n): DrawingHandle {\n    const ctx = ACTIVE_RUNTIME_CONTEXT.current;\n    if (ctx === null) throw new Error(OUTSIDE_CTX_MESSAGE);\n\n    const handleId = `${slotId}#${subId}`;\n    const existing = ctx.drawingSlots.get(handleId);\n\n    // Lift `z` out of `state.style` so it rides the emission top-level,\n    // not inside `DrawingState`. The remaining `style` (z removed) is\n    // what persists in the slot.\n    const initial = splitZ(initialState);\n\n    let slot: DrawingSlot;\n    let op: \"create\" | \"update\";\n    if (existing === undefined) {\n        slot = { handleId, kind, state: initial.state, z: initial.z, removed: false };\n        ctx.drawingSlots.set(handleId, slot);\n        op = \"create\";\n    } else {\n        // Cross-bar re-entry. Merge initialState into the existing slot\n        // (script-author may pass new anchors / style); resurrect if it\n        // was previously removed. A re-specified `z` (non-default)\n        // overrides the retained one; an omitted/`0` `z` keeps the last.\n        existing.state = mergeState(existing.state, initial.state);\n        if (initial.z !== 0) existing.z = initial.z;\n        existing.removed = false;\n        slot = existing;\n        op = \"update\";\n    }\n\n    emit(ctx, handleId, kind, op, slot.state, slot.z);\n\n    return {\n        id: handleId,\n        update(patch: Partial<DrawingState>): void {\n            // `ACTIVE_RUNTIME_CONTEXT.current` can be null when the\n            // host calls `handle.update(...)` outside a compute step\n            // (e.g. from an async callback). Drop silently in that\n            // case — the handle's slot still persists and the next\n            // in-step `update` will fire.\n            const liveCtx = ACTIVE_RUNTIME_CONTEXT.current;\n            if (liveCtx === null) return;\n            const s = liveCtx.drawingSlots.get(handleId);\n            if (s === undefined || s.removed) return;\n            // A patch may re-specify `z` inside `style`; split it out so\n            // it never merges into `state.style`. A re-specified\n            // non-default `z` overrides; an omitted/`0` `z` retains the\n            // slot's last value.\n            const split = splitZ(mergeState(s.state, patch));\n            s.state = split.state;\n            if (split.z !== 0) s.z = split.z;\n            emit(liveCtx, handleId, kind, \"update\", s.state, s.z);\n        },\n        remove(): void {\n            const liveCtx = ACTIVE_RUNTIME_CONTEXT.current;\n            if (liveCtx === null) return;\n            const s = liveCtx.drawingSlots.get(handleId);\n            if (s === undefined || s.removed) return;\n            // Flag-before-emit is safe: capabilities are invariant\n            // mid-run, so a previously-created handle's \"remove\" always\n            // reaches `pushDrawing`. The slot stays flagged even if a\n            // future drop path swallows the emission — a removed handle\n            // must never re-emit. `remove` carries the last-known `z`\n            // (harmless — no render).\n            s.removed = true;\n            emit(liveCtx, handleId, kind, \"remove\", s.state, s.z);\n        },\n    };\n}\n"]}

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

@@ -1,8 +1,9 @@
 import type { DrawNamespace } from "@invinite-org/chartlang-core";
 /**
- * Runtime `draw` namespace. After Task 18 every one of the 61
- * `DrawingKind`s has a real per-kind impl wired into `KIND_IMPLS`;
- * Phase 5 adds the viewport-anchored `table` kind.
+ * Runtime `draw` namespace. Every one of the 63 `DrawingKind`s has a
+ * real per-kind impl wired into `KIND_IMPLS` (Task 18 brought the count
+ * to 61; Phase 5 added the viewport-anchored `table` kind; the
+ * fill-between feature added `fill-between`).
  * the Proxy's `else` branch (fall-through to the core throwing-stub
  * Proxy) is dead code at runtime — kept as defence-in-depth for
  * unknown property access (e.g. JS code accessing a property name

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

@@ -1 +1 @@
-{"version":3,"file":"namespace.d.ts","sourceRoot":"","sources":["../../../src/emit/draw/namespace.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAqJlE;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,eAAO,MAAM,cAAc,EAAE,aAe3B,CAAC"}
+{"version":3,"file":"namespace.d.ts","sourceRoot":"","sources":["../../../src/emit/draw/namespace.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAuJlE;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,eAAO,MAAM,cAAc,EAAE,aAe3B,CAAC"}

package/dist/emit/draw/namespace.js

@@ -8,6 +8,7 @@ import { arrowMarker } from "./annotations/arrowMarker.js";
 import { text } from "./annotations/text.js";
 import { circle } from "./boxes/circle.js";
 import { ellipse } from "./boxes/ellipse.js";
+import { fillBetween } from "./boxes/fillBetween.js";
 import { marker } from "./boxes/marker.js";
 import { path } from "./boxes/path.js";
 import { polyline } from "./boxes/polyline.js";
@@ -80,6 +81,7 @@ const KIND_IMPLS = {
     circle,
     ellipse,
     path,
+    fillBetween,
     marker,
     // Task 8 — Curves
     arc,
@@ -145,9 +147,10 @@ const KIND_IMPLS = {
 };
 const IMPL_KIND_NAMES = new Set(Object.keys(KIND_IMPLS));
 /**
- * Runtime `draw` namespace. After Task 18 every one of the 61
- * `DrawingKind`s has a real per-kind impl wired into `KIND_IMPLS`;
- * Phase 5 adds the viewport-anchored `table` kind.
+ * Runtime `draw` namespace. Every one of the 63 `DrawingKind`s has a
+ * real per-kind impl wired into `KIND_IMPLS` (Task 18 brought the count
+ * to 61; Phase 5 added the viewport-anchored `table` kind; the
+ * fill-between feature added `fill-between`).
  * the Proxy's `else` branch (fall-through to the core throwing-stub
  * Proxy) is dead code at runtime — kept as defence-in-depth for
  * unknown property access (e.g. JS code accessing a property name

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

@@ -1 +1 @@
-{"version":3,"file":"namespace.js","sourceRoot":"","sources":["../../../src/emit/draw/namespace.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 { DrawNamespace } from \"@invinite-org/chartlang-core\";\nimport { draw as CORE_DRAW_STUB } from \"@invinite-org/chartlang-core\";\n\nimport { arrow } from \"./annotations/arrow.js\";\nimport { arrowMarkDown } from \"./annotations/arrowMarkDown.js\";\nimport { arrowMarkUp } from \"./annotations/arrowMarkUp.js\";\nimport { arrowMarker } from \"./annotations/arrowMarker.js\";\nimport { text } from \"./annotations/text.js\";\nimport { circle } from \"./boxes/circle.js\";\nimport { ellipse } from \"./boxes/ellipse.js\";\nimport { marker } from \"./boxes/marker.js\";\nimport { path } from \"./boxes/path.js\";\nimport { polyline } from \"./boxes/polyline.js\";\nimport { rectangle } from \"./boxes/rectangle.js\";\nimport { rotatedRectangle } from \"./boxes/rotatedRectangle.js\";\nimport { triangle } from \"./boxes/triangle.js\";\nimport { disjointChannel } from \"./channels/disjointChannel.js\";\nimport { flatTopBottom } from \"./channels/flatTopBottom.js\";\nimport { regressionTrend } from \"./channels/regressionTrend.js\";\nimport { trendChannel } from \"./channels/trendChannel.js\";\nimport { frame } from \"./containers/frame.js\";\nimport { group } from \"./containers/group.js\";\nimport { arc } from \"./curves/arc.js\";\nimport { brush } from \"./curves/brush.js\";\nimport { curve } from \"./curves/curve.js\";\nimport { doubleCurve } from \"./curves/doubleCurve.js\";\nimport { highlighter } from \"./curves/highlighter.js\";\nimport { pen } from \"./curves/pen.js\";\nimport { cyclicLines } from \"./cycles/cyclicLines.js\";\nimport { sineLine } from \"./cycles/sineLine.js\";\nimport { timeCycles } from \"./cycles/timeCycles.js\";\nimport { elliottCorrectionWave } from \"./elliott/elliottCorrectionWave.js\";\nimport { elliottDoubleCombo } from \"./elliott/elliottDoubleCombo.js\";\nimport { elliottImpulseWave } from \"./elliott/elliottImpulseWave.js\";\nimport { elliottTriangleWave } from \"./elliott/elliottTriangleWave.js\";\nimport { elliottTripleCombo } from \"./elliott/elliottTripleCombo.js\";\nimport { fibChannel } from \"./fibA/fibChannel.js\";\nimport { fibRetracement } from \"./fibA/fibRetracement.js\";\nimport { fibTimeZone } from \"./fibA/fibTimeZone.js\";\nimport { fibTrendExtension } from \"./fibA/fibTrendExtension.js\";\nimport { fibWedge } from \"./fibA/fibWedge.js\";\nimport { fibCircles } from \"./fibB/fibCircles.js\";\nimport { fibSpeedArcs } from \"./fibB/fibSpeedArcs.js\";\nimport { fibSpeedFan } from \"./fibB/fibSpeedFan.js\";\nimport { fibSpiral } from \"./fibB/fibSpiral.js\";\nimport { fibTrendTime } from \"./fibB/fibTrendTime.js\";\nimport { gannBox } from \"./gann/gannBox.js\";\nimport { gannFan } from \"./gann/gannFan.js\";\nimport { gannSquare } from \"./gann/gannSquare.js\";\nimport { gannSquareFixed } from \"./gann/gannSquareFixed.js\";\nimport { crossLine } from \"./lines/crossLine.js\";\nimport { horizontalLine } from \"./lines/horizontalLine.js\";\nimport { horizontalRay } from \"./lines/horizontalRay.js\";\nimport { line } from \"./lines/line.js\";\nimport { trendAngle } from \"./lines/trendAngle.js\";\nimport { verticalLine } from \"./lines/verticalLine.js\";\nimport { abcdPattern } from \"./patterns/abcdPattern.js\";\nimport { cypherPattern } from \"./patterns/cypherPattern.js\";\nimport { headAndShoulders } from \"./patterns/headAndShoulders.js\";\nimport { threeDrivesPattern } from \"./patterns/threeDrivesPattern.js\";\nimport { trianglePattern } from \"./patterns/trianglePattern.js\";\nimport { xabcdPattern } from \"./patterns/xabcdPattern.js\";\nimport { pitchfan } from \"./pitchforks/pitchfan.js\";\nimport { pitchfork } from \"./pitchforks/pitchfork.js\";\nimport { table } from \"./table/table.js\";\n\nconst KIND_IMPLS = {\n    // Task 5 — Lines/Rays\n    line,\n    horizontalLine,\n    horizontalRay,\n    verticalLine,\n    crossLine,\n    trendAngle,\n    // Task 6 — Boxes A\n    rectangle,\n    rotatedRectangle,\n    triangle,\n    polyline,\n    // Task 7 — Boxes B\n    circle,\n    ellipse,\n    path,\n    marker,\n    // Task 8 — Curves\n    arc,\n    curve,\n    doubleCurve,\n    // Task 8 — Freehand\n    pen,\n    highlighter,\n    brush,\n    // Task 9 — Annotations\n    text,\n    arrow,\n    arrowMarker,\n    arrowMarkUp,\n    arrowMarkDown,\n    // Task 10 — Channels\n    trendChannel,\n    flatTopBottom,\n    disjointChannel,\n    regressionTrend,\n    // Task 11 — Fibonacci A\n    fibRetracement,\n    fibTrendExtension,\n    fibChannel,\n    fibTimeZone,\n    fibWedge,\n    // Task 12 — Fibonacci B\n    fibSpeedFan,\n    fibSpeedArcs,\n    fibSpiral,\n    fibCircles,\n    fibTrendTime,\n    // Task 13 — Gann\n    gannBox,\n    gannSquareFixed,\n    gannSquare,\n    gannFan,\n    // Task 14 — Pitchforks\n    pitchfork,\n    pitchfan,\n    // Task 15 — Harmonic Patterns\n    xabcdPattern,\n    cypherPattern,\n    headAndShoulders,\n    abcdPattern,\n    trianglePattern,\n    threeDrivesPattern,\n    // Task 16 — Elliott Waves\n    elliottImpulseWave,\n    elliottCorrectionWave,\n    elliottTriangleWave,\n    elliottDoubleCombo,\n    elliottTripleCombo,\n    // Task 17 — Cycles\n    cyclicLines,\n    timeCycles,\n    sineLine,\n    // Task 18 — Containers\n    group,\n    frame,\n    // Phase 5 — Viewport overlays\n    table,\n} as const;\n\nconst IMPL_KIND_NAMES: ReadonlySet<string> = new Set(Object.keys(KIND_IMPLS));\n\n/**\n * Runtime `draw` namespace. After Task 18 every one of the 61\n * `DrawingKind`s has a real per-kind impl wired into `KIND_IMPLS`;\n * Phase 5 adds the viewport-anchored `table` kind.\n * the Proxy's `else` branch (fall-through to the core throwing-stub\n * Proxy) is dead code at runtime — kept as defence-in-depth for\n * unknown property access (e.g. JS code accessing a property name\n * outside the `DrawNamespace` type surface).\n *\n * Each per-kind impl is the compiler-injected overload — the\n * dispatch branches on `typeof arg1 === \"string\"` to discriminate the\n * slot-id-prefixed compiler form from the bare script-facing form\n * which always throws. This is the Phase-3 swap seam for the\n * `primitives.ts:draw` re-export, mirroring how `TA_REGISTRY` swaps\n * in Phase 2.\n *\n * @since 0.3\n * @stable\n * @example\n *     import { draw } from \"@invinite-org/chartlang-runtime\";\n *     // type S = typeof draw;\n *     void draw;\n */\nexport const DRAW_NAMESPACE: DrawNamespace = new Proxy(KIND_IMPLS as unknown as DrawNamespace, {\n    get(target, property): unknown {\n        const name = String(property);\n        if (IMPL_KIND_NAMES.has(name)) {\n            return Reflect.get(target, property);\n        }\n        // After Task 18 every `DrawingKind` has a real impl in\n        // `KIND_IMPLS` so this branch is unreachable through the\n        // `DrawNamespace` type surface — it stays as defence-in-depth\n        // for non-kind property access (e.g. JS code that reads\n        // `draw[\"foo\"]` through a typed-erased view). Falling through\n        // to core's throwing-stub keeps the failure mode consistent\n        // with the pre-Task-18 behaviour.\n        return Reflect.get(CORE_DRAW_STUB, property);\n    },\n});\n"]}
+{"version":3,"file":"namespace.js","sourceRoot":"","sources":["../../../src/emit/draw/namespace.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 { DrawNamespace } from \"@invinite-org/chartlang-core\";\nimport { draw as CORE_DRAW_STUB } from \"@invinite-org/chartlang-core\";\n\nimport { arrow } from \"./annotations/arrow.js\";\nimport { arrowMarkDown } from \"./annotations/arrowMarkDown.js\";\nimport { arrowMarkUp } from \"./annotations/arrowMarkUp.js\";\nimport { arrowMarker } from \"./annotations/arrowMarker.js\";\nimport { text } from \"./annotations/text.js\";\nimport { circle } from \"./boxes/circle.js\";\nimport { ellipse } from \"./boxes/ellipse.js\";\nimport { fillBetween } from \"./boxes/fillBetween.js\";\nimport { marker } from \"./boxes/marker.js\";\nimport { path } from \"./boxes/path.js\";\nimport { polyline } from \"./boxes/polyline.js\";\nimport { rectangle } from \"./boxes/rectangle.js\";\nimport { rotatedRectangle } from \"./boxes/rotatedRectangle.js\";\nimport { triangle } from \"./boxes/triangle.js\";\nimport { disjointChannel } from \"./channels/disjointChannel.js\";\nimport { flatTopBottom } from \"./channels/flatTopBottom.js\";\nimport { regressionTrend } from \"./channels/regressionTrend.js\";\nimport { trendChannel } from \"./channels/trendChannel.js\";\nimport { frame } from \"./containers/frame.js\";\nimport { group } from \"./containers/group.js\";\nimport { arc } from \"./curves/arc.js\";\nimport { brush } from \"./curves/brush.js\";\nimport { curve } from \"./curves/curve.js\";\nimport { doubleCurve } from \"./curves/doubleCurve.js\";\nimport { highlighter } from \"./curves/highlighter.js\";\nimport { pen } from \"./curves/pen.js\";\nimport { cyclicLines } from \"./cycles/cyclicLines.js\";\nimport { sineLine } from \"./cycles/sineLine.js\";\nimport { timeCycles } from \"./cycles/timeCycles.js\";\nimport { elliottCorrectionWave } from \"./elliott/elliottCorrectionWave.js\";\nimport { elliottDoubleCombo } from \"./elliott/elliottDoubleCombo.js\";\nimport { elliottImpulseWave } from \"./elliott/elliottImpulseWave.js\";\nimport { elliottTriangleWave } from \"./elliott/elliottTriangleWave.js\";\nimport { elliottTripleCombo } from \"./elliott/elliottTripleCombo.js\";\nimport { fibChannel } from \"./fibA/fibChannel.js\";\nimport { fibRetracement } from \"./fibA/fibRetracement.js\";\nimport { fibTimeZone } from \"./fibA/fibTimeZone.js\";\nimport { fibTrendExtension } from \"./fibA/fibTrendExtension.js\";\nimport { fibWedge } from \"./fibA/fibWedge.js\";\nimport { fibCircles } from \"./fibB/fibCircles.js\";\nimport { fibSpeedArcs } from \"./fibB/fibSpeedArcs.js\";\nimport { fibSpeedFan } from \"./fibB/fibSpeedFan.js\";\nimport { fibSpiral } from \"./fibB/fibSpiral.js\";\nimport { fibTrendTime } from \"./fibB/fibTrendTime.js\";\nimport { gannBox } from \"./gann/gannBox.js\";\nimport { gannFan } from \"./gann/gannFan.js\";\nimport { gannSquare } from \"./gann/gannSquare.js\";\nimport { gannSquareFixed } from \"./gann/gannSquareFixed.js\";\nimport { crossLine } from \"./lines/crossLine.js\";\nimport { horizontalLine } from \"./lines/horizontalLine.js\";\nimport { horizontalRay } from \"./lines/horizontalRay.js\";\nimport { line } from \"./lines/line.js\";\nimport { trendAngle } from \"./lines/trendAngle.js\";\nimport { verticalLine } from \"./lines/verticalLine.js\";\nimport { abcdPattern } from \"./patterns/abcdPattern.js\";\nimport { cypherPattern } from \"./patterns/cypherPattern.js\";\nimport { headAndShoulders } from \"./patterns/headAndShoulders.js\";\nimport { threeDrivesPattern } from \"./patterns/threeDrivesPattern.js\";\nimport { trianglePattern } from \"./patterns/trianglePattern.js\";\nimport { xabcdPattern } from \"./patterns/xabcdPattern.js\";\nimport { pitchfan } from \"./pitchforks/pitchfan.js\";\nimport { pitchfork } from \"./pitchforks/pitchfork.js\";\nimport { table } from \"./table/table.js\";\n\nconst KIND_IMPLS = {\n    // Task 5 — Lines/Rays\n    line,\n    horizontalLine,\n    horizontalRay,\n    verticalLine,\n    crossLine,\n    trendAngle,\n    // Task 6 — Boxes A\n    rectangle,\n    rotatedRectangle,\n    triangle,\n    polyline,\n    // Task 7 — Boxes B\n    circle,\n    ellipse,\n    path,\n    fillBetween,\n    marker,\n    // Task 8 — Curves\n    arc,\n    curve,\n    doubleCurve,\n    // Task 8 — Freehand\n    pen,\n    highlighter,\n    brush,\n    // Task 9 — Annotations\n    text,\n    arrow,\n    arrowMarker,\n    arrowMarkUp,\n    arrowMarkDown,\n    // Task 10 — Channels\n    trendChannel,\n    flatTopBottom,\n    disjointChannel,\n    regressionTrend,\n    // Task 11 — Fibonacci A\n    fibRetracement,\n    fibTrendExtension,\n    fibChannel,\n    fibTimeZone,\n    fibWedge,\n    // Task 12 — Fibonacci B\n    fibSpeedFan,\n    fibSpeedArcs,\n    fibSpiral,\n    fibCircles,\n    fibTrendTime,\n    // Task 13 — Gann\n    gannBox,\n    gannSquareFixed,\n    gannSquare,\n    gannFan,\n    // Task 14 — Pitchforks\n    pitchfork,\n    pitchfan,\n    // Task 15 — Harmonic Patterns\n    xabcdPattern,\n    cypherPattern,\n    headAndShoulders,\n    abcdPattern,\n    trianglePattern,\n    threeDrivesPattern,\n    // Task 16 — Elliott Waves\n    elliottImpulseWave,\n    elliottCorrectionWave,\n    elliottTriangleWave,\n    elliottDoubleCombo,\n    elliottTripleCombo,\n    // Task 17 — Cycles\n    cyclicLines,\n    timeCycles,\n    sineLine,\n    // Task 18 — Containers\n    group,\n    frame,\n    // Phase 5 — Viewport overlays\n    table,\n} as const;\n\nconst IMPL_KIND_NAMES: ReadonlySet<string> = new Set(Object.keys(KIND_IMPLS));\n\n/**\n * Runtime `draw` namespace. Every one of the 63 `DrawingKind`s has a\n * real per-kind impl wired into `KIND_IMPLS` (Task 18 brought the count\n * to 61; Phase 5 added the viewport-anchored `table` kind; the\n * fill-between feature added `fill-between`).\n * the Proxy's `else` branch (fall-through to the core throwing-stub\n * Proxy) is dead code at runtime — kept as defence-in-depth for\n * unknown property access (e.g. JS code accessing a property name\n * outside the `DrawNamespace` type surface).\n *\n * Each per-kind impl is the compiler-injected overload — the\n * dispatch branches on `typeof arg1 === \"string\"` to discriminate the\n * slot-id-prefixed compiler form from the bare script-facing form\n * which always throws. This is the Phase-3 swap seam for the\n * `primitives.ts:draw` re-export, mirroring how `TA_REGISTRY` swaps\n * in Phase 2.\n *\n * @since 0.3\n * @stable\n * @example\n *     import { draw } from \"@invinite-org/chartlang-runtime\";\n *     // type S = typeof draw;\n *     void draw;\n */\nexport const DRAW_NAMESPACE: DrawNamespace = new Proxy(KIND_IMPLS as unknown as DrawNamespace, {\n    get(target, property): unknown {\n        const name = String(property);\n        if (IMPL_KIND_NAMES.has(name)) {\n            return Reflect.get(target, property);\n        }\n        // After Task 18 every `DrawingKind` has a real impl in\n        // `KIND_IMPLS` so this branch is unreachable through the\n        // `DrawNamespace` type surface — it stays as defence-in-depth\n        // for non-kind property access (e.g. JS code that reads\n        // `draw[\"foo\"]` through a typed-erased view). Falling through\n        // to core's throwing-stub keeps the failure mode consistent\n        // with the pre-Task-18 behaviour.\n        return Reflect.get(CORE_DRAW_STUB, property);\n    },\n});\n"]}

package/dist/emit/index.d.ts

@@ -1,6 +1,8 @@
 export { alert } from "./alert.js";
 export { emitAlertCondition } from "./alertConditionEmission.js";
 export { applyPlotOverride } from "./applyPlotOverride.js";
+export { barcolor } from "./barcolor.js";
+export { bgcolor } from "./bgcolor.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";

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

@@ -1 +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,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,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,kBAAkB,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACvF,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC"}
+{"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,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,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,kBAAkB,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACvF,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/emit/index.js

@@ -3,6 +3,8 @@
 export { alert } from "./alert.js";
 export { emitAlertCondition } from "./alertConditionEmission.js";
 export { applyPlotOverride } from "./applyPlotOverride.js";
+export { barcolor } from "./barcolor.js";
+export { bgcolor } from "./bgcolor.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";