ttsc 0.20.1 → 0.22.0

package/lib/internal/projectInputPathIdentity.js

@@ -0,0 +1,222 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createProjectInputPathIdentityContext = createProjectInputPathIdentityContext;
+exports.isProjectInputPathIdentityWithin = isProjectInputPathIdentityWithin;
+exports.resolveProjectInputPath = resolveProjectInputPath;
+const node_child_process_1 = __importDefault(require("node:child_process"));
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_path_1 = __importDefault(require("node:path"));
+/**
+ * Create one filesystem-identity resolver for a project-input transaction.
+ *
+ * Existing segments use their physical spelling. A missing suffix keeps exact
+ * spelling only under a case-sensitive directory; otherwise its canonical
+ * spelling is folded so aliases remain one declaration before they exist.
+ */
+function createProjectInputPathIdentityContext(operations = {}) {
+    const identities = new Map();
+    const realpaths = new Map();
+    const sensitivities = new Map();
+    const realpath = operations.realpath ?? physicalRealpath;
+    const caseSensitive = operations.caseSensitive ?? filesystemDirectoryIsCaseSensitive;
+    const resolve = (location) => {
+        const normalized = resolveProjectInputPath(location);
+        const cached = identities.get(normalized);
+        if (cached !== undefined)
+            return cached.identity;
+        let existing = normalized;
+        const missing = [];
+        while (true) {
+            const physical = cachedRealpath(realpaths, realpath, existing);
+            if (physical !== undefined) {
+                const sensitive = missing.length === 0
+                    ? true
+                    : cachedCaseSensitivity(sensitivities, caseSensitive, physical);
+                const suffix = sensitive
+                    ? missing
+                    : missing.map((segment) => segment.toLowerCase());
+                const canonical = node_path_1.default.resolve(physical, ...suffix);
+                const identity = {
+                    key: canonical,
+                    path: canonical,
+                };
+                identities.set(normalized, {
+                    ancestor: physical,
+                    identity,
+                });
+                return identity;
+            }
+            const parent = node_path_1.default.dirname(existing);
+            if (parent === existing) {
+                const identity = {
+                    key: normalized,
+                    path: normalized,
+                };
+                identities.set(normalized, {
+                    ancestor: normalized,
+                    identity,
+                });
+                return identity;
+            }
+            missing.unshift(node_path_1.default.basename(existing));
+            existing = parent;
+        }
+    };
+    return {
+        caseSensitive: (directory) => {
+            const normalized = resolveProjectInputPath(directory);
+            resolve(normalized);
+            return cachedCaseSensitivity(sensitivities, caseSensitive, identities.get(normalized).ancestor);
+        },
+        isWithin: (root, candidate) => isProjectInputPathIdentityWithin(resolve(root).key, resolve(candidate).key),
+        resolve,
+    };
+}
+function isProjectInputPathIdentityWithin(root, candidate) {
+    if (candidate === root)
+        return true;
+    return candidate.startsWith(root.endsWith(node_path_1.default.sep) ? root : `${root}${node_path_1.default.sep}`);
+}
+function resolveProjectInputPath(location) {
+    if (process.platform !== "win32") {
+        return node_path_1.default.resolve(location);
+    }
+    const normalized = location.replaceAll("/", "\\");
+    if (normalized.toLowerCase().startsWith("\\\\?\\unc\\")) {
+        return node_path_1.default.resolve(`\\\\${normalized.slice(8)}`);
+    }
+    if (normalized.startsWith("\\\\?\\") &&
+        /^[A-Za-z]:\\/.test(normalized.slice(4))) {
+        return node_path_1.default.resolve(normalized.slice(4));
+    }
+    return node_path_1.default.resolve(normalized);
+}
+function cachedRealpath(cache, realpath, location) {
+    const cached = cache.get(location);
+    if (cached !== undefined)
+        return cached.found ? cached.path : undefined;
+    try {
+        const physical = resolveProjectInputPath(realpath(location));
+        cache.set(location, { found: true, path: physical });
+        return physical;
+    }
+    catch (error) {
+        if (isMissingFilesystemEntry(error) === false)
+            throw error;
+        cache.set(location, { found: false });
+        return undefined;
+    }
+}
+function cachedCaseSensitivity(cache, caseSensitive, directory) {
+    const cached = cache.get(directory);
+    if (cached !== undefined)
+        return cached;
+    const sensitive = caseSensitive(directory);
+    cache.set(directory, sensitive);
+    return sensitive;
+}
+function physicalRealpath(location) {
+    return node_fs_1.default.realpathSync.native?.(location) ?? node_fs_1.default.realpathSync(location);
+}
+function filesystemDirectoryIsCaseSensitive(directory) {
+    let entries;
+    try {
+        entries = node_fs_1.default.readdirSync(directory);
+    }
+    catch {
+        return unprovenCaseSensitivity();
+    }
+    const foldedNames = new Map();
+    for (const name of entries) {
+        const folded = name.toLowerCase();
+        const previous = foldedNames.get(folded);
+        if (previous !== undefined && previous !== name)
+            return true;
+        foldedNames.set(folded, name);
+    }
+    for (const name of entries) {
+        const alternate = alternateCase(name);
+        if (alternate === name)
+            continue;
+        try {
+            physicalRealpath(node_path_1.default.join(directory, alternate));
+            return false;
+        }
+        catch (error) {
+            if (isMissingFilesystemEntry(error))
+                continue;
+            throw error;
+        }
+    }
+    if (process.platform === "darwin") {
+        // APFS/HFS case semantics are volume-wide. An empty directory has no child
+        // name to probe, so ask the same read-only question of its existing name in
+        // the parent and walk upward until a name with ASCII case is available.
+        // This avoids a write probe while still distinguishing default APFS from a
+        // case-sensitive volume.
+        let current = resolveProjectInputPath(directory);
+        while (true) {
+            const parent = node_path_1.default.dirname(current);
+            if (parent === current)
+                break;
+            const name = node_path_1.default.basename(current);
+            const alternate = alternateCase(name);
+            if (alternate !== name) {
+                try {
+                    physicalRealpath(node_path_1.default.join(parent, alternate));
+                    return false;
+                }
+                catch (error) {
+                    if (isMissingFilesystemEntry(error) === false)
+                        throw error;
+                }
+            }
+            current = parent;
+        }
+        return unprovenCaseSensitivity();
+    }
+    if (process.platform !== "win32")
+        return true;
+    // Node does not expose the Windows per-directory flag. Prefer fsutil's
+    // read-only answer, then conservatively preserve distinct declarations.
+    const result = node_child_process_1.default.spawnSync("fsutil.exe", ["file", "queryCaseSensitiveInfo", directory], { encoding: "utf8", windowsHide: true });
+    if (result.error === undefined && result.status === 0) {
+        if (/\bdisabled\b/iu.test(result.stdout))
+            return false;
+        if (/\benabled\b/iu.test(result.stdout))
+            return true;
+    }
+    return unprovenCaseSensitivity();
+}
+/**
+ * What to assume when the volume refused to answer.
+ *
+ * Every probe above returns a proof: two names that fold together prove the
+ * volume keeps them apart, and a name that opens under the other case proves it
+ * does not. This is the remaining case — an empty or unreadable directory, a
+ * name with no letter to alter, a Windows build whose `fsutil` lacks the
+ * subcommand — and the only honest answer is the platform's own default.
+ *
+ * NTFS and APFS are case-insensitive unless a volume or a directory was opted
+ * out, so guessing sensitive there splits one file into two identities under
+ * two spellings, which is the failure this module exists to remove. The rarer
+ * mistake, on a volume that really was opted out, merges two files differing
+ * only in case into one watched identity.
+ */
+function unprovenCaseSensitivity() {
+    return process.platform !== "win32" && process.platform !== "darwin";
+}
+function alternateCase(value) {
+    return value.replace(/[A-Za-z]/g, (character) => character === character.toLowerCase()
+        ? character.toUpperCase()
+        : character.toLowerCase());
+}
+function isMissingFilesystemEntry(error) {
+    return (error instanceof Error &&
+        "code" in error &&
+        (error.code === "ENOENT" || error.code === "ENOTDIR"));
+}
+//# sourceMappingURL=projectInputPathIdentity.js.map

package/lib/internal/projectInputPathIdentity.js.map

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

package/lib/launcher/internal/runTtsc.d.ts

@@ -1,3 +1,5 @@
+import { type ResidentCheckWatchChange } from "../../compiler/internal/runBuild";
+import { type WatchInputChange } from "./watchTopology";
 /**
  * CLI entry point for `ttsc`. Dispatches argv to the appropriate build lane
  * (build, check, fix, format, prepare, clean, or native-delegate) and returns
@@ -9,3 +11,18 @@
  *   error or build failure.
  */
 export declare function runTtsc(argv?: readonly string[]): number;
+/**
+ * Coalesces filesystem events until the next resident check-watch cycle.
+ *
+ * A full reload dominates every narrower signal. Program invalidation remains
+ * distinct so a project-input module creation/deletion can cold-load the
+ * Program without discarding the selected execution or restarting the sidecar.
+ */
+export declare class PendingResidentCheckWatchChanges {
+    private readonly changed;
+    private readonly external;
+    private invalidate;
+    private reload;
+    push(change?: WatchInputChange, reload?: boolean): void;
+    take(): ResidentCheckWatchChange;
+}

package/lib/launcher/internal/runTtsc.js

@@ -3,6 +3,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.PendingResidentCheckWatchChanges = void 0;
 exports.runTtsc = runTtsc;
 const node_fs_1 = __importDefault(require("node:fs"));
 const node_path_1 = __importDefault(require("node:path"));
@@ -17,6 +18,7 @@ const assertSafeExplicitCacheDirectory_1 = require("../../internal/assertSafeExp
 const buildSourcePlugin_1 = require("../../plugin/internal/buildSourcePlugin");
 const getCompilerVersionText_1 = require("./getCompilerVersionText");
 const resolveCacheDir_1 = require("./resolveCacheDir");
+const singleFileOutput_1 = require("./singleFileOutput");
 const watchTopology_1 = require("./watchTopology");
 /**
  * CLI entry point for `ttsc`. Dispatches argv to the appropriate build lane
@@ -493,10 +495,11 @@ function runSingleFile(options) {
     const file = node_path_1.default.resolve(cwd, options.files[0]);
     const emit = singleFileShouldEmit(options, cwd, file);
     const out = emit
-        ? resolveSingleFileOut({
+        ? (0, singleFileOutput_1.resolveSingleFileOutput)({
             cliOutDir: options.outDir,
             cwd,
             file,
+            passthrough: options.passthrough,
             tsconfig: options.tsconfig,
         })
         : undefined;
@@ -505,6 +508,8 @@ function runSingleFile(options) {
         checkers: options.checkers,
         cwd,
         file,
+        onProjectInputs: options.onProjectInputs,
+        onWatchInputs: options.onWatchInputs,
         out,
         passthrough: options.passthrough,
         singleThreaded: options.singleThreaded,
@@ -536,80 +541,6 @@ function singleFileShouldEmit(options, cwd, file) {
     });
     return project.compilerOptions.noEmit !== true;
 }
-function resolveSingleFileOut(opts) {
-    const jsBasename = node_path_1.default.basename(opts.file).replace(/\.[cm]?tsx?$/i, "") +
-        singleFileJsExtension(opts.file);
-    // Explicit CLI --outDir wins. Mirrors the CWD-relative source layout under
-    // the requested directory so existing single-file invocations don't shift.
-    if (opts.cliOutDir) {
-        const relative = node_path_1.default.relative(opts.cwd, opts.file);
-        const jsRelative = relative.slice(0, relative.length - node_path_1.default.extname(relative).length) +
-            singleFileJsExtension(opts.file);
-        return node_path_1.default.resolve(opts.cwd, opts.cliOutDir, jsRelative);
-    }
-    // No CLI override: honor tsconfig's outDir so `ttsc src/foo.ts` lands the
-    // emitted JS at `<outDir>/<relative-from-rootDir>.js` instead of dropping
-    // it next to the source file. This matches how project mode emits and how
-    // `tsc <file>` would behave with the same tsconfig.
-    const projectOutDir = readProjectOutDir({
-        cwd: opts.cwd,
-        file: opts.file,
-        tsconfig: opts.tsconfig,
-    });
-    if (projectOutDir !== null) {
-        const fromRoot = node_path_1.default.relative(projectOutDir.rootDir, opts.file);
-        if (fromRoot !== "" && !isOutsideSingleFileLayout(fromRoot)) {
-            const jsRelative = fromRoot.slice(0, fromRoot.length - node_path_1.default.extname(fromRoot).length) +
-                singleFileJsExtension(opts.file);
-            return node_path_1.default.resolve(projectOutDir.outDir, jsRelative);
-        }
-        return node_path_1.default.resolve(projectOutDir.outDir, jsBasename);
-    }
-    // Last resort (no tsconfig outDir at all): emit next to the source. This
-    // preserves the legacy `ttsc <file.ts>` → `<file.js>` behavior for projects
-    // that intentionally don't configure outDir.
-    return opts.file.replace(/\.[cm]?tsx?$/i, singleFileJsExtension(opts.file));
-}
-function readProjectOutDir(opts) {
-    try {
-        const project = (0, readProjectConfig_1.readProjectConfig)({
-            cwd: opts.cwd,
-            file: opts.file,
-            tsconfig: opts.tsconfig,
-        });
-        const outDir = project.compilerOptions.outDir;
-        if (typeof outDir !== "string" || outDir.length === 0) {
-            return null;
-        }
-        const rawRoot = project.compilerOptions.rootDir;
-        const rootDir = typeof rawRoot === "string" && rawRoot.length !== 0
-            ? node_path_1.default.isAbsolute(rawRoot)
-                ? rawRoot
-                : node_path_1.default.resolve(project.root, rawRoot)
-            : project.root;
-        return { outDir, rootDir };
-    }
-    catch {
-        // Missing or unreadable tsconfig: fall back to the legacy behavior so
-        // `ttsc <file>` still works outside a configured project.
-        return null;
-    }
-}
-function isOutsideSingleFileLayout(relative) {
-    return (relative === ".." ||
-        relative.startsWith(`..${node_path_1.default.sep}`) ||
-        node_path_1.default.isAbsolute(relative));
-}
-function singleFileJsExtension(file) {
-    switch (node_path_1.default.extname(file).toLowerCase()) {
-        case ".mts":
-            return ".mjs";
-        case ".cts":
-            return ".cjs";
-        default:
-            return ".js";
-    }
-}
 function runWatch(options, checkOnly) {
     const cwd = node_path_1.default.resolve(options.cwd ?? process.cwd());
     let topology;
@@ -619,6 +550,9 @@ function runWatch(options, checkOnly) {
         onWatchInputs: (inputs) => {
             topology?.setExtraInputs(inputs);
         },
+        onProjectInputs: (inputs) => {
+            topology?.setProjectInputs(inputs);
+        },
         quiet: true,
     };
     const root = node_path_1.default.dirname((0, resolveProjectConfig_1.resolveProjectConfig)({
@@ -628,11 +562,14 @@ function runWatch(options, checkOnly) {
     let running = false;
     let rerun = false;
     let timer = null;
+    const resident = invocation.files.length === 0 ? new runBuild_1.ResidentCheckWatchSession() : undefined;
+    const pendingChanges = new PendingResidentCheckWatchChanges();
     // Tracks the most recent build's exit code so the watch session can exit
     // non-zero when its latest rebuild failed, instead of always reporting 0.
     let lastStatus = 0;
-    const runOnce = () => {
+    const runOnce = async () => {
         running = true;
+        const change = pendingChanges.take();
         let completed = false;
         try {
             if (!options.preserveWatchOutput) {
@@ -645,22 +582,38 @@ function runWatch(options, checkOnly) {
             // to invalid JSON, single-file invariant). Catch here so a throwing
             // rebuild reports a clear failure and the watcher keeps running instead
             // of crashing the process with an uncaught exception.
-            const status = invocation.files.length !== 0
-                ? runSingleFile(invocation)
-                : (() => {
-                    const result = (0, runBuild_1.runBuild)(checkOnly ? { ...invocation, emit: false } : invocation);
+            const status = await (invocation.files.length !== 0
+                ? Promise.resolve(runSingleFile(invocation))
+                : (async () => {
+                    const buildOptions = checkOnly
+                        ? { ...invocation, emit: false }
+                        : invocation;
+                    const result = resident === undefined
+                        ? (0, runBuild_1.runBuild)(buildOptions)
+                        : await resident.run(buildOptions, change);
+                    // Watch output is one ordered stream. The diagnostics a build
+                    // produced and the "[ttsc] watch build …" marker that concludes
+                    // them reach a single merged reader, and on two pipes the OS may
+                    // hand it the marker first — a reader that counts the build on the
+                    // marker then snapshots before the diagnostics land and sees an
+                    // empty build. The rebuilding banner, the screen clear, and the
+                    // marker are already on stdout, so the diagnostics join them there,
+                    // the way tsc --watch prints everything to one place.
                     if (result.stdout)
                         process.stdout.write(result.stdout);
                     if (result.stderr)
-                        process.stderr.write(result.stderr);
+                        process.stdout.write(result.stderr);
                     return result.status;
-                })();
+                })());
             lastStatus = status;
             completed = true;
             process.stdout.write(`[ttsc] ${status === 0 ? "watch build complete" : "watch build failed"}\n`);
         }
         catch (error) {
-            process.stderr.write(`${formatError(error)}\n`);
+            // Same ordered-stream rule as the build path: the failure text goes on
+            // the stream the marker below uses, so a merged reader sees them in order
+            // rather than racing two pipes.
+            process.stdout.write(`${formatError(error)}\n`);
             lastStatus = lastStatus === 0 ? 2 : lastStatus;
             process.stdout.write(`[ttsc] watch build failed\n`);
         }
@@ -684,27 +637,37 @@ function runWatch(options, checkOnly) {
             trigger();
         }
     };
-    const trigger = () => {
+    const trigger = (change, reload = false) => {
+        pendingChanges.push(change, reload);
         if (running) {
             rerun = true;
             return;
         }
         if (timer)
             clearTimeout(timer);
-        timer = setTimeout(runOnce, 60);
+        timer = setTimeout(() => void runOnce(), 60);
     };
     topology = new watchTopology_1.WatchTopology(invocation, {
         onError: (location, error) => {
             process.stderr.write(`[ttsc] watch error on ${node_path_1.default.relative(cwd, location) || "."}: ${formatError(error)}\n`);
         },
-        onInputChange: trigger,
-        onTopologyChange: trigger,
+        onInputChange: (change) => {
+            debugWatchInputs(`change ${change.kind}${change.invalidate === true ? " invalidate" : ""} ${change.path === undefined
+                ? "(unnamed)"
+                : node_path_1.default.relative(cwd, change.path)}`);
+            trigger(change);
+        },
+        onProjectInputWatchRoots: (roots) => {
+            debugWatchInputs(`roots ${JSON.stringify(roots.map((root) => node_path_1.default.relative(cwd, root) || "."))}`);
+        },
+        onTopologyChange: () => trigger(undefined, true),
     });
     topology.refresh(false);
     const close = () => {
         if (timer)
             clearTimeout(timer);
         topology?.close();
+        resident?.dispose();
     };
     process.on("SIGINT", () => {
         close();
@@ -716,7 +679,7 @@ function runWatch(options, checkOnly) {
     });
     process.stdout.write(`[ttsc] watching ${node_path_1.default.relative(cwd, root) || "."}\n`);
     try {
-        runOnce();
+        void runOnce();
     }
     catch (error) {
         // runOnce already swallows build throws, but guard against any unforeseen
@@ -729,11 +692,81 @@ function runWatch(options, checkOnly) {
     }
     return toExitCode(lastStatus);
 }
+/**
+ * Coalesces filesystem events until the next resident check-watch cycle.
+ *
+ * A full reload dominates every narrower signal. Program invalidation remains
+ * distinct so a project-input module creation/deletion can cold-load the
+ * Program without discarding the selected execution or restarting the sidecar.
+ */
+class PendingResidentCheckWatchChanges {
+    changed = new Set();
+    external = new Set();
+    invalidate = false;
+    reload = false;
+    push(change, reload = false) {
+        if (reload || change?.kind === "config" || change?.kind === "plugin") {
+            this.reload = true;
+            this.invalidate = false;
+            this.changed.clear();
+            this.external.clear();
+            return;
+        }
+        if (this.reload)
+            return;
+        if (change?.invalidate === true)
+            this.invalidate = true;
+        if (change?.path === undefined) {
+            if (change?.kind === "compiler") {
+                this.reload = true;
+                this.invalidate = false;
+                this.changed.clear();
+                this.external.clear();
+            }
+            return;
+        }
+        this.changed.add(change.path);
+        if (change.kind === "project")
+            this.external.add(change.path);
+    }
+    take() {
+        const change = {
+            ...(this.reload ? { reload: true } : {}),
+            ...(this.invalidate ? { invalidate: true } : {}),
+            ...(this.changed.size === 0 ? {} : { changed: [...this.changed].sort() }),
+            ...(this.external.size === 0
+                ? {}
+                : { external: [...this.external].sort() }),
+        };
+        this.reload = false;
+        this.invalidate = false;
+        this.changed.clear();
+        this.external.clear();
+        return change;
+    }
+}
+exports.PendingResidentCheckWatchChanges = PendingResidentCheckWatchChanges;
 // Coerces a build status into a valid process exit code: 0 stays 0, any
 // non-zero (or non-finite) status collapses to 1 so the session signals failure.
 function toExitCode(status) {
     return Number.isInteger(status) && status >= 0 && status <= 255 ? status : 1;
 }
+/**
+ * Opt-in report of what the project-input layer is watching and announcing.
+ *
+ * A watch that goes quiet is indistinguishable from a watch with nothing to
+ * say: the build simply never runs again, and the transcript that survives says
+ * only that. This separates the two — the roots line states what is covered,
+ * and a change line states what was announced — so a missing rebuild can be
+ * attributed to the watch that never saw the file or to the decision that
+ * declined to report it. Silent unless asked, and on the same ordered stream as
+ * the rest of the watch output so it interleaves with the builds it explains.
+ */
+function debugWatchInputs(message) {
+    if (!process.env.TTSC_WATCH_DEBUG_INPUTS)
+        return;
+    process.stdout.write(`[ttsc:debug] ${message}\n`);
+}
 function formatError(error) {
     if (error instanceof Error) {
         return error.message;