@invinite-org/chartlang-adapter-kit 1.2.1 → 1.4.0

package/dist/geometry/types.d.ts

@@ -0,0 +1,146 @@
+/**
+ * A 2D point in renderer pixel space — the structural type every
+ * projection helper returns and every {@link DrawPrimitive} consumes.
+ * Read-only so decomposers can't mutate vertices they don't own.
+ *
+ * @since 1.3
+ * @stable
+ * @example
+ *     const p: Point2 = { x: 100, y: 50 };
+ *     void p;
+ */
+export type Point2 = {
+    readonly x: number;
+    readonly y: number;
+};
+/**
+ * Visible window into world coordinates. `xMin`/`xMax` are bar times in
+ * UTC milliseconds; `yMin`/`yMax` are prices in the quote currency.
+ * `pxWidth`/`pxHeight` are the renderer's drawable size in CSS pixels.
+ * Ported verbatim from the canvas2d adapter's `render/coords.ts` so all
+ * adapters share one projection contract.
+ *
+ * @since 1.3
+ * @stable
+ * @example
+ *     const vp: Viewport = {
+ *         xMin: 0, xMax: 9, yMin: 100, yMax: 110,
+ *         pxWidth: 800, pxHeight: 400,
+ *     };
+ *     void vp;
+ */
+export type Viewport = {
+    readonly xMin: number;
+    readonly xMax: number;
+    readonly yMin: number;
+    readonly yMax: number;
+    readonly pxWidth: number;
+    readonly pxHeight: number;
+};
+/**
+ * Resolved stroke styling for a {@link DrawPrimitive}. `dash` is the
+ * `setLineDash` segment array — `[]` is a solid stroke. Decomposers map
+ * a `LineStyle` to `dash` via the `_lib/dash` helper.
+ *
+ * `alpha ∈ [0, 1]` is the optional stroke opacity the painter brackets
+ * around the `stroke()` call (the `highlighter` freehand kind sets it).
+ * When omitted the stroke is fully opaque and the painter emits no
+ * `globalAlpha` mutation — so a stroke without `alpha` is byte-identical
+ * to a Task-1 stroke.
+ *
+ * @since 1.3
+ * @stable
+ * @example
+ *     const s: StrokeStyle = { color: "#000000", width: 1, dash: [] };
+ *     void s;
+ */
+export type StrokeStyle = {
+    readonly color: string;
+    readonly width: number;
+    readonly dash: ReadonlyArray<number>;
+    readonly alpha?: number;
+};
+/**
+ * Resolved fill styling for a {@link DrawPrimitive}. `alpha ∈ [0, 1]`
+ * is applied around the fill so a subsequent stroke draws at full
+ * opacity.
+ *
+ * @since 1.3
+ * @stable
+ * @example
+ *     const f: FillStyle = { color: "#dbeafe", alpha: 0.4 };
+ *     void f;
+ */
+export type FillStyle = {
+    readonly color: string;
+    readonly alpha: number;
+};
+/**
+ * Renderer-agnostic intermediate representation every drawing reduces
+ * to. {@link decomposeDrawing} returns a flat `DrawPrimitive[]`; each
+ * adapter paints the list with its own sink (canvas `paintPrimitive`,
+ * Konva nodes, ECharts `graphic`, …). The four shapes — `polyline`,
+ * `arc`, `text`, `marker` — are the smallest set all the target chart
+ * libraries can consume.
+ *
+ * - `polyline` — an open or `closed` path with optional `stroke` / `fill`.
+ * - `arc` — a circular arc centred on `(cx, cy)` from `start` to `end`
+ *   radians, with optional `stroke` / `fill`.
+ * - `text` — a single label at `(x, y)` with explicit `align` / `baseline`.
+ * - `marker` — a sized glyph at `(x, y)` (reserved for adapter / future
+ *   kinds; no basic kind emits it).
+ *
+ * @since 1.3
+ * @stable
+ * @example
+ *     const seg: DrawPrimitive = {
+ *         kind: "polyline",
+ *         points: [{ x: 0, y: 0 }, { x: 10, y: 10 }],
+ *         closed: false,
+ *         stroke: { color: "#000000", width: 1, dash: [] },
+ *     };
+ *     void seg;
+ */
+export type DrawPrimitive = {
+    readonly kind: "polyline";
+    readonly points: ReadonlyArray<Point2>;
+    readonly closed: boolean;
+    readonly stroke?: StrokeStyle;
+    readonly fill?: FillStyle;
+} | {
+    readonly kind: "arc";
+    readonly cx: number;
+    readonly cy: number;
+    readonly r: number;
+    readonly start: number;
+    readonly end: number;
+    /**
+     * Whether the painter issues `closePath()` after the arc —
+     * drawing the chord back to the arc's start. `true` only for a
+     * full-circle shape (e.g. `circle`); partial arcs (the
+     * `trend-angle` indicator, `time-cycles`) MUST be `false`, else
+     * the chord renders as a spurious diameter line.
+     */
+    readonly closed: boolean;
+    readonly stroke?: StrokeStyle;
+    readonly fill?: FillStyle;
+} | {
+    readonly kind: "text";
+    readonly x: number;
+    readonly y: number;
+    readonly text: string;
+    readonly color: string;
+    readonly font: string;
+    readonly align: "left" | "center" | "right";
+    readonly baseline: "top" | "middle" | "bottom";
+    readonly bgColor?: string;
+} | {
+    readonly kind: "marker";
+    readonly shape: "circle" | "square" | "diamond" | "triangle-up" | "triangle-down";
+    readonly x: number;
+    readonly y: number;
+    readonly size: number;
+    readonly stroke?: StrokeStyle;
+    readonly fill?: FillStyle;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/geometry/types.d.ts.map

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

package/dist/geometry/types.js

@@ -0,0 +1,4 @@
+// Copyright (c) 2026 Invinite. Licensed under the MIT License.
+// See the LICENSE file in the repo root for full license text.
+export {};
+//# sourceMappingURL=types.js.map

package/dist/geometry/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/geometry/types.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,+DAA+D","sourcesContent":["// Copyright (c) 2026 Invinite. Licensed under the MIT License.\n// See the LICENSE file in the repo root for full license text.\n\n/**\n * A 2D point in renderer pixel space — the structural type every\n * projection helper returns and every {@link DrawPrimitive} consumes.\n * Read-only so decomposers can't mutate vertices they don't own.\n *\n * @since 1.3\n * @stable\n * @example\n *     const p: Point2 = { x: 100, y: 50 };\n *     void p;\n */\nexport type Point2 = { readonly x: number; readonly y: number };\n\n/**\n * Visible window into world coordinates. `xMin`/`xMax` are bar times in\n * UTC milliseconds; `yMin`/`yMax` are prices in the quote currency.\n * `pxWidth`/`pxHeight` are the renderer's drawable size in CSS pixels.\n * Ported verbatim from the canvas2d adapter's `render/coords.ts` so all\n * adapters share one projection contract.\n *\n * @since 1.3\n * @stable\n * @example\n *     const vp: Viewport = {\n *         xMin: 0, xMax: 9, yMin: 100, yMax: 110,\n *         pxWidth: 800, pxHeight: 400,\n *     };\n *     void vp;\n */\nexport type Viewport = {\n    readonly xMin: number;\n    readonly xMax: number;\n    readonly yMin: number;\n    readonly yMax: number;\n    readonly pxWidth: number;\n    readonly pxHeight: number;\n};\n\n/**\n * Resolved stroke styling for a {@link DrawPrimitive}. `dash` is the\n * `setLineDash` segment array — `[]` is a solid stroke. Decomposers map\n * a `LineStyle` to `dash` via the `_lib/dash` helper.\n *\n * `alpha ∈ [0, 1]` is the optional stroke opacity the painter brackets\n * around the `stroke()` call (the `highlighter` freehand kind sets it).\n * When omitted the stroke is fully opaque and the painter emits no\n * `globalAlpha` mutation — so a stroke without `alpha` is byte-identical\n * to a Task-1 stroke.\n *\n * @since 1.3\n * @stable\n * @example\n *     const s: StrokeStyle = { color: \"#000000\", width: 1, dash: [] };\n *     void s;\n */\nexport type StrokeStyle = {\n    readonly color: string;\n    readonly width: number;\n    readonly dash: ReadonlyArray<number>;\n    readonly alpha?: number;\n};\n\n/**\n * Resolved fill styling for a {@link DrawPrimitive}. `alpha ∈ [0, 1]`\n * is applied around the fill so a subsequent stroke draws at full\n * opacity.\n *\n * @since 1.3\n * @stable\n * @example\n *     const f: FillStyle = { color: \"#dbeafe\", alpha: 0.4 };\n *     void f;\n */\nexport type FillStyle = { readonly color: string; readonly alpha: number };\n\n/**\n * Renderer-agnostic intermediate representation every drawing reduces\n * to. {@link decomposeDrawing} returns a flat `DrawPrimitive[]`; each\n * adapter paints the list with its own sink (canvas `paintPrimitive`,\n * Konva nodes, ECharts `graphic`, …). The four shapes — `polyline`,\n * `arc`, `text`, `marker` — are the smallest set all the target chart\n * libraries can consume.\n *\n * - `polyline` — an open or `closed` path with optional `stroke` / `fill`.\n * - `arc` — a circular arc centred on `(cx, cy)` from `start` to `end`\n *   radians, with optional `stroke` / `fill`.\n * - `text` — a single label at `(x, y)` with explicit `align` / `baseline`.\n * - `marker` — a sized glyph at `(x, y)` (reserved for adapter / future\n *   kinds; no basic kind emits it).\n *\n * @since 1.3\n * @stable\n * @example\n *     const seg: DrawPrimitive = {\n *         kind: \"polyline\",\n *         points: [{ x: 0, y: 0 }, { x: 10, y: 10 }],\n *         closed: false,\n *         stroke: { color: \"#000000\", width: 1, dash: [] },\n *     };\n *     void seg;\n */\nexport type DrawPrimitive =\n    | {\n          readonly kind: \"polyline\";\n          readonly points: ReadonlyArray<Point2>;\n          readonly closed: boolean;\n          readonly stroke?: StrokeStyle;\n          readonly fill?: FillStyle;\n      }\n    | {\n          readonly kind: \"arc\";\n          readonly cx: number;\n          readonly cy: number;\n          readonly r: number;\n          readonly start: number;\n          readonly end: number;\n          /**\n           * Whether the painter issues `closePath()` after the arc —\n           * drawing the chord back to the arc's start. `true` only for a\n           * full-circle shape (e.g. `circle`); partial arcs (the\n           * `trend-angle` indicator, `time-cycles`) MUST be `false`, else\n           * the chord renders as a spurious diameter line.\n           */\n          readonly closed: boolean;\n          readonly stroke?: StrokeStyle;\n          readonly fill?: FillStyle;\n      }\n    | {\n          readonly kind: \"text\";\n          readonly x: number;\n          readonly y: number;\n          readonly text: string;\n          readonly color: string;\n          readonly font: string;\n          readonly align: \"left\" | \"center\" | \"right\";\n          readonly baseline: \"top\" | \"middle\" | \"bottom\";\n          readonly bgColor?: string;\n      }\n    | {\n          readonly kind: \"marker\";\n          readonly shape: \"circle\" | \"square\" | \"diamond\" | \"triangle-up\" | \"triangle-down\";\n          readonly x: number;\n          readonly y: number;\n          readonly size: number;\n          readonly stroke?: StrokeStyle;\n          readonly fill?: FillStyle;\n      };\n"]}

package/dist/index.d.ts

@@ -8,5 +8,7 @@ export type { ValidationFail, ValidationOk, ValidationResult } from "./validatio
 export { mockCandleSource } from "./mocks/index.js";
 export type { MockCandleSourceMode, MockCandleSourceOpts } from "./mocks/index.js";
 export { BufferingAdapter, PassThroughAdapter } from "./base/index.js";
+export { decomposeDrawing, priceToY, timeToX, worldPointToPixel } from "./geometry/index.js";
+export type { DrawPrimitive, FillStyle, Point2, StrokeStyle, Viewport, } from "./geometry/index.js";
 export type { Adapter, AdapterSymInfo, AlertChannel, AlertConditionEmission, AlertEmission, Capabilities, CandleEvent, DiagnosticCode, DrawingCounts, DrawingEmission, DrawingKind, InputKind, LogEmission, PlotEmission, PlotKind, PlotOverride, PlotSlotDescriptor, PlotStyle, RunnerEmissions, RuntimeDiagnostic, SymInfoField, } from "./types.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AACtE,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAChF,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,YAAY,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAC3E,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACxE,YAAY,EAAE,cAAc,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAC5F,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,YAAY,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AACnF,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACvE,YAAY,EACR,OAAO,EACP,cAAc,EACd,YAAY,EACZ,sBAAsB,EACtB,aAAa,EACb,YAAY,EACZ,WAAW,EACX,cAAc,EACd,aAAa,EACb,eAAe,EACf,WAAW,EACX,SAAS,EACT,WAAW,EACX,YAAY,EACZ,QAAQ,EACR,YAAY,EACZ,kBAAkB,EAClB,SAAS,EACT,eAAe,EACf,iBAAiB,EACjB,YAAY,GACf,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AACtE,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAChF,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,YAAY,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAC3E,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACxE,YAAY,EAAE,cAAc,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAC5F,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,YAAY,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AACnF,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACvE,OAAO,EAAE,gBAAgB,EAAE,QAAQ,EAAE,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAC7F,YAAY,EACR,aAAa,EACb,SAAS,EACT,MAAM,EACN,WAAW,EACX,QAAQ,GACX,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EACR,OAAO,EACP,cAAc,EACd,YAAY,EACZ,sBAAsB,EACtB,aAAa,EACb,YAAY,EACZ,WAAW,EACX,cAAc,EACd,aAAa,EACb,eAAe,EACf,WAAW,EACX,SAAS,EACT,WAAW,EACX,YAAY,EACZ,QAAQ,EACR,YAAY,EACZ,kBAAkB,EAClB,SAAS,EACT,eAAe,EACf,iBAAiB,EACjB,YAAY,GACf,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -6,4 +6,5 @@ export { PHASE_5_PLOT_KINDS, capabilities } from "./capabilities/index.js";
 export { decodeDrawing, validateEmission } from "./validation/index.js";
 export { mockCandleSource } from "./mocks/index.js";
 export { BufferingAdapter, PassThroughAdapter } from "./base/index.js";
+export { decomposeDrawing, priceToY, timeToX, worldPointToPixel } from "./geometry/index.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,+DAA+D;AAE/D,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAEtE,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD,OAAO,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAC3E,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAExE,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEpD,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,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\nexport { KIND_BUCKET, bucketFor } from \"@invinite-org/chartlang-core\";\nexport type { DrawingBucket, DrawingState } from \"@invinite-org/chartlang-core\";\nexport { defineAdapter } from \"./defineAdapter.js\";\nexport type { DefineAdapterOpts } from \"./defineAdapter.js\";\nexport { PHASE_5_PLOT_KINDS, capabilities } from \"./capabilities/index.js\";\nexport { decodeDrawing, validateEmission } from \"./validation/index.js\";\nexport type { ValidationFail, ValidationOk, ValidationResult } from \"./validation/index.js\";\nexport { mockCandleSource } from \"./mocks/index.js\";\nexport type { MockCandleSourceMode, MockCandleSourceOpts } from \"./mocks/index.js\";\nexport { BufferingAdapter, PassThroughAdapter } from \"./base/index.js\";\nexport type {\n    Adapter,\n    AdapterSymInfo,\n    AlertChannel,\n    AlertConditionEmission,\n    AlertEmission,\n    Capabilities,\n    CandleEvent,\n    DiagnosticCode,\n    DrawingCounts,\n    DrawingEmission,\n    DrawingKind,\n    InputKind,\n    LogEmission,\n    PlotEmission,\n    PlotKind,\n    PlotOverride,\n    PlotSlotDescriptor,\n    PlotStyle,\n    RunnerEmissions,\n    RuntimeDiagnostic,\n    SymInfoField,\n} from \"./types.js\";\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,+DAA+D;AAE/D,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAEtE,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD,OAAO,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAC3E,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAExE,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEpD,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACvE,OAAO,EAAE,gBAAgB,EAAE,QAAQ,EAAE,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,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\nexport { KIND_BUCKET, bucketFor } from \"@invinite-org/chartlang-core\";\nexport type { DrawingBucket, DrawingState } from \"@invinite-org/chartlang-core\";\nexport { defineAdapter } from \"./defineAdapter.js\";\nexport type { DefineAdapterOpts } from \"./defineAdapter.js\";\nexport { PHASE_5_PLOT_KINDS, capabilities } from \"./capabilities/index.js\";\nexport { decodeDrawing, validateEmission } from \"./validation/index.js\";\nexport type { ValidationFail, ValidationOk, ValidationResult } from \"./validation/index.js\";\nexport { mockCandleSource } from \"./mocks/index.js\";\nexport type { MockCandleSourceMode, MockCandleSourceOpts } from \"./mocks/index.js\";\nexport { BufferingAdapter, PassThroughAdapter } from \"./base/index.js\";\nexport { decomposeDrawing, priceToY, timeToX, worldPointToPixel } from \"./geometry/index.js\";\nexport type {\n    DrawPrimitive,\n    FillStyle,\n    Point2,\n    StrokeStyle,\n    Viewport,\n} from \"./geometry/index.js\";\nexport type {\n    Adapter,\n    AdapterSymInfo,\n    AlertChannel,\n    AlertConditionEmission,\n    AlertEmission,\n    Capabilities,\n    CandleEvent,\n    DiagnosticCode,\n    DrawingCounts,\n    DrawingEmission,\n    DrawingKind,\n    InputKind,\n    LogEmission,\n    PlotEmission,\n    PlotKind,\n    PlotOverride,\n    PlotSlotDescriptor,\n    PlotStyle,\n    RunnerEmissions,\n    RuntimeDiagnostic,\n    SymInfoField,\n} from \"./types.js\";\n"]}

package/dist/types.d.ts

@@ -458,6 +458,40 @@ export type PlotEmission = {
      *     void hidden;
      */
     readonly visible?: boolean;
+    /**
+     * Presentation-only horizontal display shift in **bars**. Omitted (or
+     * `0`) ⇒ no shift, so a no-shift emission is byte-identical to a plot
+     * that never carried the field. `+n` shifts the plotted series `n`
+     * bars **right** (into the future); `−n` shifts it `n` bars **left**
+     * (into the past). It moves only where the series renders — `value`
+     * is the unshifted number and alert bars are unaffected. Must be a
+     * signed integer; `validateEmission` rejects a non-integer.
+     *
+     * @since 1.3
+     * @stable
+     * @example
+     *     const shifted: PlotEmission["xShift"] = -5;
+     *     void shifted;
+     */
+    readonly xShift?: number;
+    /**
+     * Presentation-only render-order key (z-index). Omitted (or `0`) ⇒ no
+     * explicit order, so the emission is byte-identical to a plot that
+     * never carried the field. Higher `z` renders on top; lower (incl.
+     * negative) renders behind. Adapters MUST compute a stable global
+     * order keyed on `(z ?? 0, groupBand, declarationSeq)` — a plot with
+     * `z` below a drawing's `z` renders beneath that drawing, crossing the
+     * default plots-under-drawings band. Any finite number (fractional
+     * allowed); `validateEmission` rejects NaN / ±Infinity. Affects only
+     * stacking — `value`, `xShift`, alerts, and `state.*` are unaffected.
+     *
+     * @since 1.4
+     * @stable
+     * @example
+     *     const behind: PlotEmission["z"] = -1;
+     *     void behind;
+     */
+    readonly z?: number;
 };
 /**
  * An `alert()` emission. `dedupeKey` is computed by the runtime
@@ -579,6 +613,26 @@ export type DrawingEmission = {
     readonly state: DrawingState;
     readonly bar: number;
     readonly time: number;
+    /**
+     * Presentation-only render-order key (z-index). Omitted (or `0`) ⇒ no
+     * explicit order, so the emission is byte-identical to a drawing that
+     * never carried the field. Higher `z` renders on top; a **negative**
+     * `z` lets a drawing render **below** `z=0` plots, crossing the
+     * default plots-under-drawings band. Adapters MUST compute a stable
+     * global order keyed on `(z ?? 0, groupBand, declarationSeq)`. Any
+     * finite number (fractional allowed); `validateEmission` rejects
+     * NaN / ±Infinity. Affects only stacking — `state.*` geometry is
+     * unaffected. `z` is part of the latest state under the per-`(handleId,
+     * bar)` last-write-wins dedup: a `create` then `update` that changes
+     * `z` takes the updated value.
+     *
+     * @since 1.4
+     * @stable
+     * @example
+     *     const beneathPlots: DrawingEmission["z"] = -1;
+     *     void beneathPlots;
+     */
+    readonly z?: number;
 };
 /**
  * Stable machine-readable diagnostic code emitted by the runtime / host

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACR,aAAa,EACb,GAAG,EACH,KAAK,EACL,aAAa,IAAI,iBAAiB,EAClC,WAAW,IAAI,eAAe,EAC9B,SAAS,IAAI,aAAa,EAC1B,QAAQ,IAAI,YAAY,EACxB,YAAY,IAAI,gBAAgB,EAChC,kBAAkB,IAAI,sBAAsB,EAC5C,YAAY,EACZ,kBAAkB,EAClB,SAAS,EACT,SAAS,EACT,QAAQ,EACR,UAAU,EACb,MAAM,8BAA8B,CAAC;AAEtC;;;;;;;;;;GAUG;AACH,MAAM,MAAM,WAAW,GACjB;IACI,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC,GAAG,CAAC,CAAC;IAClC;;;;;OAKG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC/B,GACD;IACI,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAC;IAClB;;;;;OAKG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC/B,GACD;IACI,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAC;IAClB;;;;;OAKG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC/B,CAAC;AAER;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,QAAQ,GAAG,YAAY,CAAC;AAEpC;;;;;;;;;;;;;;;GAeG;AACH,MAAM,MAAM,kBAAkB,GAAG,sBAAsB,CAAC;AAExD;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,YAAY,GAAG,gBAAgB,CAAC;AAE5C;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,MAAM,WAAW,GAAG,eAAe,CAAC;AAE1C;;;;;;;;;GASG;AACH,MAAM,MAAM,YAAY,GAAG,KAAK,GAAG,OAAO,GAAG,SAAS,GAAG,OAAO,GAAG,KAAK,GAAG,MAAM,CAAC;AAElF;;;;;;;;;GASG;AACH,MAAM,MAAM,SAAS,GAAG,aAAa,CAAC;AAEtC;;;;;;;;;GASG;AACH,MAAM,MAAM,YAAY,GAClB,QAAQ,GACR,MAAM,GACN,SAAS,GACT,UAAU,GACV,cAAc,GACd,UAAU,GACV,UAAU,GACV,SAAS,GACT,MAAM,CAAC;AAEb;;;;;;;;;;;;;GAaG;AACH,MAAM,MAAM,cAAc,GAAG,QAAQ,CAAC;IAClC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC;CAC9C,CAAC,CAAC;AAEH;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,MAAM,aAAa,GAAG,iBAAiB,CAAC;AAE9C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,MAAM,MAAM,YAAY,GAAG;IACvB,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC,QAAQ,CAAC,CAAC;IACtC,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC,WAAW,CAAC,CAAC;IAC5C,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC,YAAY,CAAC,CAAC;IAC3C;;;;;;;;;OASG;IACH,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC;IAClC;;;;;;;;OAQG;IACH,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC,SAAS,CAAC,CAAC;IACxC;;;;;;;;;;;OAWG;IACH,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAC,kBAAkB,CAAC,CAAC;IACtD;;;;;;;;;;OAUG;IACH,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;IACjC;;;;;;;;;OASG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B;;;;;;;;;OASG;IACH,QAAQ,CAAC,aAAa,EAAE,WAAW,CAAC,YAAY,CAAC,CAAC;IAClD;;;;;;;;;;;OAWG;IACH,QAAQ,CAAC,oBAAoB,EAAE,aAAa,CAAC;IAC7C,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC9B,CAAC;AAEF;;;;;;;;;;;;;;;GAeG;AACH,MAAM,MAAM,SAAS,GACf;IACI,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;CACjC,GACD;IACI,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;CACjC,GACD;IACI,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAC;IACjC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;CACjC;AACH,qEAAqE;GACnE;IACI,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC7B;AACH,4DAA4D;GAC1D;IACI,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAC9B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC9B;AACH;;2CAE2C;GACzC;IACI,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;IAC7B,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CAC1B;AACH;iBACiB;GACf;IACI,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,OAAO,GAAG,OAAO,GAAG,QAAQ,CAAC;CACnD;AACH,wDAAwD;GACtD;IACI,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,QAAQ,GAAG,aAAa,GAAG,eAAe,GAAG,QAAQ,GAAG,SAAS,CAAC;IAClF,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACzB;AACH,sEAAsE;GACpE;IACI,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,KAAK,EACR,QAAQ,GACR,aAAa,GACb,eAAe,GACf,QAAQ,GACR,SAAS,GACT,OAAO,GACP,QAAQ,GACR,MAAM,CAAC;IACb,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,GAAG,OAAO,GAAG,UAAU,CAAC;CACtD;AACH,0EAA0E;GACxE;IACI,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,GAAG,OAAO,GAAG,UAAU,CAAC;CACtD;AACH,gEAAgE;GAC9D;IACI,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,SAAS,EAAE,IAAI,GAAG,MAAM,CAAC;IAClC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACzB;AACH,kEAAkE;GAChE;IACI,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAC;IACjC,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;IACrB,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;IACrB,QAAQ,CAAC,IAAI,CAAC,EAAE,KAAK,CAAC;CACzB;AACH,kEAAkE;GAChE;IACI,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;IAC9B,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;CACzB;AACH,2DAA2D;GACzD;IACI,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IACtB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC5B;AACH,4DAA4D;GAC1D;IACI,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;CACzB;AACH,wEAAwE;GACtE;IACI,QAAQ,CAAC,IAAI,EAAE,sBAAsB,CAAC;IACtC,QAAQ,CAAC,OAAO,EAAE,aAAa,CAC3B,QAAQ,CAAC;QAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,CAAA;KAAE,CAAC,CACxF,CAAC;CACL,CAAC;AAER;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,MAAM,YAAY,GAAG;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC;IAC1B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC;IACnD,QAAQ,CAAC,IAAI,EAAE,SAAS,GAAG,KAAK,GAAG,MAAM,CAAC;IAC1C;;;;;;;;;;OAUG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;CAC9B,CAAC;AAEF;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,MAAM,aAAa,GAAG;IACxB,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC;IACjC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC;IACnD,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC,YAAY,CAAC,CAAC;IAC/C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC9B,CAAC;AAEF;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,MAAM,sBAAsB,GAAG;IACjC,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAC;IACjC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACzB,CAAC;AAEF;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,MAAM,WAAW,GAAG;IACtB,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;IACrB,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC;IACpD,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACzB,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,MAAM,eAAe,GAAG;IAC1B,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC;IAClC,QAAQ,CAAC,EAAE,EAAE,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAC;IAC5C,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;IAC7B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACzB,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,MAAM,cAAc,GACpB,uBAAuB,GACvB,0BAA0B,GAC1B,2BAA2B,GAC3B,kBAAkB,GAClB,sBAAsB,GACtB,+BAA+B,GAC/B,0BAA0B,GAC1B,mBAAmB,GACnB,yBAAyB,GACzB,mBAAmB,GACnB,uBAAuB,GACvB,gCAAgC,GAChC,yBAAyB,GACzB,oBAAoB,GACpB,6BAA6B,GAC7B,gCAAgC,GAChC,6BAA6B,GAC7B,oBAAoB,GACpB,sBAAsB,GACtB,sBAAsB,GACtB,sBAAsB,GACtB,yBAAyB,GACzB,6BAA6B,GAC7B,0BAA0B,GAC1B,4BAA4B,GAC5B,oBAAoB,GACpB,WAAW,GACX,WAAW,GACX,oBAAoB,GACpB,4BAA4B,GAC5B,aAAa,GACb,uBAAuB,CAAC;AAE9B;;;;;;;;;;;;;;;GAeG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC5B,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC;IAChD,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;IAC9B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B,CAAC;AAEF;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,MAAM,eAAe,GAAG;IAC1B,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC,YAAY,CAAC,CAAC;IAC5C,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC,eAAe,CAAC,CAAC;IAClD,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC,aAAa,CAAC,CAAC;IAC9C,QAAQ,CAAC,eAAe,EAAE,aAAa,CAAC,sBAAsB,CAAC,CAAC;IAChE,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC,WAAW,CAAC,CAAC;IAC1C,QAAQ,CAAC,WAAW,EAAE,aAAa,CAAC,iBAAiB,CAAC,CAAC;IACvD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CAC1B,CAAC;AAEF;;;;;;;;;;;;;;GAcG;AACH,MAAM,MAAM,OAAO,GAAG;IAClB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAC;IACpC;;;;;;;;;;;;OAYG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACjF;;;;;;;;;;;;;OAaG;IACH,QAAQ,CAAC,oBAAoB,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC;IAC7F;;;;;;;;;OASG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,cAAc,CAAC;IAClC,OAAO,CAAC,IAAI,EAAE;QAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,GAAG,aAAa,CAAC,WAAW,CAAC,CAAC;IAC1E,WAAW,CAAC,SAAS,EAAE,eAAe,GAAG,IAAI,CAAC;IAC9C,OAAO,IAAI,IAAI,CAAC;CACnB,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,+DAA+D","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    AlertSeverity,\n    Bar,\n    Color,\n    DrawingCounts as CoreDrawingCounts,\n    DrawingKind as CoreDrawingKind,\n    InputKind as CoreInputKind,\n    PlotKind as CorePlotKind,\n    PlotOverride as CorePlotOverride,\n    PlotSlotDescriptor as CorePlotSlotDescriptor,\n    DrawingState,\n    IntervalDescriptor,\n    JsonValue,\n    LineStyle,\n    LogLevel,\n    SymbolType,\n} from \"@invinite-org/chartlang-core\";\n\n/**\n * Adapter-supplied candle event the runtime consumes through\n * `Adapter.candles(...)`. `history` is a batched warm-up payload; `close`\n * carries a finalised bar; `tick` carries an intra-bar update that the\n * runtime applies to the current bar's head slot.\n *\n * @since 0.1\n * @stable\n * @example\n *     const evt: CandleEvent = { kind: \"history\", bars: [] };\n */\nexport type CandleEvent =\n    | {\n          readonly kind: \"history\";\n          readonly bars: ReadonlyArray<Bar>;\n          /**\n           * Secondary-stream key. Omit for the main stream; set to a\n           * requested interval value such as `\"1D\"` for MTF candles.\n           *\n           * @since 0.5\n           */\n          readonly streamKey?: string;\n      }\n    | {\n          readonly kind: \"close\";\n          readonly bar: Bar;\n          /**\n           * Secondary-stream key. Omit for the main stream; set to a\n           * requested interval value such as `\"1D\"` for MTF candles.\n           *\n           * @since 0.5\n           */\n          readonly streamKey?: string;\n      }\n    | {\n          readonly kind: \"tick\";\n          readonly bar: Bar;\n          /**\n           * Secondary-stream key. Omit for the main stream; set to a\n           * requested interval value such as `\"1D\"` for MTF candles.\n           *\n           * @since 0.5\n           */\n          readonly streamKey?: string;\n      };\n\n/**\n * Indicator plot styles Phase 1 ships. Re-exported from\n * `@invinite-org/chartlang-core` so the script-facing and adapter-facing\n * surfaces stay in lock-step — the full PLAN §7.2 set lands in Phase 2+,\n * additively, in the core declaration. Pinned set — additive only across\n * `apiVersion: 1.x`.\n *\n * @since 0.1\n * @stable\n * @example\n *     const k: PlotKind = \"line\";\n */\nexport type PlotKind = CorePlotKind;\n\n/**\n * One plotted-slot descriptor in `ScriptManifest.plots`. Re-exported\n * from `@invinite-org/chartlang-core` so the script-facing and\n * adapter-facing surfaces stay in lockstep — adapter authors key\n * style/visibility UI rows by the stable `slotId`.\n *\n * @since 0.8\n * @stable\n * @example\n *     const slot: PlotSlotDescriptor = {\n *         slotId: \"ema.ts:12:5#0\",\n *         kind: \"line\",\n *         title: \"EMA\",\n *     };\n *     void slot;\n */\nexport type PlotSlotDescriptor = CorePlotSlotDescriptor;\n\n/**\n * Host-supplied presentation override for a single plot slot, keyed by\n * `PlotEmission.slotId`. Re-exported from `@invinite-org/chartlang-core`\n * so adapter authors and hosts share the same shape. Applied by the\n * runtime at emit time; never affects `compute`.\n *\n * @since 0.8\n * @stable\n * @example\n *     const override: PlotOverride = { visible: false, color: \"#ff0000\" };\n *     void override;\n */\nexport type PlotOverride = CorePlotOverride;\n\n/**\n * Drawing kind discriminator. Phase 3 widens the Phase-1 `\"line\"`\n * placeholder to the full 61-entry kebab-case union — re-exported from\n * `@invinite-org/chartlang-core`. The wire format is kebab-case; the\n * camelCase TypeScript surface (`draw.horizontalLine`,\n * `draw.fibRetracement`, …) is pinned via core's\n * `KIND_CAMELCASE` / `KIND_KEBABCASE` bijection. Phase-1 / Phase-2\n * adapter code that wrote `drawingKind: \"line\"` keeps compiling — the\n * widening is purely additive. Pinned set — additive only across\n * `apiVersion: 1.x`.\n *\n * @since 0.1\n * @stable\n * @example\n *     const k: DrawingKind = \"fib-retracement\";\n *     void k;\n */\nexport type DrawingKind = CoreDrawingKind;\n\n/**\n * Channels an alert emission can be dispatched on. Adapters declare the\n * subset they support via `Capabilities.alerts`; emissions to unsupported\n * channels drop with `unsupported-alert-channel`.\n *\n * @since 0.1\n * @stable\n * @example\n *     const c: AlertChannel = \"toast\";\n */\nexport type AlertChannel = \"log\" | \"toast\" | \"webhook\" | \"email\" | \"sms\" | \"push\";\n\n/**\n * Input families an adapter is willing to surface in the script-settings\n * UI. Phase-1 example scripts use defaults only; `input.*` runtime\n * resolution lands in Phase 4.\n *\n * @since 0.1\n * @stable\n * @example\n *     const k: InputKind = \"int\";\n */\nexport type InputKind = CoreInputKind;\n\n/**\n * `syminfo.*` fields the adapter populates. Phase-1 scripts don't read\n * symbol metadata; the type is here so consumer-repo adapters can pin\n * against a stable shape now.\n *\n * @since 0.1\n * @stable\n * @example\n *     const f: SymInfoField = \"ticker\";\n */\nexport type SymInfoField =\n    | \"ticker\"\n    | \"type\"\n    | \"mintick\"\n    | \"currency\"\n    | \"basecurrency\"\n    | \"exchange\"\n    | \"timezone\"\n    | \"session\"\n    | \"meta\";\n\n/**\n * Adapter-supplied per-mount symbol metadata payload consumed by the\n * runtime's `syminfo.*` view builder.\n *\n * @since 0.4\n * @stable\n * @example\n *     const info: AdapterSymInfo = {\n *         ticker: \"DEMO\",\n *         type: \"equity\",\n *         mintick: 0.01,\n *     };\n *     void info;\n */\nexport type AdapterSymInfo = Readonly<{\n    ticker?: string;\n    type?: SymbolType;\n    mintick?: number;\n    currency?: string;\n    basecurrency?: string;\n    exchange?: string;\n    timezone?: string;\n    session?: string;\n    meta?: Readonly<Record<string, JsonValue>>;\n}>;\n\n/**\n * Per-script drawing-emission budget. Excess `draw.*` calls fall back to\n * no-op + `drawing-budget-exceeded`. Mirrors Pine's `max_*_count` family.\n *\n * Canonical declaration lives in `@invinite-org/chartlang-core/types`\n * (Phase 3) so `ScriptManifest.maxDrawings?` and\n * `Capabilities.maxDrawingsPerScript` pin the same shape — the public\n * surface here is preserved via a type re-export. The re-export\n * preserves the `adapter-kit → core` dependency direction.\n *\n * @since 0.1\n * @stable\n * @example\n *     const c: DrawingCounts = {\n *         lines: 50, labels: 50, boxes: 50, polylines: 50, other: 50,\n *     };\n *     void c;\n */\nexport type DrawingCounts = CoreDrawingCounts;\n\n/**\n * Capability bag an adapter declares. The runtime, host-worker, and\n * editor all gate emissions through this shape. Primitives outside the\n * declared set become silent no-ops + diagnostic (PLAN §7.4).\n * Capability keys are pinned — additive only across `apiVersion: 1.x`.\n *\n * Phase 1 omits `feedExternalSeries`-related `inputs` entries from any\n * declared subset; Phase 4 wires the surface.\n *\n * @since 0.1\n * @stable\n * @example\n *     const c: Capabilities = {\n *         plots: new Set([\"line\"]),\n *         drawings: new Set(),\n *         alerts: new Set([\"toast\"]),\n *         alertConditions: false,\n *         logs: false,\n *         inputs: new Set(),\n *         intervals: [],\n *         multiTimeframe: false,\n *         subPanes: 0,\n *         symInfoFields: new Set(),\n *         maxDrawingsPerScript: {\n *             lines: 0, labels: 0, boxes: 0, polylines: 0, other: 0,\n *         },\n *         maxLookback: 5000,\n *         maxTickHz: 10,\n *     };\n */\nexport type Capabilities = {\n    readonly plots: ReadonlySet<PlotKind>;\n    readonly drawings: ReadonlySet<DrawingKind>;\n    readonly alerts: ReadonlySet<AlertChannel>;\n    /**\n     * Whether the adapter can route `defineAlertCondition` user-wired\n     * alerts per PLAN §11.2.\n     *\n     * @since 0.4\n     * @stable\n     * @example\n     *     const enabled: Capabilities[\"alertConditions\"] = false;\n     *     void enabled;\n     */\n    readonly alertConditions: boolean;\n    /**\n     * Whether the adapter renders `runtime.log.*` messages per PLAN §11.3.\n     *\n     * @since 0.4\n     * @stable\n     * @example\n     *     const enabled: Capabilities[\"logs\"] = false;\n     *     void enabled;\n     */\n    readonly logs: boolean;\n    readonly inputs: ReadonlySet<InputKind>;\n    /**\n     * Timeframes this adapter can deliver candles for. Order is meaningful\n     * for editor pickers and `request.security` validation (PLAN §4.5).\n     *\n     * @since 0.4\n     * @stable\n     * @example\n     *     const intervals: Capabilities[\"intervals\"] = [\n     *         { value: \"1D\", label: \"1 day\", group: \"daily\" },\n     *     ];\n     *     void intervals;\n     */\n    readonly intervals: ReadonlyArray<IntervalDescriptor>;\n    /**\n     * Whether the adapter can deliver more than one candle stream per script\n     * load. `false` triggers the Phase 4 all-NaN fallback for\n     * `request.security` (PLAN §4.5).\n     *\n     * @since 0.4\n     * @stable\n     * @example\n     *     const enabled: Capabilities[\"multiTimeframe\"] = false;\n     *     void enabled;\n     */\n    readonly multiTimeframe: boolean;\n    /**\n     * Max number of sub-panes the adapter can render for one script. Use\n     * `Number.MAX_SAFE_INTEGER` as the unlimited sentinel per PLAN §7.2.\n     *\n     * @since 0.4\n     * @stable\n     * @example\n     *     const max: Capabilities[\"subPanes\"] = Number.MAX_SAFE_INTEGER;\n     *     void max;\n     */\n    readonly subPanes: number;\n    /**\n     * `syminfo.*` fields this adapter populates. Missing fields evaluate to\n     * empty sentinels per PLAN §4.8.\n     *\n     * @since 0.4\n     * @stable\n     * @example\n     *     const fields: Capabilities[\"symInfoFields\"] = new Set([\"ticker\"]);\n     *     void fields;\n     */\n    readonly symInfoFields: ReadonlySet<SymInfoField>;\n    /**\n     * Per-script drawing-emission budget consumed by runtime drawing gates\n     * and bucketed by PLAN §10 drawing categories.\n     *\n     * @since 0.4\n     * @stable\n     * @example\n     *     const counts: Capabilities[\"maxDrawingsPerScript\"] = {\n     *         lines: 50, labels: 50, boxes: 50, polylines: 50, other: 50,\n     *     };\n     *     void counts;\n     */\n    readonly maxDrawingsPerScript: DrawingCounts;\n    readonly maxLookback: number;\n    readonly maxTickHz: number;\n};\n\n/**\n * Plot style discriminated union. Phase 1 shipped `line` / `step-line` /\n * `horizontal-line`; Phase 2 adds `histogram` / `area` /\n * `filled-band` / `label` / `marker` per PLAN §7.3. Phase 5 will extend\n * further (`shape`, `character`, `arrow`, `vertical-line`,\n * `bar-override`, …). Every expansion is additive — `apiVersion: 1`\n * scripts stay valid.\n *\n * @since 0.1\n * @stable\n * @example\n *     const line: PlotStyle = { kind: \"line\", lineWidth: 1, lineStyle: \"solid\" };\n *     const hist: PlotStyle = { kind: \"histogram\", baseline: 0 };\n *     const band: PlotStyle = { kind: \"filled-band\", upper: 1, lower: -1, alpha: 0.2 };\n *     void line; void hist; void band;\n */\nexport type PlotStyle =\n    | {\n          readonly kind: \"line\";\n          readonly lineWidth: number;\n          readonly lineStyle: LineStyle;\n      }\n    | {\n          readonly kind: \"step-line\";\n          readonly lineWidth: number;\n          readonly lineStyle: LineStyle;\n      }\n    | {\n          readonly kind: \"horizontal-line\";\n          readonly lineWidth: number;\n          readonly lineStyle: LineStyle;\n      }\n    /** Phase 2 — column rising from `baseline` to `value`. @since 0.2 */\n    | {\n          readonly kind: \"histogram\";\n          readonly baseline: number;\n      }\n    /** Phase 2 — filled polygon under a polyline. @since 0.2 */\n    | {\n          readonly kind: \"area\";\n          readonly lineWidth: number;\n          readonly lineStyle: LineStyle;\n          readonly fillAlpha: number;\n      }\n    /** Phase 2 — region between two polylines. `upper` / `lower` may be\n     *  `null` to mark a per-bar gap; both `null` is rejected by\n     *  {@link validateEmission}. @since 0.2 */\n    | {\n          readonly kind: \"filled-band\";\n          readonly upper: number | null;\n          readonly lower: number | null;\n          readonly alpha: number;\n      }\n    /** Phase 2 — text annotation anchored above / below / at the value.\n     *  @since 0.2 */\n    | {\n          readonly kind: \"label\";\n          readonly text: string;\n          readonly position: \"above\" | \"below\" | \"anchor\";\n      }\n    /** Phase 2 — discrete glyph at the value. @since 0.2 */\n    | {\n          readonly kind: \"marker\";\n          readonly shape: \"circle\" | \"triangle-up\" | \"triangle-down\" | \"square\" | \"diamond\";\n          readonly size: number;\n      }\n    /** Phase 5 — Pine `plotshape` glyph at the plot anchor. @since 0.5 */\n    | {\n          readonly kind: \"shape\";\n          readonly shape:\n              | \"circle\"\n              | \"triangle-up\"\n              | \"triangle-down\"\n              | \"square\"\n              | \"diamond\"\n              | \"cross\"\n              | \"xcross\"\n              | \"flag\";\n          readonly size: number;\n          readonly location?: \"above\" | \"below\" | \"absolute\";\n      }\n    /** Phase 5 — Pine `plotchar` text glyph at the plot anchor. @since 0.5 */\n    | {\n          readonly kind: \"character\";\n          readonly char: string;\n          readonly size: number;\n          readonly location?: \"above\" | \"below\" | \"absolute\";\n      }\n    /** Phase 5 — Pine `plotarrow` directional marker. @since 0.5 */\n    | {\n          readonly kind: \"arrow\";\n          readonly direction: \"up\" | \"down\";\n          readonly size: number;\n      }\n    /** Phase 5 — Pine `plotcandle` body-color override. @since 0.5 */\n    | {\n          readonly kind: \"candle-override\";\n          readonly bull: Color;\n          readonly bear: Color;\n          readonly doji?: Color;\n      }\n    /** Phase 5 — Pine `plotbar` outline-color override. @since 0.5 */\n    | {\n          readonly kind: \"bar-override\";\n          readonly color: Color;\n      }\n    /** Phase 5 — Pine `bgcolor` background band. @since 0.5 */\n    | {\n          readonly kind: \"bg-color\";\n          readonly color: Color;\n          readonly transp?: number;\n      }\n    /** Phase 5 — Pine `barcolor` candle/bar tint. @since 0.5 */\n    | {\n          readonly kind: \"bar-color\";\n          readonly color: Color;\n      }\n    /** Phase 5 — volume-profile horizontal histogram buckets. @since 0.5 */\n    | {\n          readonly kind: \"horizontal-histogram\";\n          readonly buckets: ReadonlyArray<\n              Readonly<{ readonly price: number; readonly volume: number; readonly color?: Color }>\n          >;\n      };\n\n/**\n * A `plot()` / `hline()` emission the runtime sends to the adapter.\n * Numeric `value: null` is the wire-level \"skip this bar\" — NaN/Infinity\n * are forbidden in `value` and anywhere in `meta` (PLAN §7.3 universal\n * payload rules).\n *\n * @since 0.1\n * @stable\n * @example\n *     const e: PlotEmission = {\n *         kind: \"plot\",\n *         slotId: \"ema-cross.ts:12:5#0\",\n *         title: \"EMA\",\n *         style: { kind: \"line\", lineWidth: 1, lineStyle: \"solid\" },\n *         bar: 100,\n *         time: 1_700_000_000_000,\n *         value: 42.31,\n *         color: \"#3b82f6\",\n *         meta: {},\n *         pane: \"overlay\",\n *     };\n */\nexport type PlotEmission = {\n    readonly kind: \"plot\";\n    readonly slotId: string;\n    readonly title: string;\n    readonly style: PlotStyle;\n    readonly bar: number;\n    readonly time: number;\n    readonly value: number | null;\n    readonly color: string | null;\n    readonly meta: Readonly<Record<string, JsonValue>>;\n    readonly pane: \"overlay\" | \"new\" | string;\n    /**\n     * Omitted ⇒ visible. Set to `false` by the runtime when a host\n     * override hides this slot; the adapter SHOULD skip rendering and\n     * y-scale inclusion but keep the slot listed.\n     *\n     * @since 0.8\n     * @stable\n     * @example\n     *     const hidden: PlotEmission[\"visible\"] = false;\n     *     void hidden;\n     */\n    readonly visible?: boolean;\n};\n\n/**\n * An `alert()` emission. `dedupeKey` is computed by the runtime\n * (`slotId + bar + hash(message + meta)`) and adapters that dispatch\n * via async channels MUST use it for idempotency.\n *\n * @since 0.1\n * @stable\n * @example\n *     const e: AlertEmission = {\n *         kind: \"alert\",\n *         slotId: \"rsi.ts:42:1#0\",\n *         severity: \"warning\",\n *         message: \"RSI divergence\",\n *         bar: 200,\n *         time: 1_700_000_000_000,\n *         meta: {},\n *         channels: [\"toast\"],\n *         dedupeKey: \"rsi.ts:42:1#0|200|deadbeef\",\n *     };\n */\nexport type AlertEmission = {\n    readonly kind: \"alert\";\n    readonly slotId: string;\n    readonly severity: AlertSeverity;\n    readonly message: string;\n    readonly bar: number;\n    readonly time: number;\n    readonly meta: Readonly<Record<string, JsonValue>>;\n    readonly channels: ReadonlyArray<AlertChannel>;\n    readonly dedupeKey: string;\n};\n\n/**\n * Per-bar emission produced by `ComputeContext.signal(conditionId, fired)`.\n * Adapters route these named, user-wired conditions to delivery channels\n * configured in their own UI.\n *\n * @since 0.5\n * @stable\n * @example\n *     const e: AlertConditionEmission = {\n *         kind: \"alert-condition\",\n *         conditionId: \"bullishCross\",\n *         title: \"Bullish cross\",\n *         description: \"Fast EMA crossed above slow EMA\",\n *         defaultMessage: \"{{ticker}} crossed up\",\n *         fired: true,\n *         bar: 42,\n *         time: 1_700_000_000_000,\n *     };\n *     void e;\n */\nexport type AlertConditionEmission = {\n    readonly kind: \"alert-condition\";\n    readonly conditionId: string;\n    readonly title: string;\n    readonly description: string;\n    readonly defaultMessage: string;\n    readonly fired: boolean;\n    readonly bar: number;\n    readonly time: number;\n};\n\n/**\n * Per-bar debug log produced by `runtime.log.info/warn/error(...)`.\n * Logs are capability-gated by `Capabilities.logs`; disabled logs are\n * silent no-ops because they are debugging output rather than signal.\n *\n * @since 0.5\n * @stable\n * @example\n *     const e: LogEmission = {\n *         kind: \"log\",\n *         level: \"info\",\n *         message: \"ema warmed\",\n *         meta: { ema: 42 },\n *         bar: 10,\n *         time: 1_700_000_000_000,\n *     };\n *     void e;\n */\nexport type LogEmission = {\n    readonly kind: \"log\";\n    readonly level: LogLevel;\n    readonly message: string;\n    readonly meta?: Readonly<Record<string, JsonValue>>;\n    readonly bar: number;\n    readonly time: number;\n};\n\n/**\n * A `draw.*` emission. Phase 3 narrows `state` from `unknown` to the\n * typed {@link DrawingState} discriminated union. `op: \"create\"`\n * carries the initial state; `op: \"update\"` carries the FULL merged\n * state per the §10.3 full-state semantic (not a patch); `op:\n * \"remove\"` carries the last-known state.\n *\n * @since 0.1\n * @stable\n * @example\n *     const e: DrawingEmission = {\n *         kind: \"drawing\",\n *         handleId: \"ph3.ts:1:1#0\",\n *         drawingKind: \"line\",\n *         op: \"create\",\n *         state: {\n *             kind: \"line\",\n *             anchors: [{ time: 0, price: 0 }, { time: 1, price: 1 }],\n *             style: {},\n *         },\n *         bar: 0,\n *         time: 0,\n *     };\n *     void e;\n */\nexport type DrawingEmission = {\n    readonly kind: \"drawing\";\n    readonly handleId: string;\n    readonly drawingKind: DrawingKind;\n    readonly op: \"create\" | \"update\" | \"remove\";\n    readonly state: DrawingState;\n    readonly bar: number;\n    readonly time: number;\n};\n\n/**\n * Stable machine-readable diagnostic code emitted by the runtime / host\n * when an emission is dropped, an input fails coercion, or a budget is\n * exceeded. Pinned set — additive only across `apiVersion: 1.x`.\n *\n * Phase 7 adds the `dep-*` family covering compile-time and runtime\n * failures of the indicator-composition surface introduced by\n * `CompiledScriptObject.output` / `.withInputs`:\n *\n * - `dep-error` — dependency `compute` threw; parent's bar dropped.\n * - `dep-cycle` — compile-time dependency cycle detected.\n * - `dep-unknown-output` — `<binding>.output(\"x\")` references a title\n *   the producer doesn't emit via `plot(value, { title })`.\n * - `dep-invalid-input-override` — `.withInputs({...})` carries a key\n *   not in the producer's `inputs` schema, or fails coercion.\n * - `dep-dynamic` — dep binding cannot be statically resolved\n *   (non-`const`, conditional initialiser, computed access).\n * - `dep-output-not-titled` — producer's `plot(...)` has no `title`,\n *   so consumers cannot reference it by name.\n *\n * @since 0.1\n * @stable\n * @example\n *     const code: DiagnosticCode = \"unsupported-plot-kind\";\n *     const dep: DiagnosticCode = \"dep-cycle\";\n *     void code;\n *     void dep;\n */\nexport type DiagnosticCode =\n    | \"unsupported-plot-kind\"\n    | \"unsupported-drawing-kind\"\n    | \"unsupported-alert-channel\"\n    | \"unsupported-pane\"\n    | \"unsupported-interval\"\n    | \"multi-timeframe-not-supported\"\n    | \"unknown-secondary-stream\"\n    | \"lookback-exceeded\"\n    | \"drawing-budget-exceeded\"\n    | \"dropped-by-policy\"\n    | \"input-coercion-failed\"\n    | \"alert-conditions-not-supported\"\n    | \"unknown-alert-condition\"\n    | \"alert-rate-limited\"\n    | \"runtime-cpu-budget-exceeded\"\n    | \"runtime-memory-budget-exceeded\"\n    | \"runtime-log-budget-exceeded\"\n    | \"malformed-log-meta\"\n    | \"runtime-error-thrown\"\n    | \"session-info-missing\"\n    | \"fixed-range-inverted\"\n    | \"state-snapshot-restored\"\n    | \"state-snapshot-future-dated\"\n    | \"state-snapshot-malformed\"\n    | \"state-snapshot-save-failed\"\n    | \"malformed-emission\"\n    | \"dep-error\"\n    | \"dep-cycle\"\n    | \"dep-unknown-output\"\n    | \"dep-invalid-input-override\"\n    | \"dep-dynamic\"\n    | \"dep-output-not-titled\";\n\n/**\n * A non-rendered diagnostic the runtime / host surfaces to the editor +\n * error reporters. Never user-visible on its own.\n *\n * @since 0.1\n * @stable\n * @example\n *     const d: RuntimeDiagnostic = {\n *         kind: \"diagnostic\",\n *         severity: \"warning\",\n *         code: \"unsupported-plot-kind\",\n *         message: \"plot kind 'area' not in adapter capabilities\",\n *         slotId: \"ema.ts:1:1#0\",\n *         bar: 10,\n *     };\n */\nexport type RuntimeDiagnostic = {\n    readonly kind: \"diagnostic\";\n    readonly severity: \"info\" | \"warning\" | \"error\";\n    readonly code: DiagnosticCode;\n    readonly message: string;\n    readonly slotId: string | null;\n    readonly bar: number | null;\n};\n\n/**\n * Top-level drain payload the runtime hands `Adapter.onEmissions(...)`.\n * Phase 1 ships `plots` / `drawings` / `alerts` / `diagnostics`; Phase 5\n * additively adds `alertConditions` + `logs` (per PLAN §7.3).\n *\n * @since 0.1\n * @stable\n * @example\n *     const e: RunnerEmissions = {\n *         plots: [],\n *         drawings: [],\n *         alerts: [],\n *         alertConditions: [],\n *         logs: [],\n *         diagnostics: [],\n *         fromBar: 0,\n *         toBar: 0,\n *     };\n */\nexport type RunnerEmissions = {\n    readonly plots: ReadonlyArray<PlotEmission>;\n    readonly drawings: ReadonlyArray<DrawingEmission>;\n    readonly alerts: ReadonlyArray<AlertEmission>;\n    readonly alertConditions: ReadonlyArray<AlertConditionEmission>;\n    readonly logs: ReadonlyArray<LogEmission>;\n    readonly diagnostics: ReadonlyArray<RuntimeDiagnostic>;\n    readonly fromBar: number;\n    readonly toBar: number;\n};\n\n/**\n * The host-side contract every chartlang adapter implements. Phase 1\n * omits PLAN §7.1's optional `feedExternalSeries?` — that surface\n * arrives in Phase 4 alongside `input.external-series`. The shape is\n * additive, so consumer-repo adapters won't need a breaking change to\n * opt in later.\n *\n * @since 0.1\n * @stable\n * @example\n *     declare const a: Adapter;\n *     for await (const e of a.candles({ interval: \"chart\" })) {\n *         void e;\n *     }\n */\nexport type Adapter = {\n    readonly id: string;\n    readonly name: string;\n    readonly capabilities: Capabilities;\n    /**\n     * Optional per-script input override resolver. Called by hosts at script\n     * mount with the script id/name and merged over manifest defaults by the\n     * runtime.\n     *\n     * @since 0.4\n     * @stable\n     * @example\n     *     const resolveInputs: Adapter[\"resolveInputs\"] = (scriptId) => ({\n     *         length: scriptId === \"demo\" ? 20 : 14,\n     *     });\n     *     void resolveInputs;\n     */\n    readonly resolveInputs?: (scriptId: string) => Readonly<Record<string, unknown>>;\n    /**\n     * Optional per-script plot-override resolver. Called by hosts at\n     * mount with the script id/name; returns a `slotId → PlotOverride`\n     * map the runtime applies to emissions. Presentation-only — never\n     * affects `compute`. Hosts may also push live updates after mount\n     * (see `ScriptHost.setPlotOverrides`).\n     *\n     * @since 0.8\n     * @stable\n     * @example\n     *     const resolvePlotOverrides: Adapter[\"resolvePlotOverrides\"] =\n     *         () => ({ \"ema.ts:12:5#0\": { visible: false } });\n     *     void resolvePlotOverrides;\n     */\n    readonly resolvePlotOverrides?: (scriptId: string) => Readonly<Record<string, PlotOverride>>;\n    /**\n     * Optional per-mount symbol metadata payload used to populate\n     * `syminfo.*`. Fields are still gated by `capabilities.symInfoFields`.\n     *\n     * @since 0.4\n     * @stable\n     * @example\n     *     const info: Adapter[\"symInfo\"] = { ticker: \"DEMO\" };\n     *     void info;\n     */\n    readonly symInfo?: AdapterSymInfo;\n    candles(opts: { interval: string | \"chart\" }): AsyncIterable<CandleEvent>;\n    onEmissions(emissions: RunnerEmissions): void;\n    dispose(): void;\n};\n"]}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,+DAA+D","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    AlertSeverity,\n    Bar,\n    Color,\n    DrawingCounts as CoreDrawingCounts,\n    DrawingKind as CoreDrawingKind,\n    InputKind as CoreInputKind,\n    PlotKind as CorePlotKind,\n    PlotOverride as CorePlotOverride,\n    PlotSlotDescriptor as CorePlotSlotDescriptor,\n    DrawingState,\n    IntervalDescriptor,\n    JsonValue,\n    LineStyle,\n    LogLevel,\n    SymbolType,\n} from \"@invinite-org/chartlang-core\";\n\n/**\n * Adapter-supplied candle event the runtime consumes through\n * `Adapter.candles(...)`. `history` is a batched warm-up payload; `close`\n * carries a finalised bar; `tick` carries an intra-bar update that the\n * runtime applies to the current bar's head slot.\n *\n * @since 0.1\n * @stable\n * @example\n *     const evt: CandleEvent = { kind: \"history\", bars: [] };\n */\nexport type CandleEvent =\n    | {\n          readonly kind: \"history\";\n          readonly bars: ReadonlyArray<Bar>;\n          /**\n           * Secondary-stream key. Omit for the main stream; set to a\n           * requested interval value such as `\"1D\"` for MTF candles.\n           *\n           * @since 0.5\n           */\n          readonly streamKey?: string;\n      }\n    | {\n          readonly kind: \"close\";\n          readonly bar: Bar;\n          /**\n           * Secondary-stream key. Omit for the main stream; set to a\n           * requested interval value such as `\"1D\"` for MTF candles.\n           *\n           * @since 0.5\n           */\n          readonly streamKey?: string;\n      }\n    | {\n          readonly kind: \"tick\";\n          readonly bar: Bar;\n          /**\n           * Secondary-stream key. Omit for the main stream; set to a\n           * requested interval value such as `\"1D\"` for MTF candles.\n           *\n           * @since 0.5\n           */\n          readonly streamKey?: string;\n      };\n\n/**\n * Indicator plot styles Phase 1 ships. Re-exported from\n * `@invinite-org/chartlang-core` so the script-facing and adapter-facing\n * surfaces stay in lock-step — the full PLAN §7.2 set lands in Phase 2+,\n * additively, in the core declaration. Pinned set — additive only across\n * `apiVersion: 1.x`.\n *\n * @since 0.1\n * @stable\n * @example\n *     const k: PlotKind = \"line\";\n */\nexport type PlotKind = CorePlotKind;\n\n/**\n * One plotted-slot descriptor in `ScriptManifest.plots`. Re-exported\n * from `@invinite-org/chartlang-core` so the script-facing and\n * adapter-facing surfaces stay in lockstep — adapter authors key\n * style/visibility UI rows by the stable `slotId`.\n *\n * @since 0.8\n * @stable\n * @example\n *     const slot: PlotSlotDescriptor = {\n *         slotId: \"ema.ts:12:5#0\",\n *         kind: \"line\",\n *         title: \"EMA\",\n *     };\n *     void slot;\n */\nexport type PlotSlotDescriptor = CorePlotSlotDescriptor;\n\n/**\n * Host-supplied presentation override for a single plot slot, keyed by\n * `PlotEmission.slotId`. Re-exported from `@invinite-org/chartlang-core`\n * so adapter authors and hosts share the same shape. Applied by the\n * runtime at emit time; never affects `compute`.\n *\n * @since 0.8\n * @stable\n * @example\n *     const override: PlotOverride = { visible: false, color: \"#ff0000\" };\n *     void override;\n */\nexport type PlotOverride = CorePlotOverride;\n\n/**\n * Drawing kind discriminator. Phase 3 widens the Phase-1 `\"line\"`\n * placeholder to the full 61-entry kebab-case union — re-exported from\n * `@invinite-org/chartlang-core`. The wire format is kebab-case; the\n * camelCase TypeScript surface (`draw.horizontalLine`,\n * `draw.fibRetracement`, …) is pinned via core's\n * `KIND_CAMELCASE` / `KIND_KEBABCASE` bijection. Phase-1 / Phase-2\n * adapter code that wrote `drawingKind: \"line\"` keeps compiling — the\n * widening is purely additive. Pinned set — additive only across\n * `apiVersion: 1.x`.\n *\n * @since 0.1\n * @stable\n * @example\n *     const k: DrawingKind = \"fib-retracement\";\n *     void k;\n */\nexport type DrawingKind = CoreDrawingKind;\n\n/**\n * Channels an alert emission can be dispatched on. Adapters declare the\n * subset they support via `Capabilities.alerts`; emissions to unsupported\n * channels drop with `unsupported-alert-channel`.\n *\n * @since 0.1\n * @stable\n * @example\n *     const c: AlertChannel = \"toast\";\n */\nexport type AlertChannel = \"log\" | \"toast\" | \"webhook\" | \"email\" | \"sms\" | \"push\";\n\n/**\n * Input families an adapter is willing to surface in the script-settings\n * UI. Phase-1 example scripts use defaults only; `input.*` runtime\n * resolution lands in Phase 4.\n *\n * @since 0.1\n * @stable\n * @example\n *     const k: InputKind = \"int\";\n */\nexport type InputKind = CoreInputKind;\n\n/**\n * `syminfo.*` fields the adapter populates. Phase-1 scripts don't read\n * symbol metadata; the type is here so consumer-repo adapters can pin\n * against a stable shape now.\n *\n * @since 0.1\n * @stable\n * @example\n *     const f: SymInfoField = \"ticker\";\n */\nexport type SymInfoField =\n    | \"ticker\"\n    | \"type\"\n    | \"mintick\"\n    | \"currency\"\n    | \"basecurrency\"\n    | \"exchange\"\n    | \"timezone\"\n    | \"session\"\n    | \"meta\";\n\n/**\n * Adapter-supplied per-mount symbol metadata payload consumed by the\n * runtime's `syminfo.*` view builder.\n *\n * @since 0.4\n * @stable\n * @example\n *     const info: AdapterSymInfo = {\n *         ticker: \"DEMO\",\n *         type: \"equity\",\n *         mintick: 0.01,\n *     };\n *     void info;\n */\nexport type AdapterSymInfo = Readonly<{\n    ticker?: string;\n    type?: SymbolType;\n    mintick?: number;\n    currency?: string;\n    basecurrency?: string;\n    exchange?: string;\n    timezone?: string;\n    session?: string;\n    meta?: Readonly<Record<string, JsonValue>>;\n}>;\n\n/**\n * Per-script drawing-emission budget. Excess `draw.*` calls fall back to\n * no-op + `drawing-budget-exceeded`. Mirrors Pine's `max_*_count` family.\n *\n * Canonical declaration lives in `@invinite-org/chartlang-core/types`\n * (Phase 3) so `ScriptManifest.maxDrawings?` and\n * `Capabilities.maxDrawingsPerScript` pin the same shape — the public\n * surface here is preserved via a type re-export. The re-export\n * preserves the `adapter-kit → core` dependency direction.\n *\n * @since 0.1\n * @stable\n * @example\n *     const c: DrawingCounts = {\n *         lines: 50, labels: 50, boxes: 50, polylines: 50, other: 50,\n *     };\n *     void c;\n */\nexport type DrawingCounts = CoreDrawingCounts;\n\n/**\n * Capability bag an adapter declares. The runtime, host-worker, and\n * editor all gate emissions through this shape. Primitives outside the\n * declared set become silent no-ops + diagnostic (PLAN §7.4).\n * Capability keys are pinned — additive only across `apiVersion: 1.x`.\n *\n * Phase 1 omits `feedExternalSeries`-related `inputs` entries from any\n * declared subset; Phase 4 wires the surface.\n *\n * @since 0.1\n * @stable\n * @example\n *     const c: Capabilities = {\n *         plots: new Set([\"line\"]),\n *         drawings: new Set(),\n *         alerts: new Set([\"toast\"]),\n *         alertConditions: false,\n *         logs: false,\n *         inputs: new Set(),\n *         intervals: [],\n *         multiTimeframe: false,\n *         subPanes: 0,\n *         symInfoFields: new Set(),\n *         maxDrawingsPerScript: {\n *             lines: 0, labels: 0, boxes: 0, polylines: 0, other: 0,\n *         },\n *         maxLookback: 5000,\n *         maxTickHz: 10,\n *     };\n */\nexport type Capabilities = {\n    readonly plots: ReadonlySet<PlotKind>;\n    readonly drawings: ReadonlySet<DrawingKind>;\n    readonly alerts: ReadonlySet<AlertChannel>;\n    /**\n     * Whether the adapter can route `defineAlertCondition` user-wired\n     * alerts per PLAN §11.2.\n     *\n     * @since 0.4\n     * @stable\n     * @example\n     *     const enabled: Capabilities[\"alertConditions\"] = false;\n     *     void enabled;\n     */\n    readonly alertConditions: boolean;\n    /**\n     * Whether the adapter renders `runtime.log.*` messages per PLAN §11.3.\n     *\n     * @since 0.4\n     * @stable\n     * @example\n     *     const enabled: Capabilities[\"logs\"] = false;\n     *     void enabled;\n     */\n    readonly logs: boolean;\n    readonly inputs: ReadonlySet<InputKind>;\n    /**\n     * Timeframes this adapter can deliver candles for. Order is meaningful\n     * for editor pickers and `request.security` validation (PLAN §4.5).\n     *\n     * @since 0.4\n     * @stable\n     * @example\n     *     const intervals: Capabilities[\"intervals\"] = [\n     *         { value: \"1D\", label: \"1 day\", group: \"daily\" },\n     *     ];\n     *     void intervals;\n     */\n    readonly intervals: ReadonlyArray<IntervalDescriptor>;\n    /**\n     * Whether the adapter can deliver more than one candle stream per script\n     * load. `false` triggers the Phase 4 all-NaN fallback for\n     * `request.security` (PLAN §4.5).\n     *\n     * @since 0.4\n     * @stable\n     * @example\n     *     const enabled: Capabilities[\"multiTimeframe\"] = false;\n     *     void enabled;\n     */\n    readonly multiTimeframe: boolean;\n    /**\n     * Max number of sub-panes the adapter can render for one script. Use\n     * `Number.MAX_SAFE_INTEGER` as the unlimited sentinel per PLAN §7.2.\n     *\n     * @since 0.4\n     * @stable\n     * @example\n     *     const max: Capabilities[\"subPanes\"] = Number.MAX_SAFE_INTEGER;\n     *     void max;\n     */\n    readonly subPanes: number;\n    /**\n     * `syminfo.*` fields this adapter populates. Missing fields evaluate to\n     * empty sentinels per PLAN §4.8.\n     *\n     * @since 0.4\n     * @stable\n     * @example\n     *     const fields: Capabilities[\"symInfoFields\"] = new Set([\"ticker\"]);\n     *     void fields;\n     */\n    readonly symInfoFields: ReadonlySet<SymInfoField>;\n    /**\n     * Per-script drawing-emission budget consumed by runtime drawing gates\n     * and bucketed by PLAN §10 drawing categories.\n     *\n     * @since 0.4\n     * @stable\n     * @example\n     *     const counts: Capabilities[\"maxDrawingsPerScript\"] = {\n     *         lines: 50, labels: 50, boxes: 50, polylines: 50, other: 50,\n     *     };\n     *     void counts;\n     */\n    readonly maxDrawingsPerScript: DrawingCounts;\n    readonly maxLookback: number;\n    readonly maxTickHz: number;\n};\n\n/**\n * Plot style discriminated union. Phase 1 shipped `line` / `step-line` /\n * `horizontal-line`; Phase 2 adds `histogram` / `area` /\n * `filled-band` / `label` / `marker` per PLAN §7.3. Phase 5 will extend\n * further (`shape`, `character`, `arrow`, `vertical-line`,\n * `bar-override`, …). Every expansion is additive — `apiVersion: 1`\n * scripts stay valid.\n *\n * @since 0.1\n * @stable\n * @example\n *     const line: PlotStyle = { kind: \"line\", lineWidth: 1, lineStyle: \"solid\" };\n *     const hist: PlotStyle = { kind: \"histogram\", baseline: 0 };\n *     const band: PlotStyle = { kind: \"filled-band\", upper: 1, lower: -1, alpha: 0.2 };\n *     void line; void hist; void band;\n */\nexport type PlotStyle =\n    | {\n          readonly kind: \"line\";\n          readonly lineWidth: number;\n          readonly lineStyle: LineStyle;\n      }\n    | {\n          readonly kind: \"step-line\";\n          readonly lineWidth: number;\n          readonly lineStyle: LineStyle;\n      }\n    | {\n          readonly kind: \"horizontal-line\";\n          readonly lineWidth: number;\n          readonly lineStyle: LineStyle;\n      }\n    /** Phase 2 — column rising from `baseline` to `value`. @since 0.2 */\n    | {\n          readonly kind: \"histogram\";\n          readonly baseline: number;\n      }\n    /** Phase 2 — filled polygon under a polyline. @since 0.2 */\n    | {\n          readonly kind: \"area\";\n          readonly lineWidth: number;\n          readonly lineStyle: LineStyle;\n          readonly fillAlpha: number;\n      }\n    /** Phase 2 — region between two polylines. `upper` / `lower` may be\n     *  `null` to mark a per-bar gap; both `null` is rejected by\n     *  {@link validateEmission}. @since 0.2 */\n    | {\n          readonly kind: \"filled-band\";\n          readonly upper: number | null;\n          readonly lower: number | null;\n          readonly alpha: number;\n      }\n    /** Phase 2 — text annotation anchored above / below / at the value.\n     *  @since 0.2 */\n    | {\n          readonly kind: \"label\";\n          readonly text: string;\n          readonly position: \"above\" | \"below\" | \"anchor\";\n      }\n    /** Phase 2 — discrete glyph at the value. @since 0.2 */\n    | {\n          readonly kind: \"marker\";\n          readonly shape: \"circle\" | \"triangle-up\" | \"triangle-down\" | \"square\" | \"diamond\";\n          readonly size: number;\n      }\n    /** Phase 5 — Pine `plotshape` glyph at the plot anchor. @since 0.5 */\n    | {\n          readonly kind: \"shape\";\n          readonly shape:\n              | \"circle\"\n              | \"triangle-up\"\n              | \"triangle-down\"\n              | \"square\"\n              | \"diamond\"\n              | \"cross\"\n              | \"xcross\"\n              | \"flag\";\n          readonly size: number;\n          readonly location?: \"above\" | \"below\" | \"absolute\";\n      }\n    /** Phase 5 — Pine `plotchar` text glyph at the plot anchor. @since 0.5 */\n    | {\n          readonly kind: \"character\";\n          readonly char: string;\n          readonly size: number;\n          readonly location?: \"above\" | \"below\" | \"absolute\";\n      }\n    /** Phase 5 — Pine `plotarrow` directional marker. @since 0.5 */\n    | {\n          readonly kind: \"arrow\";\n          readonly direction: \"up\" | \"down\";\n          readonly size: number;\n      }\n    /** Phase 5 — Pine `plotcandle` body-color override. @since 0.5 */\n    | {\n          readonly kind: \"candle-override\";\n          readonly bull: Color;\n          readonly bear: Color;\n          readonly doji?: Color;\n      }\n    /** Phase 5 — Pine `plotbar` outline-color override. @since 0.5 */\n    | {\n          readonly kind: \"bar-override\";\n          readonly color: Color;\n      }\n    /** Phase 5 — Pine `bgcolor` background band. @since 0.5 */\n    | {\n          readonly kind: \"bg-color\";\n          readonly color: Color;\n          readonly transp?: number;\n      }\n    /** Phase 5 — Pine `barcolor` candle/bar tint. @since 0.5 */\n    | {\n          readonly kind: \"bar-color\";\n          readonly color: Color;\n      }\n    /** Phase 5 — volume-profile horizontal histogram buckets. @since 0.5 */\n    | {\n          readonly kind: \"horizontal-histogram\";\n          readonly buckets: ReadonlyArray<\n              Readonly<{ readonly price: number; readonly volume: number; readonly color?: Color }>\n          >;\n      };\n\n/**\n * A `plot()` / `hline()` emission the runtime sends to the adapter.\n * Numeric `value: null` is the wire-level \"skip this bar\" — NaN/Infinity\n * are forbidden in `value` and anywhere in `meta` (PLAN §7.3 universal\n * payload rules).\n *\n * @since 0.1\n * @stable\n * @example\n *     const e: PlotEmission = {\n *         kind: \"plot\",\n *         slotId: \"ema-cross.ts:12:5#0\",\n *         title: \"EMA\",\n *         style: { kind: \"line\", lineWidth: 1, lineStyle: \"solid\" },\n *         bar: 100,\n *         time: 1_700_000_000_000,\n *         value: 42.31,\n *         color: \"#3b82f6\",\n *         meta: {},\n *         pane: \"overlay\",\n *     };\n */\nexport type PlotEmission = {\n    readonly kind: \"plot\";\n    readonly slotId: string;\n    readonly title: string;\n    readonly style: PlotStyle;\n    readonly bar: number;\n    readonly time: number;\n    readonly value: number | null;\n    readonly color: string | null;\n    readonly meta: Readonly<Record<string, JsonValue>>;\n    readonly pane: \"overlay\" | \"new\" | string;\n    /**\n     * Omitted ⇒ visible. Set to `false` by the runtime when a host\n     * override hides this slot; the adapter SHOULD skip rendering and\n     * y-scale inclusion but keep the slot listed.\n     *\n     * @since 0.8\n     * @stable\n     * @example\n     *     const hidden: PlotEmission[\"visible\"] = false;\n     *     void hidden;\n     */\n    readonly visible?: boolean;\n    /**\n     * Presentation-only horizontal display shift in **bars**. Omitted (or\n     * `0`) ⇒ no shift, so a no-shift emission is byte-identical to a plot\n     * that never carried the field. `+n` shifts the plotted series `n`\n     * bars **right** (into the future); `−n` shifts it `n` bars **left**\n     * (into the past). It moves only where the series renders — `value`\n     * is the unshifted number and alert bars are unaffected. Must be a\n     * signed integer; `validateEmission` rejects a non-integer.\n     *\n     * @since 1.3\n     * @stable\n     * @example\n     *     const shifted: PlotEmission[\"xShift\"] = -5;\n     *     void shifted;\n     */\n    readonly xShift?: number;\n    /**\n     * Presentation-only render-order key (z-index). Omitted (or `0`) ⇒ no\n     * explicit order, so the emission is byte-identical to a plot that\n     * never carried the field. Higher `z` renders on top; lower (incl.\n     * negative) renders behind. Adapters MUST compute a stable global\n     * order keyed on `(z ?? 0, groupBand, declarationSeq)` — a plot with\n     * `z` below a drawing's `z` renders beneath that drawing, crossing the\n     * default plots-under-drawings band. Any finite number (fractional\n     * allowed); `validateEmission` rejects NaN / ±Infinity. Affects only\n     * stacking — `value`, `xShift`, alerts, and `state.*` are unaffected.\n     *\n     * @since 1.4\n     * @stable\n     * @example\n     *     const behind: PlotEmission[\"z\"] = -1;\n     *     void behind;\n     */\n    readonly z?: number;\n};\n\n/**\n * An `alert()` emission. `dedupeKey` is computed by the runtime\n * (`slotId + bar + hash(message + meta)`) and adapters that dispatch\n * via async channels MUST use it for idempotency.\n *\n * @since 0.1\n * @stable\n * @example\n *     const e: AlertEmission = {\n *         kind: \"alert\",\n *         slotId: \"rsi.ts:42:1#0\",\n *         severity: \"warning\",\n *         message: \"RSI divergence\",\n *         bar: 200,\n *         time: 1_700_000_000_000,\n *         meta: {},\n *         channels: [\"toast\"],\n *         dedupeKey: \"rsi.ts:42:1#0|200|deadbeef\",\n *     };\n */\nexport type AlertEmission = {\n    readonly kind: \"alert\";\n    readonly slotId: string;\n    readonly severity: AlertSeverity;\n    readonly message: string;\n    readonly bar: number;\n    readonly time: number;\n    readonly meta: Readonly<Record<string, JsonValue>>;\n    readonly channels: ReadonlyArray<AlertChannel>;\n    readonly dedupeKey: string;\n};\n\n/**\n * Per-bar emission produced by `ComputeContext.signal(conditionId, fired)`.\n * Adapters route these named, user-wired conditions to delivery channels\n * configured in their own UI.\n *\n * @since 0.5\n * @stable\n * @example\n *     const e: AlertConditionEmission = {\n *         kind: \"alert-condition\",\n *         conditionId: \"bullishCross\",\n *         title: \"Bullish cross\",\n *         description: \"Fast EMA crossed above slow EMA\",\n *         defaultMessage: \"{{ticker}} crossed up\",\n *         fired: true,\n *         bar: 42,\n *         time: 1_700_000_000_000,\n *     };\n *     void e;\n */\nexport type AlertConditionEmission = {\n    readonly kind: \"alert-condition\";\n    readonly conditionId: string;\n    readonly title: string;\n    readonly description: string;\n    readonly defaultMessage: string;\n    readonly fired: boolean;\n    readonly bar: number;\n    readonly time: number;\n};\n\n/**\n * Per-bar debug log produced by `runtime.log.info/warn/error(...)`.\n * Logs are capability-gated by `Capabilities.logs`; disabled logs are\n * silent no-ops because they are debugging output rather than signal.\n *\n * @since 0.5\n * @stable\n * @example\n *     const e: LogEmission = {\n *         kind: \"log\",\n *         level: \"info\",\n *         message: \"ema warmed\",\n *         meta: { ema: 42 },\n *         bar: 10,\n *         time: 1_700_000_000_000,\n *     };\n *     void e;\n */\nexport type LogEmission = {\n    readonly kind: \"log\";\n    readonly level: LogLevel;\n    readonly message: string;\n    readonly meta?: Readonly<Record<string, JsonValue>>;\n    readonly bar: number;\n    readonly time: number;\n};\n\n/**\n * A `draw.*` emission. Phase 3 narrows `state` from `unknown` to the\n * typed {@link DrawingState} discriminated union. `op: \"create\"`\n * carries the initial state; `op: \"update\"` carries the FULL merged\n * state per the §10.3 full-state semantic (not a patch); `op:\n * \"remove\"` carries the last-known state.\n *\n * @since 0.1\n * @stable\n * @example\n *     const e: DrawingEmission = {\n *         kind: \"drawing\",\n *         handleId: \"ph3.ts:1:1#0\",\n *         drawingKind: \"line\",\n *         op: \"create\",\n *         state: {\n *             kind: \"line\",\n *             anchors: [{ time: 0, price: 0 }, { time: 1, price: 1 }],\n *             style: {},\n *         },\n *         bar: 0,\n *         time: 0,\n *     };\n *     void e;\n */\nexport type DrawingEmission = {\n    readonly kind: \"drawing\";\n    readonly handleId: string;\n    readonly drawingKind: DrawingKind;\n    readonly op: \"create\" | \"update\" | \"remove\";\n    readonly state: DrawingState;\n    readonly bar: number;\n    readonly time: number;\n    /**\n     * Presentation-only render-order key (z-index). Omitted (or `0`) ⇒ no\n     * explicit order, so the emission is byte-identical to a drawing that\n     * never carried the field. Higher `z` renders on top; a **negative**\n     * `z` lets a drawing render **below** `z=0` plots, crossing the\n     * default plots-under-drawings band. Adapters MUST compute a stable\n     * global order keyed on `(z ?? 0, groupBand, declarationSeq)`. Any\n     * finite number (fractional allowed); `validateEmission` rejects\n     * NaN / ±Infinity. Affects only stacking — `state.*` geometry is\n     * unaffected. `z` is part of the latest state under the per-`(handleId,\n     * bar)` last-write-wins dedup: a `create` then `update` that changes\n     * `z` takes the updated value.\n     *\n     * @since 1.4\n     * @stable\n     * @example\n     *     const beneathPlots: DrawingEmission[\"z\"] = -1;\n     *     void beneathPlots;\n     */\n    readonly z?: number;\n};\n\n/**\n * Stable machine-readable diagnostic code emitted by the runtime / host\n * when an emission is dropped, an input fails coercion, or a budget is\n * exceeded. Pinned set — additive only across `apiVersion: 1.x`.\n *\n * Phase 7 adds the `dep-*` family covering compile-time and runtime\n * failures of the indicator-composition surface introduced by\n * `CompiledScriptObject.output` / `.withInputs`:\n *\n * - `dep-error` — dependency `compute` threw; parent's bar dropped.\n * - `dep-cycle` — compile-time dependency cycle detected.\n * - `dep-unknown-output` — `<binding>.output(\"x\")` references a title\n *   the producer doesn't emit via `plot(value, { title })`.\n * - `dep-invalid-input-override` — `.withInputs({...})` carries a key\n *   not in the producer's `inputs` schema, or fails coercion.\n * - `dep-dynamic` — dep binding cannot be statically resolved\n *   (non-`const`, conditional initialiser, computed access).\n * - `dep-output-not-titled` — producer's `plot(...)` has no `title`,\n *   so consumers cannot reference it by name.\n *\n * @since 0.1\n * @stable\n * @example\n *     const code: DiagnosticCode = \"unsupported-plot-kind\";\n *     const dep: DiagnosticCode = \"dep-cycle\";\n *     void code;\n *     void dep;\n */\nexport type DiagnosticCode =\n    | \"unsupported-plot-kind\"\n    | \"unsupported-drawing-kind\"\n    | \"unsupported-alert-channel\"\n    | \"unsupported-pane\"\n    | \"unsupported-interval\"\n    | \"multi-timeframe-not-supported\"\n    | \"unknown-secondary-stream\"\n    | \"lookback-exceeded\"\n    | \"drawing-budget-exceeded\"\n    | \"dropped-by-policy\"\n    | \"input-coercion-failed\"\n    | \"alert-conditions-not-supported\"\n    | \"unknown-alert-condition\"\n    | \"alert-rate-limited\"\n    | \"runtime-cpu-budget-exceeded\"\n    | \"runtime-memory-budget-exceeded\"\n    | \"runtime-log-budget-exceeded\"\n    | \"malformed-log-meta\"\n    | \"runtime-error-thrown\"\n    | \"session-info-missing\"\n    | \"fixed-range-inverted\"\n    | \"state-snapshot-restored\"\n    | \"state-snapshot-future-dated\"\n    | \"state-snapshot-malformed\"\n    | \"state-snapshot-save-failed\"\n    | \"malformed-emission\"\n    | \"dep-error\"\n    | \"dep-cycle\"\n    | \"dep-unknown-output\"\n    | \"dep-invalid-input-override\"\n    | \"dep-dynamic\"\n    | \"dep-output-not-titled\";\n\n/**\n * A non-rendered diagnostic the runtime / host surfaces to the editor +\n * error reporters. Never user-visible on its own.\n *\n * @since 0.1\n * @stable\n * @example\n *     const d: RuntimeDiagnostic = {\n *         kind: \"diagnostic\",\n *         severity: \"warning\",\n *         code: \"unsupported-plot-kind\",\n *         message: \"plot kind 'area' not in adapter capabilities\",\n *         slotId: \"ema.ts:1:1#0\",\n *         bar: 10,\n *     };\n */\nexport type RuntimeDiagnostic = {\n    readonly kind: \"diagnostic\";\n    readonly severity: \"info\" | \"warning\" | \"error\";\n    readonly code: DiagnosticCode;\n    readonly message: string;\n    readonly slotId: string | null;\n    readonly bar: number | null;\n};\n\n/**\n * Top-level drain payload the runtime hands `Adapter.onEmissions(...)`.\n * Phase 1 ships `plots` / `drawings` / `alerts` / `diagnostics`; Phase 5\n * additively adds `alertConditions` + `logs` (per PLAN §7.3).\n *\n * @since 0.1\n * @stable\n * @example\n *     const e: RunnerEmissions = {\n *         plots: [],\n *         drawings: [],\n *         alerts: [],\n *         alertConditions: [],\n *         logs: [],\n *         diagnostics: [],\n *         fromBar: 0,\n *         toBar: 0,\n *     };\n */\nexport type RunnerEmissions = {\n    readonly plots: ReadonlyArray<PlotEmission>;\n    readonly drawings: ReadonlyArray<DrawingEmission>;\n    readonly alerts: ReadonlyArray<AlertEmission>;\n    readonly alertConditions: ReadonlyArray<AlertConditionEmission>;\n    readonly logs: ReadonlyArray<LogEmission>;\n    readonly diagnostics: ReadonlyArray<RuntimeDiagnostic>;\n    readonly fromBar: number;\n    readonly toBar: number;\n};\n\n/**\n * The host-side contract every chartlang adapter implements. Phase 1\n * omits PLAN §7.1's optional `feedExternalSeries?` — that surface\n * arrives in Phase 4 alongside `input.external-series`. The shape is\n * additive, so consumer-repo adapters won't need a breaking change to\n * opt in later.\n *\n * @since 0.1\n * @stable\n * @example\n *     declare const a: Adapter;\n *     for await (const e of a.candles({ interval: \"chart\" })) {\n *         void e;\n *     }\n */\nexport type Adapter = {\n    readonly id: string;\n    readonly name: string;\n    readonly capabilities: Capabilities;\n    /**\n     * Optional per-script input override resolver. Called by hosts at script\n     * mount with the script id/name and merged over manifest defaults by the\n     * runtime.\n     *\n     * @since 0.4\n     * @stable\n     * @example\n     *     const resolveInputs: Adapter[\"resolveInputs\"] = (scriptId) => ({\n     *         length: scriptId === \"demo\" ? 20 : 14,\n     *     });\n     *     void resolveInputs;\n     */\n    readonly resolveInputs?: (scriptId: string) => Readonly<Record<string, unknown>>;\n    /**\n     * Optional per-script plot-override resolver. Called by hosts at\n     * mount with the script id/name; returns a `slotId → PlotOverride`\n     * map the runtime applies to emissions. Presentation-only — never\n     * affects `compute`. Hosts may also push live updates after mount\n     * (see `ScriptHost.setPlotOverrides`).\n     *\n     * @since 0.8\n     * @stable\n     * @example\n     *     const resolvePlotOverrides: Adapter[\"resolvePlotOverrides\"] =\n     *         () => ({ \"ema.ts:12:5#0\": { visible: false } });\n     *     void resolvePlotOverrides;\n     */\n    readonly resolvePlotOverrides?: (scriptId: string) => Readonly<Record<string, PlotOverride>>;\n    /**\n     * Optional per-mount symbol metadata payload used to populate\n     * `syminfo.*`. Fields are still gated by `capabilities.symInfoFields`.\n     *\n     * @since 0.4\n     * @stable\n     * @example\n     *     const info: Adapter[\"symInfo\"] = { ticker: \"DEMO\" };\n     *     void info;\n     */\n    readonly symInfo?: AdapterSymInfo;\n    candles(opts: { interval: string | \"chart\" }): AsyncIterable<CandleEvent>;\n    onEmissions(emissions: RunnerEmissions): void;\n    dispose(): void;\n};\n"]}

package/dist/validation/validateEmission.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"validateEmission.d.ts","sourceRoot":"","sources":["../../src/validation/validateEmission.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD;;;;;;;;GAQG;AACH,MAAM,MAAM,YAAY,GAAG;IAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAA;CAAE,CAAC;AAEjD;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,cAAc,GAAG;IACzB,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IACnB,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;IAC9B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC5B,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,gBAAgB,GAAG,YAAY,GAAG,cAAc,CAAC;AA09C7D;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,OAAO,GAAG,gBAAgB,CAwB7D"}
+{"version":3,"file":"validateEmission.d.ts","sourceRoot":"","sources":["../../src/validation/validateEmission.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD;;;;;;;;GAQG;AACH,MAAM,MAAM,YAAY,GAAG;IAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAA;CAAE,CAAC;AAEjD;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,cAAc,GAAG;IACzB,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IACnB,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;IAC9B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC5B,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,gBAAgB,GAAG,YAAY,GAAG,cAAc,CAAC;AAqhD7D;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,OAAO,GAAG,gBAAgB,CAwB7D"}

package/dist/validation/validateEmission.js

@@ -403,6 +403,12 @@ function validatePlotEmission(e) {
     if (e.visible !== undefined && typeof e.visible !== "boolean") {
         return bad("plot.visible: must be a boolean");
     }
+    if (e.xShift !== undefined && !Number.isInteger(e.xShift)) {
+        return bad("plot.xShift: must be an integer");
+    }
+    if (e.z !== undefined && !isFiniteNumber(e.z)) {
+        return bad("plot.z: must be a finite number");
+    }
     return { ok: true };
 }
 function validateAlertEmission(e) {
@@ -681,6 +687,42 @@ function validatePathState(state) {
         return anchorsCheck;
     return validatePathOpts(state.style, "drawing.state.style");
 }
+function validateFillBetweenStyle(s, path) {
+    // `color` / `lineWidth` / `lineStyle` share the LineDrawStyle contract;
+    // delegate so the shared checks cannot drift (same pattern as
+    // `validatePathOpts`). FillBetweenStyle has no `extendLeft` / `extendRight`
+    // fields, so those LineDrawStyle checks pass vacuously.
+    const lineCheck = validateLineDrawStyle(s, path);
+    if (!lineCheck.ok)
+        return lineCheck;
+    // validateLineDrawStyle proved `s` is a plain object.
+    const obj = s;
+    if (obj.fill !== undefined && typeof obj.fill !== "string") {
+        return bad(`${path}.fill: must be a string`);
+    }
+    if (obj.fillAlpha !== undefined &&
+        (!isFiniteNumber(obj.fillAlpha) || obj.fillAlpha < 0 || obj.fillAlpha > 1)) {
+        return bad(`${path}.fillAlpha: must be a finite number in [0, 1]`);
+    }
+    return { ok: true };
+}
+// A fill-between band is a series-growth primitive: the canonical idiom
+// accumulates one `WorldPoint` per bar into each edge and re-emits the whole
+// ribbon every step (see `examples/scripts/fill-between-band.chart.ts`), unlike
+// the discrete `path` / `polyline` tools that cap at 20. The upper bound here
+// must therefore cover a full chart history — sized to the 10 000-bar bundled
+// golden fixture so a band spanning the entire dataset is not silently dropped.
+const FILL_BETWEEN_MIN_ANCHORS = 2;
+const FILL_BETWEEN_MAX_ANCHORS = 10_000;
+function validateFillBetweenState(state) {
+    const edgeACheck = validateAnchorVariable(state.edgeA, "drawing.state.edgeA", FILL_BETWEEN_MIN_ANCHORS, FILL_BETWEEN_MAX_ANCHORS);
+    if (!edgeACheck.ok)
+        return edgeACheck;
+    const edgeBCheck = validateAnchorVariable(state.edgeB, "drawing.state.edgeB", FILL_BETWEEN_MIN_ANCHORS, FILL_BETWEEN_MAX_ANCHORS);
+    if (!edgeBCheck.ok)
+        return edgeBCheck;
+    return validateFillBetweenStyle(state.style, "drawing.state.style");
+}
 const VALID_TEXT_SIZES = new Set(["tiny", "small", "normal", "large", "huge"]);
 const VALID_TEXT_HALIGN = new Set(["left", "center", "right"]);
 const VALID_TEXT_VALIGN = new Set(["top", "middle", "bottom"]);
@@ -1283,6 +1325,8 @@ function validateStateByKind(kind, state) {
             return validateEllipseState(state);
         case "path":
             return validatePathState(state);
+        case "fill-between":
+            return validateFillBetweenState(state);
         case "marker":
             return validateMarkerState(state);
         case "arc":
@@ -1411,6 +1455,9 @@ function validateDrawingEmission(e) {
     if (state.kind !== drawingKind) {
         return bad(`drawing.state.kind: '${String(state.kind)}' must equal drawing.drawingKind '${drawingKind}'`);
     }
+    if (e.z !== undefined && !isFiniteNumber(e.z)) {
+        return bad("drawing.z: must be a finite number");
+    }
     const metaCheck = validateDrawingMeta(state);
     if (!metaCheck.ok)
         return metaCheck;