ttsc 0.30.3 → 0.31.0

package/lib/compiler/internal/PrivateCompilerOutput.js

@@ -0,0 +1,245 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PrivateCompilerOutput = void 0;
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_path_1 = __importDefault(require("node:path"));
+const privateRuntimeRootDir_1 = require("./build/privateRuntimeRootDir");
+const isOutsideRelativePath_1 = require("./isOutsideRelativePath");
+/**
+ * Compiler destinations and artifact translation for a single in-memory API
+ * request. Native options retain distinct JavaScript, declaration, bundle and
+ * incremental coordinates while all actual writes belong to one private tree.
+ *
+ * @evidence contracts/common.md#principled-implementation Destination translation and returned-artifact translation share one inverse mapping, preserving original public paths while native writes use private paths.
+ * @evidence contracts/common.md#clear-and-simple-design This namespace groups one API output policy; shared build execution consumes its destination record without owning API artifact keys.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts Compiler-supported destinations are used instead of foreign filesystem interception or deleting caller artifacts after a write.
+ * @evidence contracts/common.md#meaningful-documentation Native prose distinguishes private actual writes from public artifact locations; operation comments document relative map and incremental path ownership.
+ * @evidenceExclude contracts/portability.md#os-neutral-implementation The namespace groups operations; its path-owning members document the native boundary.
+ * @evidenceExclude contracts/performance.md#efficient-algorithms The namespace chooses no processing strategy independent of its members.
+ * @evidenceExclude contracts/performance.md#reuse-equivalent-work The namespace retains no shared computation.
+ * @evidenceExclude contracts/performance.md#bound-retention-and-release-resources The API call owns the private directory lifetime.
+ */
+var PrivateCompilerOutput;
+(function (PrivateCompilerOutput) {
+    /**
+     * Relocate each compiler destination independently. Directory mappings retain
+     * the compiler's per-source layout; exact mappings keep bundle and
+     * incremental names independent of that layout. A private explicit build-info
+     * path avoids inferred paths above outDir for deeply nested rootDir values.
+     * Independent checks use another state file so diagnostic recovery cannot
+     * overwrite or masquerade as an emitted API artifact. Only a newly added
+     * outDir needs private root pinning. Relocating a configured outDir retains
+     * native inferred layout and its configuration diagnostics.
+     *
+     * @evidence contracts/common.md#principled-implementation Separate native destinations have inverse mappings to original artifact locations. Only originally source-adjacent emission receives root pinning; configured outDir retains native inferred layout and diagnostics. Inferred state follows pinned outputpaths.GetBuildInfoFileName config/rootDir/outDir rules; explicit private state prevents upward escapes and independent checks use a separate non-artifact destination.
+     * @evidence contracts/common.md#clear-and-simple-design One request-local mapping joins destination selection and artifact translation, preserving bundle/declaration distinctions at the API boundary.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts Output destination options preserve incremental checking and separate bundle/declaration output instead of disabling them or cleaning caller paths after publication.
+     * @evidence contracts/common.md#meaningful-documentation Native prose explains path ownership, independent output kinds and why inferred incremental metadata needs an explicit private location.
+     * @evidence contracts/portability.md#os-neutral-implementation Node path resolution and relative paths preserve native volume boundaries and separators; protocol text normalizes host separators only.
+     * @evidence contracts/performance.md#efficient-algorithms At most four destination mappings are allocated. Native path resolution, root-relative inference and each inverse lookup operate on a bounded number of path strings and cost their actual text lengths; no caller tree is traversed.
+     * @evidenceExclude contracts/performance.md#reuse-equivalent-work Each request observes new compiler input and owns its output; no cross-request result cache is introduced.
+     * @evidenceExclude contracts/performance.md#bound-retention-and-release-resources Mapping and returned text are request-local data; compileProjectInMemory owns acquisition and finally removal of the private tree.
+     */
+    function create(project, directory) {
+        const options = project.compilerOptions;
+        const mappings = [];
+        const relocate = (name, original, kind) => {
+            const privatePath = node_path_1.default.join(directory, name, ...(kind === "directory" ? [] : [node_path_1.default.basename(original)]));
+            mappings.push({ privatePath, originalPath: original, kind });
+            return privatePath;
+        };
+        const outFile = typeof options.outFile === "string" ? options.outFile : undefined;
+        const sourceRoot = (0, privateRuntimeRootDir_1.privateRuntimeRootDir)(project.root, options.rootDir, options.composite);
+        const destinations = {
+            outDir: outFile !== undefined && options.outDir === undefined
+                ? null
+                : relocate("javascript", options.outDir ?? sourceRoot, "directory"),
+            declarationDir: typeof options.declarationDir === "string"
+                ? relocate("declarations", options.declarationDir, "directory")
+                : null,
+            outFile: outFile !== undefined ? relocate("bundle", outFile, "bundle") : null,
+        };
+        if (options.incremental === true ||
+            options.composite === true ||
+            typeof options.tsBuildInfoFile === "string") {
+            let original = typeof options.tsBuildInfoFile === "string"
+                ? options.tsBuildInfoFile
+                : undefined;
+            if (original === undefined) {
+                const configStem = removeCompilerExtension(project.path);
+                original =
+                    options.outDir !== undefined
+                        ? node_path_1.default.resolve(options.outDir, typeof options.rootDir === "string"
+                            ? node_path_1.default.relative(options.rootDir, configStem)
+                            : node_path_1.default.basename(configStem)) + ".tsbuildinfo"
+                        : configStem + ".tsbuildinfo";
+            }
+            destinations.tsBuildInfoFile = relocate("state", original, "file");
+            destinations.diagnosticsTsBuildInfoFile = node_path_1.default.join(directory, "diagnostics", "state.tsbuildinfo");
+        }
+        return {
+            destinations,
+            pinInferredRootDir: options.outDir === undefined && destinations.outDir !== null,
+            originalPath(file) {
+                for (const mapping of mappings) {
+                    if (mapping.kind === "file") {
+                        if (file === mapping.privatePath)
+                            return mapping.originalPath;
+                    }
+                    else if (mapping.kind === "bundle") {
+                        if (file === mapping.privatePath)
+                            return mapping.originalPath;
+                        const privateStem = removeCompilerExtension(mapping.privatePath);
+                        if (file.startsWith(privateStem + "."))
+                            return (removeCompilerExtension(mapping.originalPath) +
+                                file.slice(privateStem.length));
+                    }
+                    else {
+                        const relative = node_path_1.default.relative(mapping.privatePath, file);
+                        if (!(0, isOutsideRelativePath_1.isOutsideRelativePath)(relative))
+                            return node_path_1.default.join(mapping.originalPath, relative);
+                    }
+                }
+                return file;
+            },
+        };
+    }
+    PrivateCompilerOutput.create = create;
+    /**
+     * Return all captured compiler artifacts at their original API keys. Source
+     * maps without compiler-owned sourceRoot/mapRoot need their relative sources
+     * re-based from the private destination to the original destination. Explicit
+     * roots already give sources their independent compiler-defined base. Only
+     * the final compiler map trailer is translated; similar authored text inside
+     * a multiline literal remains source text.
+     *
+     * Build information is identified by its selected path, including arbitrary
+     * extensions. Recovery-only state is excluded by path; actual emitted state
+     * remains an artifact even when the compiler also reports errors.
+     *
+     * @evidence contracts/common.md#principled-implementation Inverse destination mapping restores original keys as own data properties, including names inherited from Object.prototype. Maps without explicit sourceRoot/mapRoot rebase source paths through their private and original directories, preserving remote URLs and the pinned native generator's raw file-URL convention for different Windows roots without percent decoding filename data. Build-info source/option paths rebase similarly while special library names remain compiler identifiers. Only the separate check/recovery state is omitted; actual emission state and partial outputs remain captured.
+     * @evidence contracts/common.md#clear-and-simple-design One request-local mapping joins destination selection and artifact translation, preserving bundle/declaration distinctions at the API boundary.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts Output destination options preserve incremental checking and separate bundle/declaration output instead of disabling them or cleaning caller paths after publication.
+     * @evidence contracts/common.md#meaningful-documentation Native prose explains path ownership, independent output kinds and why inferred incremental metadata needs an explicit private location.
+     * @evidence contracts/portability.md#os-neutral-implementation Node path resolution and relative paths preserve native volume boundaries and separators; protocol text normalizes host separators only.
+     * @evidence contracts/performance.md#efficient-algorithms The iterative walk visits E private directory entries, sorts F file paths with path-text comparison costs and reads B emitted bytes once. Map/state JSON parsing, translation and serialization cost their actual text and record sizes; retained output grows with B and the path keys.
+     * @evidenceExclude contracts/performance.md#reuse-equivalent-work Each request observes new compiler input and owns its output; no cross-request result cache is introduced.
+     * @evidenceExclude contracts/performance.md#bound-retention-and-release-resources Mapping and returned text are request-local data; compileProjectInMemory owns acquisition and finally removal of the private tree.
+     */
+    function read(project, directory, originalPath, buildInfoFile, diagnosticState) {
+        const output = {};
+        for (const file of listFiles(directory)) {
+            if (file === diagnosticState)
+                continue;
+            const original = originalPath(file);
+            const relative = node_path_1.default.relative(project.root, original);
+            const key = pathToKey((0, isOutsideRelativePath_1.isOutsideRelativePath)(relative) ? original : relative);
+            let text = node_fs_1.default.readFileSync(file, "utf8");
+            const rebaseMap = (value) => {
+                const map = JSON.parse(value);
+                if (!project.compilerOptions.sourceRoot &&
+                    !project.compilerOptions.mapRoot &&
+                    Array.isArray(map.sources))
+                    map.sources = map.sources.map((source) => {
+                        if (/^[a-z][a-z0-9+.-]*:/i.test(source) &&
+                            !source.startsWith("file:"))
+                            return source;
+                        // Native tspath.GetRelativePathToDirectoryOrUrl prefixes disk paths
+                        // without URL encoding; percent escapes remain literal filename data.
+                        const nativeFile = source.startsWith("file:///") &&
+                            /^[A-Za-z]:\//.test(source.slice(8))
+                            ? source.slice(8)
+                            : source.startsWith("file://")
+                                ? source.slice(7)
+                                : undefined;
+                        const resolved = nativeFile ?? node_path_1.default.resolve(node_path_1.default.dirname(file), source);
+                        const relative = node_path_1.default.relative(node_path_1.default.dirname(original), resolved);
+                        const normalized = pathToKey(relative);
+                        return node_path_1.default.isAbsolute(relative)
+                            ? (normalized.startsWith("/") ? "file://" : "file:///") +
+                                normalized
+                            : normalized;
+                    });
+                return JSON.stringify(map);
+            };
+            if (file !== buildInfoFile && file.endsWith(".map"))
+                text = rebaseMap(text);
+            else if (file !== buildInfoFile) {
+                text = text.replace(/((?:^|\n)\/\/#[ \t]*sourceMappingURL=data:application\/json;base64,)([^\s]+)(?=\s*$)/, (_match, prefix, payload) => prefix +
+                    Buffer.from(rebaseMap(Buffer.from(payload, "base64").toString("utf8"))).toString("base64"));
+                if (project.compilerOptions.mapRoot)
+                    text = text.replace(/((?:^|\n)\/\/#[ \t]*sourceMappingURL=)([^\s]+)(?=\s*$)/, (match, prefix, url) => {
+                        if (/^(?:[a-z]+:|\/)/i.test(url))
+                            return match;
+                        return (prefix +
+                            encodeURI(pathToKey(node_path_1.default.relative(node_path_1.default.dirname(original), node_path_1.default.resolve(node_path_1.default.dirname(file), decodeURI(url))))));
+                    });
+            }
+            else {
+                const state = JSON.parse(text);
+                const rebase = (value) => pathToKey(node_path_1.default.relative(node_path_1.default.dirname(original), originalPath(node_path_1.default.resolve(node_path_1.default.dirname(file), value))));
+                if (Array.isArray(state.fileNames))
+                    state.fileNames = state.fileNames.map((file) => /^lib\.[^/\\]+\.d\.ts$/.test(file) ? file : rebase(file));
+                if (state.options !== undefined)
+                    for (const name of [
+                        "outDir",
+                        "outFile",
+                        "declarationDir",
+                        "tsBuildInfoFile",
+                        "rootDir",
+                    ])
+                        if (typeof state.options[name] === "string") {
+                            if (typeof project.compilerOptions[name] !== "string")
+                                delete state.options[name];
+                            else
+                                state.options[name] = rebase(state.options[name]);
+                        }
+                text = JSON.stringify(state);
+            }
+            Object.defineProperty(output, key, {
+                value: text,
+                enumerable: true,
+                configurable: true,
+                writable: true,
+            });
+        }
+        return output;
+    }
+    PrivateCompilerOutput.read = read;
+    /**
+     * Match pinned tspath.RemoveFileExtension, including compound declaration
+     * suffixes.
+     */
+    function removeCompilerExtension(file) {
+        return file.replace(/\.(?:d\.(?:ts|mts|cts)|mjs|mts|cjs|cts|ts|js|tsx|jsx|json)$/, "");
+    }
+    /** Recursively list all files under `directory`, sorted for stable output. */
+    function listFiles(directory) {
+        const out = [];
+        const pending = [directory];
+        while (pending.length !== 0) {
+            const current = pending.pop();
+            for (const entry of node_fs_1.default.readdirSync(current, { withFileTypes: true })) {
+                const location = node_path_1.default.join(current, entry.name);
+                if (entry.isDirectory()) {
+                    pending.push(location);
+                }
+                else if (entry.isFile()) {
+                    out.push(location);
+                }
+            }
+        }
+        return out.sort();
+    }
+    /**
+     * Convert native separators, while retaining literal POSIX backslashes, for
+     * output keys.
+     */
+    function pathToKey(file) {
+        return file.replaceAll(node_path_1.default.sep, "/");
+    }
+})(PrivateCompilerOutput || (exports.PrivateCompilerOutput = PrivateCompilerOutput = {}));
+//# sourceMappingURL=PrivateCompilerOutput.js.map

package/lib/compiler/internal/PrivateCompilerOutput.js.map

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

package/lib/compiler/internal/ResidentCheckProcess.d.ts

@@ -0,0 +1,127 @@
+import type { ResidentCheckProcessOptions } from "./ResidentCheckProcessOptions";
+import type { ResidentCheckRequest } from "./ResidentCheckRequest";
+import type { ResidentCheckResult } from "./ResidentCheckResult";
+/**
+ * FIFO JSON-line client for a check-stage `check-serve` sidecar.
+ *
+ * A watch session serializes cycles, but the client still queues replies so a
+ * caller cannot accidentally pair a late response with the next request. Any
+ * framing failure retires the process; the launcher can fall back to an
+ * ordinary one-shot command after joining the original child. An unjoined child
+ * cannot authorize that replacement.
+ *
+ * The caller owns disposal. Requests have no deadline, and outstanding request
+ * count and reply-line size are not capped; a slow live check remains pending.
+ * Retirement ends stdin and waits for actual close. A one-second grace period
+ * starts after stdin finishes, followed by forced termination and a one-second
+ * join deadline. Pending stdin writes have a one-second flush deadline once the
+ * retiring call stack yields. An unjoined deadline releases this client's
+ * pipes, request listeners, timers and event-loop process reference while
+ * keeping joining failed; the client object still holds its ChildProcess. It
+ * neither kills unrelated descendants nor certifies their termination. A forced
+ * or unjoined process is not a graceful shutdown. These delays are event-loop
+ * timer policies, not hard elapsed-time bounds; synchronous blocking or
+ * callback starvation can postpone their delivery.
+ *
+ * @evidence contracts/common.md#principled-implementation One positional reply consumes one queued cycle; invalid framing or shape retires the stream so a delayed reply cannot answer a different cycle.
+ * @evidence contracts/common.md#clear-and-simple-design One client owns its child, line reader, FIFO and failure state; private parsing and settlement keep transport policy separate from the watch coordinator's fallback.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts Protocol validation uses the declared reply fields, and transport failure is rejection rather than a fabricated successful check or a consumer-specific recovery.
+ * @evidence contracts/common.md#meaningful-documentation Native paragraphs explain FIFO ownership, retirement, caller disposal and the absence of request bounds, following the documentation skill.
+ * @evidence contracts/portability.md#os-neutral-implementation Node spawns the supplied native executable with an argv array and pipe streams, without shell quoting; cwd and environment retain caller-provided native semantics.
+ * @evidence contracts/performance.md#efficient-algorithms A head cursor consumes replies with amortized constant queue work and failure drains outstanding requests once. Encoding/decoding visit data and text bytes; caller-defined serialization can add arbitrary work. Stderr decoding and concatenation scan the new chunk plus retained tail before truncation. Native spawn, check execution and shutdown completion remain delegated and event-loop scheduled.
+ * @evidence contracts/performance.md#reuse-equivalent-work One startup-selected child is shared across FIFO cycles, but its native session can update or reconstruct Program generations. Changed/external paths travel with each request and the watch owner replaces the process on configuration/plugin identity changes; the client does not reuse a response or certify every custom host's internal Program cache.
+ * @evidence contracts/performance.md#bound-retention-and-release-resources Each settled slot releases its request; retirement clears the queue and drains replies until actual close or the failed join deadline. That deadline releases owned transport handles and callbacks without claiming the physical child or unrelated descendants joined; live request count and line bytes have no fixed cap.
+ */
+export declare class ResidentCheckProcess {
+    private readonly child;
+    private readonly pending;
+    private pendingHead;
+    private readonly reader;
+    private failure;
+    private stderr;
+    private readonly exited;
+    private closing;
+    private didClose;
+    private forced;
+    private flushDeadline;
+    private terminationTimer;
+    private terminationDeadline;
+    private releaseTransport;
+    constructor(options: ResidentCheckProcessOptions);
+    /**
+     * Send one watch cycle and wait for its reply.
+     *
+     * Replies are paired with requests in FIFO order. A request made after the
+     * process failed, or whose line cannot be written, rejects with the failure
+     * that retired the process, so the caller can fall back to a one-shot check
+     * for that cycle.
+     *
+     * Serialization precedes enqueueing and normally rejects only this call;
+     * exceptional thrown-value conversion can itself fail during normalization. A
+     * closed input retires the host and rejects its other pending calls.
+     *
+     * @evidence contracts/common.md#principled-implementation Serialization precedes enqueueing, and each successfully enqueued call keeps its own FIFO slot until a validated reply or shared retirement settles it.
+     * @evidence contracts/common.md#clear-and-simple-design Pre-write validation remains local; write failures use the same settlement and retirement operations as pipe and protocol failure.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts Failed serialization cannot consume a reply slot, and a closed pipe is not treated as a healthy host with one exceptional caller.
+     * @evidence contracts/common.md#meaningful-documentation Separate paragraphs document reply ordering, rejection scope and closed-input effects, applying the documentation skill.
+     * @evidence contracts/portability.md#os-neutral-implementation JSON lines pass native change paths as data over Node's stdin stream, without constructing a shell command or converting native separators.
+     * @evidence contracts/performance.md#efficient-algorithms Encoding visits supplied properties and output bytes, with caller-defined conversion not bounded by final JSON size; enqueueing and settlement have amortized constant queue work plus reply parsing. Native check work is delegated rather than bounded by transport cost.
+     * @evidence contracts/performance.md#reuse-equivalent-work Each cycle is sent to the existing fixed-configuration Program owner; changes are effectful transitions and are not coalesced merely because request values match.
+     * @evidence contracts/performance.md#bound-retention-and-release-resources The client retains one resolver pair per outstanding call until reply or retirement; serialization allocates one request line, and live requests wait without an implicit timeout or population limit.
+     */
+    request(payload: ResidentCheckRequest): Promise<ResidentCheckResult>;
+    /**
+     * Retire the sidecar: reject pending requests and close its request stream.
+     * Idempotent; a process that already failed is left as is.
+     *
+     * @evidence contracts/common.md#principled-implementation Setting failure before rejecting the detached FIFO makes disposal terminal; subsequent replies and requests cannot revive the child.
+     * @evidence contracts/common.md#clear-and-simple-design Disposal enters the same retirement path as transport failure instead of maintaining a second cleanup sequence.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts Cleanup ends the actual owned streams and attempts child termination; it does not disguise a pending request as a successful result.
+     * @evidence contracts/common.md#meaningful-documentation The native comment states terminal rejection and repeated-call behavior, following the documentation skill's ownership guidance.
+     * @evidence contracts/portability.md#os-neutral-implementation Owned stream EOF and forced signaling use Node's supported APIs without shell or POSIX process-tree commands.
+     * @evidence contracts/performance.md#efficient-algorithms Retirement visits each outstanding request once and releases the queue in linear time rather than repeatedly shifting all remaining entries.
+     *
+     * @evidenceExclude contracts/performance.md#reuse-equivalent-work Disposal ends the owner and produces no computation that another request may reuse.
+     *
+     * @evidence contracts/performance.md#bound-retention-and-release-resources Disposal clears pending callbacks and requests stdin EOF while preserving output until actual close or a failed join timer. Failed join destroys/unrefs owned transport and removes request listeners without proving child/descendant termination; timer delivery depends on the event loop, and the client object can still retain its ChildProcess.
+     */
+    dispose(): void;
+    /**
+     * End the request stream and await the owned child's actual close event. A
+     * forced, signalled or nonzero exit rejects; repeated calls share
+     * retirement.
+     *
+     * @evidence contracts/common.md#principled-implementation EOF is sent on the owned input and success requires the child's actual close with status zero, never merely a successful kill request.
+     * @evidence contracts/common.md#clear-and-simple-design Retirement and join are shared with dispose; this awaitable boundary adds exit validation for callers that must release process ownership.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts Forced and unknown termination remain failures rather than fabricated graceful completion.
+     * @evidence contracts/common.md#meaningful-documentation Native prose states the child-close authority, success condition and repeated-call behavior.
+     * @evidence contracts/portability.md#os-neutral-implementation Native stdin EOF and child close events work through Node's process API; forced signalling is a failure rather than a portable graceful-stop assumption.
+     * @evidence contracts/performance.md#efficient-algorithms Closing performs one retirement traversal and constant-time exit validation; no polling population grows over the lifetime.
+     * @evidence contracts/performance.md#reuse-equivalent-work Repeated closes reuse the single actual-exit promise but never reuse an earlier process's exit as proof for another child.
+     * @evidence contracts/performance.md#bound-retention-and-release-resources Actual close clears termination timers. A failed event-loop-scheduled join deadline destroys/unrefs transport and removes request listeners while retaining terminal failure; unref releases event-loop liveness, not the client object's ChildProcess reference or proof of physical child/descendant termination.
+     */
+    close(): Promise<void>;
+    /**
+     * Await actual retirement before a transport-failure fallback starts. A known
+     * failed child may be replaced; an unjoined child may not.
+     *
+     * @evidence contracts/common.md#principled-implementation A replacement can start only after the original child's close event releases its native ownership.
+     * @evidence contracts/common.md#clear-and-simple-design The transport owner exposes joining separately from graceful status validation for the supported recovery policy.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts An elapsed deadline rejects instead of treating a still-live process as retired.
+     * @evidence contracts/common.md#meaningful-documentation Native prose distinguishes recovery's known failed exit from shutdown's graceful success requirement.
+     * @evidence contracts/portability.md#os-neutral-implementation The actual close event, rather than a signal result or native PID spelling, establishes retirement on each platform.
+     * @evidence contracts/performance.md#efficient-algorithms This accessor returns the existing promise without adding a child listener or polling filesystem/process state; subscriber work belongs to the caller.
+     * @evidence contracts/performance.md#reuse-equivalent-work Every waiter shares this child's terminal event; a replacement always owns a new promise.
+     * @evidence contracts/performance.md#bound-retention-and-release-resources Waiters share actual close or, after retirement begins, its event-loop-scheduled failed join deadline. Waiting alone starts no termination timer; a live unretired child can remain pending without a deadline, and an unjoined owner remains failure.
+     */
+    waitForExit(): Promise<void>;
+    private rejectExit;
+    private onLine;
+    private settle;
+    private fail;
+    private terminate;
+    private startTerminationGrace;
+    private forceTerminationAndJoin;
+    private static ignoreTransportError;
+    private exitError;
+}