@invinite-org/chartlang-runtime 1.0.2

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

@@ -0,0 +1,42 @@
+import type { DrawingHandle, ShapeStyle, WorldPoint } from "@invinite-org/chartlang-core";
+/**
+ * Draw an axis-aligned ellipse inscribed in the bounding box of two
+ * world anchors. The renderer derives `(centerX, centerY, radiusX,
+ * radiusY)` from the projected bbox and paints a polyline
+ * approximation. Rotated ellipses (invinite's `widthOffset` form)
+ * are out of scope for Phase 3.
+ *
+ * @anchors `a`, `b` — two `WorldPoint`s (opposite bbox corners)
+ * @anchorCount 2
+ * @bucket boxes
+ * @since 0.3
+ * @stable
+ * @example
+ *     import { defineIndicator } from "@invinite-org/chartlang-core";
+ *     export default defineIndicator({
+ *         name: "draw.ellipse demo",
+ *         apiVersion: 1,
+ *         compute({ bar, draw }) {
+ *             draw.ellipse(
+ *                 { time: bar.time, price: bar.low },
+ *                 { time: bar.time, price: bar.high },
+ *                 { stroke: "#22c55e", fill: "#dcfce7", fillAlpha: 0.3 },
+ *             );
+ *         },
+ *     });
+ */
+export declare function ellipse(a: WorldPoint, b: WorldPoint, opts?: ShapeStyle): DrawingHandle;
+/**
+ * Compiler-injected overload — the callsite-id transformer rewrites
+ * every script-side `draw.ellipse(a, b, opts)` into
+ * `draw.ellipse(slotId, a, b, opts)`.
+ *
+ * @since 0.3
+ * @stable
+ * @example
+ *     // Internal — the compiler rewrites every script callsite.
+ *     // const fn: typeof ellipse = ellipse;
+ *     // void fn;
+ */
+export declare function ellipse(slotId: string, a: WorldPoint, b: WorldPoint, opts?: ShapeStyle): DrawingHandle;
+//# sourceMappingURL=ellipse.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ellipse.d.ts","sourceRoot":"","sources":["../../../../src/emit/draw/boxes/ellipse.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EACR,aAAa,EAEb,UAAU,EACV,UAAU,EACb,MAAM,8BAA8B,CAAC;AAqBtC;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,OAAO,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,UAAU,EAAE,IAAI,CAAC,EAAE,UAAU,GAAG,aAAa,CAAC;AACxF;;;;;;;;;;;GAWG;AACH,wBAAgB,OAAO,CACnB,MAAM,EAAE,MAAM,EACd,CAAC,EAAE,UAAU,EACb,CAAC,EAAE,UAAU,EACb,IAAI,CAAC,EAAE,UAAU,GAClB,aAAa,CAAC"}

package/dist/emit/draw/boxes/ellipse.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.
+//
+// Anchors + state shape ported from
+//   invinite/shared/trading-chart-collab-yjs/y-doc-bridge.ts
+//     (EllipseDrawing), commit
+//     078f41fe2569d659d5aba726da8bcb5d3e2ced02, © Invinite.
+// Behaviour from
+//   invinite/src/components/trading-chart/tools/ellipse-tool.ts.
+// Re-licensed MIT for chartlang. See PLAN.md §3.1 + §22.10.
+import { ACTIVE_RUNTIME_CONTEXT } from "../../../runtimeContext.js";
+import { createDrawingHandle } from "../handle.js";
+import { nextSubId } from "../subIdAllocator.js";
+const OUTSIDE_CTX_MESSAGE = "draw.ellipse called outside an active script step";
+function ellipseImpl(slotId, a, b, opts) {
+    const ctx = ACTIVE_RUNTIME_CONTEXT.current;
+    if (ctx === null)
+        throw new Error(OUTSIDE_CTX_MESSAGE);
+    const subId = nextSubId(ctx, slotId);
+    const state = { kind: "ellipse", anchors: [a, b], style: opts };
+    return createDrawingHandle(slotId, subId, "ellipse", state);
+}
+/**
+ * Implementation signature for {@link ellipse}. Branches on
+ * `typeof arg1 === "string"` to dispatch the script-facing vs
+ * compiler-injected overload.
+ *
+ * @since 0.3
+ * @stable
+ * @example
+ *     // const fn: typeof ellipse = ellipse;
+ *     // void fn;
+ */
+export function ellipse(arg1, arg2, arg3, arg4) {
+    if (typeof arg1 !== "string" || arg2 === undefined || arg3 === undefined) {
+        throw new Error(OUTSIDE_CTX_MESSAGE);
+    }
+    return ellipseImpl(arg1, arg2, arg3, arg4 ?? {});
+}
+//# sourceMappingURL=ellipse.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ellipse.js","sourceRoot":"","sources":["../../../../src/emit/draw/boxes/ellipse.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,+DAA+D;AAC/D,EAAE;AACF,oCAAoC;AACpC,6DAA6D;AAC7D,+BAA+B;AAC/B,4DAA4D;AAC5D,iBAAiB;AACjB,iEAAiE;AACjE,4DAA4D;AAS5D,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,mDAAmD,CAAC;AAEhF,SAAS,WAAW,CAChB,MAAc,EACd,CAAa,EACb,CAAa,EACb,IAAgB;IAEhB,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,GAAiB,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;IAC9E,OAAO,mBAAmB,CAAC,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC;AAChE,CAAC;AA+CD;;;;;;;;;;GAUG;AACH,MAAM,UAAU,OAAO,CACnB,IAAyB,EACzB,IAAiB,EACjB,IAA8B,EAC9B,IAAiB;IAEjB,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,SAAS,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACvE,MAAM,IAAI,KAAK,CAAC,mBAAmB,CAAC,CAAC;IACzC,CAAC;IACD,OAAO,WAAW,CAAC,IAAI,EAAE,IAAI,EAAE,IAAkB,EAAE,IAAI,IAAI,EAAE,CAAC,CAAC;AACnE,CAAC"}

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

@@ -0,0 +1,43 @@
+import type { DrawingHandle, TextOpts, WorldPoint } from "@invinite-org/chartlang-core";
+type MarkerOpts = TextOpts & {
+    readonly text?: string;
+    readonly value?: number;
+};
+/**
+ * Draw a single-anchor marker glyph with an optional text label and
+ * numeric value. The renderer projects `anchor` to canvas pixel space
+ * and paints the `text` (if any) at that position using the
+ * {@link TextOpts}-derived font + alignment.
+ *
+ * @anchors `anchor` — one `WorldPoint`
+ * @anchorCount 1
+ * @bucket labels
+ * @since 0.3
+ * @stable
+ * @example
+ *     import { defineIndicator } from "@invinite-org/chartlang-core";
+ *     export default defineIndicator({
+ *         name: "draw.marker demo",
+ *         apiVersion: 1,
+ *         compute({ bar, draw }) {
+ *             draw.marker(
+ *                 { time: bar.time, price: bar.close },
+ *                 { text: "B", size: "large", color: "#10b981" },
+ *             );
+ *         },
+ *     });
+ */
+export declare function marker(anchor: WorldPoint, opts?: MarkerOpts): DrawingHandle;
+/**
+ * Compiler-injected overload.
+ *
+ * @since 0.3
+ * @stable
+ * @example
+ *     // Internal — the compiler rewrites every script callsite.
+ *     // const fn: typeof marker = marker;
+ *     // void fn;
+ */
+export declare function marker(slotId: string, anchor: WorldPoint, opts?: MarkerOpts): DrawingHandle;
+export {};
+//# sourceMappingURL=marker.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"marker.d.ts","sourceRoot":"","sources":["../../../../src/emit/draw/boxes/marker.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EACR,aAAa,EAEb,QAAQ,EACR,UAAU,EACb,MAAM,8BAA8B,CAAC;AAQtC,KAAK,UAAU,GAAG,QAAQ,GAAG;IACzB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CAC3B,CAAC;AAmBF;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,MAAM,CAAC,MAAM,EAAE,UAAU,EAAE,IAAI,CAAC,EAAE,UAAU,GAAG,aAAa,CAAC;AAC7E;;;;;;;;;GASG;AACH,wBAAgB,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,IAAI,CAAC,EAAE,UAAU,GAAG,aAAa,CAAC"}

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

@@ -0,0 +1,49 @@
+// Copyright (c) 2026 Invinite. Licensed under the MIT License.
+// See the LICENSE file in the repo root for full license text.
+//
+// Anchors + state shape ported from
+//   invinite/shared/trading-chart-collab-yjs/y-doc-bridge.ts
+//     (MarkerDrawing), commit
+//     078f41fe2569d659d5aba726da8bcb5d3e2ced02, © Invinite.
+// Behaviour from
+//   invinite/src/components/trading-chart/tools/marker-tool.ts.
+// Re-licensed MIT for chartlang. See PLAN.md §3.1 + §22.10.
+import { ACTIVE_RUNTIME_CONTEXT } from "../../../runtimeContext.js";
+import { createDrawingHandle } from "../handle.js";
+import { nextSubId } from "../subIdAllocator.js";
+const OUTSIDE_CTX_MESSAGE = "draw.marker called outside an active script step";
+function markerImpl(slotId, anchor, opts) {
+    const ctx = ACTIVE_RUNTIME_CONTEXT.current;
+    if (ctx === null)
+        throw new Error(OUTSIDE_CTX_MESSAGE);
+    const subId = nextSubId(ctx, slotId);
+    // Split the merged opts bag: top-level `text` / `value` live on the
+    // state; the remaining TextOpts fields nest under `style`.
+    const { text, value, ...style } = opts;
+    const state = {
+        kind: "marker",
+        anchor,
+        ...(text !== undefined ? { text } : {}),
+        ...(value !== undefined ? { value } : {}),
+        style,
+    };
+    return createDrawingHandle(slotId, subId, "marker", state);
+}
+/**
+ * Implementation signature for {@link marker}. Branches on
+ * `typeof arg1 === "string"` to dispatch the script-facing vs
+ * compiler-injected overload.
+ *
+ * @since 0.3
+ * @stable
+ * @example
+ *     // const fn: typeof marker = marker;
+ *     // void fn;
+ */
+export function marker(arg1, arg2, arg3) {
+    if (typeof arg1 !== "string" || arg2 === undefined) {
+        throw new Error(OUTSIDE_CTX_MESSAGE);
+    }
+    return markerImpl(arg1, arg2, arg3 ?? {});
+}
+//# sourceMappingURL=marker.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"marker.js","sourceRoot":"","sources":["../../../../src/emit/draw/boxes/marker.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,+DAA+D;AAC/D,EAAE;AACF,oCAAoC;AACpC,6DAA6D;AAC7D,8BAA8B;AAC9B,4DAA4D;AAC5D,iBAAiB;AACjB,gEAAgE;AAChE,4DAA4D;AAS5D,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,kDAAkD,CAAC;AAO/E,SAAS,UAAU,CAAC,MAAc,EAAE,MAAkB,EAAE,IAAgB;IACpE,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,oEAAoE;IACpE,2DAA2D;IAC3D,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,KAAK,EAAE,GAAG,IAAI,CAAC;IACvC,MAAM,KAAK,GAAgB;QACvB,IAAI,EAAE,QAAQ;QACd,MAAM;QACN,GAAG,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACvC,GAAG,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACzC,KAAK;KACR,CAAC;IACF,OAAO,mBAAmB,CAAC,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC;AAC/D,CAAC;AAsCD;;;;;;;;;;GAUG;AACH,MAAM,UAAU,MAAM,CAClB,IAAyB,EACzB,IAA8B,EAC9B,IAAiB;IAEjB,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACjD,MAAM,IAAI,KAAK,CAAC,mBAAmB,CAAC,CAAC;IACzC,CAAC;IACD,OAAO,UAAU,CAAC,IAAI,EAAE,IAAkB,EAAE,IAAI,IAAI,EAAE,CAAC,CAAC;AAC5D,CAAC"}

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

@@ -0,0 +1,43 @@
+import type { DrawingHandle, PathOpts, WorldPoint } from "@invinite-org/chartlang-core";
+/**
+ * Draw an OPEN polyline through N world anchors. Distinct from
+ * `draw.polyline` (Task 6) which is CLOSED — `path` does NOT
+ * auto-connect the last anchor back to the first. Use
+ * `opts.closed === true` to override and close the path explicitly.
+ * Supply 2..20 anchors (validator pins this range, mirroring
+ * invinite's 20-point cap).
+ *
+ * @anchors `anchors` — `ReadonlyArray<WorldPoint>` of length 2..20
+ * @anchorCount 2..20
+ * @bucket polylines
+ * @since 0.3
+ * @stable
+ * @example
+ *     import { defineIndicator } from "@invinite-org/chartlang-core";
+ *     export default defineIndicator({
+ *         name: "draw.path demo",
+ *         apiVersion: 1,
+ *         compute({ bar, draw }) {
+ *             draw.path(
+ *                 [
+ *                     { time: bar.time, price: bar.open },
+ *                     { time: bar.time, price: bar.close },
+ *                 ],
+ *                 { color: "#3b82f6", lineWidth: 2 },
+ *             );
+ *         },
+ *     });
+ */
+export declare function path(anchors: ReadonlyArray<WorldPoint>, opts?: PathOpts): DrawingHandle;
+/**
+ * Compiler-injected overload.
+ *
+ * @since 0.3
+ * @stable
+ * @example
+ *     // Internal — the compiler rewrites every script callsite.
+ *     // const fn: typeof path = path;
+ *     // void fn;
+ */
+export declare function path(slotId: string, anchors: ReadonlyArray<WorldPoint>, opts?: PathOpts): DrawingHandle;
+//# sourceMappingURL=path.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"path.d.ts","sourceRoot":"","sources":["../../../../src/emit/draw/boxes/path.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,aAAa,EAAE,QAAQ,EAAa,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAoBnG;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,IAAI,CAAC,OAAO,EAAE,aAAa,CAAC,UAAU,CAAC,EAAE,IAAI,CAAC,EAAE,QAAQ,GAAG,aAAa,CAAC;AACzF;;;;;;;;;GASG;AACH,wBAAgB,IAAI,CAChB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,aAAa,CAAC,UAAU,CAAC,EAClC,IAAI,CAAC,EAAE,QAAQ,GAChB,aAAa,CAAC"}

package/dist/emit/draw/boxes/path.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.
+//
+// Anchors + state shape ported from
+//   invinite/shared/trading-chart-collab-yjs/y-doc-bridge.ts
+//     (PathDrawing), commit
+//     078f41fe2569d659d5aba726da8bcb5d3e2ced02, © Invinite.
+// Behaviour from
+//   invinite/src/components/trading-chart/tools/path-tool.ts.
+// Re-licensed MIT for chartlang. See PLAN.md §3.1 + §22.10.
+import { ACTIVE_RUNTIME_CONTEXT } from "../../../runtimeContext.js";
+import { createDrawingHandle } from "../handle.js";
+import { nextSubId } from "../subIdAllocator.js";
+const OUTSIDE_CTX_MESSAGE = "draw.path called outside an active script step";
+function pathImpl(slotId, anchors, opts) {
+    const ctx = ACTIVE_RUNTIME_CONTEXT.current;
+    if (ctx === null)
+        throw new Error(OUTSIDE_CTX_MESSAGE);
+    const subId = nextSubId(ctx, slotId);
+    const state = { kind: "path", anchors, style: opts };
+    return createDrawingHandle(slotId, subId, "path", state);
+}
+/**
+ * Implementation signature for {@link path}. Branches on
+ * `typeof arg1 === "string"` to dispatch the script-facing vs
+ * compiler-injected overload.
+ *
+ * @since 0.3
+ * @stable
+ * @example
+ *     // const fn: typeof path = path;
+ *     // void fn;
+ */
+export function path(arg1, arg2, arg3) {
+    if (typeof arg1 !== "string" || arg2 === undefined || !Array.isArray(arg2)) {
+        throw new Error(OUTSIDE_CTX_MESSAGE);
+    }
+    return pathImpl(arg1, arg2, arg3 ?? {});
+}
+//# sourceMappingURL=path.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"path.js","sourceRoot":"","sources":["../../../../src/emit/draw/boxes/path.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,+DAA+D;AAC/D,EAAE;AACF,oCAAoC;AACpC,6DAA6D;AAC7D,4BAA4B;AAC5B,4DAA4D;AAC5D,iBAAiB;AACjB,8DAA8D;AAC9D,4DAA4D;AAI5D,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,gDAAgD,CAAC;AAE7E,SAAS,QAAQ,CACb,MAAc,EACd,OAAkC,EAClC,IAAc;IAEd,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,GAAc,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;IAChE,OAAO,mBAAmB,CAAC,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;AAC7D,CAAC;AA+CD;;;;;;;;;;GAUG;AACH,MAAM,UAAU,IAAI,CAChB,IAAwC,EACxC,IAA2C,EAC3C,IAAe;IAEf,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,SAAS,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QACzE,MAAM,IAAI,KAAK,CAAC,mBAAmB,CAAC,CAAC;IACzC,CAAC;IACD,OAAO,QAAQ,CAAC,IAAI,EAAE,IAAiC,EAAE,IAAI,IAAI,EAAE,CAAC,CAAC;AACzE,CAAC"}

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

@@ -0,0 +1,43 @@
+import type { DrawingHandle, LineDrawStyle, WorldPoint } from "@invinite-org/chartlang-core";
+/**
+ * Draw a closed polyline through N world anchors. The renderer
+ * auto-connects the last anchor back to the first to close the
+ * polygon; supply between 3 and 20 anchors (validator pins this
+ * range, mirroring the invinite tool's 20-point cap). The open
+ * polyline equivalent will ship as `draw.path` (Task 7).
+ *
+ * @anchors `anchors` — `ReadonlyArray<WorldPoint>` of length 3..20
+ * @anchorCount 3..20
+ * @bucket polylines
+ * @since 0.3
+ * @stable
+ * @example
+ *     import { defineIndicator } from "@invinite-org/chartlang-core";
+ *     export default defineIndicator({
+ *         name: "draw.polyline demo",
+ *         apiVersion: 1,
+ *         compute({ bar, draw }) {
+ *             draw.polyline(
+ *                 [
+ *                     { time: bar.time, price: bar.low },
+ *                     { time: bar.time, price: bar.open },
+ *                     { time: bar.time, price: bar.high },
+ *                 ],
+ *                 { color: "#a855f7", lineWidth: 2 },
+ *             );
+ *         },
+ *     });
+ */
+export declare function polyline(anchors: ReadonlyArray<WorldPoint>, opts?: LineDrawStyle): DrawingHandle;
+/**
+ * Compiler-injected overload.
+ *
+ * @since 0.3
+ * @stable
+ * @example
+ *     // Internal — the compiler rewrites every script callsite.
+ *     // const fn: typeof polyline = polyline;
+ *     // void fn;
+ */
+export declare function polyline(slotId: string, anchors: ReadonlyArray<WorldPoint>, opts?: LineDrawStyle): DrawingHandle;
+//# sourceMappingURL=polyline.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"polyline.d.ts","sourceRoot":"","sources":["../../../../src/emit/draw/boxes/polyline.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EACR,aAAa,EACb,aAAa,EAEb,UAAU,EACb,MAAM,8BAA8B,CAAC;AAoBtC;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC,UAAU,CAAC,EAAE,IAAI,CAAC,EAAE,aAAa,GAAG,aAAa,CAAC;AAClG;;;;;;;;;GASG;AACH,wBAAgB,QAAQ,CACpB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,aAAa,CAAC,UAAU,CAAC,EAClC,IAAI,CAAC,EAAE,aAAa,GACrB,aAAa,CAAC"}

package/dist/emit/draw/boxes/polyline.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.
+//
+// Anchors + state shape ported from
+//   invinite/shared/trading-chart-collab-yjs/y-doc-bridge.ts
+//     (PolylineDrawing), commit
+//     078f41fe2569d659d5aba726da8bcb5d3e2ced02, © Invinite.
+// Behaviour from
+//   invinite/src/components/trading-chart/tools/polyline-tool.ts.
+// Re-licensed MIT for chartlang. See PLAN.md §3.1 + §22.10.
+import { ACTIVE_RUNTIME_CONTEXT } from "../../../runtimeContext.js";
+import { createDrawingHandle } from "../handle.js";
+import { nextSubId } from "../subIdAllocator.js";
+const OUTSIDE_CTX_MESSAGE = "draw.polyline called outside an active script step";
+function polylineImpl(slotId, anchors, opts) {
+    const ctx = ACTIVE_RUNTIME_CONTEXT.current;
+    if (ctx === null)
+        throw new Error(OUTSIDE_CTX_MESSAGE);
+    const subId = nextSubId(ctx, slotId);
+    const state = { kind: "polyline", anchors, style: opts };
+    return createDrawingHandle(slotId, subId, "polyline", state);
+}
+/**
+ * Implementation signature for {@link polyline}. Branches on
+ * `typeof arg1 === "string"` to dispatch the script-facing vs
+ * compiler-injected overload.
+ *
+ * @since 0.3
+ * @stable
+ * @example
+ *     // const fn: typeof polyline = polyline;
+ *     // void fn;
+ */
+export function polyline(arg1, arg2, arg3) {
+    if (typeof arg1 !== "string" || arg2 === undefined || !Array.isArray(arg2)) {
+        throw new Error(OUTSIDE_CTX_MESSAGE);
+    }
+    return polylineImpl(arg1, arg2, arg3 ?? {});
+}
+//# sourceMappingURL=polyline.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"polyline.js","sourceRoot":"","sources":["../../../../src/emit/draw/boxes/polyline.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,+DAA+D;AAC/D,EAAE;AACF,oCAAoC;AACpC,6DAA6D;AAC7D,gCAAgC;AAChC,4DAA4D;AAC5D,iBAAiB;AACjB,kEAAkE;AAClE,4DAA4D;AAS5D,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,oDAAoD,CAAC;AAEjF,SAAS,YAAY,CACjB,MAAc,EACd,OAAkC,EAClC,IAAmB;IAEnB,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,GAAkB,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;IACxE,OAAO,mBAAmB,CAAC,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,CAAC,CAAC;AACjE,CAAC;AA+CD;;;;;;;;;;GAUG;AACH,MAAM,UAAU,QAAQ,CACpB,IAAwC,EACxC,IAAgD,EAChD,IAAoB;IAEpB,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,SAAS,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QACzE,MAAM,IAAI,KAAK,CAAC,mBAAmB,CAAC,CAAC;IACzC,CAAC;IACD,OAAO,YAAY,CAAC,IAAI,EAAE,IAAiC,EAAE,IAAI,IAAI,EAAE,CAAC,CAAC;AAC7E,CAAC"}

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

@@ -0,0 +1,40 @@
+import type { DrawingHandle, ShapeStyle, WorldPoint } from "@invinite-org/chartlang-core";
+/**
+ * Draw an axis-aligned rectangle defined by two opposite world corners.
+ * The renderer projects each anchor with the adapter's viewport
+ * transform; degenerate (zero-area) inputs render as a single line.
+ *
+ * @anchors `a`, `b` — two `WorldPoint`s (opposite corners)
+ * @anchorCount 2
+ * @bucket boxes
+ * @since 0.3
+ * @stable
+ * @example
+ *     import { defineIndicator } from "@invinite-org/chartlang-core";
+ *     export default defineIndicator({
+ *         name: "draw.rectangle demo",
+ *         apiVersion: 1,
+ *         compute({ bar, draw }) {
+ *             draw.rectangle(
+ *                 { time: bar.time, price: bar.low },
+ *                 { time: bar.time, price: bar.high },
+ *                 { stroke: "#3b82f6", fill: "#dbeafe", fillAlpha: 0.4 },
+ *             );
+ *         },
+ *     });
+ */
+export declare function rectangle(a: WorldPoint, b: WorldPoint, opts?: ShapeStyle): DrawingHandle;
+/**
+ * Compiler-injected overload — the callsite-id transformer rewrites
+ * every script-side `draw.rectangle(a, b, opts)` into
+ * `draw.rectangle(slotId, a, b, opts)`.
+ *
+ * @since 0.3
+ * @stable
+ * @example
+ *     // Internal — the compiler rewrites every script callsite.
+ *     // const fn: typeof rectangle = rectangle;
+ *     // void fn;
+ */
+export declare function rectangle(slotId: string, a: WorldPoint, b: WorldPoint, opts?: ShapeStyle): DrawingHandle;
+//# sourceMappingURL=rectangle.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"rectangle.d.ts","sourceRoot":"","sources":["../../../../src/emit/draw/boxes/rectangle.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EACR,aAAa,EAEb,UAAU,EACV,UAAU,EACb,MAAM,8BAA8B,CAAC;AAqBtC;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,UAAU,EAAE,IAAI,CAAC,EAAE,UAAU,GAAG,aAAa,CAAC;AAC1F;;;;;;;;;;;GAWG;AACH,wBAAgB,SAAS,CACrB,MAAM,EAAE,MAAM,EACd,CAAC,EAAE,UAAU,EACb,CAAC,EAAE,UAAU,EACb,IAAI,CAAC,EAAE,UAAU,GAClB,aAAa,CAAC"}

package/dist/emit/draw/boxes/rectangle.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.
+//
+// Anchors + state shape ported from
+//   invinite/shared/trading-chart-collab-yjs/y-doc-bridge.ts
+//     (RectangleDrawing), commit
+//     078f41fe2569d659d5aba726da8bcb5d3e2ced02, © Invinite.
+// Behaviour from
+//   invinite/src/components/trading-chart/tools/rectangle-tool.ts.
+// Re-licensed MIT for chartlang. See PLAN.md §3.1 + §22.10.
+import { ACTIVE_RUNTIME_CONTEXT } from "../../../runtimeContext.js";
+import { createDrawingHandle } from "../handle.js";
+import { nextSubId } from "../subIdAllocator.js";
+const OUTSIDE_CTX_MESSAGE = "draw.rectangle called outside an active script step";
+function rectangleImpl(slotId, a, b, opts) {
+    const ctx = ACTIVE_RUNTIME_CONTEXT.current;
+    if (ctx === null)
+        throw new Error(OUTSIDE_CTX_MESSAGE);
+    const subId = nextSubId(ctx, slotId);
+    const state = { kind: "rectangle", anchors: [a, b], style: opts };
+    return createDrawingHandle(slotId, subId, "rectangle", state);
+}
+/**
+ * Implementation signature for {@link rectangle}. Branches on
+ * `typeof arg1 === "string"` to dispatch the script-facing vs
+ * compiler-injected overload.
+ *
+ * @since 0.3
+ * @stable
+ * @example
+ *     // const fn: typeof rectangle = rectangle;
+ *     // void fn;
+ */
+export function rectangle(arg1, arg2, arg3, arg4) {
+    if (typeof arg1 !== "string" || arg2 === undefined || arg3 === undefined) {
+        throw new Error(OUTSIDE_CTX_MESSAGE);
+    }
+    return rectangleImpl(arg1, arg2, arg3, arg4 ?? {});
+}
+//# sourceMappingURL=rectangle.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"rectangle.js","sourceRoot":"","sources":["../../../../src/emit/draw/boxes/rectangle.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,+DAA+D;AAC/D,EAAE;AACF,oCAAoC;AACpC,6DAA6D;AAC7D,iCAAiC;AACjC,4DAA4D;AAC5D,iBAAiB;AACjB,mEAAmE;AACnE,4DAA4D;AAS5D,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,qDAAqD,CAAC;AAElF,SAAS,aAAa,CAClB,MAAc,EACd,CAAa,EACb,CAAa,EACb,IAAgB;IAEhB,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,GAAmB,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;IAClF,OAAO,mBAAmB,CAAC,MAAM,EAAE,KAAK,EAAE,WAAW,EAAE,KAAK,CAAC,CAAC;AAClE,CAAC;AA6CD;;;;;;;;;;GAUG;AACH,MAAM,UAAU,SAAS,CACrB,IAAyB,EACzB,IAAiB,EACjB,IAA8B,EAC9B,IAAiB;IAEjB,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,SAAS,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACvE,MAAM,IAAI,KAAK,CAAC,mBAAmB,CAAC,CAAC;IACzC,CAAC;IACD,OAAO,aAAa,CAAC,IAAI,EAAE,IAAI,EAAE,IAAkB,EAAE,IAAI,IAAI,EAAE,CAAC,CAAC;AACrE,CAAC"}

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

@@ -0,0 +1,45 @@
+import type { AnchorQuad, DrawingHandle, ShapeStyle } from "@invinite-org/chartlang-core";
+/**
+ * Draw a rotated rectangle by its four world-space corners. The four
+ * anchors should be supplied in stroke order (CW or CCW); the renderer
+ * walks them as a closed polygon so any non-self-intersecting quad
+ * paints correctly. Pure square / axis-aligned input is supported —
+ * use {@link rectangle} for that case if you prefer the 2-anchor
+ * ergonomics.
+ *
+ * @anchors `anchors` — 4 `WorldPoint`s in stroke order
+ * @anchorCount 4
+ * @bucket boxes
+ * @since 0.3
+ * @stable
+ * @example
+ *     import { defineIndicator } from "@invinite-org/chartlang-core";
+ *     export default defineIndicator({
+ *         name: "draw.rotatedRectangle demo",
+ *         apiVersion: 1,
+ *         compute({ bar, draw }) {
+ *             draw.rotatedRectangle(
+ *                 [
+ *                     { time: bar.time, price: bar.low },
+ *                     { time: bar.time, price: bar.high },
+ *                     { time: bar.time, price: bar.high + 1 },
+ *                     { time: bar.time, price: bar.low + 1 },
+ *                 ],
+ *                 { stroke: "#22c55e" },
+ *             );
+ *         },
+ *     });
+ */
+export declare function rotatedRectangle(anchors: AnchorQuad, opts?: ShapeStyle): DrawingHandle;
+/**
+ * Compiler-injected overload.
+ *
+ * @since 0.3
+ * @stable
+ * @example
+ *     // Internal — the compiler rewrites every script callsite.
+ *     // const fn: typeof rotatedRectangle = rotatedRectangle;
+ *     // void fn;
+ */
+export declare function rotatedRectangle(slotId: string, anchors: AnchorQuad, opts?: ShapeStyle): DrawingHandle;
+//# sourceMappingURL=rotatedRectangle.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"rotatedRectangle.d.ts","sourceRoot":"","sources":["../../../../src/emit/draw/boxes/rotatedRectangle.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EACR,UAAU,EACV,aAAa,EAEb,UAAU,EACb,MAAM,8BAA8B,CAAC;AAoBtC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,UAAU,EAAE,IAAI,CAAC,EAAE,UAAU,GAAG,aAAa,CAAC;AACxF;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAC5B,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,UAAU,EACnB,IAAI,CAAC,EAAE,UAAU,GAClB,aAAa,CAAC"}

package/dist/emit/draw/boxes/rotatedRectangle.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.
+//
+// Anchors + state shape ported from
+//   invinite/shared/trading-chart-collab-yjs/y-doc-bridge.ts
+//     (RotatedRectangleDrawing), commit
+//     078f41fe2569d659d5aba726da8bcb5d3e2ced02, © Invinite.
+// Behaviour from
+//   invinite/src/components/trading-chart/tools/rotated-rectangle-tool.ts.
+// Re-licensed MIT for chartlang. See PLAN.md §3.1 + §22.10.
+import { ACTIVE_RUNTIME_CONTEXT } from "../../../runtimeContext.js";
+import { createDrawingHandle } from "../handle.js";
+import { nextSubId } from "../subIdAllocator.js";
+const OUTSIDE_CTX_MESSAGE = "draw.rotatedRectangle called outside an active script step";
+function rotatedRectangleImpl(slotId, anchors, opts) {
+    const ctx = ACTIVE_RUNTIME_CONTEXT.current;
+    if (ctx === null)
+        throw new Error(OUTSIDE_CTX_MESSAGE);
+    const subId = nextSubId(ctx, slotId);
+    const state = { kind: "rotated-rectangle", anchors, style: opts };
+    return createDrawingHandle(slotId, subId, "rotated-rectangle", state);
+}
+/**
+ * Implementation signature for {@link rotatedRectangle}. Branches on
+ * `typeof arg1 === "string"` to dispatch the script-facing vs
+ * compiler-injected overload.
+ *
+ * @since 0.3
+ * @stable
+ * @example
+ *     // const fn: typeof rotatedRectangle = rotatedRectangle;
+ *     // void fn;
+ */
+export function rotatedRectangle(arg1, arg2, arg3) {
+    if (typeof arg1 !== "string" || arg2 === undefined || !Array.isArray(arg2)) {
+        throw new Error(OUTSIDE_CTX_MESSAGE);
+    }
+    return rotatedRectangleImpl(arg1, arg2, arg3 ?? {});
+}
+//# sourceMappingURL=rotatedRectangle.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"rotatedRectangle.js","sourceRoot":"","sources":["../../../../src/emit/draw/boxes/rotatedRectangle.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,+DAA+D;AAC/D,EAAE;AACF,oCAAoC;AACpC,6DAA6D;AAC7D,wCAAwC;AACxC,4DAA4D;AAC5D,iBAAiB;AACjB,2EAA2E;AAC3E,4DAA4D;AAS5D,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,4DAA4D,CAAC;AAEzF,SAAS,oBAAoB,CACzB,MAAc,EACd,OAAmB,EACnB,IAAgB;IAEhB,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,GAA0B,EAAE,IAAI,EAAE,mBAAmB,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;IACzF,OAAO,mBAAmB,CAAC,MAAM,EAAE,KAAK,EAAE,mBAAmB,EAAE,KAAK,CAAC,CAAC;AAC1E,CAAC;AAiDD;;;;;;;;;;GAUG;AACH,MAAM,UAAU,gBAAgB,CAC5B,IAAyB,EACzB,IAA8B,EAC9B,IAAiB;IAEjB,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,SAAS,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QACzE,MAAM,IAAI,KAAK,CAAC,mBAAmB,CAAC,CAAC;IACzC,CAAC;IACD,OAAO,oBAAoB,CAAC,IAAI,EAAE,IAAkB,EAAE,IAAI,IAAI,EAAE,CAAC,CAAC;AACtE,CAAC"}

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

@@ -0,0 +1,42 @@
+import type { AnchorTriple, DrawingHandle, ShapeStyle } from "@invinite-org/chartlang-core";
+/**
+ * Draw a triangle as a closed three-vertex polygon. Vertices may be
+ * supplied CW or CCW; the renderer walks them as a closed path. Not to
+ * be confused with `draw.trianglePattern` (Task 15) — that variant is
+ * the harmonic five-anchor triangle pattern.
+ *
+ * @anchors `anchors` — 3 `WorldPoint`s
+ * @anchorCount 3
+ * @bucket boxes
+ * @since 0.3
+ * @stable
+ * @example
+ *     import { defineIndicator } from "@invinite-org/chartlang-core";
+ *     export default defineIndicator({
+ *         name: "draw.triangle demo",
+ *         apiVersion: 1,
+ *         compute({ bar, draw }) {
+ *             draw.triangle(
+ *                 [
+ *                     { time: bar.time, price: bar.low },
+ *                     { time: bar.time, price: bar.high },
+ *                     { time: bar.time, price: bar.close },
+ *                 ],
+ *                 { stroke: "#ef4444", fill: "#fee2e2", fillAlpha: 0.5 },
+ *             );
+ *         },
+ *     });
+ */
+export declare function triangle(anchors: AnchorTriple, opts?: ShapeStyle): DrawingHandle;
+/**
+ * Compiler-injected overload.
+ *
+ * @since 0.3
+ * @stable
+ * @example
+ *     // Internal — the compiler rewrites every script callsite.
+ *     // const fn: typeof triangle = triangle;
+ *     // void fn;
+ */
+export declare function triangle(slotId: string, anchors: AnchorTriple, opts?: ShapeStyle): DrawingHandle;
+//# sourceMappingURL=triangle.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"triangle.d.ts","sourceRoot":"","sources":["../../../../src/emit/draw/boxes/triangle.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EACR,YAAY,EACZ,aAAa,EACb,UAAU,EAEb,MAAM,8BAA8B,CAAC;AAgBtC;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,QAAQ,CAAC,OAAO,EAAE,YAAY,EAAE,IAAI,CAAC,EAAE,UAAU,GAAG,aAAa,CAAC;AAClF;;;;;;;;;GASG;AACH,wBAAgB,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,EAAE,IAAI,CAAC,EAAE,UAAU,GAAG,aAAa,CAAC"}