ttsc 0.33.0 → 0.34.0

package/lib/launcher/internal/buildSingleRootInMemory.js

@@ -0,0 +1,253 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildSingleRootInMemory = buildSingleRootInMemory;
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_path_1 = __importDefault(require("node:path"));
+const BuildExecution_1 = require("../../compiler/internal/build/BuildExecution");
+const PassthroughFlags_1 = require("../../compiler/internal/build/PassthroughFlags");
+const TsgoArguments_1 = require("../../compiler/internal/build/TsgoArguments");
+const readProjectConfig_1 = require("../../compiler/internal/project/readProjectConfig");
+const readEffectiveCompilerOptions_1 = require("../../compiler/internal/readEffectiveCompilerOptions");
+const resolveTsgo_1 = require("../../compiler/internal/resolveTsgo");
+const SidecarEnvironment_1 = require("../../compiler/internal/sharedHost/SidecarEnvironment");
+const readCompilerOptionValues_1 = require("../../flags/readCompilerOptionValues");
+const hasProjectPluginEntries_1 = require("../../plugin/internal/load/hasProjectPluginEntries");
+const TypeScriptSyncApi_1 = require("./TypeScriptSyncApi");
+const compilerArgsAsConfigOptions_1 = require("./compilerArgsAsConfigOptions");
+const DependencyBuildGeneration_1 = require("./runtime/DependencyBuildGeneration");
+const runtimeCompilerArgs_1 = require("./runtimeCompilerArgs");
+const runtimeEmitProfile_1 = require("./runtimeEmitProfile");
+const singleRootProjectConfig_1 = require("./singleRootProjectConfig");
+/**
+ * Compile one root outside its project's file set through the consuming
+ * TypeScript's own API, with the single-root tsconfig held in memory, or report
+ * that this build cannot take that route.
+ *
+ * `buildSingleRootProject` compiles such a root through a tsconfig that extends
+ * the project and lists only the root. On the command line that tsconfig has to
+ * exist on disk, beside the project's own when a checked build needs its
+ * directory-relative lookups. TypeScript 7.1's `typescript/sync` API opens a
+ * project from a snapshot whose filesystem layer holds the tsconfig instead,
+ * and its emit returns the files rather than writing them. So here the tsconfig
+ * always sits, in memory, beside the project's own: `${configDir}`, the default
+ * `typeRoots` and every `types` entry resolve exactly as the user's config sees
+ * them, and nothing is created in the user's tree.
+ *
+ * The compiler options are the command-line build's. The arguments that build
+ * would pass after `-p` (`TsgoArguments.createTsgoBuildArgs` over the same run
+ * options) are written into the in-memory tsconfig's `compilerOptions` by
+ * `compilerArgsAsConfigOptions`, which keeps their precedence over the project.
+ * The session compiler's own command-line parser must accept them first, so an
+ * invalid argument still gets the command line's diagnostic. Outputs are
+ * written into `emitDir` only; one the options would place elsewhere is not
+ * written at all, as the command-line build's isolation keeps it inside. Each
+ * JavaScript output's source is the one the compiler emitted it from.
+ *
+ * The route is unavailable, and the caller keeps the command-line build, when
+ * the project's TypeScript publishes no such API (7.0), when a compiler binary
+ * other than that TypeScript's own or a compiler environment is selected (the
+ * binary ttsx hands its runtime is the one it resolved, so a root the running
+ * program reaches is admitted like an entry), when the build would run native
+ * plugins (they run inside ttsc's own host, which reads its tsconfig from
+ * disk), or when its arguments cannot be carried by a tsconfig: a response
+ * file, a terminal flag, or another command-line-only argument.
+ *
+ * The returned `project` is the owning project's parse. The in-memory tsconfig
+ * changes only the file set, the output layout and declaration emission, so its
+ * module options are the project's.
+ *
+ * @returns The build, or `undefined` when this route is unavailable.
+ * @throws When the build fails, with the messages of the command-line build: a
+ *   checked build fails on any diagnostic, an emit-only build only when it
+ *   produced no JavaScript.
+ * @evidence contracts/common.md#principled-implementation The command-line build's own argument composition supplies the options, translated into the extending config's compilerOptions where they keep command-line precedence, and validated by the consumer compiler's parseCommandLine. Diagnostics are gathered in the native report order (GetDiagnosticsOfAnyProgram: config and syntactic, then options and global, then semantic and the global diagnostics checking found, each later group only when no diagnostic beyond the config ones precedes), and the emit is the consumer compiler's own. Premise: a layer-filesystem config is parsed like one on disk at the same path, verified against typescript@7.1.0-beta and the 7.1 nightly the E2E lane installs.
+ * @evidence contracts/common.md#clear-and-simple-design Admission, option translation, the API session and output writing are each one step of this function, with translation and the API surface in their own modules; the caller keeps the command-line route for every refusal.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts Every unsupported build class returns undefined to the existing command-line route instead of an approximation; no consumer or fixture is special-cased and the compiler is used through its published API.
+ * @evidence contracts/common.md#meaningful-documentation The prose explains the in-memory placement, option equivalence, output isolation, provenance, every refusal class and the meaning of the returned project.
+ * @evidence contracts/portability.md#os-neutral-implementation Output names from the API are resolved with node:path before writing, and sources are recorded by their native real path, the spelling the command-line provenance records.
+ * @evidence contracts/performance.md#efficient-algorithms The compiler package is resolved and its API loaded first, so a 7.0 project costs one package resolution and a failed export lookup before the command-line build. An admitted build then makes one project parse, one execution resolution without plugin loading, one API session with one snapshot, one diagnostic pass when checked and one emit; an emit-only build gathers diagnostics only to explain a failure.
+ * @evidence contracts/performance.md#reuse-equivalent-work The project parse serves plugin admission, the runtime options and the execution context; the session's parse of the arguments precedes the single snapshot.
+ * @evidence contracts/performance.md#bound-retention-and-release-resources The API session is closed in finally on success and failure: close destroys its pipes and signals the child to terminate without waiting for its exit, and the API kills a child still alive when the process exits. Emitted text is held until written; the caller owns emitDir.
+ */
+function buildSingleRootInMemory(props) {
+    const options = props.options;
+    if ((0, readCompilerOptionValues_1.readCompilerOptionValues)(options.passthrough).responseFiles.length !== 0 ||
+        (options.env !== undefined && Object.keys(options.env).length !== 0))
+        return undefined;
+    // Checked first: a 7.0 project, the common case, then costs one package
+    // resolution before the command-line build. The package is resolved past any
+    // selected binary, so the selection can be compared with it.
+    const packageEnv = SidecarEnvironment_1.SidecarEnvironment.merge(process.env);
+    SidecarEnvironment_1.SidecarEnvironment.write(packageEnv, "TTSC_TSGO_BINARY", undefined);
+    let compiler;
+    try {
+        compiler = (0, resolveTsgo_1.resolveTsgo)({
+            cwd: node_path_1.default.dirname(props.tsconfig),
+            env: packageEnv,
+        });
+    }
+    catch {
+        // The command-line build reports a missing compiler in its own words.
+        return undefined;
+    }
+    // ttsx hands its runtime the compiler it resolved as `TTSC_TSGO_BINARY`, so
+    // only a selection naming another binary is a custom compiler.
+    const selected = options.binary ?? SidecarEnvironment_1.SidecarEnvironment.read(process.env, "TTSC_TSGO_BINARY");
+    if (selected && !sameFile(selected, compiler.binary))
+        return undefined;
+    const api = TypeScriptSyncApi_1.TypeScriptSyncApi.load(compiler.packageJson);
+    if (api === undefined)
+        return undefined;
+    const project = (0, readProjectConfig_1.readProjectConfig)({
+        cwd: props.projectRoot,
+        projectRoot: options.projectRoot,
+        tsconfig: props.tsconfig,
+    });
+    if ((0, hasProjectPluginEntries_1.hasProjectPluginEntries)(project, options.plugins, options.pluginConfigDir))
+        return undefined;
+    const effectiveOptions = (0, readEffectiveCompilerOptions_1.readEffectiveCompilerOptions)(project, options.passthrough, undefined, process.env);
+    const runOptions = {
+        checkers: options.checkers,
+        cwd: props.projectRoot,
+        emit: true,
+        outDir: props.emitDir,
+        isolateOutputsTo: props.emitDir,
+        passthrough: (0, runtimeCompilerArgs_1.runtimeCompilerArgs)(project, options.passthrough, undefined, effectiveOptions),
+        forceRuntimeSourceMap: (0, runtimeEmitProfile_1.runtimeEmitProfile)(project, options.passthrough, undefined, effectiveOptions).forceRuntimeSourceMap,
+        plugins: options.plugins,
+        pluginConfigDir: options.pluginConfigDir,
+        projectRoot: options.projectRoot,
+        quiet: true,
+        resolvedProject: project,
+        singleThreaded: options.singleThreaded,
+        skipDiagnosticsCheck: !props.checked,
+        tsconfig: props.tsconfig,
+    };
+    const execution = BuildExecution_1.BuildExecution.resolveExecutionContext(runOptions);
+    if (execution.compilerSelection.inspectionError !== undefined ||
+        execution.pluginSetupFailure !== undefined ||
+        execution.nativePlugins.length !== 0 ||
+        !sameFile(execution.tsgo.binary, compiler.binary))
+        return undefined;
+    const buildOptions = BuildExecution_1.BuildExecution.applyProjectNoEmit(runOptions, execution);
+    if (PassthroughFlags_1.PassthroughFlags.forwardsTerminalTsgoFlag(buildOptions))
+        return undefined;
+    const args = TsgoArguments_1.TsgoArguments.createTsgoBuildArgs(execution, buildOptions, {
+        listEmittedFiles: false,
+        noEmitOnError: props.checked,
+    });
+    if (args[0] !== "-p" || args[1] !== execution.tsconfig)
+        return undefined;
+    const assigned = (0, compilerArgsAsConfigOptions_1.compilerArgsAsConfigOptions)(args.slice(2), execution.cwd);
+    if (assigned === undefined)
+        return undefined;
+    const config = (0, singleRootProjectConfig_1.singleRootProjectConfig)({
+        tsconfig: props.tsconfig,
+        source: props.source,
+        volumeRoot: props.volumeRoot,
+        checked: props.checked,
+    });
+    const configFile = node_path_1.default.join(node_path_1.default.dirname(props.tsconfig), `.ttsx-${props.role}.${props.key}.tsconfig.json`);
+    const session = new api.API({
+        cwd: execution.cwd,
+        tsserverPath: execution.tsgo.binary,
+    });
+    try {
+        if (session.parseCommandLine(args.slice(2)).errors.length !== 0)
+            return undefined;
+        const snapshot = session.createSnapshot({
+            openProjects: [configFile],
+            fileSystem: {
+                kind: "layer",
+                files: {
+                    [configFile]: JSON.stringify({
+                        ...config,
+                        compilerOptions: { ...config.compilerOptions, ...assigned },
+                    }),
+                },
+            },
+        });
+        const opened = snapshot.getConfiguredProject(configFile);
+        const program = opened === undefined ? undefined : snapshot.getProgram(opened.id);
+        if (program === undefined)
+            throw new Error(`ttsx: TypeScript did not open the ${props.role} project for ${props.source}`);
+        const failure = (summary, diagnostics) => new Error([summary, api.formatDiagnostics(diagnostics, session)]
+            .filter((line) => line.trim().length !== 0)
+            .join("\n"));
+        const checkFailure = `ttsx: ${props.role} check failed for ${props.source}`;
+        if (props.checked) {
+            const diagnostics = TypeScriptSyncApi_1.TypeScriptSyncApi.reportedDiagnostics(program);
+            if (diagnostics.length !== 0)
+                throw failure(checkFailure, diagnostics);
+        }
+        const emitted = program.emitToString();
+        if (props.checked && (emitted.diagnostics?.length ?? 0) !== 0)
+            throw failure(checkFailure, emitted.diagnostics);
+        const emitDir = node_path_1.default.resolve(props.emitDir);
+        const emittedSources = Object.create(null);
+        const emittedSourceProofFailures = Object.create(null);
+        node_fs_1.default.mkdirSync(emitDir, { recursive: true });
+        for (const [fileName, file] of emitted.outputFiles) {
+            const output = node_path_1.default.resolve(fileName);
+            const relative = node_path_1.default.relative(emitDir, output);
+            if (relative === "" ||
+                relative.startsWith("..") ||
+                node_path_1.default.isAbsolute(relative))
+                continue;
+            node_fs_1.default.mkdirSync(node_path_1.default.dirname(output), { recursive: true });
+            node_fs_1.default.writeFileSync(output, file.text);
+            if (!/\.(?:js|jsx|mjs|cjs)$/i.test(output))
+                continue;
+            const owner = physicalSource(file.sourceFileName);
+            if (owner !== undefined)
+                emittedSources[output] = [owner];
+            else {
+                emittedSources[output] = [];
+                emittedSourceProofFailures[output] =
+                    file.sourceFileName === undefined
+                        ? "TypeScript reported no source for this output."
+                        : `The source TypeScript emitted this output from no longer resolves: ${JSON.stringify(file.sourceFileName)}.`;
+            }
+        }
+        if (!props.checked && !DependencyBuildGeneration_1.DependencyBuildGeneration.emittedAnything(emitDir))
+            throw failure(`ttsx: ${props.role} build produced no output for ${props.source}`, TypeScriptSyncApi_1.TypeScriptSyncApi.reportedDiagnostics(program));
+        return {
+            project,
+            rootDir: typeof assigned.rootDir === "string"
+                ? assigned.rootDir
+                : props.volumeRoot,
+            emittedSources,
+            emittedSourceProofFailures: Object.keys(emittedSourceProofFailures).length === 0
+                ? undefined
+                : emittedSourceProofFailures,
+        };
+    }
+    finally {
+        session.close();
+    }
+}
+/** Whether two paths name the same existing file. */
+function sameFile(left, right) {
+    try {
+        return (node_fs_1.default.realpathSync.native(node_path_1.default.resolve(left)) ===
+            node_fs_1.default.realpathSync.native(node_path_1.default.resolve(right)));
+    }
+    catch {
+        return false;
+    }
+}
+/** The native real path of an emitted output's source, if it still exists. */
+function physicalSource(fileName) {
+    if (fileName === undefined)
+        return undefined;
+    try {
+        return node_fs_1.default.realpathSync.native(node_path_1.default.resolve(fileName));
+    }
+    catch {
+        return undefined;
+    }
+}
+//# sourceMappingURL=buildSingleRootInMemory.js.map

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

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

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

@@ -23,20 +23,24 @@ import type { TtscCommonOptions } from "../../structures/internal/TtscCommonOpti
  * 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.
+ * combine a project with a file list, so no other placement is faithful for it.
+ * TypeScript 7.1's API can hold that tsconfig in memory, beside the real one,
+ * without creating a file: `buildSingleRootInMemory` takes the build first, and
+ * everything below runs only when that route is unavailable: for a TypeScript
+ * 7.0 project, native plugins, a custom compiler, or arguments a tsconfig
+ * cannot carry. 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
@@ -64,12 +68,12 @@ import type { TtscCommonOptions } from "../../structures/internal/TtscCommonOpti
  *   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#principled-implementation The in-memory API route is tried first and owns its own admission; otherwise 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 selects the in-memory route when it is available and otherwise 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/common.md#meaningful-documentation Native paragraphs explain the in-memory route and when it is unavailable, 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#efficient-algorithms An admitted in-memory build replaces every step below with its own single API session; a refused one adds its admission (a project parse and an execution resolution without plugin loading) before them. 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.
  */

package/lib/launcher/internal/buildSingleRootProject.js

@@ -11,6 +11,7 @@ const readProjectConfig_1 = require("../../compiler/internal/project/readProject
 const readEffectiveCompilerOptions_1 = require("../../compiler/internal/readEffectiveCompilerOptions");
 const SidecarEnvironment_1 = require("../../compiler/internal/sharedHost/SidecarEnvironment");
 const createFilesystemPathIdentityContext_1 = require("../../internal/pathIdentity/createFilesystemPathIdentityContext");
+const buildSingleRootInMemory_1 = require("./buildSingleRootInMemory");
 const DependencyBuildGeneration_1 = require("./runtime/DependencyBuildGeneration");
 const runtimeCompilerArgs_1 = require("./runtimeCompilerArgs");
 const runtimeEmitProfile_1 = require("./runtimeEmitProfile");
@@ -37,20 +38,24 @@ const singleRootProjectConfig_1 = require("./singleRootProjectConfig");
  * 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.
+ * combine a project with a file list, so no other placement is faithful for it.
+ * TypeScript 7.1's API can hold that tsconfig in memory, beside the real one,
+ * without creating a file: `buildSingleRootInMemory` takes the build first, and
+ * everything below runs only when that route is unavailable: for a TypeScript
+ * 7.0 project, native plugins, a custom compiler, or arguments a tsconfig
+ * cannot carry. 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
@@ -78,12 +83,12 @@ const singleRootProjectConfig_1 = require("./singleRootProjectConfig");
  *   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#principled-implementation The in-memory API route is tried first and owns its own admission; otherwise 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 selects the in-memory route when it is available and otherwise 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/common.md#meaningful-documentation Native paragraphs explain the in-memory route and when it is unavailable, 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#efficient-algorithms An admitted in-memory build replaces every step below with its own single API session; a refused one adds its admission (a project parse and an execution resolution without plugin loading) before them. 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.
  */
@@ -99,6 +104,9 @@ function buildSingleRootProject(props) {
     const volumeRoot = node_path_1.default.parse((0, createFilesystemPathIdentityContext_1.createFilesystemPathIdentityContext)({
         throwOnRealpathError: false,
     }).resolve(props.source).path).root;
+    const inMemory = (0, buildSingleRootInMemory_1.buildSingleRootInMemory)({ ...props, options, volumeRoot });
+    if (inMemory !== undefined)
+        return inMemory;
     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`);
@@ -225,6 +233,7 @@ function unwritableConfigDirectory(error, props, directory) {
         `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".`,
+        "With TypeScript 7.1 or later, a build without native plugins, a custom compiler or a response file compiles it in memory instead.",
     ].join("\n"));
 }
 //# sourceMappingURL=buildSingleRootProject.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"buildSingleRootProject.js","sourceRoot":"","sources":["../../../src/launcher/internal/buildSingleRootProject.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"buildSingleRootProject.js","sourceRoot":"","sources":["../../../src/launcher/internal/buildSingleRootProject.ts"],"names":[],"mappings":";;;;;;AAAA,sDAAyB;AACzB,0DAA6B;AAE7B,qEAAkE;AAClE,yFAAsF;AACtF,uGAAoG;AACpG,8FAA2F;AAC3F,yHAAsH;AAGtH,uEAAoE;AACpE,mFAAgF;AAChF,+DAA4D;AAC5D,6DAA0D;AAC1D,uEAAoE;AAEpE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2EG;AACH,gCAAuC,KA4BtC;IAaC,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,IAAI,EAAE,CAAC;IACpC,yEAAyE;IACzE,6EAA6E;IAC7E,2EAA2E;IAC3E,8EAA8E;IAC9E,4EAA4E;IAC5E,2EAA2E;IAC3E,WAAW;IACX,MAAM,UAAU,GAAG,mBAAI,CAAC,KAAK,CAC3B,IAAA,yEAAmC,EAAC;QAClC,oBAAoB,EAAE,KAAK;KAC5B,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,CAC9B,CAAC,IAAI,CAAC;IACP,MAAM,QAAQ,GAAG,IAAA,iDAAuB,EAAC,EAAE,GAAG,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC,CAAC;IAC5E,IAAI,QAAQ,KAAK,SAAS;QAAE,OAAO,QAAQ,CAAC;IAC5C,MAAM,MAAM,GACV,KAAK,CAAC,OAAO;QACb,IAAA,qCAAiB,EAAC,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CACxE,iBAAE,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,QAAQ,CAAC,cAAc,CAAC,CACvD,CAAC;IACJ,MAAM,QAAQ,GAAG,mBAAI,CAAC,IAAI,CACxB,MAAM,CAAC,CAAC,CAAC,mBAAI,CAAC,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,mBAAI,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,EACnE,SAAS,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,GAAG,gBAAgB,CACjD,CAAC;IACF,iBAAE,CAAC,SAAS,CAAC,mBAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC1D,IAAI,gBAAoC,CAAC;IACzC,IAAI,UAAU,GAAG,KAAK,CAAC;IACvB,IAAI,CAAC;QACH,IAAI,CAAC;YACH,gBAAgB,GAAG,iBAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;YAC/C,UAAU,GAAG,IAAI,CAAC;YAClB,iBAAE,CAAC,aAAa,CACd,gBAAgB,EAChB,IAAI,CAAC,SAAS,CACZ,IAAA,iDAAuB,EAAC;gBACtB,QAAQ,EAAE,KAAK,CAAC,QAAQ;gBACxB,MAAM,EAAE,KAAK,CAAC,MAAM;gBACpB,UAAU;gBACV,OAAO,EAAE,KAAK,CAAC,OAAO;aACvB,CAAC,EACF,IAAI,EACJ,CAAC,CACF,EACD,MAAM,CACP,CAAC;YACF,iBAAE,CAAC,SAAS,CAAC,gBAAgB,CAAC,CAAC;YAC/B,gBAAgB,GAAG,SAAS,CAAC;QAC/B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,yBAAyB,CAAC,KAAK,EAAE,KAAK,EAAE,mBAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC;QACxE,CAAC;QACD,MAAM,OAAO,GAAG,IAAA,qCAAiB,EAAC;YAChC,GAAG,EAAE,KAAK,CAAC,WAAW;YACtB,sEAAsE;YACtE,8BAA8B;YAC9B,WAAW,EACT,OAAO,CAAC,WAAW,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC;YACjE,QAAQ;SACT,CAAC,CAAC;QACH,iBAAE,CAAC,SAAS,CAAC,KAAK,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACjD,MAAM,gBAAgB,GAAG,IAAA,2DAA4B,EACnD,OAAO,EACP,OAAO,CAAC,WAAW,EACnB,OAAO,CAAC,MAAM,EACd,uCAAkB,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,EAAE,OAAO,CAAC,GAAG,CAAC,CACnD,CAAC;QACF,MAAM,MAAM,GAAG,IAAA,mBAAQ,EAAC;YACtB,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,QAAQ,EAAE,OAAO,CAAC,QAAQ;YAC1B,GAAG,EAAE,KAAK,CAAC,WAAW;YACtB,IAAI,EAAE,IAAI;YACV,GAAG,EAAE,OAAO,CAAC,GAAG;YAChB,QAAQ,EAAE,OAAO,CAAC,QAAQ;YAC1B,MAAM,EAAE,KAAK,CAAC,OAAO;YACrB,sEAAsE;YACtE,sEAAsE;YACtE,yEAAyE;YACzE,mBAAmB;YACnB,gBAAgB,EAAE,KAAK,CAAC,OAAO;YAC/B,WAAW,EAAE,IAAA,yCAAmB,EAC9B,OAAO,EACP,OAAO,CAAC,WAAW,EACnB,OAAO,CAAC,MAAM,EACd,gBAAgB,CACjB;YACD,yEAAyE;YACzE,8DAA8D;YAC9D,qBAAqB,EAAE,IAAA,uCAAkB,EACvC,OAAO,EACP,OAAO,CAAC,WAAW,EACnB,OAAO,CAAC,MAAM,EACd,gBAAgB,CACjB,CAAC,qBAAqB;YACvB,mBAAmB,EAAE,IAAI;YACzB,iEAAiE;YACjE,uEAAuE;YACvE,kEAAkE;YAClE,eAAe,EACb,OAAO,CAAC,eAAe;gBACvB,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,mBAAI,CAAC,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;YACrD,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,KAAK,EAAE,IAAI;YACX,eAAe,EAAE,OAAO;YACxB,cAAc,EAAE,OAAO,CAAC,cAAc;YACtC,oBAAoB,EAAE,CAAC,KAAK,CAAC,OAAO;YACpC,QAAQ;SACT,CAAC,CAAC;QACH,0EAA0E;QAC1E,yEAAyE;QACzE,sEAAsE;QACtE,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO;YAC1B,CAAC,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC;YACrB,CAAC,CAAC,CAAC,qDAAyB,CAAC,eAAe,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAC9D,IAAI,MAAM,EAAE,CAAC;YACX,MAAM,IAAI,KAAK,CACb;gBACE,KAAK,CAAC,OAAO;oBACX,CAAC,CAAC,SAAS,KAAK,CAAC,IAAI,qBAAqB,KAAK,CAAC,MAAM,EAAE;oBACxD,CAAC,CAAC,SAAS,KAAK,CAAC,IAAI,iCAAiC,KAAK,CAAC,MAAM,EAAE;gBACtE,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM;aAC/B;iBACE,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,CAAC;iBAC1C,IAAI,CAAC,IAAI,CAAC,CACd,CAAC;QACJ,CAAC;QACD,2EAA2E;QAC3E,mDAAmD;QACnD,MAAM,SAAS,GAAG,gBAAgB,EAAE,CAAC,SAAS,CAAC,CAAC;QAChD,OAAO;YACL,cAAc,EAAE,MAAM,CAAC,cAAc;YACrC,0BAA0B,EAAE,MAAM,CAAC,0BAA0B;YAC7D,OAAO;YACP,OAAO,EACL,OAAO,SAAS,KAAK,QAAQ;gBAC3B,CAAC,CAAC,mBAAI,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,SAAS,CAAC;gBACvC,CAAC,CAAC,UAAU;SACjB,CAAC;IACJ,CAAC;YAAS,CAAC;QACT,IAAI,gBAAgB,KAAK,SAAS,EAAE,CAAC;YACnC,IAAI,CAAC;gBACH,iBAAE,CAAC,SAAS,CAAC,gBAAgB,CAAC,CAAC;YACjC,CAAC;YAAC,MAAM,CAAC;gBACP,iEAAiE;YACnE,CAAC;QACH,CAAC;QACD,IAAI,UAAU,EAAE,CAAC;YACf,IAAI,CAAC;gBACH,iBAAE,CAAC,MAAM,CAAC,QAAQ,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;YACvC,CAAC;YAAC,MAAM,CAAC;gBACP,qEAAqE;YACvE,CAAC;QACH,CAAC;IACH,CAAC;AACH,CAAC;AAED;;;;;;;;;GASG;AACH,SAAS,yBAAyB,CAChC,KAAc,EACd,KAA2C,EAC3C,SAAiB;IAEjB,MAAM,IAAI,GAAI,KAAsC,EAAE,IAAI,CAAC;IAC3D,IAAI,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,OAAO,IAAI,IAAI,KAAK,OAAO;QAAE,OAAO,KAAK,CAAC;IAC5E,OAAO,IAAI,KAAK,CACd;QACE,wBAAwB,KAAK,CAAC,MAAM,wBAAwB,KAAK,CAAC,QAAQ,KAAK,SAAS,qBAAqB,IAAI,IAAI;QACrH,6JAA6J;QAC7J,qFAAqF;QACrF,mIAAmI;KACpI,CAAC,IAAI,CAAC,IAAI,CAAC,CACb,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,39 @@
+/**
+ * Translate compiler command-line arguments into the `compilerOptions` of a
+ * tsconfig that extends the project, so that a build which opens that tsconfig
+ * alone sees the options the arguments would have given it.
+ *
+ * TypeScript applies command-line options over the options of the config it
+ * builds, and an extending config's own `compilerOptions` override the config
+ * it extends in the same way. So the assignments of `args`, written into the
+ * extending config, win over the project exactly as they would on the command
+ * line. Each value is converted the way the compiler parses it from argv: the
+ * last occurrence of an option wins; `null` resets an inherited value; enum
+ * values are trimmed and lowercased; a list value is split at commas and loses
+ * its empty members; and a value that names a path is resolved against `cwd`,
+ * because the compiler resolves a command-line path against its working
+ * directory while a config path resolves against the config's directory.
+ *
+ * Arguments that a config cannot carry make the translation unavailable, so the
+ * caller keeps a build that passes them on the command line: a response file, a
+ * positional file name, an unknown option, an option the compiler accepts only
+ * on the command line, a project selection, the trace and profile options whose
+ * artifacts the compiler writes itself, and a value containing `${configDir}`,
+ * which a config would substitute and the command line does not. The
+ * translation assumes valid arguments; the caller confirms them with the same
+ * compiler's own command-line parser before using the result.
+ *
+ * @param args Compiler arguments without the leading `-p <tsconfig>`.
+ * @param cwd The directory the compiler would run in.
+ * @returns The assignments by canonical option name, or `undefined` when the
+ *   arguments cannot be carried by a config.
+ * @evidence contracts/common.md#principled-implementation Each occurrence is classified by the pinned native grammar (readCompilerOptionOccurrence) and its value converted by the native command-line rules: null resets, last occurrence wins, enum trim and lowercase, list TrimSpace and comma split with empty members dropped, and paths resolved against the working directory. Command-line options override the configured ones as an extending config's options override its base, so writing them into the extending config preserves precedence. Premise: the arguments are valid; the caller verifies that with the consumer compiler's parseCommandLine. Options newer than the pinned table are unknown here and make the translation unavailable.
+ * @evidence contracts/common.md#clear-and-simple-design One pure function owns the argv-to-config translation; the build that consumes it owns compiler selection, validation and emission.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts Unsupported argument classes return undefined so the caller keeps the command-line build instead of approximating them; no option is special-cased by consumer or fixture.
+ * @evidence contracts/common.md#meaningful-documentation The prose states the precedence premise, every conversion rule, each class that makes the translation unavailable and the validity premise.
+ * @evidence contracts/portability.md#os-neutral-implementation Path values are resolved with node:path against the supplied working directory, so drive letters and separators follow the host; no other value is touched as a path.
+ * @evidence contracts/performance.md#efficient-algorithms One pass over the arguments with a constant-time table lookup per option and a split per list value.
+ * @evidenceExclude contracts/performance.md#reuse-equivalent-work The translation depends only on its arguments and is computed once per build.
+ * @evidenceExclude contracts/performance.md#bound-retention-and-release-resources The returned record is the only allocation and transfers to the caller.
+ */
+export declare function compilerArgsAsConfigOptions(args: readonly string[], cwd: string): Record<string, unknown> | undefined;

package/lib/launcher/internal/compilerArgsAsConfigOptions.js

@@ -0,0 +1,115 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.compilerArgsAsConfigOptions = compilerArgsAsConfigOptions;
+const node_path_1 = __importDefault(require("node:path"));
+const normalizeCompilerEnumValue_1 = require("../../flags/normalizeCompilerEnumValue");
+const readCompilerOptionOccurrence_1 = require("../../flags/readCompilerOptionOccurrence");
+/**
+ * Translate compiler command-line arguments into the `compilerOptions` of a
+ * tsconfig that extends the project, so that a build which opens that tsconfig
+ * alone sees the options the arguments would have given it.
+ *
+ * TypeScript applies command-line options over the options of the config it
+ * builds, and an extending config's own `compilerOptions` override the config
+ * it extends in the same way. So the assignments of `args`, written into the
+ * extending config, win over the project exactly as they would on the command
+ * line. Each value is converted the way the compiler parses it from argv: the
+ * last occurrence of an option wins; `null` resets an inherited value; enum
+ * values are trimmed and lowercased; a list value is split at commas and loses
+ * its empty members; and a value that names a path is resolved against `cwd`,
+ * because the compiler resolves a command-line path against its working
+ * directory while a config path resolves against the config's directory.
+ *
+ * Arguments that a config cannot carry make the translation unavailable, so the
+ * caller keeps a build that passes them on the command line: a response file, a
+ * positional file name, an unknown option, an option the compiler accepts only
+ * on the command line, a project selection, the trace and profile options whose
+ * artifacts the compiler writes itself, and a value containing `${configDir}`,
+ * which a config would substitute and the command line does not. The
+ * translation assumes valid arguments; the caller confirms them with the same
+ * compiler's own command-line parser before using the result.
+ *
+ * @param args Compiler arguments without the leading `-p <tsconfig>`.
+ * @param cwd The directory the compiler would run in.
+ * @returns The assignments by canonical option name, or `undefined` when the
+ *   arguments cannot be carried by a config.
+ * @evidence contracts/common.md#principled-implementation Each occurrence is classified by the pinned native grammar (readCompilerOptionOccurrence) and its value converted by the native command-line rules: null resets, last occurrence wins, enum trim and lowercase, list TrimSpace and comma split with empty members dropped, and paths resolved against the working directory. Command-line options override the configured ones as an extending config's options override its base, so writing them into the extending config preserves precedence. Premise: the arguments are valid; the caller verifies that with the consumer compiler's parseCommandLine. Options newer than the pinned table are unknown here and make the translation unavailable.
+ * @evidence contracts/common.md#clear-and-simple-design One pure function owns the argv-to-config translation; the build that consumes it owns compiler selection, validation and emission.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts Unsupported argument classes return undefined so the caller keeps the command-line build instead of approximating them; no option is special-cased by consumer or fixture.
+ * @evidence contracts/common.md#meaningful-documentation The prose states the precedence premise, every conversion rule, each class that makes the translation unavailable and the validity premise.
+ * @evidence contracts/portability.md#os-neutral-implementation Path values are resolved with node:path against the supplied working directory, so drive letters and separators follow the host; no other value is touched as a path.
+ * @evidence contracts/performance.md#efficient-algorithms One pass over the arguments with a constant-time table lookup per option and a split per list value.
+ * @evidenceExclude contracts/performance.md#reuse-equivalent-work The translation depends only on its arguments and is computed once per build.
+ * @evidenceExclude contracts/performance.md#bound-retention-and-release-resources The returned record is the only allocation and transfers to the caller.
+ */
+function compilerArgsAsConfigOptions(args, cwd) {
+    const options = {};
+    for (let index = 0; index < args.length;) {
+        if (args[index].startsWith("@"))
+            return undefined;
+        const occurrence = (0, readCompilerOptionOccurrence_1.readCompilerOptionOccurrence)(args, index);
+        const option = occurrence.option;
+        if (option === undefined ||
+            option.commandLineOnly ||
+            COMMAND_LINE_OUTPUTS.has(option.name))
+            return undefined;
+        const next = occurrence.width === 2 ? args[index + 1] : undefined;
+        let value;
+        if (next === "null")
+            value = null;
+        else if (option.configOnly) {
+            // The command line accepts only `null`, or `false` for a boolean.
+            if (option.kind !== "boolean" || next !== "false")
+                return undefined;
+            value = false;
+        }
+        else if (option.kind === "boolean")
+            value = occurrence.booleanValue;
+        else if (next === undefined)
+            // A list whose value is empty; any other kind is an invalid argument.
+            value = [];
+        else if (next.includes("${configDir}"))
+            return undefined;
+        else if (option.kind === "number")
+            value = Number(next);
+        else if (option.kind === "enum")
+            value = (0, normalizeCompilerEnumValue_1.normalizeCompilerEnumValue)(next, "cli");
+        else if (option.kind === "list")
+            value = splitList(next, option.element === "enum", option.filePath, cwd);
+        else
+            value = option.filePath ? node_path_1.default.resolve(cwd, next) : next;
+        options[option.name] = value;
+        index += occurrence.width;
+    }
+    return options;
+}
+/**
+ * Options whose output the compiler writes itself, outside the emit: a config
+ * route that only collects emitted files cannot produce them.
+ */
+const COMMAND_LINE_OUTPUTS = new Set([
+    "project",
+    "generateTrace",
+    "generateCpuProfile",
+    "pprofDir",
+]);
+/** Members of a command-line list value, as the native parser reads them. */
+function splitList(value, enumMembers, filePath, cwd) {
+    // Go strings.TrimSpace follows Unicode White_Space for the whole value;
+    // enum members are then trimmed with the compiler's IsWhiteSpaceLike set.
+    const trimmed = value.replace(/^\p{White_Space}+|\p{White_Space}+$/gu, "");
+    if (trimmed === "" || trimmed.startsWith("-"))
+        return [];
+    const members = [];
+    for (const part of trimmed.split(",")) {
+        const member = enumMembers ? (0, normalizeCompilerEnumValue_1.normalizeCompilerEnumValue)(part, "cli") : part;
+        if (member === null || member === "")
+            continue;
+        members.push(filePath ? node_path_1.default.resolve(cwd, member) : member);
+    }
+    return members;
+}
+//# sourceMappingURL=compilerArgsAsConfigOptions.js.map

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

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