ttsc 0.20.1 → 0.22.0

package/lib/compiler/internal/residentCheckProcess.js

@@ -0,0 +1,227 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ResidentCheckProcess = void 0;
+const node_child_process_1 = require("node:child_process");
+const node_readline_1 = require("node:readline");
+const residentTransformProcess_1 = require("./residentTransformProcess");
+const STDERR_TAIL_LIMIT = 64 * 1024;
+const REPLY_ECHO_LIMIT = 200;
+const TERMINATION_GRACE_MS = 1_000;
+/**
+ * FIFO JSON-line client for a check-stage `check-serve` sidecar.
+ *
+ * A watch session serializes cycles, but the client still queues replies so a
+ * caller cannot accidentally pair a late response with the next request. Any
+ * framing failure retires the process; the launcher then falls back to the
+ * ordinary one-shot command for that cycle.
+ */
+class ResidentCheckProcess {
+    child;
+    pending = [];
+    reader;
+    requestTimeoutMs;
+    failure;
+    stderr = "";
+    constructor(options) {
+        this.requestTimeoutMs = (0, residentTransformProcess_1.normalizeRequestTimeoutMs)(options.requestTimeoutMs);
+        this.child = (0, node_child_process_1.spawn)(options.binary, [...options.args], {
+            cwd: options.cwd,
+            env: options.env,
+            windowsHide: true,
+        });
+        const stdin = this.child.stdin;
+        const stdout = this.child.stdout;
+        if (stdin === null || stdout === null) {
+            this.child.kill();
+            throw new Error("ttsc: resident check host has no stdio pipes");
+        }
+        this.reader = (0, node_readline_1.createInterface)({ input: stdout });
+        this.reader.on("line", (line) => this.onLine(line));
+        this.reader.on("close", () => {
+            if (this.failure === undefined)
+                this.fail(this.exitError());
+        });
+        this.child.stderr?.on("data", (chunk) => {
+            const text = typeof chunk === "string" ? chunk : chunk.toString("utf8");
+            this.stderr = (this.stderr + text).slice(-STDERR_TAIL_LIMIT);
+        });
+        this.child.on("error", (error) => this.fail(error));
+        stdin.on("error", (error) => this.fail(error));
+        stdout.on("error", (error) => this.fail(error));
+        this.child.stderr?.on("error", () => { });
+    }
+    request(payload) {
+        if (this.failure !== undefined)
+            return Promise.reject(this.failure);
+        const stdin = this.child.stdin;
+        if (stdin === null || stdin.destroyed) {
+            return Promise.reject(new Error("ttsc: resident check host stdin is closed"));
+        }
+        let line;
+        try {
+            line = `${JSON.stringify(payload)}\n`;
+        }
+        catch (error) {
+            return Promise.reject(asError(error));
+        }
+        return new Promise((resolve, reject) => {
+            const pending = {
+                reject,
+                resolve,
+                timer: setTimeout(() => {
+                    const detail = stderrSuffix(this.stderr);
+                    const timeout = new Error(`ttsc: resident check request timed out after ${String(this.requestTimeoutMs)} ms${detail}`);
+                    this.settle(pending, timeout);
+                    this.fail(timeout);
+                }, this.requestTimeoutMs),
+            };
+            pending.timer.unref();
+            this.pending.push(pending);
+            try {
+                stdin.write(line, (error) => {
+                    if (error === null || error === undefined)
+                        return;
+                    this.settle(pending, error);
+                    this.fail(error);
+                });
+            }
+            catch (error) {
+                const reason = asError(error);
+                this.settle(pending, reason);
+                this.fail(reason);
+            }
+        });
+    }
+    dispose() {
+        if (this.failure !== undefined)
+            return;
+        this.fail(new Error("ttsc: resident check host disposed"));
+    }
+    onLine(line) {
+        if (this.failure !== undefined || line.trim().length === 0)
+            return;
+        const pending = this.pending[0];
+        if (pending === undefined) {
+            this.fail(new Error("ttsc: resident check host sent an unsolicited reply"));
+            return;
+        }
+        const result = parseResidentCheckResult(line);
+        if (result === undefined) {
+            const error = new Error(`ttsc: resident check host sent a malformed reply: ${echoLine(line)}`);
+            this.settle(pending, error);
+            this.fail(error);
+            return;
+        }
+        this.settle(pending, result);
+    }
+    settle(pending, result) {
+        const index = this.pending.indexOf(pending);
+        if (index === -1)
+            return;
+        this.pending.splice(index, 1);
+        clearTimeout(pending.timer);
+        if (result instanceof Error)
+            pending.reject(result);
+        else
+            pending.resolve(result);
+    }
+    fail(error) {
+        if (this.failure !== undefined)
+            return;
+        this.failure = error;
+        while (this.pending.length !== 0) {
+            this.settle(this.pending[0], error);
+        }
+        this.terminate();
+    }
+    terminate() {
+        const stdin = this.child.stdin;
+        if (stdin !== null && !stdin.destroyed)
+            stdin.destroy();
+        if (this.child.exitCode !== null || this.child.signalCode !== null)
+            return;
+        try {
+            this.child.kill();
+        }
+        catch {
+            return;
+        }
+        const force = setTimeout(() => {
+            if (this.child.exitCode !== null || this.child.signalCode !== null)
+                return;
+            try {
+                this.child.kill("SIGKILL");
+            }
+            catch {
+                // The host exited between the liveness check and forced termination.
+            }
+        }, TERMINATION_GRACE_MS);
+        force.unref();
+        this.child.once("exit", () => clearTimeout(force));
+    }
+    exitError() {
+        const detail = this.stderr.trim();
+        if (detail.length !== 0)
+            return new Error(detail);
+        const signal = this.child.signalCode === null ? "" : `, signal ${this.child.signalCode}`;
+        return new Error(`ttsc: resident check host exited (code ${this.child.exitCode ?? "null"}${signal})`);
+    }
+}
+exports.ResidentCheckProcess = ResidentCheckProcess;
+function parseResidentCheckResult(line) {
+    let value;
+    try {
+        value = JSON.parse(line);
+    }
+    catch {
+        return undefined;
+    }
+    if (!isRecord(value) ||
+        typeof value.status !== "number" ||
+        !Number.isInteger(value.status)) {
+        return undefined;
+    }
+    if (typeof value.stdout !== "string" || typeof value.stderr !== "string") {
+        return undefined;
+    }
+    const telemetry = value.telemetry;
+    if (!isRecord(telemetry) ||
+        typeof telemetry.pid !== "number" ||
+        !Number.isSafeInteger(telemetry.pid) ||
+        typeof telemetry.programLoads !== "number" ||
+        !Number.isSafeInteger(telemetry.programLoads) ||
+        typeof telemetry.programUpdates !== "number" ||
+        !Number.isSafeInteger(telemetry.programUpdates) ||
+        typeof telemetry.reused !== "boolean") {
+        return undefined;
+    }
+    return {
+        diagnostics: [],
+        status: value.status,
+        stderr: value.stderr,
+        stdout: value.stdout,
+        telemetry: {
+            pid: telemetry.pid,
+            programLoads: telemetry.programLoads,
+            programUpdates: telemetry.programUpdates,
+            reused: telemetry.reused,
+        },
+    };
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function echoLine(line) {
+    const trimmed = line.trim();
+    return JSON.stringify(trimmed.length <= REPLY_ECHO_LIMIT
+        ? trimmed
+        : `${trimmed.slice(0, REPLY_ECHO_LIMIT)}…`);
+}
+function stderrSuffix(stderr) {
+    const detail = stderr.trim();
+    return detail.length === 0 ? "" : `: ${detail}`;
+}
+function asError(error) {
+    return error instanceof Error ? error : new Error(String(error));
+}
+//# sourceMappingURL=residentCheckProcess.js.map

package/lib/compiler/internal/residentCheckProcess.js.map

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

package/lib/compiler/internal/resolveEmittedJavaScript.d.ts

@@ -5,7 +5,8 @@
  *
  * 1. Try to derive the exact output path by mirroring the source's relative
  *    position inside `projectRoot` into `outDir`, applying the correct JS
- *    extension (`.js` / `.mjs` / `.cjs`). Use this path if it exists on disk.
+ *    extension (`.js` / `.jsx` / `.mjs` / `.cjs`). Use this path if it exists
+ *    on disk.
  * 2. Fall back to scoring each candidate in `emittedFiles` (or a recursive
  *    directory scan of `outDir`) by the number of trailing path-stem segments
  *    shared with the source file name, and pick the highest-scoring existing

package/lib/compiler/internal/resolveEmittedJavaScript.js

@@ -14,7 +14,8 @@ const paths_1 = require("./paths");
  *
  * 1. Try to derive the exact output path by mirroring the source's relative
  *    position inside `projectRoot` into `outDir`, applying the correct JS
- *    extension (`.js` / `.mjs` / `.cjs`). Use this path if it exists on disk.
+ *    extension (`.js` / `.jsx` / `.mjs` / `.cjs`). Use this path if it exists
+ *    on disk.
  * 2. Fall back to scoring each candidate in `emittedFiles` (or a recursive
  *    directory scan of `outDir`) by the number of trailing path-stem segments
  *    shared with the source file name, and pick the highest-scoring existing
@@ -23,9 +24,17 @@ const paths_1 = require("./paths");
  * Returns `null` when no matching output file is found on disk.
  */
 function resolveEmittedJavaScript(options) {
-    const exact = resolveExactEmittedFile(options.outDir, options.projectRoot, options.sourceFile);
-    if (exact && node_fs_1.default.existsSync(exact)) {
-        return exact;
+    const exact = resolveExactEmittedFiles(options.outDir, options.projectRoot, options.sourceFile);
+    const emitted = new Set(options.emittedFiles?.map((file) => emittedPathKey(file)) ?? []);
+    for (const candidate of exact) {
+        if (emitted.has(emittedPathKey(candidate)) && node_fs_1.default.existsSync(candidate)) {
+            return candidate;
+        }
+    }
+    for (const candidate of exact) {
+        if (node_fs_1.default.existsSync(candidate)) {
+            return candidate;
+        }
     }
     // Score the pre-computed emit list first (cheap). When it yields nothing —
     // because the list is incomplete (a native transform host such as typia emits
@@ -64,16 +73,16 @@ function bestStemMatch(files, sourceFile) {
 }
 /**
  * Derive the exact output path for `sourceFile` by mirroring its position
- * relative to `projectRoot` into `outDir`. Returns `null` when the source is
- * not inside the project root or when the path cannot be determined.
+ * relative to `projectRoot` into `outDir`. Returns no candidates when the
+ * source is not inside the project root or when the path cannot be determined.
  */
-function resolveExactEmittedFile(outDir, projectRoot, sourceFile) {
+function resolveExactEmittedFiles(outDir, projectRoot, sourceFile) {
     const relative = node_path_1.default.relative(projectRoot, sourceFile);
     if (relative === "" || (0, paths_1.isOutsideRelativePath)(relative)) {
-        return null;
+        return [];
     }
-    return node_path_1.default.resolve(outDir, relative.slice(0, relative.length - node_path_1.default.extname(relative).length) +
-        emittedJavaScriptExtension(sourceFile));
+    const stem = relative.slice(0, relative.length - node_path_1.default.extname(relative).length);
+    return emittedJavaScriptExtensions(sourceFile).map((extension) => node_path_1.default.resolve(outDir, stem + extension));
 }
 /**
  * Recursively enumerate every JavaScript output file under `root`. Uses an
@@ -125,21 +134,29 @@ function sharedSourceStemSegments(outPath, srcPath) {
     return shared;
 }
 /**
- * Map a TypeScript source extension to its JavaScript output counterpart.
- * `.mts` → `.mjs`, `.cts` → `.cjs`, everything else → `.js`.
+ * Map a source extension to every JavaScript output counterpart tsgo can use.
+ * JSX preserve mode writes `.tsx`/`.jsx` inputs as `.jsx`; all other JSX modes
+ * write `.js`.
  */
-function emittedJavaScriptExtension(filename) {
+function emittedJavaScriptExtensions(filename) {
     switch (node_path_1.default.extname(filename).toLowerCase()) {
         case ".mts":
-            return ".mjs";
+            return [".mjs"];
         case ".cts":
-            return ".cjs";
+            return [".cjs"];
+        case ".tsx":
+        case ".jsx":
+            return [".js", ".jsx"];
         default:
-            return ".js";
+            return [".js"];
     }
 }
-/** Return true when `filename` has a `.js`, `.mjs`, or `.cjs` extension. */
+/** Return true when `filename` has a JavaScript output extension. */
 function isJavaScriptOutput(filename) {
-    return /\.(?:[cm]?js)$/i.test(filename);
+    return /\.(?:[cm]?js|jsx)$/i.test(filename);
+}
+function emittedPathKey(filename) {
+    const resolved = node_path_1.default.resolve(filename);
+    return process.platform === "win32" ? resolved.toLowerCase() : resolved;
 }
 //# sourceMappingURL=resolveEmittedJavaScript.js.map

package/lib/compiler/internal/resolveEmittedJavaScript.js.map

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

package/lib/compiler/internal/runBuild.d.ts

@@ -1,16 +1,28 @@
+import { type ProjectInputPathIdentityContext } from "../../internal/projectInputPathIdentity";
 import type { ITtscCompilerDiagnostic } from "../../structures/ITtscCompilerDiagnostic";
+import type { ITtscLoadedNativePlugin } from "../../structures/internal/ITtscLoadedNativePlugin";
 import type { ITtscParsedProjectConfig } from "../../structures/internal/ITtscParsedProjectConfig";
+import type { ITtscProjectInputSnapshot } from "../../structures/internal/ITtscProjectInputSnapshot";
 import type { TtscBuildOptions } from "../../structures/internal/TtscBuildOptions";
 import type { TtscBuildResult } from "../../structures/internal/TtscBuildResult";
-type RunBuildOptions = TtscBuildOptions & {
+import { type ResidentCheckRequest } from "./residentCheckProcess";
+export type RunBuildOptions = TtscBuildOptions & {
     skipDiagnosticsCheck?: boolean;
     forceListEmittedFiles?: boolean;
+    /** Keep every compiler-owned side product inside this private directory. */
+    isolateOutputsTo?: string;
     /**
      * Receives selected native-plugin source roots after the project resolves.
      * The watch launcher uses these roots to invalidate a sidecar when its Go
      * implementation changes between rebuilds.
      */
     onWatchInputs?: (inputs: readonly string[]) => void;
+    /**
+     * Receives the reconciled project-rule filesystem dependency snapshot. Called
+     * only by watch launchers; ordinary builds do not probe the optional sidecar
+     * command.
+     */
+    onProjectInputs?: (inputs: ITtscProjectInputSnapshot) => void;
     /**
      * Emit an external source map from the direct tsgo build lane even when the
      * project configures none. Set by the ttsx runtime builds so a served emit
@@ -27,6 +39,57 @@ type RunBuildOptions = TtscBuildOptions & {
  * decide how to surface diagnostics. Does not throw on non-zero exit.
  */
 export declare function runBuild(options?: RunBuildOptions): TtscBuildResult;
+export type ResidentCheckWatchChange = {
+    /** Re-resolve project, plugin, contributor, and Program topology. */
+    reload?: boolean;
+    /** Retain the sidecar and execution selection but cold-load its Program. */
+    invalidate?: boolean;
+    /** Local compiler or data paths changed since the prior cycle. */
+    changed?: readonly string[];
+    /** Subset of changed paths declared by ProjectRules as external inputs. */
+    external?: readonly string[];
+};
+/**
+ * Analysis-only watch coordinator.
+ *
+ * The selected project and compatible check-stage processes stay resident
+ * across ordinary source/data edits. A config, root-set, contributor, or plugin
+ * topology transition calls for a full reset before the next cycle. Emit and
+ * transform lanes can pass through the coordinator, but compatibility checks
+ * keep them on the established one-shot path without starting sidecars.
+ */
+export declare class ResidentCheckWatchSession {
+    private execution;
+    private readonly pendingChanges;
+    private projectInputs;
+    private readonly processes;
+    run(options: RunBuildOptions, change?: ResidentCheckWatchChange): Promise<TtscBuildResult>;
+    /** Terminate every sidecar and discard the cached selection context. */
+    dispose(): void;
+    private reset;
+    private captureProjectInputs;
+    private refreshProjectInputTopology;
+    private runCheckPlugins;
+}
+export type ResidentCheckEntryPlan = {
+    args: string[];
+    entryIndex: number;
+    key: string | undefined;
+    plugin: ITtscLoadedNativePlugin;
+};
+/**
+ * Plan every configured check entry while sharing resident processes only by
+ * binary/name/argument identity.
+ */
+export declare function planResidentCheckEntries(plugins: readonly ITtscLoadedNativePlugin[], createArgs: (plugin: ITtscLoadedNativePlugin) => string[]): ResidentCheckEntryPlan[];
+/** Retain one complete change stream per configured resident check entry. */
+export declare function bufferResidentCheckEntryRequests(pending: Map<number, ResidentCheckRequest>, checks: readonly ResidentCheckEntryPlan[], request: ResidentCheckRequest): void;
+/** Consume exactly one configured entry's buffered request. */
+export declare function takeResidentCheckEntryRequest(pending: Map<number, ResidentCheckRequest>, entryIndex: number): ResidentCheckRequest;
+export declare function residentCheckRequest(change: ResidentCheckWatchChange, cwd: string): ResidentCheckRequest;
+export declare function mergeProjectInputSnapshots(fallbackRoot: string, snapshots: readonly ITtscProjectInputSnapshot[], identities?: ProjectInputPathIdentityContext): ITtscProjectInputSnapshot;
+export declare function parseProjectInputSnapshot(text: string, plugin: ITtscLoadedNativePlugin): ITtscProjectInputSnapshot;
+export declare function isAbsoluteLocalProjectInputPath(location: string, platform?: NodeJS.Platform): boolean;
 /**
  * Merge two `TtscBuildResult` values into one.
  *