ttsc 0.30.4 → 0.31.0

package/lib/launcher/internal/runtimeCompilerArgs.js

@@ -1,70 +1,99 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.runtimeCompilerArgs = runtimeCompilerArgs;
-const resolveTsgo_1 = require("../../compiler/internal/resolveTsgo");
-const spawnNative_1 = require("../../compiler/internal/spawnNative");
-const schema_1 = require("../../flags/schema");
+const readEffectiveCompilerOptions_1 = require("../../compiler/internal/readEffectiveCompilerOptions");
 /**
- * Lower proposal syntax in ESNext runtime builds without changing the implied
- * library or module kind. TypeScript-Go preserves standard decorators at
- * ESNext, while Node cannot parse them. Its latest standard target, ES2025,
- * runs the upstream decorator transform and keeps native class-field
- * semantics.
+ * The compiler arguments of a runtime build: the caller's own, plus whatever
+ * requests decorator/JSX lowering and JavaScript emission for Node. This is not
+ * certification of every runtime API or syntax feature. The config, source, and
+ * ordinary `ttsc` output never change.
+ *
+ * Two settings hand syntax Node cannot parse to a later tool, and each is
+ * replaced only in the runtime build, after the forwarded flags so it wins over
+ * them as well as over the config:
+ *
+ * - `target: ESNext` preserves proposal decorators. The build lowers to ES2025,
+ *   TypeScript-Go's latest standard target, which runs the upstream decorator
+ *   lowering policy while retaining the standard class-field target, without
+ *   changing the implied library or module kind.
+ * - `jsx: preserve` and `jsx: react-native` keep JSX. The build compiles it with
+ *   the JSX runtime the type-check already reads.
+ *
+ * A forwarded `--noEmit` or `--emitDeclarationOnly` is switched back off as
+ * well. ttsx forwards the flags before the entry to its type-check, and the
+ * check is unchanged by them, but the runtime build is that check's emit, and
+ * without JavaScript there is nothing to run.
+ *
+ * A caller coordinating one build may supply its effective-options reader for
+ * this exact project and forwarded arguments. Null preserves the compiler's
+ * argument-rejection path; omission creates the reader here.
+ *
+ * @evidence contracts/common.md#principled-implementation Effective compiler options determine runtime-only target/JSX overrides; preserving implied module and library choices keeps the original check's meaning while producing executable syntax.
+ * @evidence contracts/common.md#clear-and-simple-design One ordered argument adapter separates runtime emit policy from project configuration and leaves invalid-argument diagnostics to the compiler.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts ES2025 and JSX discriminants reflect supported compiler transforms; no source-text patch or consumer-specific override substitutes for emission.
+ * @evidence contracts/common.md#meaningful-documentation Native paragraphs explain decorator, JSX, library and no-emit decisions and their runtime-only scope without changing the user's project.
+ * @evidence contracts/portability.md#os-neutral-implementation Effective-option resolution delegates response-file parsing to the compiler owner and returns argument tokens rather than shell text or platform-specific paths.
+ * @evidence contracts/performance.md#bound-retention-and-release-resources The returned copied argv array belongs to the caller. An internally prepared effective reader is call-local; a supplied reader and its captured config/assignment records remain caller-owned. Delegated response inspection and native showConfig/capture own cleanup attempts; this adapter retains no history or process handle.
+ * @evidence contracts/performance.md#efficient-algorithms Copying A forwarded argument references and text/value queries precedes fixed policy additions. Without a supplied reader, delegated argv/response inspection, native showConfig, full output decoding and JSON parsing are additional input/native costs; the returned argv need not be short.
+ * @evidence contracts/performance.md#reuse-equivalent-work One effective reader serves this call's policy queries, and an actual reader supplied for the same project/arguments avoids preparation repeated across coordinated build adapters. The caller owns that equivalence premise; this adapter caches no historical argv result.
  */
-function runtimeCompilerArgs(project, passthrough = [], binary) {
-    let compilerOptions = project.compilerOptions;
-    const hasResponseFile = passthrough.some((token) => token.startsWith("@"));
-    if (hasResponseFile) {
-        // Let TypeScript-Go own response-file quoting, nesting, cwd, and ordering.
-        // Replaying just the visible flags would overwrite options inside @files.
-        const tsgo = (0, resolveTsgo_1.resolveTsgo)({ cwd: project.root, binary });
-        const result = (0, spawnNative_1.spawnNative)(tsgo.binary, ["-p", project.path, ...passthrough, "--showConfig"], { cwd: project.root, encoding: "utf8" });
-        // Preserve the original compiler's diagnostic when its arguments are invalid.
-        if (result.status !== 0)
-            return [...passthrough];
-        compilerOptions = JSON.parse((0, spawnNative_1.outputText)(result.stdout)).compilerOptions;
+function runtimeCompilerArgs(project, passthrough = [], binary, effectiveOptions) {
+    const option = effectiveOptions === undefined
+        ? (0, readEffectiveCompilerOptions_1.readEffectiveCompilerOptions)(project, passthrough, binary)
+        : effectiveOptions;
+    // Preserve the original compiler's diagnostic when its arguments are invalid.
+    if (option === null)
+        return [...passthrough];
+    const args = [...passthrough];
+    const target = option("target", ["t"]);
+    if (typeof target === "string" && target.toLowerCase() === "esnext") {
+        args.push("--target", "es2025");
+        const module = option("module", ["m"]);
+        if (module == null || String(module).toLowerCase() === "none") {
+            // GetEmitModuleKind derives ESNext from the original target.
+            args.push("--module", "esnext");
+        }
+        const noLib = option("noLib");
+        if (option("lib") == null && noLib !== true && noLib !== "true") {
+            // The references in TypeScript-Go's lib.esnext.full.d.ts. An explicit lib
+            // (including []) or noLib keeps the user's exact library selection.
+            args.push("--lib", "esnext,dom,webworker.importscripts,scripthost,dom.iterable,dom.asynciterable");
+        }
     }
-    const option = (name, aliases = []) => {
-        if (hasResponseFile)
-            return compilerOptions[name];
-        let value = compilerOptions[name];
-        for (let i = 0; i < passthrough.length; i++) {
-            const token = passthrough[i];
-            if (!token.startsWith("-"))
-                continue;
-            const normalized = (0, schema_1.normalizeFlagToken)(token);
-            if (normalized !== name.toLowerCase() && !aliases.includes(normalized)) {
-                continue;
+    const jsx = option("jsx");
+    if (typeof jsx === "string" && PRESERVED_JSX.has(jsx.toLowerCase())) {
+        // A project that preserves JSX hands it to another tool, and Node is not
+        // that tool. The runtime build compiles it the way the compiler already
+        // checks it. A `jsxImportSource` makes the checker read JSX as the automatic
+        // runtime even under `preserve`, so it selects `react-jsx`. Without one, a
+        // `jsxFactory`, `jsxFragmentFactory`, or `reactNamespace` declares the
+        // classic transform, and a project that declares nothing gets the automatic
+        // runtime's default source, `react`.
+        const factories = ["jsxFactory", "jsxFragmentFactory", "reactNamespace"];
+        const automatic = option("jsxImportSource") != null ||
+            factories.every((name) => option(name) == null);
+        args.push("--jsx", automatic ? "react-jsx" : "react");
+        // `preserve` accepts a factory beside an import source, and `react-jsx`
+        // rejects it (TS5089), so the factories the automatic runtime never reads
+        // are set aside for the runtime build.
+        if (automatic) {
+            for (const name of factories) {
+                if (option(name) != null)
+                    args.push(`--${name}`, "null");
             }
-            const next = passthrough[i + 1];
-            value =
-                name === "noLib" &&
-                    next !== "true" &&
-                    next !== "false" &&
-                    next !== "null"
-                    ? true
-                    : next === "null"
-                        ? undefined
-                        : next;
         }
-        return value;
-    };
-    const target = option("target", ["t"]);
-    if (typeof target !== "string" || target.toLowerCase() !== "esnext") {
-        return [...passthrough];
-    }
-    const args = [...passthrough, "--target", "es2025"];
-    const module = option("module", ["m"]);
-    if (module == null || String(module).toLowerCase() === "none") {
-        // GetEmitModuleKind derives ESNext from the original target.
-        args.push("--module", "esnext");
-    }
-    const noLib = option("noLib");
-    if (option("lib") == null && noLib !== true && noLib !== "true") {
-        // The references in TypeScript-Go's lib.esnext.full.d.ts. An explicit lib
-        // (including []) or noLib keeps the user's exact library selection.
-        args.push("--lib", "esnext,dom,webworker.importscripts,scripthost,dom.iterable,dom.asynciterable");
     }
+    // Unconditional, after every forwarded token: a response file can carry the
+    // flag too. Explicit false operands clear the two native boolean assignments.
+    args.push("--noEmit", "false", "--emitDeclarationOnly", "false");
     return args;
 }
+/**
+ * JSX modes that leave the syntax in the output for a downstream tool. Node
+ * cannot parse either, so a runtime build replaces them.
+ */
+const PRESERVED_JSX = new Set([
+    "preserve",
+    "react-native",
+]);
 //# sourceMappingURL=runtimeCompilerArgs.js.map

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

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

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

@@ -0,0 +1,39 @@
+import { readEffectiveCompilerOptions } from "../../compiler/internal/readEffectiveCompilerOptions";
+import type { ITtscParsedProjectConfig } from "../../structures/internal/ITtscParsedProjectConfig";
+import type { OwningModuleOptions } from "./runtime/OwningModuleOptions";
+/**
+ * What a ttsx runtime build emits, read from the options it compiles with: the
+ * project's config and the flags forwarded before the entry, in the order the
+ * compiler applies them.
+ *
+ * Two decisions follow from the emit, and reading the config alone answered
+ * both for a build that is not the one that runs:
+ *
+ * - `moduleOptions` classify every file the build serves as CommonJS or an ES
+ *   module. `ttsx --module esnext` on a CommonJS project emitted ESM that the
+ *   runtime then served as CommonJS, and the entry never ran while the run
+ *   exited 0.
+ * - `forceRuntimeSourceMap` adds `--sourceMap` when the build would carry no map
+ *   to inline. A forwarded `--inlineSourceMap` already carries one, and forcing
+ *   `sourceMap` beside it failed the build with TS5053.
+ *
+ * @param project - The project the runtime build compiles.
+ * @param passthrough - The flags forwarded to that build, in order.
+ * @param binary - An explicit TypeScript-Go binary, for a response file.
+ * @param effectiveOptions - A reader already resolved for this exact build's
+ *   project and forwarded arguments, or null after compiler rejection.
+ * @evidence contracts/common.md#principled-implementation Reading effective options in compiler order classifies the actual emit, and the two map booleans prevent asking for conflicting external and inline maps.
+ * @evidence contracts/common.md#clear-and-simple-design The profile carries only module classification and whether a map must be requested; the local boolean reader normalizes supported true spellings.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts Invalid forwarded arguments retain the compiler's own rejection path; config fallback is provisional classification rather than silently dropping those arguments.
+ * @evidence contracts/common.md#meaningful-documentation Native paragraphs and parameter comments explain emit-derived decisions and the two failure modes this boundary avoids; result members retain separate native comments.
+ * @evidence contracts/portability.md#os-neutral-implementation Native response-file interpretation stays with effective-option resolution; this adapter passes binary identity and argument tokens without shell quoting or guessed filesystem case rules.
+ * @evidence contracts/performance.md#bound-retention-and-release-resources The local option reader and its captured assignment/shown records end with the call unless supplied/retained by the caller; delegated response inspection/native capture own resource cleanup attempts. The small returned profile retains module-option values rather than process handles or history.
+ * @evidence contracts/performance.md#efficient-algorithms Without a supplied reader, effective-option preparation projects argv and may inspect/decode/hash response bytes, run native showConfig and parse its output. Profile queries also normalize option/alias/value text; the fixed outer result shape does not bound delegated input or native execution costs.
+ * @evidence contracts/performance.md#reuse-equivalent-work One effective reader serves all profile queries; an actual reader supplied for this exact project/argument invocation avoids preparing it again. Context matching is the caller's prerequisite, not an equality or native-state proof performed by this adapter; there is no historical profile memo.
+ */
+export declare function runtimeEmitProfile(project: ITtscParsedProjectConfig, passthrough?: readonly string[], binary?: string, effectiveOptions?: ReturnType<typeof readEffectiveCompilerOptions>): {
+    /** The emit-deciding options the runtime classifies served files with. */
+    moduleOptions: OwningModuleOptions;
+    /** Whether the build must be asked for a source map. */
+    forceRuntimeSourceMap: boolean;
+};

package/lib/launcher/internal/runtimeEmitProfile.js

@@ -0,0 +1,56 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runtimeEmitProfile = runtimeEmitProfile;
+const readEffectiveCompilerOptions_1 = require("../../compiler/internal/readEffectiveCompilerOptions");
+const projectModuleOptions_1 = require("./runtime/projectModuleOptions");
+/**
+ * What a ttsx runtime build emits, read from the options it compiles with: the
+ * project's config and the flags forwarded before the entry, in the order the
+ * compiler applies them.
+ *
+ * Two decisions follow from the emit, and reading the config alone answered
+ * both for a build that is not the one that runs:
+ *
+ * - `moduleOptions` classify every file the build serves as CommonJS or an ES
+ *   module. `ttsx --module esnext` on a CommonJS project emitted ESM that the
+ *   runtime then served as CommonJS, and the entry never ran while the run
+ *   exited 0.
+ * - `forceRuntimeSourceMap` adds `--sourceMap` when the build would carry no map
+ *   to inline. A forwarded `--inlineSourceMap` already carries one, and forcing
+ *   `sourceMap` beside it failed the build with TS5053.
+ *
+ * @param project - The project the runtime build compiles.
+ * @param passthrough - The flags forwarded to that build, in order.
+ * @param binary - An explicit TypeScript-Go binary, for a response file.
+ * @param effectiveOptions - A reader already resolved for this exact build's
+ *   project and forwarded arguments, or null after compiler rejection.
+ * @evidence contracts/common.md#principled-implementation Reading effective options in compiler order classifies the actual emit, and the two map booleans prevent asking for conflicting external and inline maps.
+ * @evidence contracts/common.md#clear-and-simple-design The profile carries only module classification and whether a map must be requested; the local boolean reader normalizes supported true spellings.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts Invalid forwarded arguments retain the compiler's own rejection path; config fallback is provisional classification rather than silently dropping those arguments.
+ * @evidence contracts/common.md#meaningful-documentation Native paragraphs and parameter comments explain emit-derived decisions and the two failure modes this boundary avoids; result members retain separate native comments.
+ * @evidence contracts/portability.md#os-neutral-implementation Native response-file interpretation stays with effective-option resolution; this adapter passes binary identity and argument tokens without shell quoting or guessed filesystem case rules.
+ * @evidence contracts/performance.md#bound-retention-and-release-resources The local option reader and its captured assignment/shown records end with the call unless supplied/retained by the caller; delegated response inspection/native capture own resource cleanup attempts. The small returned profile retains module-option values rather than process handles or history.
+ * @evidence contracts/performance.md#efficient-algorithms Without a supplied reader, effective-option preparation projects argv and may inspect/decode/hash response bytes, run native showConfig and parse its output. Profile queries also normalize option/alias/value text; the fixed outer result shape does not bound delegated input or native execution costs.
+ * @evidence contracts/performance.md#reuse-equivalent-work One effective reader serves all profile queries; an actual reader supplied for this exact project/argument invocation avoids preparing it again. Context matching is the caller's prerequisite, not an equality or native-state proof performed by this adapter; there is no historical profile memo.
+ */
+function runtimeEmitProfile(project, passthrough = [], binary, effectiveOptions) {
+    const option = effectiveOptions === undefined
+        ? (0, readEffectiveCompilerOptions_1.readEffectiveCompilerOptions)(project, passthrough, binary)
+        : effectiveOptions;
+    const compilerOptions = project.compilerOptions;
+    // Invalid forwarded flags fail the build on their own; the config answers
+    // until then.
+    const read = (name, aliases) => option === null ? compilerOptions[name] : option(name, aliases);
+    return {
+        moduleOptions: (0, projectModuleOptions_1.projectModuleOptions)({
+            module: read("module", ["m"]),
+            target: read("target", ["t"]),
+        }),
+        forceRuntimeSourceMap: !isOn(read("sourceMap")) && !isOn(read("inlineSourceMap")),
+    };
+}
+/** Whether a config value or a forwarded flag value turns an option on. */
+function isOn(value) {
+    return value === true || value === "true";
+}
+//# sourceMappingURL=runtimeEmitProfile.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"runtimeEmitProfile.js","sourceRoot":"","sources":["../../../src/launcher/internal/runtimeEmitProfile.ts"],"names":[],"mappings":";;;AAAA,uGAAoG;AAGpG,yEAAsE;AAEtE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,4BACE,OAAiC,EACjC,WAAW,GAAsB,EAAE,EACnC,MAAe,EACf,gBAAkE;IAQlE,MAAM,MAAM,GACV,gBAAgB,KAAK,SAAS;QAC5B,CAAC,CAAC,IAAA,2DAA4B,EAAC,OAAO,EAAE,WAAW,EAAE,MAAM,CAAC;QAC5D,CAAC,CAAC,gBAAgB,CAAC;IACvB,MAAM,eAAe,GAAG,OAAO,CAAC,eAA0C,CAAC;IAC3E,0EAA0E;IAC1E,cAAc;IACd,MAAM,IAAI,GAAG,CAAC,IAAY,EAAE,OAA2B,EAAW,EAAE,CAClE,MAAM,KAAK,IAAI,CAAC,CAAC,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAClE,OAAO;QACL,aAAa,EAAE,IAAA,2CAAoB,EAAC;YAClC,MAAM,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,GAAG,CAAC,CAAC;YAC7B,MAAM,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,GAAG,CAAC,CAAC;SAC9B,CAAC;QACF,qBAAqB,EACnB,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;KAC7D,CAAC;AACJ,CAAC;AAED,2EAA2E;AAC3E,SAAS,IAAI,CAAC,KAAc;IAC1B,OAAO,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,MAAM,CAAC;AAC5C,CAAC"}

package/lib/launcher/internal/runtimeHookPreload.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-const runtimeHooks_1 = require("./runtimeHooks");
+const installRuntimeHooks_1 = require("./runtime/installRuntimeHooks");
 /**
  * `--require` target that only installs the runtime module hooks. `ttsx` puts
  * it on `NODE_OPTIONS` for the child process so every descendant the program
@@ -8,9 +8,9 @@ const runtimeHooks_1 = require("./runtimeHooks");
  * source-loading hooks, the way `ts-node` propagates through `--require
  * ts-node/register`. The preload itself is CommonJS and only registers the
  * hooks; ESM support comes from the `registerHooks` they install, not from how
- * the preload is loaded. The entry process additionally goes through the
- * bootstrap, which loads the entry itself; here we only register
+ * the preload is loaded. The entry process gets it the same way, which is what
+ * lets Node load the entry itself as its main module; here we only register
  * (idempotently).
  */
-(0, runtimeHooks_1.installRuntimeHooks)();
+(0, installRuntimeHooks_1.installRuntimeHooks)();
 //# sourceMappingURL=runtimeHookPreload.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"runtimeHookPreload.js","sourceRoot":"","sources":["../../../src/launcher/internal/runtimeHookPreload.ts"],"names":[],"mappings":";;AAAA,iDAAqD;AAErD;;;;;;;;;;GAUG;AACH,IAAA,kCAAmB,GAAE,CAAC"}
+{"version":3,"file":"runtimeHookPreload.js","sourceRoot":"","sources":["../../../src/launcher/internal/runtimeHookPreload.ts"],"names":[],"mappings":";;AAAA,uEAAoE;AAEpE;;;;;;;;;;GAUG;AACH,IAAA,yCAAmB,GAAE,CAAC"}

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

@@ -0,0 +1 @@
+export {};

package/lib/launcher/internal/runtimeOwnerPreload.js

@@ -0,0 +1,43 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_path_1 = __importDefault(require("node:path"));
+const ProcessOwnedDirectory_1 = require("./runtime/ProcessOwnedDirectory");
+const withRuntimeDirectoryLock_1 = require("./runtime/withRuntimeDirectoryLock");
+/**
+ * Claim a ttsx run before another preload or the program can use its output.
+ *
+ * The launcher can be killed after it starts a child. The child must publish
+ * its own owner record under the lock that default clean uses, so either clean
+ * sees its live claim or the child fails before user code if clean removed the
+ * run first. NODE_OPTIONS passes this preload to descendants as well. A child
+ * without the inherited runtime manifest uses its own cache and claims no part
+ * of the parent's run.
+ */
+const directory = process.env.TTSX_RUNTIME_RUN_DIR;
+const manifest = process.env.TTSX_RUNTIME_MANIFEST;
+const runtime = process.env.TTSX_RUNTIME_CACHE_DIR;
+const runs = process.env.TTSX_RUNTIME_RUNS_DIR;
+if (directory !== undefined &&
+    manifest !== undefined &&
+    manifest.length !== 0) {
+    if (!node_path_1.default.isAbsolute(directory) ||
+        runtime === undefined ||
+        !node_path_1.default.isAbsolute(runtime) ||
+        runs === undefined ||
+        !node_path_1.default.isAbsolute(runs) ||
+        node_path_1.default.dirname(directory) !== runs) {
+        throw new Error(`ttsx: invalid runtime run directory: ${directory}`);
+    }
+    (0, withRuntimeDirectoryLock_1.withRuntimeDirectoryLock)(runtime, () => {
+        const entry = node_fs_1.default.lstatSync(directory);
+        if (!entry.isDirectory() || entry.isSymbolicLink()) {
+            throw new Error(`ttsx: unsafe runtime run directory: ${directory}`);
+        }
+        ProcessOwnedDirectory_1.ProcessOwnedDirectory.admit(directory, process.pid);
+    });
+}
+//# sourceMappingURL=runtimeOwnerPreload.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"runtimeOwnerPreload.js","sourceRoot":"","sources":["../../../src/launcher/internal/runtimeOwnerPreload.ts"],"names":[],"mappings":";;;;;AAAA,sDAAyB;AACzB,0DAA6B;AAE7B,2EAAwE;AACxE,iFAA8E;AAE9E;;;;;;;;;GASG;AACH,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC;AACnD,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,qBAAqB,CAAC;AACnD,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,sBAAsB,CAAC;AACnD,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,qBAAqB,CAAC;AAC/C,IACE,SAAS,KAAK,SAAS;IACvB,QAAQ,KAAK,SAAS;IACtB,QAAQ,CAAC,MAAM,KAAK,CAAC,EACrB,CAAC;IACD,IACE,CAAC,mBAAI,CAAC,UAAU,CAAC,SAAS,CAAC;QAC3B,OAAO,KAAK,SAAS;QACrB,CAAC,mBAAI,CAAC,UAAU,CAAC,OAAO,CAAC;QACzB,IAAI,KAAK,SAAS;QAClB,CAAC,mBAAI,CAAC,UAAU,CAAC,IAAI,CAAC;QACtB,mBAAI,CAAC,OAAO,CAAC,SAAS,CAAC,KAAK,IAAI,EAChC,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,wCAAwC,SAAS,EAAE,CAAC,CAAC;IACvE,CAAC;IACD,IAAA,mDAAwB,EAAC,OAAO,EAAE,GAAG,EAAE;QACrC,MAAM,KAAK,GAAG,iBAAE,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;QACtC,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE,IAAI,KAAK,CAAC,cAAc,EAAE,EAAE,CAAC;YACnD,MAAM,IAAI,KAAK,CAAC,uCAAuC,SAAS,EAAE,CAAC,CAAC;QACtE,CAAC;QACD,6CAAqB,CAAC,KAAK,CAAC,SAAS,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC;IACtD,CAAC,CAAC,CAAC;AACL,CAAC"}

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

@@ -0,0 +1,34 @@
+/**
+ * Project the single-root overlay that inherits the selected owning config.
+ * Explicit empty include/exclude lists displace inherited populations. Checked
+ * overlays preserve inherited noEmitOnError; unchecked overlays clear it. The
+ * caller supplies the already selected physical volume root and owns config
+ * placement, exclusive creation, parsing, compilation and cleanup.
+ *
+ * @evidence contracts/common.md#principled-implementation The overlay retains its owning config through extends, selects the exact source and clears inherited include/exclude populations without changing the checked lane's noEmitOnError policy.
+ * @evidence contracts/common.md#clear-and-simple-design One fresh JSON-compatible object supplies the existing fixed compiler overrides and selected path values to the production writer.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts Ordinary compiler config fields own selection; no compiler output, native root inference or read result is invented or intercepted.
+ * @evidence contracts/common.md#meaningful-documentation The native paragraph states list replacement, checked versus unchecked policy and the caller-owned filesystem/compiler boundaries.
+ * @evidence contracts/portability.md#os-neutral-implementation Only the host-native separator is replaced with config-compatible slashes in the selected config, source and volume-root strings; this operation does not resolve paths or infer a filesystem root.
+ * @evidence contracts/performance.md#efficient-algorithms Three replaceAll operations visit the supplied path text before constructing a fixed-size object and arrays; fixed property count does not bound input string bytes or delegated compilation cost.
+ * @evidenceExclude contracts/performance.md#reuse-equivalent-work This projection coordinates no completed or in-flight producer; build and cache reuse remain with its caller.
+ * @evidenceExclude contracts/performance.md#bound-retention-and-release-resources A fresh returned object transfers to the caller and no descriptor, process, history or retained cache is acquired.
+ */
+export declare function singleRootProjectConfig(props: {
+    tsconfig: string;
+    source: string;
+    volumeRoot: string;
+    checked: boolean;
+}): {
+    extends: string;
+    compilerOptions: {
+        composite: boolean;
+        declaration: boolean;
+        declarationMap: boolean;
+        noEmitOnError?: boolean | undefined;
+        rootDir: string;
+    };
+    files: string[];
+    include: never[];
+    exclude: never[];
+};

package/lib/launcher/internal/singleRootProjectConfig.js

@@ -0,0 +1,39 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.singleRootProjectConfig = singleRootProjectConfig;
+const node_path_1 = __importDefault(require("node:path"));
+/**
+ * Project the single-root overlay that inherits the selected owning config.
+ * Explicit empty include/exclude lists displace inherited populations. Checked
+ * overlays preserve inherited noEmitOnError; unchecked overlays clear it. The
+ * caller supplies the already selected physical volume root and owns config
+ * placement, exclusive creation, parsing, compilation and cleanup.
+ *
+ * @evidence contracts/common.md#principled-implementation The overlay retains its owning config through extends, selects the exact source and clears inherited include/exclude populations without changing the checked lane's noEmitOnError policy.
+ * @evidence contracts/common.md#clear-and-simple-design One fresh JSON-compatible object supplies the existing fixed compiler overrides and selected path values to the production writer.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts Ordinary compiler config fields own selection; no compiler output, native root inference or read result is invented or intercepted.
+ * @evidence contracts/common.md#meaningful-documentation The native paragraph states list replacement, checked versus unchecked policy and the caller-owned filesystem/compiler boundaries.
+ * @evidence contracts/portability.md#os-neutral-implementation Only the host-native separator is replaced with config-compatible slashes in the selected config, source and volume-root strings; this operation does not resolve paths or infer a filesystem root.
+ * @evidence contracts/performance.md#efficient-algorithms Three replaceAll operations visit the supplied path text before constructing a fixed-size object and arrays; fixed property count does not bound input string bytes or delegated compilation cost.
+ * @evidenceExclude contracts/performance.md#reuse-equivalent-work This projection coordinates no completed or in-flight producer; build and cache reuse remain with its caller.
+ * @evidenceExclude contracts/performance.md#bound-retention-and-release-resources A fresh returned object transfers to the caller and no descriptor, process, history or retained cache is acquired.
+ */
+function singleRootProjectConfig(props) {
+    return {
+        extends: props.tsconfig.replaceAll(node_path_1.default.sep, "/"),
+        compilerOptions: {
+            composite: false,
+            declaration: false,
+            declarationMap: false,
+            ...(props.checked ? {} : { noEmitOnError: false }),
+            rootDir: props.volumeRoot.replaceAll(node_path_1.default.sep, "/"),
+        },
+        files: [props.source.replaceAll(node_path_1.default.sep, "/")],
+        include: [],
+        exclude: [],
+    };
+}
+//# sourceMappingURL=singleRootProjectConfig.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"singleRootProjectConfig.js","sourceRoot":"","sources":["../../../src/launcher/internal/singleRootProjectConfig.ts"],"names":[],"mappings":";;;;;;AAAA,0DAA6B;AAE7B;;;;;;;;;;;;;;;GAeG;AACH,iCAAwC,KAKvC;IACC,OAAO;QACL,OAAO,EAAE,KAAK,CAAC,QAAQ,CAAC,UAAU,CAAC,mBAAI,CAAC,GAAG,EAAE,GAAG,CAAC;QACjD,eAAe,EAAE;YACf,SAAS,EAAE,KAAK;YAChB,WAAW,EAAE,KAAK;YAClB,cAAc,EAAE,KAAK;YACrB,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,KAAK,EAAE,CAAC;YAClD,OAAO,EAAE,KAAK,CAAC,UAAU,CAAC,UAAU,CAAC,mBAAI,CAAC,GAAG,EAAE,GAAG,CAAC;SACpD;QACD,KAAK,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,UAAU,CAAC,mBAAI,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;QAC/C,OAAO,EAAE,EAAE;QACX,OAAO,EAAE,EAAE;KACZ,CAAC;AACJ,CAAC"}

package/lib/launcher/internal/ttscserver/ILSPPluginSelectionInputs.d.ts

@@ -0,0 +1,61 @@
+/**
+ * What a `ttscserver` session's plugin selection was loaded from, as the native
+ * host receives it in the plugin manifest (`selectionInputs`). Native startup
+ * and later input checks reject a changed recorded fingerprint or relevant
+ * source listing; this shape alone does not guarantee every external change
+ * will be observed or delivered to a running session.
+ *
+ * Both kinds of input travel by directory, each directory with the names of the
+ * files in it and the digest each had
+ * (`LSPProjectInputDigest.lspProjectInputFileDigest`). The descriptors' inputs
+ * can include many missing resolution candidates, and plugin sources can span
+ * many files. At construction the host indexes resolved directory identity once
+ * per directory rather than separately for every recorded basename; later
+ * checks still perform native identity and file observations. A source
+ * directory's listing is an input too, counted by the build's own rule: a
+ * residue file or a directory the build passes over changes nothing.
+ *
+ * @evidence contracts/common.md#principled-implementation Separate descriptor candidates and source-directory listings encode different invalidation meaning; digests preserve missing candidates while shared builder omission rules define which source entries can change selection.
+ * @evidence contracts/common.md#clear-and-simple-design Directory-to-basename maps match the native observer's unit of identity resolution; omission vocabulary travels as data rather than becoming a second independently maintained source policy.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts Recorded file state comes from the selection's actual inputs, and source filters are shared builder rules rather than consumer or fixture exceptions.
+ * @evidence contracts/common.md#meaningful-documentation The interface and member comments explain directory grouping, missing candidates and listing exclusions; documented members have blank source lines and tags are separated according to the documentation skill.
+ * @evidence contracts/portability.md#os-neutral-implementation Declared native directories and entry names travel separately so the native host resolves actual directory identity without replacing path spellings with an OS-wide case assumption.
+ * @evidenceExclude contracts/performance.md#bound-retention-and-release-resources A type declaration acquires and holds no runtime resource.
+ * @evidenceExclude contracts/performance.md#efficient-algorithms A type declaration chooses no processing strategy.
+ * @evidenceExclude contracts/performance.md#reuse-equivalent-work A type declaration computes nothing, so there is no work to share.
+ */
+export interface ILSPPluginSelectionInputs {
+    /**
+     * Every directory holding a non-deferred input the plugin load reported, with
+     * each recorded basename and digest: the project's config chain, the
+     * manifests plugin discovery reads, the descriptors, and what they resolved.
+     * Only those reported files count; the record does not discover undeclared
+     * external reads.
+     */
+    descriptorFiles: Record<string, Record<string, string>>;
+    /**
+     * Every plugin source directory an observer watches
+     * (`collectPluginSourceDirectories`), with the name of every file directly
+     * inside it that the build keys on (`collectPluginSourceFiles`) and its
+     * digest.
+     */
+    sourceFiles: Record<string, Record<string, string>>;
+    /**
+     * The names of files the build never keys on
+     * (`GoSourceInputs.OMITTED_SOURCE_FILE_NAMES`), whose appearance in a source
+     * directory changes nothing.
+     */
+    omittedNames: readonly string[];
+    /**
+     * The suffixes of files the build never keys on
+     * (`GoSourceInputs.OMITTED_SOURCE_FILE_SUFFIXES`), such as an editor's `~`
+     * backups.
+     */
+    omittedSuffixes: readonly string[];
+    /**
+     * The names of directories the build passes over
+     * (`GoSourceInputs.PRUNED_SOURCE_DIRECTORY_NAMES`), whose appearance changes
+     * nothing.
+     */
+    prunedDirectoryNames: readonly string[];
+}

package/lib/launcher/internal/ttscserver/ILSPPluginSelectionInputs.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=ILSPPluginSelectionInputs.js.map

package/lib/launcher/internal/ttscserver/ILSPPluginSelectionInputs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ILSPPluginSelectionInputs.js","sourceRoot":"","sources":["../../../../src/launcher/internal/ttscserver/ILSPPluginSelectionInputs.ts"],"names":[],"mappings":""}