@invinite-org/chartlang-compiler 1.0.1

package/dist/bundle.js

@@ -0,0 +1,90 @@
+// Copyright (c) 2026 Invinite. Licensed under the MIT License.
+// See the LICENSE file in the repo root for full license text.
+import { fileURLToPath } from "node:url";
+import { dirname } from "node:path";
+import * as esbuild from "esbuild";
+// The compiler package directory — esbuild's `resolveDir` so the workspace
+// `@invinite-org/chartlang-core` bare specifier resolves through the compiler
+// package's own `node_modules/` symlink. Computed once at module load.
+const COMPILER_PACKAGE_DIR = dirname(dirname(fileURLToPath(import.meta.url)));
+/**
+ * Drive esbuild's `build` API against an in-memory transformed TS source and
+ * emit a self-contained ESM bundle. Pinned flags: `bundle: true`,
+ * `loader: "ts"`, `format: "esm"`, `target: "es2022"`, `treeShaking: true`,
+ * `platform: "neutral"`. Bare specifiers like
+ * `@invinite-org/chartlang-core` resolve through the compiler package's own
+ * `node_modules/` (i.e. `resolveDir` is fixed to the compiler package dir),
+ * so the output has zero remaining `import` statements and can load from a
+ * `data:` URL inside any host (worker / QuickJS / Node) without a module
+ * resolver. Output is ~5–50 KB unminified per PLAN §5.2.
+ *
+ * @since 0.1
+ * @example
+ *     // const { moduleSource } = await bundleModule({
+ *     //     transformedSource: "export default {};",
+ *     //     sourcePath: "demo.chart.ts",
+ *     //     sourcemap: false,
+ *     //     minify: false,
+ *     // });
+ *     const fn: typeof bundleModule = bundleModule;
+ *     void fn;
+ */
+export async function bundleModule(opts) {
+    const esbuildSourcemap = opts.sourcemap === false ? false : opts.sourcemap === "inline" ? "inline" : "external";
+    const wantsExternalMap = opts.sourcemap === true || opts.sourcemap === "external";
+    const buildOpts = {
+        stdin: {
+            contents: opts.transformedSource,
+            loader: "ts",
+            sourcefile: opts.sourcePath,
+            resolveDir: COMPILER_PACKAGE_DIR,
+        },
+        bundle: true,
+        format: "esm",
+        target: "es2022",
+        platform: "neutral",
+        sourcemap: esbuildSourcemap,
+        minify: opts.minify,
+        treeShaking: true,
+        write: false,
+        // `outfile` is required when `sourcemap: "external"`; the virtual path
+        // never touches disk because `write: false`.
+        ...(wantsExternalMap ? { outfile: `${opts.sourcePath}.js` } : {}),
+    };
+    const result = await esbuild.build(buildOpts);
+    // `outputFiles` is only `undefined` when `write !== false`; we pin
+    // `write: false` above so the runtime branch never fires. The defensive
+    // throws keep the type narrow without bloating the coverage gate.
+    const outputFiles = result.outputFiles ?? /* v8 ignore next */ [];
+    const jsFile = outputFiles.find((f) => !f.path.endsWith(".map"));
+    /* v8 ignore next 3 */
+    if (jsFile === undefined) {
+        throw new Error("esbuild produced no JS output file");
+    }
+    if (wantsExternalMap) {
+        const mapFile = outputFiles.find((f) => f.path.endsWith(".map"));
+        /* v8 ignore next 3 */
+        if (mapFile === undefined) {
+            throw new Error("esbuild produced no sourcemap file");
+        }
+        return Object.freeze({ moduleSource: jsFile.text, sourcemap: mapFile.text });
+    }
+    return Object.freeze({ moduleSource: jsFile.text });
+}
+/**
+ * Synthesise the bottom-of-bundle `export const __manifest = …;` assignment.
+ * The runtime reads this constant via dynamic `import(...)` to recover the
+ * frozen `ScriptManifest` that travels alongside the compiled JS. Serialised
+ * via `JSON.stringify` for determinism (insertion-order key emission).
+ *
+ * @since 0.1
+ * @example
+ *     // const line = formatManifestAssignment(manifest);
+ *     // line === 'export const __manifest = {"apiVersion":1,…};\n'
+ *     const fn: typeof formatManifestAssignment = formatManifestAssignment;
+ *     void fn;
+ */
+export function formatManifestAssignment(manifest) {
+    return `export const __manifest = ${JSON.stringify(manifest)};\n`;
+}
+//# sourceMappingURL=bundle.js.map

package/dist/bundle.js.map

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

package/dist/diagnostics.d.ts

@@ -0,0 +1,88 @@
+import type ts from "typescript";
+/**
+ * Stable identifier for every diagnostic the compiler can emit. New codes are
+ * added at the end; existing codes never change meaning so consumer-side
+ * filtering stays compatible across versions.
+ *
+ * Phase 1 ships eight emittable codes plus Phase 4's
+ * `request.security` and input-extraction codes.
+ *
+ * @since 0.1
+ * @example
+ *     const code: CompileDiagnosticCode = "unbounded-loop";
+ */
+export type CompileDiagnosticCode = "unbounded-loop" | "recursion-not-allowed" | "hostile-global" | "stateful-call-inside-loop" | "stateful-call-element-access" | "request-security-interval-not-literal" | "dynamic-series-index" | "callsite-id-conflict" | "missing-default-export" | "api-version-mismatch" | "input-default-not-literal" | "unknown-input-kind" | "multiple-input-interval" | "requires-intervals-not-literal" | "alert-condition-not-literal" | "alert-condition-field-not-literal" | "lower-tf-not-lower" | "request-lower-tf-interval-not-literal" | "type-error";
+/**
+ * Single diagnostic the compiler emits while transforming or analysing a
+ * `.chart.ts` source. The shape is intentionally small — file/line/column and
+ * a stable code — so callers (CLI, editor, host) can format errors uniformly.
+ *
+ * `severity` distinguishes hard errors (abort `compile`) from warnings
+ * (surface to the user but still produce a manifest).
+ *
+ * @since 0.1
+ * @example
+ *     const d: CompileDiagnostic = {
+ *         severity: "error",
+ *         code: "unbounded-loop",
+ *         message: "while loops are not allowed",
+ *         file: "demo.chart.ts",
+ *         line: 5,
+ *         column: 1,
+ *     };
+ */
+export type CompileDiagnostic = {
+    readonly severity: "error" | "warning";
+    readonly code: CompileDiagnosticCode;
+    readonly message: string;
+    readonly file: string;
+    readonly line: number;
+    readonly column: number;
+    readonly nodeText?: string;
+};
+/**
+ * Build a frozen `CompileDiagnostic` from a TypeScript node. Reads the node's
+ * starting position against the supplied source file, converts to 1-based
+ * line/column, and truncates the source snippet to a single line so terminal
+ * output stays compact.
+ *
+ * @since 0.1
+ * @example
+ *     // Inside an analysis pass:
+ *     //   diagnostics.push(createDiagnostic({
+ *     //       severity: "error", code: "unbounded-loop",
+ *     //       message: "while loops are not allowed",
+ *     //       file: sourcePath, node, sourceFile,
+ *     //   }));
+ *     const fake = { severity: "error" as const };
+ *     void fake;
+ */
+export declare function createDiagnostic(args: {
+    readonly severity: "error" | "warning";
+    readonly code: CompileDiagnosticCode;
+    readonly message: string;
+    readonly file: string;
+    readonly node: ts.Node;
+    readonly sourceFile: ts.SourceFile;
+    readonly includeSnippet?: boolean;
+}): CompileDiagnostic;
+/**
+ * Build a frozen `CompileDiagnostic` from a raw TypeScript `ts.Diagnostic`.
+ * Used by the `compile()` pipeline to surface semantic type-checker errors
+ * (TS2322, TS2345, …) under the `type-error` code. Carries the original
+ * `TS<code>` numeric prefix in the message so editor consumers can route
+ * to the TypeScript documentation if they want.
+ *
+ * Diagnostics without a `file` (global-scope, project-shape) are mapped to
+ * the script's `sourcePath` at line/column `1:1` so callers always get a
+ * stable location they can attribute to the user's source. The message is
+ * flattened across `DiagnosticMessageChain` nodes.
+ *
+ * @since 0.7
+ * @example
+ *     // const compileDiagnostic = mapTsDiagnostic(tsDiagnostic, "demo.chart.ts");
+ *     const fn: typeof mapTsDiagnostic = mapTsDiagnostic;
+ *     void fn;
+ */
+export declare function mapTsDiagnostic(diagnostic: ts.Diagnostic, sourcePath: string): CompileDiagnostic;
+//# sourceMappingURL=diagnostics.d.ts.map

package/dist/diagnostics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostics.d.ts","sourceRoot":"","sources":["../src/diagnostics.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,YAAY,CAAC;AAEjC;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,qBAAqB,GAC3B,gBAAgB,GAChB,uBAAuB,GACvB,gBAAgB,GAChB,2BAA2B,GAC3B,8BAA8B,GAC9B,uCAAuC,GACvC,sBAAsB,GACtB,sBAAsB,GACtB,wBAAwB,GACxB,sBAAsB,GACtB,2BAA2B,GAC3B,oBAAoB,GACpB,yBAAyB,GACzB,gCAAgC,GAChC,6BAA6B,GAC7B,mCAAmC,GACnC,oBAAoB,GACpB,uCAAuC,GACvC,YAAY,CAAC;AAEnB;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC5B,QAAQ,CAAC,QAAQ,EAAE,OAAO,GAAG,SAAS,CAAC;IACvC,QAAQ,CAAC,IAAI,EAAE,qBAAqB,CAAC;IACrC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC9B,CAAC;AAEF;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE;IACnC,QAAQ,CAAC,QAAQ,EAAE,OAAO,GAAG,SAAS,CAAC;IACvC,QAAQ,CAAC,IAAI,EAAE,qBAAqB,CAAC;IACrC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC;IACvB,QAAQ,CAAC,UAAU,EAAE,EAAE,CAAC,UAAU,CAAC;IACnC,QAAQ,CAAC,cAAc,CAAC,EAAE,OAAO,CAAC;CACrC,GAAG,iBAAiB,CAoBpB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,eAAe,CAAC,UAAU,EAAE,EAAE,CAAC,UAAU,EAAE,UAAU,EAAE,MAAM,GAAG,iBAAiB,CAsBhG"}

package/dist/diagnostics.js

@@ -0,0 +1,95 @@
+// Copyright (c) 2026 Invinite. Licensed under the MIT License.
+// See the LICENSE file in the repo root for full license text.
+/**
+ * Build a frozen `CompileDiagnostic` from a TypeScript node. Reads the node's
+ * starting position against the supplied source file, converts to 1-based
+ * line/column, and truncates the source snippet to a single line so terminal
+ * output stays compact.
+ *
+ * @since 0.1
+ * @example
+ *     // Inside an analysis pass:
+ *     //   diagnostics.push(createDiagnostic({
+ *     //       severity: "error", code: "unbounded-loop",
+ *     //       message: "while loops are not allowed",
+ *     //       file: sourcePath, node, sourceFile,
+ *     //   }));
+ *     const fake = { severity: "error" as const };
+ *     void fake;
+ */
+export function createDiagnostic(args) {
+    const { severity, code, message, file, node, sourceFile, includeSnippet } = args;
+    const start = node.getStart(sourceFile);
+    const { line, character } = sourceFile.getLineAndCharacterOfPosition(start);
+    const base = {
+        severity,
+        code,
+        message,
+        file,
+        line: line + 1,
+        column: character + 1,
+    };
+    if (includeSnippet) {
+        const text = node.getText(sourceFile);
+        const newlineIndex = text.indexOf("\n");
+        const firstLine = newlineIndex === -1 ? text : text.slice(0, newlineIndex);
+        const snippet = firstLine.length > 80 ? `${firstLine.slice(0, 77)}...` : firstLine;
+        return Object.freeze({ ...base, nodeText: snippet });
+    }
+    return Object.freeze(base);
+}
+/**
+ * Build a frozen `CompileDiagnostic` from a raw TypeScript `ts.Diagnostic`.
+ * Used by the `compile()` pipeline to surface semantic type-checker errors
+ * (TS2322, TS2345, …) under the `type-error` code. Carries the original
+ * `TS<code>` numeric prefix in the message so editor consumers can route
+ * to the TypeScript documentation if they want.
+ *
+ * Diagnostics without a `file` (global-scope, project-shape) are mapped to
+ * the script's `sourcePath` at line/column `1:1` so callers always get a
+ * stable location they can attribute to the user's source. The message is
+ * flattened across `DiagnosticMessageChain` nodes.
+ *
+ * @since 0.7
+ * @example
+ *     // const compileDiagnostic = mapTsDiagnostic(tsDiagnostic, "demo.chart.ts");
+ *     const fn: typeof mapTsDiagnostic = mapTsDiagnostic;
+ *     void fn;
+ */
+export function mapTsDiagnostic(diagnostic, sourcePath) {
+    const message = flattenDiagnosticMessage(diagnostic.messageText);
+    const file = diagnostic.file;
+    if (file === undefined || diagnostic.start === undefined) {
+        return Object.freeze({
+            severity: "error",
+            code: "type-error",
+            message: `TS${diagnostic.code}: ${message}`,
+            file: sourcePath,
+            line: 1,
+            column: 1,
+        });
+    }
+    const { line, character } = file.getLineAndCharacterOfPosition(diagnostic.start);
+    return Object.freeze({
+        severity: "error",
+        code: "type-error",
+        message: `TS${diagnostic.code}: ${message}`,
+        file: sourcePath,
+        line: line + 1,
+        column: character + 1,
+    });
+}
+function flattenDiagnosticMessage(message) {
+    if (typeof message === "string")
+        return message;
+    const parts = [message.messageText];
+    const next = message.next;
+    if (next === undefined)
+        return parts.join(" ");
+    const queue = next;
+    for (const chain of queue) {
+        parts.push(flattenDiagnosticMessage(chain));
+    }
+    return parts.join(" ");
+}
+//# sourceMappingURL=diagnostics.js.map

package/dist/diagnostics.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+export { CompileError, compile, compileFile, compileProject, transformAndAnalyse, walkChartFiles, writeAtomic, } from "./api.js";
+export type { CompileFileOptions, CompileOptions, CompiledScript, TransformAndAnalyseOptions, TransformAndAnalyseResult, } from "./api.js";
+export { bundleModule, formatManifestAssignment } from "./bundle.js";
+export type { BundleModuleOptions, BundleModuleResult } from "./bundle.js";
+export type { CompileDiagnostic, CompileDiagnosticCode } from "./diagnostics.js";
+export { emitTypes } from "./typesEmit.js";
+export type { EmitTypesOptions } from "./typesEmit.js";
+export { resolveCalleeName } from "./transformers/resolveCallee.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,OAAO,EACH,YAAY,EACZ,OAAO,EACP,WAAW,EACX,cAAc,EACd,mBAAmB,EACnB,cAAc,EACd,WAAW,GACd,MAAM,UAAU,CAAC;AAClB,YAAY,EACR,kBAAkB,EAClB,cAAc,EACd,cAAc,EACd,0BAA0B,EAC1B,yBAAyB,GAC5B,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,YAAY,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AACrE,YAAY,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAC3E,YAAY,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AACjF,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,YAAY,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC"}

package/dist/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 { CompileError, compile, compileFile, compileProject, transformAndAnalyse, walkChartFiles, writeAtomic, } from "./api.js";
+export { bundleModule, formatManifestAssignment } from "./bundle.js";
+export { emitTypes } from "./typesEmit.js";
+export { resolveCalleeName } from "./transformers/resolveCallee.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,+DAA+D;AAE/D,OAAO,EACH,YAAY,EACZ,OAAO,EACP,WAAW,EACX,cAAc,EACd,mBAAmB,EACnB,cAAc,EACd,WAAW,GACd,MAAM,UAAU,CAAC;AAQlB,OAAO,EAAE,YAAY,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AAGrE,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE3C,OAAO,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC"}

package/dist/manifest.d.ts

@@ -0,0 +1,40 @@
+import type { AlertConditionDefinition, CapabilityId, ScriptManifest } from "@invinite-org/chartlang-core";
+type ValueFormat = "price" | "volume" | "percent" | "compact";
+type ScaleAxis = "price" | "left" | "right" | "new";
+type ManifestInputDescriptors = Readonly<Record<string, Readonly<Record<string, unknown>>>>;
+/**
+ * Build a recursively-frozen `ScriptManifest` from the compiler's
+ * extraction passes. Every array, every nested record, and the outer
+ * object itself are frozen so the runtime can structurally clone the
+ * manifest without worrying about post-build mutation.
+ *
+ * @since 0.1
+ * @example
+ *     // const manifest = buildManifest({
+ *     //     name: "EMA(20)", kind: "indicator",
+ *     //     capabilities: ["alerts", "indicators"],
+ *     //     requestedIntervals: [], userPickableInterval: false,
+ *     //     seriesCapacities: {}, maxLookback: 0, inputs: {},
+ *     // });
+ *     const fn: typeof buildManifest = buildManifest;
+ *     void fn;
+ */
+export declare function buildManifest(args: {
+    readonly name: string;
+    readonly kind: "indicator" | "drawing" | "alert" | "alertCondition";
+    readonly capabilities: ReadonlyArray<CapabilityId>;
+    readonly requestedIntervals: ReadonlyArray<string>;
+    readonly userPickableInterval: boolean;
+    readonly seriesCapacities: Readonly<Record<string, number>>;
+    readonly maxLookback: number;
+    readonly inputs: ManifestInputDescriptors;
+    readonly maxBarsBack?: number;
+    readonly format?: ValueFormat;
+    readonly precision?: number;
+    readonly scale?: ScaleAxis;
+    readonly requiresIntervals?: ReadonlyArray<string>;
+    readonly shortName?: string;
+    readonly alertConditions?: ReadonlyArray<AlertConditionDefinition>;
+}): ScriptManifest;
+export {};
+//# sourceMappingURL=manifest.d.ts.map

package/dist/manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../src/manifest.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACR,wBAAwB,EACxB,YAAY,EACZ,cAAc,EACjB,MAAM,8BAA8B,CAAC;AAEtC,KAAK,WAAW,GAAG,OAAO,GAAG,QAAQ,GAAG,SAAS,GAAG,SAAS,CAAC;AAC9D,KAAK,SAAS,GAAG,OAAO,GAAG,MAAM,GAAG,OAAO,GAAG,KAAK,CAAC;AACpD,KAAK,wBAAwB,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;AAE5F;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,WAAW,GAAG,SAAS,GAAG,OAAO,GAAG,gBAAgB,CAAC;IACpE,QAAQ,CAAC,YAAY,EAAE,aAAa,CAAC,YAAY,CAAC,CAAC;IACnD,QAAQ,CAAC,kBAAkB,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IACnD,QAAQ,CAAC,oBAAoB,EAAE,OAAO,CAAC;IACvC,QAAQ,CAAC,gBAAgB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAC5D,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,wBAAwB,CAAC;IAC1C,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;IAC9B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,CAAC;IAC3B,QAAQ,CAAC,iBAAiB,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IACnD,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,eAAe,CAAC,EAAE,aAAa,CAAC,wBAAwB,CAAC,CAAC;CACtE,GAAG,cAAc,CA4CjB"}

package/dist/manifest.js

@@ -0,0 +1,57 @@
+// Copyright (c) 2026 Invinite. Licensed under the MIT License.
+// See the LICENSE file in the repo root for full license text.
+/**
+ * Build a recursively-frozen `ScriptManifest` from the compiler's
+ * extraction passes. Every array, every nested record, and the outer
+ * object itself are frozen so the runtime can structurally clone the
+ * manifest without worrying about post-build mutation.
+ *
+ * @since 0.1
+ * @example
+ *     // const manifest = buildManifest({
+ *     //     name: "EMA(20)", kind: "indicator",
+ *     //     capabilities: ["alerts", "indicators"],
+ *     //     requestedIntervals: [], userPickableInterval: false,
+ *     //     seriesCapacities: {}, maxLookback: 0, inputs: {},
+ *     // });
+ *     const fn: typeof buildManifest = buildManifest;
+ *     void fn;
+ */
+export function buildManifest(args) {
+    const capabilities = Object.freeze(args.capabilities.slice());
+    const requestedIntervals = Object.freeze(args.requestedIntervals.slice());
+    const seriesCapacities = Object.freeze({ ...args.seriesCapacities });
+    const inputEntries = Object.entries(args.inputs).map(([key, value]) => [key, Object.freeze({ ...value })]);
+    const inputs = Object.freeze(Object.fromEntries(inputEntries));
+    const scriptInputs = inputs;
+    const requiresIntervals = args.requiresIntervals === undefined
+        ? undefined
+        : Object.freeze(args.requiresIntervals.slice());
+    const alertConditions = args.alertConditions === undefined
+        ? undefined
+        : Object.freeze(args.alertConditions.map((condition) => Object.freeze({
+            id: condition.id,
+            title: condition.title,
+            description: condition.description,
+            defaultMessage: condition.defaultMessage,
+        })));
+    return Object.freeze({
+        apiVersion: 1,
+        kind: args.kind,
+        name: args.name,
+        inputs: scriptInputs,
+        capabilities,
+        requestedIntervals,
+        userPickableInterval: args.userPickableInterval,
+        seriesCapacities,
+        maxLookback: args.maxLookback,
+        ...(args.maxBarsBack === undefined ? {} : { maxBarsBack: args.maxBarsBack }),
+        ...(args.format === undefined ? {} : { format: args.format }),
+        ...(args.precision === undefined ? {} : { precision: args.precision }),
+        ...(args.scale === undefined ? {} : { scale: args.scale }),
+        ...(requiresIntervals === undefined ? {} : { requiresIntervals }),
+        ...(args.shortName === undefined ? {} : { shortName: args.shortName }),
+        ...(alertConditions === undefined ? {} : { alertConditions }),
+    });
+}
+//# sourceMappingURL=manifest.js.map

package/dist/manifest.js.map

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

package/dist/program.d.ts

@@ -0,0 +1,68 @@
+import ts from "typescript";
+/**
+ * Virtual on-disk path the in-memory `@invinite-org/chartlang-core` ambient
+ * declaration file is served from. Kept stable so the analysis passes can
+ * detect callee declarations coming from core (vs. user-shadowed names).
+ *
+ * @since 0.1
+ * @example
+ *     import { CORE_MODULE_PATH } from "@invinite-org/chartlang-compiler/program";
+ *     void CORE_MODULE_PATH;
+ */
+export declare const CORE_MODULE_PATH = "/__chartlang__/core.d.ts";
+/**
+ * The compiler options the compiler pins for every script. ES2022 target,
+ * Bundler module resolution, strict mode, no DOM. Scripts that depend on
+ * browser globals fail the `forbiddenConstructs` pass on the global access
+ * itself; the `lib` setting keeps the typechecker from accepting them in the
+ * first place.
+ *
+ * @since 0.1
+ * @example
+ *     import { COMPILER_OPTIONS } from "@invinite-org/chartlang-compiler/program";
+ *     void COMPILER_OPTIONS;
+ */
+export declare const COMPILER_OPTIONS: ts.CompilerOptions;
+/**
+ * The return shape of `createProgramForSource`. Callers use `sourceFile` for
+ * AST walks, `checker` for symbol resolution, and `program` as the root
+ * handle when they need diagnostics from `tsc` itself (not used in Phase 1,
+ * but kept on the type so Task 3 can plug in `program.getSemanticDiagnostics`
+ * without an API change).
+ *
+ * @since 0.1
+ * @example
+ *     // const { sourceFile, checker } = createProgramForSource(src, opts);
+ *     const shape: { sourceFile: unknown; checker: unknown; program: unknown } = {
+ *         sourceFile: null,
+ *         checker: null,
+ *         program: null,
+ *     };
+ *     void shape;
+ */
+export type ProgramForSource = Readonly<{
+    program: ts.Program;
+    sourceFile: ts.SourceFile;
+    checker: ts.TypeChecker;
+}>;
+/**
+ * Build a single-file TypeScript program for an in-memory `.chart.ts`
+ * source. The synthetic file lives at `sourcePath` (POSIX, as the user
+ * would write it); imports of `@invinite-org/chartlang-core` resolve
+ * against the in-memory ambient shim. Returns the source file and a
+ * configured type checker — the caller never sees the underlying compiler
+ * host plumbing.
+ *
+ * @since 0.1
+ * @example
+ *     // const { sourceFile, checker } = createProgramForSource(
+ *     //     'export default defineIndicator({ name: "x", apiVersion: 1, compute: () => {} });',
+ *     //     { sourcePath: "demo.chart.ts" },
+ *     // );
+ *     const fn: typeof createProgramForSource = createProgramForSource;
+ *     void fn;
+ */
+export declare function createProgramForSource(source: string, opts: {
+    readonly sourcePath: string;
+}): ProgramForSource;
+//# sourceMappingURL=program.d.ts.map

package/dist/program.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"program.d.ts","sourceRoot":"","sources":["../src/program.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,MAAM,YAAY,CAAC;AAE5B;;;;;;;;;GASG;AACH,eAAO,MAAM,gBAAgB,6BAA6B,CAAC;AAwxC3D;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,gBAAgB,EAAE,EAAE,CAAC,eAYjC,CAAC;AAEF;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,MAAM,gBAAgB,GAAG,QAAQ,CAAC;IACpC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC;IACpB,UAAU,EAAE,EAAE,CAAC,UAAU,CAAC;IAC1B,OAAO,EAAE,EAAE,CAAC,WAAW,CAAC;CAC3B,CAAC,CAAC;AAEH;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,sBAAsB,CAClC,MAAM,EAAE,MAAM,EACd,IAAI,EAAE;IAAE,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GACtC,gBAAgB,CAoDlB"}