ttsc 0.30.3 → 0.31.0

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

@@ -0,0 +1,439 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runTtscserver = runTtscserver;
+const node_child_process_1 = require("node:child_process");
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_os_1 = __importDefault(require("node:os"));
+const node_path_1 = __importDefault(require("node:path"));
+const outputText_1 = require("../../../compiler/internal/outputText");
+const createNativeProjectContextArgs_1 = require("../../../compiler/internal/project/createNativeProjectContextArgs");
+const readProjectConfig_1 = require("../../../compiler/internal/project/readProjectConfig");
+const resolveBinary_1 = require("../../../compiler/internal/resolveBinary");
+const resolveTsgo_1 = require("../../../compiler/internal/resolveTsgo");
+const SidecarEnvironment_1 = require("../../../compiler/internal/sharedHost/SidecarEnvironment");
+const spawnNative_1 = require("../../../compiler/internal/spawnNative");
+const E2ETrace_1 = require("../../../internal/E2ETrace");
+const resolveNodeBinary_1 = require("../../../internal/resolveNodeBinary");
+const loadProjectPlugins_1 = require("../../../plugin/internal/load/loadProjectPlugins");
+const resolveTtscserverBinary_1 = require("../resolveTtscserverBinary");
+const captureLSPPluginSelectionInputs_1 = require("./captureLSPPluginSelectionInputs");
+const fingerprintInitialLSPProjectInputSnapshot_1 = require("./fingerprintInitialLSPProjectInputSnapshot");
+const initialLSPProjectInputSnapshotIsCurrent_1 = require("./initialLSPProjectInputSnapshotIsCurrent");
+const materializeLSPPluginManifest_1 = require("./materializeLSPPluginManifest");
+const needsStdio_1 = require("./needsStdio");
+/**
+ * Drive the ttscserver native binary from a node launcher. The launcher is
+ * deliberately thin: argument parsing, version banners, and help text are owned
+ * by the Go binary so future flags only need to change one layer. The JS side
+ * performs the Node-owned setup that depends on package resolution:
+ *
+ * - Resolve the platform binary,
+ * - Ask that binary to interpret the complete invocation before project setup,
+ * - Resolve the project TypeScript-Go binary for the native wrapper,
+ * - Resolve the project config and materialize the private LSP plugin manifest,
+ * - Inject the Node/ttsx helper paths used by disk-backed LSP sidecars,
+ * - Inject `--stdio` for nonempty non-meta invocations,
+ * - Delegate with inherited stdio and convert a reported POSIX signal to an exit
+ *   status. Windows termination has no POSIX signal number.
+ *
+ * @evidence contracts/common.md#principled-implementation The native host's shared parser resolves the complete original invocation before project reads; its effective cwd/config/binary drive preparation while final caller argv remains intact. A discovered project uses repeated selection and current reload-fingerprint checks before manifest handoff; native metadata dispatch skips preparation and failed implicit config reading leaves discovery without a JS plugin manifest. Native refusal and final status or reported signal propagate, without certifying descendant completion.
+ * @evidence contracts/common.md#clear-and-simple-design A private native query supplies effective launch options to Node-owned package preparation. No JavaScript flag parser competes with the Go parser; selection confirmation, snapshots and manifest transport remain private responsibilities beneath this synchronous launcher.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts Bounded confirmation addresses real startup filesystem drift and fails explicitly when unstable; native process and environment APIs carry the selected plugins without foreign patching or test-specific branches.
+ * @evidence contracts/common.md#meaningful-documentation The native description names setup responsibilities and platform-specific termination meaning; private context/member documentation records ownership with paragraph and tag separation following the documentation skill.
+ * @evidence contracts/portability.md#os-neutral-implementation Shared environment merge/removal resolves Windows variable aliases while POSIX names remain exact; native paths and argv avoid shell quoting, and chmod plus signal status are isolated to their supported native platforms.
+ * @evidence contracts/performance.md#efficient-algorithms One native launch query parses argv and returns selected option strings before project startup. Startup allows three confirmation attempts, each containing two plugin loads and project-input captures. Native config/source/environment/runtime observations, delegated builds/queries, manifest/argv/result bytes, fingerprint reads and sorted snapshot serialization contribute work beyond plugin counts. Transport keys deduplicate binary/context-mode queries within one capture; attempt count is not a total time or child-count bound.
+ * @evidence contracts/performance.md#reuse-equivalent-work Each capture reuses one project-input snapshot per binary/context mode; plugin loader and binary owners supply validated persistent reuse, while confirmation must observe current selection rather than reuse an unchecked snapshot.
+ * @evidence contracts/performance.md#bound-retention-and-release-resources The launcher owns the synchronous native query and final host invocation and, when allocated, its manifest disposer in finally. Query output has no independent byte ceiling; the matching native host returns selected argv strings. Startup helpers own their additional native children/files; selected and confirmation maps coexist during an attempt and serialized records have no input-size ceiling here. Disposal failures remain observable and can prevent status return; abnormal interruption does not guarantee cleanup or descendant settlement.
+ */
+function runTtscserver(argv = process.argv.slice(2)) {
+    const binary = (0, resolveTtscserverBinary_1.resolveTtscserverBinary)();
+    if (!binary) {
+        process.stderr.write([
+            `ttscserver: platform-specific binary not found (@ttsc/${process.platform}-${process.arch}).`,
+            `Set TTSCSERVER_BINARY to an absolute path or reinstall ttsc with optional dependencies enabled.`,
+        ].join("\n") + "\n");
+        return 1;
+    }
+    ensureExecutable(binary);
+    const args = (0, needsStdio_1.needsStdio)(argv) ? ["--stdio", ...argv] : [...argv];
+    let execution;
+    try {
+        const queryArgs = ["--ttsc-resolve-launch", ...args];
+        const trace = E2ETrace_1.E2ETrace.begin(binary, queryArgs, {}, "ttscserver");
+        const query = (0, node_child_process_1.spawnSync)(binary, queryArgs, {
+            encoding: "utf8",
+            maxBuffer: Infinity,
+            stdio: ["ignore", "pipe", "pipe"],
+            windowsHide: true,
+        });
+        E2ETrace_1.E2ETrace.result(trace, query);
+        if (query.error || query.signal || query.status !== 0) {
+            process.stdout.write(query.stdout ?? "");
+            process.stderr.write(query.stderr ?? "");
+            return nativeExitStatus(query);
+        }
+        const launch = parseLaunchOptions(query.stdout);
+        execution = resolveTtscserverEnv(launch);
+    }
+    catch (error) {
+        process.stderr.write(`ttscserver: ${stripTtscPrefix(formatError(error))}\n`);
+        return 1;
+    }
+    let result;
+    try {
+        const nativeArgs = [...execution.args, ...args];
+        const trace = E2ETrace_1.E2ETrace.begin(binary, nativeArgs, {}, "ttscserver");
+        result = (0, node_child_process_1.spawnSync)(binary, nativeArgs, {
+            stdio: "inherit",
+            env: execution.env,
+            windowsHide: true,
+        });
+        E2ETrace_1.E2ETrace.result(trace, result);
+    }
+    finally {
+        execution.dispose();
+    }
+    return nativeExitStatus(result);
+}
+function nativeExitStatus(result) {
+    if (result.error) {
+        process.stderr.write(`ttscserver: ${result.error.message}\n`);
+        return 1;
+    }
+    if (result.signal) {
+        // POSIX convention: 128 + signum so wrappers (bash, npm-script, CI)
+        // can decode the signal that killed the child (130 = SIGINT, 143 =
+        // SIGTERM, etc.). On Windows, `spawnSync` does not surface a signal
+        // (TerminateProcess carries no signum) so this branch is POSIX-only
+        // by design; Windows-killed children take the `result.status ?? 1`
+        // path below.
+        const signum = node_os_1.default.constants.signals[result.signal];
+        return typeof signum === "number" ? 128 + signum : 1;
+    }
+    return result.status ?? 1;
+}
+/** Validate the private native response without interpreting caller flags. */
+function parseLaunchOptions(text) {
+    const value = JSON.parse(text);
+    if (value === null ||
+        typeof value !== "object" ||
+        typeof value.lsp !== "boolean" ||
+        typeof value.cwd !== "string" ||
+        typeof value.tsconfig !== "string" ||
+        typeof value.tsconfigExplicit !== "boolean" ||
+        typeof value.tsgo !== "string") {
+        throw new Error("native host returned malformed launch options");
+    }
+    return value;
+}
+const LSP_SELECTION_STABILITY_ATTEMPTS = 3;
+/**
+ * Build the environment for the native binary. In `--stdio` (LSP) mode the Go
+ * binary needs the project tsgo binary plus any LSP-capable plugin sidecars the
+ * JS loader resolved from config. Pass the manifest through a private temporary
+ * file and inject canonical helper paths so the native host and every later
+ * sidecar refresh use the same launch context.
+ */
+function resolveTtscserverEnv(launch) {
+    if (!launch.lsp) {
+        // Non-LSP invocations (--version, --help) do not shell out to tsgo.
+        return { args: [], dispose() { }, env: process.env };
+    }
+    const context = resolveLspExecutionContext(launch);
+    const env = lspSidecarEnvironment({
+        cwd: context.projectContext?.logicalProjectRoot ?? node_path_1.default.resolve(launch.cwd),
+        pluginConfigOrigin: context.projectContext?.pluginConfigOrigin,
+        tsgoBinary: context.tsgoBinary,
+    });
+    SidecarEnvironment_1.SidecarEnvironment.write(env, "TTSC_LSP_PLUGINS_JSON", undefined);
+    SidecarEnvironment_1.SidecarEnvironment.write(env, "TTSC_LSP_PLUGINS_FILE", undefined);
+    const lspPlugins = context.nativePlugins.filter((plugin) => plugin.capabilities?.lsp === true);
+    const selectionInputs = context.selectionInputs !== undefined &&
+        (Object.keys(context.selectionInputs.descriptorFiles).length !== 0 ||
+            Object.keys(context.selectionInputs.sourceFiles).length !== 0)
+        ? context.selectionInputs
+        : undefined;
+    if (lspPlugins.length === 0 && selectionInputs === undefined) {
+        // No transport is needed without plugins or observed selection inputs.
+        return { args: [], dispose() { }, env };
+    }
+    const transport = (0, materializeLSPPluginManifest_1.materializeLSPPluginManifest)({
+        initialProjectInputs: Object.fromEntries(context.initialProjectInputs),
+        plugins: serializeNativePlugins(context.nativePlugins),
+        projectContext: context.projectContext,
+        ...(selectionInputs === undefined ? {} : { selectionInputs }),
+        lspPlugins: lspPlugins.map((plugin) => ({
+            binary: plugin.binary,
+            ...(plugin.capabilities?.projectInputs === true
+                ? { initialProjectInputKey: lspPluginTransportKey(plugin) }
+                : {}),
+            name: plugin.name,
+            projectDiagnostics: plugin.capabilities?.projectDiagnostics === true,
+            projectInputs: plugin.capabilities?.projectInputs === true,
+            projectContextArgs: plugin.capabilities?.projectContextArgs === true,
+            stage: plugin.stage,
+        })),
+    });
+    // Deliver the manifest as an explicit flag rather than an inherited variable.
+    // A native host that predates the flag rejects the invocation instead of
+    // starting without the plugins this project declared, and nothing downstream
+    // of the host inherits either a path to the manifest or its payload.
+    return {
+        args: ["--lsp-plugins-file", transport.path],
+        dispose: transport.dispose,
+        env,
+    };
+}
+function lspSidecarEnvironment(options) {
+    const env = SidecarEnvironment_1.SidecarEnvironment.merge(process.env, {
+        TTSC_TSGO_BINARY: options.tsgoBinary,
+        TTSC_TTSX_BINARY: SidecarEnvironment_1.SidecarEnvironment.read(process.env, "TTSC_TTSX_BINARY") ??
+            node_path_1.default.join(__dirname, "..", "..", "..", "launcher", "ttsx.js"),
+    });
+    const node = (0, resolveNodeBinary_1.resolveNodeBinary)(env, options.cwd);
+    SidecarEnvironment_1.SidecarEnvironment.write(env, "TTSC_NODE_BINARY", node);
+    SidecarEnvironment_1.SidecarEnvironment.write(env, "TTSC_PLUGIN_CONFIG_DIR", options.pluginConfigOrigin);
+    return env;
+}
+function resolveLspExecutionContext(launch) {
+    const cwd = node_path_1.default.resolve(launch.cwd);
+    const tsconfig = launch.tsconfigExplicit ? launch.tsconfig : undefined;
+    const pluginConfigOrigin = process.env.TTSC_PLUGIN_CONFIG_DIR === undefined ||
+        process.env.TTSC_PLUGIN_CONFIG_DIR === ""
+        ? undefined
+        : node_path_1.default.resolve(cwd, process.env.TTSC_PLUGIN_CONFIG_DIR);
+    let initialProject;
+    try {
+        initialProject = (0, readProjectConfig_1.readProjectConfig)({ cwd, tsconfig });
+    }
+    catch (error) {
+        if (tsconfig) {
+            throw error;
+        }
+        const tsgo = (0, resolveTsgo_1.resolveTsgo)({
+            binary: launch.tsgo,
+            cwd,
+            resolveFrom: __filename,
+        });
+        return {
+            initialProjectInputs: new Map(),
+            nativePlugins: [],
+            tsgoBinary: tsgo.binary,
+        };
+    }
+    let project = initialProject;
+    for (let attempt = 1; attempt <= LSP_SELECTION_STABILITY_ATTEMPTS; attempt++) {
+        const loaded = loadLSPProjectPlugins(project, cwd, pluginConfigOrigin);
+        const selectedProject = loaded.project;
+        const tsgo = (0, resolveTsgo_1.resolveTsgo)({
+            binary: launch.tsgo,
+            cwd: selectedProject.root,
+            resolveFrom: __filename,
+        });
+        const initialProjectInputs = captureInitialLSPProjectInputs({
+            nativePlugins: loaded.nativePlugins,
+            pluginConfigOrigin,
+            project: selectedProject,
+            tsgoBinary: tsgo.binary,
+        });
+        const confirmationProject = (0, readProjectConfig_1.readProjectConfig)({ cwd, tsconfig });
+        const confirmation = loadLSPProjectPlugins(confirmationProject, cwd, pluginConfigOrigin);
+        const confirmedProject = confirmation.project;
+        const confirmedTsgo = (0, resolveTsgo_1.resolveTsgo)({
+            binary: launch.tsgo,
+            cwd: confirmedProject.root,
+            resolveFrom: __filename,
+        });
+        const confirmedProjectInputs = captureInitialLSPProjectInputs({
+            nativePlugins: confirmation.nativePlugins,
+            pluginConfigOrigin,
+            project: confirmedProject,
+            tsgoBinary: confirmedTsgo.binary,
+        });
+        const selectionInputs = (0, captureLSPPluginSelectionInputs_1.captureLSPPluginSelectionInputs)(confirmation);
+        if (selectionInputs !== undefined &&
+            lspSelectionSignature(selectedProject, loaded.nativePlugins) ===
+                lspSelectionSignature(confirmedProject, confirmation.nativePlugins) &&
+            initialLSPProjectInputsEqual(initialProjectInputs, confirmedProjectInputs) &&
+            [...confirmedProjectInputs.values()].every(initialLSPProjectInputSnapshotIsCurrent_1.initialLSPProjectInputSnapshotIsCurrent)) {
+            return {
+                initialProjectInputs: confirmedProjectInputs,
+                nativePlugins: confirmation.nativePlugins,
+                selectionInputs,
+                projectContext: {
+                    ...confirmedProject.identity,
+                    ...(pluginConfigOrigin === undefined ? {} : { pluginConfigOrigin }),
+                },
+                tsgoBinary: confirmedTsgo.binary,
+            };
+        }
+        project = confirmedProject;
+    }
+    throw new Error(`ttscserver: project plugin selection remained unstable across ${LSP_SELECTION_STABILITY_ATTEMPTS} bounded startup attempts`);
+}
+function loadLSPProjectPlugins(project, cwd, pluginConfigOrigin) {
+    // Loaded even for a project that declares no plugin: what selects the
+    // plugins, the config chain and the manifests plugin discovery reads, is an
+    // input of the session all the same, so adding a plugin later ends it.
+    // A load that finds no entry returns before any build.
+    return (0, loadProjectPlugins_1.loadProjectPlugins)({
+        binary: (0, resolveBinary_1.resolveBinary)() ?? "",
+        cwd,
+        pluginConfigDir: pluginConfigOrigin,
+        tsconfig: project.identity.logicalConfigPath,
+    });
+}
+function captureInitialLSPProjectInputs(options) {
+    const snapshots = new Map();
+    const pluginsJSON = JSON.stringify(serializeNativePlugins(options.nativePlugins));
+    for (const plugin of options.nativePlugins) {
+        if (plugin.capabilities?.lsp !== true ||
+            plugin.capabilities.projectInputs !== true) {
+            continue;
+        }
+        const transportKey = lspPluginTransportKey(plugin);
+        if (snapshots.has(transportKey))
+            continue;
+        const args = [
+            "project-inputs",
+            "--tsconfig=" + options.project.path,
+            "--plugins-json=" + pluginsJSON,
+            "--cwd=" + options.project.root,
+        ];
+        if (plugin.capabilities.projectContextArgs === true) {
+            args.push(...(0, createNativeProjectContextArgs_1.createNativeProjectContextArgs)(options.project, options.pluginConfigOrigin));
+        }
+        const env = lspSidecarEnvironment({
+            cwd: options.project.root,
+            pluginConfigOrigin: options.pluginConfigOrigin,
+            tsgoBinary: options.tsgoBinary,
+        });
+        const result = (0, spawnNative_1.spawnNative)(plugin.binary, args, {
+            cwd: options.project.root,
+            env,
+        });
+        if (result.error) {
+            throw new Error(`ttscserver: ${plugin.name ?? plugin.binary} project-inputs failed: ${result.error.message}`);
+        }
+        const stdout = (0, outputText_1.outputText)(result.stdout).trim();
+        if (result.status !== 0) {
+            const detail = (0, outputText_1.outputText)(result.stderr).trim() || stdout;
+            throw new Error(`ttscserver: ${plugin.name ?? plugin.binary} project-inputs failed${detail ? `: ${detail}` : ""}`);
+        }
+        snapshots.set(transportKey, (0, fingerprintInitialLSPProjectInputSnapshot_1.fingerprintInitialLSPProjectInputSnapshot)(parseInitialLSPProjectInputSnapshot(stdout, plugin)));
+    }
+    return snapshots;
+}
+function lspPluginTransportKey(plugin) {
+    return (plugin.binary +
+        "\0" +
+        (plugin.capabilities?.projectContextArgs === true ? "1" : "0"));
+}
+function initialLSPProjectInputsEqual(left, right) {
+    if (left.size !== right.size)
+        return false;
+    for (const [key, leftSnapshot] of left) {
+        const rightSnapshot = right.get(key);
+        if (rightSnapshot === undefined ||
+            initialLSPProjectInputSnapshotSignature(leftSnapshot) !==
+                initialLSPProjectInputSnapshotSignature(rightSnapshot)) {
+            return false;
+        }
+    }
+    return true;
+}
+function initialLSPProjectInputSnapshotSignature(snapshot) {
+    const sorted = (values) => [...(values ?? [])].sort();
+    const reloadDirectories = sorted(snapshot.reloadDirectories);
+    const reloadFiles = sorted(snapshot.reloadFiles);
+    return JSON.stringify({
+        files: sorted(snapshot.files),
+        globs: sorted(snapshot.globs),
+        reloadDirectories: reloadDirectories.map((directory) => [
+            directory,
+            snapshot.reloadDirectoryDigests[directory],
+        ]),
+        reloadFiles: reloadFiles.map((file) => [
+            file,
+            snapshot.reloadFileDigests[file],
+        ]),
+        root: snapshot.root,
+    });
+}
+function parseInitialLSPProjectInputSnapshot(text, plugin) {
+    let value;
+    try {
+        value = JSON.parse(text);
+    }
+    catch (error) {
+        throw new Error(`ttscserver: ${plugin.name ?? plugin.binary} project-inputs returned invalid JSON: ${error instanceof Error ? error.message : String(error)}`);
+    }
+    if (value === null ||
+        typeof value !== "object" ||
+        typeof value.root !== "string" ||
+        !isStringArray(value.files) ||
+        !isStringArray(value.globs) ||
+        (value.reloadFiles !== undefined &&
+            !isStringArray(value.reloadFiles)) ||
+        (value.reloadDirectories !== undefined &&
+            !isStringArray(value.reloadDirectories))) {
+        throw new Error(`ttscserver: ${plugin.name ?? plugin.binary} project-inputs returned a malformed snapshot`);
+    }
+    return value;
+}
+/** Validate contributor path lists before any native-path operation reads them. */
+function isStringArray(value) {
+    return (Array.isArray(value) && value.every((entry) => typeof entry === "string"));
+}
+function lspSelectionSignature(project, plugins) {
+    return JSON.stringify({
+        identity: project.identity,
+        plugins: plugins.map((plugin) => ({
+            binary: plugin.binary,
+            capabilities: plugin.capabilities,
+            config: plugin.config,
+            contributors: plugin.contributors,
+            kind: plugin.kind,
+            name: plugin.name,
+            source: plugin.source,
+            stage: plugin.stage,
+        })),
+    });
+}
+function serializeNativePlugins(plugins) {
+    return plugins.map((plugin) => ({
+        config: plugin.config,
+        name: plugin.name,
+        stage: plugin.stage,
+    }));
+}
+function formatError(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+function stripTtscPrefix(message) {
+    return message.startsWith("ttsc: ")
+        ? message.slice("ttsc: ".length)
+        : message;
+}
+/** Mirror the ttsc helper-binary chmod hint so first-run from npm works. */
+function ensureExecutable(binary) {
+    if (process.platform === "win32")
+        return;
+    try {
+        node_fs_1.default.accessSync(binary, node_fs_1.default.constants.X_OK);
+        return;
+    }
+    catch {
+        try {
+            const mode = node_fs_1.default.statSync(binary).mode & 0o777;
+            node_fs_1.default.chmodSync(binary, mode | 0o755);
+        }
+        catch {
+            /* spawn will surface the underlying error */
+        }
+    }
+}
+//# sourceMappingURL=runTtscserver.js.map

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

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

package/lib/launcher/internal/watch/CompilerDirectoryWatchEventPlan.d.ts

@@ -0,0 +1,29 @@
+/**
+ * What the watch launcher does in response to one directory event over the
+ * compiler's inputs, as planned by {@link planCompilerDirectoryWatchEvent}.
+ *
+ * @evidence contracts/common.md#principled-implementation Changes, inode rearming and population refresh are separate decisions rather than treating every backend event as a content edit.
+ * @evidence contracts/common.md#clear-and-simple-design Three fields carry the planner's independent actions to the topology owner.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts The plan represents actual supported watcher actions without consumer or fixture identities.
+ * @evidence contracts/common.md#meaningful-documentation Member paragraphs explain tracked changes, Windows rearm absence and unnamed-event refresh following the documentation skill.
+ * @evidence contracts/portability.md#os-neutral-implementation The rearm field exposes the native backend distinction explicitly; the type performs no guessed filesystem case conversion.
+ * @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 CompilerDirectoryWatchEventPlan = {
+    /** Tracked input candidates for the caller to check before reporting changes. */
+    changes: string[];
+    /**
+     * Tracked files selected for per-file watcher rearming after a rename or an
+     * unnamed event. This plan alone does not establish inode replacement. Always
+     * empty on Windows, where inputs are observed through their directories
+     * only.
+     */
+    rearm: string[];
+    /**
+     * Recompute the watch topology, because the event may have added or removed
+     * an input (an unnamed event, or a name that is not a tracked file).
+     */
+    refresh: boolean;
+};

package/lib/launcher/internal/watch/CompilerDirectoryWatchEventPlan.js

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

package/lib/launcher/internal/watch/CompilerDirectoryWatchEventPlan.js.map

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

package/lib/launcher/internal/watch/DirectoryWatcher.d.ts

@@ -0,0 +1,44 @@
+/**
+ * A watch on one directory, as `watchDirectory` opens it on every platform.
+ *
+ * It carries what the watch set needs from `fs.FSWatcher` and nothing else, so
+ * a backend other than `fs.watch` can serve it: closing it, and hearing that it
+ * failed.
+ *
+ * @evidence contracts/common.md#principled-implementation The method set represents the lifecycle and failure notification both native watcher backends can provide.
+ * @evidence contracts/common.md#clear-and-simple-design Closing and failure subscription remain independent of backend-specific event-emitter features.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts Backends implement this supported boundary without replacing foreign watcher methods.
+ * @evidence contracts/common.md#meaningful-documentation Native prose explains the reduced interface and idempotent closure following the documentation skill.
+ * @evidence contracts/portability.md#os-neutral-implementation The interface isolates fs.watch and macOS FSEvents behind the same lifecycle contract.
+ * @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 DirectoryWatcher {
+    /**
+     * Stop delivering events. Closing a watch twice is harmless.
+     *
+     * @evidence contracts/common.md#principled-implementation Closing retires this subscription and repeated closure preserves the already retired state.
+     * @evidence contracts/common.md#clear-and-simple-design One lifecycle operation hides whether the backend closes a handle or releases a shared stream subscription.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts Closure uses the backend's supported resource boundary rather than patching its native implementation.
+     * @evidence contracts/common.md#meaningful-documentation The native comment states event retirement and idempotency following the documentation skill.
+     * @evidence contracts/portability.md#os-neutral-implementation Callers close through the shared method rather than assuming platform-specific handle types.
+     * @evidenceExclude contracts/performance.md#bound-retention-and-release-resources close declares a signature only; the implementation owns acquisition and release of resources.
+     * @evidenceExclude contracts/performance.md#efficient-algorithms close declares a signature only; the implementation owns the processing strategy.
+     * @evidenceExclude contracts/performance.md#reuse-equivalent-work close declares a signature only; the implementation owns any shared work.
+     */
+    close(): void;
+    /**
+     * Subscribe to failure notification so the owner can retire the watch.
+     *
+     * @evidence contracts/common.md#principled-implementation The failure subscription communicates observation loss so the owner can reconcile its watch set.
+     * @evidence contracts/common.md#clear-and-simple-design One error event avoids exposing unrelated backend event channels.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts Failure is not replaced with a fabricated healthy watcher result.
+     * @evidence contracts/common.md#meaningful-documentation The native comment explains failure notification and caller retirement responsibility following the documentation skill.
+     * @evidence contracts/portability.md#os-neutral-implementation Native backend failures share an Error callback rather than OS-specific result shapes.
+     * @evidenceExclude contracts/performance.md#bound-retention-and-release-resources This method signature acquires no runtime resource; backend implementations own listener storage and the watcher owner closes the subscription.
+     * @evidenceExclude contracts/performance.md#efficient-algorithms This method signature defines no processing algorithm; the backend implements event subscription.
+     * @evidenceExclude contracts/performance.md#reuse-equivalent-work This method signature coordinates no runtime work; backend event distribution owns any sharing.
+     */
+    on(event: "error", listener: (error: Error) => void): unknown;
+}

package/lib/launcher/internal/watch/DirectoryWatcher.js

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

package/lib/launcher/internal/watch/DirectoryWatcher.js.map

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