ttsc 0.30.4 → 0.31.0

package/lib/launcher/internal/buildSingleRootProject.js

@@ -0,0 +1,229 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildSingleRootProject = buildSingleRootProject;
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_path_1 = __importDefault(require("node:path"));
+const runBuild_1 = require("../../compiler/internal/build/runBuild");
+const readProjectConfig_1 = require("../../compiler/internal/project/readProjectConfig");
+const readEffectiveCompilerOptions_1 = require("../../compiler/internal/readEffectiveCompilerOptions");
+const createFilesystemPathIdentityContext_1 = require("../../internal/pathIdentity/createFilesystemPathIdentityContext");
+const DependencyBuildGeneration_1 = require("./runtime/DependencyBuildGeneration");
+const runtimeCompilerArgs_1 = require("./runtimeCompilerArgs");
+const runtimeEmitProfile_1 = require("./runtimeEmitProfile");
+const singleRootProjectConfig_1 = require("./singleRootProjectConfig");
+/**
+ * Compile one TypeScript root that its owning project's file set does not
+ * contain, with every compiler option of that project.
+ *
+ * `ttsc` selects a _file set_: a project whose `include` is `src` must emit
+ * only `src` into `outDir`, and a `clear.ts`, a `build/release.ts`, or a
+ * `lint.config.ts` beside the tsconfig has no business in `lib`. `ttsx` needs
+ * that project's compiler options for a file it runs, not its file list. Those
+ * two requirements are not in conflict, but the whole-project build cannot
+ * satisfy the second, so such a root is compiled here through a project that
+ * inherits every option and declares only the root. Two lanes need it: the
+ * launcher's entry when the project build did not emit it, and a TypeScript
+ * file the running program reaches that no build compiled.
+ *
+ * Where the synthesized tsconfig lives depends on what the build reads from its
+ * location. `extends` with an absolute path resolves from anywhere, and every
+ * relative option resolves against the config that declares it, but
+ * `${configDir}` is substituted with the directory of the config tsgo was
+ * given, and the default `typeRoots` and each `types` entry are looked up from
+ * there. A checked build needs all of them exactly as the user's config sees
+ * them, so its tsconfig is written beside the real one, and a directory that
+ * refuses the write is reported by name. TypeScript-Go's command line cannot
+ * combine a project with a file list, and ttsc ships no host that replaces a
+ * project's roots in memory, so no other placement is faithful. An emit-only
+ * build ignores diagnostics, and none of those lookups changes what it emits,
+ * with one exception: `${configDir}` inside `paths` or `baseUrl` decides which
+ * module an import resolves to, and so whether a re-exported name is elided as
+ * a type. Unless its config chain uses `${configDir}`, an emit-only build's
+ * tsconfig is written beside `emitDir` instead, because such a build runs while
+ * the program is running, for an installed package whose directory may be
+ * read-only or for a plugin descriptor whose inputs are fingerprinted by their
+ * directory's metadata, and a file created and removed in the user's tree would
+ * disturb both. The overlay is created exclusively: an occupied name is refused
+ * without writing or removing that entry. After acquisition, closing its
+ * descriptor and removing the overlay are attempted on success or failure;
+ * native cleanup failures may leave the overlay behind.
+ *
+ * `rootDir` is the root of the source's volume. The layout of this emit is
+ * private, so `rootDir` decides nothing here but whether a file of the program
+ * fits under it, and every narrower choice fails some program: the inherited
+ * `rootDir` (`src`) does not contain the root, and a root that imports a
+ * sibling package's source reaches outside any ancestor it shares with the
+ * project. A file outside `rootDir` is TS6059 in a checked build and, in an
+ * emit-only one, an output written beside the user's `.ts`. The caller finds
+ * the output through `EmitOwnershipIndex` against the returned `rootDir`, so
+ * the width costs nothing in precision. A `--rootDir` forwarded on the command
+ * line still wins, as it does in every build, and the returned `rootDir` is
+ * then that one.
+ *
+ * `composite` is switched off. It exists for `tsc -b`, whose project graph
+ * needs every file listed, and inherited here it would reject each import of
+ * the root with TS6307, since only the root is listed. Declarations go with it:
+ * nothing at run time reads them, and an inherited `declarationMap` would
+ * otherwise fail with TS5069 once `composite` no longer implies `declaration`.
+ * An emit-only build also switches `noEmitOnError` off, since it fails only on
+ * an empty output and an inherited `noEmitOnError` would turn any diagnostic
+ * into one.
+ *
+ * @returns The project, effective `rootDir` and compiler-owned source
+ *   provenance for actual written outputs. Missing provenance is not
+ *   synthesized from maps.
+ * @throws When the build fails. A checked build fails on any diagnostic; an
+ *   emit-only build fails only when it produced no JavaScript at all.
+ * @evidence contracts/common.md#principled-implementation A transient extends overlay changes only roots and runtime output constraints, while preserving configDir-sensitive anchors; effective rootDir is returned for output ownership rather than inferred from emitted filenames.
+ * @evidence contracts/common.md#clear-and-simple-design This boundary owns single-root overlay construction and cleanup, delegates project parsing/building, and isolates writable-directory diagnostics in a private helper.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts Private emit layout, disabled declaration/composite products and checked versus installed-package diagnostics are runtime contract distinctions, not source patches or tests-only compiler modes.
+ * @evidence contracts/common.md#meaningful-documentation Native paragraphs explain overlay placement, wide rootDir, diagnostics and cleanup, while separately documented input members preserve their ownership facts.
+ * @evidence contracts/portability.md#os-neutral-implementation Shared filesystem identity selects the source volume from resolved native identity when available and retained spelling otherwise; overlay JSON converts only native separators, preserving literal POSIX backslashes. Public exclusive creation refuses an occupied overlay name without overwriting it; explicit compiler paths avoid shell interpolation and blanket case folding.
+ * @evidence contracts/performance.md#efficient-algorithms Emit-only placement parses the config chain and scans its text for configDir anchors; checked placement skips that scan. Native identity resolution, overlay serialization/write, effective-options preparation and delegated compilation contribute path/input/output byte costs; this boundary performs no source-directory mirror or second whole-project compilation.
+ * @evidence contracts/performance.md#reuse-equivalent-work One effective-options reader for this overlay and exact forwarded tokens is shared by runtime lowering, emit classification and rootDir selection, avoiding duplicate response-file compiler queries. Callers own sharing of completed build generations.
+ * @evidence contracts/performance.md#bound-retention-and-release-resources Exclusive open establishes ownership of one transient tsconfig and descriptor. The descriptor is closed before parsing; finally attempts any remaining close and removal after write, close, parse or build failure, without removing a failed-acquisition entry. Native cleanup failures may retain the overlay; caller owns emit storage and delegated build lifetimes.
+ */
+function buildSingleRootProject(props) {
+    const options = props.options ?? {};
+    // `source` already carries the one spelling the runtime decided on. tsgo
+    // compares it against `rootDir` textually — `GetCommonSourceDirectory` takes
+    // `rootDir` verbatim and `ContainsPath` is lexical — so a mismatch here is
+    // not a near miss: the file counts as outside `rootDir`, and tsgo emits it to
+    // its own source path with the extension changed instead of under `outDir`,
+    // writing a `.js` and its map beside the user's `.ts` where nothing cleans
+    // them up.
+    const volumeRoot = node_path_1.default.parse((0, createFilesystemPathIdentityContext_1.createFilesystemPathIdentityContext)({
+        throwOnRealpathError: false,
+    }).resolve(props.source).path).root;
+    const beside = props.checked ||
+        (0, readProjectConfig_1.readProjectConfig)({ tsconfig: props.tsconfig }).configPaths.some((file) => node_fs_1.default.readFileSync(file, "utf8").includes("${configDir}"));
+    const tsconfig = node_path_1.default.join(beside ? node_path_1.default.dirname(props.tsconfig) : node_path_1.default.dirname(props.emitDir), `.ttsx-${props.role}.${props.key}.tsconfig.json`);
+    node_fs_1.default.mkdirSync(node_path_1.default.dirname(tsconfig), { recursive: true });
+    let configDescriptor;
+    let ownsConfig = false;
+    try {
+        try {
+            configDescriptor = node_fs_1.default.openSync(tsconfig, "wx");
+            ownsConfig = true;
+            node_fs_1.default.writeFileSync(configDescriptor, JSON.stringify((0, singleRootProjectConfig_1.singleRootProjectConfig)({
+                tsconfig: props.tsconfig,
+                source: props.source,
+                volumeRoot,
+                checked: props.checked,
+            }), null, 2), "utf8");
+            node_fs_1.default.closeSync(configDescriptor);
+            configDescriptor = undefined;
+        }
+        catch (error) {
+            throw unwritableConfigDirectory(error, props, node_path_1.default.dirname(tsconfig));
+        }
+        const project = (0, readProjectConfig_1.readProjectConfig)({
+            cwd: props.projectRoot,
+            // A tsconfig outside the project would otherwise make its own private
+            // directory the project root.
+            projectRoot: options.projectRoot ?? (beside ? undefined : props.projectRoot),
+            tsconfig,
+        });
+        node_fs_1.default.mkdirSync(props.emitDir, { recursive: true });
+        const effectiveOptions = (0, readEffectiveCompilerOptions_1.readEffectiveCompilerOptions)(project, options.passthrough, options.binary);
+        const result = (0, runBuild_1.runBuild)({
+            binary: options.binary,
+            checkers: options.checkers,
+            cwd: props.projectRoot,
+            emit: true,
+            env: options.env,
+            cacheDir: options.cacheDir,
+            outDir: props.emitDir,
+            // Every output this build writes stays in ttsx's private directory: a
+            // declared `declarationDir`, `tsBuildInfoFile`, or `outFile`, and any
+            // output location forwarded on the command line, would otherwise land in
+            // the user's tree.
+            isolateOutputsTo: props.emitDir,
+            passthrough: (0, runtimeCompilerArgs_1.runtimeCompilerArgs)(project, options.passthrough, options.binary, effectiveOptions),
+            // A source map on the transient emit lets the serve path inline it under
+            // the source URL; a project that configures its own keeps it.
+            forceRuntimeSourceMap: (0, runtimeEmitProfile_1.runtimeEmitProfile)(project, options.passthrough, options.binary, effectiveOptions).forceRuntimeSourceMap,
+            forceEmitProvenance: true,
+            // Native plugins discover their config files from the tsconfig's
+            // directory, which for a private tsconfig is ttsx's cache; anchor them
+            // at the real one, as a bundler adapter's temporary overlay does.
+            pluginConfigDir: options.pluginConfigDir ??
+                (beside ? undefined : node_path_1.default.dirname(props.tsconfig)),
+            plugins: options.plugins,
+            quiet: true,
+            resolvedProject: project,
+            singleThreaded: options.singleThreaded,
+            skipDiagnosticsCheck: !props.checked,
+            tsconfig,
+        });
+        // An emit-only build reports its diagnostics through the exit status even
+        // though it wrote the JavaScript, so only an empty output fails it — the
+        // same rule the dependency lane applies to the package's other files.
+        const failed = props.checked
+            ? result.status !== 0
+            : !DependencyBuildGeneration_1.DependencyBuildGeneration.emittedAnything(props.emitDir);
+        if (failed) {
+            throw new Error([
+                props.checked
+                    ? `ttsx: ${props.role} check failed for ${props.source}`
+                    : `ttsx: ${props.role} build produced no output for ${props.source}`,
+                result.stderr || result.stdout,
+            ]
+                .filter((line) => line.trim().length !== 0)
+                .join("\n"));
+        }
+        // The root the compiler actually laid the outputs against: the one written
+        // above unless the command line forwarded another.
+        const effective = effectiveOptions?.("rootDir");
+        return {
+            emittedSources: result.emittedSources,
+            emittedSourceProofFailures: result.emittedSourceProofFailures,
+            project,
+            rootDir: typeof effective === "string"
+                ? node_path_1.default.resolve(project.root, effective)
+                : volumeRoot,
+        };
+    }
+    finally {
+        if (configDescriptor !== undefined) {
+            try {
+                node_fs_1.default.closeSync(configDescriptor);
+            }
+            catch {
+                // Preserve the write or close failure that reached this cleanup.
+            }
+        }
+        if (ownsConfig) {
+            try {
+                node_fs_1.default.rmSync(tsconfig, { force: true });
+            }
+            catch {
+                // Best effort: native cleanup failure can leave this overlay behind.
+            }
+        }
+    }
+}
+/**
+ * The error for a synthesized tsconfig the filesystem refused, naming the
+ * directory and what to do instead of surfacing a bare `EPERM`. Any other
+ * failure is returned unchanged.
+ *
+ * TypeScript-Go's command line cannot combine a project with a file list, so a
+ * build that must read the anchors of a tsconfig from its own directory needs a
+ * tsconfig in that directory. A read-only checkout, mount, or volume refuses
+ * it.
+ */
+function unwritableConfigDirectory(error, props, directory) {
+    const code = error?.code;
+    if (code !== "EACCES" && code !== "EPERM" && code !== "EROFS")
+        return error;
+    return new Error([
+        `ttsx: cannot compile ${props.source} with the options of ${props.tsconfig}: ${directory} is not writable (${code}).`,
+        "The file is outside that project's file set, and ttsx compiles it through a temporary tsconfig placed beside the project's own for the length of the build.",
+        `Make the directory writable, or add the file to the project's "include" or "files".`,
+    ].join("\n"));
+}
+//# sourceMappingURL=buildSingleRootProject.js.map

package/lib/launcher/internal/buildSingleRootProject.js.map

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

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

@@ -1,3 +1,16 @@
 import type { TtscCommonOptions } from "../../structures/internal/TtscCommonOptions";
-/** Format the CLI version banner from the wrapper package and resolved tsc. */
+/**
+ * Format the CLI version banner from the wrapper package and resolved tsc. A
+ * failed native version request throws; unreadable wrapper metadata uses
+ * 0.0.0.
+ *
+ * @evidence contracts/common.md#principled-implementation The selected compiler's version command supplies reported banner text, not a content or ABI identity certificate, while package-local metadata supplies wrapper identity with a documented fallback.
+ * @evidence contracts/common.md#clear-and-simple-design Native invocation and wrapper metadata reading have separate failure policies; the private reader owns only the package-relative lookup.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts The fallback is an explicit unknown wrapper version, not a fabricated compiler version or a suppressed failed native command.
+ * @evidence contracts/common.md#meaningful-documentation Native prose documents the distinct native-command failure and metadata fallback, and the helper explains the compiled-layout anchor.
+ * @evidence contracts/portability.md#os-neutral-implementation resolveTsgo and spawnNative own executable selection and invocation; shared environment merging preserves Windows alias identity and caller precedence while POSIX names remain exact. Node paths anchor package metadata without a shell or filesystem case folding.
+ * @evidence contracts/performance.md#bound-retention-and-release-resources Delegated synchronous spawn/capture owns process/output-file lifetime and cleanup attempts, without a descendant-join or certified native release guarantee here. Captured output and package metadata are call-local; returned banner text belongs to the caller and this helper stores no history.
+ * @evidence contracts/performance.md#efficient-algorithms Compiler selection, environment merging and delegated spawn/capture/recovery add native lookup, argv/environment and process costs. Full output decoding/trim/formatting and package JSON reading/parsing scale with their bytes; no local timeout or output-byte cap bounds them.
+ * @evidenceExclude contracts/performance.md#reuse-equivalent-work This helper queries the current selected compiler and package metadata each call rather than retaining its banner; delegated runtime capability/cache policies are owned by their helpers.
+ */
 export declare function getCompilerVersionText(options?: TtscCommonOptions): string;

package/lib/launcher/internal/getCompilerVersionText.js

@@ -6,22 +6,37 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.getCompilerVersionText = getCompilerVersionText;
 const node_fs_1 = __importDefault(require("node:fs"));
 const node_path_1 = __importDefault(require("node:path"));
+const outputText_1 = require("../../compiler/internal/outputText");
 const resolveTsgo_1 = require("../../compiler/internal/resolveTsgo");
+const SidecarEnvironment_1 = require("../../compiler/internal/sharedHost/SidecarEnvironment");
 const spawnNative_1 = require("../../compiler/internal/spawnNative");
-/** Format the CLI version banner from the wrapper package and resolved tsc. */
+/**
+ * Format the CLI version banner from the wrapper package and resolved tsc. A
+ * failed native version request throws; unreadable wrapper metadata uses
+ * 0.0.0.
+ *
+ * @evidence contracts/common.md#principled-implementation The selected compiler's version command supplies reported banner text, not a content or ABI identity certificate, while package-local metadata supplies wrapper identity with a documented fallback.
+ * @evidence contracts/common.md#clear-and-simple-design Native invocation and wrapper metadata reading have separate failure policies; the private reader owns only the package-relative lookup.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts The fallback is an explicit unknown wrapper version, not a fabricated compiler version or a suppressed failed native command.
+ * @evidence contracts/common.md#meaningful-documentation Native prose documents the distinct native-command failure and metadata fallback, and the helper explains the compiled-layout anchor.
+ * @evidence contracts/portability.md#os-neutral-implementation resolveTsgo and spawnNative own executable selection and invocation; shared environment merging preserves Windows alias identity and caller precedence while POSIX names remain exact. Node paths anchor package metadata without a shell or filesystem case folding.
+ * @evidence contracts/performance.md#bound-retention-and-release-resources Delegated synchronous spawn/capture owns process/output-file lifetime and cleanup attempts, without a descendant-join or certified native release guarantee here. Captured output and package metadata are call-local; returned banner text belongs to the caller and this helper stores no history.
+ * @evidence contracts/performance.md#efficient-algorithms Compiler selection, environment merging and delegated spawn/capture/recovery add native lookup, argv/environment and process costs. Full output decoding/trim/formatting and package JSON reading/parsing scale with their bytes; no local timeout or output-byte cap bounds them.
+ * @evidenceExclude contracts/performance.md#reuse-equivalent-work This helper queries the current selected compiler and package metadata each call rather than retaining its banner; delegated runtime capability/cache policies are owned by their helpers.
+ */
 function getCompilerVersionText(options = {}) {
     const tsgo = (0, resolveTsgo_1.resolveTsgo)(options);
     const res = (0, spawnNative_1.spawnNative)(tsgo.binary, ["--version"], {
         cwd: options.cwd,
-        env: { ...process.env, ...options.env },
+        env: SidecarEnvironment_1.SidecarEnvironment.merge(process.env, options.env),
     });
     if (res.error || res.status !== 0) {
-        throw new Error("ttsc.version: failed: " + ((0, spawnNative_1.outputText)(res.stderr) || res.error?.message));
+        throw new Error("ttsc.version: failed: " + ((0, outputText_1.outputText)(res.stderr) || res.error?.message));
     }
-    return `ttsc ${readOwnPackageVersion()} (${(0, spawnNative_1.outputText)(res.stdout).trim()})`;
+    return `ttsc ${readOwnPackageVersion()} (${(0, outputText_1.outputText)(res.stdout).trim()})`;
 }
 /**
- * Read the `version` field from the `@ttsc/ttsc` package.json that sits three
+ * Read the `version` field from the `ttsc` package.json that sits three
  * directories above the compiled launcher output (`lib/launcher/internal/`).
  * Returns `"0.0.0"` on any I/O or parse failure so the banner is always safe to
  * display.
@@ -30,7 +45,7 @@ function readOwnPackageVersion() {
     try {
         const file = node_path_1.default.resolve(__dirname, "..", "..", "..", "package.json");
         const pkg = JSON.parse(node_fs_1.default.readFileSync(file, "utf8"));
-        return pkg.version ?? "0.0.0";
+        return typeof pkg?.version === "string" ? pkg.version : "0.0.0";
     }
     catch {
         return "0.0.0";

package/lib/launcher/internal/getCompilerVersionText.js.map

@@ -1 +1 @@
-{"version":3,"file":"getCompilerVersionText.js","sourceRoot":"","sources":["../../../src/launcher/internal/getCompilerVersionText.ts"],"names":[],"mappings":";;;;;;AAAA,sDAAyB;AACzB,0DAA6B;AAE7B,qEAAkE;AAClE,qEAA8E;AAG9E,+EAA+E;AAC/E,gCACE,OAAO,GAAsB,EAAE;IAE/B,MAAM,IAAI,GAAG,IAAA,yBAAW,EAAC,OAAO,CAAC,CAAC;IAClC,MAAM,GAAG,GAAG,IAAA,yBAAW,EAAC,IAAI,CAAC,MAAM,EAAE,CAAC,WAAW,CAAC,EAAE;QAClD,GAAG,EAAE,OAAO,CAAC,GAAG;QAChB,GAAG,EAAE,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE;KACxC,CAAC,CAAC;IACH,IAAI,GAAG,CAAC,KAAK,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAClC,MAAM,IAAI,KAAK,CACb,wBAAwB,GAAG,CAAC,IAAA,wBAAU,EAAC,GAAG,CAAC,MAAM,CAAC,IAAI,GAAG,CAAC,KAAK,EAAE,OAAO,CAAC,CAC1E,CAAC;IACJ,CAAC;IACD,OAAO,QAAQ,qBAAqB,EAAE,KAAK,IAAA,wBAAU,EAAC,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,GAAG,CAAC;AAC9E,CAAC;AAED;;;;;GAKG;AACH,SAAS,qBAAqB;IAC5B,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,mBAAI,CAAC,OAAO,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,cAAc,CAAC,CAAC;QACvE,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,iBAAE,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAEnD,CAAC;QACF,OAAO,GAAG,CAAC,OAAO,IAAI,OAAO,CAAC;IAChC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,OAAO,CAAC;IACjB,CAAC;AACH,CAAC"}
+{"version":3,"file":"getCompilerVersionText.js","sourceRoot":"","sources":["../../../src/launcher/internal/getCompilerVersionText.ts"],"names":[],"mappings":";;;;;;AAAA,sDAAyB;AACzB,0DAA6B;AAE7B,mEAAgE;AAChE,qEAAkE;AAClE,8FAA2F;AAC3F,qEAAkE;AAGlE;;;;;;;;;;;;;GAaG;AACH,gCACE,OAAO,GAAsB,EAAE;IAE/B,MAAM,IAAI,GAAG,IAAA,yBAAW,EAAC,OAAO,CAAC,CAAC;IAClC,MAAM,GAAG,GAAG,IAAA,yBAAW,EAAC,IAAI,CAAC,MAAM,EAAE,CAAC,WAAW,CAAC,EAAE;QAClD,GAAG,EAAE,OAAO,CAAC,GAAG;QAChB,GAAG,EAAE,uCAAkB,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,EAAE,OAAO,CAAC,GAAG,CAAC;KACxD,CAAC,CAAC;IACH,IAAI,GAAG,CAAC,KAAK,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAClC,MAAM,IAAI,KAAK,CACb,wBAAwB,GAAG,CAAC,IAAA,uBAAU,EAAC,GAAG,CAAC,MAAM,CAAC,IAAI,GAAG,CAAC,KAAK,EAAE,OAAO,CAAC,CAC1E,CAAC;IACJ,CAAC;IACD,OAAO,QAAQ,qBAAqB,EAAE,KAAK,IAAA,uBAAU,EAAC,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,GAAG,CAAC;AAC9E,CAAC;AAED;;;;;GAKG;AACH,SAAS,qBAAqB;IAC5B,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,mBAAI,CAAC,OAAO,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,cAAc,CAAC,CAAC;QACvE,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,iBAAE,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAEnD,CAAC;QACF,OAAO,OAAO,GAAG,EAAE,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC;IAClE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,OAAO,CAAC;IACjB,CAAC;AACH,CAAC"}

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

@@ -0,0 +1,35 @@
+/**
+ * Rewrite a recognized trailing source-map line comment to inline metadata,
+ * anchoring native source paths to file URLs while preserving qualified URLs. A
+ * supplied single-source anchor overrides its map entry; this is lexical
+ * attribution rather than a check that the referenced source exists.
+ *
+ * Ttsx runs tsgo-built JavaScript under the ORIGINAL `.ts` source URL. When the
+ * owning tsconfig emits external maps, their relative URL belongs to the emit
+ * directory rather than the served source URL. Reading and embedding metadata
+ * avoids that relative lookup after temporary emits are removed. Actual Node,
+ * coverage-tool, debugger and editor interpretation remains their boundary.
+ *
+ * Re-inlining supported normalized string-source maps under the same source
+ * anchor preserves the rewritten bytes. This adapter does not validate every
+ * source-map semantic shape or authenticate a cross-process cache population.
+ *
+ * Reuse requires unchanged served text, source anchor and actual map bytes. The
+ * module cache retains at most 128 recent entries; individual map sizes are not
+ * capped. Only actual trailing line comments are rewritten. Strings, templates
+ * and regular-expression contents cannot supply a directive; unsupported
+ * lexical input is left for the runtime loader to diagnose.
+ *
+ * @param source - The emitted JavaScript text served under the source URL.
+ * @param emittedFile - On-disk path of the emitted `.js`, beside its `.map`.
+ * @param sourceFile - Real path of the `.ts` source the emit was built from.
+ * @evidence contracts/common.md#principled-implementation Acorn comment boundaries distinguish a real trailing directive from literal contents. Metadata uses supplied lexical anchors; parse failures, non-object maps, invalid index sections and unsupported lexical input retain the source. This is not complete source-map schema validation.
+ * @evidence contracts/common.md#clear-and-simple-design The serve boundary coordinates input-equivalent reuse, while helpers separate URL decoding, file reading and source anchoring; external map validity is checked before returning cached JavaScript.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts Canonical sibling-map fallback follows compiler emit layout and missing-map removal addresses a dangling reference; no cached filename alone substitutes for current source or map contents.
+ * @evidence contracts/common.md#meaningful-documentation Native paragraphs explain source-URL execution, idempotence, cache equivalence and retention limits; parameters distinguish emitted and original-source paths.
+ * @evidence contracts/portability.md#os-neutral-implementation Node path resolution reads native emitted files and pathToFileURL encodes source paths; already-qualified map URLs remain protocol identifiers rather than being case-folded as filesystem paths.
+ * @evidence contracts/performance.md#efficient-algorithms Work includes regex matching, optional full-source Acorn lexing, native map reads, JSON/base64 conversion and recursive section/source normalization with path-text costs. No universal linear-time or depth bound is asserted. An equal-source entry at the same emitted key reuses lexical recognition; a fully matching entry avoids rewrite processing after current map-data validation.
+ * @evidence contracts/performance.md#reuse-equivalent-work Absolute native locations capture cwd-sensitive emitted/source anchors, while exact source text shares lexical recognition and freshly read map JSON validates the rewrite; changed bytes or anchors rebuild rather than serving an old generation.
+ * @evidence contracts/performance.md#bound-retention-and-release-resources The module owns a 128-entry insertion-ordered LRU and evicts its oldest entry after a miss; retained bytes still depend on individual source/map sizes, and process exit releases the remaining cache.
+ */
+export declare function inlineServedSourceMap(source: string, emittedFile: string | undefined, sourceFile: string | undefined): string;

package/lib/launcher/internal/inlineServedSourceMap.js

@@ -0,0 +1,255 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.inlineServedSourceMap = inlineServedSourceMap;
+const acorn_1 = require("acorn");
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_path_1 = __importDefault(require("node:path"));
+const node_url_1 = require("node:url");
+/**
+ * Rewrite a recognized trailing source-map line comment to inline metadata,
+ * anchoring native source paths to file URLs while preserving qualified URLs. A
+ * supplied single-source anchor overrides its map entry; this is lexical
+ * attribution rather than a check that the referenced source exists.
+ *
+ * Ttsx runs tsgo-built JavaScript under the ORIGINAL `.ts` source URL. When the
+ * owning tsconfig emits external maps, their relative URL belongs to the emit
+ * directory rather than the served source URL. Reading and embedding metadata
+ * avoids that relative lookup after temporary emits are removed. Actual Node,
+ * coverage-tool, debugger and editor interpretation remains their boundary.
+ *
+ * Re-inlining supported normalized string-source maps under the same source
+ * anchor preserves the rewritten bytes. This adapter does not validate every
+ * source-map semantic shape or authenticate a cross-process cache population.
+ *
+ * Reuse requires unchanged served text, source anchor and actual map bytes. The
+ * module cache retains at most 128 recent entries; individual map sizes are not
+ * capped. Only actual trailing line comments are rewritten. Strings, templates
+ * and regular-expression contents cannot supply a directive; unsupported
+ * lexical input is left for the runtime loader to diagnose.
+ *
+ * @param source - The emitted JavaScript text served under the source URL.
+ * @param emittedFile - On-disk path of the emitted `.js`, beside its `.map`.
+ * @param sourceFile - Real path of the `.ts` source the emit was built from.
+ * @evidence contracts/common.md#principled-implementation Acorn comment boundaries distinguish a real trailing directive from literal contents. Metadata uses supplied lexical anchors; parse failures, non-object maps, invalid index sections and unsupported lexical input retain the source. This is not complete source-map schema validation.
+ * @evidence contracts/common.md#clear-and-simple-design The serve boundary coordinates input-equivalent reuse, while helpers separate URL decoding, file reading and source anchoring; external map validity is checked before returning cached JavaScript.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts Canonical sibling-map fallback follows compiler emit layout and missing-map removal addresses a dangling reference; no cached filename alone substitutes for current source or map contents.
+ * @evidence contracts/common.md#meaningful-documentation Native paragraphs explain source-URL execution, idempotence, cache equivalence and retention limits; parameters distinguish emitted and original-source paths.
+ * @evidence contracts/portability.md#os-neutral-implementation Node path resolution reads native emitted files and pathToFileURL encodes source paths; already-qualified map URLs remain protocol identifiers rather than being case-folded as filesystem paths.
+ * @evidence contracts/performance.md#efficient-algorithms Work includes regex matching, optional full-source Acorn lexing, native map reads, JSON/base64 conversion and recursive section/source normalization with path-text costs. No universal linear-time or depth bound is asserted. An equal-source entry at the same emitted key reuses lexical recognition; a fully matching entry avoids rewrite processing after current map-data validation.
+ * @evidence contracts/performance.md#reuse-equivalent-work Absolute native locations capture cwd-sensitive emitted/source anchors, while exact source text shares lexical recognition and freshly read map JSON validates the rewrite; changed bytes or anchors rebuild rather than serving an old generation.
+ * @evidence contracts/performance.md#bound-retention-and-release-resources The module owns a 128-entry insertion-ordered LRU and evicts its oldest entry after a miss; retained bytes still depend on individual source/map sizes, and process exit releases the remaining cache.
+ */
+function inlineServedSourceMap(source, emittedFile, sourceFile) {
+    if (emittedFile === undefined) {
+        return source;
+    }
+    const emittedPath = node_path_1.default.resolve(emittedFile);
+    const sourcePath = sourceFile === undefined ? undefined : node_path_1.default.resolve(sourceFile);
+    const cached = inlineCache.get(emittedPath);
+    const match = cached?.source === source ? cached.match : trailingSourceMapComment(source);
+    const url = match?.[1]?.trim();
+    const json = url ? readMapJson(url, emittedPath) : null;
+    if (cached !== undefined &&
+        cached.source === source &&
+        cached.sourceFile === sourcePath &&
+        cached.json === json) {
+        inlineCache.delete(emittedPath);
+        inlineCache.set(emittedPath, cached);
+        return cached.rewritten;
+    }
+    const rewritten = rewrite(source, emittedPath, sourcePath, match, json);
+    inlineCache.delete(emittedPath);
+    inlineCache.set(emittedPath, {
+        source,
+        sourceFile: sourcePath,
+        match,
+        json,
+        rewritten,
+    });
+    if (inlineCache.size > 128) {
+        inlineCache.delete(inlineCache.keys().next().value);
+    }
+    return rewritten;
+}
+/** Most recently used rewrites; map bytes are re-read before sharing a result. */
+const inlineCache = new Map();
+/**
+ * Trailing `//# sourceMappingURL=<url>` (or legacy `//@`) magic comment.
+ * Anchored at end of text through any trailing whitespace, so it matches the
+ * last comment whether tsgo emitted it with a newline, none, or a CRLF line
+ * ending.
+ */
+const SOURCE_MAPPING_URL = /\/\/[#@] sourceMappingURL=([^\r\n]*)[ \t\r\n]*$/;
+/**
+ * Locate a real trailing line comment without treating string/regex text as
+ * code.
+ */
+function trailingSourceMapComment(source) {
+    const candidate = SOURCE_MAPPING_URL.exec(source);
+    if (candidate === null)
+        return null;
+    let recognized = false;
+    try {
+        const lexer = (0, acorn_1.tokenizer)(source, {
+            ecmaVersion: "latest",
+            sourceType: "module",
+            onComment(block, _text, start) {
+                if (!block && start === candidate.index)
+                    recognized = true;
+            },
+        });
+        while (lexer.getToken().type !== acorn_1.tokTypes.eof) {
+            // Lexing supplies comment boundaries without allocating an AST.
+        }
+    }
+    catch {
+        // Optional mapping cannot replace the actual loader's syntax diagnostics.
+        return null;
+    }
+    return recognized ? candidate : null;
+}
+function rewrite(source, emittedFile, sourceFile, match, json) {
+    if (match === null) {
+        return source;
+    }
+    const url = match[1].trim();
+    if (url.length === 0) {
+        return source;
+    }
+    if (json === null) {
+        // The referenced map cannot be read (an external ref whose sibling is
+        // missing). Strip the dangling comment so Node does not cache the script
+        // with `data: null` and misattribute coverage; leave an already-inline
+        // `data:` map untouched since it is self-contained.
+        return url.startsWith("data:")
+            ? source
+            : source.slice(0, match.index).replace(/\r?\n$/, "");
+    }
+    const inlined = inlineComment(json, emittedFile, sourceFile);
+    if (inlined === null) {
+        return source;
+    }
+    return source.slice(0, match.index) + inlined;
+}
+/** Read the raw map JSON from a `data:` URI or a sibling map file. */
+function readMapJson(url, emittedFile) {
+    if (url.startsWith("data:")) {
+        return decodeDataUri(url);
+    }
+    const direct = node_path_1.default.resolve(node_path_1.default.dirname(emittedFile), url);
+    const fromRef = readFileOrNull(direct);
+    if (fromRef !== null) {
+        return fromRef;
+    }
+    // tsgo names the comment after the emit basename; fall back to the canonical
+    // sibling path when the comment's relative form does not resolve on disk.
+    return readFileOrNull(`${emittedFile}.map`);
+}
+/** Decode a `data:application/json[;base64],...` source-map URI to its JSON. */
+function decodeDataUri(url) {
+    const comma = url.indexOf(",");
+    if (comma === -1) {
+        return null;
+    }
+    const meta = url.slice(0, comma);
+    if (!meta.includes("application/json")) {
+        return null;
+    }
+    const payload = url.slice(comma + 1);
+    try {
+        return meta.includes(";base64")
+            ? Buffer.from(payload, "base64").toString("utf8")
+            : decodeURIComponent(payload);
+    }
+    catch {
+        return null;
+    }
+}
+/** Parse the map, absolutize its `sources`, and re-encode it as a `data:` URI. */
+function inlineComment(json, emittedFile, sourceFile) {
+    let map;
+    try {
+        map = JSON.parse(json);
+    }
+    catch {
+        return null;
+    }
+    if (map === null || typeof map !== "object" || Array.isArray(map)) {
+        return null;
+    }
+    try {
+        absolutizeMap(map, node_path_1.default.dirname(emittedFile), sourceFile);
+    }
+    catch {
+        // A URL root that cannot resolve its relative entries must retain the
+        // original metadata rather than silently become a native path.
+        return null;
+    }
+    const encoded = Buffer.from(JSON.stringify(map), "utf8").toString("base64");
+    return `//# sourceMappingURL=data:application/json;charset=utf-8;base64,${encoded}`;
+}
+/**
+ * Normalize each embedded map without inventing root-level sources for an
+ * index.
+ */
+function absolutizeMap(map, mapDir, sourceFile) {
+    if (Array.isArray(map.sections)) {
+        for (const section of map.sections) {
+            const child = section?.map;
+            if (child === null || typeof child !== "object" || Array.isArray(child))
+                throw new Error("unsupported external source-map section");
+            // Sections can describe different originals; use each map's own anchor.
+            absolutizeMap(child, mapDir, undefined);
+        }
+    }
+    else {
+        map.sources = absolutizeSources(map, mapDir, sourceFile);
+        // Absolute source URLs no longer use their former relative root.
+        delete map.sourceRoot;
+    }
+}
+/**
+ * Map each entry of the source map's `sources` to an absolute `file://` URL.
+ *
+ * Tsgo's per-file emit is 1:1, so a single source is the served file itself and
+ * resolves to the real on-disk `sourceFile` the serve path already knows — the
+ * most reliable anchor. A map that somehow carries several sources (or is
+ * consumed without a known source file) has each relative entry resolved
+ * against the map's own directory and `sourceRoot`, exactly where tsgo computed
+ * them from; entries that are already absolute URLs pass through unchanged.
+ */
+function absolutizeSources(map, mapDir, sourceFile) {
+    const sources = Array.isArray(map.sources) ? map.sources : [];
+    if (sources.length === 1 && sourceFile !== undefined) {
+        return [(0, node_url_1.pathToFileURL)(sourceFile).href];
+    }
+    const sourceRoot = typeof map.sourceRoot === "string" ? map.sourceRoot : "";
+    return sources.map((entry) => {
+        if (typeof entry !== "string") {
+            return String(entry);
+        }
+        if (node_path_1.default.isAbsolute(entry)) {
+            return (0, node_url_1.pathToFileURL)(entry).href;
+        }
+        if (/^[a-zA-Z][a-zA-Z0-9+.-]*:/.test(entry)) {
+            return entry;
+        }
+        if (!node_path_1.default.isAbsolute(sourceRoot) &&
+            /^[a-zA-Z][a-zA-Z0-9+.-]*:/.test(sourceRoot)) {
+            return new URL(entry, sourceRoot.endsWith("/") ? sourceRoot : `${sourceRoot}/`).href;
+        }
+        return (0, node_url_1.pathToFileURL)(node_path_1.default.resolve(mapDir, sourceRoot, entry)).href;
+    });
+}
+function readFileOrNull(file) {
+    try {
+        return node_fs_1.default.readFileSync(file, "utf8");
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=inlineServedSourceMap.js.map

package/lib/launcher/internal/inlineServedSourceMap.js.map

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