ttsc 0.14.1 → 0.15.0

package/lib/launcher/internal/runtimeHooks.js

@@ -0,0 +1,810 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.installRuntimeHooks = installRuntimeHooks;
+exports.entryModuleFormat = entryModuleFormat;
+const node_crypto_1 = __importDefault(require("node:crypto"));
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_module_1 = require("node:module");
+const node_os_1 = __importDefault(require("node:os"));
+const node_path_1 = __importDefault(require("node:path"));
+const node_url_1 = require("node:url");
+const readProjectConfig_1 = require("../../compiler/internal/project/readProjectConfig");
+const resolveEmittedJavaScript_1 = require("../../compiler/internal/resolveEmittedJavaScript");
+const resolveTsgo_1 = require("../../compiler/internal/resolveTsgo");
+const runBuild_1 = require("../../compiler/internal/runBuild");
+const spawnNative_1 = require("../../compiler/internal/spawnNative");
+/**
+ * Synchronous Node module hooks installed (via `module.registerHooks`) in the
+ * child process `ttsx` spawns to run a TypeScript entry _from source_.
+ *
+ * They give the runner ts-node-style whole-graph reach without weakening the
+ * compile gate. The owning entry project is type-checked and built up front (by
+ * `prepareExecution`, with its transform plugins such as typia); these hooks
+ * serve that build under the source URLs so `__dirname`/`import.meta.url` keep
+ * pointing at the source tree. Three load paths:
+ *
+ * 1. A `.ts` belonging to the entry project → serve the pre-built emitted JS
+ *    (transform plugins already applied), mapped by the project's `rootDir`.
+ * 2. Any other raw `.ts` dependency (a published or workspace package that ships
+ *    source) → build its own owning `tsconfig.json` once via `runBuild` and
+ *    serve the emit. A real build (not a type-strip) is required because Node's
+ *    type-stripping cannot do cross-file type-only elision — e.g. a
+ *    value-shaped import of a type+namespace merge survives stripping and
+ *    dangles at runtime.
+ * 3. No owning tsconfig → transform the lone file by the format it resolves to: a
+ *    CommonJS-classified file (`.cts`, or a `.ts` in a package without `type:
+ *    "module"`) is lowered to CommonJS through a tsgo single-file emit so its
+ *    `export` syntax becomes `module.exports`; any other (ESM) file keeps the
+ *    fast in-process `mode: "transform"` type-strip.
+ *
+ * The hooks are synchronous and run on the main thread (not a loader worker):
+ * that is what lets a CommonJS `require("./x")` chain reach them and what makes
+ * `require.resolve(..., { paths })` inside `runBuild`'s plugin loader behave.
+ */
+/** Source/JS extensions probed when an extensionless relative import fails. */
+const RESOLVABLE_EXTENSIONS = [
+    ".ts",
+    ".tsx",
+    ".mts",
+    ".cts",
+    ".js",
+    ".mjs",
+    ".cjs",
+];
+/** TypeScript source extensions these hooks compile. */
+const TYPESCRIPT_EXTENSIONS = [".ts", ".tsx", ".mts", ".cts"];
+let manifestCache;
+function manifest() {
+    if (manifestCache !== undefined) {
+        return manifestCache;
+    }
+    const file = process.env.TTSX_RUNTIME_MANIFEST;
+    if (file === undefined || file.length === 0) {
+        manifestCache = null;
+        return manifestCache;
+    }
+    try {
+        manifestCache = JSON.parse(node_fs_1.default.readFileSync(file, "utf8"));
+    }
+    catch {
+        manifestCache = null;
+    }
+    return manifestCache;
+}
+let installed = false;
+/**
+ * Install the source-loading hooks on the current (main) thread. Idempotent:
+ * the bootstrap installs them for the entry process, and `NODE_OPTIONS`
+ * re-imports the installer in every child process the program spawns — both may
+ * run in the same process.
+ *
+ * Two hooks are needed, because `module.registerHooks` does not intercept a
+ * `require()` made from inside a CommonJS module that was itself reached
+ * through an ESM `import` (the interop translator loads it on the raw CJS
+ * path). The ESM graph goes through `registerHooks`; the CommonJS `require`
+ * graph goes through `Module._extensions` — the canonical loader extension
+ * point `ts-node`/`tsx` use for the same reason.
+ */
+function installRuntimeHooks() {
+    if (installed) {
+        return;
+    }
+    installed = true;
+    (0, node_module_1.registerHooks)({ load, resolve });
+    installCommonJsHook();
+}
+/**
+ * Register a CommonJS `require` handler for each TypeScript source extension so
+ * a `require("./x")` chain compiles `.ts` the same way the ESM `load` hook
+ * does.
+ */
+function installCommonJsHook() {
+    const extensions = node_module_1.Module._extensions;
+    const compile = (module, filename) => {
+        module._compile(resolveServedSource(filename).source, filename);
+    };
+    for (const extension of [".ts", ".tsx", ".cts"]) {
+        extensions[extension] = compile;
+    }
+}
+/**
+ * The module format of the entry source file, derived from the entry project's
+ * `module` option (via the runtime manifest) the same way the served files are
+ * classified. The bootstrap uses it to load the entry through a CommonJS
+ * `require` or an ESM `import`.
+ */
+function entryModuleFormat(entryFile) {
+    return moduleFormat(entryFile, manifest()?.moduleOption) === "module"
+        ? "module"
+        : "commonjs";
+}
+/**
+ * Rescue an extensionless or directory relative specifier that Node's resolver
+ * rejected. Only runs after `nextResolve` throws, so a successful resolution is
+ * never perturbed; a genuinely missing module finds no candidate and the
+ * original error is rethrown, preserving `ERR_MODULE_NOT_FOUND`.
+ */
+function resolve(specifier, context, nextResolve) {
+    try {
+        return nextResolve(specifier, context);
+    }
+    catch (error) {
+        const rescued = probeRescuableSpecifier(specifier, context.parentURL);
+        if (rescued === null) {
+            throw error;
+        }
+        return { shortCircuit: true, url: rescued };
+    }
+}
+const builtProjects = new Map();
+function load(url, context, nextLoad) {
+    if (!url.startsWith("file:")) {
+        return nextLoad(url, context);
+    }
+    const filename = (0, node_url_1.fileURLToPath)(url);
+    if (!isTypeScriptSource(filename)) {
+        return nextLoad(url, context);
+    }
+    const { source, moduleOption } = resolveServedSource(filename, url);
+    return {
+        format: moduleFormat(filename, moduleOption),
+        shortCircuit: true,
+        source,
+    };
+}
+/**
+ * Resolve the JavaScript to run for a TypeScript source file, in priority
+ * order: the entry project's pre-built emit (transform plugins applied), a
+ * built raw `.ts` dependency, or — when no tsconfig owns it — a `mode:
+ * "transform"` type-strip. Shared by the ESM `load` hook and the CommonJS
+ * `require` handler.
+ */
+function resolveServedSource(filename, url = (0, node_url_1.pathToFileURL)(filename).href) {
+    const real = realPath(filename);
+    const served = serveEntryEmit(real);
+    if (served !== null) {
+        return { moduleOption: manifest()?.moduleOption, source: served };
+    }
+    const built = serveDependencyEmit(real);
+    if (built !== null) {
+        return built;
+    }
+    return {
+        moduleOption: undefined,
+        source: transformOrphanSource(filename, url),
+    };
+}
+/**
+ * Transform a TypeScript source file that no tsconfig owns (a published or
+ * vendored package that ships raw `.ts`/`.cts`/`.mts` straight under
+ * `node_modules`), choosing the lowering by the format the file resolves to.
+ *
+ * Node's in-process `stripTypeScriptTypes` only erases type syntax; it never
+ * rewrites ECMAScript `import`/`export` into CommonJS. That is correct for a
+ * file Node will load as ESM, but wrong for one classified CommonJS — a `.cts`,
+ * or a `.ts` in a package without `type: "module"` — when the author wrote it
+ * with module syntax (`export const`, `export namespace`, `export function`).
+ * Stripping leaves the `export` in place and Node's CommonJS loader dies with
+ * `SyntaxError: Unexpected token 'export'`. So a CommonJS-format orphan is
+ * lowered through a real tsgo `--module commonjs` single-file emit (which also
+ * handles `export =`), exactly the format decision tsgo would have made for an
+ * owning project; an ESM-format orphan keeps the fast in-process strip.
+ */
+function transformOrphanSource(filename, url) {
+    if (moduleFormat(filename, undefined) === "commonjs") {
+        const lowered = emitOrphanAsCommonJs(filename);
+        if (lowered !== null) {
+            return lowered;
+        }
+    }
+    return (0, node_module_1.stripTypeScriptTypes)(node_fs_1.default.readFileSync(filename, "utf8"), {
+        mode: "transform",
+        sourceUrl: url,
+    });
+}
+/**
+ * Lower a single CommonJS-format source file to CommonJS JavaScript by running
+ * tsgo on the lone file with `--module commonjs`. Emit-only, no diagnostic gate
+ * (the entry project's up-front check is the type gate), matching
+ * `buildDependency`. Returns `null` when tsgo is unavailable or produced no
+ * output, so the caller can fall back to the in-process strip.
+ */
+function emitOrphanAsCommonJs(filename) {
+    let tsgo;
+    try {
+        tsgo = (0, resolveTsgo_1.resolveTsgo)({ cwd: node_path_1.default.dirname(filename) }).binary;
+    }
+    catch {
+        return null;
+    }
+    // Content-hash cache: a CJS-format orphan ('s tsgo single-file emit) is lowered
+    // once and reused by every other process in the run, and across runs. Without
+    // it a program that fans out into many processes (the automated test corpus
+    // imports the same vendored `.ts` deps from thousands of generated files) would
+    // re-spawn tsgo per file per process and crawl.
+    const cacheFile = orphanCacheFile(filename, tsgo);
+    if (cacheFile !== null) {
+        const hit = readFileOrNull(cacheFile);
+        if (hit !== null) {
+            return hit;
+        }
+    }
+    const outDir = node_fs_1.default.mkdtempSync(node_path_1.default.join(node_os_1.default.tmpdir(), "ttsx-orphan-"));
+    try {
+        const res = (0, spawnNative_1.spawnNative)(tsgo, [
+            filename,
+            // The file is named on the command line, so any tsconfig tsgo would
+            // discover by walking up (the consumer's own) must be ignored — both
+            // because it is not this file's project and because tsgo errors out
+            // ("tsconfig.json is present but will not be loaded") otherwise.
+            "--ignoreConfig",
+            "--module",
+            "commonjs",
+            "--target",
+            "es2022",
+            // This is an emit-only lowering: the entry project's up-front build is
+            // the type gate, so the single-file pass does not need to type-check.
+            // Skipping the check (and the lib check it implies) cuts the per-file
+            // cost several-fold, which matters when a program generates and imports
+            // thousands of raw `.ts` files at runtime (a fanned-out test corpus) and
+            // each one would otherwise pay a full single-file check.
+            "--noCheck",
+            "--skipLibCheck",
+            "--outDir",
+            outDir,
+            "--listEmittedFiles",
+        ], { cwd: node_path_1.default.dirname(filename), encoding: "utf8" });
+        const emitted = parseFirstEmittedFile((0, spawnNative_1.outputText)(res.stdout));
+        const lowered = emitted === null ? null : readFileOrNull(emitted);
+        if (lowered !== null && cacheFile !== null) {
+            writeOrphanCache(cacheFile, lowered);
+        }
+        return lowered;
+    }
+    catch {
+        return null;
+    }
+    finally {
+        node_fs_1.default.rmSync(outDir, { force: true, recursive: true });
+    }
+}
+/** Cache root for lowered orphan sources, shared per run (and across runs when
+ * `TTSC_CACHE_DIR` points at a persisted directory). */
+function orphanCacheRoot() {
+    const base = process.env.TTSC_CACHE_DIR && process.env.TTSC_CACHE_DIR.length !== 0
+        ? process.env.TTSC_CACHE_DIR
+        : node_path_1.default.join(node_os_1.default.tmpdir(), "ttsc-orphan");
+    return node_path_1.default.join(base, "ttsx-orphan-cjs");
+}
+/** Content-addressed cache path for one orphan file's CommonJS lowering, keyed
+ * by source bytes and the tsgo binary so a tsgo bump invalidates it. `null` when
+ * the source cannot be read. */
+function orphanCacheFile(filename, tsgo) {
+    let source;
+    try {
+        source = node_fs_1.default.readFileSync(filename);
+    }
+    catch {
+        return null;
+    }
+    const key = node_crypto_1.default
+        .createHash("sha256")
+        .update(tsgo)
+        .update("\0")
+        .update(source)
+        .digest("hex")
+        .slice(0, 32);
+    return node_path_1.default.join(orphanCacheRoot(), `${key}.js`);
+}
+/** Write the lowered source to its cache path atomically (temp + rename), so a
+ * concurrent reader never sees a half-written file. Best-effort: a failure just
+ * means the next process re-lowers. */
+function writeOrphanCache(cacheFile, lowered) {
+    try {
+        node_fs_1.default.mkdirSync(node_path_1.default.dirname(cacheFile), { recursive: true });
+        const tmp = `${cacheFile}.${process.pid}.${Date.now()}.tmp`;
+        node_fs_1.default.writeFileSync(tmp, lowered);
+        node_fs_1.default.renameSync(tmp, cacheFile);
+    }
+    catch {
+        // ignore — caching is an optimization, correctness does not depend on it
+    }
+}
+/** First `TSFILE:` path tsgo printed under `--listEmittedFiles`, or `null`. */
+function parseFirstEmittedFile(stdout) {
+    for (const line of stdout.split(/\r?\n/)) {
+        const match = line.match(/^TSFILE:\s*(.+)$/);
+        if (match?.[1]) {
+            return match[1].trim();
+        }
+    }
+    return null;
+}
+/**
+ * Serve the entry project's pre-built JavaScript for a source file the build
+ * emitted, or `null` when the file is outside the build or its emit is
+ * missing.
+ *
+ * The bound is the project's `rootDir` (the source root the emit mirrors), not
+ * its tsconfig directory: a project can pull in a file from elsewhere via
+ * `files` with a wider `rootDir` (e.g. the lint config loader compiles a
+ * `*.config.ts` from any directory under `rootDir: "/"`). Anything outside
+ * `rootDir` cannot have a mirrored emit, so it falls through to the dependency
+ * paths.
+ */
+function serveEntryEmit(real) {
+    const m = manifest();
+    if (m === null) {
+        return null;
+    }
+    if (!isWithin(real, m.rootDir)) {
+        return null;
+    }
+    const emitted = (0, resolveEmittedJavaScript_1.resolveEmittedJavaScript)({
+        emittedFiles: m.emittedFiles,
+        outDir: m.emitDir,
+        projectRoot: m.rootDir,
+        sourceFile: real,
+    });
+    return readFileOrNull(emitted);
+}
+/**
+ * True when `real` is `directory` itself or sits beneath it. Handles a root
+ * `directory` (`/`, `C:\`): naively appending a separator would yield `//`,
+ * which no path starts with, so a `rootDir: "/"` project would serve nothing.
+ */
+function isWithin(real, directory) {
+    if (real === directory) {
+        return true;
+    }
+    const prefix = directory.endsWith(node_path_1.default.sep)
+        ? directory
+        : directory + node_path_1.default.sep;
+    return real.startsWith(prefix);
+}
+/**
+ * Build the project that owns `real` (nearest `tsconfig.json` above its real
+ * path) and return its emitted JavaScript, or `null` when no tsconfig owns it
+ * or the project does not emit it. The build honours the dependency's own
+ * tsconfig (transform plugins included), so a source-shipping package that
+ * needs a transform behaves correctly at runtime.
+ */
+function serveDependencyEmit(real) {
+    const tsconfig = nearestTsconfig(real);
+    if (tsconfig === null) {
+        return null;
+    }
+    let built;
+    try {
+        built = ensureProjectBuilt(tsconfig);
+    }
+    catch {
+        // The owning project produced no emit at all; fall back to type-stripping
+        // this single file rather than failing the whole run.
+        return null;
+    }
+    const emitted = (0, resolveEmittedJavaScript_1.resolveEmittedJavaScript)({
+        emittedFiles: built.emittedFiles,
+        outDir: built.emitDir,
+        projectRoot: built.rootDir,
+        sourceFile: real,
+    });
+    const source = readFileOrNull(emitted);
+    return source === null ? null : { moduleOption: built.moduleOption, source };
+}
+/**
+ * Build the project that owns a dependency once per run and share the result
+ * across every process the program spawns.
+ *
+ * A program (a benchmark, a worker pool) can fan out into many child processes,
+ * each of which inherits the runtime manifest and would otherwise rebuild every
+ * dependency from scratch — and worse, several at once into the same directory,
+ * corrupting each other. So the build output is content-keyed under the shared
+ * per-run cache: a finished build leaves a meta marker that any later process
+ * (or a second import in this one) reuses, and concurrent first-builders are
+ * serialised by an atomic lock directory.
+ */
+function ensureProjectBuilt(tsconfig) {
+    const cached = builtProjects.get(tsconfig);
+    if (cached !== undefined) {
+        return cached;
+    }
+    const key = node_crypto_1.default
+        .createHash("sha256")
+        .update(tsconfig)
+        .digest("hex")
+        .slice(0, 16);
+    const root = dependencyCacheRoot();
+    const emitDir = node_path_1.default.join(root, key);
+    const metaPath = node_path_1.default.join(root, `${key}.json`);
+    const lockDir = node_path_1.default.join(root, `${key}.lock`);
+    const reuse = readDependencyCache(emitDir, metaPath);
+    if (reuse !== null) {
+        builtProjects.set(tsconfig, reuse);
+        return reuse;
+    }
+    node_fs_1.default.mkdirSync(root, { recursive: true });
+    const built = withBuildLock(lockDir, metaPath, emitDir, () => buildDependency(tsconfig, emitDir, metaPath));
+    builtProjects.set(tsconfig, built);
+    return built;
+}
+/** Reuse a dependency another process (or an earlier import) already built. */
+function readDependencyCache(emitDir, metaPath) {
+    let meta;
+    try {
+        meta = JSON.parse(node_fs_1.default.readFileSync(metaPath, "utf8"));
+    }
+    catch {
+        return null;
+    }
+    if (!emittedAnything(emitDir)) {
+        return null;
+    }
+    return {
+        emitDir,
+        emittedFiles: undefined,
+        moduleOption: meta.moduleOption,
+        rootDir: meta.rootDir,
+    };
+}
+/**
+ * Run `build` while holding an exclusive lock for this dependency, re-checking
+ * the cache once the lock is held (a concurrent builder may have just
+ * finished). A waiter polls for the winner's meta marker, and steals an
+ * abandoned lock (a builder that crashed) after a generous timeout so the run
+ * never wedges.
+ */
+function withBuildLock(lockDir, metaPath, emitDir, build) {
+    const stealAfterMs = 600_000;
+    for (;;) {
+        try {
+            node_fs_1.default.mkdirSync(lockDir);
+        }
+        catch {
+            const waited = waitForDependencyCache(emitDir, metaPath, stealAfterMs);
+            if (waited !== null) {
+                return waited;
+            }
+            node_fs_1.default.rmSync(lockDir, { force: true, recursive: true });
+            continue;
+        }
+        try {
+            const reuse = readDependencyCache(emitDir, metaPath);
+            return reuse ?? build();
+        }
+        finally {
+            node_fs_1.default.rmSync(lockDir, { force: true, recursive: true });
+        }
+    }
+}
+/** Poll for a concurrent builder's completion, up to `timeoutMs`. */
+function waitForDependencyCache(emitDir, metaPath, timeoutMs) {
+    const startedAt = Date.now();
+    for (;;) {
+        const reuse = readDependencyCache(emitDir, metaPath);
+        if (reuse !== null) {
+            return reuse;
+        }
+        if (Date.now() - startedAt > timeoutMs) {
+            return null;
+        }
+        sleepSync(50);
+    }
+}
+/** Block the current (synchronous) thread for `ms` without busy-spinning. */
+function sleepSync(ms) {
+    Atomics.wait(new Int32Array(new SharedArrayBuffer(4)), 0, 0, ms);
+}
+/** Compile a dependency project to `emitDir` and write its completion marker. */
+function buildDependency(tsconfig, emitDir, metaPath) {
+    const project = (0, readProjectConfig_1.readProjectConfig)({ cwd: node_path_1.default.dirname(tsconfig), tsconfig });
+    node_fs_1.default.rmSync(emitDir, { force: true, recursive: true });
+    const result = (0, runBuild_1.runBuild)({
+        cwd: project.root,
+        emit: true,
+        forceListEmittedFiles: true,
+        outDir: emitDir,
+        // Honour the dependency's own transform plugins: a source-shipping package
+        // can itself depend on a transform (e.g. a fixture whose values are built
+        // with `typia.createRandom`), and its runtime behaviour is wrong without it.
+        // `runBuild` runs on this main thread, so its plugin resolution works the
+        // same as the entry build's.
+        quiet: true,
+        // Emit only: the entry project's up-front check is the type gate. A
+        // dependency build pulls its own transitive sources into the program and
+        // would otherwise fail on type diagnostics that belong to those packages
+        // under their own (laxer) config — e.g. unused-type-parameter warnings in a
+        // transitively imported library. We still want the type-aware emit (for
+        // type-only elision), just not the error gate.
+        skipDiagnosticsCheck: true,
+        tsconfig,
+    });
+    // Success is "the project wrote JavaScript", not "the build reported a file
+    // list": a native transform host (typia, @ttsc/banner, …) emits without
+    // printing the `--listEmittedFiles` lines, so `result.emittedFiles` is empty
+    // even on a clean build. A genuinely empty output directory is the real
+    // failure; the caller then falls back to type-stripping the one file.
+    if (!emittedAnything(emitDir)) {
+        throw new Error([
+            `ttsx: dependency build produced no output for ${tsconfig}`,
+            result.stderr || result.stdout,
+        ]
+            .filter((line) => line.trim().length !== 0)
+            .join("\n"));
+    }
+    const rootDir = typeof project.compilerOptions.rootDir === "string"
+        ? project.compilerOptions.rootDir
+        : project.root;
+    const moduleOption = typeof project.compilerOptions.module === "string"
+        ? project.compilerOptions.module
+        : undefined;
+    node_fs_1.default.writeFileSync(metaPath, JSON.stringify({ moduleOption, rootDir }), "utf8");
+    return { emitDir, emittedFiles: undefined, moduleOption, rootDir };
+}
+function dependencyCacheRoot() {
+    const m = manifest();
+    return m !== null && m.depCacheDir.length !== 0
+        ? m.depCacheDir
+        : node_path_1.default.join(node_os_1.default.tmpdir(), "ttsx-dep");
+}
+/** Owning-tsconfig cache keyed by directory, mirroring `packageTypeCache`. */
+const tsconfigCache = new Map();
+/**
+ * The nearest `tsconfig.json` at or above `file`'s directory, or `null`. The
+ * walk stops at a `node_modules` boundary: a tsconfig above `node_modules`
+ * belongs to the consumer, not to the published dependency inside it, so a
+ * dependency that ships no tsconfig of its own has no owning project and is
+ * type-stripped instead. A pnpm-symlinked workspace package is unaffected
+ * because `file` is already its real path (outside `node_modules`).
+ *
+ * The walk is memoised per directory (the whole walked chain shares one
+ * answer), so the thousands of files a fanned-out test corpus imports from the
+ * same handful of projects do not each re-stat the same parent directories.
+ */
+function nearestTsconfig(file) {
+    let directory = node_path_1.default.dirname(file);
+    const chain = [];
+    for (;;) {
+        const cached = tsconfigCache.get(directory);
+        if (cached !== undefined) {
+            return rememberTsconfig(chain, cached);
+        }
+        if (node_path_1.default.basename(directory) === "node_modules") {
+            return rememberTsconfig(chain, null);
+        }
+        chain.push(directory);
+        const candidate = node_path_1.default.join(directory, "tsconfig.json");
+        if (isFile(candidate)) {
+            return rememberTsconfig(chain, candidate);
+        }
+        const parent = node_path_1.default.dirname(directory);
+        if (parent === directory) {
+            return rememberTsconfig(chain, null);
+        }
+        directory = parent;
+    }
+}
+function rememberTsconfig(directories, result) {
+    for (const directory of directories) {
+        tsconfigCache.set(directory, result);
+    }
+    return result;
+}
+function readFileOrNull(file) {
+    if (file === null) {
+        return null;
+    }
+    try {
+        return node_fs_1.default.readFileSync(file, "utf8");
+    }
+    catch {
+        return null;
+    }
+}
+function realPath(target) {
+    try {
+        return node_fs_1.default.realpathSync(target);
+    }
+    catch {
+        return target;
+    }
+}
+/**
+ * Map the JavaScript extension a relative `specifier` carries to the TypeScript
+ * source extensions tsgo would have emitted it from. Running from source, a
+ * `"./x.js"` import (whether authored or rewritten from `"./x.ts"` by
+ * `--rewriteRelativeImportExtensions`) has no `.js` on disk — only `./x.ts`.
+ */
+const JS_TO_TS_EXTENSIONS = new Map([
+    [".js", [".ts", ".tsx"]],
+    [".jsx", [".tsx"]],
+    [".mjs", [".mts"]],
+    [".cjs", [".cts"]],
+]);
+/**
+ * Rescue a `specifier` that Node's resolver rejected: map a JavaScript
+ * extension back to its TypeScript source, or probe candidate extensions /
+ * directory indexes for an extensionless form. Returns a `file:` URL for the
+ * first match, or `null` when nothing matches.
+ *
+ * Handles two shapes:
+ *
+ * - A relative specifier (`./x`) resolved against a `file:` parent — a normal
+ *   `import`/`require` inside a served module;
+ * - An already-absolute specifier with no parent — the main entry of a
+ *   `child_process.fork(__dirname + "/servant.js")`. fork's main module reaches
+ *   the resolve hook as an absolute `.js` path with `parentURL` undefined, and
+ *   run-from-source ships only the `.ts`, so without this the child dies with
+ *   `Cannot find module servant.js` and a tgrid master waits on it forever.
+ */
+function probeRescuableSpecifier(specifier, parentURL) {
+    // A `?query` / `#hash` suffix is part of module identity, not the path; strip
+    // it before resolving and re-attach it to the resolved URL so a loader keying
+    // on the suffix (and `import.meta.url`) sees it preserved.
+    const suffixStart = specifier.search(/[?#]/);
+    const suffix = suffixStart === -1 ? "" : specifier.slice(suffixStart);
+    const pathname = suffixStart === -1 ? specifier : specifier.slice(0, suffixStart);
+    let base;
+    if (isRelativeSpecifier(specifier)) {
+        if (parentURL === undefined || !parentURL.startsWith("file:")) {
+            return null;
+        }
+        const parentDir = node_path_1.default.dirname((0, node_url_1.fileURLToPath)(parentURL));
+        base = node_path_1.default.resolve(parentDir, pathname);
+    }
+    else if (node_path_1.default.isAbsolute(pathname)) {
+        base = pathname;
+    }
+    else {
+        return null;
+    }
+    const withSuffix = (candidate) => (0, node_url_1.pathToFileURL)(candidate).href + suffix;
+    const jsExtension = node_path_1.default.extname(base).toLowerCase();
+    const tsExtensions = JS_TO_TS_EXTENSIONS.get(jsExtension);
+    if (tsExtensions !== undefined) {
+        const stem = base.slice(0, base.length - jsExtension.length);
+        for (const extension of tsExtensions) {
+            const candidate = stem + extension;
+            if (isFile(candidate)) {
+                return withSuffix(candidate);
+            }
+        }
+        return null;
+    }
+    if (hasConcreteExtension(pathname)) {
+        return null;
+    }
+    for (const extension of RESOLVABLE_EXTENSIONS) {
+        const candidate = base + extension;
+        if (isFile(candidate)) {
+            return withSuffix(candidate);
+        }
+    }
+    for (const extension of RESOLVABLE_EXTENSIONS) {
+        const candidate = node_path_1.default.join(base, `index${extension}`);
+        if (isFile(candidate)) {
+            return withSuffix(candidate);
+        }
+    }
+    return null;
+}
+/**
+ * Decide the module format the way Node and tsgo do — from configuration, never
+ * by sniffing the emitted text. The file extension is authoritative
+ * (`.mts`/`.mjs` → module, `.cts`/`.cjs` → commonjs); otherwise the owning
+ * tsconfig's `module` option decides: a fixed CommonJS / ES target maps
+ * directly, while the `node*`/`preserve` family (and a file with no owning
+ * tsconfig) defers to the nearest `package.json` `type`, exactly as tsgo chose
+ * when it emitted.
+ */
+function moduleFormat(filename, moduleOption) {
+    if (filename.endsWith(".mts") || filename.endsWith(".mjs")) {
+        return "module";
+    }
+    if (filename.endsWith(".cts") || filename.endsWith(".cjs")) {
+        return "commonjs";
+    }
+    const option = (moduleOption ?? "").toLowerCase();
+    if (option === "commonjs" || option === "node10" || option === "none") {
+        return "commonjs";
+    }
+    if (option === "" ||
+        option === "node16" ||
+        option === "node18" ||
+        option === "nodenext" ||
+        option === "preserve") {
+        return nearestPackageType(filename);
+    }
+    // Every remaining `module` target (es2015 … esnext, system, amd, umd) emits
+    // ECMAScript modules.
+    return "module";
+}
+/** Package-type cache keyed by directory, mirroring Node's own lookup walk. */
+const packageTypeCache = new Map();
+function nearestPackageType(filename) {
+    let directory = node_path_1.default.dirname(filename);
+    const chain = [];
+    while (true) {
+        const cached = packageTypeCache.get(directory);
+        if (cached !== undefined) {
+            return rememberPackageType(chain, cached);
+        }
+        chain.push(directory);
+        const type = readPackageType(directory);
+        if (type !== null) {
+            return rememberPackageType(chain, type);
+        }
+        const parent = node_path_1.default.dirname(directory);
+        if (parent === directory) {
+            return rememberPackageType(chain, "commonjs");
+        }
+        directory = parent;
+    }
+}
+function rememberPackageType(directories, type) {
+    for (const directory of directories) {
+        packageTypeCache.set(directory, type);
+    }
+    return type;
+}
+/** Read a directory's `package.json` `type`, or `null` when absent/invalid. */
+function readPackageType(directory) {
+    const manifestPath = node_path_1.default.join(directory, "package.json");
+    if (!isFile(manifestPath)) {
+        return null;
+    }
+    try {
+        const parsed = JSON.parse(node_fs_1.default.readFileSync(manifestPath, "utf8"));
+        return parsed.type === "module" ? "module" : "commonjs";
+    }
+    catch {
+        return "commonjs";
+    }
+}
+function isRelativeSpecifier(specifier) {
+    return (specifier === "." ||
+        specifier === ".." ||
+        specifier.startsWith("./") ||
+        specifier.startsWith("../"));
+}
+/** True when `specifier` already carries an extension Node can load directly. */
+function hasConcreteExtension(specifier) {
+    return /\.(?:[cm]?jsx?|json|node|[cm]?tsx?)$/i.test(specifier);
+}
+function isTypeScriptSource(filename) {
+    return TYPESCRIPT_EXTENSIONS.some((extension) => filename.endsWith(extension));
+}
+function isFile(candidate) {
+    try {
+        return node_fs_1.default.statSync(candidate).isFile();
+    }
+    catch {
+        return false;
+    }
+}
+/** True when `directory` holds at least one emitted JavaScript file (any depth). */
+function emittedAnything(directory) {
+    let entries;
+    try {
+        entries = node_fs_1.default.readdirSync(directory, { withFileTypes: true });
+    }
+    catch {
+        return false;
+    }
+    for (const entry of entries) {
+        const full = node_path_1.default.join(directory, entry.name);
+        if (entry.isDirectory()) {
+            if (emittedAnything(full)) {
+                return true;
+            }
+        }
+        else if (entry.isFile() && /\.(?:[cm]?js)$/i.test(entry.name)) {
+            return true;
+        }
+    }
+    return false;
+}
+//# sourceMappingURL=runtimeHooks.js.map