ttsc 0.30.4 → 0.31.0

package/lib/compiler/internal/build/ResidentCheckWatchSession.js

@@ -0,0 +1,378 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ResidentCheckWatchSession = void 0;
+const node_fs_1 = __importDefault(require("node:fs"));
+const touchPluginCacheEntryInUse_1 = require("../../../plugin/internal/source/touchPluginCacheEntryInUse");
+const ResidentCheckProcess_1 = require("../ResidentCheckProcess");
+const BuildExecution_1 = require("./BuildExecution");
+const BuildTiming_1 = require("./BuildTiming");
+const NativePluginArguments_1 = require("./NativePluginArguments");
+const PassthroughFlags_1 = require("./PassthroughFlags");
+const TsgoArguments_1 = require("./TsgoArguments");
+const appendBuildOutput_1 = require("./appendBuildOutput");
+const bufferResidentCheckEntryRequests_1 = require("./bufferResidentCheckEntryRequests");
+const normalizeBuildOutput_1 = require("./normalizeBuildOutput");
+const planResidentCheckEntries_1 = require("./planResidentCheckEntries");
+const residentCheckRequest_1 = require("./residentCheckRequest");
+const takeResidentCheckEntryRequest_1 = require("./takeResidentCheckEntryRequest");
+/**
+ * Analysis-only watch coordinator.
+ *
+ * The selected project and compatible check-stage processes stay resident
+ * across ordinary source/data edits. A config, root-set, contributor, or plugin
+ * topology transition calls for a full reset before the next cycle. Emit and
+ * transform lanes can pass through the coordinator, but compatibility checks
+ * keep them on the established one-shot path without starting sidecars.
+ *
+ * The watch launcher must serialize cycles and use reload when invocation
+ * selection or startup environment changes. A session does not independently
+ * compare every option/environment field before reusing its cached context.
+ * `TTSC_WATCH_DEBUG_INPUTS` reports why selection is reset and the active
+ * sidecar count being retired, and distinguishes a failed resident transport.
+ *
+ * @evidence contracts/common.md#principled-implementation Stable invocation selection and serialized cycles let compatible analysis-only checks retain their Program; explicit reload and observed input-topology changes reset selection before another cycle.
+ * @evidence contracts/common.md#clear-and-simple-design The session owns selected execution, dependency snapshot, process identities and per-entry delivery buffers while shared BuildExecution owns one-shot phase and failure policy.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts Capability-aware residency has an actual transport-failure one-shot path, not a successful-result substitution; configuration positions remain distinct even when processes share a key.
+ * @evidence contracts/common.md#meaningful-documentation Native paragraphs state supported lanes, reset causes and the caller's serialization/stable-invocation premise; run and dispose document lifecycle effects.
+ * @evidence contracts/portability.md#os-neutral-implementation Native filesystem checks and cache touch helpers use selected binary paths; child creation delegates native executable/argv/environment handling to ResidentCheckProcess and BuildExecution.
+ * @evidence contracts/performance.md#efficient-algorithms Per-cycle command planning, key serialization and buffer unions process configured checks and pending path text; sorting/comparison bytes, native cache observations, subscribed input discovery and delegated checks add work. Snapshot comparison visits normalized strings and accumulated output can repeatedly copy earlier phase text.
+ * @evidence contracts/performance.md#reuse-equivalent-work Process keys include binary/name/argv/compiler payload, while stable invocation context and reload guard the remaining startup inputs; current input snapshots and change requests determine warm Program updates.
+ * @evidence contracts/performance.md#bound-retention-and-release-resources Reset clears active maps, execution and snapshots while retiring children and join promises remain separately retained. Unknown joins remain retained rejection and prevent replacement; delegated termination is not descendant settlement. Stable options bound active process keys by configured checks, but pending unique paths and repeated disposal promise chains have no independent historical ceiling.
+ */
+class ResidentCheckWatchSession {
+    execution;
+    /** Undelivered changes keyed by configured check position, not process key. */
+    pendingChanges = new Map();
+    /** Latest normalized dependency population, plus declared watch aliases. */
+    projectInputs;
+    /** Sidecars acquired for the stable invocation; reset releases every key. */
+    processes = new Map();
+    retiringProcesses = new Set();
+    retirement = Promise.resolve();
+    closed = false;
+    generation = 0;
+    /**
+     * Run one serialized watch cycle through the shared build/check policies.
+     * Options identifying the invocation and startup environment must remain
+     * stable until reload; callers must not run overlapping cycles.
+     *
+     * The first cycle, and any cycle after `change.reload`, resolves the project
+     * and plugins and starts resident check processes for compatible entries.
+     * Later cycles reuse them and forward `change` as an incremental request. A
+     * resident process that fails is retired and its entry falls back to the
+     * one-shot check for that cycle.
+     *
+     * @evidence contracts/common.md#principled-implementation Compatible no-emit check-only selection uses the same diagnostic/failure policy as one-shot execution; reload, missing binaries and changed normalized dependency topology cold-resolve the next execution.
+     * @evidence contracts/common.md#clear-and-simple-design The cycle separates setup/reuse, topology refresh, ordered checks and final diagnostics/timing, delegating each phase to its owning shared operation.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts Failed resident transport retires that process and uses the established real check command; the fallback neither drops forwarded compiler options nor converts a nonzero check into success.
+     * @evidence contracts/common.md#meaningful-documentation Native paragraphs document serialization, stable startup inputs, reload and failed-sidecar behavior instead of claiming arbitrary option changes are handled automatically.
+     * @evidence contracts/portability.md#os-neutral-implementation Native binary existence and cache freshness use filesystem helpers; all commands preserve selected cwd and use native process/environment abstractions without shell interpolation.
+     * @evidence contracts/performance.md#efficient-algorithms Warm cycles avoid project/plugin re-resolution until a missing binary or changed subscribed topology resets selection. Native existence/cache touches, optional onProjectInputs discovery, command/key construction, per-entry unions/sorts, delegated host work and output normalization/merging retain their actual entry/text/byte costs.
+     * @evidence contracts/performance.md#reuse-equivalent-work Selected context and capability-supported sidecars survive only stable invocation cycles; change requests update Programs, reload/topology transitions reset them, and effectful configured entries remain separately scheduled.
+     * @evidence contracts/performance.md#bound-retention-and-release-resources The session retains active sidecars and per-entry pending changes; transport failure retires its process and awaits actual close before fallback. Reset clears active state but not unknown retiring ownership or its rejection. Unconsumed path sets have no finite bound while an earlier entry repeatedly fails; child close does not certify descendants.
+     */
+    async run(options, change = {}) {
+        let generation = this.generation;
+        await this.retirement;
+        this.assertOpen(generation);
+        if (change.reload === true)
+            generation = await this.resetForRun("watch-reload");
+        const timing = BuildTiming_1.BuildTiming.createBuildTiming(options);
+        const projectFree = BuildExecution_1.BuildExecution.runProjectFreeTerminalFlag(options);
+        if (projectFree !== null) {
+            await this.resetForRun("terminal-flag");
+            return BuildTiming_1.BuildTiming.appendTimingOutput(projectFree, timing);
+        }
+        let execution = this.execution;
+        const reusedExecution = execution !== undefined;
+        let buildOptions;
+        if (execution === undefined) {
+            const setupStartedAt = process.hrtime.bigint();
+            execution = BuildExecution_1.BuildExecution.resolveExecutionContext(options);
+            const discoveryOptions = this.captureProjectInputs(options);
+            const prepared = BuildExecution_1.BuildExecution.prepareBuildExecution(discoveryOptions, timing, execution, setupStartedAt);
+            buildOptions = prepared.buildOptions;
+            if (prepared.result !== undefined) {
+                await this.resetForRun("preparation-result");
+                return BuildTiming_1.BuildTiming.appendTimingOutput(prepared.result, timing);
+            }
+            if (!residentCheckExecutionIsCompatible(buildOptions, execution)) {
+                await this.resetForRun("incompatible-execution");
+                return BuildTiming_1.BuildTiming.appendTimingOutput(BuildExecution_1.BuildExecution.runPreparedBuild(options, timing, execution, buildOptions), timing);
+            }
+            this.execution = execution;
+        }
+        else {
+            // The session keeps running the plugin binaries it resolved without
+            // resolving them again, so it records each cycle's use in their cache
+            // entries, and a binary the cache removed anyway sends the session back
+            // through resolution, which builds it again, rather than failing a
+            // sidecar respawn.
+            if (execution.nativePlugins.some((plugin) => !node_fs_1.default.existsSync(plugin.binary))) {
+                await this.resetForRun("missing-plugin-binary");
+                return this.run(options);
+            }
+            for (const plugin of execution.nativePlugins)
+                (0, touchPluginCacheEntryInUse_1.touchPluginCacheEntryInUse)(plugin.binary);
+            buildOptions = BuildExecution_1.BuildExecution.applyProjectNoEmit(options, execution);
+        }
+        if (reusedExecution &&
+            this.refreshProjectInputTopology(options, execution)) {
+            await this.resetForRun("project-input-topology");
+            return this.run(options);
+        }
+        const checked = await this.runCheckPlugins(buildOptions, execution, timing, change, generation);
+        this.assertOpen(generation);
+        let result;
+        if (checked.status !== 0) {
+            result = BuildExecution_1.BuildExecution.appendTypeScriptDiagnosticsAfterPluginFailure(checked, buildOptions, execution);
+        }
+        else if (BuildExecution_1.BuildExecution.checkPluginsReportTypeScriptDiagnostics(execution.nativePlugins)) {
+            result = checked;
+        }
+        else {
+            result = (0, appendBuildOutput_1.appendBuildOutput)(checked, BuildExecution_1.BuildExecution.runTsgo(execution, ["--noEmit"], buildOptions));
+        }
+        return BuildTiming_1.BuildTiming.appendTimingOutput(result, timing);
+    }
+    /**
+     * Request termination of every retained sidecar and discard session state.
+     * This initiates retirement synchronously; a later run awaits actual child
+     * close before selecting a fresh session. Use close for terminal, awaitable
+     * release. Child termination and queued-request rejection belong to the
+     * process owner.
+     *
+     * @evidence contracts/common.md#principled-implementation Reset visits each owned process before clearing its map and discards pending changes, dependency snapshot and selected execution together.
+     * @evidence contracts/common.md#clear-and-simple-design Disposal uses the same reset boundary as topology transitions, keeping resource and cached-selection release in one place.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts Release calls the supported child disposal API rather than replacing process methods or marking still-owned resources as successful check results.
+     * @evidence contracts/common.md#meaningful-documentation Native prose distinguishes synchronous initiation, joined reuse and terminal close.
+     * @evidence contracts/portability.md#os-neutral-implementation Platform-specific child termination is delegated to ResidentCheckProcess; this coordinator does not assume a POSIX signal guarantees process-tree exit on every OS.
+     * @evidence contracts/performance.md#efficient-algorithms Reset deduplicates active and retiring children, traverses that population and collects previous/current promise outcomes; delegated disposal can reject queued child requests. Maps clear without a separate path-by-path pending-request scan, while debug serialization and callbacks add their own costs.
+     *
+     * @evidenceExclude contracts/performance.md#reuse-equivalent-work Disposal invalidates shared execution ownership rather than establishing reusable computation.
+     *
+     * @evidence contracts/performance.md#bound-retention-and-release-resources Every retained process receives retirement before map ownership is cleared; known failed exits can be replaced only after actual close, while unknown joins reject. Buffers and selected state release immediately and the generation rejects late work.
+     */
+    dispose() {
+        if (this.closed)
+            return;
+        void this.reset("dispose");
+    }
+    /**
+     * Terminally close this session and await every retained or retiring child.
+     * Unlike dispose, later runs are rejected and cannot start a fallback.
+     *
+     * @evidence contracts/common.md#principled-implementation Terminal admission closes before owned processes are retired, and completion awaits their actual child-close outcomes.
+     * @evidence contracts/common.md#clear-and-simple-design The same reset boundary owns reusable disposal and terminal closure, with a separate admission flag for their different public contracts.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts Closing forbids subsequent process acquisition or fallback and retains failed or unknown retirement as rejection.
+     * @evidence contracts/common.md#meaningful-documentation Native prose distinguishes terminal closure from the compatible reusable dispose operation.
+     * @evidence contracts/portability.md#os-neutral-implementation Native EOF and close validation belong to each process owner; the session joins outcomes without assuming POSIX signal behavior on Windows.
+     * @evidence contracts/performance.md#efficient-algorithms Terminal reset deduplicates active and retiring children and observes their joins alongside the previous retirement promise. Outcome/failure collection and delegated queued-request disposal contribute work; unknown joins can reject at the child owner's event-loop deadline rather than becoming successful closes.
+     * @evidence contracts/performance.md#reuse-equivalent-work Repeated terminal closes share the retirement promise, while subsequent computation is forbidden by terminal admission.
+     * @evidence contracts/performance.md#bound-retention-and-release-resources Closing releases maps and selected state immediately but retains join promises until every actual child outcome settles; failed or unknown ownership remains rejection.
+     */
+    close() {
+        if (!this.closed) {
+            this.closed = true;
+            void this.reset("close");
+        }
+        return this.retirement;
+    }
+    assertOpen(generation = this.generation) {
+        if (this.closed)
+            throw new Error("ttsc: resident check watch session closed");
+        if (generation !== this.generation)
+            throw new Error("ttsc: resident check watch cycle retired");
+    }
+    async resetForRun(reason) {
+        const retirement = this.reset(reason);
+        const generation = this.generation;
+        await retirement;
+        this.assertOpen(generation);
+        return generation;
+    }
+    /** Release selection immediately and join its children before replacement. */
+    reset(reason) {
+        ++this.generation;
+        if (process.env.TTSC_WATCH_DEBUG_INPUTS) {
+            process.stdout.write(`[ttsc:debug] resident reset ${JSON.stringify({
+                reason,
+                selectedExecution: this.execution !== undefined,
+                processes: this.processes.size,
+            })}\n`);
+        }
+        const previous = this.retirement;
+        const children = new Set([
+            ...this.processes.values(),
+            ...this.retiringProcesses,
+        ]);
+        const retiring = [...children].map((child) => {
+            const joined = this.trackRetirement(child);
+            return this.closed ? child.close() : joined;
+        });
+        this.retirement = Promise.allSettled([previous, ...retiring]).then((results) => {
+            const errors = results.flatMap((result) => result.status === "rejected" ? [result.reason] : []);
+            if (errors.length !== 0)
+                throw new AggregateError(errors, "ttsc: resident check retirement failed");
+        });
+        void this.retirement.catch(() => { });
+        this.processes.clear();
+        this.pendingChanges.clear();
+        this.execution = undefined;
+        this.projectInputs = undefined;
+        return this.retirement;
+    }
+    trackRetirement(child) {
+        this.retiringProcesses.add(child);
+        child.dispose();
+        const joined = child.waitForExit();
+        void joined.then(() => this.retiringProcesses.delete(child), () => { });
+        return joined;
+    }
+    /** Capture discoveries only when the caller actually subscribes to them. */
+    captureProjectInputs(options) {
+        const onProjectInputs = options.onProjectInputs;
+        if (onProjectInputs === undefined)
+            return options;
+        return {
+            ...options,
+            onProjectInputs: (snapshot) => {
+                this.projectInputs = snapshot;
+                onProjectInputs(snapshot);
+            },
+        };
+    }
+    /**
+     * Refresh normalized Program topology while always publishing declared alias
+     * updates to the watcher, even when physical dependency identity is
+     * unchanged.
+     */
+    refreshProjectInputTopology(options, execution) {
+        if (options.onProjectInputs === undefined)
+            return false;
+        const next = BuildExecution_1.BuildExecution.discoverNativeProjectInputs(options, execution);
+        const changed = this.projectInputs !== undefined &&
+            !projectInputSnapshotsEqual(this.projectInputs, next);
+        this.projectInputs = next;
+        options.onProjectInputs(next);
+        return changed;
+    }
+    /**
+     * Deliver changes in configured order, retaining later entries' undelivered
+     * requests after an earlier failure. Process sharing never shares away a
+     * configured check invocation.
+     */
+    async runCheckPlugins(options, execution, timing, change, generation) {
+        let out = {
+            diagnostics: [],
+            status: 0,
+            stderr: "",
+            stdout: "",
+        };
+        const tsgoArgs = TsgoArguments_1.TsgoArguments.createNativeTsgoArgs(options);
+        const checks = (0, planResidentCheckEntries_1.planResidentCheckEntries)(execution.nativePlugins, (plugin) => NativePluginArguments_1.NativePluginArguments.createNativeCheckArgs(execution, options, plugin), tsgoArgs, execution.compilerSelection.compilerArgsCwd);
+        const request = (0, residentCheckRequest_1.residentCheckRequest)(change, execution.projectRoot);
+        // Buffer the cycle for every resident plugin before running any of them.
+        // An earlier plugin may fail and short-circuit diagnostics, but a later
+        // sidecar must still receive every filesystem transition when it resumes.
+        (0, bufferResidentCheckEntryRequests_1.bufferResidentCheckEntryRequests)(this.pendingChanges, checks, request);
+        for (const { args, entryIndex, key, plugin } of checks) {
+            this.assertOpen(generation);
+            let result;
+            if (key === undefined) {
+                result = BuildExecution_1.BuildExecution.runNativePluginCommand(plugin, args, options, execution, "ttsc.check", timing, `ttsc check plugin ${plugin.name} time`, tsgoArgs);
+            }
+            else {
+                const startedAt = process.hrtime.bigint();
+                let resident = this.processes.get(key);
+                if (resident === undefined) {
+                    resident = new ResidentCheckProcess_1.ResidentCheckProcess({
+                        args: ["check-serve", ...args.slice(1)],
+                        binary: plugin.binary,
+                        cwd: execution.projectRoot,
+                        env: BuildExecution_1.BuildExecution.nativePluginEnv(options.env, execution, plugin, tsgoArgs),
+                    });
+                    this.processes.set(key, resident);
+                }
+                try {
+                    const reply = await resident.request((0, takeResidentCheckEntryRequest_1.takeResidentCheckEntryRequest)(this.pendingChanges, entryIndex));
+                    result = (0, normalizeBuildOutput_1.normalizeBuildOutput)({
+                        status: reply.status,
+                        stderr: reply.stderr,
+                        stdout: reply.stdout,
+                    }, execution.projectRoot);
+                }
+                catch {
+                    if (process.env.TTSC_WATCH_DEBUG_INPUTS) {
+                        process.stdout.write(`[ttsc:debug] resident transport failed ${JSON.stringify({
+                            entryIndex,
+                            plugin: plugin.name,
+                        })}\n`);
+                    }
+                    resident.dispose();
+                    this.processes.delete(key);
+                    const previousRetirement = this.retirement;
+                    this.retirement = Promise.allSettled([
+                        previousRetirement,
+                        this.trackRetirement(resident),
+                    ]).then((results) => {
+                        const failed = results.find((result) => result.status === "rejected");
+                        if (failed?.status === "rejected")
+                            throw failed.reason;
+                    });
+                    void this.retirement.catch(() => { });
+                    await this.retirement;
+                    this.assertOpen(generation);
+                    // The one-shot fallback observes the complete current filesystem,
+                    // and a later sidecar starts cold, so neither needs old deltas.
+                    // A capability-aware host may still disappear or violate framing.
+                    // Preserve correctness by running the established one-shot command
+                    // for this cycle; the next cycle gets one clean respawn attempt. It
+                    // carries the same forwarded compiler flags the resident host was
+                    // started with: a failed transport is not a request to drop them.
+                    result = BuildExecution_1.BuildExecution.runNativePluginCommand(plugin, args, options, execution, "ttsc.check", { ...timing, enabled: false }, "", tsgoArgs);
+                }
+                BuildTiming_1.BuildTiming.recordTiming(timing, `ttsc check plugin ${plugin.name} time`, startedAt);
+            }
+            out = (0, appendBuildOutput_1.appendBuildOutput)(out, result);
+            if (result.status !== 0)
+                return out;
+        }
+        return out;
+    }
+}
+exports.ResidentCheckWatchSession = ResidentCheckWatchSession;
+/**
+ * Compare canonical physical topology; alias watch spellings refresh
+ * separately.
+ */
+function projectInputSnapshotsEqual(left, right) {
+    const leftReloadFiles = left.reloadFiles ?? [];
+    const rightReloadFiles = right.reloadFiles ?? [];
+    const leftReloadDirectories = left.reloadDirectories ?? [];
+    const rightReloadDirectories = right.reloadDirectories ?? [];
+    return (left.root === right.root &&
+        left.files.length === right.files.length &&
+        left.globs.length === right.globs.length &&
+        leftReloadDirectories.length === rightReloadDirectories.length &&
+        leftReloadFiles.length === rightReloadFiles.length &&
+        left.files.every((value, index) => value === right.files[index]) &&
+        left.globs.every((value, index) => value === right.globs[index]) &&
+        leftReloadDirectories.every((value, index) => value === rightReloadDirectories[index]) &&
+        leftReloadFiles.every((value, index) => value === rightReloadFiles[index]));
+}
+/**
+ * Residency serves analysis-only check stages without fix/format/terminal
+ * effects.
+ */
+function residentCheckExecutionIsCompatible(options, execution) {
+    return (options.emit === false &&
+        options.fix !== true &&
+        options.format !== true &&
+        PassthroughFlags_1.PassthroughFlags.forwardsTerminalTsgoFlag(options) === false &&
+        execution.nativePlugins.every((plugin) => plugin.stage === "check"));
+}
+//# sourceMappingURL=ResidentCheckWatchSession.js.map

package/lib/compiler/internal/build/ResidentCheckWatchSession.js.map

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

package/lib/compiler/internal/build/RunBuildOptions.d.ts

@@ -0,0 +1,130 @@
+import type { ITtscParsedProjectConfig } from "../../../structures/internal/ITtscParsedProjectConfig";
+import type { ITtscProjectInputSnapshot } from "../../../structures/internal/ITtscProjectInputSnapshot";
+import type { TtscBuildOptions } from "../../../structures/internal/TtscBuildOptions";
+/**
+ * Options of one {@link runBuild} call: the public build options plus the knobs
+ * only ttsc's own lanes set (ttsx's private runtime builds, single-file emit,
+ * watch).
+ *
+ * @evidence contracts/common.md#principled-implementation Public build selection is intersected with internal lane controls, preserving optional defaults while distinguishing diagnostic gating, compiler-output isolation and watch callbacks.
+ * @evidence contracts/common.md#clear-and-simple-design Lane-specific decisions are explicit options on the shared build boundary rather than hidden global switches or duplicated compiler APIs.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts Internal controls express supported runtime/watch requirements; source-map and inferred-root exceptions are documented lane policies, not test-specific escape flags.
+ * @evidence contracts/common.md#meaningful-documentation Native member paragraphs explain ownership, optional-state effects and the rootDir premise, with blank lines separating documented properties.
+ * @evidence contracts/portability.md#os-neutral-implementation The type carries native private-output/project selection and filesystem input callbacks without embedding slash, drive or case assumptions; process/path adapters interpret those values.
+ * @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 type RunBuildOptions = TtscBuildOptions & {
+    /**
+     * Skip the independent direct-compiler type-check gate and the added
+     * `--noEmitOnError` guard. Configured plugin checks and native hosts still
+     * apply their own diagnostic policy. It does not erase returned status or
+     * make failed plugin checks successful. The ttsx dependency lane may judge
+     * usable emitted output under its own policy and sets it because the entry
+     * project's check is the type gate and a source-shipping dependency's own
+     * config must not fail the run.
+     */
+    skipDiagnosticsCheck?: boolean;
+    /**
+     * Request `--listEmittedFiles` when the user did not ask for paths. Later
+     * forwarded assignments can still override this internal default, and actual
+     * producer output determines what is returned. Callers locating one emitted
+     * file (ttsx, single-file emit) set it.
+     */
+    forceListEmittedFiles?: boolean;
+    /**
+     * Request the selected emitting producer's output-to-source provenance.
+     * Native hosts must declare support; the external compiler adapter admits
+     * only its documented layout and stable-observation subset. Missing, unknown
+     * or ambiguous ownership stays explicit for a routing consumer to reject.
+     *
+     * This request must not change compiler selection, semantic options,
+     * diagnostic policy or which files are emitted. It applies to the emitting
+     * phase, not earlier checks or terminal/format operations without emission.
+     */
+    forceEmitProvenance?: boolean;
+    /**
+     * Apply final compiler destination overrides for this private directory. This
+     * does not sandbox arbitrary plugin, cache or external process writes.
+     */
+    isolateOutputsTo?: string;
+    /**
+     * API-owned destinations preserving separate declaration and bundle output.
+     * Every specified path belongs to the API temporary lifetime. An absent
+     * build-info override means the project has no incremental state to
+     * relocate.
+     */
+    privateOutputDestinations?: {
+        /** Private JavaScript directory, or null for a bundle-only layout. */
+        outDir: string | null;
+        /**
+         * Private separate declaration directory; null keeps declarations beside
+         * JS.
+         */
+        declarationDir: string | null;
+        /** Private bundle filename; null retains per-source emission. */
+        outFile: string | null;
+        /** Explicit private incremental state when this project can produce it. */
+        tsBuildInfoFile?: string;
+        /** Separate recovery/check state, which is not an emitted API artifact. */
+        diagnosticsTsBuildInfoFile?: string;
+    };
+    /**
+     * Hand tsgo the `rootDir` it would otherwise infer, for a build whose
+     * `outDir` this process injected rather than the project declaring it.
+     *
+     * Tsgo answers an inferred common source directory with TS5011 the moment an
+     * `outDir` is in play, so injecting one turns a project that declares no
+     * output at all — the `noEmit` check-only shape `tsgo`, `ttsc`, and `ttsc
+     * --emit` all accept — into one that must configure the layout of output the
+     * user never asked for and never sees.
+     *
+     * Without a declared rootDir, ordinary runtime output uses the native volume
+     * root instead of adding the compiler's config-directory containment to a
+     * check-only project. Composite projects retain their config root. This is
+     * private output layout, not inference of source membership or physical alias
+     * equivalence; emitted-source provenance remains authoritative.
+     *
+     * Without a runtime-selected privateEmitRootDir, ignored when the project
+     * declares rootDir. A supplied runtime root already represents effective
+     * declared/forwarded root policy and is replayed before user arguments.
+     *
+     * Never set for a user-supplied `--outDir`. That outDir is the user's own
+     * request, and TS5011 is then tsgo's genuine answer to it.
+     */
+    pinInferredRootDir?: boolean;
+    /**
+     * Runtime-selected private output root, after the owning runtime has read
+     * effective compiler options. Passed only with pinInferredRootDir; argv
+     * replay still puts user assignments afterward. This internal layout value
+     * retains the compiler input spelling, before physical resolution for served
+     * output lookup. These roots share relative layout, not necessarily absolute
+     * spelling. It introduces no public flag or replacement producer.
+     */
+    privateEmitRootDir?: string;
+    /**
+     * Receives selected native-plugin source roots after the project resolves.
+     * The watch launcher uses these roots to invalidate a sidecar when its Go
+     * implementation changes between rebuilds.
+     */
+    onWatchInputs?: (inputs: readonly string[]) => void;
+    /**
+     * Receives the reconciled project-rule filesystem dependency snapshot. Called
+     * when this internal callback is supplied, normally by watch launchers;
+     * ordinary calls without the callback do not probe the optional sidecar
+     * command.
+     */
+    onProjectInputs?: (inputs: ITtscProjectInputSnapshot) => void;
+    /**
+     * Request an external source map in an emitting direct tsgo lane even when
+     * the project configures none. Later forwarded sourceMap assignments can
+     * override this default. Ttsx runtime builds use it to request a map for
+     * inlining under the source URL. Applied only to the plain tsgo emit — never
+     * forwarded to a native plugin host, whose own emit honours the project's
+     * `sourceMap` setting.
+     */
+    forceRuntimeSourceMap?: boolean;
+    /** Retain an already selected project's lexical identity across API lanes. */
+    resolvedProject?: ITtscParsedProjectConfig;
+};

package/lib/compiler/internal/build/RunBuildOptions.js

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

package/lib/compiler/internal/build/RunBuildOptions.js.map

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