@invinite-org/chartlang-core 1.0.1

package/dist/define/defineAlert.d.ts

@@ -0,0 +1,43 @@
+import type { CompiledScriptObject, ComputeFn, InputSchema } from "../types.js";
+import type { ScriptOverrides } from "./overrides.js";
+type AlertOverrides = Omit<ScriptOverrides, "scale" | "format" | "precision">;
+/**
+ * Author-supplied options the script passes to `defineAlert(...)`. Same shape
+ * as `DefineIndicatorOpts` minus the indicator-only `overlay` flag — alert
+ * scripts have no plot output.
+ *
+ * @since 0.1
+ * @example
+ *     const opts: DefineAlertOpts = {
+ *         name: "RSI overbought",
+ *         apiVersion: 1,
+ *         compute: () => {},
+ *     };
+ */
+export type DefineAlertOpts = Readonly<{
+    name: string;
+    apiVersion: 1;
+    inputs?: InputSchema;
+    compute: ComputeFn;
+}> & AlertOverrides;
+/**
+ * Construct a Phase-1 alert script object. Returns a frozen
+ * `CompiledScriptObject` whose `manifest.kind` is `"alert"` and whose
+ * declared `capabilities` is `["alerts"]`. Same compile-time override
+ * semantics as `defineIndicator`.
+ *
+ * @since 0.1
+ * @example
+ * ```ts
+ * import { defineAlert } from "@invinite-org/chartlang-core";
+ *
+ * export default defineAlert({
+ *     name: "RSI > 70",
+ *     apiVersion: 1,
+ *     compute: ({ alert }) => { alert("overbought"); },
+ * });
+ * ```
+ */
+export declare function defineAlert(opts: DefineAlertOpts): CompiledScriptObject;
+export {};
+//# sourceMappingURL=defineAlert.d.ts.map

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

@@ -0,0 +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"}

package/dist/define/defineAlert.js

@@ -0,0 +1,49 @@
+// Copyright (c) 2026 Invinite. Licensed under the MIT License.
+// See the LICENSE file in the repo root for full license text.
+/**
+ * Construct a Phase-1 alert script object. Returns a frozen
+ * `CompiledScriptObject` whose `manifest.kind` is `"alert"` and whose
+ * declared `capabilities` is `["alerts"]`. Same compile-time override
+ * semantics as `defineIndicator`.
+ *
+ * @since 0.1
+ * @example
+ * ```ts
+ * import { defineAlert } from "@invinite-org/chartlang-core";
+ *
+ * export default defineAlert({
+ *     name: "RSI > 70",
+ *     apiVersion: 1,
+ *     compute: ({ alert }) => { alert("overbought"); },
+ * });
+ * ```
+ */
+export function defineAlert(opts) {
+    const capabilities = Object.freeze(["alerts"]);
+    const requestedIntervals = Object.freeze([]);
+    const seriesCapacities = Object.freeze({});
+    const base = {
+        apiVersion: 1,
+        kind: "alert",
+        name: opts.name,
+        inputs: opts.inputs ?? {},
+        capabilities,
+        requestedIntervals,
+        userPickableInterval: false,
+        seriesCapacities,
+        maxLookback: 0,
+    };
+    const manifest = {
+        ...base,
+        ...(opts.maxBarsBack === undefined ? {} : { maxBarsBack: opts.maxBarsBack }),
+        ...(opts.requiresIntervals === undefined
+            ? {}
+            : { requiresIntervals: opts.requiresIntervals }),
+        ...(opts.shortName === undefined ? {} : { shortName: opts.shortName }),
+    };
+    return Object.freeze({
+        manifest: Object.freeze(manifest),
+        compute: opts.compute,
+    });
+}
+//# sourceMappingURL=defineAlert.js.map

package/dist/define/defineAlert.js.map

@@ -0,0 +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"}

package/dist/define/defineAlertCondition.d.ts

@@ -0,0 +1,65 @@
+import type { AlertConditionDescriptor, CompiledScriptObject, ComputeFn, InputSchema } from "../types.js";
+/**
+ * Author-supplied options for `defineAlertCondition(...)`. Mirrors
+ * `DefineAlertOpts` plus the `conditions` map.
+ *
+ * @since 0.5
+ * @stable
+ * @example
+ *     const opts: DefineAlertConditionOpts = {
+ *         name: "EMA cross",
+ *         apiVersion: 1,
+ *         conditions: {
+ *             up: {
+ *                 title: "Up",
+ *                 description: "Close > EMA",
+ *                 defaultMessage: "{{ticker}} up",
+ *             },
+ *         },
+ *         compute: () => {},
+ *     };
+ *     void opts;
+ */
+export type DefineAlertConditionOpts = Readonly<{
+    name: string;
+    apiVersion: 1;
+    inputs?: InputSchema;
+    conditions: Readonly<Record<string, AlertConditionDescriptor>>;
+    compute: ComputeFn;
+}>;
+/**
+ * Construct a Phase-5 alert-condition script. Returns a frozen
+ * `CompiledScriptObject` whose `manifest.kind` is `"alertCondition"`.
+ *
+ * @since 0.5
+ * @stable
+ * @example
+ * ```ts
+ * import { defineAlertCondition, input, ta } from "@invinite-org/chartlang-core";
+ *
+ * export default defineAlertCondition({
+ *     name: "EMA cross",
+ *     apiVersion: 1,
+ *     inputs: { length: input.int(20) },
+ *     conditions: {
+ *         up: {
+ *             title: "Up",
+ *             description: "Close > EMA",
+ *             defaultMessage: "{{ticker}} up",
+ *         },
+ *         down: {
+ *             title: "Down",
+ *             description: "Close < EMA",
+ *             defaultMessage: "{{ticker}} down",
+ *         },
+ *     },
+ *     compute({ bar, ta, inputs, signal }) {
+ *         const ema = ta.ema(bar.close, inputs.length as number);
+ *         signal?.("up", ta.crossover(bar.close, ema).current);
+ *         signal?.("down", ta.crossunder(bar.close, ema).current);
+ *     },
+ * });
+ * ```
+ */
+export declare function defineAlertCondition(opts: DefineAlertConditionOpts): CompiledScriptObject;
+//# sourceMappingURL=defineAlertCondition.d.ts.map

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

@@ -0,0 +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"}

package/dist/define/defineAlertCondition.js

@@ -0,0 +1,64 @@
+// Copyright (c) 2026 Invinite. Licensed under the MIT License.
+// See the LICENSE file in the repo root for full license text.
+function freezeCondition(id, descriptor) {
+    return Object.freeze({
+        id,
+        title: descriptor.title,
+        description: descriptor.description,
+        defaultMessage: descriptor.defaultMessage,
+    });
+}
+/**
+ * Construct a Phase-5 alert-condition script. Returns a frozen
+ * `CompiledScriptObject` whose `manifest.kind` is `"alertCondition"`.
+ *
+ * @since 0.5
+ * @stable
+ * @example
+ * ```ts
+ * import { defineAlertCondition, input, ta } from "@invinite-org/chartlang-core";
+ *
+ * export default defineAlertCondition({
+ *     name: "EMA cross",
+ *     apiVersion: 1,
+ *     inputs: { length: input.int(20) },
+ *     conditions: {
+ *         up: {
+ *             title: "Up",
+ *             description: "Close > EMA",
+ *             defaultMessage: "{{ticker}} up",
+ *         },
+ *         down: {
+ *             title: "Down",
+ *             description: "Close < EMA",
+ *             defaultMessage: "{{ticker}} down",
+ *         },
+ *     },
+ *     compute({ bar, ta, inputs, signal }) {
+ *         const ema = ta.ema(bar.close, inputs.length as number);
+ *         signal?.("up", ta.crossover(bar.close, ema).current);
+ *         signal?.("down", ta.crossunder(bar.close, ema).current);
+ *     },
+ * });
+ * ```
+ */
+export function defineAlertCondition(opts) {
+    const alertConditions = Object.freeze(Object.entries(opts.conditions).map(([id, descriptor]) => freezeCondition(id, descriptor)));
+    const capabilities = Object.freeze(["alertConditions"]);
+    const requestedIntervals = Object.freeze([]);
+    const seriesCapacities = Object.freeze({});
+    const manifest = Object.freeze({
+        apiVersion: 1,
+        kind: "alertCondition",
+        name: opts.name,
+        inputs: opts.inputs ?? {},
+        capabilities,
+        requestedIntervals,
+        userPickableInterval: false,
+        seriesCapacities,
+        maxLookback: 0,
+        alertConditions,
+    });
+    return Object.freeze({ manifest, compute: opts.compute });
+}
+//# sourceMappingURL=defineAlertCondition.js.map

package/dist/define/defineAlertCondition.js.map

@@ -0,0 +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"}

package/dist/define/defineDrawing.d.ts

@@ -0,0 +1,62 @@
+import type { CompiledScriptObject, ComputeFn, DrawingCounts, InputSchema } from "../types.js";
+import type { ScriptOverrides } from "./overrides.js";
+type DrawingOverrides = Omit<ScriptOverrides, "maxBarsBack" | "scale">;
+/**
+ * Author-supplied options the script passes to `defineDrawing(...)`. Same
+ * shape as `DefineAlertOpts` (no indicator-only `overlay` flag) plus the
+ * Phase-3 `maxDrawings` per-bucket cap from `DefineIndicatorOpts`.
+ *
+ * @since 0.3
+ * @stable
+ * @example
+ *     const opts: DefineDrawingOpts = {
+ *         name: "Interactive Fib Retracement",
+ *         apiVersion: 1,
+ *         compute: () => {},
+ *     };
+ */
+export type DefineDrawingOpts = Readonly<{
+    name: string;
+    apiVersion: 1;
+    inputs?: InputSchema;
+    compute: ComputeFn;
+    /** Per-bucket cap on `draw.*` emissions per bar. @since 0.3 */
+    maxDrawings?: DrawingCounts;
+}> & DrawingOverrides;
+/**
+ * Construct a Phase-3 drawing script object. Mirrors `defineIndicator`
+ * structurally; only `manifest.kind` (`"drawing"`) and the declared
+ * `capabilities` (`["drawings"]`) differ. The runtime treats indicator
+ * 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
+ * with fixed anchors so the runtime path can be exercised.
+ *
+ * @since 0.3
+ * @stable
+ * @example
+ * ```ts
+ * import { defineDrawing } from "@invinite-org/chartlang-core";
+ *
+ * export default defineDrawing({
+ *     name: "Interactive Fib Retracement",
+ *     apiVersion: 1,
+ *     compute: ({ draw }) => {
+ *         draw.fibRetracement(
+ *             { time: 1_700_000_000_000, price: 100 },
+ *             { time: 1_700_086_400_000, price: 110 },
+ *         );
+ *     },
+ * });
+ * ```
+ */
+export declare function defineDrawing(opts: DefineDrawingOpts): CompiledScriptObject;
+export {};
+//# sourceMappingURL=defineDrawing.d.ts.map

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

@@ -0,0 +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"}

package/dist/define/defineDrawing.js

@@ -0,0 +1,67 @@
+// Copyright (c) 2026 Invinite. Licensed under the MIT License.
+// See the LICENSE file in the repo root for full license text.
+/**
+ * Construct a Phase-3 drawing script object. Mirrors `defineIndicator`
+ * structurally; only `manifest.kind` (`"drawing"`) and the declared
+ * `capabilities` (`["drawings"]`) differ. The runtime treats indicator
+ * 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
+ * with fixed anchors so the runtime path can be exercised.
+ *
+ * @since 0.3
+ * @stable
+ * @example
+ * ```ts
+ * import { defineDrawing } from "@invinite-org/chartlang-core";
+ *
+ * export default defineDrawing({
+ *     name: "Interactive Fib Retracement",
+ *     apiVersion: 1,
+ *     compute: ({ draw }) => {
+ *         draw.fibRetracement(
+ *             { time: 1_700_000_000_000, price: 100 },
+ *             { time: 1_700_086_400_000, price: 110 },
+ *         );
+ *     },
+ * });
+ * ```
+ */
+export function defineDrawing(opts) {
+    const capabilities = Object.freeze(["drawings"]);
+    const requestedIntervals = Object.freeze([]);
+    const seriesCapacities = Object.freeze({});
+    const base = {
+        apiVersion: 1,
+        kind: "drawing",
+        name: opts.name,
+        inputs: opts.inputs ?? {},
+        capabilities,
+        requestedIntervals,
+        userPickableInterval: false,
+        seriesCapacities,
+        maxLookback: 0,
+    };
+    const manifest = {
+        ...base,
+        ...(opts.maxDrawings === undefined ? {} : { maxDrawings: opts.maxDrawings }),
+        ...(opts.format === undefined ? {} : { format: opts.format }),
+        ...(opts.precision === undefined ? {} : { precision: opts.precision }),
+        ...(opts.requiresIntervals === undefined
+            ? {}
+            : { requiresIntervals: opts.requiresIntervals }),
+        ...(opts.shortName === undefined ? {} : { shortName: opts.shortName }),
+    };
+    return Object.freeze({
+        manifest: Object.freeze(manifest),
+        compute: opts.compute,
+    });
+}
+//# sourceMappingURL=defineDrawing.js.map

package/dist/define/defineDrawing.js.map

@@ -0,0 +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"}

package/dist/define/defineIndicator.d.ts

@@ -0,0 +1,48 @@
+import type { CompiledScriptObject, ComputeFn, DrawingCounts, InputSchema } from "../types.js";
+import type { ScriptOverrides } from "./overrides.js";
+/**
+ * Author-supplied options the script passes to `defineIndicator(...)`. The
+ * compiler reads this object's static shape to build the script's manifest;
+ * any field can be overridden at compile time via the AST transform.
+ *
+ * `maxDrawings` (Phase 3 / §10 / §4.1) caps the per-bucket `draw.*`
+ * emission rate per bar. Omit to default to the adapter's cap.
+ *
+ * @since 0.1
+ * @example
+ *     const opts: DefineIndicatorOpts = {
+ *         name: "demo",
+ *         apiVersion: 1,
+ *         compute: () => {},
+ *     };
+ */
+export type DefineIndicatorOpts = Readonly<{
+    name: string;
+    apiVersion: 1;
+    overlay?: boolean;
+    inputs?: InputSchema;
+    compute: ComputeFn;
+    /** Per-bucket cap on `draw.*` emissions per bar. @since 0.3 */
+    maxDrawings?: DrawingCounts;
+}> & ScriptOverrides;
+/**
+ * Construct a Phase-1 indicator script object. Returns a frozen
+ * `CompiledScriptObject` with a default manifest the compiler later overrides
+ * (extracts `capabilities` from primitive usage, `maxLookback` from
+ * `series[N]` reads). The defaults let the constructor work in unit tests
+ * before the compiler runs.
+ *
+ * @since 0.1
+ * @example
+ * ```ts
+ * import { defineIndicator } from "@invinite-org/chartlang-core";
+ *
+ * export default defineIndicator({
+ *     name: "EMA(20)",
+ *     apiVersion: 1,
+ *     compute: ({ bar, plot }) => { plot(bar.close); },
+ * });
+ * ```
+ */
+export declare function defineIndicator(opts: DefineIndicatorOpts): CompiledScriptObject;
+//# sourceMappingURL=defineIndicator.d.ts.map

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

@@ -0,0 +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"}

package/dist/define/defineIndicator.js

@@ -0,0 +1,54 @@
+// Copyright (c) 2026 Invinite. Licensed under the MIT License.
+// See the LICENSE file in the repo root for full license text.
+/**
+ * Construct a Phase-1 indicator script object. Returns a frozen
+ * `CompiledScriptObject` with a default manifest the compiler later overrides
+ * (extracts `capabilities` from primitive usage, `maxLookback` from
+ * `series[N]` reads). The defaults let the constructor work in unit tests
+ * before the compiler runs.
+ *
+ * @since 0.1
+ * @example
+ * ```ts
+ * import { defineIndicator } from "@invinite-org/chartlang-core";
+ *
+ * export default defineIndicator({
+ *     name: "EMA(20)",
+ *     apiVersion: 1,
+ *     compute: ({ bar, plot }) => { plot(bar.close); },
+ * });
+ * ```
+ */
+export function defineIndicator(opts) {
+    const capabilities = Object.freeze(["indicators"]);
+    const requestedIntervals = Object.freeze([]);
+    const seriesCapacities = Object.freeze({});
+    const base = {
+        apiVersion: 1,
+        kind: "indicator",
+        name: opts.name,
+        inputs: opts.inputs ?? {},
+        capabilities,
+        requestedIntervals,
+        userPickableInterval: false,
+        seriesCapacities,
+        maxLookback: 0,
+    };
+    const manifest = {
+        ...base,
+        ...(opts.maxDrawings === undefined ? {} : { maxDrawings: opts.maxDrawings }),
+        ...(opts.maxBarsBack === undefined ? {} : { maxBarsBack: opts.maxBarsBack }),
+        ...(opts.format === undefined ? {} : { format: opts.format }),
+        ...(opts.precision === undefined ? {} : { precision: opts.precision }),
+        ...(opts.scale === undefined ? {} : { scale: opts.scale }),
+        ...(opts.requiresIntervals === undefined
+            ? {}
+            : { requiresIntervals: opts.requiresIntervals }),
+        ...(opts.shortName === undefined ? {} : { shortName: opts.shortName }),
+    };
+    return Object.freeze({
+        manifest: Object.freeze(manifest),
+        compute: opts.compute,
+    });
+}
+//# sourceMappingURL=defineIndicator.js.map

package/dist/define/defineIndicator.js.map

@@ -0,0 +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"}

package/dist/define/index.d.ts

@@ -0,0 +1,6 @@
+export * from "./defineIndicator.js";
+export * from "./defineAlert.js";
+export * from "./defineAlertCondition.js";
+export * from "./defineDrawing.js";
+export type { ScaleAxis, ScriptOverrides, ValueFormat } from "./overrides.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/define/index.ts"],"names":[],"mappings":"AAGA,cAAc,sBAAsB,CAAC;AACrC,cAAc,kBAAkB,CAAC;AACjC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,oBAAoB,CAAC;AACnC,YAAY,EAAE,SAAS,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/define/index.js

@@ -0,0 +1,7 @@
+// Copyright (c) 2026 Invinite. Licensed under the MIT License.
+// See the LICENSE file in the repo root for full license text.
+export * from "./defineIndicator.js";
+export * from "./defineAlert.js";
+export * from "./defineAlertCondition.js";
+export * from "./defineDrawing.js";
+//# sourceMappingURL=index.js.map

package/dist/define/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/define/index.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,+DAA+D;AAE/D,cAAc,sBAAsB,CAAC;AACrC,cAAc,kBAAkB,CAAC;AACjC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,oBAAoB,CAAC"}

package/dist/define/overrides.d.ts

@@ -0,0 +1,102 @@
+/**
+ * Value-format hint the adapter uses for axis-label rendering. PLAN §4.1.
+ * `"price"` formats with the symbol's quote-currency rules; `"volume"` uses
+ * K/M/B compact notation; `"percent"` appends `%`; `"compact"` falls back to
+ * K/M/B for generic non-volume values.
+ *
+ * @since 0.4
+ * @stable
+ * @example
+ *     const f: ValueFormat = "percent";
+ *     void f;
+ */
+export type ValueFormat = "price" | "volume" | "percent" | "compact";
+/**
+ * Scale axis the indicator should bind to. PLAN §4.1.
+ *
+ * - `"price"` — overlay on the main price pane.
+ * - `"left"` / `"right"` — sub-pane axis side.
+ * - `"new"` — request a fresh sub-pane keyed by the script id.
+ *
+ * @since 0.4
+ * @stable
+ * @example
+ *     const s: ScaleAxis = "right";
+ *     void s;
+ */
+export type ScaleAxis = "price" | "left" | "right" | "new";
+/**
+ * Author-supplied display + budget overrides. Every field is optional;
+ * missing fields fall back to adapter defaults.
+ *
+ * @since 0.4
+ * @stable
+ * @example
+ *     const o: ScriptOverrides = {
+ *         shortName: "EMA(20)",
+ *         precision: 4,
+ *         format: "price",
+ *     };
+ *     void o;
+ */
+export type ScriptOverrides = Readonly<{
+    /**
+     * Max bars of historical lookback the script needs. `0` keeps the
+     * runtime default. Pine `max_bars_back` parity.
+     *
+     * @since 0.4
+     * @example
+     *     const v: ScriptOverrides["maxBarsBack"] = 100;
+     *     void v;
+     */
+    maxBarsBack?: number;
+    /**
+     * Value-formatting hint for axis labels + cursor read-out.
+     *
+     * @since 0.4
+     * @example
+     *     const v: ScriptOverrides["format"] = "price";
+     *     void v;
+     */
+    format?: ValueFormat;
+    /**
+     * Decimal precision the adapter renders the indicator at. `0`-`10`;
+     * `undefined` follows the symbol's default precision.
+     *
+     * @since 0.4
+     * @example
+     *     const v: ScriptOverrides["precision"] = 2;
+     *     void v;
+     */
+    precision?: number;
+    /**
+     * Scale-axis binding. Defaults to `"price"` for overlay indicators and
+     * `"right"` for sub-pane indicators.
+     *
+     * @since 0.4
+     * @example
+     *     const v: ScriptOverrides["scale"] = "right";
+     *     void v;
+     */
+    scale?: ScaleAxis;
+    /**
+     * Intervals the script requires the adapter to ship in
+     * `Capabilities.intervals`.
+     *
+     * @since 0.4
+     * @example
+     *     const v: ScriptOverrides["requiresIntervals"] = ["1D"];
+     *     void v;
+     */
+    requiresIntervals?: ReadonlyArray<string>;
+    /**
+     * Compact display label for legend chips. Defaults to truncated `name`.
+     *
+     * @since 0.4
+     * @example
+     *     const v: ScriptOverrides["shortName"] = "EMA";
+     *     void v;
+     */
+    shortName?: string;
+}>;
+//# sourceMappingURL=overrides.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"overrides.d.ts","sourceRoot":"","sources":["../../src/define/overrides.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,QAAQ,GAAG,SAAS,GAAG,SAAS,CAAC;AAErE;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,MAAM,GAAG,OAAO,GAAG,KAAK,CAAC;AAE3D;;;;;;;;;;;;;GAaG;AACH,MAAM,MAAM,eAAe,GAAG,QAAQ,CAAC;IACnC;;;;;;;;OAQG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;;;;OAOG;IACH,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB;;;;;;;;OAQG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;;;;;OAQG;IACH,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB;;;;;;;;OAQG;IACH,iBAAiB,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAC1C;;;;;;;OAOG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC,CAAC"}

package/dist/define/overrides.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=overrides.js.map

package/dist/define/overrides.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"overrides.js","sourceRoot":"","sources":["../../src/define/overrides.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,+DAA+D"}