@invinite-org/chartlang-core 1.0.1 → 1.1.1

package/CHANGELOG.md

@@ -1,5 +1,103 @@
 # @invinite-org/chartlang-core
 
+## 1.1.1
+
+### Patch Changes
+
+- 71ea0a5: Inline original TypeScript sources into emitted `.js.map` files (`inlineSources: true`). Published sourcemaps no longer reference missing `../src/*.ts` files, fixing "points to missing source files" warnings in downstream bundlers (e.g. Vite).
+
+## 1.1.0
+
+### Minor Changes
+
+- f0c8eb8: Add `CompiledScriptObject.output` / `.withInputs` sentinels, `DependencyDeclaration` + `OutputDeclaration` types, optional `dependencies` / `outputs` / `exportName` / `siblings` / `isDrawn` fields on `ScriptManifest`, `CompiledScriptBundle` + `isCompiledScriptBundle` narrowing helper, and six new `dep-*` `DiagnosticCode` entries (`dep-error`, `dep-cycle`, `dep-unknown-output`, `dep-invalid-input-override`, `dep-dynamic`, `dep-output-not-titled`). The compiler ambient shim is widened in lockstep so script source resolves the new surface. Additive within `apiVersion: 1`.
+- 2123181: Structured `StateSnapshot` carrying per-runner slot sections (primary +
+  siblings + dependencies) so a `CompiledScriptBundle`'s cold-replay
+  emissions match its warm-restart emissions byte-identically. Slot keys
+  now carry the active runner's `slotIdPrefix` everywhere they reach a
+  `StateStore` (`dep:<localId>/` for deps, `export:<exportName>/` for
+  siblings, empty for the primary). Flat-shape snapshots from before this
+  release continue to load back-compat as primary-only.
+- 2123181: Indicator composition (Phase 7 closeout): one chartlang indicator can
+  read another indicator's titled plot output as a typed `Series<number>`.
+
+  - Compose via local `const` binding plus `<binding>.output("title")` —
+    no new public API beyond the chainable `.output` / `.withInputs`
+    accessors on `CompiledScriptObject`.
+  - A single `.chart.ts` MAY declare a default export plus any number of
+    named exports plus any number of private `const` deps. Export form
+    determines render policy: drawn exports render with the
+    `export:<exportName>/` slot-id prefix; private `const` deps are data
+    feeds only and their visuals are dropped.
+  - Cross-file `import baseTrend from "./base-trend.chart"` resolves
+    recursively; shared producers inline exactly once per consumer.
+  - Additive within `apiVersion: 1.x`. The 172-entry
+    `STATEFUL_PRIMITIVES` set is unchanged. `DiagnosticCode` widens to 32
+    with the new `dep-*` codes (`dep-error`, `dep-cycle`,
+    `dep-unknown-output`, `dep-invalid-input-override`, `dep-dynamic`,
+    `dep-output-not-titled`).
+  - Five conformance scenarios in `@invinite-org/chartlang-conformance`
+    pin the runtime contract end-to-end (`dep-private-single-file`,
+    `dep-multi-export`, `dep-cross-file`, `dep-diamond`,
+    `dep-error-halts-parent`). `Scenario.additionalSources` lets
+    cross-file scenarios ship producer + consumer side-by-side.
+  - Two new example scripts in `examples/scripts/`:
+    `base-trend.chart.ts` (producer) + `trend-confirmation.chart.ts`
+    (multi-export consumer). React-demo gains a fifth catalogue entry
+    exercising the feature end-to-end in the browser.
+  - Docs: `docs/language/indicator-composition.md` narrative guide,
+    `docs/spec/manifest.md` + `docs/spec/semantics.md` +
+    `docs/spec/versioning.md` updates, five new glossary entries.
+
+- 2123181: Light up the end-to-end cross-file dep path for indicator composition. The
+  compiler's `rewriteDependencyAccessors` transformer now collapses
+  `const <alias> = <root>.withInputs({...})...` chains to the bare root
+  identifier so the runtime sentinel never fires at module load; the merged
+  effective inputs flow through the `__dependencies[i].inputOverrides` slot
+  into the runtime's `DepRunner`. Cross-file producers' `@invinite-org/chartlang-core`
+  imports are hoisted above the inlined IIFE so esbuild dedupes them against
+  the consumer's imports and pulls in every symbol the producer uses
+  (`input.int`, `ta.ema`, …). The `__dependencies` export is now prepended
+  pre-bundle so esbuild's tree-shaker keeps each alias binding alive. The
+  `dep-cross-file` conformance scenario joins `ALL_SCENARIOS` and the suite
+  runs 225 scenarios green.
+- 4d77f4d: Add the additive plot-override contract: `PlotSlotDescriptor`,
+  `PlotOverride`, `ScriptManifest.plots?`, `PlotEmission.visible?`, and
+  `Adapter.resolvePlotOverrides?`. `validateEmission` now accepts an
+  optional `visible: boolean` arm on plot emissions and rejects any
+  other type via the existing `malformed-emission` path.
+
+  No behavior changes ship in this contract step — every new field is
+  optional and absence keeps emissions byte-identical to today. The
+  compiler's ambient core shim gains `PlotSlotDescriptor` and the
+  `ScriptManifest.plots?` field so script-side `__manifest` consumers
+  stay in lockstep; `PlotOverride` is intentionally not shimmed (it is
+  runtime-/host-side only).
+
+- 0427459: Persist `defineIndicator({ overlay })` onto `ScriptManifest.overlay?:
+boolean` so the runtime has a script-level default-pane signal. Add
+  `HLineOpts.pane?: "overlay" | "new" | string` mirroring `PlotOpts.pane`
+  so hlines opt into the same pane router. The compiler's `buildManifest`
+  extracts the literal-boolean `overlay` from the `defineIndicator`
+  object literal via `extractOverrides` and emits it on the bundled
+  `__manifest`; the ambient core shim now carries `ScriptManifest.overlay?`
+  and `HLineOpts.pane?` to keep downstream packages type-aligned.
+
+  Step 1 of the `subpane-rendering` feature. Pure additive contract
+  change — every new field is optional and absence keeps existing
+  manifests / emissions byte-identical. The runtime, adapter, and demos
+  land in tasks 2-5.
+
+### Patch Changes
+
+- d6d1a1f: Fix Phase-7 indicator composition where a producer's titled `plot(...)` outputs were never wired to consumers. The compiler computed each binding's `outputs` statically but only wrote them into the manifest sidecar, never onto the producer object's own `manifest.outputs` — so the runtime allocated no dep-output ring buffer and every `<binding>.output("title")` read returned NaN past warmup.
+
+  `defineIndicator` now copies an optional `outputs` opts field into the manifest (omitted ⇒ manifest byte-identical to a script with no titled plots), and the compiler bakes each producer binding's titled `outputs` into its `defineIndicator({...})` opts literal so private deps, named-export siblings, and cross-file producer defaults are self-describing at runtime. Output-free scripts are untouched. Additive within `apiVersion: 1`.
+
+- 3b4952d: Remove the redundant `bars` plot kind. It was never reachable from the script-author API (`PlotOptsStyle` had no `bars` arm and the runtime `buildStyle` had no `case`), no `ta.*` primitive or example emitted it, and the canvas2d reference adapter declared it as a capability but never rendered it. It carried the same `{ baseline: number }` shape as `histogram`, so it was a dead arm of the `PlotKind` / wire-level `PlotStyle` unions.
+
+  `PlotKind`, the adapter-kit `PlotStyle` union, `validateEmission`, the `capabilities.bars()` / `PHASE_5_PLOT_KINDS` surfaces, and the canvas2d adapter's dead `bars.ts` renderer are all dropped. chartlang has no users yet, so this is a hard reset with no deprecation path. Authors who want columns use `histogram`.
+
 ## 1.0.1
 
 ### Patch Changes

package/README.md

@@ -22,9 +22,14 @@ pnpm add @invinite-org/chartlang-core
 - Secondary stream: `request.security({ interval })` typed surface.
 - Emissions: `plot`, `hline`, `alert`, and the 61-kind `draw.*` namespace.
 - Registry: `STATEFUL_PRIMITIVES` for compiler slot-id injection.
+- Indicator composition (Phase 7): `CompiledScriptObject.output(title)` /
+  `.withInputs(overrides)` accessors for binding one indicator's output to
+  another. Both are compiler-rewritten sentinels — direct invocation throws.
+  `isCompiledScriptBundle(v)` narrows the multi-script bundle.
 - Types: `Series<T>`, `Bar`, `InputDescriptor`, `MutableSlot<T>`,
   `ScriptManifest`, `ComputeContext`, `DrawingState`, `DrawingHandle`,
-  `DrawingCounts`, `SecurityBar`, view types, and option/result types.
+  `DrawingCounts`, `SecurityBar`, view types, option/result types, plus
+  `DependencyDeclaration`, `OutputDeclaration`, `CompiledScriptBundle`.
 
 ## Minimum-viable API call
 

package/dist/alert/alert.d.ts

@@ -17,7 +17,7 @@ export type AlertOpts = Readonly<{
 }>;
 /**
  * Compile-time callable hole for `alert(message, opts?)`. The compiler
- * rewrites every callsite (Task 2) to dispatch to the runtime; calling this
+ * rewrites every callsite to dispatch to the runtime; calling this
  * outside the runtime throws the sentinel.
  *
  * @since 0.1

package/dist/alert/alert.js

@@ -2,7 +2,7 @@
 // See the LICENSE file in the repo root for full license text.
 /**
  * Compile-time callable hole for `alert(message, opts?)`. The compiler
- * rewrites every callsite (Task 2) to dispatch to the runtime; calling this
+ * rewrites every callsite to dispatch to the runtime; calling this
  * outside the runtime throws the sentinel.
  *
  * @since 0.1

package/dist/alert/alert.js.map

@@ -1 +1 @@
-{"version":3,"file":"alert.js","sourceRoot":"","sources":["../../src/alert/alert.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,+DAA+D;AAqB/D;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,KAAK,CAAC,QAAgB,EAAE,KAAiB;IACrD,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;AAC7D,CAAC"}
+{"version":3,"file":"alert.js","sourceRoot":"","sources":["../../src/alert/alert.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,+DAA+D;AAqB/D;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,KAAK,CAAC,QAAgB,EAAE,KAAiB;IACrD,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;AAC7D,CAAC","sourcesContent":["// Copyright (c) 2026 Invinite. Licensed under the MIT License.\n// See the LICENSE file in the repo root for full license text.\n\nimport type { AlertSeverity, JsonValue } from \"../types.js\";\n\n/**\n * Styling and metadata options accepted by `alert(...)`. `severity` defaults\n * to `\"info\"`; `meta` is round-tripped to the host as a JSON-serialisable\n * payload.\n *\n * @since 0.1\n * @example\n *     const opts: AlertOpts = {\n *         severity: \"warning\",\n *         meta: { reason: \"crossover\", strength: 0.42 },\n *     };\n */\nexport type AlertOpts = Readonly<{\n    severity?: AlertSeverity;\n    meta?: Readonly<Record<string, JsonValue>>;\n}>;\n\n/**\n * Compile-time callable hole for `alert(message, opts?)`. The compiler\n * rewrites every callsite to dispatch to the runtime; calling this\n * outside the runtime throws the sentinel.\n *\n * @since 0.1\n * @stable\n * @example\n *     // Inside a compiled `compute`:\n *     //   alert(\"EMA crossed\", { severity: \"info\" });\n *     import { alert } from \"@invinite-org/chartlang-core\";\n *     try { alert(\"noop\"); } catch {}\n */\nexport function alert(_message: string, _opts?: AlertOpts): void {\n    throw new Error(\"alert called outside compiled runtime\");\n}\n"]}

package/dist/alert/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/alert/index.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,+DAA+D;AAE/D,cAAc,YAAY,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/alert/index.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,+DAA+D;AAE/D,cAAc,YAAY,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 * from \"./alert.js\";\n"]}

package/dist/color/colorHelpers.js.map

@@ -1 +1 @@
-{"version":3,"file":"colorHelpers.js","sourceRoot":"","sources":["../../src/color/colorHelpers.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"colorHelpers.js","sourceRoot":"","sources":["../../src/color/colorHelpers.ts"],"names":[],"mappings":"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","sourcesContent":["// Copyright (c) 2026 Invinite. Licensed under the MIT License.\n// See the LICENSE file in the repo root for full license text.\n\nimport type { Color } from \"../types.js\";\nimport { parseColor } from \"./parseColor.js\";\n\n/**\n * Gradient color stop for `color.fromGradient`.\n *\n * @since 0.5\n * @stable\n * @example\n *     const stop: GradientStop = { at: 0, color: \"#0000ff\" };\n *     void stop;\n */\nexport type GradientStop = Readonly<{ at: number; color: Color }>;\n\nconst TRANSPARENT_BLACK = \"rgba(0, 0, 0, 0)\";\n\nfunction clampUnit(value: number): number {\n    if (Number.isNaN(value)) return 0;\n    return Math.min(1, Math.max(0, value));\n}\n\nfunction clampByte(value: number): number {\n    if (Number.isNaN(value)) return 0;\n    return Math.min(255, Math.max(0, Math.floor(value)));\n}\n\nfunction clampHue(value: number): number {\n    if (Number.isNaN(value)) return 0;\n    return Math.min(359.999, Math.max(0, value));\n}\n\nfunction clampPercent(value: number): number {\n    if (Number.isNaN(value)) return 0;\n    return Math.min(100, Math.max(0, value));\n}\n\nfunction formatNumber(value: number): string {\n    const rounded = Math.round(value * 1000) / 1000;\n    return String(rounded);\n}\n\nfunction emitRgb(r: number, g: number, b: number, alpha: number): Color {\n    if (alpha >= 1) return `rgb(${r}, ${g}, ${b})`;\n    return `rgba(${r}, ${g}, ${b}, ${formatNumber(alpha)})`;\n}\n\nfunction emitRgba(r: number, g: number, b: number, alpha: number): Color {\n    return `rgba(${r}, ${g}, ${b}, ${formatNumber(alpha)})`;\n}\n\n/**\n * Dynamic color from a normalised position. `t` is clamped to `[0, 1]`;\n * out-of-range maps to the boundary stop. Stops must be pre-sorted by `at`\n * ascending. Empty stops return transparent black.\n *\n * Pine's `color.from_gradient`.\n *\n * @since 0.5\n * @stable\n * @example\n *     // const blue = \"#0000ff\";\n *     // const red = \"#ff0000\";\n *     // color.fromGradient(0.5, [{ at: 0, color: blue }, { at: 1, color: red }]);\n */\nexport function fromGradient(t: number, stops: ReadonlyArray<GradientStop>): Color {\n    const first = stops[0];\n    if (first === undefined) return TRANSPARENT_BLACK;\n    if (stops.length === 1 || Number.isNaN(t)) return first.color;\n\n    const position = clampUnit(t);\n    if (position <= first.at) return first.color;\n    const last = stops[stops.length - 1];\n    if (position >= last.at) return last.color;\n\n    let previous = first;\n    let next = last;\n    for (let i = 1; i < stops.length; i += 1) {\n        const candidate = stops[i];\n        if (position <= candidate.at) {\n            next = candidate;\n            break;\n        }\n        previous = candidate;\n    }\n\n    const left = parseColor(previous.color);\n    const right = parseColor(next.color);\n    if (left === null || right === null) return previous.color;\n    const ratio = (position - previous.at) / (next.at - previous.at);\n    const alpha = left.a + (right.a - left.a) * ratio;\n    return emitRgb(\n        clampByte(left.r + (right.r - left.r) * ratio),\n        clampByte(left.g + (right.g - left.g) * ratio),\n        clampByte(left.b + (right.b - left.b) * ratio),\n        clampUnit(alpha),\n    );\n}\n\n/**\n * Override an existing color's alpha channel. `alpha` is clamped to\n * `[0, 1]`. NaN returns the input color unchanged. Pine's `color.new(c,\n * transp)` analogue using direct alpha.\n *\n * @since 0.5\n * @stable\n * @example\n *     const c = withAlpha(\"#ff0000\", 0.5);\n *     void c;\n */\nexport function withAlpha(c: Color, alpha: number): Color {\n    if (Number.isNaN(alpha)) return c;\n    const parsed = parseColor(c);\n    if (parsed === null) return c;\n    return emitRgba(parsed.r, parsed.g, parsed.b, clampUnit(alpha));\n}\n\n/**\n * Construct a color from RGB(A) components. Each component is clamped to\n * `[0, 255]`; alpha defaults to `1`. NaN components clamp to `0`.\n *\n * @since 0.5\n * @stable\n * @example\n *     const red = rgb(255, 0, 0);\n *     void red;\n */\nexport function rgb(r: number, g: number, b: number, alpha?: number): Color {\n    const red = clampByte(r);\n    const green = clampByte(g);\n    const blue = clampByte(b);\n    if (alpha === undefined) return `rgb(${red}, ${green}, ${blue})`;\n    return emitRgba(red, green, blue, clampUnit(alpha));\n}\n\n/**\n * Construct a color from HSL(A) components. `h` is clamped to `[0, 360)`;\n * `s` and `l` are clamped to `[0, 100]`. Alpha defaults to `1`. NaN\n * components clamp to `0`.\n *\n * @since 0.5\n * @stable\n * @example\n *     const red = hsl(0, 100, 50);\n *     void red;\n */\nexport function hsl(h: number, s: number, l: number, alpha?: number): Color {\n    const hue = formatNumber(clampHue(h));\n    const sat = formatNumber(clampPercent(s));\n    const light = formatNumber(clampPercent(l));\n    if (alpha === undefined) return `hsl(${hue}, ${sat}%, ${light}%)`;\n    return `hsla(${hue}, ${sat}%, ${light}%, ${formatNumber(clampUnit(alpha))})`;\n}\n"]}

package/dist/color/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/color/index.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,+DAA+D;AAE/D,OAAO,EAAE,YAAY,EAAE,GAAG,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACtE,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhD,OAAO,EAAE,YAAY,EAAE,GAAG,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAGtE;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC;IAC/B,GAAG,aAAa;IAChB,YAAY;IACZ,SAAS;IACT,GAAG;IACH,GAAG;CACN,CAAC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/color/index.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,+DAA+D;AAE/D,OAAO,EAAE,YAAY,EAAE,GAAG,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACtE,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhD,OAAO,EAAE,YAAY,EAAE,GAAG,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAGtE;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC;IAC/B,GAAG,aAAa;IAChB,YAAY;IACZ,SAAS;IACT,GAAG;IACH,GAAG;CACN,CAAC,CAAC","sourcesContent":["// Copyright (c) 2026 Invinite. Licensed under the MIT License.\n// See the LICENSE file in the repo root for full license text.\n\nimport { fromGradient, hsl, rgb, withAlpha } from \"./colorHelpers.js\";\nimport { COLOR_PALETTE } from \"./parseColor.js\";\n\nexport { fromGradient, hsl, rgb, withAlpha } from \"./colorHelpers.js\";\nexport type { GradientStop } from \"./colorHelpers.js\";\n\n/**\n * Pine-style color namespace. Includes the named palette plus dynamic\n * helpers for compute-time colors.\n *\n * @since 0.5\n * @stable\n * @example\n *     const c = color.withAlpha(color.red, 0.5);\n *     void c;\n */\nexport const color = Object.freeze({\n    ...COLOR_PALETTE,\n    fromGradient,\n    withAlpha,\n    rgb,\n    hsl,\n});\n"]}

package/dist/color/parseColor.js.map

@@ -1 +1 @@
-{"version":3,"file":"parseColor.js","sourceRoot":"","sources":["../../src/color/parseColor.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"parseColor.js","sourceRoot":"","sources":["../../src/color/parseColor.ts"],"names":[],"mappings":"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","sourcesContent":["// Copyright (c) 2026 Invinite. Licensed under the MIT License.\n// See the LICENSE file in the repo root for full license text.\n\nimport type { Color } from \"../types.js\";\n\n/**\n * Pine-style named palette values accepted by the color parser and exposed\n * through the `color` namespace.\n *\n * @internal\n * @since 0.5\n * @example\n *     const red = COLOR_PALETTE.red;\n *     void red;\n */\nexport const COLOR_PALETTE = Object.freeze({\n    aqua: \"#00ffff\",\n    black: \"#000000\",\n    blue: \"#0000ff\",\n    fuchsia: \"#ff00ff\",\n    gray: \"#808080\",\n    green: \"#008000\",\n    lime: \"#00ff00\",\n    maroon: \"#800000\",\n    navy: \"#000080\",\n    olive: \"#808000\",\n    orange: \"#ffa500\",\n    purple: \"#800080\",\n    red: \"#ff0000\",\n    silver: \"#c0c0c0\",\n    teal: \"#008080\",\n    white: \"#ffffff\",\n    yellow: \"#ffff00\",\n});\n\ntype PaletteName = keyof typeof COLOR_PALETTE;\n\nconst HEX_SHORT = /^#([0-9a-f]{3})$/i;\nconst HEX_LONG = /^#([0-9a-f]{6})$/i;\nconst RGB = /^rgba?\\(\\s*([^,\\s]+)\\s*,\\s*([^,\\s]+)\\s*,\\s*([^,\\s]+)(?:\\s*,\\s*([^,\\s]+))?\\s*\\)$/i;\nconst HSL = /^hsla?\\(\\s*([^,\\s]+)\\s*,\\s*([^,\\s%]+)%\\s*,\\s*([^,\\s%]+)%(?:\\s*,\\s*([^,\\s]+))?\\s*\\)$/i;\n\nfunction isPaletteName(value: string): value is PaletteName {\n    return Object.prototype.hasOwnProperty.call(COLOR_PALETTE, value);\n}\n\nfunction clampByte(value: number): number {\n    return Math.min(255, Math.max(0, Math.floor(value)));\n}\n\nfunction clampRoundedByte(value: number): number {\n    return Math.min(255, Math.max(0, Math.round(value)));\n}\n\nfunction clampUnit(value: number): number {\n    return Math.min(1, Math.max(0, value));\n}\n\nfunction parseNumber(value: string): number | null {\n    const parsed = Number(value);\n    if (Number.isNaN(parsed)) return null;\n    return parsed;\n}\n\nfunction hslToRgb(h: number, s: number, l: number): Readonly<{ r: number; g: number; b: number }> {\n    const hue = Math.min(359.999, Math.max(0, h)) / 360;\n    const sat = Math.min(100, Math.max(0, s)) / 100;\n    const light = Math.min(100, Math.max(0, l)) / 100;\n\n    if (sat === 0) {\n        const gray = clampRoundedByte(light * 255);\n        return { r: gray, g: gray, b: gray };\n    }\n\n    const q = light < 0.5 ? light * (1 + sat) : light + sat - light * sat;\n    const p = 2 * light - q;\n    const channel = (t: number): number => {\n        let adjusted = t;\n        if (adjusted < 0) adjusted += 1;\n        if (adjusted > 1) adjusted -= 1;\n        if (adjusted < 1 / 6) return p + (q - p) * 6 * adjusted;\n        if (adjusted < 1 / 2) return q;\n        if (adjusted < 2 / 3) return p + (q - p) * (2 / 3 - adjusted) * 6;\n        return p;\n    };\n\n    return {\n        r: clampRoundedByte(channel(hue + 1 / 3) * 255),\n        g: clampRoundedByte(channel(hue) * 255),\n        b: clampRoundedByte(channel(hue - 1 / 3) * 255),\n    };\n}\n\n/**\n * Parse the CSS color forms chartlang emits: `#rgb`, `#rrggbb`,\n * `rgb(...)`, `rgba(...)`, `hsl(...)`, `hsla(...)`, and the named palette.\n * Returns `null` for unparseable input.\n *\n * @internal\n * @since 0.5\n * @example\n *     const parsed = parseColor(\"#ff0000\");\n *     void parsed;\n */\nexport function parseColor(\n    c: Color,\n): Readonly<{ r: number; g: number; b: number; a: number }> | null {\n    const value = c.trim().toLowerCase();\n    if (isPaletteName(value)) return parseColor(COLOR_PALETTE[value]);\n\n    const shortHex = HEX_SHORT.exec(value);\n    if (shortHex) {\n        const hex = shortHex[1];\n        return {\n            r: Number.parseInt(`${hex[0]}${hex[0]}`, 16),\n            g: Number.parseInt(`${hex[1]}${hex[1]}`, 16),\n            b: Number.parseInt(`${hex[2]}${hex[2]}`, 16),\n            a: 1,\n        };\n    }\n\n    const longHex = HEX_LONG.exec(value);\n    if (longHex) {\n        const hex = longHex[1];\n        return {\n            r: Number.parseInt(hex.slice(0, 2), 16),\n            g: Number.parseInt(hex.slice(2, 4), 16),\n            b: Number.parseInt(hex.slice(4, 6), 16),\n            a: 1,\n        };\n    }\n\n    const rgbMatch = RGB.exec(value);\n    if (rgbMatch) {\n        const r = parseNumber(rgbMatch[1]);\n        const g = parseNumber(rgbMatch[2]);\n        const b = parseNumber(rgbMatch[3]);\n        const a = rgbMatch[4] === undefined ? 1 : parseNumber(rgbMatch[4]);\n        if (r === null || g === null || b === null || a === null) return null;\n        return { r: clampByte(r), g: clampByte(g), b: clampByte(b), a: clampUnit(a) };\n    }\n\n    const hslMatch = HSL.exec(value);\n    if (hslMatch) {\n        const h = parseNumber(hslMatch[1]);\n        const s = parseNumber(hslMatch[2]);\n        const l = parseNumber(hslMatch[3]);\n        const a = hslMatch[4] === undefined ? 1 : parseNumber(hslMatch[4]);\n        if (h === null || s === null || l === null || a === null) return null;\n        return { ...hslToRgb(h, s, l), a: clampUnit(a) };\n    }\n\n    return null;\n}\n"]}

package/dist/define/defineAlert.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"defineAlert.d.ts","sourceRoot":"","sources":["../../src/define/defineAlert.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,oBAAoB,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAChF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEtD,KAAK,cAAc,GAAG,IAAI,CAAC,eAAe,EAAE,OAAO,GAAG,QAAQ,GAAG,WAAW,CAAC,CAAC;AAE9E;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,eAAe,GAAG,QAAQ,CAAC;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,CAAC,CAAC;IACd,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,OAAO,EAAE,SAAS,CAAC;CACtB,CAAC,GACE,cAAc,CAAC;AAEnB;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,eAAe,GAAG,oBAAoB,CA2BvE"}
+{"version":3,"file":"defineAlert.d.ts","sourceRoot":"","sources":["../../src/define/defineAlert.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,oBAAoB,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAEhF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEtD,KAAK,cAAc,GAAG,IAAI,CAAC,eAAe,EAAE,OAAO,GAAG,QAAQ,GAAG,WAAW,CAAC,CAAC;AAE9E;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,eAAe,GAAG,QAAQ,CAAC;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,CAAC,CAAC;IACd,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,OAAO,EAAE,SAAS,CAAC;CACtB,CAAC,GACE,cAAc,CAAC;AAEnB;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,eAAe,GAAG,oBAAoB,CA6BvE"}

package/dist/define/defineAlert.js

@@ -1,5 +1,6 @@
 // Copyright (c) 2026 Invinite. Licensed under the MIT License.
 // See the LICENSE file in the repo root for full license text.
+import { attachDepAccessorSentinels } from "./depAccessorSentinel.js";
 /**
  * Construct a Phase-1 alert script object. Returns a frozen
  * `CompiledScriptObject` whose `manifest.kind` is `"alert"` and whose
@@ -41,9 +42,9 @@ export function defineAlert(opts) {
             : { requiresIntervals: opts.requiresIntervals }),
         ...(opts.shortName === undefined ? {} : { shortName: opts.shortName }),
     };
-    return Object.freeze({
+    return Object.freeze(attachDepAccessorSentinels({
         manifest: Object.freeze(manifest),
         compute: opts.compute,
-    });
+    }));
 }
 //# sourceMappingURL=defineAlert.js.map

package/dist/define/defineAlert.js.map

@@ -1 +1 @@
-{"version":3,"file":"defineAlert.js","sourceRoot":"","sources":["../../src/define/defineAlert.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,+DAA+D;AA4B/D;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,WAAW,CAAC,IAAqB;IAC7C,MAAM,YAAY,GAA4B,MAAM,CAAC,MAAM,CAAa,CAAC,QAAQ,CAAC,CAAC,CAAC;IACpF,MAAM,kBAAkB,GAA0B,MAAM,CAAC,MAAM,CAAW,EAAE,CAAC,CAAC;IAC9E,MAAM,gBAAgB,GAAqC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IAC7E,MAAM,IAAI,GAAG;QACT,UAAU,EAAE,CAAU;QACtB,IAAI,EAAE,OAAgB;QACtB,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,EAAE;QACzB,YAAY;QACZ,kBAAkB;QAClB,oBAAoB,EAAE,KAAK;QAC3B,gBAAgB;QAChB,WAAW,EAAE,CAAC;KACjB,CAAC;IACF,MAAM,QAAQ,GAAG;QACb,GAAG,IAAI;QACP,GAAG,CAAC,IAAI,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE,CAAC;QAC5E,GAAG,CAAC,IAAI,CAAC,iBAAiB,KAAK,SAAS;YACpC,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC,EAAE,iBAAiB,EAAE,IAAI,CAAC,iBAAiB,EAAE,CAAC;QACpD,GAAG,CAAC,IAAI,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC;KACzE,CAAC;IACF,OAAO,MAAM,CAAC,MAAM,CAAC;QACjB,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC;QACjC,OAAO,EAAE,IAAI,CAAC,OAAO;KACxB,CAAC,CAAC;AACP,CAAC"}
+{"version":3,"file":"defineAlert.js","sourceRoot":"","sources":["../../src/define/defineAlert.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,+DAA+D;AAG/D,OAAO,EAAE,0BAA0B,EAAE,MAAM,0BAA0B,CAAC;AA0BtE;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,WAAW,CAAC,IAAqB;IAC7C,MAAM,YAAY,GAA4B,MAAM,CAAC,MAAM,CAAa,CAAC,QAAQ,CAAC,CAAC,CAAC;IACpF,MAAM,kBAAkB,GAA0B,MAAM,CAAC,MAAM,CAAW,EAAE,CAAC,CAAC;IAC9E,MAAM,gBAAgB,GAAqC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IAC7E,MAAM,IAAI,GAAG;QACT,UAAU,EAAE,CAAU;QACtB,IAAI,EAAE,OAAgB;QACtB,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,EAAE;QACzB,YAAY;QACZ,kBAAkB;QAClB,oBAAoB,EAAE,KAAK;QAC3B,gBAAgB;QAChB,WAAW,EAAE,CAAC;KACjB,CAAC;IACF,MAAM,QAAQ,GAAG;QACb,GAAG,IAAI;QACP,GAAG,CAAC,IAAI,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE,CAAC;QAC5E,GAAG,CAAC,IAAI,CAAC,iBAAiB,KAAK,SAAS;YACpC,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC,EAAE,iBAAiB,EAAE,IAAI,CAAC,iBAAiB,EAAE,CAAC;QACpD,GAAG,CAAC,IAAI,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC;KACzE,CAAC;IACF,OAAO,MAAM,CAAC,MAAM,CAChB,0BAA0B,CAAC;QACvB,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC;QACjC,OAAO,EAAE,IAAI,CAAC,OAAO;KACxB,CAAC,CACL,CAAC;AACN,CAAC","sourcesContent":["// Copyright (c) 2026 Invinite. Licensed under the MIT License.\n// See the LICENSE file in the repo root for full license text.\n\nimport type { CompiledScriptObject, ComputeFn, InputSchema } from \"../types.js\";\nimport { attachDepAccessorSentinels } from \"./depAccessorSentinel.js\";\nimport type { ScriptOverrides } from \"./overrides.js\";\n\ntype AlertOverrides = Omit<ScriptOverrides, \"scale\" | \"format\" | \"precision\">;\n\n/**\n * Author-supplied options the script passes to `defineAlert(...)`. Same shape\n * as `DefineIndicatorOpts` minus the indicator-only `overlay` flag — alert\n * scripts have no plot output.\n *\n * @since 0.1\n * @example\n *     const opts: DefineAlertOpts = {\n *         name: \"RSI overbought\",\n *         apiVersion: 1,\n *         compute: () => {},\n *     };\n */\nexport type DefineAlertOpts = Readonly<{\n    name: string;\n    apiVersion: 1;\n    inputs?: InputSchema;\n    compute: ComputeFn;\n}> &\n    AlertOverrides;\n\n/**\n * Construct a Phase-1 alert script object. Returns a frozen\n * `CompiledScriptObject` whose `manifest.kind` is `\"alert\"` and whose\n * declared `capabilities` is `[\"alerts\"]`. Same compile-time override\n * semantics as `defineIndicator`.\n *\n * @since 0.1\n * @example\n * ```ts\n * import { defineAlert } from \"@invinite-org/chartlang-core\";\n *\n * export default defineAlert({\n *     name: \"RSI > 70\",\n *     apiVersion: 1,\n *     compute: ({ alert }) => { alert(\"overbought\"); },\n * });\n * ```\n */\nexport function defineAlert(opts: DefineAlertOpts): CompiledScriptObject {\n    const capabilities: ReadonlyArray<\"alerts\"> = Object.freeze<[\"alerts\"]>([\"alerts\"]);\n    const requestedIntervals: ReadonlyArray<string> = Object.freeze<string[]>([]);\n    const seriesCapacities: Readonly<Record<string, number>> = Object.freeze({});\n    const base = {\n        apiVersion: 1 as const,\n        kind: \"alert\" as const,\n        name: opts.name,\n        inputs: opts.inputs ?? {},\n        capabilities,\n        requestedIntervals,\n        userPickableInterval: false,\n        seriesCapacities,\n        maxLookback: 0,\n    };\n    const manifest = {\n        ...base,\n        ...(opts.maxBarsBack === undefined ? {} : { maxBarsBack: opts.maxBarsBack }),\n        ...(opts.requiresIntervals === undefined\n            ? {}\n            : { requiresIntervals: opts.requiresIntervals }),\n        ...(opts.shortName === undefined ? {} : { shortName: opts.shortName }),\n    };\n    return Object.freeze(\n        attachDepAccessorSentinels({\n            manifest: Object.freeze(manifest),\n            compute: opts.compute,\n        }),\n    );\n}\n"]}

package/dist/define/defineAlertCondition.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"defineAlertCondition.d.ts","sourceRoot":"","sources":["../../src/define/defineAlertCondition.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACR,wBAAwB,EAExB,oBAAoB,EACpB,SAAS,EACT,WAAW,EAEd,MAAM,aAAa,CAAC;AAErB;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,MAAM,wBAAwB,GAAG,QAAQ,CAAC;IAC5C,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,CAAC,CAAC;IACd,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,wBAAwB,CAAC,CAAC,CAAC;IAC/D,OAAO,EAAE,SAAS,CAAC;CACtB,CAAC,CAAC;AAcH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,wBAAwB,GAAG,oBAAoB,CAoBzF"}
+{"version":3,"file":"defineAlertCondition.d.ts","sourceRoot":"","sources":["../../src/define/defineAlertCondition.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACR,wBAAwB,EAExB,oBAAoB,EACpB,SAAS,EACT,WAAW,EAEd,MAAM,aAAa,CAAC;AAGrB;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,MAAM,wBAAwB,GAAG,QAAQ,CAAC;IAC5C,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,CAAC,CAAC;IACd,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,wBAAwB,CAAC,CAAC,CAAC;IAC/D,OAAO,EAAE,SAAS,CAAC;CACtB,CAAC,CAAC;AAcH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,wBAAwB,GAAG,oBAAoB,CAoBzF"}

package/dist/define/defineAlertCondition.js

@@ -1,5 +1,6 @@
 // Copyright (c) 2026 Invinite. Licensed under the MIT License.
 // See the LICENSE file in the repo root for full license text.
+import { attachDepAccessorSentinels } from "./depAccessorSentinel.js";
 function freezeCondition(id, descriptor) {
     return Object.freeze({
         id,
@@ -59,6 +60,6 @@ export function defineAlertCondition(opts) {
         maxLookback: 0,
         alertConditions,
     });
-    return Object.freeze({ manifest, compute: opts.compute });
+    return Object.freeze(attachDepAccessorSentinels({ manifest, compute: opts.compute }));
 }
 //# sourceMappingURL=defineAlertCondition.js.map

package/dist/define/defineAlertCondition.js.map

@@ -1 +1 @@
-{"version":3,"file":"defineAlertCondition.js","sourceRoot":"","sources":["../../src/define/defineAlertCondition.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,+DAA+D;AAwC/D,SAAS,eAAe,CACpB,EAAU,EACV,UAAoC;IAEpC,OAAO,MAAM,CAAC,MAAM,CAAC;QACjB,EAAE;QACF,KAAK,EAAE,UAAU,CAAC,KAAK;QACvB,WAAW,EAAE,UAAU,CAAC,WAAW;QACnC,cAAc,EAAE,UAAU,CAAC,cAAc;KAC5C,CAAC,CAAC;AACP,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,MAAM,UAAU,oBAAoB,CAAC,IAA8B;IAC/D,MAAM,eAAe,GAAG,MAAM,CAAC,MAAM,CACjC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,UAAU,CAAC,EAAE,EAAE,CAAC,eAAe,CAAC,EAAE,EAAE,UAAU,CAAC,CAAC,CAC7F,CAAC;IACF,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,CAAmC,CAAC,iBAAiB,CAAC,CAAC,CAAC;IAC1F,MAAM,kBAAkB,GAAG,MAAM,CAAC,MAAM,CAAW,EAAE,CAAC,CAAC;IACvD,MAAM,gBAAgB,GAAqC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IAC7E,MAAM,QAAQ,GAAmB,MAAM,CAAC,MAAM,CAAC;QAC3C,UAAU,EAAE,CAAC;QACb,IAAI,EAAE,gBAAgB;QACtB,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,EAAE;QACzB,YAAY;QACZ,kBAAkB;QAClB,oBAAoB,EAAE,KAAK;QAC3B,gBAAgB;QAChB,WAAW,EAAE,CAAC;QACd,eAAe;KAClB,CAAC,CAAC;IACH,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;AAC9D,CAAC"}
+{"version":3,"file":"defineAlertCondition.js","sourceRoot":"","sources":["../../src/define/defineAlertCondition.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,+DAA+D;AAU/D,OAAO,EAAE,0BAA0B,EAAE,MAAM,0BAA0B,CAAC;AA+BtE,SAAS,eAAe,CACpB,EAAU,EACV,UAAoC;IAEpC,OAAO,MAAM,CAAC,MAAM,CAAC;QACjB,EAAE;QACF,KAAK,EAAE,UAAU,CAAC,KAAK;QACvB,WAAW,EAAE,UAAU,CAAC,WAAW;QACnC,cAAc,EAAE,UAAU,CAAC,cAAc;KAC5C,CAAC,CAAC;AACP,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,MAAM,UAAU,oBAAoB,CAAC,IAA8B;IAC/D,MAAM,eAAe,GAAG,MAAM,CAAC,MAAM,CACjC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,UAAU,CAAC,EAAE,EAAE,CAAC,eAAe,CAAC,EAAE,EAAE,UAAU,CAAC,CAAC,CAC7F,CAAC;IACF,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,CAAmC,CAAC,iBAAiB,CAAC,CAAC,CAAC;IAC1F,MAAM,kBAAkB,GAAG,MAAM,CAAC,MAAM,CAAW,EAAE,CAAC,CAAC;IACvD,MAAM,gBAAgB,GAAqC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IAC7E,MAAM,QAAQ,GAAmB,MAAM,CAAC,MAAM,CAAC;QAC3C,UAAU,EAAE,CAAC;QACb,IAAI,EAAE,gBAAgB;QACtB,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,EAAE;QACzB,YAAY;QACZ,kBAAkB;QAClB,oBAAoB,EAAE,KAAK;QAC3B,gBAAgB;QAChB,WAAW,EAAE,CAAC;QACd,eAAe;KAClB,CAAC,CAAC;IACH,OAAO,MAAM,CAAC,MAAM,CAAC,0BAA0B,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;AAC1F,CAAC","sourcesContent":["// Copyright (c) 2026 Invinite. Licensed under the MIT License.\n// See the LICENSE file in the repo root for full license text.\n\nimport type {\n    AlertConditionDescriptor,\n    AlertConditionDefinition,\n    CompiledScriptObject,\n    ComputeFn,\n    InputSchema,\n    ScriptManifest,\n} from \"../types.js\";\nimport { attachDepAccessorSentinels } from \"./depAccessorSentinel.js\";\n\n/**\n * Author-supplied options for `defineAlertCondition(...)`. Mirrors\n * `DefineAlertOpts` plus the `conditions` map.\n *\n * @since 0.5\n * @stable\n * @example\n *     const opts: DefineAlertConditionOpts = {\n *         name: \"EMA cross\",\n *         apiVersion: 1,\n *         conditions: {\n *             up: {\n *                 title: \"Up\",\n *                 description: \"Close > EMA\",\n *                 defaultMessage: \"{{ticker}} up\",\n *             },\n *         },\n *         compute: () => {},\n *     };\n *     void opts;\n */\nexport type DefineAlertConditionOpts = Readonly<{\n    name: string;\n    apiVersion: 1;\n    inputs?: InputSchema;\n    conditions: Readonly<Record<string, AlertConditionDescriptor>>;\n    compute: ComputeFn;\n}>;\n\nfunction freezeCondition(\n    id: string,\n    descriptor: AlertConditionDescriptor,\n): AlertConditionDefinition {\n    return Object.freeze({\n        id,\n        title: descriptor.title,\n        description: descriptor.description,\n        defaultMessage: descriptor.defaultMessage,\n    });\n}\n\n/**\n * Construct a Phase-5 alert-condition script. Returns a frozen\n * `CompiledScriptObject` whose `manifest.kind` is `\"alertCondition\"`.\n *\n * @since 0.5\n * @stable\n * @example\n * ```ts\n * import { defineAlertCondition, input, ta } from \"@invinite-org/chartlang-core\";\n *\n * export default defineAlertCondition({\n *     name: \"EMA cross\",\n *     apiVersion: 1,\n *     inputs: { length: input.int(20) },\n *     conditions: {\n *         up: {\n *             title: \"Up\",\n *             description: \"Close > EMA\",\n *             defaultMessage: \"{{ticker}} up\",\n *         },\n *         down: {\n *             title: \"Down\",\n *             description: \"Close < EMA\",\n *             defaultMessage: \"{{ticker}} down\",\n *         },\n *     },\n *     compute({ bar, ta, inputs, signal }) {\n *         const ema = ta.ema(bar.close, inputs.length as number);\n *         signal?.(\"up\", ta.crossover(bar.close, ema).current);\n *         signal?.(\"down\", ta.crossunder(bar.close, ema).current);\n *     },\n * });\n * ```\n */\nexport function defineAlertCondition(opts: DefineAlertConditionOpts): CompiledScriptObject {\n    const alertConditions = Object.freeze(\n        Object.entries(opts.conditions).map(([id, descriptor]) => freezeCondition(id, descriptor)),\n    );\n    const capabilities = Object.freeze<ReadonlyArray<\"alertConditions\">>([\"alertConditions\"]);\n    const requestedIntervals = Object.freeze<string[]>([]);\n    const seriesCapacities: Readonly<Record<string, number>> = Object.freeze({});\n    const manifest: ScriptManifest = Object.freeze({\n        apiVersion: 1,\n        kind: \"alertCondition\",\n        name: opts.name,\n        inputs: opts.inputs ?? {},\n        capabilities,\n        requestedIntervals,\n        userPickableInterval: false,\n        seriesCapacities,\n        maxLookback: 0,\n        alertConditions,\n    });\n    return Object.freeze(attachDepAccessorSentinels({ manifest, compute: opts.compute }));\n}\n"]}

package/dist/define/defineDrawing.d.ts

@@ -30,13 +30,13 @@ export type DefineDrawingOpts = Readonly<{
  * and drawing scripts identically at the per-bar level — the
  * discriminator is a host-side hint the editor uses to distinguish
  * drawing scripts from indicator scripts in the script-picker UI
- * (PLAN.md §4.1).
+ *.
  *
  * `compute({ bar, draw, inputs, ... })` runs per bar; emit drawings via
  * the `draw.*` namespace. Each `draw.<kind>(...)` returns a
  * {@link DrawingHandle} the script can `update(...)` or `remove()`
  * across bars. Phase 4 layers an interactive-anchor-picker UI on top of
- * this constructor (PLAN.md §10.1.1); Phase 3 ships the constructor
+ * this constructor; Phase 3 ships the constructor
  * with fixed anchors so the runtime path can be exercised.
  *
  * @since 0.3

package/dist/define/defineDrawing.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"defineDrawing.d.ts","sourceRoot":"","sources":["../../src/define/defineDrawing.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,oBAAoB,EAAE,SAAS,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC/F,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEtD,KAAK,gBAAgB,GAAG,IAAI,CAAC,eAAe,EAAE,aAAa,GAAG,OAAO,CAAC,CAAC;AAEvE;;;;;;;;;;;;;GAaG;AACH,MAAM,MAAM,iBAAiB,GAAG,QAAQ,CAAC;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,CAAC,CAAC;IACd,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,OAAO,EAAE,SAAS,CAAC;IACnB,+DAA+D;IAC/D,WAAW,CAAC,EAAE,aAAa,CAAC;CAC/B,CAAC,GACE,gBAAgB,CAAC;AAErB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,iBAAiB,GAAG,oBAAoB,CA6B3E"}
+{"version":3,"file":"defineDrawing.d.ts","sourceRoot":"","sources":["../../src/define/defineDrawing.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,oBAAoB,EAAE,SAAS,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/F,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEtD,KAAK,gBAAgB,GAAG,IAAI,CAAC,eAAe,EAAE,aAAa,GAAG,OAAO,CAAC,CAAC;AAEvE;;;;;;;;;;;;;GAaG;AACH,MAAM,MAAM,iBAAiB,GAAG,QAAQ,CAAC;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,CAAC,CAAC;IACd,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,OAAO,EAAE,SAAS,CAAC;IACnB,+DAA+D;IAC/D,WAAW,CAAC,EAAE,aAAa,CAAC;CAC/B,CAAC,GACE,gBAAgB,CAAC;AAErB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,iBAAiB,GAAG,oBAAoB,CA+B3E"}

package/dist/define/defineDrawing.js

@@ -1,5 +1,6 @@
 // Copyright (c) 2026 Invinite. Licensed under the MIT License.
 // See the LICENSE file in the repo root for full license text.
+import { attachDepAccessorSentinels } from "./depAccessorSentinel.js";
 /**
  * Construct a Phase-3 drawing script object. Mirrors `defineIndicator`
  * structurally; only `manifest.kind` (`"drawing"`) and the declared
@@ -7,13 +8,13 @@
  * and drawing scripts identically at the per-bar level — the
  * discriminator is a host-side hint the editor uses to distinguish
  * drawing scripts from indicator scripts in the script-picker UI
- * (PLAN.md §4.1).
+ *.
  *
  * `compute({ bar, draw, inputs, ... })` runs per bar; emit drawings via
  * the `draw.*` namespace. Each `draw.<kind>(...)` returns a
  * {@link DrawingHandle} the script can `update(...)` or `remove()`
  * across bars. Phase 4 layers an interactive-anchor-picker UI on top of
- * this constructor (PLAN.md §10.1.1); Phase 3 ships the constructor
+ * this constructor; Phase 3 ships the constructor
  * with fixed anchors so the runtime path can be exercised.
  *
  * @since 0.3
@@ -59,9 +60,9 @@ export function defineDrawing(opts) {
             : { requiresIntervals: opts.requiresIntervals }),
         ...(opts.shortName === undefined ? {} : { shortName: opts.shortName }),
     };
-    return Object.freeze({
+    return Object.freeze(attachDepAccessorSentinels({
         manifest: Object.freeze(manifest),
         compute: opts.compute,
-    });
+    }));
 }
 //# sourceMappingURL=defineDrawing.js.map

package/dist/define/defineDrawing.js.map

@@ -1 +1 @@
-{"version":3,"file":"defineDrawing.js","sourceRoot":"","sources":["../../src/define/defineDrawing.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,+DAA+D;AA+B/D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,MAAM,UAAU,aAAa,CAAC,IAAuB;IACjD,MAAM,YAAY,GAA8B,MAAM,CAAC,MAAM,CAAe,CAAC,UAAU,CAAC,CAAC,CAAC;IAC1F,MAAM,kBAAkB,GAA0B,MAAM,CAAC,MAAM,CAAW,EAAE,CAAC,CAAC;IAC9E,MAAM,gBAAgB,GAAqC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IAC7E,MAAM,IAAI,GAAG;QACT,UAAU,EAAE,CAAU;QACtB,IAAI,EAAE,SAAkB;QACxB,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,EAAE;QACzB,YAAY;QACZ,kBAAkB;QAClB,oBAAoB,EAAE,KAAK;QAC3B,gBAAgB;QAChB,WAAW,EAAE,CAAC;KACjB,CAAC;IACF,MAAM,QAAQ,GAAG;QACb,GAAG,IAAI;QACP,GAAG,CAAC,IAAI,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE,CAAC;QAC5E,GAAG,CAAC,IAAI,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC;QAC7D,GAAG,CAAC,IAAI,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC;QACtE,GAAG,CAAC,IAAI,CAAC,iBAAiB,KAAK,SAAS;YACpC,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC,EAAE,iBAAiB,EAAE,IAAI,CAAC,iBAAiB,EAAE,CAAC;QACpD,GAAG,CAAC,IAAI,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC;KACzE,CAAC;IACF,OAAO,MAAM,CAAC,MAAM,CAAC;QACjB,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC;QACjC,OAAO,EAAE,IAAI,CAAC,OAAO;KACxB,CAAC,CAAC;AACP,CAAC"}
+{"version":3,"file":"defineDrawing.js","sourceRoot":"","sources":["../../src/define/defineDrawing.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,+DAA+D;AAG/D,OAAO,EAAE,0BAA0B,EAAE,MAAM,0BAA0B,CAAC;AA6BtE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,MAAM,UAAU,aAAa,CAAC,IAAuB;IACjD,MAAM,YAAY,GAA8B,MAAM,CAAC,MAAM,CAAe,CAAC,UAAU,CAAC,CAAC,CAAC;IAC1F,MAAM,kBAAkB,GAA0B,MAAM,CAAC,MAAM,CAAW,EAAE,CAAC,CAAC;IAC9E,MAAM,gBAAgB,GAAqC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IAC7E,MAAM,IAAI,GAAG;QACT,UAAU,EAAE,CAAU;QACtB,IAAI,EAAE,SAAkB;QACxB,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,EAAE;QACzB,YAAY;QACZ,kBAAkB;QAClB,oBAAoB,EAAE,KAAK;QAC3B,gBAAgB;QAChB,WAAW,EAAE,CAAC;KACjB,CAAC;IACF,MAAM,QAAQ,GAAG;QACb,GAAG,IAAI;QACP,GAAG,CAAC,IAAI,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE,CAAC;QAC5E,GAAG,CAAC,IAAI,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC;QAC7D,GAAG,CAAC,IAAI,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC;QACtE,GAAG,CAAC,IAAI,CAAC,iBAAiB,KAAK,SAAS;YACpC,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC,EAAE,iBAAiB,EAAE,IAAI,CAAC,iBAAiB,EAAE,CAAC;QACpD,GAAG,CAAC,IAAI,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC;KACzE,CAAC;IACF,OAAO,MAAM,CAAC,MAAM,CAChB,0BAA0B,CAAC;QACvB,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC;QACjC,OAAO,EAAE,IAAI,CAAC,OAAO;KACxB,CAAC,CACL,CAAC;AACN,CAAC","sourcesContent":["// Copyright (c) 2026 Invinite. Licensed under the MIT License.\n// See the LICENSE file in the repo root for full license text.\n\nimport type { CompiledScriptObject, ComputeFn, DrawingCounts, InputSchema } from \"../types.js\";\nimport { attachDepAccessorSentinels } from \"./depAccessorSentinel.js\";\nimport type { ScriptOverrides } from \"./overrides.js\";\n\ntype DrawingOverrides = Omit<ScriptOverrides, \"maxBarsBack\" | \"scale\">;\n\n/**\n * Author-supplied options the script passes to `defineDrawing(...)`. Same\n * shape as `DefineAlertOpts` (no indicator-only `overlay` flag) plus the\n * Phase-3 `maxDrawings` per-bucket cap from `DefineIndicatorOpts`.\n *\n * @since 0.3\n * @stable\n * @example\n *     const opts: DefineDrawingOpts = {\n *         name: \"Interactive Fib Retracement\",\n *         apiVersion: 1,\n *         compute: () => {},\n *     };\n */\nexport type DefineDrawingOpts = Readonly<{\n    name: string;\n    apiVersion: 1;\n    inputs?: InputSchema;\n    compute: ComputeFn;\n    /** Per-bucket cap on `draw.*` emissions per bar. @since 0.3 */\n    maxDrawings?: DrawingCounts;\n}> &\n    DrawingOverrides;\n\n/**\n * Construct a Phase-3 drawing script object. Mirrors `defineIndicator`\n * structurally; only `manifest.kind` (`\"drawing\"`) and the declared\n * `capabilities` (`[\"drawings\"]`) differ. The runtime treats indicator\n * and drawing scripts identically at the per-bar level — the\n * discriminator is a host-side hint the editor uses to distinguish\n * drawing scripts from indicator scripts in the script-picker UI\n *.\n *\n * `compute({ bar, draw, inputs, ... })` runs per bar; emit drawings via\n * the `draw.*` namespace. Each `draw.<kind>(...)` returns a\n * {@link DrawingHandle} the script can `update(...)` or `remove()`\n * across bars. Phase 4 layers an interactive-anchor-picker UI on top of\n * this constructor; Phase 3 ships the constructor\n * with fixed anchors so the runtime path can be exercised.\n *\n * @since 0.3\n * @stable\n * @example\n * ```ts\n * import { defineDrawing } from \"@invinite-org/chartlang-core\";\n *\n * export default defineDrawing({\n *     name: \"Interactive Fib Retracement\",\n *     apiVersion: 1,\n *     compute: ({ draw }) => {\n *         draw.fibRetracement(\n *             { time: 1_700_000_000_000, price: 100 },\n *             { time: 1_700_086_400_000, price: 110 },\n *         );\n *     },\n * });\n * ```\n */\nexport function defineDrawing(opts: DefineDrawingOpts): CompiledScriptObject {\n    const capabilities: ReadonlyArray<\"drawings\"> = Object.freeze<[\"drawings\"]>([\"drawings\"]);\n    const requestedIntervals: ReadonlyArray<string> = Object.freeze<string[]>([]);\n    const seriesCapacities: Readonly<Record<string, number>> = Object.freeze({});\n    const base = {\n        apiVersion: 1 as const,\n        kind: \"drawing\" as const,\n        name: opts.name,\n        inputs: opts.inputs ?? {},\n        capabilities,\n        requestedIntervals,\n        userPickableInterval: false,\n        seriesCapacities,\n        maxLookback: 0,\n    };\n    const manifest = {\n        ...base,\n        ...(opts.maxDrawings === undefined ? {} : { maxDrawings: opts.maxDrawings }),\n        ...(opts.format === undefined ? {} : { format: opts.format }),\n        ...(opts.precision === undefined ? {} : { precision: opts.precision }),\n        ...(opts.requiresIntervals === undefined\n            ? {}\n            : { requiresIntervals: opts.requiresIntervals }),\n        ...(opts.shortName === undefined ? {} : { shortName: opts.shortName }),\n    };\n    return Object.freeze(\n        attachDepAccessorSentinels({\n            manifest: Object.freeze(manifest),\n            compute: opts.compute,\n        }),\n    );\n}\n"]}

package/dist/define/defineIndicator.d.ts

@@ -1,4 +1,5 @@
 import type { CompiledScriptObject, ComputeFn, DrawingCounts, InputSchema } from "../types.js";
+import type { OutputDeclaration } from "./dependency.js";
 import type { ScriptOverrides } from "./overrides.js";
 /**
  * Author-supplied options the script passes to `defineIndicator(...)`. The
@@ -24,6 +25,16 @@ export type DefineIndicatorOpts = Readonly<{
     compute: ComputeFn;
     /** Per-bucket cap on `draw.*` emissions per bar. @since 0.3 */
     maxDrawings?: DrawingCounts;
+    /**
+     * Titled outputs this producer exposes for `<binding>.output(...)`
+     * consumption. Injected by the compiler from the producer's
+     * `plot(value, { title })` calls so the runtime object is
+     * self-describing — hosts read `manifest.outputs` to allocate the
+     * dep-output ring buffer. Hand-authored scripts omit it; absent
+     * `outputs` keeps the emitted manifest byte-identical to a script
+     * with no titled plots. @since 0.7
+     */
+    outputs?: ReadonlyArray<OutputDeclaration>;
 }> & ScriptOverrides;
 /**
  * Construct a Phase-1 indicator script object. Returns a frozen

package/dist/define/defineIndicator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"defineIndicator.d.ts","sourceRoot":"","sources":["../../src/define/defineIndicator.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,oBAAoB,EAAE,SAAS,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC/F,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEtD;;;;;;;;;;;;;;;GAeG;AACH,MAAM,MAAM,mBAAmB,GAAG,QAAQ,CAAC;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,CAAC,CAAC;IACd,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,OAAO,EAAE,SAAS,CAAC;IACnB,+DAA+D;IAC/D,WAAW,CAAC,EAAE,aAAa,CAAC;CAC/B,CAAC,GACE,eAAe,CAAC;AAEpB;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,mBAAmB,GAAG,oBAAoB,CA+B/E"}
+{"version":3,"file":"defineIndicator.d.ts","sourceRoot":"","sources":["../../src/define/defineIndicator.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,oBAAoB,EAAE,SAAS,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/F,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACzD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEtD;;;;;;;;;;;;;;;GAeG;AACH,MAAM,MAAM,mBAAmB,GAAG,QAAQ,CAAC;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,CAAC,CAAC;IACd,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,OAAO,EAAE,SAAS,CAAC;IACnB,+DAA+D;IAC/D,WAAW,CAAC,EAAE,aAAa,CAAC;IAC5B;;;;;;;;OAQG;IACH,OAAO,CAAC,EAAE,aAAa,CAAC,iBAAiB,CAAC,CAAC;CAC9C,CAAC,GACE,eAAe,CAAC;AAEpB;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,mBAAmB,GAAG,oBAAoB,CAmC/E"}

package/dist/define/defineIndicator.js

@@ -1,5 +1,6 @@
 // Copyright (c) 2026 Invinite. Licensed under the MIT License.
 // See the LICENSE file in the repo root for full license text.
+import { attachDepAccessorSentinels } from "./depAccessorSentinel.js";
 /**
  * Construct a Phase-1 indicator script object. Returns a frozen
  * `CompiledScriptObject` with a default manifest the compiler later overrides
@@ -36,6 +37,7 @@ export function defineIndicator(opts) {
     };
     const manifest = {
         ...base,
+        ...(opts.overlay === undefined ? {} : { overlay: opts.overlay }),
         ...(opts.maxDrawings === undefined ? {} : { maxDrawings: opts.maxDrawings }),
         ...(opts.maxBarsBack === undefined ? {} : { maxBarsBack: opts.maxBarsBack }),
         ...(opts.format === undefined ? {} : { format: opts.format }),
@@ -45,10 +47,11 @@ export function defineIndicator(opts) {
             ? {}
             : { requiresIntervals: opts.requiresIntervals }),
         ...(opts.shortName === undefined ? {} : { shortName: opts.shortName }),
+        ...(opts.outputs === undefined ? {} : { outputs: opts.outputs }),
     };
-    return Object.freeze({
+    return Object.freeze(attachDepAccessorSentinels({
         manifest: Object.freeze(manifest),
         compute: opts.compute,
-    });
+    }));
 }
 //# sourceMappingURL=defineIndicator.js.map

package/dist/define/defineIndicator.js.map

@@ -1 +1 @@
-{"version":3,"file":"defineIndicator.js","sourceRoot":"","sources":["../../src/define/defineIndicator.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,+DAA+D;AAgC/D;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,eAAe,CAAC,IAAyB;IACrD,MAAM,YAAY,GAAgC,MAAM,CAAC,MAAM,CAAiB,CAAC,YAAY,CAAC,CAAC,CAAC;IAChG,MAAM,kBAAkB,GAA0B,MAAM,CAAC,MAAM,CAAW,EAAE,CAAC,CAAC;IAC9E,MAAM,gBAAgB,GAAqC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IAC7E,MAAM,IAAI,GAAG;QACT,UAAU,EAAE,CAAU;QACtB,IAAI,EAAE,WAAoB;QAC1B,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,EAAE;QACzB,YAAY;QACZ,kBAAkB;QAClB,oBAAoB,EAAE,KAAK;QAC3B,gBAAgB;QAChB,WAAW,EAAE,CAAC;KACjB,CAAC;IACF,MAAM,QAAQ,GAAG;QACb,GAAG,IAAI;QACP,GAAG,CAAC,IAAI,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE,CAAC;QAC5E,GAAG,CAAC,IAAI,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE,CAAC;QAC5E,GAAG,CAAC,IAAI,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC;QAC7D,GAAG,CAAC,IAAI,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC;QACtE,GAAG,CAAC,IAAI,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC;QAC1D,GAAG,CAAC,IAAI,CAAC,iBAAiB,KAAK,SAAS;YACpC,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC,EAAE,iBAAiB,EAAE,IAAI,CAAC,iBAAiB,EAAE,CAAC;QACpD,GAAG,CAAC,IAAI,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC;KACzE,CAAC;IACF,OAAO,MAAM,CAAC,MAAM,CAAC;QACjB,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC;QACjC,OAAO,EAAE,IAAI,CAAC,OAAO;KACxB,CAAC,CAAC;AACP,CAAC"}
+{"version":3,"file":"defineIndicator.js","sourceRoot":"","sources":["../../src/define/defineIndicator.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,+DAA+D;AAG/D,OAAO,EAAE,0BAA0B,EAAE,MAAM,0BAA0B,CAAC;AAyCtE;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,eAAe,CAAC,IAAyB;IACrD,MAAM,YAAY,GAAgC,MAAM,CAAC,MAAM,CAAiB,CAAC,YAAY,CAAC,CAAC,CAAC;IAChG,MAAM,kBAAkB,GAA0B,MAAM,CAAC,MAAM,CAAW,EAAE,CAAC,CAAC;IAC9E,MAAM,gBAAgB,GAAqC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IAC7E,MAAM,IAAI,GAAG;QACT,UAAU,EAAE,CAAU;QACtB,IAAI,EAAE,WAAoB;QAC1B,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,EAAE;QACzB,YAAY;QACZ,kBAAkB;QAClB,oBAAoB,EAAE,KAAK;QAC3B,gBAAgB;QAChB,WAAW,EAAE,CAAC;KACjB,CAAC;IACF,MAAM,QAAQ,GAAG;QACb,GAAG,IAAI;QACP,GAAG,CAAC,IAAI,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC;QAChE,GAAG,CAAC,IAAI,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE,CAAC;QAC5E,GAAG,CAAC,IAAI,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE,CAAC;QAC5E,GAAG,CAAC,IAAI,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC;QAC7D,GAAG,CAAC,IAAI,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC;QACtE,GAAG,CAAC,IAAI,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC;QAC1D,GAAG,CAAC,IAAI,CAAC,iBAAiB,KAAK,SAAS;YACpC,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC,EAAE,iBAAiB,EAAE,IAAI,CAAC,iBAAiB,EAAE,CAAC;QACpD,GAAG,CAAC,IAAI,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC;QACtE,GAAG,CAAC,IAAI,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC;KACnE,CAAC;IACF,OAAO,MAAM,CAAC,MAAM,CAChB,0BAA0B,CAAC;QACvB,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC;QACjC,OAAO,EAAE,IAAI,CAAC,OAAO;KACxB,CAAC,CACL,CAAC;AACN,CAAC","sourcesContent":["// Copyright (c) 2026 Invinite. Licensed under the MIT License.\n// See the LICENSE file in the repo root for full license text.\n\nimport type { CompiledScriptObject, ComputeFn, DrawingCounts, InputSchema } from \"../types.js\";\nimport { attachDepAccessorSentinels } from \"./depAccessorSentinel.js\";\nimport type { OutputDeclaration } from \"./dependency.js\";\nimport type { ScriptOverrides } from \"./overrides.js\";\n\n/**\n * Author-supplied options the script passes to `defineIndicator(...)`. The\n * compiler reads this object's static shape to build the script's manifest;\n * any field can be overridden at compile time via the AST transform.\n *\n * `maxDrawings` (Phase 3 / §10 / §4.1) caps the per-bucket `draw.*`\n * emission rate per bar. Omit to default to the adapter's cap.\n *\n * @since 0.1\n * @example\n *     const opts: DefineIndicatorOpts = {\n *         name: \"demo\",\n *         apiVersion: 1,\n *         compute: () => {},\n *     };\n */\nexport type DefineIndicatorOpts = Readonly<{\n    name: string;\n    apiVersion: 1;\n    overlay?: boolean;\n    inputs?: InputSchema;\n    compute: ComputeFn;\n    /** Per-bucket cap on `draw.*` emissions per bar. @since 0.3 */\n    maxDrawings?: DrawingCounts;\n    /**\n     * Titled outputs this producer exposes for `<binding>.output(...)`\n     * consumption. Injected by the compiler from the producer's\n     * `plot(value, { title })` calls so the runtime object is\n     * self-describing — hosts read `manifest.outputs` to allocate the\n     * dep-output ring buffer. Hand-authored scripts omit it; absent\n     * `outputs` keeps the emitted manifest byte-identical to a script\n     * with no titled plots. @since 0.7\n     */\n    outputs?: ReadonlyArray<OutputDeclaration>;\n}> &\n    ScriptOverrides;\n\n/**\n * Construct a Phase-1 indicator script object. Returns a frozen\n * `CompiledScriptObject` with a default manifest the compiler later overrides\n * (extracts `capabilities` from primitive usage, `maxLookback` from\n * `series[N]` reads). The defaults let the constructor work in unit tests\n * before the compiler runs.\n *\n * @since 0.1\n * @example\n * ```ts\n * import { defineIndicator } from \"@invinite-org/chartlang-core\";\n *\n * export default defineIndicator({\n *     name: \"EMA(20)\",\n *     apiVersion: 1,\n *     compute: ({ bar, plot }) => { plot(bar.close); },\n * });\n * ```\n */\nexport function defineIndicator(opts: DefineIndicatorOpts): CompiledScriptObject {\n    const capabilities: ReadonlyArray<\"indicators\"> = Object.freeze<[\"indicators\"]>([\"indicators\"]);\n    const requestedIntervals: ReadonlyArray<string> = Object.freeze<string[]>([]);\n    const seriesCapacities: Readonly<Record<string, number>> = Object.freeze({});\n    const base = {\n        apiVersion: 1 as const,\n        kind: \"indicator\" as const,\n        name: opts.name,\n        inputs: opts.inputs ?? {},\n        capabilities,\n        requestedIntervals,\n        userPickableInterval: false,\n        seriesCapacities,\n        maxLookback: 0,\n    };\n    const manifest = {\n        ...base,\n        ...(opts.overlay === undefined ? {} : { overlay: opts.overlay }),\n        ...(opts.maxDrawings === undefined ? {} : { maxDrawings: opts.maxDrawings }),\n        ...(opts.maxBarsBack === undefined ? {} : { maxBarsBack: opts.maxBarsBack }),\n        ...(opts.format === undefined ? {} : { format: opts.format }),\n        ...(opts.precision === undefined ? {} : { precision: opts.precision }),\n        ...(opts.scale === undefined ? {} : { scale: opts.scale }),\n        ...(opts.requiresIntervals === undefined\n            ? {}\n            : { requiresIntervals: opts.requiresIntervals }),\n        ...(opts.shortName === undefined ? {} : { shortName: opts.shortName }),\n        ...(opts.outputs === undefined ? {} : { outputs: opts.outputs }),\n    };\n    return Object.freeze(\n        attachDepAccessorSentinels({\n            manifest: Object.freeze(manifest),\n            compute: opts.compute,\n        }),\n    );\n}\n"]}

package/dist/define/depAccessorSentinel.d.ts

@@ -0,0 +1,46 @@
+import type { CompiledScriptObject, ComputeFn, ScriptManifest } from "../types.js";
+/**
+ * Sentinel thrown when `output` / `withInputs` are called outside the
+ * compiler-rewritten bundle path. The Phase-7 compiler statically
+ * replaces every consumer-side `.output("title")` call site with a
+ * synthesised `__chartlang_depOutput(...)` runtime call, and every
+ * `.withInputs({...})` chain with a folded dep manifest, so these
+ * bodies are unreachable when the bundle is loaded normally. Hand-
+ * running an un-compiled script in a unit test hits the sentinel,
+ * which is the desired failure.
+ *
+ * @since 0.7
+ * @stable
+ * @example
+ *     try {
+ *         depAccessorSentinel("output(\"line\")");
+ *     } catch (err) {
+ *         void (err as Error).message;
+ *     }
+ */
+export declare const depAccessorSentinel: (name: string) => never;
+/**
+ * Attach the {@link depAccessorSentinel}-backed `output` /
+ * `withInputs` accessors to a `{ manifest, compute }` pair so the
+ * `defineIndicator` / `defineAlert` / `defineDrawing` /
+ * `defineAlertCondition` constructors return a complete
+ * {@link CompiledScriptObject}. The compiler rewrites both accessors
+ * to static dep lookups at bundle time — the throwing bodies only
+ * fire when an un-compiled module is invoked directly.
+ *
+ * @since 0.7
+ * @stable
+ * @example
+ *     declare const manifest: ScriptManifest;
+ *     declare const compute: ComputeFn;
+ *     const cs: CompiledScriptObject = attachDepAccessorSentinels({
+ *         manifest,
+ *         compute,
+ *     });
+ *     void cs;
+ */
+export declare const attachDepAccessorSentinels: (base: Readonly<{
+    manifest: ScriptManifest;
+    compute: ComputeFn;
+}>) => CompiledScriptObject;
+//# sourceMappingURL=depAccessorSentinel.d.ts.map

package/dist/define/depAccessorSentinel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"depAccessorSentinel.d.ts","sourceRoot":"","sources":["../../src/define/depAccessorSentinel.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,oBAAoB,EAAE,SAAS,EAAE,cAAc,EAAU,MAAM,aAAa,CAAC;AAE3F;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,mBAAmB,GAAI,MAAM,MAAM,KAAG,KAIlD,CAAC;AAEF;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,0BAA0B,GACnC,MAAM,QAAQ,CAAC;IAAE,QAAQ,EAAE,cAAc,CAAC;IAAC,OAAO,EAAE,SAAS,CAAA;CAAE,CAAC,KACjE,oBAKD,CAAC"}

package/dist/define/depAccessorSentinel.js

@@ -0,0 +1,51 @@
+// Copyright (c) 2026 Invinite. Licensed under the MIT License.
+// See the LICENSE file in the repo root for full license text.
+/**
+ * Sentinel thrown when `output` / `withInputs` are called outside the
+ * compiler-rewritten bundle path. The Phase-7 compiler statically
+ * replaces every consumer-side `.output("title")` call site with a
+ * synthesised `__chartlang_depOutput(...)` runtime call, and every
+ * `.withInputs({...})` chain with a folded dep manifest, so these
+ * bodies are unreachable when the bundle is loaded normally. Hand-
+ * running an un-compiled script in a unit test hits the sentinel,
+ * which is the desired failure.
+ *
+ * @since 0.7
+ * @stable
+ * @example
+ *     try {
+ *         depAccessorSentinel("output(\"line\")");
+ *     } catch (err) {
+ *         void (err as Error).message;
+ *     }
+ */
+export const depAccessorSentinel = (name) => {
+    throw new Error(`${name} can only be called on a compiled chartlang indicator binding inside another indicator's compute body`);
+};
+/**
+ * Attach the {@link depAccessorSentinel}-backed `output` /
+ * `withInputs` accessors to a `{ manifest, compute }` pair so the
+ * `defineIndicator` / `defineAlert` / `defineDrawing` /
+ * `defineAlertCondition` constructors return a complete
+ * {@link CompiledScriptObject}. The compiler rewrites both accessors
+ * to static dep lookups at bundle time — the throwing bodies only
+ * fire when an un-compiled module is invoked directly.
+ *
+ * @since 0.7
+ * @stable
+ * @example
+ *     declare const manifest: ScriptManifest;
+ *     declare const compute: ComputeFn;
+ *     const cs: CompiledScriptObject = attachDepAccessorSentinels({
+ *         manifest,
+ *         compute,
+ *     });
+ *     void cs;
+ */
+export const attachDepAccessorSentinels = (base) => ({
+    manifest: base.manifest,
+    compute: base.compute,
+    output: (name) => depAccessorSentinel(`output("${name}")`),
+    withInputs: () => depAccessorSentinel("withInputs"),
+});
+//# sourceMappingURL=depAccessorSentinel.js.map

package/dist/define/depAccessorSentinel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"depAccessorSentinel.js","sourceRoot":"","sources":["../../src/define/depAccessorSentinel.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,+DAA+D;AAI/D;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,IAAY,EAAS,EAAE;IACvD,MAAM,IAAI,KAAK,CACX,GAAG,IAAI,uGAAuG,CACjH,CAAC;AACN,CAAC,CAAC;AAEF;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG,CACtC,IAAgE,EAC5C,EAAE,CAAC,CAAC;IACxB,QAAQ,EAAE,IAAI,CAAC,QAAQ;IACvB,OAAO,EAAE,IAAI,CAAC,OAAO;IACrB,MAAM,EAAE,CAAC,IAAY,EAAkB,EAAE,CAAC,mBAAmB,CAAC,WAAW,IAAI,IAAI,CAAC;IAClF,UAAU,EAAE,GAAyB,EAAE,CAAC,mBAAmB,CAAC,YAAY,CAAC;CAC5E,CAAC,CAAC","sourcesContent":["// Copyright (c) 2026 Invinite. Licensed under the MIT License.\n// See the LICENSE file in the repo root for full license text.\n\nimport type { CompiledScriptObject, ComputeFn, ScriptManifest, Series } from \"../types.js\";\n\n/**\n * Sentinel thrown when `output` / `withInputs` are called outside the\n * compiler-rewritten bundle path. The Phase-7 compiler statically\n * replaces every consumer-side `.output(\"title\")` call site with a\n * synthesised `__chartlang_depOutput(...)` runtime call, and every\n * `.withInputs({...})` chain with a folded dep manifest, so these\n * bodies are unreachable when the bundle is loaded normally. Hand-\n * running an un-compiled script in a unit test hits the sentinel,\n * which is the desired failure.\n *\n * @since 0.7\n * @stable\n * @example\n *     try {\n *         depAccessorSentinel(\"output(\\\"line\\\")\");\n *     } catch (err) {\n *         void (err as Error).message;\n *     }\n */\nexport const depAccessorSentinel = (name: string): never => {\n    throw new Error(\n        `${name} can only be called on a compiled chartlang indicator binding inside another indicator's compute body`,\n    );\n};\n\n/**\n * Attach the {@link depAccessorSentinel}-backed `output` /\n * `withInputs` accessors to a `{ manifest, compute }` pair so the\n * `defineIndicator` / `defineAlert` / `defineDrawing` /\n * `defineAlertCondition` constructors return a complete\n * {@link CompiledScriptObject}. The compiler rewrites both accessors\n * to static dep lookups at bundle time — the throwing bodies only\n * fire when an un-compiled module is invoked directly.\n *\n * @since 0.7\n * @stable\n * @example\n *     declare const manifest: ScriptManifest;\n *     declare const compute: ComputeFn;\n *     const cs: CompiledScriptObject = attachDepAccessorSentinels({\n *         manifest,\n *         compute,\n *     });\n *     void cs;\n */\nexport const attachDepAccessorSentinels = (\n    base: Readonly<{ manifest: ScriptManifest; compute: ComputeFn }>,\n): CompiledScriptObject => ({\n    manifest: base.manifest,\n    compute: base.compute,\n    output: (name: string): Series<number> => depAccessorSentinel(`output(\"${name}\")`),\n    withInputs: (): CompiledScriptObject => depAccessorSentinel(\"withInputs\"),\n});\n"]}