@invinite-org/chartlang-compiler 1.0.1

package/dist/api.d.ts

@@ -0,0 +1,205 @@
+import type { IntervalDescriptor, ScriptManifest } from "@invinite-org/chartlang-core";
+import ts from "typescript";
+import type { CompileDiagnostic } from "./diagnostics.js";
+/**
+ * Options accepted by `transformAndAnalyse`. `sourcePath` is the
+ * package-relative POSIX path baked into every callsite id; the compiler
+ * does not read any other file. `declaredIntervals` is the host-supplied
+ * `Capabilities.intervals` set used by the `lower-tf-not-lower` validation —
+ * when omitted the lower-timeframe ordering check is skipped.
+ *
+ * @since 0.1
+ * @example
+ *     const opts: TransformAndAnalyseOptions = { sourcePath: "demo.chart.ts" };
+ */
+export type TransformAndAnalyseOptions = Readonly<{
+    sourcePath: string;
+    declaredIntervals?: ReadonlyArray<IntervalDescriptor>;
+}>;
+/**
+ * Result of `transformAndAnalyse`. `transformed` is the AST after callsite
+ * ids have been injected; `manifest` is the recursively-frozen
+ * `ScriptManifest`; `diagnostics` is the flat list of every diagnostic
+ * emitted by any pass (errors abort the rewrite, warnings flow through).
+ *
+ * @since 0.1
+ * @example
+ *     // const { transformed, manifest, diagnostics } =
+ *     //     transformAndAnalyse(src, { sourcePath: "demo.chart.ts" });
+ *     const shape: { transformed: unknown; manifest: unknown; diagnostics: unknown } = {
+ *         transformed: null,
+ *         manifest: null,
+ *         diagnostics: [],
+ *     };
+ *     void shape;
+ */
+export type TransformAndAnalyseResult = Readonly<{
+    transformed: ts.SourceFile;
+    manifest: ScriptManifest;
+    diagnostics: ReadonlyArray<CompileDiagnostic>;
+}>;
+/**
+ * Run the Phase-1 compiler pipeline against an in-memory script source.
+ * Builds a TypeScript program, runs the structural / forbidden-construct /
+ * stateful-call-in-loop checks, rewrites stateful calls with callsite ids,
+ * and extracts the manifest's `capabilities` / `maxLookback` /
+ * `seriesCapacities` / `inputs` fields.
+ *
+ * Error-severity diagnostics short-circuit the transform: the function
+ * returns the original `sourceFile` and a placeholder manifest so callers
+ * can still surface the errors uniformly. The public `compile` /
+ * `compileFile` / `compileProject` wrappers above turn those error
+ * diagnostics into a `CompileError` throw.
+ *
+ * @since 0.1
+ * @example
+ *     // const result = transformAndAnalyse(
+ *     //     'export default defineIndicator({ name: "x", apiVersion: 1, compute: () => {} });',
+ *     //     { sourcePath: "demo.chart.ts" },
+ *     // );
+ *     const fn: typeof transformAndAnalyse = transformAndAnalyse;
+ *     void fn;
+ */
+export declare function transformAndAnalyse(source: string, opts: TransformAndAnalyseOptions): TransformAndAnalyseResult;
+/**
+ * Options accepted by `compile`. `apiVersion` is the frozen language
+ * version this compiler implements. Passing `apiVersion: 1` is an explicit
+ * acknowledgement of that contract; the type stays the literal `1` so a
+ * future `apiVersion: 2` compiler is a type-level break. See
+ * `docs/spec/versioning.md`. `sourcePath` overrides the file-system-derived
+ * path used in callsite ids; `sourcemap`, `minify`, and `target` mirror the
+ * bundler's flags. `declaredIntervals` is the adapter's
+ * `Capabilities.intervals` set — when supplied, `request.lowerTf` literals
+ * are validated against the smallest declared main interval
+ * (`lower-tf-not-lower`).
+ *
+ * @since 0.1
+ * @example
+ *     const opts: CompileOptions = { apiVersion: 1, sourcePath: "demo.chart.ts" };
+ *     void opts;
+ */
+export type CompileOptions = Readonly<{
+    apiVersion: 1;
+    sourcePath?: string;
+    sourcemap?: boolean | "inline" | "external";
+    minify?: boolean;
+    target?: "es2022";
+    declaredIntervals?: ReadonlyArray<IntervalDescriptor>;
+}>;
+/**
+ * Options accepted by `compileFile`. Extends `CompileOptions` with a `write`
+ * toggle that, when `false`, skips the sibling-file writes and returns the
+ * triple in memory only.
+ *
+ * @since 0.1
+ * @example
+ *     const opts: CompileFileOptions = { apiVersion: 1, write: false };
+ *     void opts;
+ */
+export type CompileFileOptions = CompileOptions & Readonly<{
+    write?: boolean;
+}>;
+/**
+ * Frozen result of a single script compilation. `moduleSource` is the bundled
+ * ESM string (with the `export const __manifest = …;` tail appended);
+ * `sourcemap` is present when the caller asked for an external map;
+ * `manifest` is the recursively-frozen `ScriptManifest`; `types` is the
+ * `.d.ts` sibling source.
+ *
+ * @since 0.1
+ * @example
+ *     // const result: CompiledScript = await compile(src, { apiVersion: 1 });
+ *     const shape: CompiledScript = {} as CompiledScript;
+ *     void shape;
+ */
+export type CompiledScript = Readonly<{
+    moduleSource: string;
+    sourcemap?: string;
+    manifest: ScriptManifest;
+    types: string;
+}>;
+/**
+ * Error thrown by `compile` / `compileFile` / `compileProject` when any
+ * compilation produces an error-severity diagnostic. Carries the full
+ * frozen diagnostic array on `err.diagnostics`; the message starts with the
+ * first diagnostic's `code: message (file:line:column)` so console output
+ * stays compact.
+ *
+ * @since 0.1
+ * @example
+ *     // try { await compile(badSrc, { apiVersion: 1 }); }
+ *     // catch (err) { if (err instanceof CompileError) console.error(err.diagnostics); }
+ *     const E: typeof CompileError = CompileError;
+ *     void E;
+ */
+export declare class CompileError extends Error {
+    readonly diagnostics: ReadonlyArray<CompileDiagnostic>;
+    constructor(diagnostics: ReadonlyArray<CompileDiagnostic>);
+}
+/**
+ * Compile a script source into a frozen `CompiledScript` triple. Runs
+ * `transformAndAnalyse`, throws `CompileError` on any error diagnostic,
+ * prints the transformed AST, drives esbuild to ESM, appends the
+ * `__manifest` assignment, and emits the `.d.ts` sibling.
+ *
+ * @since 0.1
+ * @example
+ *     // const result = await compile(emaCrossSource, {
+ *     //     apiVersion: 1,
+ *     //     sourcePath: "ema-cross.chart.ts",
+ *     // });
+ *     const fn: typeof compile = compile;
+ *     void fn;
+ */
+export declare function compile(source: string, opts: CompileOptions): Promise<CompiledScript>;
+/**
+ * Write a file atomically — render to a `<target>.tmp.<rand>` sibling first,
+ * then `rename` into place. On any error during write or rename, the temp
+ * file is unlinked so the caller never sees a half-written artefact.
+ *
+ * @since 0.1
+ * @example
+ *     // await writeAtomic("/tmp/foo.txt", "hello");
+ *     const fn: typeof writeAtomic = writeAtomic;
+ *     void fn;
+ */
+export declare function writeAtomic(target: string, contents: string): Promise<void>;
+/**
+ * Read a `.chart.ts` file from disk, compile it, and (when `write !== false`)
+ * emit the three sibling files atomically — `<base>.chart.js`,
+ * `<base>.chart.manifest.json`, `<base>.chart.d.ts`, plus
+ * `<base>.chart.js.map` when `sourcemap` is external.
+ *
+ * @since 0.1
+ * @example
+ *     // const result = await compileFile("./demo.chart.ts", { apiVersion: 1 });
+ *     const fn: typeof compileFile = compileFile;
+ *     void fn;
+ */
+export declare function compileFile(path: string, opts: CompileFileOptions): Promise<CompiledScript>;
+/**
+ * Walk `rootDir` recursively and return every `*.chart.ts` file's absolute
+ * path. Skips `node_modules` and `dist` subtrees. The walker is iterative to
+ * stay portable across Node 20.1 → 20.x.
+ *
+ * @since 0.1
+ * @example
+ *     // const files = await walkChartFiles("./examples/scripts");
+ *     const fn: typeof walkChartFiles = walkChartFiles;
+ *     void fn;
+ */
+export declare function walkChartFiles(rootDir: string): Promise<string[]>;
+/**
+ * Discover every `*.chart.ts` under `rootDir` and compile each in parallel.
+ * Results are returned in deterministic (path-sorted) order so callers can
+ * snapshot the array safely. Compilation runs in memory only — the CLI
+ * (Phase-1 Task 11) loops `compileFile` when it needs sibling files on disk.
+ *
+ * @since 0.1
+ * @example
+ *     // const all = await compileProject("./examples/scripts", { apiVersion: 1 });
+ *     const fn: typeof compileProject = compileProject;
+ *     void fn;
+ */
+export declare function compileProject(rootDir: string, opts: CompileOptions): Promise<ReadonlyArray<CompiledScript>>;
+//# sourceMappingURL=api.d.ts.map

package/dist/api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../src/api.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AACvF,OAAO,EAAE,MAAM,YAAY,CAAC;AAe5B,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAO1D;;;;;;;;;;GAUG;AACH,MAAM,MAAM,0BAA0B,GAAG,QAAQ,CAAC;IAC9C,UAAU,EAAE,MAAM,CAAC;IACnB,iBAAiB,CAAC,EAAE,aAAa,CAAC,kBAAkB,CAAC,CAAC;CACzD,CAAC,CAAC;AAEH;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,MAAM,yBAAyB,GAAG,QAAQ,CAAC;IAC7C,WAAW,EAAE,EAAE,CAAC,UAAU,CAAC;IAC3B,QAAQ,EAAE,cAAc,CAAC;IACzB,WAAW,EAAE,aAAa,CAAC,iBAAiB,CAAC,CAAC;CACjD,CAAC,CAAC;AAEH;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,mBAAmB,CAC/B,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,0BAA0B,GACjC,yBAAyB,CAkH3B;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,MAAM,cAAc,GAAG,QAAQ,CAAC;IAClC,UAAU,EAAE,CAAC,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,UAAU,CAAC;IAC5C,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,QAAQ,CAAC;IAClB,iBAAiB,CAAC,EAAE,aAAa,CAAC,kBAAkB,CAAC,CAAC;CACzD,CAAC,CAAC;AAEH;;;;;;;;;GASG;AACH,MAAM,MAAM,kBAAkB,GAAG,cAAc,GAC3C,QAAQ,CAAC;IACL,KAAK,CAAC,EAAE,OAAO,CAAC;CACnB,CAAC,CAAC;AAEP;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,cAAc,GAAG,QAAQ,CAAC;IAClC,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,cAAc,CAAC;IACzB,KAAK,EAAE,MAAM,CAAC;CACjB,CAAC,CAAC;AAEH;;;;;;;;;;;;;GAaG;AACH,qBAAa,YAAa,SAAQ,KAAK;IACnC,QAAQ,CAAC,WAAW,EAAE,aAAa,CAAC,iBAAiB,CAAC,CAAC;gBAE3C,WAAW,EAAE,aAAa,CAAC,iBAAiB,CAAC;CAU5D;AAOD;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC,CAuC3F;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAcjF;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAAC,cAAc,CAAC,CA4BjG;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CA+BvE;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,cAAc,CAChC,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,cAAc,GACrB,OAAO,CAAC,aAAa,CAAC,cAAc,CAAC,CAAC,CAYxC"}

package/dist/api.js

@@ -0,0 +1,354 @@
+// Copyright (c) 2026 Invinite. Licensed under the MIT License.
+// See the LICENSE file in the repo root for full license text.
+import { randomBytes } from "node:crypto";
+import { readFile, readdir, rename, unlink, writeFile } from "node:fs/promises";
+import { isAbsolute, join, relative, resolve as resolvePath } from "node:path";
+import { STATEFUL_PRIMITIVES_BY_NAME } from "@invinite-org/chartlang-core";
+import ts from "typescript";
+import { extractAlertConditions, extractCapabilities, extractInputs, extractMaxLookback, extractRequestedIntervals, extractRequiresIntervals, runForbiddenConstructs, runStatefulCallInLoop, runStructuralChecks, validateLowerTfIntervals, } from "./analysis/index.js";
+import { bundleModule, formatManifestAssignment } from "./bundle.js";
+import { mapTsDiagnostic } from "./diagnostics.js";
+import { buildManifest } from "./manifest.js";
+import { createProgramForSource } from "./program.js";
+import { injectCallsiteIds } from "./transformers/callsiteIdInjection.js";
+import { emitTypes } from "./typesEmit.js";
+/**
+ * Run the Phase-1 compiler pipeline against an in-memory script source.
+ * Builds a TypeScript program, runs the structural / forbidden-construct /
+ * stateful-call-in-loop checks, rewrites stateful calls with callsite ids,
+ * and extracts the manifest's `capabilities` / `maxLookback` /
+ * `seriesCapacities` / `inputs` fields.
+ *
+ * Error-severity diagnostics short-circuit the transform: the function
+ * returns the original `sourceFile` and a placeholder manifest so callers
+ * can still surface the errors uniformly. The public `compile` /
+ * `compileFile` / `compileProject` wrappers above turn those error
+ * diagnostics into a `CompileError` throw.
+ *
+ * @since 0.1
+ * @example
+ *     // const result = transformAndAnalyse(
+ *     //     'export default defineIndicator({ name: "x", apiVersion: 1, compute: () => {} });',
+ *     //     { sourcePath: "demo.chart.ts" },
+ *     // );
+ *     const fn: typeof transformAndAnalyse = transformAndAnalyse;
+ *     void fn;
+ */
+export function transformAndAnalyse(source, opts) {
+    const sourcePath = opts.sourcePath;
+    const { program, sourceFile, checker } = createProgramForSource(source, { sourcePath });
+    const structural = runStructuralChecks(sourceFile, checker, sourcePath);
+    const forbidden = runForbiddenConstructs(sourceFile, sourcePath);
+    const statefulInLoop = runStatefulCallInLoop(sourceFile, checker, sourcePath, STATEFUL_PRIMITIVES_BY_NAME);
+    // PLAN §5.2 step 1: the pipeline starts with tsc programmatic-API
+    // typechecking against `@invinite-org/chartlang-core`'s ambient
+    // declarations. Surface every semantic error coming from the
+    // user's source file under the stable `type-error` code. Shim
+    // diagnostics are dropped — they always come from the synthetic
+    // core.d.ts and would only ever signal a chartlang-side bug.
+    const semanticDiagnostics = program
+        .getSemanticDiagnostics(sourceFile)
+        .filter((d) => d.file?.fileName === sourceFile.fileName)
+        .map((d) => mapTsDiagnostic(d, sourcePath));
+    const earlyDiagnostics = [
+        ...semanticDiagnostics,
+        ...structural.diagnostics,
+        ...forbidden,
+        ...statefulInLoop,
+    ];
+    const hasError = earlyDiagnostics.some((d) => d.severity === "error");
+    if (hasError) {
+        return Object.freeze({
+            transformed: sourceFile,
+            manifest: buildManifest({
+                name: structural.name,
+                kind: structural.kind,
+                capabilities: ["indicators"],
+                requestedIntervals: [],
+                userPickableInterval: false,
+                seriesCapacities: {},
+                maxLookback: 0,
+                inputs: {},
+                ...structural.overrides,
+            }),
+            diagnostics: Object.freeze(earlyDiagnostics.slice()),
+        });
+    }
+    const injection = injectCallsiteIds(sourceFile, checker, {
+        sourcePath,
+        statefulByName: STATEFUL_PRIMITIVES_BY_NAME,
+    });
+    const capabilities = extractCapabilities(sourceFile, checker, structural.kind);
+    const lookback = extractMaxLookback(sourceFile, checker, sourcePath);
+    const inputs = extractInputs(sourceFile, checker, sourcePath);
+    const alertConditions = extractAlertConditions(sourceFile, checker, sourcePath);
+    const intervalDiagnostics = [];
+    const requestedIntervalsFromCalls = extractRequestedIntervals(sourceFile, checker, inputs.inputs, intervalDiagnostics, sourcePath);
+    const requiresIntervals = extractRequiresIntervals(sourceFile, checker, intervalDiagnostics, sourcePath);
+    const lowerTfDiagnostics = validateLowerTfIntervals(sourceFile, checker, sourcePath, opts.declaredIntervals ?? []);
+    const requestedIntervals = Array.from(new Set([...requestedIntervalsFromCalls, ...requiresIntervals])).sort();
+    const { requiresIntervals: structuralRequiresIntervals, ...structuralOverrides } = structural.overrides;
+    void structuralRequiresIntervals;
+    const manifest = buildManifest({
+        name: structural.name,
+        kind: structural.kind,
+        capabilities,
+        requestedIntervals,
+        userPickableInterval: inputs.userPickableInterval,
+        seriesCapacities: lookback.seriesCapacities,
+        maxLookback: lookback.maxLookback,
+        inputs: inputs.inputs,
+        ...structuralOverrides,
+        ...(requiresIntervals.length === 0 ? {} : { requiresIntervals }),
+        ...(alertConditions.alertConditions.length === 0
+            ? {}
+            : { alertConditions: alertConditions.alertConditions }),
+    });
+    const allDiagnostics = [
+        ...earlyDiagnostics,
+        ...injection.diagnostics,
+        ...lookback.diagnostics,
+        ...inputs.diagnostics,
+        ...alertConditions.diagnostics,
+        ...intervalDiagnostics,
+        ...lowerTfDiagnostics,
+    ];
+    return Object.freeze({
+        transformed: injection.transformed,
+        manifest,
+        diagnostics: Object.freeze(allDiagnostics.slice()),
+    });
+}
+/**
+ * Error thrown by `compile` / `compileFile` / `compileProject` when any
+ * compilation produces an error-severity diagnostic. Carries the full
+ * frozen diagnostic array on `err.diagnostics`; the message starts with the
+ * first diagnostic's `code: message (file:line:column)` so console output
+ * stays compact.
+ *
+ * @since 0.1
+ * @example
+ *     // try { await compile(badSrc, { apiVersion: 1 }); }
+ *     // catch (err) { if (err instanceof CompileError) console.error(err.diagnostics); }
+ *     const E: typeof CompileError = CompileError;
+ *     void E;
+ */
+export class CompileError extends Error {
+    diagnostics;
+    constructor(diagnostics) {
+        const first = diagnostics[0];
+        const message = first === undefined
+            ? "Compilation failed"
+            : `${first.code}: ${first.message} (${first.file}:${first.line}:${first.column})`;
+        super(message);
+        this.name = "CompileError";
+        this.diagnostics = diagnostics;
+    }
+}
+const PRINTER = ts.createPrinter({
+    removeComments: false,
+    newLine: ts.NewLineKind.LineFeed,
+});
+/**
+ * Compile a script source into a frozen `CompiledScript` triple. Runs
+ * `transformAndAnalyse`, throws `CompileError` on any error diagnostic,
+ * prints the transformed AST, drives esbuild to ESM, appends the
+ * `__manifest` assignment, and emits the `.d.ts` sibling.
+ *
+ * @since 0.1
+ * @example
+ *     // const result = await compile(emaCrossSource, {
+ *     //     apiVersion: 1,
+ *     //     sourcePath: "ema-cross.chart.ts",
+ *     // });
+ *     const fn: typeof compile = compile;
+ *     void fn;
+ */
+export async function compile(source, opts) {
+    const sourcePath = opts.sourcePath ?? "script.chart.ts";
+    const result = transformAndAnalyse(source, {
+        sourcePath,
+        ...(opts.declaredIntervals === undefined
+            ? {}
+            : { declaredIntervals: opts.declaredIntervals }),
+    });
+    const errors = result.diagnostics.filter((d) => d.severity === "error");
+    if (errors.length > 0) {
+        throw new CompileError(Object.freeze(errors.slice()));
+    }
+    const transformedSource = PRINTER.printFile(result.transformed);
+    const sourcemap = opts.sourcemap ?? false;
+    const bundle = await bundleModule({
+        transformedSource,
+        sourcePath,
+        sourcemap,
+        minify: opts.minify ?? false,
+    });
+    const moduleSource = `${bundle.moduleSource}${formatManifestAssignment(result.manifest)}`;
+    const types = emitTypes({ manifest: result.manifest, sourcePath });
+    if (bundle.sourcemap !== undefined) {
+        return Object.freeze({
+            moduleSource,
+            sourcemap: bundle.sourcemap,
+            manifest: result.manifest,
+            types,
+        });
+    }
+    return Object.freeze({
+        moduleSource,
+        manifest: result.manifest,
+        types,
+    });
+}
+/**
+ * Write a file atomically — render to a `<target>.tmp.<rand>` sibling first,
+ * then `rename` into place. On any error during write or rename, the temp
+ * file is unlinked so the caller never sees a half-written artefact.
+ *
+ * @since 0.1
+ * @example
+ *     // await writeAtomic("/tmp/foo.txt", "hello");
+ *     const fn: typeof writeAtomic = writeAtomic;
+ *     void fn;
+ */
+export async function writeAtomic(target, contents) {
+    const suffix = randomBytes(8).toString("hex");
+    const tmp = `${target}.tmp.${suffix}`;
+    try {
+        await writeFile(tmp, contents, "utf8");
+        await rename(tmp, target);
+    }
+    catch (err) {
+        try {
+            await unlink(tmp);
+        }
+        catch {
+            // Best-effort cleanup; the rename failure is the real error.
+        }
+        throw err;
+    }
+}
+/**
+ * Read a `.chart.ts` file from disk, compile it, and (when `write !== false`)
+ * emit the three sibling files atomically — `<base>.chart.js`,
+ * `<base>.chart.manifest.json`, `<base>.chart.d.ts`, plus
+ * `<base>.chart.js.map` when `sourcemap` is external.
+ *
+ * @since 0.1
+ * @example
+ *     // const result = await compileFile("./demo.chart.ts", { apiVersion: 1 });
+ *     const fn: typeof compileFile = compileFile;
+ *     void fn;
+ */
+export async function compileFile(path, opts) {
+    const absolute = isAbsolute(path) ? path : resolvePath(process.cwd(), path);
+    const source = await readFile(absolute, "utf8");
+    const sourcePath = opts.sourcePath ?? toPosixRelative(process.cwd(), absolute);
+    const compileOpts = stripWriteFlag({ ...opts, sourcePath });
+    const result = await compile(source, compileOpts);
+    if (opts.write === false) {
+        return result;
+    }
+    const base = absolute.replace(/\.chart\.ts$/, "");
+    const jsPath = `${base}.chart.js`;
+    const manifestPath = `${base}.chart.manifest.json`;
+    const dtsPath = `${base}.chart.d.ts`;
+    await writeAtomic(jsPath, result.moduleSource);
+    await writeAtomic(manifestPath, JSON.stringify(result.manifest, null, 4));
+    await writeAtomic(dtsPath, result.types);
+    if ((opts.sourcemap === true || opts.sourcemap === "external") &&
+        result.sourcemap !== undefined) {
+        await writeAtomic(`${jsPath}.map`, result.sourcemap);
+    }
+    return result;
+}
+/**
+ * Walk `rootDir` recursively and return every `*.chart.ts` file's absolute
+ * path. Skips `node_modules` and `dist` subtrees. The walker is iterative to
+ * stay portable across Node 20.1 → 20.x.
+ *
+ * @since 0.1
+ * @example
+ *     // const files = await walkChartFiles("./examples/scripts");
+ *     const fn: typeof walkChartFiles = walkChartFiles;
+ *     void fn;
+ */
+export async function walkChartFiles(rootDir) {
+    const absolute = isAbsolute(rootDir) ? rootDir : resolvePath(process.cwd(), rootDir);
+    const out = [];
+    const queue = [absolute];
+    for (;;) {
+        const current = queue.shift();
+        if (current === undefined)
+            break;
+        let entries;
+        try {
+            entries = await readDirEntries(current);
+        }
+        catch {
+            continue;
+        }
+        for (const entry of entries) {
+            if (entry.name === "node_modules" || entry.name === "dist")
+                continue;
+            const full = join(current, entry.name);
+            if (entry.isDirectory) {
+                queue.push(full);
+                continue;
+            }
+            if (entry.isFile && full.endsWith(".chart.ts")) {
+                out.push(full);
+            }
+        }
+    }
+    out.sort();
+    return out;
+}
+/**
+ * Discover every `*.chart.ts` under `rootDir` and compile each in parallel.
+ * Results are returned in deterministic (path-sorted) order so callers can
+ * snapshot the array safely. Compilation runs in memory only — the CLI
+ * (Phase-1 Task 11) loops `compileFile` when it needs sibling files on disk.
+ *
+ * @since 0.1
+ * @example
+ *     // const all = await compileProject("./examples/scripts", { apiVersion: 1 });
+ *     const fn: typeof compileProject = compileProject;
+ *     void fn;
+ */
+export async function compileProject(rootDir, opts) {
+    const files = await walkChartFiles(rootDir);
+    const compiled = await Promise.all(files.map((file) => compileFile(file, {
+        ...opts,
+        write: false,
+        sourcePath: toPosixRelative(process.cwd(), file),
+    })));
+    return Object.freeze(compiled);
+}
+function toPosixRelative(cwd, absolute) {
+    return relative(cwd, absolute).replace(/\\/g, "/");
+}
+async function readDirEntries(dir) {
+    const raw = await readdir(dir, { withFileTypes: true });
+    return raw.map((entry) => Object.freeze({
+        name: entry.name,
+        isDirectory: entry.isDirectory(),
+        isFile: entry.isFile(),
+    }));
+}
+function stripWriteFlag(opts) {
+    const { apiVersion, sourcePath, sourcemap, minify, target, declaredIntervals } = opts;
+    const out = { apiVersion };
+    if (sourcePath !== undefined)
+        out.sourcePath = sourcePath;
+    if (sourcemap !== undefined)
+        out.sourcemap = sourcemap;
+    if (minify !== undefined)
+        out.minify = minify;
+    if (target !== undefined)
+        out.target = target;
+    if (declaredIntervals !== undefined)
+        out.declaredIntervals = declaredIntervals;
+    return out;
+}
+//# sourceMappingURL=api.js.map

package/dist/api.js.map

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

package/dist/bundle.d.ts

@@ -0,0 +1,75 @@
+import type { ScriptManifest } from "@invinite-org/chartlang-core";
+/**
+ * Options accepted by `bundleModule`. `transformedSource` is the printed text
+ * of the callsite-id-injected `ts.SourceFile`; `sourcePath` becomes the
+ * sourcemap `sourcefile` field; `sourcemap` mirrors the compile API contract;
+ * `minify` toggles esbuild's minifier.
+ *
+ * @since 0.1
+ * @example
+ *     const opts: BundleModuleOptions = {
+ *         transformedSource: "export default {};",
+ *         sourcePath: "demo.chart.ts",
+ *         sourcemap: false,
+ *         minify: false,
+ *     };
+ */
+export type BundleModuleOptions = Readonly<{
+    transformedSource: string;
+    sourcePath: string;
+    sourcemap: boolean | "inline" | "external";
+    minify: boolean;
+}>;
+/**
+ * Result of `bundleModule`. `moduleSource` is the ESM output; `sourcemap` is
+ * the external map JSON when `sourcemap === true | "external"` and omitted
+ * when `sourcemap === false | "inline"`. Inline sourcemaps land inside
+ * `moduleSource` as a base64 `sourceMappingURL` comment.
+ *
+ * @since 0.1
+ * @example
+ *     const result: BundleModuleResult = { moduleSource: "export default {};" };
+ *     void result;
+ */
+export type BundleModuleResult = Readonly<{
+    moduleSource: string;
+    sourcemap?: string;
+}>;
+/**
+ * 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 declare function bundleModule(opts: BundleModuleOptions): Promise<BundleModuleResult>;
+/**
+ * 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 declare function formatManifestAssignment(manifest: ScriptManifest): string;
+//# sourceMappingURL=bundle.d.ts.map

package/dist/bundle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bundle.d.ts","sourceRoot":"","sources":["../src/bundle.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAGnE;;;;;;;;;;;;;;GAcG;AACH,MAAM,MAAM,mBAAmB,GAAG,QAAQ,CAAC;IACvC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,OAAO,GAAG,QAAQ,GAAG,UAAU,CAAC;IAC3C,MAAM,EAAE,OAAO,CAAC;CACnB,CAAC,CAAC;AAEH;;;;;;;;;;GAUG;AACH,MAAM,MAAM,kBAAkB,GAAG,QAAQ,CAAC;IACtC,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC,CAAC;AAOH;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAsB,YAAY,CAAC,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAgDzF;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,cAAc,GAAG,MAAM,CAEzE"}